插件开发者门户
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;包内无 ../ 与绝对路径。