Release Pilot 是面向 Windows 和 macOS 的版本发布通知助手。它从本地或远程 Git 仓库、Jenkins PREPARE 产物中收集发布证据,生成非 IT 员工能理解的中文企微通知,经过人工审核后再触发 Jenkins 发布。
- 多项目、发布单元和目标分支配置
- 本地仓库,或应用管理缓存中的 HTTPS/SSH 远程仓库
- Conventional Commits 驱动的 SemVer、RC 和 Stable 版本提案
v{version}与{unit}-v{version}等 Tag 模板- OpenAI Responses API 与 Anthropic Messages API
- 隔离运行本地 Codex CLI 或 Claude CLI,不读取目标仓库
- 明确确认后从
OPENAI_API_KEY或ANTHROPIC_API_KEY导入系统凭据库 - Jenkins
PREPARE -> review -> WeCom -> DEPLOY两阶段流程 - 适配既有 Jenkins 参数化 Job,支持一个项目按后端、前端顺序串行发布
- 根据 Git 变更路径推荐 Jenkins 发布项,发布人员可在执行前增删选择
- SQLite 本地状态库,以及 macOS Keychain / Windows Credential Manager 密钥存储
- 默认开启 Simulation Mode,禁止通知、部署、Tag 和 Push
- AI 输出始终是草稿,必须人工审核。
- 提交说明不足时,版本级别与业务含义需要人工确认。
- 企微通知超过 3800 字节时阻止发送,不会静默截断。
- 不跳过 TLS 或 SSH 主机校验,不覆盖远程 Tag,不执行 force push。
- 当前界面不会自动创建或推送 Tag;Tag 发布必须在部署成功状态接入完成后启用。
- 未经单独确认,不应连接生产 Jenkins、生产企微群或生产 Git 写入 Remote。
现有 Job 模式会先只读检查所有已选 Job 的 config.xml 参数,然后发送一次企微通知,再按后端、前端、其他的顺序触发 buildWithParameters。默认等待每个 Job 成功后再执行下一个;Simulation Mode 只做配置检查,不通知、不构建。
Release Pilot 协议模式的接入包位于 jenkins/:
Jenkinsfile.example:参数化 PREPARE/DEPLOY 示例release-evidence.schema.json:schemaVersion: 1证据契约collect-release-evidence.sh:Linux/macOS Agent,需要git和jqcollect-release-evidence.ps1:Windows Agent
将示例和对应脚本复制到需要发布的仓库并替换 Git 地址、凭据 ID 和实际部署步骤。PREPARE 必须归档 release-evidence.json;DEPLOY 必须检出 Release Pilot 传入的精确 COMMIT_SHA。
pnpm install
pnpm tauri dev验证:
pnpm build
cargo test --manifest-path src-tauri/Cargo.toml
cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets -- -D warnings
pnpm tauri build --debug单台 macOS 电脑执行 pnpm tauri build 只会生成当前平台支持的 .app 和 .dmg,不会同时生成 Windows 安装程序。仓库的 .github/workflows/release.yml 会在一次发布中并行完成:
- macOS Runner:生成 Apple Silicon
.dmg - Windows Runner:生成 x64 NSIS
-setup.exe - 两个平台的安装包上传到同一个 GitHub Draft Release
先同步 package.json、src-tauri/tauri.conf.json 和 src-tauri/Cargo.toml 中的版本并提交,然后运行:
pnpm release该命令会创建并推送 v{version} Tag,触发跨平台构建。构建结束后,到 GitHub Releases 检查 DMG 和 EXE,完成真实机器冒烟测试,再发布草稿。也可以在 GitHub Actions 页面手动运行 Build desktop release。
本机仅构建当前平台安装包时运行:
pnpm release:local正式公司分发前还需要配置 macOS 签名与公证、Windows 代码签名。未配置签名时,工作流能生成安装包,但操作系统可能显示未知开发者或安全警告。