Devin 插件与 Customize 页面

​

什么是插件？

​

Customize 页面

• Plugins — 所有已安装的内容，按作用域分组，并可通过 Browse marketplace 安装更多内容。
• 技能 — Devin 按需加载的技能，来自已安装的 plugins 和你的代码仓库。
• MCPs — 为 Devin 提供内置工具之外能力的 MCP 服务器。详见下文 MCPs。
• 钩子 — 在 会话 中的特定时点自动运行的命令。详见下文 钩子。
• 规则 — 作用域内 会话 需遵循的长期指导。详见下文 规则。

• Personal — 任何人都可更改自己作用域内的内容。
• Organization — 具有组织设置访问权限的成员。
• Enterprise — 具有企业设置访问权限的成员。

​

安装插件

​

从 marketplace 安装

​

从代码仓库、.zip 文件或编辑器安装

​

通过 CLI

​

让 Devin 来做

​

插件如何进入会话 (云端 ↔ 本地同步)

• 云端会话在启动时获取企业级、组织级和个人级清单，并将由此得到的插件安装到会话机器上，同时也会安装其克隆的代码仓库中声明的插件。
• 登录后，Devin CLI 和 Devin Desktop 会获取同样的清单，因此你在网页端安装的插件会出现在你的电脑上，而你在电脑上执行 devin plugins install 安装的插件也会出现在你的下一个云端会话中。来自私有代码仓库的插件会使用你本地的 git 凭据获取，因此你本人需要拥有该仓库的访问权限。企业可以完全关闭 CLI 插件 (企业设置中的 Devin CLI plugins) 。
• 个人用户 (不属于任何组织) 只有个人作用域。

​

Indexing

• 触发条件 —— 安装、移除或编辑插件都会自动排入一次重新索引。向插件的 source 仓库推送 changes 后,可通过 Plugin settings → Reindex plugins 刷新索引。
• 运行过程中 —— 一次 run 可能处于 scheduled、queued、starting 或 indexing 状态。过于频繁的重新索引会被分散执行,上传 bundle 的保存操作可能需要稍等一会儿才会排队。插件 MCP 在其 configuration 建立索引后即可连接。
• 结果 —— 打开 Plugin settings(齿轮菜单)可查看上次建立索引的时间以及存在的 issue。刷新 failed 时,上一次成功的结果可能仍然可见;因此插件出现在 list 中并不代表最近一次刷新已成功。
• 仓库访问权限 —— 从某个代码仓库建立索引的插件内容,只会在通过 Git integration 拥有该仓库访问权限的组织中显示。若没有权限,该作用域的内容将不予显示,并提示 Plugin repos unauthorized;此时请在 Settings → Repositories 中授予该仓库权限。不予显示的作用域中的治理规则(其 forbid 项)仍然生效。
• network policy —— 索引任务运行在一台继承了你的组织会话 network policy 的 machine 上,因此插件 source 必须在该 policy 下可访问。

​

解决索引问题

1. 在需要该插件的组织中打开 Customize → Plugins。选择其 Personal、Organization 或 企业 作用域，然后打开 Plugin settings，查看问题描述及其中指出的插件或作用域。
2. 如果某次 run 处于计划、排队、启动或建立索引状态，请等待其完成。如果该插件从未建立索引，或其 source 自上次建立索引后发生了变化，请选择 Reindex plugins。
3. 对于失败的 run 或缺失的内容，请参照下表对应的修复方法。保存或 commit 修正后，选择 Reindex plugins 并再次检查结果。修改共享清单或代码仓库权限可能需要 Admin 操作。

​

MCPs

• 来自插件 — 由已安装插件声明的 MCP 服务器。连接设置 (URL、transport、所需凭据) 归插件所有，以只读方式显示；但你仍可启用、停用、连接或卸载它。大多数官方 marketplace 插件都由一个 MCP 服务器构成，并可选附带 skills。
• 独立 — 单独安装的 MCP 服务器：自定义服务器 (Add custom MCP) 以及从旧版 MCP marketplace 安装的服务器，该 marketplace 仍可从此选项卡进入。

​

钩子

​

规则

​

清单

{
  "requiredPlugins": ["acme/review-tools"],
  "optionalPlugins": [],
  "forbiddenPlugins": ["sketchy-org/bad-plugin", "acme/*"]
}

• requiredPlugins — 为作用域内的所有人安装 (会递归安装，包括其依赖的所有插件) 。从 UI 安装会在此处添加一个条目。
• optionalPlugins — 一个允许列表，用于认可插件但不自动安装；可用于为被禁条目设置例外。
• forbiddenPlugins — 一个拒绝列表，包含插件标识或 glob 模式。

​

上传的插件

{ "requiredPlugins": [{ "source": "account-upload", "bundleId": "bugzilla" }] }

{ "requiredPlugins": [{ "source": "account-upload", "bundleId": "bugzilla", "bundleScope": "account" }] }

• 企业 requiredPlugins — 在每个组织中安装。
• 企业 optionalPlugins — 在每个组织的 Suggested 下显示，admin 可在此安装。在企业插件的详情面板中，Required organizations 会将其安装到你选择的组织中。

​

治理

​

作用域与继承

• 独立账户拥有一份账户清单 (在 Customize 中显示为 Organization) ，以及每位成员的个人清单。
• Enterprise 拥有一份 enterprise 清单，由其下所有子组织继承；其下一层是各 organization 级别的清单，再下一层是个人清单。

​

更新如何生效

• 清单变更 (安装、移除、清单编辑) 会在下一个会话中生效，适用于所有界面。
• 插件内容变更——当插件跟踪的分支合并了更新后，会自动应用到新会话 (云端会话在启动时获取；CLI 在执行 devin plugins update 时刷新) 。Customize 会在下一次建立索引后显示新内容——点击 Reindex plugins 可立即拉取。
• 正在运行的会话会保留其启动时加载的内容——更新绝不会在会话运行过程中生效。

​

固定 插件

{
  "requiredPlugins": [
    { "source": "github", "repo": "acme/review-tools", "sha": "3f2a9c1d8e4b7a6f5c0d1e2f3a4b5c6d7e8f9a0b" }
  ]
}

​

plugin环境变量

{
  "requiredPlugins": [
    {
      "source": "github",
      "repo": "acme/review-tools",
      "env": {
        "API_KEY": "secret:org:REVIEW_API_KEY",
        "REVIEW_MODE": "strict"
      }
    }
  ]
}

​

支持的引用方式

secret:org:NAME
secret:enterprise:NAME
secret:personal:NAME
secret:session:NAME
secret:repo:owner/repo:NAME

​

了解更多

• 插件参考 — 插件文件格式、清单、治理语义、CLI 命令
• 设置你的插件生态系统 — 构建并治理你自己的插件仓库
• 快速开始：团队 marketplace — 从零搭建共享插件仓库
• Skills — 插件打包的 SKILL.md 步骤
• MCP 服务器 — 传输方式、自定义服务器、单个服务器的设置