cc-web/.planning/history-message-recall/task_plan.md

修复历史消息回看入口

目标

让被本地展示裁剪的旧消息仍然可通过明确入口回看，保留当前渲染性能与会话加载稳定性。

步骤

• 定位消息裁剪逻辑、历史数据来源和现有接口
• 明确按需加载旧消息的交互与数据边界
• 实现历史消息回看入口及服务端/客户端衔接
• 补充裁剪与历史回看回归测试
• 运行测试并核验兼容性，完成后按约定清理临时 TODO 文件

验收标准

• 默认加载仍只渲染最近 45 条（或当前代码实际配置的同等窗口），不会因增加入口而自动拉取全部旧消息。
• 出现“省略 50 条旧消息”时，界面有清晰可操作的回看入口，而不是只有数量提示。
• 用户点击入口后能看到被省略消息的真实内容，并可继续按页查看更早消息。
• 回看后的顺序、时间线、角色、内容和现有消息渲染保持正确；滚动位置不会跳乱。
• 覆盖空历史、旧消息不足一页、连续多页、重复点击、加载失败和新消息并发到达等边界。

错误记录

错误	尝试	处理

当前决策

• 不删除旧消息数据，只调整本地展示和按需加载路径。
• 先复用现有会话消息接口；只有确认接口无法分页时才扩展接口。

风险与约束

• 优先使用分页/游标加载，避免一次性把全部历史复制到浏览器内存。
• 历史加载与实时新消息并发时，必须按稳定消息索引或 ID 去重并保持排序。
• 历史接口沿用会话归属校验；失败时给出可理解的错误反馈并允许重试。
• 不能破坏现有裁剪提示、缓存、滚动位置和消息渲染批处理。

已确认实现边界

• 旧消息优先从 Claude JSONL / Codex rollout 原始记录恢复；cc-web 快照只作为无原始记录时的降级来源。
• 正常打开会话只渲染最近窗口；历史按钮使用现有 load_history_page WebSocket 按游标加载。
• 搜索命中跳转仍允许目标预取，不受普通会话的按需加载策略影响。