mesalogo
e2a5f83666
Cross-platform packages / Validate source (push) Canceled after 0s
Cross-platform packages / Authorize desktop packaging (push) Canceled after 0s
Cross-platform packages / linux arm64 (push) Canceled after 0s
Cross-platform packages / macos arm64 (push) Canceled after 0s
Cross-platform packages / windows arm64 (push) Canceled after 0s
Cross-platform packages / linux x64 (push) Canceled after 0s
Cross-platform packages / macos x64 (push) Canceled after 0s
Cross-platform packages / windows x64 (push) Canceled after 0s
Cross-platform packages / Publish GitHub and OSS release (push) Canceled after 0s
Deploy website to GitHub Pages / Deploy static website (push) Canceled after 0s
53 lines
2.7 KiB
Markdown
53 lines
2.7 KiB
Markdown
# 技术设计与测试计划
|
|
|
|
## 当前边界
|
|
|
|
`ChatHistoryPane` 当前有两层机制：`messageRenderBatchSize = 80` 控制向上滚动时可访问的历史窗口；`maxRenderedMessageCount = 60` 控制实际挂载的消息组件。第一阶段只移除前者在生产接线中的作用，保留后者以及消息高度占位和锚点恢复。
|
|
|
|
已加载历史的消息数组仍由会话 store 提供。带 `messageSummary` 的会话继续先显示加载状态，由现有 `loadHistory` 路径取得完整历史。这样本实验测量的是滚动历史窗口的变化，不混入存储或 IPC 改造。
|
|
|
|
## 实验分组
|
|
|
|
| 组别 | 历史窗口 | DOM 窗口 | minimap |
|
|
| --- | --- | --- | --- |
|
|
| A 基线 | 每次增加 80 条 | 保留 | 无 |
|
|
| B 本阶段 | 当前已加载消息全部可访问 | 保留 | 无 |
|
|
| C 下一阶段 | 当前已加载消息全部可访问 | 保留 | 有 |
|
|
|
|
A 组保留在组件级回归测试中；B 组是当前生产实验；C 组待 B 组稳定后实现。
|
|
|
|
## 功能测试计划
|
|
|
|
- 100 条消息：打开会话后直接滚到第一条，不出现加载按钮。
|
|
- 500 条消息：从底部连续滚到顶部，检查消息顺序、首尾消息和滚动位置。
|
|
- 2,000 条消息：在中部、顶部和底部来回滚动，确认高度占位和锚点不跳动。
|
|
- 消息交互：展开 reasoning/tool details、输入答案、选择文本、打开附件后滚出再滚回，确认状态保留。
|
|
- 流式消息：生成过程中滚动、暂停跟随底部，再回到底部，确认自动跟随行为不变。
|
|
- 摘要会话：打开只有 `messageSummary` 的会话，确认仍然先加载历史，不把摘要误当作完整消息。
|
|
|
|
## 性能测试计划
|
|
|
|
每个规模至少运行 5 次，分别记录冷打开和已经打开后的滚动表现。低端机模拟沿用已有性能测试配置，结果记录中注明运行环境。
|
|
|
|
记录指标：
|
|
|
|
- 会话打开到首屏可交互的耗时；
|
|
- 首次滚到顶部的耗时；
|
|
- 连续滚动期间长任务和掉帧；
|
|
- Renderer 内存峰值和测试结束后的回收情况；
|
|
- 实际挂载消息数量；
|
|
- 流式输出时输入延迟。
|
|
|
|
通过条件：B 组功能测试全部通过，实际挂载消息数量仍受窗口上限控制；相对 A 组没有明显的输入、流式输出或滚动回归。若 B 组稳定，再以同一批数据实现 C 组并做增量对比。
|
|
|
|
## 验证命令
|
|
|
|
```text
|
|
npm exec vitest run src/renderer/src/ChatHistoryPane.test.tsx src/renderer/src/ChatTimeline.test.tsx
|
|
npm run typecheck
|
|
npm run lint
|
|
npm run perf:app
|
|
```
|
|
|
|
`perf:app` 的具体参数和输出以仓库脚本当前实现为准；无法在自动化环境观察的内存和掉帧指标，需要补充 Electron 手工记录。
|