111222cjyq/dsh-branch-visualizer

README 摘要

DSH Branch Visualizer 一个面向 DeepSeek Harness 的持久化分支可视化插件。它把 Harness 原生会话与子代理关系展示为可拖拽树图，并在同一界面提供跳转、改名和归档操作。 当前状态： Developer Preview 。本插件已按 2026-08-21 的 DeepSeek Harness 0.1.0-rc.8 / master 契约核对，但 Harness 本身仍处于实验阶段。适配策略与已知风险见 DSH COMPATIBILITY STRATEGY.md 和 KNOWN LIMITATIONS.md。 功能 功能 说明 原生分支树 读取同一工作区的会话、父会话和子代理关系，自动生成树形布局 自由画布 支持拖动节点、框选、平移、缩放、自动布局和视图居中 紧凑显示 普通面板在有效缩放低于 0.6 时切换圆形节点；紧凑面板阈值为 0.85 会话跳转 双击普通节点打开会话；子代理节点使用 Harness 的 openSubagent 地址跳转 运行状态 区分 running 、 idle 、 cold ，并监听 Agent 生命周期事件 标题修改 支持活跃会话直接改名；冷会话通过持久化事件追加并处理序列冲突 单项/批量归档 归档前校验工作区归属，批量结果逐项返回；父节点归档时收集其子代理后代 归档显示模式 默认不加载归档节点；可切换完整视图。隐藏归档链时用双虚线连接最近可见祖先 性能保护 快照 TTL/LRU、同键请求合并、全局重建并发上限、子代理 TTL/LRU 和轮询退避 兼容诊断 /brvis/api/diagnostics 返回去敏的适配器版本、能力状态和缺失能力 安装 前置条件： - DeepSeek Harness 支持 bundle/plugin profile； - Node.js ^22.19.0 或 =24.0.0 ； - 使用 Harness CLI 管理插件，不要手工复制构建产物。 从 GitHub 安装到指定 profile： 然后重启对应的 Harness 进程。Cordis 动态包是进程内实例，源码或 lib 更新不会自动替换已经运行的插件实例。 Git 依赖会通过 prepare 自动构建。如果 pnpm 报告构建脚本被阻止，请让 Harness CLI 把精确包名 dsh-branch-visualizer 加入宿主项目的 pnpm.allowBuilds ，不要全局放开任意依赖脚本。 更新或移除时仍通过同一个 profile 操作，并在操作后重启 Harness。CLI 参数以当前 Harness 版本的 dsh plugin --help 为准。 使用 1. 打开任意会话。 2. 点击会话标题栏中的“◈ 分支图”。 3. 双击节点跳转；拖动节点调整布局；空格加左键平移画布。 4. 选…

分类