用途:在 ask-bridge 专案中执行版本号提升(patch/minor/major)、发布准备,以及 GitHub Release 建立后的繁体中文发行说明维护。触发语包含 Bump version、Bump patch/minor version、升级版本号、释出新版本、准备 Release、Bump and release。
主要能力与待更新档案:版本号须在 Cargo.toml(version = "X.Y.Z")、package.json、src/main.rs(Clap 的 #[command(version = "X.Y.Z")])、install.ps1($Version)、install.sh(VERSION)与 scripts/ask.sh(VERSION)六处保持一致。升级类型分 patch、minor、major。
使用方式:修改版本号后执行 cargo check 同步更新 Cargo.lock,必要时 cargo build --release 与 npm test;只推送 main,不建 Tag。提交采用 Conventional Commits,记录待发布 commit SHA。随后以 gh run list/watch 确认 ci.yml 对该 SHA 的 push 事件达到 completed、success,且 origin/main 仍指向该 SHA;通过后才建立并推送 vX.Y.Z 注解 Tag,且不得覆写既有 Tag。Release 建立后用 gh release view、git log、git diff 蒐集资讯,以繁体中文 Markdown 撰写发行重点、新增、修正、文件与网站、测试、注意事项与相关连结,再用 gh release edit 写入。
限制与注意:找不到 CI run、逾时、gh auth/API/网路错误或任何非 success 结果一律停止,不得以本机测试或旧 commit 结果取代;新 commit 须重跑流程。发行说明只能描述已由 commit、diff、CHANGELOG.md 或 release asset 验证的事实,资料不足须明确说明,禁止臆测。仅改 Cargo.toml 会漏掉安装脚本版本。其余未提供。