插件编辑器

开发、检查、预览与发布 ZF 扩展。

插件编辑器

插件编辑器用于开发、联调、预览和本机发布 ZF 扩展。扩展可以给 AI 增加工具，或提供新的标签页、工作台入口。

本工作台只用于开发 ZF 扩展。只启停已有扩展时，用 AI 设置 → 扩展 即可。安装、目录约定、商城提交的完整说明见 扩展与插件开发。

也可从 AI 设置 → 扩展 → 打开插件编辑器，或菜单 AI → 插件开发器 进入。

打开方式

1. 场景控制台 → 场景工作台 → 开发系统 → 插件编辑器。
2. 不强制先打开代码项目工作区，但需要确认 插件根目录。
3. 首次进入会弹出 设置插件根目录：可 使用默认目录，或 选择文件夹…。

默认根目录一般在工作区的扩展目录下；无工作区则用用户目录下的同名位置。之后可用 文件 → 设置插件根目录… 更换。标题栏可 返回场景控制台。

界面分区

未设置根目录时，中间会提示先设置。设置后：插件根已挂到左侧「插件」，请打开扩展文件编辑。

第一次使用

1. 进入工作台，确认或选择插件根目录。
2. 右侧 新建：填写 名称（保存时自动生成 ID），选择 模板，点 创建扩展。
3. 在左侧 插件 树中打开清单和源码。
4. 保存 后点 检查（或 Ctrl+Enter）。状态为「检查通过，可以发布」后再 发布。
5. 若包含界面，在清单中选视图，点 预览 UI。
6. 也可用 AI → 用 AI 新建扩展包…，在右侧 Agent 中说明要做的工具或界面。

发布成功后，开一个新会话再试新工具；当前这一轮对话可能仍使用发布前的工具集。一般不必重启应用。

选哪个模板

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

扩展包文件

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

写后台工具时：模型可见的工具描述和真正执行的路由必须成对，否则检查不会通过。扩展在沙箱中运行，不要直读本机磁盘、不要动态执行代码、不要把密钥写进源码。

文件菜单

联调

错误 必须修掉才能发布；警告 建议修，但不阻断。检查未通过时显示「存在错误，无法发布」。

发布并热挂载 只表示本机可用，不等于已提交到官网商城。工作台类型发布后，回到首页 场景工作台 → 其它 应能看到新入口。

和 AI 配合

AI 菜单：

• 开发当前扩展…：针对当前打开的扩展继续改
• 用 AI 新建扩展包…：从空白需求生成

会打开右侧 Agent，并带上扩展开发说明。请写清：要提供什么工具或界面、用户怎么触发、不要做什么。改完后仍要自己点 检查 和 预览 UI，并在新会话里试一次。

任意对话里也可以说：「帮我写一个插件，用来……」。

设置中的扩展页

不开发、只使用扩展时：

1. 打开 AI 设置 → 扩展。
2. 查看已挂载装配包和商城已装项，启用或停用。
3. 可打开扩展目录、刷新或删除本地扩展。
4. 需要上架时，若提供提交商城入口，按向导操作；审核以 商城 为准。

详见 扩展与插件开发、设置中心。

注意

1. 扩展需通过检查才能发布到本机。
2. 不要把本工作台当成通用 Node 插件开发环境。
3. 删除扩展不可恢复；重要扩展请备份插件根目录或纳入版本管理。
4. 发布后若对话里调不到，先确认已启用，再开新会话。