前言¶
DeepSeek Harness(DSH)的会话列表默认是扁平的:项目一多,很难一眼看出某条对话属于哪个工作区、哪条任务线。有人用文件夹或命名约定凑合,但列表仍会随着会话增多变得难扫。下面介绍的是客户端插件 dsh-conversation-tree(仓库 orchivo/dsh-conversation-tree):在会话列左侧增加一条可折叠、可拖宽的「对话树」带,按 Workspace → 主题 → 对话 组织,点击行仍打开 DSH 原有的真实会话,不替换产品自带的会话列、Composer 和右侧栏。
这是什么¶
Conversation Tree for DSH 由维护者 orchivo 发布,分类为客户端插件,当前 npm 包版本 0.2.0(MIT 许可证)。它解决的是对话归档与导航:把多条 WorkSpace 下的会话挂到可嵌套的主题节点上,并支持状态汇总、搜索与(可选)由智能体通过工具维护树结构。数据只写在本地,不发起网络请求。
需注意:社区里另有名称相近的 Unintendedz/dsh-conversation-tree,做的是单会话内的消息分支,与本插件的「工作区—主题—对话」组织层不是同一类产品;在 dsh.so 上本插件对应页面为 /artifact/dsh-conversation-tree-2/。
核心功能¶
插件在会话列左侧预留一条树形带(默认折叠);展开后可见多级结构,产品 UI 其余部分保持原样。
| 能力 | 说明 |
|---|---|
| 分层组织 | 第一级为 WorkSpace,其下为主题(可嵌套),对话挂在主题或工作区根下 |
| 状态一览 | 每行汇总自身及子节点下对话的状态计数,打开对应对话后相关计数才会清掉 |
| 带内搜索 | 可搜主题标题/描述、已索引的对话标题与正文(索引在 DSH 内按需构建) |
| 折叠与宽度 | 默认折叠;可拖右缘调整宽度(最小约 320px),状态会记住 |
| 界面语言 | 简中/英文随 Settings → General → Language 切换,无需重启 |
| 0.2.0 增量 | 树随当前会话定位;每 WorkSpace 有「Archived」架;支持拖拽整理;删主题会先确认,对话保留并回退到工作区顶层 |
插件向智能体注册 9 个工具,可用于规划目标结构、创建/重命名/移动节点、把已有对话归档到合适主题等;工具只读写本地对话树映射,不执行 shell、不扫盘。
权威数据文件为 $DSH_HOME/conversation-map/map.json,经 /conversation-map RPC 读写并带乐观锁 revision;插件声明无 npm 依赖、无 install/postinstall 脚本。
安装与启用¶
要求 DSH >=0.2.1-rc.3(见包内 engines.dsh)。
官方命令:
dsh plugin --profile web add dsh-conversation-tree
安装后重启 DSH。树带默认收起:会话标题栏会出现约 28×28 的图标,侧栏面板行里的「Conversation Tree」入口行为一致。
若命令找不到包,可在 DSH 里 Plugins → Discover → Index sources 添加索引源后再从界面安装:
https://cdn.jsdelivr.net/gh/orchivo/dsh-plugins-index@main/index.json
也可在对话里让智能体按 README 中的三步说明代为执行上述命令与索引添加,并在完成后提示你重启。
典型用法¶
README 归纳的三种常见方式如下,均可直接对照操作。
- 多个 WorkSpace,一棵树:每个 WorkSpace 是树的第一层,各自保留会话列表,避免在长扁平列表里猜对话归属。
- 长项目按主题归档:主题可嵌套(例如目标 → 策略 → 任务);从树行打开对话时,高亮、当前会话与右侧栏保持一致。
- 交给模型维护树:在对话中说明意图,例如让模型审阅当前线程并归档到合适主题;模型通过上述 9 个工具改树,对已归档项会返回
ARCHIVED而不误改。
拖拽方面:可把对话拖到主题或 WorkSpace 行;主题可拖到其它主题或兄弟节点之间;删除主题会确认并移除整棵子树,其下对话保留并落到工作区顶层。
适用场景与注意¶
适合:同时使用多个 WorkSpace、单项目会话很多、希望按主题浏览和搜索、或希望智能体帮忙整理对话结构的用户。
运行与信任:插件以当前 DSH 进程权限运行,仅读写本地 map.json 及 DSH 已有的会话文本(用于搜索索引)。安装前建议查看 GitHub 源码 与 MIT 许可证;除你自行执行的 dsh plugin add 或添加 Discover 索引 URL 外,插件本身不联网。若产品 DOM 插槽变化导致带无法挂载,会显示「暂时不可用」提示,而不是盖住会话列。
社区目录页(与 DeepSeek / 幻方无官方从属关系):skillhub.cn 插件页。
结尾¶
dsh-conversation-tree 在不动 DSH 主界面布局的前提下,用 Workspace → 主题 → 对话 的树形带解决扁平会话列表难管理的问题,并支持本地搜索、归档与智能体协作整理。安装命令为 dsh plugin --profile web add dsh-conversation-tree,需 DSH >=0.2.1-rc.3 并在安装后重启。
- 目录页:https://www.skillhub.cn/plugins/orchivo/dsh-conversation-tree
- GitHub:https://github.com/orchivo/dsh-conversation-tree