前言¶

在 DeepSeek Harness (DSH) 中开发或调试智能体时，面对长会话的对话轨迹，往往难以快速理清逻辑脉络。@nydsg/dsh-mindmap 把对话渲染成一张横向层级树：最左侧是唯一的起始总标题（内容是第 1 轮提问），之后每一轮从它向右逐层展开。卡片表面只显示提问，插件通过比较每轮提问与前序提问的相似度（信号词阈值 0.50）自动续接分支，也支持手动修改父节点。全部分析在浏览器本地完成，无网络请求、无模型调用、无构建步骤。

安装与启用¶

安装插件后重启 Harness，会话顶部会出现第三个页签「导图」，与「对话」「轨迹」平级。

dsh plugin --profile web add @nydsg/dsh-mindmap

核心功能¶

横向层级树与总标题¶

导图视图采用列 = 深度、行 = 排布的布局方式。最左侧列固定为起始总标题，内容取第 1 轮提问。它不是一轮对话，没有模块、不可选中，也不产生自己的连线。所有分支起点都挂在总标题下，形成单一入口的树状结构。

自动分支与接上一轮¶

插件通过比较提问词面的相似度决定分支走向。规则如下：
1. 词面命中：本轮提问与之前某一轮的提问共享足够的信号词（阈值 0.50），则接到那一轮下面（回溯）。
2. 接上一轮：提问词面没有命中任何更早的轮次时，本轮就作为上一轮的子节点。这是基于对话顺序的结构判断，不是猜测。
3. 新分支：既不命中更早提问，也不属于接上一轮时，作为新的起始分支。

层级上限与换行¶

默认最大层级为 5。当一轮按原规则会落在第 6 层时，它不再向下，而是在上一轮旁边并列（换行新建）。这防止了长会话的横向无限延伸。可在工具栏将最大层级设为 0 以不限层级。

手动控制与持久化¶

选中卡片后，可在右侧面板手动指定该轮接到任意更早的问题下面或改为新分支。手动指定的连接会按会话存本地，重载后仍在，且不会被自动重算覆盖。

模型判定（可选）¶

1.4.0 版本起支持「模型判定」。它利用 DSH 里配置好的模型，根据系统提示词判断当前轮次应「下推 / 换行 / 回溯」。判定结果通过本地 HTTP 桥 (/plugin-mindmap/*) 调用，默认关闭，点击「运行模型判定」时生效。手动指定永远压过模型结论。

导出与离线¶

插件支持一键导出整张导图为 Markdown 大纲。所有分析均在浏览器本地完成，零网络请求、零模型调用、零构建步骤。离线判定默认行为是按对话顺序下推。

判定逻辑说明¶

插件使用信号词（会话内出现 ≤2 次或高于自身 IDF 中位数）而非余弦相似度计算分数。真实追问（如「那接下来呢」）几乎不重复上一轮回复里的名词，因此无法靠相似度判断「接上一轮」。插件将「接上一轮」定义为结构延续，将「回溯」定义为词面证据确凿的旧话题回归。

适用场景¶

适合需要梳理长对话逻辑、调试智能体规划能力、或对会话结构进行可视化的开发者。

资源¶

• 仓库地址：https://github.com/nydsg/dsh-mindmap