前言¶
DeepSeek Harness (DSH) 的会话管理通常涉及 fork 会话以并行处理任务。随着会话数量增加，仅凭列表视图很难把握上下文和任务分支。分支图谱插件通过树形结构提供了一种解决方案，将 fork 会话组织成可视化的图谱，并允许为每个分支添加文档和持久化布局。
插件定位¶
这是一个用于树形管理 fork 会话、每分支注解文档以及布局持久化的插件。由 useful-money 维护。它提供零第三方依赖、零 CDN 和零构建步骤的静态双端包形态。
安装与启用¶
插件通过一条命令完成安装与激活，无需手工改 patch 文件或 mklink junction。
dsh plugin --profile web add github:<你的用户名>/branch-map-plugin
核心功能¶
- 树形管理 fork 会话：将 fork 会话呈现为树形结构。
- 每分支注解文档：为每个分支添加描述。
- 布局持久化：保存拖拽后的卡片位置。
- 零依赖：纯自研渲染，无外部依赖。
典型用法¶
- 打开任意会话，顶部会出现“分支图谱”标签。
- 卡片代表一个工作区会话，连线上的圆点代表分叉点（
#fork序号）。 - 拖拽卡片调整布局（自动保存）；在空白处拖拽可平移视图。
- 使用工具栏进行“重置布局 / 适应窗口 / 刷新”。
- 点击“编辑”打开对话框，可修改分支名称、说明、状态和标签。
- 使用状态下拉列表过滤卡片。
- 点击“跳转”在新会话中打开该分支。
数据与文件¶
树结构不落盘，按会话 cwd 实时聚合。数据存储在工作区根目录下的 .branchmap 文件夹中：
* annotations.yaml：存储分支注解信息，包含乐观锁 revision。
* layout.yaml：存储节点位置信息，拖拽后自动保存。
* diag.log：诊断日志文件。
卸载¶
若需移除插件：
dsh plugin --profile web remove @local/branch-map
参考资料¶
- GitHub 仓库：https://github.com/useful-money/Deepseek-Harness-branch-map-plugin
- 插件目录：https://www.skillhub.cn/plugins/useful-money/Deepseek-Harness-branch-map-plugin
