docs(guide): changelog 直接 commit main + author 字段必填说明
所有检测均成功
changelog-filename-gate / validate (push) Successful in 1s

这个提交包含在:
API Changelog Bot 2026-08-03 22:36:58 +08:00
父节点 ab0067c309
当前提交 c101715232

查看文件

@ -62,14 +62,24 @@ npm run check:frontmatter -- --base origin/main --head HEAD
## 4. 提交和推送 ## 4. 提交和推送
只暂存本次 changelog 文件: 只暂存本次 changelog 文件,**直接 commit main**(不建分支/PR
```powershell ```powershell
git status --short git status --short
git add -- changelogs-v2/2026-07/24_5205_车务首页汇总状态补全-修改接口-管理后台.md git add -- changelogs-v2/2026-07/24_5205_车务首页汇总状态补全-修改接口-管理后台.md
git diff --cached --check git diff --cached --check
git commit -m "docs: hand off API contract (#5205)" git commit -m "docs: hand off API contract (#5205)"
git push -u origin <任务分支> git push origin main
``` ```
然后向 `main` 创建 PR。不要提交其他任务的 changelog、`.tmp-*` 文件或任何凭据。 不要提交其他任务的 changelog、`.tmp-*` 文件或任何凭据。
## 5. author 字段(必填)
所有 changelog frontmatter 必须包含 `author` 字段,格式为推送者登录名 + `(GIT)` 后缀:
```yaml
author: "wx(GIT)" # wx 推送写 wx(GIT);yst 推送写 yst(GIT);以此类推
```
谁 push 到 main 就写谁,多会话并行时用于追溯该条 changelog 的推送人。新写文件必须带;修改旧文件时顺手补上。