性能优化提案：历史加载剔除流式分块事件（附完整实现与测试）

[dingdingfox]

中文

提案：session.history 历史页省略 assistant/chunk 流式分块增量（附完整实现、测试与 Agent Note，欢迎直接取用）。

现象

手机端（经 Tailscale）打开会话历史需要 10 秒以上；桌面端随会话增长也越来越慢。

根因（实测）

session.history 按消息数分页（默认 50 条消息），然后发送页内 seq 范围内的全部事件。实测一个普通的重负载会话：50 条消息展开为 26,562 条 assistant/chunk 事件、约 5.4MB JSON——其中约 99% 是仅用于流式动画的分块增量。assistant/message 事件本身携带完整内容（message.content），对话 reducer 渲染历史时直接使用这些事件，分块对历史查看者没有任何价值。

方案

1. 服务器（packages/host/apiproxy）：historyPage（session.history、detached 历史、subagent.history 共用）在分页前过滤 assistant/chunk。分页边界、hasMore 语义不变；单页从 5.4MB 降到约 200KB（约 50 倍）。
2. 客户端（packages/client/runtime）：loadOlder 的连续性断言从「精确相邻」放宽为「确实更旧」（被剥离的分块会在页间留下预期 seq 间隙）；非更旧的页仍然 fail-soft。
3. 不受影响：存储日志与实时 mux 事件流保留全部分块，流式动画完全不变。

验证

• pnpm run typecheck ✅ / oxlint 0 错误 ✅
• 新增 api-proxy-history-chunks.spec.ts（attached + detached 双路径）+ 更新 session.client.spec.ts，53 测试全过 ✅
• verify-translation-pairing（937 对一致）✅ / verify-agent-note-format ✅
• 手机实测：历史加载从 10+ 秒降到 1 秒内

代码

完整实现（含中英双语 Agent Note）在分支：https://github.com/dingdingfox/deepseek-harness/tree/perf/history-omit-streaming-chunks

如果团队认可这个方向，可以直接取用或开放外部 PR（当前仓库未开放外部 PR，CONTRIBUTING.md 注明现阶段不接受）。

---

English summary

Proposal: session.history pages should omit assistant/chunk streaming deltas — with a complete implementation, tests, and an Agent Note available on the branch above.

• Measured problem: a 50-message history page of a heavy session ships ~26,562 assistant/chunk events (~5.4 MB JSON, ~99% streaming-only payload). Phone history loads take 10+ seconds over Tailscale; the desktop degrades too as sessions grow.
• Fix: historyPage filters assistant/chunk before paginating (same message window, ~50x smaller pages; hasMore and page boundaries unchanged); the client loadOlder continuity assertion relaxes to "actually older". The stored log and live mux stream keep every chunk.
• Verified: typecheck, lint, 53 unit tests (new attached + detached history specs), translation pairing, and note format all pass. Measured phone load drops to under a second.
• Code: https://github.com/dingdingfox/deepseek-harness/tree/perf/history-omit-streaming-chunks

Happy to adapt the approach to team preferences.