docs: keep completed branches as registered history

This commit is contained in:
john
2026-07-27 22:19:00 +08:00
parent a95681ea3a
commit aff6ddf9d3
2 changed files with 52 additions and 5 deletions
+47
View File
@@ -9,6 +9,53 @@
- 不得从这类分支继续开发,不得 merge、cherry-pick、打包或发布。
- 不得把旧 worktree 中的未提交文件直接覆盖到当前主线;应先与最新 `origin/main` 逐文件比较。
- 若确需恢复历史代码,必须重新评估当前 `main`,在最新主线上建立新分支,并重新执行对应测试和 verify。
- 已提交、已合入并已进入 `origin/main` 的开发分支可以保留本地分支名;保留只用于审计和追溯,不代表还有待合并工作。
- 远端功能分支默认在闭环后删除;发布和审计依据使用 `main` commit、tag、CI 记录或 runtime manifest,不使用功能分支名。
- 这类保留分支必须在本文件登记清楚:分支名、最终 HEAD、进入 `origin/main` 的提交、验证摘要,以及“禁止再次引用”的状态。
## `feature/fix-rybbit-publication-tracking`
**状态:禁止再次引用。改动已提交并进入 `origin/main`,该分支保留仅用于只读追溯,不是待合并开发分支。**
审计日期:2026-07-27
分支 HEAD`90ee4c3`
`origin/main` 对应提交:`90ee4c3`
### 原始用途
该分支用于补齐 `m.tkmind.cn` 发布页 Rybbit tracking
-`/u/:owner/pages/:slug``/MindSpace/:user/public/...` 发布页 HTML / shell 注入 Rybbit tracker。
- Portal bootstrap 在 Rybbit env secret 缺失时复用 `mindspace_config` 中存储的 MindSpace analytics secret。
- 补充发布页交付、domain bootstrap 与 Rybbit 配置测试。
### 已进入 `main` 的提交
| 提交 | 内容 |
|---|---|
| `c7718c6` | 注入 Rybbit tracking 到发布页交付链路 |
| `90ee4c3` | 修复空字符串 env secret 阻断存储 secret fallback |
### 验证摘要
本分支闭环前已通过:
- `node --test mindspace-rybbit.test.mjs server/portal-domain-services-bootstrap.test.mjs server/portal-published-page-delivery.test.mjs server/portal-publication-shell.test.mjs`
- `npm run verify:chat-finish-sync`
- `npm run verify:mindspace-publish-guards`
- `npm run verify:mindspace-publish-guards:full`
- `npm run verify:mindspace-page-sync-guards`
- `npm run verify:h5-session-patches`
- `npm run build`
- `npm test`
### 最终处置
- 保留本地分支名用于审计追溯。
- 远端功能分支如曾创建,应在确认 `origin/main` 包含对应提交后删除;发布依据是 `90ee4c3` 及后续 main/tag/manifest,不是该功能分支名。
- 不要从该分支继续开发。
- 不要 merge、cherry-pick 该分支提交或从该分支构建 runtime/artifact。
- 后续开发必须从最新 `origin/main` 新建分支。
## `codex/product-quality-p0`