在 DeepSeek Harness(DSH)中进行多轮对话或开发多个子代理时,会话数量增加后,理清父/子会话关系、查看代理谱系会变得困难。现有的列表式界面难以直观呈现复杂的层级结构。dsh-conversation-map 插件提供了一个可视化的解决方案,将当前工作区内的所有会话按关系自动排布。
该插件由 xyAxzy 维护,旨在为 DSH Web 界面提供一个实时的对话地图。它将当前工作区内的所有会话按父子关系自动排成树状结构,帮助开发者快速定位会话层级和运行状态。
核心功能¶
- 树状自动排版:会话按父/子关系自动排列。父节点位于左侧,分叉的子会话向右逐层缩进,同层会话垂直排开,结构一目了然。
- 父子连线避让:父子连线采样真实贝塞尔曲线。连线经过的会话卡片会被自动挪到工作区内的最近空位,保证连线始终清晰可见。
- 工作区主题色贯穿:工作区边框、会话卡片边框(选中/未选中有深浅区分)、父子连线颜色全部继承工作区主题色。
- 方格本画布:背景为可随缩放平移的网格纸,工作区框为透明的手绘感框框,无阴影。
- 自动扩容:当新建会话或进行分叉操作时,画布会自动长高,确保新卡片不会溢出或与现有卡片重叠。
- 实时状态:通过状态点直观显示会话的运行中 / 待交互 / 空闲状态。
- 一键导航:双击会话卡片可直接跳转到对应会话。
- 可缩放画布:支持平移、缩放操作,也可以拖拽摆放工作区框,位置会持久化保存。
安装与启用¶
使用官方安装命令添加插件:
dsh plugins add dsh-conversation-map
安装完成后,重启 dsh web,在左侧栏底部会出现「对话地图」入口。
典型用法¶
- 打开地图:点击左下角的「对话地图」打开地图 Tab。
- 跳转会话:双击任意会话卡片,页面将跳转到该会话。
- 创建分支:在对话窗口中让 Agent 派生子代理,或悬停在消息点上点击 fork 图标,地图上会自动生成对应的父子连线与树状分支。
- 调整视图:拖动工作区标题条可移动位置,拖动角落可调整大小。
- 查看详情:点击卡片可查看摘要、关键结论或下一步建议。
适用场景与注意¶
该插件适合需要在复杂对话流程中快速定位子代理、梳理会话谱系的使用者。
- 插件以当前 DSH 进程的权限运行。
- 安装前建议查看源码与许可证(MIT)。
通过可视化的树状图,开发者可以更清晰地管理工作区内的会话结构。插件地址:GitHub。