用途:在 macOS 上执行 Kaku 的完整发布流程。scripts/release.sh 为权威入口,覆盖预检、构建、公证、打标签、上传 GitHub Releases 及触发 Homebrew tap;scripts/nightly.sh 负责滚动 Nightly 预发布包。
主要能力:release.sh 分阶段运行 preflight、stage:checks、stage:build(universal 包,产出 dist/Kaku.app、Kaku.dmg、kaku_for_update.zip 及其 sha256)、stage:notarize(优先 rcodesign,失败可回退 notarytool)、stage:tag、stage:upload、stage:homebrew-tap。nightly.sh 构建通用版并公证、装订,复制为 dist/Kaku-nightly.dmg 后重建 nightly 预发布。
使用方式:需在 main 分支、工作树干净且与 origin/main 同步。常用命令:./scripts/release.sh --dry-run 仅预检;KAKU_ASC_API_KEY_PATH=/dev/null ./scripts/release.sh 在网络较慢时走 notarytool 回退;./scripts/release.sh 直接走 AWS 路径;./scripts/nightly.sh 生成 Nightly。失败恢复可用 --notarize-only、--upload-only、--tap-only,需保留 dist 产物。环境变量含 KAKU_SIGNING_IDENTITY、KAKU_ASC_API_KEY_PATH、KAKU_NOTARYTOOL_PROFILE、HOMEBREW_TAP_TOKEN、REQUIRE_HOMEBREW_TAP_UPDATE、RUN_CLIPPY、SKIP_TESTS、OUT_DIR、PROFILE、BUILD_ARCH。
准备与限制:需一次性配置签名与公证凭据,rcodesign 用 cargo install apple-codesign 安装;发布前需核对版本、config_version、RELEASE_NOTES.md 中英内容,并手动跑运行时冒烟项(窗口、标签栏、shell 初始化、AI chat)。Nightly 不升版本、不建 V* 标签、不更新 Homebrew。常见阻塞含 rcodesign S3 连接超时(用 /dev/null 前缀绕过)、Homebrew tap 校验因 Fastly 缓存误报超时等。更细的收费、平台支持范围、官方说明等信息暂未提供。