扩展与插件开发

安装启停扩展、装配包约定、检查发布与用 AI 协助开发。

扩展与插件开发

扩展用来给 AI 增加工具、技能、界面或新的工作台入口。日常使用在 AI 设置 → 扩展 启停；开发、联调、发布在 插件编辑器 中完成。

与 MCP、Skills、Rules 的关系：MCP 接外部服务；Skills / Rules 约束做事方式和边界；扩展可以把工具、Skill、Agent、MCP 和界面打成一条可启用的装配线。工作台按钮与菜单的逐项说明见 插件编辑器。

扩展能做什么

启用一条扩展后，可能同时提供：

日常使用不必改源码。需要给团队做内部工具、或把固定能力打包复用时，再进入插件编辑器。

管理已安装扩展

1. 打开 AI 设置 → 扩展（也可从首页 AI 设置 进入后点侧栏「扩展」）。
2. 页面有两个标签：
   • 装配线 / 已挂载：本机已扫描到的扩展包
   • 商城已装：从官网商城写入的安装记录
3. 常用操作：
   • 启用 / 停用：立即热挂载或卸载，一般不必重启
   • 打开插件编辑器：进入开发工作台
   • 打开目录：在资源管理器中查看扩展文件
   • 刷新：重新扫描列表
   • 删除：移除扩展目录，不可恢复

从商城安装：打开 商城 · 插件，在详情页点添加入口，回到客户端确认列表中出现该项并启用。

不要把密钥写进扩展源码或 Skill 正文。密钥只放在设置里。

打开插件编辑器

任选其一：

1. 首页 场景工作台 → 插件编辑器
2. AI 设置 → 扩展 → 打开插件编辑器
3. 菜单 AI → 插件开发器
4. 命令面板搜索「插件编辑器」

首次打开会提示设置 插件根目录。所有扩展都保存在该目录下，并挂到左侧资源管理器的「插件」节点。

• 未指定时：已打开工作区则用工作区下的默认扩展目录；未打开工作区则用用户目录下的同名位置。
• 之后可随时：文件 → 设置插件根目录…，或选 使用默认目录。

界面分区：

第一次新建扩展

1. 右侧切到 新建。
2. 填写 名称（保存时自动生成 ID）。
3. 选择 模板。
4. 确认将创建到的插件根目录。
5. 点击 创建扩展。
6. 在左侧打开生成的文件，按目标改内容。
7. 保存（Ctrl+S / Cmd+S）→ 检查（Ctrl+Enter）→ 通过后 发布。

选哪个模板

不确定时选 完整装配线，再删掉不需要的部分。

扩展包里有哪些文件

完整装配线大致包含：

只做界面时，主要改 views.json 和 ui/ 下的 HTML。只做工具时，主要改 plugin.js 和 manifest.json。

写后台工具时注意

1. 工具要同时登记「模型可见的描述」和「真正执行的路由」，缺一则检查不会通过。
2. 扩展在沙箱中运行：不要使用本机文件系统直读、动态执行代码、或把密钥写进源码。
3. 改完必须先 检查，存在 错误 时无法发布。

检查、发布与预览

检查

1. 保存当前文件。
2. 点工具栏 检查，或菜单 联调 → 检查 / 试跑。
3. 右侧 检查 页查看结果。问题按四类列出：完整性、安全性、可靠性、一致性；严重程度为错误 / 警告 / 提示。

错误 必须修掉才能发布；警告 建议修，但不阻断。

发布并热挂载

1. 检查通过后点 发布（菜单 联调 → 发布并热挂载）。
2. 成功后状态提示「已发布并热挂载」。
3. 下一轮对话 即可调用新工具；一般不必重启应用。

停用 / 启用：菜单 联调 → 禁用扩展 / 启用扩展，或到 AI 设置 → 扩展 切换开关。

预览 UI

扩展贡献了 Tab 或工作台时：

1. 在右侧清单中选择要预览的视图，或点 预览 UI。
2. 确认页面能打开、按钮可点。
3. 工作台类型发布后，回到首页 场景工作台 → 其它，应能看到新入口。

用 AI 协助开发

插件编辑器菜单 AI 提供两条入口：

也可以在任意对话里直接说：「帮我写一个插件，用来……」。请尽量写清：

1. 要工具、界面，还是完整装配线。
2. 用户怎么触发（说一句话 / 点一个工作台）。
3. 不要做什么（例如不要访问外网、不要改项目文件）。

AI 会先澄清目标，再在插件根目录下创建或修改，并走检查 → 发布。你仍需自己点 预览 UI、在下一轮对话里试一次新工具。

提交到商城（可选）

本机发布只让当前电脑可用。要给团队或社区使用：

1. 在 AI 设置 → 扩展 选中扩展。
2. 若界面提供提交 / 发布到商城，按向导填写说明并提交审核。
3. 审核结果以官网 商城 为准。

未登录或当前套餐不支持提交时，仍可本机使用，不必上架。

建议开发顺序

1. 用模板创建，先跑通「检查通过 → 发布 → 下一轮对话能调到」。
2. 再补 Skill / 界面，每改一处就检查一次。
3. 用低风险任务验证（例如只返回一段说明，不写文件）。
4. 稳定后再考虑提交商城或分发给同事。

团队共用时：统一插件根目录约定，或把扩展目录纳入版本管理；密钥仍各自在设置中填写。

常见问题

创建后列表是空的
确认插件根目录设对了，点 刷新；扩展必须在该根目录下，而不是项目里的任意文件夹。

检查不通过
先看错误项：清单字段是否完整、工具描述与执行是否成对、是否写入了不允许的能力。修完再检查。

发布了但对话里调不到
开一个新会话再试；确认扩展为已启用；在设置里刷新列表。当前正在进行的一轮对话可能仍使用发布前的工具集。

预览 UI 打不开
确认 views.json 里的入口路径与 ui/ 下文件一致，且已保存。

误删扩展
删除不可恢复。重要扩展请自行备份插件根目录，或纳入版本管理。

更多排障见 故障排除。

相关章节

• 插件编辑器
• 设置中心
• MCP 扩展
• Skills 与 Rules
• AI 对话与模式