Skip to content

About

jenkins发布企微通知小工具

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Release Pilot

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。

Jenkins 接入

现有 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 和 jq
  • collect-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 代码签名。未配置签名时,工作流能生成安装包,但操作系统可能显示未知开发者或安全警告。

About

jenkins发布企微通知小工具

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages