💞 立即获取 Athena OS！ 💞

点击上方 Docker 图标，探索 Athena OS Docker 容器！

点击上方图标，在 Microsoft Store 应用中探索 Athena OS WSL！

自动化软件包更新

本仓库中的软件包通过由 nvchecker 驱动的每日 GitHub Actions 工作流自动保持最新状态。

工作原理

该自动化每天运行（也可手动触发），并执行以下步骤：

1. 配置生成 — .nvchecker/generate-nvchecker-config.py 扫描 src/ 下的每个 PKGBUILD，并自动生成 .nvchecker/nvchecker.toml。每个软件包被归类为以下类型之一：

   • 发布版软件包 — 具有静态 pkgver= 和远程源 URL。按托管平台上的最新标签/版本进行跟踪。
   • VCS 软件包 — 具有 pkgver() 函数和 git+https:// 源。按最新上游提交进行跟踪。
   • 仅本地软件包 — 所有源均为本地文件。静默跳过（没有可跟踪的上游）。

2. 版本检查 — nvchecker 查询每个被跟踪软件包的上游并将结果写入 .nvchecker/newver.json。将其与 .nvchecker/oldver.json（已提交到仓库中）进行比较，以找出有新版本可用的软件包。

3. PKGBUILD 更新与 PR — 对于每个过时的软件包，工作流会：

   • 创建专用分支 auto-update/<pkgname>-<newver>。
   • 在 PKGBUILD 中更新 pkgver 并将 pkgrel 重置为 1。
   • 对于发布版软件包：使用 updpkgsums 重新生成校验和。
   • 对于 VCS 软件包：克隆上游仓库，在本地运行 pkgver() 函数以计算真实的 Arch 风格版本字符串（例如 131.940a5d3），并保持 sha512sums=('SKIP') 不变。
   • 在合并到 main 之前，打开一个标记为 auto-update 的拉取请求供人工审查。

4. 状态保存 — .nvchecker/oldver.json 会使用本次运行中看到的版本进行更新并提交回 main，这样下次运行只会为真正的新变更打开 PR。

支持的托管平台

PKGBUILD 中的 Shell 变量展开

配置生成器和 CI 工作流都会解析 source= 行中的 shell 变量引用，以便正确处理如下所示的间接 URL：

支持以下 bash 参数展开形式：

已知限制

以下 bash 结构不会被自动化解析。依赖这些结构的 PKGBUILD 将被优雅地跳过并附上说明信息 —— 不会报错，且它们始终可以手动更新。

如果你的 PKGBUILD 使用了上述任何结构且自动化跳过了它，你可以将该赋值改写为普通的 var=value 行，或者打开一个 PR 手动更新版本。