# 历史分支处置登记 本文件记录已经完成迁移、但仍可能因为 Git 拓扑或遗留 worktree 被误判为“尚未进入 `main`”的分支。 它是分支复用、合并、cherry-pick 和清理前的必查清单。 ## 处置规则 - 标记为“禁止再次引用”的分支只允许用于只读历史追溯。 - 不得从这类分支继续开发，不得 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/fix-portal-canary-backup-ssh` **状态：禁止再次引用。改动已提交并进入 `origin/main`，该分支保留仅用于只读追溯，不是待合并开发分支。** 审计日期：2026-07-27 分支 HEAD：`7ba63a8` `origin/main` 对应提交：`7ba63a8` ### 原始用途 该分支用于修复 Portal canary 生产发布脚本在 103 完整备份阶段的 SSH 中断问题： - 将 103 full stable backup 与 persisted-data backup 拆到候选安装前的独立 SSH 步骤。 - 保留 full/persisted 备份硬闸门，后续 canary 安装远程脚本只复核已生成备份的 sha、gzip 与 `.env` 内容。 - 避免长 here-doc 发布脚本在大备份阶段被远端关闭连接后无法继续发布。 ### 已进入 `main` 的提交 | 提交 | 内容 | |---|---| | `7ba63a8` | 拆分 Portal canary 发布前 103 备份步骤 | ### 验证摘要 本分支闭环前已通过： - `bash -n scripts/release-portal-canary-prod.sh` - `node scripts/build-portal-runtime.mjs` - `ALLOW_MAIN_RELEASE=1 bash scripts/release-portal-canary-prod.sh --dry-run --yes` - Portal production Gate：187/187 通过，report commit `7ba63a83b1b52add4536a9391e3f3ea7869e569f` - `ALLOW_MAIN_RELEASE=1 bash scripts/release-portal-canary-prod.sh --yes` ### 最终处置 - 保留本地分支名用于审计追溯。 - 不要从该分支继续开发。 - 不要 merge、cherry-pick 该分支提交或从该分支构建 runtime/artifact。 - 后续开发必须从最新 `origin/main` 新建分支。 ## `codex/product-quality-p0` **状态：禁止再次引用。功能已进入 `main`，该分支不是待合并开发分支。** 审计日期：2026-07-17 历史分支基线：`6ef3ea8` 历史分支 HEAD：`ebfdc21` 审计时相对 `main`：分支侧 6 个提交、主线侧 53 个提交 ### 原始用途 该分支用于 Memind 产品质量 P0 审计与修复，内容包括： - 修复用户可见的聊天 routing/skill 前缀、旧 Page Data prompt 和部分 MindSpace/语音交互问题。 - 修复页面发布确认状态与过期未确认页面的 `owner_only` 回退。 - 将 `src/api/client.ts` 拆分为 MindSpace、发布、Page Data、Agent Jobs 等模块。 - 在 worktree 中继续处理聊天 Finish 顺序、消息按 ID 合并和发布 HTML 的预览 CSP 清理。 ### 已进入 `main` 的提交 原分支提交已经在更新后的主线基线上重新落地，不能因为 commit hash 不同而再次引用： | 原分支提交 | `main` 对应提交 | 内容 | |---|---|---| | `f7a9c21` | `77f1ea8` | 产品交互加固 | | `db17691` | `f2d0c99` | 旧 prompt 与发布确认兼容 | | `ad3c5bf` | `f6dcf5b` | MindSpace API 模块拆分 | | `3504ee0` | `8ac159a` | 发布 API 模块拆分 | | `456ec54` | `ddb3a33` | Page Data API 模块拆分 | | `ebfdc21` | `6250b59` | Agent Jobs API 模块拆分 | `456ec54` 与 `ddb3a33` 的 patch-id 不同，是因为主线重新落地时原有 Page Data 路径已经从 `/page-data` 更新为 `/admin/page-data`。两边最终的 `src/api/page-data.ts` 内容一致； `ddb3a33` 是适配更新后主线的正确落点，不是遗漏提交。 ### 遗留 worktree 的五文件修改 `/Users/john/Project/Memind-product-quality-p0` 曾保留以下五个未提交文件： - `chat-finish-sync.mjs` - `chat-finish-sync.test.mjs` - `mindspace-public-delivery.mjs` - `mindspace-public-delivery.test.mjs` - `src/utils/message.ts` 这些修改已在 `933466c`（`fix: preserve chat order and published page scripts`）进入 `main`。 2026-07-17 复核结果：其中四个 worktree 文件与 `main` 字节级一致； `chat-finish-sync.test.mjs` 的 `main` 版本额外包含两组回归测试，因此主线版本更完整。 ### 最终处置 - 不要 merge `codex/product-quality-p0`。 - 不要 cherry-pick 该分支的 6 个提交。 - 不要从其脏 worktree 复制上述五个文件覆盖主线。 - 不要从该分支或 worktree 构建任何 runtime/artifact。 - 后续开发必须从最新 `origin/main` 新建分支。 该分支及 worktree 是否删除，属于独立清理动作；删除前仍需用户明确批准。 ## `codex/retain-completed-branch-history` **状态：禁止再次引用。改动已提交并进入 `origin/main`，该分支保留仅用于只读追溯，不是待合并开发分支。** 审计日期：2026-07-28 分支 HEAD：`3de116d` `origin/main` 对应提交：`3de116d` ### 原始用途 该分支用于在长图导出时隐藏平台操作控件，并补充对应回归测试。 ### 验证摘要 - Git 祖先检查确认分支 HEAD 已进入 `origin/main`。 - 实现与回归测试分别落在 `mindspace-long-image.mjs` 和 `mindspace-long-image.test.mjs`。 - 本次仅补录历史处置事实，没有重新引用该分支或重跑历史发布。 ### 最终处置 - 保留本地分支名用于审计追溯。 - 不要从该分支继续开发。 - 不要 merge、cherry-pick 该分支提交或从该分支构建 runtime/artifact。 - 后续开发必须从最新 `origin/main` 新建分支。 ## `feature/relax-release-gate-pending-ci` **状态：禁止再次引用。改动已提交并进入 `origin/main`，该分支保留仅用于只读追溯，不是待合并开发分支。** 审计日期：2026-07-28 分支 HEAD：`a95681e` `origin/main` 对应提交：`a95681e` ### 原始用途 该分支用于在候选提交已与 `origin/main` 同步时处理 Gitea CI 长时间保持 pending 的发布闸门判定，并补充 CI 状态回归测试。 ### 验证摘要 - Git 祖先检查确认分支 HEAD 已进入 `origin/main`。 - 规则实现和回归测试分别落在 `release-gate/ci-status.mjs` 和 `release-gate/ci-status.test.mjs`。 - 本次仅补录历史处置事实，没有重新引用该分支或重跑历史发布。 ### 最终处置 - 保留本地分支名用于审计追溯。 - 不要从该分支继续开发。 - 不要 merge、cherry-pick 该分支提交或从该分支构建 runtime/artifact。 - 后续开发必须从最新 `origin/main` 新建分支。 ## `feature/relax-release-gate-rel-checks` **状态：禁止再次引用。改动已提交并进入 `origin/main`，该分支保留仅用于只读追溯，不是待合并开发分支。** 审计日期：2026-07-28 分支 HEAD：`82b74d7` `origin/main` 对应提交：`82b74d7` ### 原始用途 该分支用于调整常规 Portal 发布的 REL 检查，包括忽略本地 runtime 产物、 同步主线时的 CI 状态判定，以及通过两次干净构建验证 artifact 可复现性。 ### 验证摘要 - Git 祖先检查确认分支 HEAD 已进入 `origin/main`。 - 变更包含 `release-gate/ci-status.test.mjs`、 `release-gate/runner.test.mjs` 和 artifact 可复现脚本。 - 本次仅补录历史处置事实，没有重新引用该分支或重跑历史发布。 ### 最终处置 - 保留本地分支名用于审计追溯。 - 不要从该分支继续开发。 - 不要 merge、cherry-pick 该分支提交或从该分支构建 runtime/artifact。 - 后续开发必须从最新 `origin/main` 新建分支。 ## `codex/wechat-page-data-delivery-guard` **状态：禁止再次引用。改动已提交并进入 `origin/main`，该分支保留仅用于只读追溯，不是待合并开发分支。** 审计日期：2026-07-28 功能提交：`8bfb795` `origin/main` 对应提交：`8bfb795` ### 原始用途 该分支用于为微信 Page Data 生成与修复增加独立 Aider 发送前审核，借鉴 Tool Gateway 能力但不写入 `h5_agent_runs`，并通过用户级开关和不可变用户标识限制灰度范围。 ### 验证摘要 - 全量 Node 测试 `1399/1399` 通过。 - Page Data 专项验证 `78/78` 通过。 - 生产发布守门员单测 `90/90` 通过。 - Portal runtime 构建、运行时语法检查和 MindSpace 附件链接检查通过。 - Git 祖先检查确认功能提交已进入 `origin/main`。 ### 最终处置 - 保留本地分支名用于审计追溯。 - 不要从该分支继续开发。 - 不要 merge、cherry-pick 该分支提交或从该分支构建 runtime/artifact。 - 后续开发必须从最新 `origin/main` 新建分支。 ## `codex/wechat-page-data-canary-config` **状态：禁止再次引用。改动已提交并进入 `origin/main`，该分支保留仅用于只读追溯，不是待合并开发分支。** 审计日期：2026-07-28 功能提交：`1e91195` `origin/main` 对应提交：`1e91195` ### 原始用途 该分支用于把微信 Page Data Aider 审核开关和唐用户不可变 UUID 注入 103 候选 Portal，避免在线修改稳定 `.env`，并确保稳定 8081 与其他用户不进入审核链路。 ### 验证摘要 - 全量 Node 测试 `1399/1399` 通过。 - 生产发布守门员单测 `90/90` 通过。 - 灰度发布脚本、候选启动脚本和远端 heredoc shell 语法检查通过。 - Git 祖先检查确认功能提交已进入 `origin/main`。 ### 最终处置 - 保留本地分支名用于审计追溯。 - 不要从该分支继续开发。 - 不要 merge、cherry-pick 该分支提交或从该分支构建 runtime/artifact。 - 后续开发必须从最新 `origin/main` 新建分支。 ## `codex/wechat-page-data-canary-aider-bin` **状态：禁止再次引用。改动已提交并进入 `origin/main`，该分支保留仅用于只读追溯，不是待合并开发分支。** 审计日期：2026-07-28 功能提交：`8cd85a9` `origin/main` 对应提交：`8cd85a9` ### 原始用途 该分支用于修复 launchd 候选进程无法从系统 `PATH` 定位 Aider 的问题，将 `/opt/homebrew/bin/aider` 纳入 103 灰度预检、LaunchAgent 环境和候选启动校验。 ### 验证摘要 - 全量 Node 测试 `1399/1399` 通过。 - 生产发布守门员单测 `90/90` 通过。 - 候选启动测试确认稳定 `.env` 无法覆盖受控 Aider 绝对路径。 - Git 祖先检查确认功能提交已进入 `origin/main`。 ### 最终处置 - 保留本地分支名用于审计追溯。 - 不要从该分支继续开发。 - 不要 merge、cherry-pick 该分支提交或从该分支构建 runtime/artifact。 - 后续开发必须从最新 `origin/main` 新建分支。 ## `codex/release-gate-impact-only` **状态：禁止再次引用。改动已提交并进入 `origin/main`，该分支保留仅用于只读追溯，不是待合并开发分支。** 审计日期：2026-07-28 功能提交：`7a381db` `origin/main` 对应提交：`7a381db` ### 原始用途 该分支用于将生产发布 Gate 调整为按 Git 影响域自动选择核心和受影响场景， 取消每次生产发布自动执行 187 项全量回归；无法识别影响范围或基线异常时硬阻断发布。 ### 验证摘要 - 全量 Node 测试 `1399/1399` 通过。 - 生产发布守门员单测 `92/92` 通过。 - 对当前稳定 103 基线执行影响域选择，命中 `126/187`，无未映射文件。 - Git 祖先检查确认功能提交已进入 `origin/main`。 ### 最终处置 - 保留本地分支名用于审计追溯。 - 不要从该分支继续开发。 - 不要 merge、cherry-pick 该分支提交或从该分支构建 runtime/artifact。 - 后续开发必须从最新 `origin/main` 新建分支。