文档+配置: workflow 全面汉化 + actions 升级到 Node 24 + 关闭 docker 英文 summary (#6)

owner 反馈 GitHub Actions UI 上 'Build image and deploy to staging' 等英文
job 名、'Docker Build summary / Build inputs / Build records include...'
等英文 summary 文本不符合中文开发者团队约定。

## 汉化(全部显示字段)
- ci.yml: workflow name '持续集成'、job '构建/Vet/测试' 和 'golangci-lint'、
  所有 step name 中文(保留 golangci-lint / Go 等工具名)
- deploy-staging.yml: workflow name '测试环境部署'、job '构建镜像并部署到
  测试环境'、11 个 step name 中文
- doc/development-workflow-zh.md: 同步 4 处对 'Deploy Staging' 显示名的
  引用,改为 '测试环境部署 (deploy-staging.yml)' 形式,以文件名锚定

## 关闭 docker/build-push-action 英文 summary
deploy-staging.yml workflow env 加 DOCKER_BUILD_SUMMARY=false。原来跑完
build 那个英文 'Docker Build summary / Build inputs / ...' 块在 GitHub
Actions UI 上不再出现。部署结果靠 Telegram 通知传递。

## actions 升级到支持 Node 24 的版本
GitHub Runner 报 Node 20 deprecated 警告,9 月 16 日强制移除。本次一次
性升级到当前 latest:
- actions/checkout v4 -> v6
- actions/setup-go v5 -> v6
- docker/setup-buildx-action v3 -> v4
- docker/build-push-action v6 -> v7
- appleboy/scp-action v0.1.7 -> v1.0.0 (正式版)
- appleboy/ssh-action v1.0.3 -> v1.2.5
- golangci/golangci-lint-action v6 -> v9 (Node 24,仍支持 version: latest
  和 only-new-issues: true)

不改:
- workflow .yml 文件名(gh CLI / 文档引用都用文件名锚定,不动)
- secret 名 / env var 名(约定俗成全大写英文)
- Telegram 通知正文(本来就是中文)

## 后续
agent prompt(架构师/QA/devops)里引用 'Build, vet, test' / 'Deploy
Staging' 显示名的部分,PR merge 后另外 multica agent update 同步。
不在本 PR 范围。
This commit is contained in:
2026-06-03 06:48:41 -07:00
committed by GitHub
parent 19d28a8f89
commit f6f2ca9a29
3 changed files with 40 additions and 37 deletions
+4 -4
View File
@@ -9,7 +9,7 @@
```
Multica issue → 分支 fix/<num>-中文简述 → 推 github → 开 PR → CI 绿 → 架构师 approve
→ GitHub UI Squash and merge 进 internal → Deploy Staging 自动跑
→ GitHub UI Squash and merge 进 internal → 测试环境部署 (deploy-staging.yml) 自动跑
→ QA 在 staging 验收 → Multica issue → done
发版时:架构师把 internal squash 进 main → 对外正式版本
@@ -111,7 +111,7 @@ gh pr create --base internal --title '修复(#<num>): ...' --body-file <path>
- **必须用 GitHub UI 的 "Squash and merge"**。
- squash 后 commit message 由架构师编辑确认:保持 `<类型>(#<num>): ...` 形式 + 必要正文。
- 合并按钮按下后 PR 自动 close,分支由 GitHub 自动删("Automatically delete head branches" 应开启)。
- 架构师在 Multica issue 上 `@运维工程师` 附 commit hash,通知可以部署(虽然 Deploy Staging 已自动跑,但运维需要确认部署状态)。
- 架构师在 Multica issue 上 `@运维工程师` 附 commit hash,通知可以部署(虽然测试环境部署 workflow 已自动跑,但运维需要确认部署状态)。
**禁止做的事**
- ❌ 在本地 squash 再 `git push``internal` / `main`
@@ -121,7 +121,7 @@ gh pr create --base internal --title '修复(#<num>): ...' --body-file <path>
- ❌ 自己 approve 自己的 PR
- ❌ 未经测试工程师验收的分支合并(架构师红线)
### 2.7 Deploy Staging 自动触发
### 2.7 测试环境部署自动触发 (`.github/workflows/deploy-staging.yml`)
合并到 `internal` 后,`.github/workflows/deploy-staging.yml` 自动触发:
@@ -159,7 +159,7 @@ gh pr create --base main --head internal --title '发版: <版本号>'
| `todo` | 已排期,待 assigned agent 开始 |
| `in_progress` | 分支已开始写,未 push |
| `in_review` | PR 已开,等 review / CI / merge |
| `done` | PR merged + Deploy Staging 通过 + QA 验收通过 |
| `done` | PR merged + 测试环境部署通过 + QA 验收通过 |
**三个条件没全满足就不要标 done**——否则验收链路看不到真问题。