前言¶
在 DeepSeek Harness（DSH）里跑智能体会话，日志和 Trajectory 能还原「发生了什么」，但长回合里用户消息、助手回复、工具调用、审批与子代理并行往往交错在一起，靠纯文本扫读成本高。若你已经在用 dsh web 管理会话，又希望「执行到哪、图就画到哪」，并且能区分上下文注入与真实用户输入、下钻子代理子流程，下面介绍社区插件 @weibaohui/dsh-flow（维护者 weibaohui，分类：工作流）。
这是什么¶
@weibaohui/dsh-flow 是 DSH 的 Web 侧插件：订阅当前会话的事件流，把回合、用户、助手、工具、审批、重试等步骤映射为流程图节点，经 SSE 推到浏览器实时生长。默认是四泳道（上下文 | 用户 | 助手 | 工具）流程图；子代理委派画成发散–收敛扇形，双击可进入该子代理的完整流程图。另提供紧凑列表视图一键切换。全程只读 ctx.sessions，不写事件。
核心功能¶
四泳道流程图与工具铁路¶
四条垂直泳道按转移频率排布，回合从左向右单调推进；椭圆表示回合起止（含耗时），菱形表示审批决策，方框表示消息与动作；连线为带箭头的单弯曲线，样式可在 quad / line / bezier 间切换。工具组成员在工具泳道纵向串联，组框引入、末成员汇回主链，避免横穿交叉；工具组默认展开，单击组框可折叠。
子代理扇形与下钻¶
对 subagent、spawn_teammate、lead 等委派调用，在主链下方横向排开：发散边向下、收敛边汇回主链下一节点。经 subagent/catalog 名册配对到子会话后，双击委派节点可切换为该子代理的完整流程图（成员框显示任务标签）；面包屑「← 返回主流程」或 Esc 返回，支持逐级下钻。历史子会话不在内存时，只读解压 ~/.dsh/sessions 的多帧 zstd 日志（按 mtime 缓存），状态标「静态（历史）」。
实时、筛选与断线续传¶
宿主侧订阅 session/event，每次日志追加经 SSE 推送到浏览器，非轮询；运行中工具节点脉冲，回合未收口时主链末端可显示「模型工作中…」幽灵节点。六类 chip（用户 / 上下文 / 助手 / 工具 / 待办 / 事件）与顺序正交过滤；source.kind ≠ 'user' 的注入消息归入「上下文」，不与真实用户输入混淆。SSE 帧带 id: <seq>，重连时经 Last-Event-ID 回补再直播，同 seq 客户端去重。停留在底部时新节点自动滚入视野；上翻则不打扰，并提示回到底部。
详情与列表视图¶
双击任意节点可弹详情窗（seq、时间、turn/step、耗时、callId、token 用量、待办等）；正文超过 400 字可按键加载全文（GET /dsh-flow/api/event?seq=）。一键切换到紧凑列表视图，适合扫读文本。
安装与启用¶
在已安装 @deepseek-ai/dsh 且使用 Web profile 的环境下，安装命令以 README 为准：
dsh plugin --profile web add @weibaohui/dsh-flow -w
装完后重启 dsh web。打开任意会话，在顶部 Trajectory 右侧进入「执行流程」标签，即锁定当前会话。
版本兼容性（README 发版表）：插件 0.1.0 已在 @deepseek-ai/dsh@0.1.7-rc.2 下验证；package.json 中 engines.dsh 为 >=0.1.7-rc.2，npm 包当前版本为 0.1.7。Node 需 >=22.5。许可证：MIT。
典型用法¶
- 按上文命令安装并重启
dsh web。 - 打开正在运行或已有的会话，切到「执行流程」。
- 观察四泳道主链随执行向下生长；需要看工具组细节时在工具泳道展开/折叠组框。
- 出现子代理委派时，在主链下方查看扇形；双击下钻子流程，用面包屑或 Esc 返回。
- 需要扫文本时切换到列表视图；需要字段级信息时双击节点打开详情。
- 用类型 chip 过滤用户、上下文、助手、工具等，与时间顺序无关。
节点与事件对应关系（节选，完整表见 GitHub README）：
| 节点 | 来源事件 | 展示要点 |
|---|---|---|
| 回合分隔 | turn/start、turn/end |
全宽 pill，含结束原因 |
| 用户 | user/message |
文本预览；注入类标「注入」chip |
| 助手 | assistant/message |
预览 + 思考字数 / 工具数 / token / 中断徽标 |
| 工具 | tool/call + tool/result |
工具名 + 参数摘要；运行中 → 完成/失败 + 耗时 |
| 审批 | approval/asked、approval/decided |
等待 / 结果 |
| 重试 | llm/retry、llm/retry-started |
虚线橙卡 + 原因 |
request/header、system/message 等结构/背景事件不进流程图。
适用场景与注意¶
适合：在 dsh web 中调试复杂智能体会话、排查工具链路与审批卡点、对比子代理并行派发与子流程行为。不适合替代 Trajectory 的全文检索或离线批分析——本插件侧重可视化执行拓扑与实时跟随。
插件以当前 DSH 进程权限运行，API 走 connection 服务的 Host/Origin 与浏览器认证栅栏；安装前建议在 GitHub 查看源码与 MIT 许可证，确认与本地 DSH 版本匹配。社区目录页由 SkillHub 等站点收录，与 DeepSeek / 幻方无官方从属关系。
结尾¶
@weibaohui/dsh-flow 把会话日志映射为可交互的四泳道流程图，SSE 驱动实时生长，并支持子代理下钻与列表视图，便于在 Web 里「看见」一轮智能体是怎么跑下来的。
- 目录页：https://www.skillhub.cn/plugins/weibaohui/dsh-flow
- 仓库：https://github.com/weibaohui/dsh-flow
