cmux-release

cmux 發布

建議優先使用 /release 指令。該指令會判定新版本號（預設為 minor）、收集自上個 Tag 以來的 commit 紀錄、更新 CHANGELOG.md、執行 ./scripts/bump-version.sh、提交變更、執行 ./scripts/release-pretag-guard.sh，最後建立標籤並推送至遠端。

位於 web/app/[locale]/(landing)/docs/changelog/page.tsx 的文件 Changelog 頁面是直接從 CHANGELOG.md 渲染，因此不需要另外更新獨立的文件 Changelog 來源。

版本號遞增

./scripts/bump-version.sh          # minor (0.15.0 -> 0.16.0)
./scripts/bump-version.sh patch    # patch (0.15.0 -> 0.15.1)
./scripts/bump-version.sh major    # major (0.15.0 -> 1.0.0)
./scripts/bump-version.sh 1.0.0    # 指定明確版本號

此動作會更新 MARKETING_VERSION 與 CURRENT_PROJECT_VERSION。建置編號（build number）會自動遞增，且必須遞增才能使 Sparkle 自動更新功能正常運作。除非有明確的特殊要求，否則預設遞增次要版本（minor version）。

標籤管理（Tagging）

./scripts/release-pretag-guard.sh
git tag vX.Y.Z
git push origin vX.Y.Z
gh run watch --repo manaflow-ai/cmux

若 pretag 檢查防護失敗，請執行 ./scripts/bump-version.sh，提交建置編號遞增的變更，然後重試。

發布資產與 Secret 設定

• 發布資產為 cmux-macos.dmg，會附加在 Tag 之下。README 中的下載按鈕指向 releases/latest/download/cmux-macos.dmg。
• 程式碼簽署（Signing）與公證（Notarization）需要下列 GitHub secrets：APPLE_CERTIFICATE_BASE64、APPLE_CERTIFICATE_PASSWORD、APPLE_SIGNING_IDENTITY、APPLE_ID、APPLE_APP_SPECIFIC_PASSWORD、APPLE_TEAM_ID。

詳細參考文件

• references/release-checklist.md：Changelog 語氣規範、失敗排查及資產重命名後續影響。