65 lines
4.0 KiB
Markdown
65 lines
4.0 KiB
Markdown
# 使用统计看板产品化优化计划
|
||
|
||
## 目标
|
||
|
||
在不改变统计协议、统计口径和现有聊天功能的前提下，以用户原型提供的信息架构为基础，将使用统计看板优化为符合 cc-web 产品语言的运营工作台，并保持全部现有主题和响应式视口可用。
|
||
|
||
## 完成标准
|
||
|
||
- 桌面端信息架构对齐原型：顶部标题与筛选、五张指标卡、左趋势右 MCP 明细、左状态右 Skill 排行、底部最近会话。
|
||
- 使用现有真实统计数据，不伪造组织、用户、时长或人工/自动消息等当前协议未提供的数据。
|
||
- 保留本周、本月、自定义日期、MCP 明细、会话跳转、加载/空态/错误态。
|
||
- 11 个现有主题均通过语义变量适配；浅色主题贴近原型，深色主题保持相同布局层级。
|
||
- 参考视口、常规桌面、平板和手机通过真实浏览器检查。
|
||
- 不修改聊天消息 DOM、生成状态、草稿、附件和会话 JSON。
|
||
|
||
## 阶段
|
||
|
||
1. [complete] 建立代码基线并归档参考原型
|
||
2. [complete] 量化原型并映射现有 DOM 与数据
|
||
3. [complete] 重构看板 DOM 与渲染结构
|
||
4. [complete] 实现原型版式与主题视觉
|
||
5. [complete] 适配交互状态与响应式布局
|
||
6. [complete] 补充统计看板回归契约
|
||
7. [complete] 执行自动化与真实浏览器验收
|
||
8. [complete] 检查运行会话并安全更新预览
|
||
9. [complete] 固化产品化优化原则与改动边界
|
||
10. [complete] 精简统计看板信息架构与文案
|
||
11. [complete] 将 MCP 明细重构为侧边抽屉
|
||
12. [complete] 重做桌面端去卡片化视觉层级
|
||
13. [complete] 优化手机端指标带与响应式布局
|
||
14. [complete] 更新回归契约与静态资源版本
|
||
15. [complete] 执行多主题多视口视觉验收
|
||
16. [complete] 执行专项全量回归与在线确认
|
||
|
||
## 决策
|
||
|
||
- 这是现有功能页返工，不新增主题 ID。
|
||
- 原型图只作为构图证据并归档，不作为产品运行时资产。
|
||
- 当前数据协议没有的数据不伪造；对应区域用现有指标重新表达。
|
||
- 遵照用户要求，不派额外审计代理。
|
||
- 原型约束信息结构，不逐像素复刻；具体密度、层级和交互按 cc-web 真实使用场景优化。
|
||
- 顶部五项指标改为连续指标带，主色只承担选中、关键走势和状态表达，避免五种颜色同时争抢注意力。
|
||
- MCP 调用明细改为看板内侧边抽屉，保持上下文，不再滚动跳转到页面中部。
|
||
- 移动端优先保证首屏判断效率，指标采用紧凑横向浏览，不做五张纵向大卡堆叠。
|
||
|
||
## 错误记录
|
||
|
||
| 错误 | 尝试 | 处理 |
|
||
|---|---:|---|
|
||
| 归档脚本拼接 Markdown 反引号触发 JavaScript SyntaxError | 1 | 改为无嵌套反引号的补丁文本，命令未执行且源文件未变 |
|
||
| 错误日志补丁使用了未展开的时间变量，未匹配原文 | 2 | 读取实际文本后改用稳定上下文补丁 |
|
||
| 进度补丁使用新时间匹配旧时间，未命中原文 | 1 | 后续进度追加只使用稳定标题或固定文本作为上下文 |
|
||
| 阶段状态补丁连续使用错误旧时间 | 3 | 停止猜测，先读取计划尾部再用精确文本同步 |
|
||
| 环境没有 ImageMagick identify | 1 | 改用 file 与 stat 读取 PNG 尺寸、通道和大小 |
|
||
| usage-statistics 回归把初始化事件断言放进渲染函数切片 | 1 | 将自定义日期事件断言改为检查完整 frontendSource |
|
||
| 视觉脚本在初始查询 loading 时点击 disabled 的应用按钮 | 1 | 先等待初始查询离开 loading，再设置自定义日期并应用 |
|
||
| 等待初始查询后自定义结果仍未满足非零条件 | 2 | 增加页面诊断快照，先获取状态/错误/日期/指标再决定修复 |
|
||
| 自定义查询紧跟默认查询触发 250ms 频率限制 | 3 | 根据服务端阈值在视觉脚本中等待 320ms 后提交 |
|
||
| 在线 JS 检查使用 `rg -m1` 提前关闭管道导致 curl 报 23 | 1 | 改为让 rg 消费完整响应，复检命中且退出码为 0 |
|
||
|
||
## 状态
|
||
|
||
- 当前：产品化优化已完成
|
||
- 更新时间：2026-08-03T21:08:00+08:00
|