Skip to main content
插件目前处于封闭测试阶段。要申请访问权限，请联系 support@cognition.ai。后续版本中的行为和配置可能会有所调整。

​
什么是插件？

插件将技能——以及可选的规则、钩子、MCP 服务器和子 Agent——打包成一个单元，以便安装和复用。有关文件格式和插件可包含的内容，请参阅插件参考。 托管插件允许管理员在 Devin Web 应用中集中安装插件，使其对整个 组织 或企业中的所有人生效——无需逐个用户设置。这既适用于云端 Devin 会话，也适用于已登录该账户的 Devin CLI 用户 (企业级/账户级配置也会同步到 CLI——请参阅云端会话与 CLI) 。安装插件后，其中的技能会自动提供给 Devin，并可作为 /<plugin>:<skill> 命令使用。 本页介绍插件在 Web 应用侧的内容：托管清单、作用域和上传。

​
在哪里配置它们

前往 设置 → 资源 → 插件。该页面有两个选项卡：
  • Marketplace — 浏览并安装插件 (包括 Devin 官方目录，以及你的组织或企业添加的任何插件) 。安装插件会将其作为必填插件添加到所选作用域的清单中，因此该作用域内的所有人都会自动安装它。
  • 配置 — 以 JSON 格式编辑原始插件清单，并以文件夹或 .zip 的形式上传你自己的插件 (也可以在编辑器中构建) 。
访问权限受限：
  • 组织管理员 (具有组织设置访问权限) 管理 组织 清单。
  • Enterprise Admin (具有企业设置访问权限) 还可以管理共享的 企业 清单。

​
清单

清单是一个 JSON 文档，包含三个列表：
  • requiredPlugins — 为作用域内的所有人安装 (会递归安装，包括其依赖的所有插件) 。
  • optionalPlugins — 一个允许列表，用于认可插件但不自动安装；可用于为被禁条目设置例外。
  • forbiddenPlugins — 一个拒绝列表，包含插件标识或 glob 模式。
清单会按原样存储；Agent 会在安装时验证完整来源。有关每个条目可采用的来源形式以及完整的依赖和治理语义，请参阅插件参考。

​
添加你自己的插件

根据插件所在的位置，可通过以下任一方式添加：

​
上传插件包

在 配置选项卡中，已上传的插件部分支持你以文件夹或 .zip 文件的形式上传插件，或直接在编辑器中构建插件。保存后，它会作为必填插件添加到清单中 (为作用域内的所有人安装) ；删除后，则会移除该引用。对于你不想 (或无法) 托管在 Git 仓库中的插件来说，这是一个不错的选择。

​
使用私有 skills 仓库

让清单直接指向私有仓库——通常不需要把它预先放进你的环境快照里。凡是 Devin 已经能通过你的 Git 集成访问到的私有仓库，都可以自动安装。使用 git URL 形式，或使用 git-subdir 从共享仓库的子文件夹安装插件。 (同一清单涵盖的 CLI 用户会使用各自本地的 git 凭据来拉取，因此他们也需要拥有该仓库的访问权限。) 如果无法通过你的 Git 集成访问该仓库，可以将其作为插件包上传 (见上文) ，或者在环境设置期间克隆它，再通过本地路径引用。

​
更新如何生效

  • 清单变更 (设置 → 资源 → 插件) 会在下一个会话中生效。
  • 插件变更——当插件跟踪的分支合并了更新后，几小时内就会自动应用到新会话。将插件固定到某个 commit SHA，即可自行控制更新；在 CLI 中，devin plugins update 会立即刷新。
  • 正在运行的会话会保留其启动时加载的内容——更新绝不会在会话运行过程中生效。

​
作用域与继承

托管清单最多可存在于两个层级：
  • 独立账户只有一个适用于所有人的 账户 清单。
  • 企业有一个共享的 企业 清单，每个子组织都会继承它，其下还会叠加一个按 组织 划分的清单。Marketplace 视图会同时显示这两者；企业管理员可以选择在企业作用域安装插件 (全局生效) ，而组织管理员则可以仅在自己的组织内安装。
它们位于整个插件层级的最上方，高于仓库级和用户级插件配置。有关其他层级和权威性规则，请参阅继承与层级。

​
云端会话与 CLI

云端 Devin 会话和 Devin CLI 都遵循 enterprise/account 清单：必需的插件会自动安装，禁用规则也同样适用于登录该账户的 CLI 用户。 org 清单仅适用于 云端会话。CLI 在账户级进行身份验证，不具备组织上下文，因此组织级的必需项和禁用项不会作用于 CLI 用户。凡是你需要在 CLI 中 (或账户级) 强制执行的内容，都应放在 enterprise/account 清单中；而 org 清单则用于为云端会话添加组织特有的内容。

​
了解更多

  • Skills — 插件内置的 SKILL.md 步骤
  • CLI 插件参考 — plugin 文件格式、编写方式和用户级安装
  • Playbooks — 附加到会话的可复用提示模板