插件和市场 - Docs by LangChain中文

插件通过可复用的技能和MCP服务器扩展 Deep Agents Code。市场提供目录，用于跨项目或团队发现和安装插件。Deep Agents Code 支持 Claude 和 Codex 风格的插件清单和市场目录，如创建插件和创建市场所述。

请只从您信任的来源安装插件和市场。已启用的插件可以添加指令，并以您的用户权限启动 MCP 服务器进程。

交互式管理插件

要在 dcode 会话中浏览市场和管理插件：

运行 /plugins 打开插件管理器。
从其市场选项卡添加一个市场。支持的来源包括：
- 格式为 owner/repo 的 GitHub 仓库，可选跟 @branch-or-tag。
- HTTPS Git 仓库 URL，可选跟 #branch-or-tag。
- 提供市场 JSON 文件的 HTTPS URL。
- 本地市场目录或 JSON 文件。
从该市场安装插件。
运行 /reload 以激活新安装的插件技能和 MCP 服务器，无需重启会话。

插件管理器还允许您启用、禁用和卸载已安装的插件。禁用插件会保留其安装状态，但在您运行 /reload 或启动新会话后，其技能和 MCP 服务器将被排除。移除市场会卸载其插件并移除受管缓存数据。当市场来源于本地目录或文件时，Deep Agents Code 会保留原始来源。运行 /reload 或启动新会话以将移除操作应用到活动会话。

通过命令行管理插件

使用 dcode plugin 进行脚本编写和基于终端的管理。插件 ID 使用格式 plugin-name@marketplace-name。

# Add and inspect a marketplace
dcode plugin marketplace add acme/plugins
dcode plugin marketplace list

# Browse and install plugins
dcode plugin list
dcode plugin install code-review@acme-tools

# Change plugin state
dcode plugin disable code-review@acme-tools
dcode plugin enable code-review@acme-tools

# Remove a plugin or marketplace
dcode plugin uninstall code-review@acme-tools
dcode plugin marketplace remove acme-tools

plugin list 和 plugin marketplace list 接受 --json。安装插件后，在活动的交互式会话中运行 /reload 或启动新会话。

使用插件技能和 MCP 服务器

插件技能具有命名空间，以防止与项目、用户和其他插件技能冲突。使用插件 ID 和技能路径调用技能：

/skill:plugin-name@marketplace-name:skill-name optional arguments

在交互模式下，自动补全也会匹配较短的 /plugin-name:skill-name 形式，并将其扩展为规范的 /skill: 命令。嵌套的技能目录会将每个目录添加到命名空间中。例如，来自 quality@acme-tools 的 skills/review/security/SKILL.md 变为 /skill:quality@acme-tools:review:security。已启用的插件还可以提供 MCP 服务器。Deep Agents Code 在插件加载时将这些服务器与您的常规 MCP 配置合并。使用 /mcp 检查可用的服务器和工具。

创建插件

Deep Agents Code 插件是一个包含一个或多个受支持组件的目录：

my-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── review/
│       └── SKILL.md
└── .mcp.json

Deep Agents Code 也识别 .codex-plugin/plugin.json。当组件使用其默认位置时，清单是可选的。如果插件只包含一个技能，您可以将 SKILL.md 放在插件根目录下，而不是创建 skills/ 目录。

定义插件清单

如果存在，.claude-plugin/plugin.json 或 .codex-plugin/plugin.json 必须包含 name。您还可以声明版本和自定义组件路径：

{
  "name": "my-plugin",
  "version": "1.0.0",
  "skills": "./skills",
  "mcpServers": "./.mcp.json"
}

skills 和 mcpServers 字段接受路径字符串或路径数组。mcpServers 还可以包含内联 MCP 配置对象。每个组件路径必须以 ./ 开头，保持在插件根目录内，且不包含 ..。当未声明自定义路径时，Deep Agents Code 会查找：

skills/ 下的技能，或者当 skills/ 目录不存在时，查找根目录下的 SKILL.md。
根目录 .mcp.json 文件中的 MCP 服务器。

添加技能

将每个技能组织为一个包含 SKILL.md 的目录：

skills/
└── review/
    ├── SKILL.md
    └── checklist.md

使用与独立 Deep Agents Code 技能相同的技能格式。安装的插件名称将成为技能命名空间。更多信息，请参见记忆与技能。

添加 MCP 服务器

将标准 MCP 服务器定义放在 .mcp.json 中，或在插件清单的 mcpServers 中内联声明它们。插件配置支持以下路径变量：

${CLAUDE_PLUGIN_ROOT} 或 ${PLUGIN_ROOT}：已安装的插件目录。
${CLAUDE_PLUGIN_DATA} 或 ${PLUGIN_DATA}：插件的可写数据目录。
${CLAUDE_PROJECT_DIR}：活动的项目目录。

例如：

{
  "mcpServers": {
    "review-tools": {
      "command": "python",
      "args": ["${CLAUDE_PLUGIN_ROOT}/server.py"],
      "env": {
        "CACHE_DIR": "${CLAUDE_PLUGIN_DATA}"
      }
    }
  }
}

有关支持的 MCP 传输和字段，请参见MCP工具。

创建市场

市场是一个包含名称和 plugins 数组的 JSON 目录。将其存储在市场根目录下的以下路径之一：

.claude-plugin/marketplace.json
.agents/plugins/marketplace.json
.agents/plugins/api_marketplace.json

以下市场包含一个存储在同一仓库中的插件：

{
  "name": "acme-tools",
  "plugins": [
    {
      "name": "code-review",
      "source": "./plugins/code-review",
      "description": "审查代码的正确性和可维护性"
    }
  ]
}

每个插件条目需要 name 和 source。它还可以包含 description 和 author。本地源路径必须以 ./ 开头，并保持在市场根目录内。当所有本地插件共享不同的基础目录时，设置 metadata.pluginRoot。市场条目还可以使用外部 Git 源：

{
  "name": "acme-tools",
  "plugins": [
    {
      "name": "code-review",
      "source": {
        "source": "github",
        "repo": "acme/code-review-plugin",
        "ref": "v1.0.0"
      }
    },
    {
      "name": "release-tools",
      "source": {
        "source": "git-subdir",
        "url": "https://github.com/acme/developer-tools.git",
        "path": "./plugins/release-tools",
        "ref": "main"
      }
    }
  ]
}

支持的外部插件源类型是 github、url 和 git-subdir。远程 URL 必须使用 HTTPS。作为直接 JSON URL 添加的市场不能包含本地相对插件源，因为只有目录文件会被下载。当目录引用同一源树中的插件目录时，请使用 Git 仓库或本地目录。通过添加本地目录、安装插件并启动新会话或运行 /reload 来测试本地市场：

dcode plugin marketplace add ./my-marketplace
dcode plugin install code-review@acme-tools

另请参阅

Connect these docs to Claude, VSCode, and more via MCP for real-time answers.

Edit this page on GitHub or file an issue.

​交互式管理插件

​通过命令行管理插件

​使用插件技能和 MCP 服务器

​创建插件

​定义插件清单

​添加技能

​添加 MCP 服务器

​创建市场

​另请参阅

交互式管理插件

通过命令行管理插件

使用插件技能和 MCP 服务器

创建插件

定义插件清单

添加技能

添加 MCP 服务器

创建市场

另请参阅