前言¶
DSH 的理念是「一切皆插件」。社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
当同一个工作区里有多条会话、父会话和子代理时，普通文本视图不容易快速看出分支关系。下面介绍 dsh-branch-visualizer：一个持久化 DeepSeek Harness 插件，用于查看原生会话分支，并进行跳转、改名和归档。
这是什么¶
dsh-branch-visualizer 由 111222cjyq 维护，采用 MIT 许可证。
它读取同一工作区的会话、父会话和子代理关系，自动生成树形布局，并在同一界面提供会话跳转、标题修改和归档操作。
当前状态为 Developer Preview。DeepSeek Harness 本身仍处于实验阶段。
核心功能¶
分支树与画布¶
- 读取同一工作区的会话、父会话和子代理关系，自动生成树形布局。
- 支持拖动节点、框选、平移、缩放、自动布局和视图居中。
- 普通面板在有效缩放低于
0.6时切换圆形节点；紧凑面板阈值为0.85。
会话跳转¶
- 双击普通节点打开会话。
- 子代理节点使用 Harness 的跳转地址：
openSubagent
状态、改名与归档¶
- 区分
running、idle、cold，并监听 Agent 生命周期事件。 - 活跃会话可直接改名。
- 冷会话通过持久化事件追加，并处理序列冲突。
- 归档前校验工作区归属。
- 批量归档结果逐项返回。
- 父节点归档时收集其子代理后代。
归档视图¶
- 默认不加载归档节点。
- 可切换完整视图。
- 隐藏归档链时，用双虚线连接最近可见祖先。
性能与诊断¶
- 使用快照 TTL/LRU、同键请求合并、全局重建并发上限、子代理 TTL/LRU 和轮询退避。
- 提供去敏诊断接口：
/brvis/api/diagnostics
该接口返回适配器版本、能力状态和缺失能力。
安装与启用¶
从 GitHub 安装到指定 profile：
dsh plugin --profile <profile> add github:111222cjyq/dsh-branch-visualizer
安装后重启对应的 Harness 进程。
典型用法¶
1、打开任意会话。
2、点击会话标题栏中的“◈ 分支图”。
3、双击节点跳转；拖动节点调整布局；空格加左键平移画布。
4、选择一个或多个节点后执行改名或归档。
5、需要检查完整历史时开启“显示归档”。
适用场景与注意¶
这个插件适合需要查看同一工作区会话分支、子代理关系和归档历史的 DSH 使用者。
由于它随当前 dsh 进程运行，安装前应检查源码和 MIT 许可证。
当前使用要注意：
- 当前只支持：
dsh.client.platform = web
未验证 Electron/桌面专用 bridge。
- HTTP 边界用于阻止普通跨站浏览器请求，不是本机恶意进程隔离或多用户认证系统。
- 冷会话改名依赖 session event 结构，容易受 Harness schema 变化影响。
- 尚未提供“取消归档”。
- 键盘无障碍和触屏手势仍不完整。
- 不包含遥测、广告、分析 SDK 或第三方网络请求。
- 只通过 Harness 同源接口访问本地宿主：
/brvis/api
链接¶
- 目录页：dsh-branch-visualizer
- GitHub：dsh-branch-visualizer
