* 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>
106 lines
4.9 KiB
TypeScript
106 lines
4.9 KiB
TypeScript
import { describe, expect, it } from 'vitest'
|
|
import { contentText, lastActivity } from '../src/subagent-activity.ts'
|
|
import type { SidebarSessionEvent } from '../src/context-types.ts'
|
|
|
|
describe('subagent activity summary parser', () => {
|
|
/** One raw session event. */
|
|
const entry = (type: string, data: Record<string, unknown>): SidebarSessionEvent => ({
|
|
type, seq: 0, time: 0, data,
|
|
})
|
|
|
|
it('extracts text blocks and skips non-text content', () => {
|
|
// Text blocks join as paragraphs (newline-separated).
|
|
expect(contentText([{ type: 'text', text: 'hello' }, { type: 'text', text: ' world' }])).toBe('hello\n world')
|
|
expect(contentText([{ type: 'tool_use', name: 'bash' }])).toBeUndefined()
|
|
expect(contentText(undefined)).toBeUndefined()
|
|
expect(contentText('nope')).toBeUndefined()
|
|
})
|
|
|
|
it('lastActivity returns the LAST text output and the LAST tool call', () => {
|
|
const live = lastActivity([
|
|
entry('turn/start', { turn: 1 }),
|
|
entry('user/message', { content: [{ type: 'text', text: '请检查代码' }] }),
|
|
entry('tool/call', { callId: 'c1', name: 'bash', arguments: '{"command":"ls -la"}' }),
|
|
entry('assistant/message', {
|
|
turn: 1, step: 1,
|
|
message: { content: [{ type: 'text', text: '检查完毕' }] },
|
|
}),
|
|
entry('tool/call', { callId: 'c2', name: 'read', arguments: '{"path":"a.ts"}' }),
|
|
entry('assistant/message', {
|
|
turn: 1, step: 2,
|
|
message: { content: [{ type: 'text', text: '再看一眼' }] },
|
|
}),
|
|
])
|
|
expect(live).toEqual({
|
|
text: '再看一眼',
|
|
tool: { name: 'read', args: '{"path":"a.ts"}' },
|
|
})
|
|
})
|
|
|
|
it('lastActivity keeps only the fields the log actually has', () => {
|
|
expect(lastActivity([
|
|
entry('tool/call', { callId: 'c1', name: 'bash', arguments: '{"command":"ls"}' }),
|
|
])).toEqual({ tool: { name: 'bash', args: '{"command":"ls"}' } })
|
|
expect(lastActivity([
|
|
entry('assistant/message', { turn: 1, step: 1, message: { content: [{ type: 'text', text: 'ok' }] } }),
|
|
])).toEqual({ text: 'ok' })
|
|
})
|
|
|
|
it('lastActivity ignores lifecycle events, chunks, and text-less messages', () => {
|
|
const live = lastActivity([
|
|
entry('turn/end', { turn: 1, reason: 'success' }),
|
|
entry('step/start', { turn: 1, step: 1 }),
|
|
entry('assistant/chunk', { turn: 1, step: 1, chunk: { type: 'text', delta: 'x' } }),
|
|
entry('assistant/message', { turn: 1, step: 1, message: { content: [{ type: 'tool_use', name: 'bash' }] } }),
|
|
])
|
|
expect(live).toEqual({})
|
|
expect(lastActivity([])).toEqual({})
|
|
})
|
|
|
|
it('lastActivity defaults a missing tool name and tolerates non-string arguments', () => {
|
|
const live = lastActivity([
|
|
entry('tool/call', { callId: 'c1' }),
|
|
entry('tool/call', { callId: 'c2', name: 'web', arguments: { url: 'x' } }),
|
|
])
|
|
expect(live.tool).toEqual({ name: 'web', args: '' })
|
|
})
|
|
|
|
it('lastActivity window excludes activity older than the last maxMessages messages', () => {
|
|
// One stale tool call before the window: with maxMessages=1 only the
|
|
// latest message (and the events around it) are considered.
|
|
expect(lastActivity([
|
|
entry('tool/call', { callId: 'stale', name: 'bash', arguments: '{"command":"old"}' }),
|
|
entry('assistant/message', { turn: 1, step: 1, message: { content: [{ type: 'text', text: 'new text' }] } }),
|
|
], 1)).toEqual({ text: 'new text' })
|
|
|
|
// The same log with a wider window surfaces the tool call again.
|
|
expect(lastActivity([
|
|
entry('tool/call', { callId: 'stale', name: 'bash', arguments: '{"command":"old"}' }),
|
|
entry('assistant/message', { turn: 1, step: 1, message: { content: [{ type: 'text', text: 'new text' }] } }),
|
|
], 2)).toEqual({
|
|
text: 'new text',
|
|
tool: { name: 'bash', args: '{"command":"old"}' },
|
|
})
|
|
|
|
// Non-message events (tool calls) do not consume quota, but once the
|
|
// window holds its messages, older events are dropped even without an
|
|
// older message to stop at: the second message pushes the tool call out.
|
|
expect(lastActivity([
|
|
entry('tool/call', { callId: 'stale', name: 'bash', arguments: '{"command":"old"}' }),
|
|
entry('assistant/message', { turn: 1, step: 1, message: { content: [{ type: 'text', text: 'first' }] } }),
|
|
entry('user/message', { content: [{ type: 'text', text: '继续' }] }),
|
|
], 1)).toEqual({})
|
|
|
|
// A tool call between the two in-window messages stays visible.
|
|
expect(lastActivity([
|
|
entry('tool/call', { callId: 'stale', name: 'bash', arguments: '{"command":"old"}' }),
|
|
entry('assistant/message', { turn: 1, step: 1, message: { content: [{ type: 'text', text: 'first' }] } }),
|
|
entry('tool/call', { callId: 'fresh', name: 'read', arguments: '{"path":"a.ts"}' }),
|
|
entry('user/message', { content: [{ type: 'text', text: '继续' }] }),
|
|
], 2)).toEqual({
|
|
text: 'first',
|
|
tool: { name: 'read', args: '{"path":"a.ts"}' },
|
|
})
|
|
})
|
|
})
|