# 从控制台提交插件发布

## 什么是插件

插件是豆包开放平台连接外部系统与数据源的能力载体，让豆包在用户授权范围内查询数据或执行操作。插件可通过 MCP 或 CLI 提供工具能力，并配套插件说明，描述适用场景、调用方式和操作流程，帮助豆包正确理解和使用这些能力。

### 插件目录结构

```text
route-assistant/
├── plugin.json                         # 插件根清单
├── skills/
│   └── route-planning/
│       ├── SKILL.md                    # 技能说明
│       ├── references/                 # 可选：补充资料
│       ├── scripts/                    # 可选：辅助程序
│       └── assets/
│           └── icon.png                # 可选：技能图标
├── mcp.json                            # 可选：MCP 服务连接
└── com.doubao/
    ├── assets/
    │   ├── plugin-icon.png
    │   ├── plugin-chat-icon.png
    │   └── routes-icon.png             # 可选：MCP 服务图标
    └── auth/
        └── routes.json                 # 按需提供：静态凭据配置
```

## 推荐接入方式

|方案|适用场景|说明|
|---|---|---|
|**MCP \+ Skill**<br>|已有网络 API、本地工具，或可以提供 MCP Server。|MCP 负责暴露标准工具能力，Skill 负责触发和使用说明。远程 MCP 优先使用 Streamable HTTP；本地进程使用 STDIO。|
**推荐兼容基线：** 优先采用 **MCP + Skill**。远程服务优先使用 Streamable HTTP；需要用户授权时，推荐 **OAuth 2\.0 Authorization Code \+ PKCE S256 \+ MCP 2025\-06\-18**。该组合是当前兼容性更稳妥的默认方案。

## 接入流程

![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/192f93e1c675c69b23f06f27c78f1fd4_TszRbicKtD.png?height=1860&lazyload=true&maxWidth=750&width=3676)

- **开发者操作：** 完成注册登录和企业认证后，在控制台创建插件并上传插件包；平台自动校验通过后，开发者需完善配置信息并提交审核。

- **平台处理：** 创建能力时自动解析资源包，并校验包结构、内容和许可证；开发者提交审核后，平台运营人员在测试商店完成验收，验收通过后等待统一发版，最终更新插件状态为「已上架」。

## 创建并提交插件

### 前提条件

