# 调研发现

- `server.js` 中 `resolveSessionHistory` 位于约 4489 行，session_info、session_history_chunk、resume_session_result 多处复用。
- `lib/codex-rollouts.js` 是 native rollout 解析入口，需结合 server.js 的持久化写入路径分析。
- `public/app.js` 已有 `renderMessages` 与 `reconcileRenderedSessionMessages`，前端存在重连/历史刷新竞态相关逻辑。
- codebase-memory 项目 `home-cc-web` 索引状态为 ready（8208 nodes / 19300 edges）。
- 工作区存在用户已有未提交改动：`lib/ccweb-mcp-server.js`、`scripts/ccweb-message-reply-unit.js`，本任务不触碰。


- 2026-09-21：db04e08 已删除全量 native 替换，但 merge 的数值 baseIndex 回退仍不可靠；messagesEquivalent 不支持 codexAppTurnId 与 native turnId 跨来源对齐。
- 前端 prepend/reconcile 仍以相同下标跳过不同 ID，缓存也会按下标覆盖不同消息。
- sessions/35394008-4f0c-43c0-a481-b622d9e6b884.json 本机暂未找到，不能假装完成迁移。

- 自动回传使用 buildCrossConversationReplyAutoRunText 的“子对话回传已返回……”包装，需与“来自……”投递包装分别精确识别；两者均不能作为普通用户消息。
- response_item 中存在 AGENTS/environment 等用户角色上下文；有 event_msg.user_message 时以事件为权威，仅从匹配 response 补充 ID。
- done 原来不携带持久化助手身份，结束后的本地 stream 与刷新消息无法去重；现已将最终消息及合并后下标通过 done 传递。
- 新迁移能力通过已认证 WebSocket 在服务端同步检查/备份/写入；单文件提供 --migrate-session-history 入口，默认预览，--apply 写入。

## 2026-09-21 旧会话迁移复盘

 - `sessions/35394008-…json` 的截断提示结构化字段完整，但仍报 `history_boundary_unconfirmed`：快照首条是 cc-web 专有的跨对话回传显示气泡（`ccwebDisplayOnly`），rollout 里不存在对应记录，旧规则只认首条锚点就直接放弃确认。
 - mergeHistorySegments 的 turn 别名键会把 native 前缀里同一 turn 的多条气泡折叠成一条，实测丢掉 9 条助手正文（2537 字）；native 前缀必须按自身 ID 去重，不能按 turn 去重。
 - rollout 解析器会把同一条气泡拆成多条空文本工具片段且共用同一 `history-assistant:<hash>` ID，前端按稳定 ID 去重时只保留最后一条；前缀侧需要先按 ID 合并片段（正文拼接、工具调用并集）再交给前端。
 - 迁移后文件不再带截断提示，未升级的旧服务进程也会走 snapshot 分支把 739 条全部展示，historyAvailable 为 true，因此迁移不必等待服务重启。