NuperAkiandMenghuan1918
6cea4bdd6f
fix(subagent): 子代理页实时预览改为批量接口，避免 O(N²) history 请求风暴 (#298)
* fix(subagent): 子代理页实时预览改为批量接口，避免 O(N²) history 请求风暴
## 背景
DSH Web UI 中，当主代理同时运行多个子代理时，`dsh-better-sidebar` 的「任务管理/子代理」页面会出现明显卡顿。经调查，卡顿根因不在页面渲染，而在实时预览的请求模式。
## 根因
旧实现中，每个 running 子代理卡片都独立轮询 `subagents.history`：
- N 个 running 子代理 → 每 3 秒产生 N 次 `subagents.history` 请求；
- 每次 `subagents.history` 都会在 host 侧触发一次完整的 `listChildren` 全量子代理目录枚举；
- 子代理数量越多，服务端重复扫描越严重，近似 O(N²) 放大；
- 请求超过 3 秒时，客户端还会 abort 旧请求并重发，进一步形成请求风暴。
## 改动内容
1. **新增 host 批量接口 `POST /sidebar/api/subagents.live`**
- 请求 `{ rootSessionId }`；
- 通过 `ctx.subagents.listDescendants(rootSessionId)` 一次枚举整棵子代理树；
- 仅对 running 且非 Side Chat 的子代理，从 session events 尾部提取最新 `text/tool` 活动；
- 返回 `{ live: Record<childId, { text?, tool? }> }`；
- 缺 `subagents`/`agents` 服务或枚举失败时返回 503；单个子代理日志异常只跳过该子代理。
2. **客户端改为单轮询 + 单飞行请求**
- 删除每个 running 子代理独立的 `subagents.history` 定时器；
- 在 `SubagentView` 中合并为一个 `useSubagentLive` 轮询 hook；
- 使用递归 `setTimeout` 和单在途请求，慢请求不再被 abort/重发；
- 页面隐藏或 root 变化时停止轮询并中止在途请求。
3. **解析器优化**
- `lastActivity` 改为接收原始 `SidebarSessionEvent[]`；
- 从事件尾部向前扫描，找到最新 text 和 tool 后提前停止，避免复制/遍历完整历史。
4. **UI 保持不变**
- 实时预览的展示逻辑、文案、截断规则均未改变。
## 测试
- 新增 `tests/subagent-live-route.spec.ts`：覆盖批量接口成功聚合、只返回 running、跳过 Side Chat、缺服务 503、枚举失败 503、`ctx.get` 回退、bad-request。
- 新增 `tests/subagent-live-polling.spec.tsx`：覆盖每轮只发 1 次 `subagents.live`、不再调用 `subagents.history`、单在途不并发。
- 更新 `tests/subagent-activity.spec.ts` 与 `tests/subagent-jobs-view.spec.tsx`。
- `pnpm typecheck` ✅
- `pnpm build` ✅
- 相关测试 29 个全部通过 ✅
> 本机完整 `pnpm test` 仍有与本改动无关的环境性失败（node-pty 超时、Windows CRLF 断言、pty-deps 路径断言），不影响本 PR 逻辑。
* fix(subagent): live 预览以 catalog activity 为准，删除 agents 第二事实源 (#298)
- host 路由 running 门改回 entry.activity === 'running'（与客户端卡片渲染门一致），
恢复 PR 承诺的 UI 不变：turn 间 idle 的 continuable 子代理仍显示最后活动
- 删除 ctx.agents 依赖与 SidebarAgent.status 新增（agents 缺失时不再静默 200 空 map；
503 契约收窄为只涉及 subagents，与文档/测试一致）
- service 解析统一为 ctx.get('subagents')（兄弟路由惯例；插件未 inject subagents，
直接属性访问有抛错风险）
- buildSubagentLiveApi 签名改收完整 Context，删除 SidebarSubagentLiveContext 窄接口
- api.ts 复用 LastActivity，删除重复类型 SubagentLiveEntry
- 测试：route spec 删除 agents 相关用例；polling spec 新增页面隐藏停止轮询、
root 变化清空 live 并重启轮询两个用例
* fix(subagent): live 预览恢复最近 12 条消息窗口，排除陈旧活动 (#298)
CR 反馈：新批量接口把完整 session event log 喂给 lastActivity，
- 长时间只输出文本、早期调用过工具的 running 子代理会持续显示陈旧 tool
- 无 tool 的长会话每次轮询反向扫描整个事件数组，重新引入与历史长度
相关的 CPU 成本
修复（与旧 subagents.history({ maxMessages: 12 }) 窗口语义一致）：
- lastActivity 增加可选 maxMessages 参数：反向扫描按表面消息
（user/message + assistant/message）计数，窗口满后更老事件一律跳过
- 路由传 LIVE_WINDOW_MESSAGES = 12（导出常量）
- 回归测试：窗口外旧 tool 不返回；窗口内 tool 保留；非消息事件不消耗配额
---------
Co-authored-by: Menghuan1918 <menghuan2003@outlook.com>
2026-08-21 18:15:49 +08:00
..
2026-08-21 16:40:14 +08:00
2026-08-18 20:29:14 +08:00
2026-08-16 22:32:17 +08:00
2026-08-10 21:43:58 +08:00
2026-08-16 23:06:44 +08:00
2026-08-15 00:28:59 +08:00
2026-08-14 20:17:27 +08:00
2026-08-12 18:27:28 +08:00
2026-08-20 02:09:36 +08:00
2026-08-11 19:28:48 +08:00
2026-08-11 19:28:48 +08:00
2026-08-21 15:41:14 +08:00
2026-08-18 01:22:28 +08:00
2026-08-18 01:22:28 +08:00
2026-08-20 02:09:36 +08:00
2026-08-14 21:28:41 +08:00
2026-08-21 01:28:17 +08:00
2026-08-20 02:09:36 +08:00
2026-08-11 11:16:36 +08:00
2026-08-20 18:28:57 +08:00
2026-08-16 23:06:44 +08:00
2026-08-20 18:28:57 +08:00
2026-08-17 15:00:03 +08:00
2026-08-16 23:35:57 +08:00
2026-08-16 23:35:57 +08:00
2026-08-16 23:06:44 +08:00
2026-08-16 23:35:57 +08:00
2026-08-12 01:16:20 +08:00
2026-08-13 09:06:55 +08:00
2026-08-14 22:30:34 +08:00
2026-08-15 15:05:06 +08:00
2026-08-13 00:43:28 +08:00
2026-08-20 02:09:36 +08:00
2026-08-13 10:26:57 +08:00
2026-08-18 01:22:28 +08:00
2026-08-18 01:22:28 +08:00
2026-08-18 01:22:28 +08:00
2026-08-14 14:53:03 +08:00
2026-08-16 23:06:44 +08:00
2026-08-11 11:22:28 +08:00
2026-08-16 23:35:57 +08:00
2026-08-16 23:35:57 +08:00
2026-08-14 23:04:25 +08:00
2026-08-21 01:28:17 +08:00
2026-08-21 01:28:17 +08:00
2026-08-16 23:06:44 +08:00
2026-08-17 00:06:20 +08:00
2026-08-18 19:56:04 +08:00
2026-08-11 19:28:48 +08:00
2026-08-13 01:39:59 +08:00
2026-08-17 15:00:03 +08:00
2026-08-16 16:24:28 +08:00
2026-08-21 01:28:17 +08:00
2026-08-20 02:09:36 +08:00
2026-08-21 01:28:17 +08:00
2026-08-17 15:00:03 +08:00
2026-08-21 15:41:14 +08:00
2026-08-21 15:41:14 +08:00
2026-08-21 15:41:14 +08:00
2026-08-21 15:41:14 +08:00
2026-08-20 18:28:57 +08:00
2026-08-17 15:00:03 +08:00
2026-08-21 18:15:49 +08:00
2026-08-21 15:41:14 +08:00
2026-08-21 18:15:49 +08:00
2026-08-13 09:06:55 +08:00
2026-08-21 18:15:49 +08:00
2026-08-21 18:15:49 +08:00
2026-08-18 23:04:29 +08:00
2026-08-14 22:59:19 +08:00
2026-08-17 00:06:20 +08:00
2026-08-14 14:36:49 +08:00
2026-08-16 16:37:11 +08:00
2026-08-21 01:28:17 +08:00
2026-08-20 02:09:36 +08:00
2026-08-14 23:03:26 +08:00
2026-08-14 00:41:08 +08:00
2026-08-20 18:28:57 +08:00
2026-08-21 01:28:17 +08:00