JianFeeeee f339850ffb docs(ci): CI/CD 流水线手册 —— 用法、机制与 6 个踩过的坑 ...

仓库迁 GitHub 后新增两条流水线（ci.yml / release.yml），但用法与机制
此前只存在于 workflow 的注释和提交信息里。发版是高频操作，写成手册。

内容：
- §1 CI 六个 job 与「明确不进 CI」的清单（真机/密钥/内网依赖）
- §2 发版标准流程、幂等闸门（tag 存在即跳过）、
     发版门（go build 硬门 + go test 可用 [skip-release-tests] 跳过）
- §2.5 构建资产（ci-assets-v1）的托管与升级方式
- §3 六个实测踩过的坑：
      3.1 workflow 文件必须存在于目标分支（否则推 release/** 不触发）
      3.2 runner 无 electron 缓存 ⇒ 必须 npm ci（且不能用 --production）
      3.3 管道里的 grep -q 因 SIGPIPE 误杀检测（800M 包必炸）
      3.4 gh 在非 git 目录要显式 --repo
      3.5 gitcode 上传的 ASSET_DIR + 裸名语义
      3.6 手工补发 gitcode 附件的流程
- §4 SDK 仓的差异（独立 module 测试要跑两处、CGO 不需要）
- §5 关于失败邮件的说明（可能是验证步骤自身 bug 的假警报）

markdownlint 全绿（两个产物清单代码块补了 text 语言标注）。

2026-09-29 15:03:05 +08:00

..

zh

docs(ci): CI/CD 流水线手册 —— 用法、机制与 6 个踩过的坑

2026-09-29 15:03:05 +08:00

git-branching.md

docs: 删除迁移期临时文档，现行内容搬进正式文档

2026-09-19 19:22:48 +08:00