发布插件

1. 准备插件

确保 plugin.json 位于 ZIP 根目录，包含准确的 ID、SemVer、Plugin API、主程序版本范围、执行模式和依赖。运行时字段以这个文件为准。

查看安装包要求 ↗

2. 建立条目

pnpm registry:new-plugin

填写插件 ID、发布者、仓库地址、中英文名称与简介、分类及许可证，并完善 README.md 和 README.en.md。脚本生成待发布草稿目录；在真实 Release 导入前，公开 API 不会收录它。

3. 创建 GitHub Release

以 v<version> 为标签，上传 <plugin-id>-<version>.zip。Registry 会按 ZIP 原始字节计算并固化 size 与 SHA-256；已经发布的同一版本不可覆盖，需要修正时发布新的版本号。

如需签名，先在 Publisher 记录的 signing_keys 中登记 Ed25519 公钥，再额外上传 <plugin-id>-<version>.zip.sig。签名文件使用 ed25519-sha256-v1 JSON 格式；导入时会验证签名，不接受未知 key_id 或无效签名。

4. 导入并验证

pnpm registry:import-release -- <plugin-id> https://github.com/OWNER/REPO/releases/tag/v1.0.0
pnpm registry:verify-releases
pnpm check

导入器读取 GitHub Release 与标签 commit、下载 ZIP、校验路径和清单、计算 SHA-256，最后生成版本记录。提交前请检查截图、中英文 README、权限描述与兼容范围。