根目录清单
rpi-extension.json:name / version / type: "extension" / targets / 完整的 install 命令。没有它,收录后会因安装命令为空而无法上架。
不需要填表、不需要发邮件。在仓库里放一份清单、打一个 topic,官方目录的发现任务就会把它收录进来;符合规则的扩展直接上架并标记为官方。
rpi-extension.json + topic: rpi-extension这是一份给 AI 看的 SKILL.md:它知道 rpi 需要什么样的清单、tag 和目录结构。把它丢给你的编码 Agent,让它照着改造仓库。
包含:形态判定、rpi-extension.json 模板、Release 与 tag 规则、CI 模板(三平台检查 + 宿主冒烟 + 发布)、自检命令、常见失败对照表。
把这个仓库改造成 rpi 扩展:在根目录加 rpi-extension.json(type 写 extension,install 写完整的 rpi install … --github …),确认 Cargo 产出 cdylib,按 <name>-v<version> 打 Release,然后告诉我需要加哪些 topic。
rpi-extension.json:name / version / type: "extension" / targets / 完整的 install 命令。没有它,收录后会因安装命令为空而无法上架。
要么 Cargo.toml 的 crate-type 含 cdylib(源码构建),要么 Release 里按平台放好动态库(预编译,推荐)。
仓库 Topics 加 rpi-extension。这是发现任务唯一的入口;命中且有清单会进入审核队列,人工通过后上架。免审和「官方」标记只给官方仓库 pi-rust/rpi-extension、pi-rust/rpi-package。
从 pi-rust/rpi-extension 的 .github/workflows/ 抄一份改名:三平台 fmt / test / clippy -D warnings,加一个宿主冒烟 job(装宿主 → rpi install → 启动),发布用 tag 触发。技能文件里有可直接用的模板。
能被目录收录 ≠ 能装上。用干净环境跑一遍安装,再对照清单检查字段。
curl -s https://api.github.com/repos/OWNER/REPO/contents/rpi-extension.json?ref=main -H 'Accept: application/vnd.github.raw'rpi install rpi-your-extension --github OWNER/REPO --force && rpi --no-session -p 'echo ok'gh release view rpi-your-extension-v0.1.0 --json assets --jq '.assets[].name'
常见失败:缺 rpi-extension.json(不会被收录)、topic 或 type 不对(不会自动上架)、下载量恒为 0(tag 不是 <name>-v<version>)、名字被占用(换名后重新收录)。
收录后一般 1 小时内出现在目录;页面与接口都有缓存,最多 60 秒可见。