Skip to content

发布与产物说明.md

Latest commit

 

History

History
147 lines (98 loc) · 3.68 KB

发布与产物说明.md

File metadata and controls

147 lines (98 loc) · 3.68 KB

发布与产物说明

适用范围

本文档说明当前仓库的统一发布入口、Release 产物清单、手动触发参数与常见排障路径。

统一发布入口

当前唯一发布 workflow：

  • .github/workflows/release-all.yml
  • 前端 dist 会先单独构建一次，再分发给各平台打包 job 复用

触发方式：

  • 仅支持 workflow_dispatch
  • 默认不会随 push / pull request 自动触发

核心输入：

  • tag：发布标签，必填
  • ref：构建基线分支或提交，默认 main
  • prerelease：auto | true | false
  • 说明：workflow 仅负责打包与发布，不再包含服务器侧测试门

产物清单

Desktop

  • Windows：CodexManager_<version>_x64-setup.exe
  • Windows：CodexManager-portable.exe
  • macOS：CodexManager_<version>_aarch64.dmg
  • macOS：CodexManager_<version>_x64.dmg
  • Linux：CodexManager_<version>_amd64.AppImage
  • Linux：CodexManager_<version>_amd64.deb
  • Linux：CodexManager-linux-portable.zip

Service

  • Windows：CodexManager-service-windows-x86_64.zip
  • macOS：CodexManager-service-macos-arm64.zip
  • macOS：CodexManager-service-macos-x64.zip
  • Linux：CodexManager-service-linux-x86_64.zip
  • Linux（web 测试包）：CodexManager-web-linux-x86_64.zip

GitHub 默认附件

GitHub Release 仍会自动附带：

  • Source code (zip)
  • Source code (tar.gz)

pre-release 规则

  • prerelease=auto 且 tag 包含 -：发布为 pre-release
  • prerelease=auto 且 tag 不包含 -：发布为正式版
  • prerelease=true|false：强制覆盖自动判断
  • 重跑同一 tag 时，会按本次输入重新同步 Release 元数据

本地触发入口

Windows 本地辅助脚本：

  • scripts/rebuild.ps1

常见用法：

pwsh -NoLogo -NoProfile -File scripts/rebuild.ps1 `
  -AllPlatforms `
  -GitRef main `
  -ReleaseTag v0.1.9 `
  -GithubToken <token>

常用参数：

  • -AllPlatforms：触发 release-all.yml
  • -ReleaseTag：发布 tag
  • -GitRef：构建 ref
  • -Prerelease：显式指定 pre-release 状态
  • -DownloadArtifacts：触发后是否下载构建工件

平台差异说明

Windows

  • 同时产出安装版与便携版
  • 便携版当前为单独 exe，不再额外套一层 zip

macOS

  • 当前产物为 dmg
  • 由于未使用 Apple Developer 账号公证，首次启动仍可能被 Gatekeeper 拦截
  • dmg 内会带：
    • Open CodexManager.command
    • README-macOS-first-launch.txt

Linux

  • 当前桌面端提供 AppImage 与 deb
  • Service 版本以压缩包形式发布

推荐发版前检查

  1. 确认版本号已通过 scripts/bump-version.ps1 同步
  2. 确认 CHANGELOG.md 已更新
  3. 确认桌面端前端构建通过：pnpm -C apps run build
  4. 确认核心测试通过：pnpm -C apps run test、cargo test --workspace
  5. 若涉及网关协议改动，额外执行 scripts/tests/gateway_regression_suite.ps1

常见失败排查

前端工件缺失

优先检查：

  • apps/out/ 是否能正常构建
  • workflow 中前端构建步骤是否成功完成

Release 元数据不对

优先检查：

  • tag 是否包含 -
  • prerelease 是否显式覆盖了自动判断

macOS 产物可下载但首次打不开

这是当前未公证状态下的预期限制，不是 workflow 构建失败。

处理方式：

  1. 先把 CodexManager.app 拖到“应用程序”
  2. 双击 Open CodexManager.command
  3. 或执行：
xattr -dr com.apple.quarantine /Applications/CodexManager.app

相关文档