前言¶
DSH 的理念是「一切皆插件」。在 DeepSeek Harness 会话中,用户消息、助手消息、工具调用、并行调用和子代理分支会交织在同一条会话流里;只读线性消息时,流程关系、工具返回和子代理执行进度不够直观。
dsh-flowglass 是 DeepSeek Harness 的实时会话流程图插件。它把当前会话画成三列泳道,并支持子代理分支、逐层钻取和详情查看。下面先介绍它的定位和功能,再给出安装命令与典型用法。
这是什么¶
dsh-flowglass 由 Iwctwbh 维护,采用 MIT License。它的客户端平台为 web,要求 node >=22.19。
dsh-flowglass 是默认产品和默认构建目标。它是原生静态 Host/Client 插件,不使用 dynamicCordisRunner,也不产生 dyn/*。完整 Toolbox 次级产品 dsh-dynamic-toolbox 与默认 dsh-flowglass 相互独立。
dsh-better-sidebar 是可选依赖。
核心功能¶
- 三列泳道:中列是用户与助手主干,工具调用从右侧发出、从左侧返回。
- 子代理分支:子会话在触发步骤旁展开自己的分支和执行进度。
- 逐层钻取:进入任意子代理会话,并通过面包屑逐级返回。
- 并行分组:同一步中的并行调用集中显示,运行中的节点持续高亮。
- 完整详情:点击消息或工具卡查看完整内容、参数、结果、模型和 token 信息。
- Markdown 助手详情:默认使用 Harness 官方 Markdown renderer 展示表格、代码块、列表和数学公式。
- 详情侧栏可调宽:左缘拖拽或外观设置「详情宽度」滑杆,自动记忆。
- 一键复制:详情各内容框标题行「复制」按钮,直接写系统剪贴板。
- 实时刷新:默认每 2 秒静默刷新;页面不可见时暂停,回到页面后继续。
- 可选集成:可与
dsh-better-sidebar集成,注册为按会话隔离的原生「流镜」Tab。
安装与启用¶
先安装 dsh-flowglass:
dsh plugin --profile web add dsh-flowglass
升级到指定版本后,需要重启 DSH:
dsh plugin --profile web add dsh-flowglass@<新版本>
卸载时执行:
dsh plugin --profile web remove dsh-flowglass
如果要与 dsh-better-sidebar 集成,先安装侧边栏,再安装流镜:
dsh plugin --profile web add dsh-better-sidebar
dsh plugin --profile web add dsh-flowglass
典型用法¶
1、打开 DSH 会话后,查看三列泳道中的会话主干。中列是用户与助手主干,工具调用从右侧发出、从左侧返回。
2、点击消息或工具卡,查看完整内容、参数、结果、模型和 token 信息。
3、进入任意子代理会话,子会话会在触发步骤旁展开自己的分支和执行进度;使用面包屑逐级返回。
4、查看同一步中的并行调用,运行中的节点会持续高亮。
5、在助手详情中查看 Markdown 内容,包括表格、代码块、列表和数学公式。
6、调整详情侧栏宽度:拖动左缘,或在外观设置「详情宽度」滑杆;设置会自动记忆。
7、使用详情内容框标题行的「复制」按钮,将内容写入系统剪贴板。
8、保持页面打开时,默认每 2 秒静默刷新;页面不可见时暂停,回到页面后继续。
适用场景与注意¶
dsh-flowglass 适合需要观察 DSH 会话流程、工具调用、并行调用、子代理执行和模型 token 信息的场景。
安装和使用时注意:
- 插件以当前
dsh进程权限运行,安装前应检查源码与许可证。 - 许可证为 MIT。
- 客户端平台为 web,要求
node >=22.19。 - 依赖关系包括
@deepseek-ai/dsh-client-ui-primitives ^0.1.1-rc.2、react ^18.3.1、react-dom ^18.3.1;dsh-better-sidebar >=0.4.0为可选依赖。 - 内部保留
toolboxRegistry、toolbox.*RPC 与.dsh-dynamic-toolbox/数据路径,以兼容现有框架和历史数据;这些内部名称不改变默认安装入口。 - 静态插件不使用
dynamicCordisRunner,不产生dyn/*。
链接¶
GitHub 仓库:
https://github.com/Iwctwbh/dsh-flowglass
DSH 社区目录是独立站点,与 DeepSeek / 幻方无官方从属关系;本次已核实资料未提供目录页 URL。