docs: keep completed branches as registered history
This commit is contained in:
@@ -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`
|
||||
|
||||
|
||||
Reference in New Issue
Block a user