发布与审核

准备认证和展示信息

使用具备 plugins:read、plugins:write、releases:write 的 PAT，并先取得管理员批准的命名空间。 创建 metadata.json，包含 display_name、summary、description，以及可空的 icon_url、docs_url、support_url。

{
  "display_name": "我的插件",
  "summary": "一句话用途",
  "description": "完整说明",
  "icon_url": null,
  "docs_url": null,
  "support_url": null
}

提交平台归档

pluginctl publish --name my-team/my-plugin --metadata ./metadata.json --artifacts-dir ./artifacts --journal ./publish-1.0.0.json --endpoint https://market.example/v1/graphql --json

首次创建展示草稿，并与首个版本一起提交一次审核；已有名称必须属于你当前有权管理的插件。 artifacts-dir 放置 pack 生成的 tar.gz 与 .pack.json。使用 source-url 时与 artifacts-dir 互斥，并明确 version 和 family。 publish 本地预检名称和字节，稳定记录 command ID，然后上传并等待校验达到 pending_review。

等待明确审核

pluginctl status --name my-team/my-plugin --endpoint https://market.example/v1/graphql --json

临时上传和候选材料保留 7 天，校验、审核与重试不会延期。上传 URL 有效期为 15 分钟； 材料过期后使用新的上传和候选重提未发布版本。

pending_review 和 publishing 都不是 published。管理员在审核队列核对 listing 与精确 release，并明确批准或拒绝。 最终鉴权并提交持久发布承诺后，系统写公开字节、snapshot与HTML，再独立确认两channel。 承诺前失权会拒绝候选；承诺后的ownership变化不取消原授权发布。后续版本不改变展示可见性。 通用 publish 不自行审批，即使调用者是管理员。

确认真实交付

使用distribution地址和authority UUID匿名show；按平台download并校验SHA-256/大小。 只取得 accepted receipt 或看到上传成功都不能证明审核通过或可下载。

pluginctl publication-status --command-id <original-command-uuid> --endpoint https://market.example/v1/graphql --json

结果区分stable/preview和HTML进度。failed/unknown由管理员按当前revision显式恢复原publication：

pluginctl publication-recover --publication-id <publication-uuid> --revision <current-revision> --command-id <recovery-command-uuid> --endpoint https://market.example/v1/graphql --json

保留原publication和原发布命令，不重传或换版本制造第二次发布。恢复命令applied只证明已重新排队。