[0.1.7-rc.1] 重入运行中的会话时『载入历史』挂起直到回合结束（回合对齐分页的副作用）

[eddiedon]

[0.1.7-rc.1] 重入运行中的会话时「载入历史…」挂起直到回合结束 —— 回合对齐分页（turn-aligned pagination）的副作用

环境

• 宿主：Windows 11 自托管 DeepSeek Harness 0.1.7-rc.1（Node.js v24.18.0），由 0.1.5-rc.3 原地升级
• 访问链路（三种均实测）：
  1. Windows 本机浏览器直连宿主端口（loopback 直连）
  2. 远程浏览器经 FRP 穿透访问
  3. 远程浏览器经**局域网反向代理（Caddy）**访问
• 客户端：macOS 上的 Safari（远程场景）、Windows 本机浏览器（本地场景）
• 时间线说明：升级当晚，客户端侧的 macOS 环境也升级到了 27，多个变更同晚发生、时间线混杂，无法做严格的单变量归因；但下方复现矩阵显示各链路现象一致，指向宿主侧行为而非链路差异。

症状

• 会话 A 的 agent 轮次正在运行（正在流式输出）时，从会话 A 切到其他会话、再切回 A：视图停在**「载入历史…」占位符**，不渲染任何内容，直到该轮次自然结束才一次性出现。
• 挂起时长与当前回合的剩余时长一致：
  • 回合快结束时切回：只短暂卡一下（Windows + FRP 实测很快刷好）；
  • 回合很长时：一直挂到回合结束（macOS Safari 实测挂到结束）。

复现步骤

1. 宿主升级到 0.1.7-rc.1；
2. 在会话 A 发起一个较长的 agent 回合（工具调用在执行、消息持续追加）；
3. 在该回合运行期间切换到会话 B，再切回会话 A；
4. 观察：会话 A 停留在「载入历史…」，直到回合结束才一次性渲染全部内容。

根因分析

定位到 0.1.7-rc.1 变更范围内的提交：

• 提交：50ba2c8bb2 —— fix(session): align history pagination with turn boundaries（经 PR 开发了一个基于deepseek harness的图片和视频生成agent插件 #1371 fix-large-history-pagination 合入）

该提交把历史消息分页从「固定 50 条消息」改为「回合边界对齐（turn-aligned pagination）」：

• 新增 turnWindow 请求参数：每页至少 50 条 user/assistant 消息、且跨越至少 2 个 turn/start，上限 500 条；
• 首次 follow / 重连的打开请求也携带 turnWindow（改动位于 packages/api/session-controller/src/client/sessions/session.ts 的 HISTORY_PAGE_OPTIONS 与 events.open 调用）。

机制：重入一个运行中的会话时，打开页需要对齐回合边界；当前回合尚未关闭（工具调用在执行、消息在追加）时 opening 页无法交付，宿主等到 turn/end 落盘才返回。前端于是停在「载入历史…」，直到回合自然结束才拿到数据、一次性渲染——这也解释了为什么挂起时长 ≈ 当前回合剩余时长。

边界说明（如实标注）：已核实分页函数 paginate() 本身（lib/types/history.js:395）是对已装载数组的纯回溯、不阻塞；等待发生在数据源获取 / 快照协调一层（sourceFor → sessionQuery.observeSession），确切的等待语句尚未逐行钉死。

旁证：0.1.5-rc.3 的「消息对齐分页」在任何时刻都能立即返回，无此问题。

相关旧帖：#7677 报告过 Firefox 下历史在「载入历史…」处无限卡住，但被归因为 Firefox 特有；本例与浏览器无关、四条链路均出现，且挂起时长精确跟随回合边界，判断为不同问题，故另开新帖。

复现矩阵

访问链路	结果
Windows 本机浏览器直连（loopback）	不复现（或极短暂后自行恢复）
Windows 浏览器 + FRP 穿透（远程）	短暂卡顿后自行恢复
macOS Safari + FRP 穿透（远程）	必现，挂到回合结束
macOS Safari + 局域网反向代理 Caddy（远程）	必现，挂到回合结束

四条链路均出现（直连只是恢复更快），因此与 FRP / 反代等网络链路无关；浏览器差异只影响感知恢复速度，不改变「挂到回合结束」的本质。

规避

• 回合运行期间不切换会话；
• 或接受该行为：内容不丢失，回合结束后会一次性渲染出来。

给官方的建议

1. 核心诉求：当 opening 页无法满足 turnWindow（当前回合未闭合）时，提供消息对齐（message-aligned）的即时降级——先返回当前可用的历史前缀让前端立即渲染，后续内容再由流式事件补齐，让「重入运行中的会话」不必等待回合闭合。
2. 若短期内不调整行为，至少在文档 / Release Notes 中明确标注「重入运行中的会话时，历史渲染会等待当前回合结束」，避免用户误判为前端挂死。

---

以上均为实测结果；提交号、PR 号与代码位置已对照 0.1.7-rc.1 源码核实。

[ttbj2023]

补充一个归因修正供参考：这个现象我们也在 Firefox 上稳定复现过，根因大概率不是回合对齐分页，而是 #5919 的 hasIntrinsicConstructor 跨引擎 toString 格式问题 + #6954 描述的打开路径错误归宿：未结算 attempt 的原生 chunk 记录在 Firefox/Safari 上校验必抛 TypeError，回合结束后结算为带类型记录即自愈——“挂起直到回合结束”与该机制完全吻合。可用浏览器做快速判别：同一会话 Chromium 正常、Firefox/Safari 卡，即为此因（V8 单行原生函数排版恰好匹配硬编码模板）。