在 DeepSeek Harness (DSH) 中进行长对话时，记录通常是一条线性的文本流。想要回头查找某个上下文，或者从某一轮对话换个方向继续问，往往需要手动滚动或频繁切换视图。dsh-chattree 插件将这种线性结构转化为一张可视化的对话地图。
插件定位¶
dsh-chattree 是一个 DSH 客户端插件，由 RyanZeeee 维护。它将每一轮问答变成画布上的一个节点，每一次提问变成一条新分支。这种非线性的展示方式，让对话的脉络和分支情况一目了然。
核心功能¶
画布与节点¶
每一轮问答对应一个卡片节点，按时间顺序从上往下排列，节点之间通过平滑曲线连接。选中节点后，从根节点到当前节点的路径会高亮显示，方便追踪对话来源。
- 分支提问：在右侧面板继续提问，会从当前节点分叉出新的对话线，原路径不受影响。
- 归档：可以将某个节点及其下游内容从画布上隐藏（会话文件本身不会被删除）。
- 整理与定位：支持一键按层级重新排列，以及将视角快速定位到最新的一轮。
- 拖拽与缩放：支持拖拽画布平移、滚轮缩放、拖拽节点位置（刷新后位置会保留）。
界面布局¶
- 左侧栏：用于管理工作区和画布。支持折叠/展开工作区、切换画布、重命名。可以通过“+”按钮将系统目录添加为工作区。
- 右侧面板：显示选中节点的完整问答内容，也可以在此处直接继续提问。
- 输入框按钮：支持附件、权限预设、模型切换和上下文统计。
压缩上下文¶
输入框旁提供“压缩上下文”按钮。调用 DSH 的 /compact 接口，将当前会话历史替换为摘要。画布上会生成一个绿色节点（卡片模式为绿框，圆点模式为绿点），后续对话基于此摘要继续。
安装与启用¶
前置条件¶
- DeepSeek Harness 2.0.9 或更高版本
- Node.js 22.19+
安装步骤¶
打开 DSH Desktop 的终端（默认 profile 为 desktop）或使用 --profile 参数指定 profile：
dsh plugin add "github:RyanZeeee/dsh-chattree"
安装完成后，重启 DSH。在视图切换条中会出现 Chat Tree 选项。
典型用法¶
- 查看内容：点击画布上的节点，右侧面板会显示该轮的完整问答。
- 分叉对话：在右侧面板继续提问，新的分支会从当前节点延伸出去。
- 压缩上下文：点击输入框旁的“上下文”按钮，选择“压缩上下文”，系统会用摘要替换历史，并在画布上留下一个可继续交互的绿色节点。
适用场景与注意¶
该插件适合需要长时间、多分支进行 DSH 对话的用户。在使用前，建议确认 DSH 版本满足要求。
权限与边界：
- 插件零运行时依赖，仅使用 Node 内置模块。
- 不读取 DSH 会话文件，不联网，不执行 shell。
- 数据文件仅写入 $DSH_HOME/chattree/workspaces。
- 所有模型调用仍由 DSH 本体处理。
总结¶
dsh-chattree 通过可视化的方式解决了长对话中上下文定位和分支管理的问题。你可以通过 目录页 或 GitHub 仓库 了解更多详情。
