cc-web/.planning/sidebar-title-refresh-storm/progress.md

进度记录：侧栏标题刷新风暴

会话：2026-07-30

阶段 1：确认索引与侧栏更新链路

• 状态： complete
• 开始时间： 2026-07-30 15:25 +08:00
• 已完成：
  • 阅读用户截图并记录视觉现象。
  • 扫描并启用 planning-with-files 与 todo-list-csv 技能。
  • 执行会话恢复检查，未发现未同步上下文。
  • 完成 Trellis 会话初始化检查，发现当前任务仍指向一项旧主题任务。
  • 将用户关于“不要按猜测调查”的约束写入调研记录。
  • 计划文档通过独立子代理审查。
  • 确认 home-cc-web 代码索引就绪，初步定位 renderSessionList。
  • 读取 renderSessionList 完整源码并追踪入站调用，确认每次调用都会清空并重建整个列表。
  • 核验 handleServerMessage：session_list 与 session_message 均会无条件全量重建侧栏，流式文本事件不会直接重建。
  • 追踪服务端列表发布链路：完整列表无去重/节流，且子代理状态更新是广播入口之一。
  • 建立子代理更新闭环：每个 child 增量都会无条件广播完整 session_list，前端随后整段替换侧栏。
  • 确认 child 增量每次都会改写父会话 updated，所以完整载荷去重不足；现有测试也未覆盖节点身份稳定性。

阶段 2：复现并定位高频重绘根因

• 状态： complete
• 开始时间： 2026-07-30T07:35:21.137Z
• 下一步：
  • 已通过代码调用链确认子代理与普通消息均可能触发全量替换。
  • 已确认服务运行指标正常，排除服务进程阻塞。

阶段 3：回归测试与修复

• 状态： complete
• 开始时间： 2026-07-30T07:43:47.002Z
• 已完成：
  • 创建独立 Trellis 任务、PRD、根因研究文件及 implement/check 上下文。
  • 新增 DOM 级失败回归，旧实现按预期失败于“仅 updated 变化仍清空列表”。
  • 新增结构签名缓存和相对时间原位刷新，实现节点身份与点击监听器稳定。
  • 新增服务端失败回归，旧实现缺少 child 更新合并并会逐次保存、逐次广播完整列表。
  • 同一父会话 250ms 内复用待保存快照，尾随冲刷前重读最新会话；最终态立即保存。
  • 合并 child 引起的完整列表广播，同时保留每次局部工具卡 WebSocket 更新。

阶段 4：验证与交付

• 状态： complete
• 开始时间： 2026-07-30T08:10:22.442Z
• 已完成：
  • 定向侧栏刷新回归通过。
  • 侧栏折叠、会话工具提示、子代理卡片路由回归通过。
  • public/app.js 与 scripts/regression.js 语法检查通过。
  • git diff --check 通过。
  • 完整 npm run regression 在 60 秒超时约束内通过。
  • 服务端 child 更新合并定向回归通过，既有子代理卡片路由回归通过。
  • 用户重启后暴露 oldSessionCollapseKey 漏解构；新增历史会话折叠分支回归先复现同一 ReferenceError，再补回字段。
  • 更新前端静态资源缓存版本；从运行中的 HTTP 服务确认新 index 与修复后的 app.js 已生效。
  • 修正后定向回归、语法检查、diff 检查与 60 秒完整回归再次通过。
  • 最终独立 diff 审查通过，确认签名提交时机、sibling child 保留、缓存版本号和未定义变量均无阻塞问题。
  • 重启后的运行态观察：ccweb 同一 PID 在线，CPU 约 0.6%，连续 HTTP 200 约 0.9–5.8ms；未读取敏感环境配置。
• 下一步：
  • 无；服务端后续重启需先确认除当前对话外没有其他 running 对话。
• 创建文件：
  • .planning/sidebar-title-refresh-storm/task_plan.md
  • .planning/sidebar-title-refresh-storm/findings.md
  • .planning/sidebar-title-refresh-storm/progress.md

测试结果

测试	预期	实际	状态
失败回归（修复前）	仅 updated 变化不应再次清空	缺少结构签名/旧实现再次清空	预期失败
服务端失败回归（修复前）	child 突发合并保存与完整列表广播	缺少 isFinalCcwebMcpChildStatus 及批处理实现	预期失败
侧栏刷新定向回归	节点稳定且真实结构变化重建	通过	✓
child 更新合并回归	3 次局部推送、1 次保存、1 次完整列表广播，最终态立即落盘	通过	✓
历史会话折叠失败回归	隐藏会话存在时应保留折叠键并正常渲染	修复前复现同一 ReferenceError；修复后通过	✓
部分渲染失败恢复回归	首轮异常后再次渲染必须重建完整置顶/项目 DOM	修复前失败；签名延后提交后通过	✓
共享 spawnToolId sibling 回归	同一工具下多个 child 最终状态都落盘	修复前第一个 sibling 丢失；按 threadId 去重后通过	✓
相关定向回归	折叠、提示、子代理路由无回退	通过	✓
JS 语法与 diff 检查	server.js、public/app.js、scripts/regression.js 无语法/空白错误	通过	✓
完整 regression	全量回归通过	Regression checks passed	✓

错误日志

时间	错误	次数	处理
2026-07-30T07:49:41.008Z	误用执行单元等待接口	6	切换到 collaboration.wait_agent；实现任务未受影响
2026-07-30T07:49:41.008Z	错误日志补丁再次因动态时间上下文不匹配	1	改为匹配稳定表头追加
2026-07-30T07:44:54.498Z	full-history fork 不能同时覆盖为 worker 角色	1	改用 fork_turns: none，通过磁盘 PRD 和 JSONL 注入完整上下文
2026-07-30T07:46:30.649Z	Default 模式下 request_user_input 不可用	1	不需要用户输入，停止调用并继续实现
2026-07-30T07:46:30.649Z	错误日志补丁的动态时间上下文不匹配	1	读取稳定尾部后重新追加，未重复原失败补丁
2026-07-30T16:45:00+08:00	renderSessionList 漏解构 oldSessionCollapseKey，用户重启后前台 ReferenceError	1	新增实际隐藏会话分支回归复现，补回解构并更新缓存版本，完整回归通过