Files
cc-web/.planning/history-control-position/task_plan.md
2026-09-13 23:59:27 +08:00

44 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 修复历史消息入口位置
## 目标
将“还有 N 条更早消息 / 查看更早消息”入口放回消息流顶部的正常文档流中,避免它在滚动时悬浮、跟随内容或遮挡消息;同时保留连续翻页和失败重试能力。
## 阶段
| 阶段 | 状态 | 验收标准 |
|---|---|---|
| 1. 定位历史入口的 DOM、脚本和样式链路 | complete | 明确控件是否由 fixed/sticky 定位、插入到哪个滚动容器及滚动时的行为 |
| 2. 补充控件位置回归断言 | complete | 回归能锁定入口必须位于消息流顶部且不使用悬浮定位 |
| 3. 调整历史入口的 DOM 插入和滚动逻辑 | complete | 控件作为消息列表首部普通节点显示,加载后不跟随视口悬浮 |
| 4. 调整样式并兼容窄屏布局 | complete | 桌面和窄屏下入口均保持正常流布局,不遮挡消息内容 |
| 5. 运行定向回归、语法检查和差异检查 | complete | 相关回归、JS 语法检查、git diff --check 全部通过 |
| 6. 清理临时记录并交付修改结果 | complete | TODO CSV 删除,工作区仅保留本次修改并明确验证结果 |
## 机器可读阶段状态
### Phase 1:定位历史入口的 DOM、脚本和样式链路
**Status:** complete
### Phase 2:补充控件位置回归断言
**Status:** complete
### Phase 3:调整历史入口的 DOM 插入和滚动逻辑
**Status:** complete
### Phase 4:调整样式并兼容窄屏布局
**Status:** complete
### Phase 5:运行定向回归、语法检查和差异检查
**Status:** complete
### Phase 6:清理临时记录并交付修改结果
**Status:** complete
## 错误记录
| 错误 | 尝试 | 处理 |
|---|---|---|
| 定向历史回归按预期失败:历史控件仍为绝对定位 | 1 | 已证明新增契约能捕获当前悬浮实现,进入布局修复 |
| `curl` 返回 23 | 1 | 仅因输出管道被 `rg -m 1` 提前关闭;同一响应已成功打印目标 CSS 片段,非服务错误 |