插件开发者门户

5 分钟从模板到上架:写插件、打 tag 发版、本地校验、提 PR 登记。

审核 SLA:3 个工作日内给出通过或修改意见;发版后打 tag 即自动更新,无需再提 PR。

1. 从模板建仓

用 plugin-template 生成仓库(一个插件一个仓库),写好 manifest.json 与 main.js,id 一旦上架不可更改。

2. 本地跑通

桌面端用“从 URL/本地安装”装上,确认节点出现、无报错;主题插件确认 8 个文件内全部合法。

3. 打 tag 发版

推 v* tag(如 v0.1.0)触发 release 工作流,产出 <id>-<版本>.zip、<id>.zip 别名与 manifest.json 三个正式版资产。

4. 本地校验

跑 node scripts/validate-plugin-submit.mjs --manifest ./manifest.json --repo 你/仓库,全部 ok 再提 PR(命令与 CI 同规则)。

5. 提 PR 登记

向 poly-creator/plugins 的 plugins.json 加一条(含 id/repo/名称/作者/描述),CI 通过即上架;之后发版只打 tag。

审核标准(与拒收理由一一对应)

  • 一插件一仓库,release 为正式版(draft/prerelease 不命中 latest)。
  • 三个资产齐全:版本 zip、无版本别名 zip、integrity 注入后的 manifest.json。
  • manifest 合法:safe-id、semver、main 与 theme.files 必选其一、权限在允许列表内。
  • 包内 manifest 与登记条目一致(id/版本/资产名);钉版本条目 tag 与 sha256 必须成对。
  • trusted(含 nodeEntry)人工更严:主进程权限按需声明,默认按 safe 处理。
  • 下架即删条目;zip 不超过 30MiB;包内无 ../ 与绝对路径。
完整发布指南插件模板插件目录仓库