Docs / Protocol

Registry v1

站点与 JSON API 来自同一份 registry/ 数据；API 文件在构建时生成，客户端无需执行 Astro 页面。

入口

GET /api/v1/registry.json
GET /api/v1/index.json
GET /api/v1/publishers/<id>.json
GET /api/v1/plugins/<id>.json
GET /api/v1/plugins/<id>/versions/<version>.json

入口中的 index 是相对 URL，便于镜像。查看当前 Registry root ↗

客户端版本选择

Index 的 latest_published 仅表示最新发布，不等于可安装。客户端应读取版本详情，筛掉 yanked 版本，再按允许的 Channel、主程序版本范围、Plugin API 和 RPC API 选择最高兼容 SemVer。

Artifact 完整性

每个版本的 artifact 必须包含固定文件名、HTTPS Release URL、字节大小与 SHA-256。客户端安装前应核对 size 和 sha256。signature 为可选字段；存在时采用 ed25519-sha256-v1，通过 key_id 绑定 /api/v1/publishers/<id>.json 中登记的 Ed25519 公钥。签名覆盖带域分隔的 SHA-256 消息，而不是 Registry JSON 本身。

撤回和缓存

版本 identity 不可覆盖。撤回时仅追加 yanked 与原因；客户端不得选择被撤回的版本。静态部署需为 root/index 设置较短缓存期；yanked 状态可变，客户端应重新检查版本状态并保持离线缓存容错。

目前状态

当前有 1 个待发布条目、8 个已发布插件。草稿不进入公开 index，也不等于可安装版本。