nixkits-check-updates

NixKits 软件包更新检查

检查 NixKits 各软件包的上游发布更新，执行版本升级，并更新文档。

排除的软件包

以下类别不检查（无固定上游发布版本）。通过 .nix 文件特征自动分类：

• 自建软件包：src 指向本地路径（./ 或 ../ 开头），如 rustPlatform.buildRustPackage { src = ./src; }
• 动态版本追踪：version 从外部输入动态读取，如 builtins.readFile、URL 抓取、flake input
• 跟随 nixpkgs 版本：使用 overrideAttrs 仅追加 patch，不定义独立 version
• 补丁内硬编码版本：.patch 文件中直接包含 ${version} 或 wheel URL 及 hash（见下方「检查补丁内版本」节）

flake.nix → packages 中的其余包均自动纳入检查。

第 1 步：确认本地仓库

# 通过 flake.nix 自动发现项目名
test -f flake.nix && echo "OK: $(grep -oP 'description\s*=\s*"\K[^"]+' flake.nix | head -1)" || echo "ERROR: not in a flake project"

第 2 步：发现待检查的软件包

从 flake.nix 的 packages 段自动提取，再按排除规则过滤：

# 自动发现所有被 callPackage 引用的包文件
grep -oP '\./[a-zA-Z0-9_/-]+\.nix' flake.nix | sort -u > /tmp/all_pkgs.txt

# 排除自建包（src 包含 ./ 或 ../）
while read f; do
  grep -q 'src\s*=\s*\./\.\.\|src\s*=\s*\.\/' "$f" 2>/dev/null && echo "SKIP self-hosted: $f"
done < /tmp/all_pkgs.txt

# 剩余包即为外部更新候选

第 3 步：检查上游版本

对每个发现的外部包，从其 .nix 文件确定上游仓库，然后比对：

check() {
  local pkg="$1" current="$2" repo="$3"
  latest=$(curl -s "https://api.github.com/repos/$repo/releases/latest" | grep -oP '"tag_name":\s*"\K[^"]+')
  if [ "$current" != "$latest" ]; then
    echo "UPDATE: $pkg  $current → $latest"
  else
    echo "OK: $pkg  $current"
  fi
}

第 4 步：更新构建配置

⚠️ hash 计算注意事项

• SRI hash 格式必须使用标准 base64（+ / =），不能使用 URL-safe base64（- _）。 用 nix hash to-sri --type sha256 <hash> 或 nix-prefetch-url --type sha256 <url> 获取正确格式
• fetchFromGitHub 的 source hash 不能从 GitHub archive tarball（/archive/refs/tags/）预计算 — 两者可能不同。必须通过 nix build 的 hash mismatch 错误获取
• npmDepsHash 不能设为空字符串 ""。清空时使用 lib.fakeHash 占位
• npm 包需要两次 nix build：第一次获取 source hash，第二次获取 npmDepsHash。 如果 source hash 已知正确，可只清空 npmDepsHash 一次构建完成

对每个有更新的包：

npm 包

1. 更新 .nix 文件中的 version 字符串
2. 将 fetchFromGitHub 的 hash 置为空占位符
3. 将 npmDepsHash 置为空占位符
4. 运行 nix build .#<pkg> 两次 — 第一次获取源码 hash，第二次获取 npmDepsHash
5. 用实际值更新两个 hash
6. 运行 nix build .#<pkg> 验证构建成功