111222cjyq/dsh-branch-visualizer

Developer Preview: persistent DeepSeek Harness session branch visualizer with navigation, rename, archive, and compatibility adapters.

Project Overview项目介绍

This is a persistent branch visualization plugin for DeepSeek Harness. It renders native session and subagent relationships into a draggable tree diagram, and supports session navigation, renaming and archiving. Use it to map multi-branch session workflows. It is a developer preview, and DeepSeek Harness itself is experimental.

这是面向DeepSeek Harness的持久化分支可视化插件,可将原生会话与子代理关系展示为可拖拽树图,提供会话跳转、改名和归档操作,适合梳理多分支会话工作流使用,当前为开发者预览版,DeepSeek Harness本身仍处于实验阶段。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:111222cjyq/dsh-branch-visualizer

把 111222cjyq/dsh-branch-visualizer 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

DSH Branch Visualizer

CI

一个面向 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:

dsh plugin --profile <profile> add github:111222cjyq/dsh-branch-visualizer

然后重启对应的 Harness 进程。Cordis 动态包是进程内实例,源码或 lib 更新不会自动替换已经运行的插件实例。

Git 依赖会通过 prepare 自动构建。如果 pnpm 报告构建脚本被阻止,请让 Harness CLI 把精确包名 dsh-branch-visualizer 加入宿主项目的 pnpm.allowBuilds,不要全局放开任意依赖脚本。

更新或移除时仍通过同一个 profile 操作,并在操作后重启 Harness。CLI 参数以当前 Harness 版本的 dsh plugin --help 为准。

使用

  1. 打开任意会话。
  2. 点击会话标题栏中的“◈ 分支图”。
  3. 双击节点跳转;拖动节点调整布局;空格加左键平移画布。
  4. 选择一个或多个节点后执行改名或归档。
  5. 需要检查完整历史时开启“显示归档”。大工作区第一次加载完整历史可能明显慢于默认视图。

持久化与数据边界

这是标准 Harness bundle,不依赖临时注入器,也不把状态写入浏览器全局变量。安装关系由 package.json 的 dsh.bundle.patch 和根目录 cordis.patch.yml 声明;宿主和客户端由同一个包提供。

插件:

  • 不包含遥测、广告、分析 SDK 或第三方网络请求;
  • 只通过 Harness 同源 /brvis/api 访问本地宿主;
  • 读取会话 ID、标题、父子关系、工作区归属、归档状态和 Agent 状态;
  • 只有在用户明确点击时才改名或归档;
  • 兼容诊断不返回路径、会话 ID、标题或用户内容;
  • 源码和发布包通过隐私扫描,禁止提交本机用户目录、私钥和明显的硬编码令牌。

更完整的威胁模型见 SECURITY.md。

面向 Harness 大改的适配结构

业务核心不直接绑定 Harness 的服务名和槽位名:

DeepSeek Harness
      │
      ├─ Host adapter: src/platform/adapters/dsh-preview-2026-08/host.ts
      ├─ Client adapter: src/platform/adapters/dsh-preview-2026-08/client.ts
      │
      ├─ Stable contracts: src/shared/
      │
      ├─ Host core: src/host/
      └─ Client core: src/client/

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev MemVault 下一个 Next dsh-outlook →