SuperAPI AI 工具集

cli-release-distribution

通用与其它

查看项目

更新于 10-16 06:52

技能介绍

用途:把编译型 CLI(Go/Rust)从“本机能构建”推进到“用户一行命令可安装、TAB 补全可用”。不适用于 Python/Node 解释型 CLI、库发布、GUI 应用,以及尚无用户的工具(此时 go install / cargo install 已足够)。

主要能力:按渠道分三层——第一层由你在每个 tag 自动完成(GitHub Releases、自建 Homebrew tap、自建 Scoop bucket、go install/crates.io);第二层需你提 PR 由他人审核(winget-pkgs、AUR、nixpkgs、homebrew-core、MacPorts);第三层由下游志愿者自发打包(Debian、Fedora、Alpine 等),不应纳入计划。

使用方式:Go 侧用 goreleaser init 生成配置,goreleaser check 校验,goreleaser release --snapshot --clean 本地全量试跑;工作流 A 在 push tags v*.. 时发布预编译二进制,工作流 B 用模板生成 formula 并推送到 homebrew-<name> 仓库,工作流 C 用 scoops: 块自动发布 Scoop manifest,工作流 D 处理补全的生成与安装。附带脚本 scripts/check-release-readiness.sh(检查 tag 与 Release 是否匹配、校验和、tap/bucket 版本滞后、补全安装、cgo 状态)和 scripts/bump-formula.sh(由校验和渲染 formula 并可推送)。

限制与注意:GoReleaser 已弃用 brews:,无法再发布 Homebrew formula,需自行模板化推送;GITHUB_TOKEN 不能推送到其他仓库,需细粒度 PAT;跨仓库推送的 PAT 只能在浏览器创建;从 go install 迁移到包管理器时旧二进制可能遮蔽新版本;补全生成不得有副作用;归档命名应显式固定。具体配置细节见其 references 目录。