> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Devin 应用

> Devin 应用是由 Devin 构建、在其自有机器上运行并通过稳定 URL 提供访问的 Web 应用。了解如何创建、共享、锁定和更新 Devin 应用，以及相关计费方式。

Devin 应用是 Devin 为你构建、并在其自有机器上持续运行的 Web 应用，可以是内部工具、仪表板、表单、跟踪器或演示等。每个应用都有一个固定不变的 URL，方便你与团队共享。

应用的运行方式与[浏览器预览](https://docs.devinenterprise.com/zh/work-with-devin/browser-previews.md)相同。预览用于在单个会话中查看进行中的工作，足以满足大多数场景。而应用适用于会话工作结束后，团队仍需长期使用的成果。

> [!NOTE]
>
> Devin 应用正在逐步推出。如果你的 sidebar 中没有显示 **Apps**，说明该功能尚未对你开放。

## Devin Apps 的工作原理

* **应用运行在 Devin 的机器上。** Devin 在会话中构建应用，并由该会话的机器提供服务。不会部署到任何第三方托管平台。
* **支持任意技术栈。** Devin 可以选用任何适合该任务的框架和语言，只要最终能在某个端口上提供 HTTP 服务即可。
* **您的数据保留在机器上。** 应用可以使用你喜欢的任何数据库，例如运行在同一台机器上的 SQLite 或 Postgres。文件和上传的内容也存放在这台机器上。
* **URL 固定不变。** 应用的 URL 格式为 `https://<name>--<id>.preview.devinapps.com`。每次更新后 URL 都保持不变，重命名应用也不会影响它。Devin 知道该 URL，并会在应用上线后将其发给你。
* **应用是私有的。** 任何人打开应用都必须先登录 Devin。访问权限由你决定。应用永远不会公开。
* **应用由会话管理。** 构建应用的会话也负责发布后续更改。如需修改应用，请向对应的会话发送消息。

## 用例

* **产品的 Beta 版和预生产环境版本。** Devin 可以在其机器上运行贵公司真实的技术栈：前端、后端、数据库以及所有工作器。因此，Devin App 非常适合托管应用的 Beta 版或预生产环境副本，团队成员只需打开链接即可访问，无需另行搭建托管环境。
* **内部工具。** 管理面板、请求表单、审批队列，以及用于取代共享电子表格的小工具。
* **仪表板。** 从你自己的数据源拉取指标、值班健康状况、支持队列或销售数据，并按计划定期刷新。
* **Rollout 跟踪器。** 用一个页面展示迁移、发布或功能开关 rollout 的当前进度以及剩余工作。
* **演示和原型。** 在正式构建之前，先做出一个可运行的版本，让大家点击体验你的想法。

## 创建应用

1. 在 sidebar 中打开 [**Apps**](https://app.devin.ai/apps)。
2. 描述应用需要实现的功能。你也可以选择一个提示词模板作为起点。
3. 发送提示。

随后你会进入一个新的 Devin 会话。Devin 会在第一条消息中提出所有疑问，然后构建应用并将其上线。应用会立即出现在 **Apps** 下，并显示其 URL；在首个版本上线前，其状态为 **Building**。

你也可以在任意会话中要求创建应用，例如“把这个构建成一个 Devin App”。如果 Devin 已经向你展示了浏览器预览，你可以让它将该预览发布为应用。

## 休眠、唤醒与计费

无人使用时，Devin 的机器会进入休眠。有人打开该应用时，机器会被唤醒并提供页面。休眠后的首次加载可能需要几秒钟。最后一次请求结束 5 分钟后，机器会再次进入休眠。

应用按机器处于唤醒状态的时长计费。如果无人访问应用，机器休眠期间不会产生任何用量。构建和修改应用属于常规会话工作，计费方式与其他会话相同。请参阅[用量](https://docs.devinenterprise.com/zh/admin/billing/usage.md)。

## 共享应用

在应用上点击 **Share**，即可复制其链接或更改谁可以打开它。**General access** 有三个级别：

| 级别 | 谁可以打开该应用 |
| - | - |
| **Only people with access** | 创建者、组织管理员以及你添加的人员 |
| **Organization** | 你的组织中的所有人，以及你添加的任何人 |
| **Enterprise** | 你的企业中所有组织的成员 |

你还可以添加特定的人员、组或组织，并为每一方分别设置可执行的操作：打开应用、编辑其设置，或将其共享给他人。

组织管理员可以在 **Sharing defaults** 中为本组织的所有应用设置默认共享级别。

## 查找和置顶应用

“应用”页面列出了你可以打开的应用，并支持搜索、分类浏览和按筛选条件过滤。你可以将最常用的应用置顶。置顶分为两种：

* **为我置顶**：将应用置顶在你个人的应用主页上。
* **为所有人置顶**：将应用置顶在整个组织的应用主页上。仅组织管理员可执行此操作。

如果你喜欢别人的某个应用，可以使用 **以此为起点**，基于该应用创建一个新应用。

## 更新应用

打开应用并点击 **Edit in session**，然后告诉 Devin 要修改哪些内容。Devin 会完成修改、构建新版本并将其上线，URL 保持不变。

每次更新都会生成一个新版本。应用页面会在 **Deployments** 下列出所有版本，并显示每个版本的状态、描述和对应的 commit。如果新版本启动失败，上一个版本会继续提供服务。如需回退到旧版本，请在会话中要求重新部署该版本。

应用页面还会显示过去 24 小时、7 天或 30 天的页面浏览量。

应用的创建者和组织管理员可以打开应用设置，对其进行重命名、编辑描述、设置封面图片、下线或删除。下线应用会保留其历史记录；删除应用后，其 URL 将无法再访问。这两种操作都不会影响会话。

## Devin 如何构建应用

Devin 在构建应用时会遵循一组内置指示。以下几点值得了解：

* **提供生产构建版本。** Devin 基于开发服务器进行开发，并在浏览器预览中检查成果。应用运行正常后，Devin 会对其进行构建，并运行生产构建版本，而不是开发服务器。
* **用 git 管理代码。** Devin 在每次部署前都会提交，因此每个版本都对应一个 commit。如果应用位于你的某个代码仓库中，Devin 会推送这些提交或创建 pull request。
* **数据不存放在构建文件夹中。** 数据库文件和上传的文件存储在会被重新构建的文件夹之外，因此更新或回滚不会清除这些数据。
* **沿用你的品牌风格。** 除非你指定了具体外观，否则 Devin 会在你的代码仓库中查找公司的设计系统，并使用其中的颜色、字体和组件，同时告诉你品牌风格的来源。如果找不到，则使用简洁的默认样式。
* **预先提问。** 用户发送请求后往往会离开，因此 Devin 会在第一次回复中就提出所需的全部问题。
* **不留下无法运行的版本。** 如果部署失败，Devin 会读取错误信息、进行修复，然后重新部署。
* **生成缩略图。** 部署完成后，Devin 会为应用截取屏幕截图，用作 Apps 页面上该应用卡片的缩略图。

你可以在提示中覆盖以上任何行为，例如指定想要的技术栈、数据库或外观。

## 使用自动化让应用保持最新

应用不必等你提出更改请求。[自动化](https://docs.devinenterprise.com/zh/product-guides/automations.md)可以唤醒 Devin，让它替你更新应用。两种常见配置：

* **定时运行。** Devin 每小时、每天或每周唤醒一次，拉取最新数据并更新应用。这种方式非常适合仪表板和报告。
* **每次 Push 时运行。** 如果应用跟踪您的某个代码仓库中的分支，Devin 会在该分支每次变更时重新部署应用。

只需让应用的会话完成此项配置。Devin 会创建自动化，你只需批准一次。你也可以在“自动化”页面自行创建，并让它向应用的会话发送消息。

> [!WARNING]
>
> 每次自动化运行都是一个 Devin 会话，并按会话计费。如果应用每隔几分钟就更新一次，其成本可能远高于应用本身。要控制成本，可以：
>
> * 降低自动化的运行频率。大多数仪表板按小时或按天更新就足够了。
> * 为自动化的会话选择成本效益更高的模型。
> * 尽量减少工作量。让 Devin 编写一个只获取新数据的脚本，并在每次更新时运行该脚本，这样它就不必每次都从头摸索解决方案。
> * 在自动化上设置每个会话的支出限额。参见[限额与保护措施](https://docs.devinenterprise.com/zh/product-guides/automations.md#limits-and-safeguards)。

## Secrets 与其他服务

App 可以从其他服务读取数据，也可以向其写入数据。Devin 的配置方式与在任何会话中相同。

* **其他服务的 API 密钥。** 将密钥添加为 [secret](https://docs.devinenterprise.com/zh/product-guides/secrets.md)，并告诉 Devin 该密钥用于哪个服务。Devin 会将密钥提供给 App 的服务器，再由 App 从服务器端调用该服务。请将密钥保留在 App 的服务器端。发送到浏览器的任何内容，所有能打开该 App 的人都能看到。
* **Devin API。** App 可以使用[个人访问令牌](https://docs.devinenterprise.com/zh/api-reference/personal-access-tokens.md)或服务用户密钥调用 [Devin API](https://docs.devinenterprise.com/zh/api-reference/overview.md)。借此，你可以基于 Devin 构建自己的工具，例如通过表单启动会话的页面，或展示团队会话的仪表板。个人访问令牌代表你本人执行操作，因此所有使用该 App 的人都将拥有你的权限。共享此类 App 时请务必谨慎。
* **登录。** 所有打开 App 的人都已登录 Devin，因此大多数 App 无需单独设置登录功能。

Secrets 与 App 的其他部分一同存放在 Devin 的机器上。它们不属于 App 的共享设置，除非 App 主动显示，否则能打开 App 的人也无法读取。

## 应用离线时

应用依赖于其所在的会话。请注意以下几点：

* **归档或结束会话会导致应用离线。** 当你归档一个正在接管并运行应用的会话时，Devin 会事先提醒你。取消归档或恢复该会话即可让应用重新上线。
* **崩溃的服务器不会自动重启。** 如果应用的服务器停止运行，在 Devin 重新启动它之前，该 URL 会一直显示错误页面。打开该应用的会话，让 Devin 重新部署即可。
* **没有在线版本的应用会显示离线页面。** 在首次部署完成之前，或有人将应用下线之后，你看到的就是这个页面。

无论哪种情况，解决方法都是从“Apps”页面打开该应用的会话，然后让 Devin 重新部署。

## 限制

* 应用无法设为公开，访问者始终需要登录 Devin。
* 应用无法注册自己的 service worker，因此 PWA 无法使用离线模式。
* 应用运行在单台机器上，适合内部工具和仪表板，不适合高流量的生产服务。对于此类服务，请使用您现有的 CI/CD 将其部署到您自己的基础设施上，并通过[机密信息](https://docs.devinenterprise.com/zh/product-guides/secrets.md)和[技能](https://docs.devinenterprise.com/zh/product-guides/skills.md)为 Devin 授予访问权限。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.