- 完成 [企业资质认证](https://open.feishu.cn/document/doubao-developer-guide/enterprise-qualification-certification)。

- 按照 [插件开发规范](https://open.feishu.cn/document/plugin-docs-center/build/mcp-server-development/plugin-development-spec/plugin-development-specification-overview)完成插件开发。

### 创建插件

1. 进入控制台左侧的 [插件列表](https://open.doubao.com/console/plugins) 页面，点击 **\+ 创建插件**。

2. 在 **上传资源** 步骤上传插件压缩包。可以把文件拖到上传区域，也可以点击 **选择文件**。

- 资源包需包含名称、简介、图标和版本号。

- 仅支持 ZIP；压缩包不超过 16 MB、文件条目不超过 1024 个、单个文件解压后不超过 2 MB、整包解压总量不超过 16 MB。
    名称、图标、简介或版本号需要调整时，应修改压缩包后重新上传。

3. 等待平台解析名称、简介、图标、版本号和包内模块，并查看检测结果。检测通过后，点击 **下一步**。

![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/25a10486b5d9fcb0349d0bd19b1e8ae8_gjOWZaaUNE.png?height=566&lazyload=true&maxWidth=400&width=1504)
    若检测失败，按页面列出的文件名、格式或许可证问题修改压缩包并重新上传。

4. 在完善 **基础信息** 步骤选择 **意向分类**，按需填写 **补充说明**，并点击 **下一步**。

![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/46965161685af06585f19167aabc9ae0_xHHdjSRxzX.png?height=1050&lazyload=true&maxWidth=400&width=1346)
    意向分类只是申报项，最终展示分类由平台在上线前确定。

5. 在完善 **子能力信息** 步骤选择完成插件中包含的 **连接器** 和 **技能** 的信息配置，并点击 **下一步**。

![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/78cdda1ebae068e1a2fccea77579bac7_mtaqsD02k1.png?height=1728&lazyload=true&maxWidth=400&width=1356)

**连接器配置项**：

- **传输方式**：MCP 当前主要使用 STDIO 与 Streamable HTTP 两种标准传输方式；HTTP\+SSE 仅作为兼容项保留。

- **鉴权方式**：远程 MCP 可选择无需鉴权、OAuth 或 API Key / 自定义鉴权；STDIO 所需凭据通过进程环境变量交付。

- **测试账号/测试 Key**：按所选鉴权方式提供，供平台审核时实测使用。可点击右侧 **点击检测** 验证账号是否可用。

**Skill 配置项**：

- **评测报告：** 需要填写飞书云文档链接，并向平台审核人员开放阅读权限。

- **示例提示词：** 需要提供 5–10 条，每行一条。仅用于平台审核测试，不会对用户展示。

**CLI 配置项**：

- **功能说明文档：** 需要覆盖每条指令的含义与写法，请粘贴飞书云文档链接，并对平台审核人员开放阅读权限。

6. 确认填写信息无误后，点击 **提交**。提交后，进入平台审核阶段。页面显示 **已提交审核** 后，可点击 **返回插件列表** 查看后续状态。

- 审核时效通常为「3 个工作日」，审核结果会通过「站内信」通知。

- 版本提交后，由平台运营人员在测试商店完成验收和上架，开发者无需操作。

- 审核期间不可修改，也不能同时创建其他新版本。如需调整，应先撤回当前审核，或在版本被驳回后修改草稿并重新提交。

### 修改草稿

若开发者需要暂时离开，可点击 **保存为草稿**。每个能力仅保留一份草稿，且只有创建者可以编辑。已保存的草稿可在 **插件列表** 页面中查看和继续编辑。
审核被驳回或撤回后，已提交版本也会恢复为可编辑的草稿状态。

### 撤回版本审核

插件处于 **审核中** 时，开发者可以在插件的 **版本列表** 页面撤回已提交版本，撤回后恢复草稿编辑。版本处于发布中状态时不能撤回。

### 创建版本

插件审核通过后，若需更新插件、MCP、CLI、图标或基础信息等内容并再次发布，你可以在开放平台为当前插件创建并提交一个新的版本。

平台审核期间不可修改插件，也不能创建新版本。

1. 在 **插件列表** 页，点击插件右侧的 **查看** 操作，进入插件详情页。

2. 点击右上角的 **创建版本**，为当前插件创建并提交一个新版本。操作步骤与创建插件一致。

### 查看审核和上架状态

每次状态变化会通过飞书消息推送给开发者。开发者可在 **插件列表** 页查看插件状态，在 **插件详情** > **版本列表** 页查看版本状态、历史审批和打回原因。

|对象|状态|含义|
|---|---|---|
|**插件**|未上架|尚无版本进入正式商店。版本处于草稿、审核中、已打回，或已通过审核但尚未随商店发版时，能力仍为未上架。|
||已上架|至少一个版本已随商店统一发版进入正式商店，可供用户查看和安装。|
||已下架|平台运营已将能力从正式商店下架。暂不提供开发者自行下架入口。|
|**版本**|草稿（待提交）|版本尚未提交；审核中撤回后也回到草稿，可继续修改并重新提交。|
||审核中|版本已提交，运营人员正在进行后台实测和审核；此时开发者可以撤回。|
||已拒绝|版本未通过审核，控制台展示打回原因；修改后可重新提交并再次进入审核中。|
||已上线|版本已通过审核并固化为不可编辑的发布版本。平台运营随商店统一发版后，对应能力变为已上架。|
||已下架|新版本上线后，旧版本自动进入该状态并保留为历史版本；能力整体下架时，当前线上版本也不再对外提供。|

## 在豆包工作中使用插件

上架后，终端用户可在 **豆包工作** 客户端的 **插件\&技能\&伙伴** 页面查看并安装已上架插件。详情参考 [在豆包工作中使用插件](https://www.doubao.com/work/docs/zh-cn/articles/705018132598-plugins)。

![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/3b7a29868256ab8f2e8315e511ad8b04_JZ4mlf0flH.png?height=1674&lazyload=true&maxWidth=400&width=2912)

## 常见问题

### 为什么提交按钮不可用？

检测未全部通过，或评测链接、示例提示词等提审必填项未填写时，提交按钮不可用。根据页面提示修改 ZIP 或补齐字段后重新检测。

### 审核被驳回后怎么办？

在能力详情查看驳回原因。版本回到草稿后修改并重新提交；历史审批记录和理由会保留。

### 上架后如何更新？

创建新版本并完成内容修改，重新完成检测和审核。新版本审核期间，线上版本继续服务；新版本上架后，旧版本变为已下架，已安装用户自动升级。

### 能否自行下架能力？

目前控制台没有开发者下架入口，需要由平台运营处理。插件下架后，已安装该插件的用户仍可继续使用。