JianFeeeee 8cdcbf70fb ci: 发布流水线 —— release/** 推送即发版（tag/打包/发布/镜像全自动化） ...

## 设计

版本号唯一事实源是 internal/meta/meta.go 的 Version（仓库纪律），
所以发版动作 = 在 release/vX.Y.x 上把 meta.Version 改成目标版本后推送：

  prepare      读版本号；tag 已存在则整轮跳过（幂等闸门，改文档不会重发）
  build-linux  go build + go test 过门 → 下载资产 → 打包 3 deb + 1 tar.gz
               → 平铺 → 验证（deb 元数据/模型在位/校验和自验）→ artifact
  publish      打 tag → gh release create 传附件 → 回读下载验证校验和
  sync-gitcode 有 GITCODE_TOKEN 时同步 tag+附件到 gitcode（无则跳过不阻断）

## 关键事实（全部本地实测过才写进 workflow）

1. **编译不需要 ONNX Runtime**：onnxruntime_go 是 dlopen 方式（运行期才
   加载 .so），本地在清空 ORT 相关环境变量的条件下带 -tags=onnxruntime
   编译通过（83M）。CI 只需在**打包**时有 ORT（要打进 deb）。
2. **构建资产托管在 release ci-assets-v1**（已上传）：
   chinese-clip-vit-b16-onnx.tar 719MB + onnxruntime-linux-amd64-1.28.0.tar
   24MB + SHA256SUMS。模型内容不随版本变 ⇒ 一次上传反复复用，CI 打包前
   下载并 sha256sum -c 校验。上传实测 3.2MB/s，构建期下载同源更快。
3. **打包链路在干净 worktree 全程实跑通过**（release/v1.3.x + VERSION=1.3.13）：
   full 800M / server 726M / client 80M / tar.gz 841M，SHA256SUMS 平铺自验
   4/4 OK，full 包内确认含 TextEncoder/VisionEncoder.onnx 与 libonnxruntime.so。
4. **SHA256SUMS 的坑**：脚本把校验和写成平铺名（./xxx.deb），而产物在
   deb/ tar/ 子目录 ⇒ 直接 -c 会全 FAILED。workflow 里显式平铺后再验。
   （呼应 git-branching.md §七「校验和必须覆盖全部附件、只传一次」。）
5. ORT 资产补齐了缺失的 LICENSE + ThirdPartyNotices.txt（取自
   microsoft/onnxruntime v1.28.0 tag，与本地 .so 的内嵌版本号一致）——
   打包脚本的 stage_multimodal_assets 对这两文件非空校验，缺失即失败。
6. actionlint 全绿（修掉了 shellcheck SC2012：ls 改 stat 循环）。

## 已知边界

- arm64 发布产物暂缺（package-linux.sh 支持，但 CI 未配 QEMU 交叉；待需要时加 matrix）。
- Windows 安装器未纳入（需 electron-builder win 打包，单独验证后接入）。
- sync-gitcode 依赖 secret GITCODE_TOKEN（待用户配置；未配置时该 job 显式跳过）。

2026-09-29 13:07:36 +08:00

..

ci.yml

ci: 建立 GitHub Actions 流水线（六个 job，全部命令已本地实测）

2026-09-29 10:23:21 +08:00

release.yml

ci: 发布流水线 —— release/** 推送即发版（tag/打包/发布/镜像全自动化）

2026-09-29 13:07:36 +08:00