6. 到开发者后台上传插件

完成开发和本地调试后,先执行 pnpm build,再到 ToolZen 开发者后台上传重新生成的 dist 插件包。

插件后台

打开 ToolZen 插件后台

后台用于上传插件包、查看审核意见、提交审核和查看发布状态。客户端与后台使用同一套账号。

上传插件

  1. 在插件工程根目录执行 pnpm build。
  2. 登录插件后台。
  3. 打开「上传插件」页面,点击「上传插件」。
  4. 选择刚刚构建的 dist 目录,目录必须包含 manifest.json 和 index.js。
  5. 确认后台读取到插件名称、编码、版本和文件数量后点击「上传」。
  6. 上传成功后记录进入「草稿」状态,确认自测完成后点击「提交审核」。

上传界面会按服务端规则校验清单和文件:manifest.code 必须与插件记录一致,manifest.entry 必须指向包内文件,文件数量、大小、目录深度和扩展名也必须符合限制。只选择 dist 目录,不要选择源码工程根目录,也不要上传 src、node_modules 或手动制作的 ZIP。

兼容性声明也会在这一步校验,以下情况会被 400 打回(提示里会列出全部问题):

  • requires / optional 里出现未登记的能力名;
  • 同一能力同时写在 requires 和 optional(自相矛盾);
  • minApiLevel 不是 ≥ 1 的整数,或超过上限;
  • minApiLevel 低于 requires 隐含的级别。

各字段的取值与规则见manifest.json 字段参考,能力协商机制见版本与兼容性。

审核与发布

草稿 ──提交审核──> 审核中 ──管理员通过──> 已发布
  ↑                    │
  └──── 修改并递增版本 <── 驳回

管理员会重点检查功能描述与实际行为、权限声明、入口安全、剪贴板规则和数据采集说明。被驳回时查看审核意见,修改代码或清单并递增 version,再上传新版本并重新提交。

已发布版本内容不可覆盖;即使只是修改一行代码,也必须使用新的三段式版本号。旧版本会继续保持可见,直到新版本审核通过并发布。