fix(changelog): restore stable path aliases for #5252
changelog-filename-gate / validate (pull_request) Successful in 2s
changelog-filename-gate / validate (pull_request) Successful in 2s
这个提交包含在:
@@ -49,6 +49,30 @@ not_required
|
||||
|
||||
## 更新命令
|
||||
|
||||
### 存在历史路径 alias 的文档
|
||||
|
||||
消费线程已经记录的路径不得因文件改名失效。先解析路径:
|
||||
|
||||
```powershell
|
||||
npm run changelog:resolve -- "changelogs-v2/2026-07/旧路径.md"
|
||||
```
|
||||
|
||||
状态回写统一使用 alias-aware 命令;传旧路径或 canonical 均会同时更新整组文件:
|
||||
|
||||
```powershell
|
||||
npm run changelog:transition -- `
|
||||
"changelogs-v2/2026-07/旧路径.md" implemented `
|
||||
--owner frontend-team `
|
||||
--frontend-ref "mmg/hl-ui@abc1234" `
|
||||
--write
|
||||
```
|
||||
|
||||
相同状态和证据可以重复执行,第二次不会产生文件变更。alias 关系集中记录在
|
||||
`changelog-path-aliases.json`,并由 `npm run check:path-aliases` 校验文件存在性、ticket、
|
||||
canonical 指向及前端状态一致性。
|
||||
|
||||
### 无 alias 的文档
|
||||
|
||||
领取:
|
||||
|
||||
```powershell
|
||||
@@ -107,3 +131,4 @@ QA 或产品可以协助更新 `verified_at`,但必须基于实际页面验证
|
||||
- `hl-changelog/v1` 继续可读和索引,不强制一次性迁移。
|
||||
- 文件名带“前端待处理”不代表真实状态;需要继续流转时补充 v2 元数据。
|
||||
- 不通过重命名表达消费状态,避免破坏文件名校验和历史链接。
|
||||
- 已被消费的路径如确需规范化,必须先登记 alias、保留兼容入口,并使用 alias-aware 命令同步状态。
|
||||
|
||||
在新工单中引用
屏蔽一个用户