Miyu 的官方软件源:索引发在 https://miyu-agent.github.io/packages/,包文件在各包自己仓库的 Release 里。miyu pkg update、miyu pkg search、miyu pkg install <编号> 用的就是这里。
| 文件 | 做什么 |
|---|---|
sources.toml |
照哪几种来源收:官方的仓库,和打了 miyu-package 话题的社区仓库 |
miyu-rev |
收录和打包模板用核心仓库的哪一版读清单:一行提交号。升级只改这一个文件,两边跟着走 |
official.toml |
官方的仓库,各取最新的 Release 里的 .miyu |
names.toml |
编号到来源仓库:先到先得,第一个收录的仓库占住,永远跟着它。新占的由收录写回来 |
blocked.toml |
拉黑的编号或仓库,和理由 |
.github/workflows/collect.yml |
每天收一次,签名,发到 Pages。改了规则、手动触发也跑。顺带数各包全部发布的下载次数,最近 8 天的记在 Pages 上的 stats.json(不签名),索引里每个包带上线时刻、下载次数、近 7 天的下载次数 |
.github/workflows/pack.yml |
给包作者用的打包模板 |
.github/workflows/pack-selftest.yml |
打包模板的自测:改了模板、miyu-rev 时在三种系统上把 tests/hello 打一遍,不传 Release |
索引用 Ed25519 签名,公钥编在 miyu 里(编号 f9234109a4740be9)。签名验不过的索引,miyu 整份不收。
在包自己的仓库里加 .github/workflows/release.yml:
name: release
on:
push:
tags: ["v*"]
jobs:
pack:
uses: miyu-agent/packages/.github/workflows/pack.yml@main
permissions:
contents: write
with:
package: <包编号>打 tag(v 加上 package.toml 里的 version)后,模板照 Miyu 装包的那一套查清单、打成 .miyu、传进这个 tag 的 Release。
- 包文件夹不在仓库根目录:写
folder。 - 打包前要先编程序:写
build,一段 bash。 - 清单写了
targets的:一种系统一个包文件,用strategy.matrix分别写runs-on和target。 - 打包用的核心版本:不写
miyu-rev的照本仓库根目录的miyu-rev,和收录同一版,不会出现打得出、收不进(或者反过来)。只有要试还没进这里的新写法时才写。
社区包自动收录(2026-11-02 起):仓库打上 miyu-package 话题,最新的 Release 里有 .miyu,每天收录一趟就收进来,标成社区包;编号先到先得,作恶的写进 blocked.toml。进官方列表(official.toml)要项目主人点头。