dsh-process-tree
Verifieddsh-process-tree · v0.8.2 · MIT · Web UI
Classic flowing process tree by default, with quiet lines and botanical artwork as optional styles.
Install
dsh plugin add dsh-process-tree Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-process-tree
给 DeepSeek Harness 的任务过程添加树形连接线。默认使用经典曲线,另有安静线条和植物树冠风格。支持嵌套工具调用、状态圆点、按视口绘制和减少动态效果设置。
这是社区界面插件,适用于 DSH Web 和使用同一界面的桌面版。TUI 不显示此插件。已验证环境和限制见 兼容性记录。
效果预览
以下示例来自一段真实的 DSH 桌面对话:三组只读任务分别展开多个嵌套调用,其中一项有意失败。
三种风格
同一段对话的多分支片段,从上到下依次展示经典曲线、植物手稿和安静线条。

浅色与深色
同一段多分支过程使用植物手稿风格,在两种界面外观下的效果:

安装前后
上方为未安装插件的原始过程,下方为安装过程树后使用默认经典曲线的相同记录。

同时看见不同状态
空心圆点表示已完成的工具步骤,红色节点是演示中的预期失败,蓝色节点正在运行。植物手稿的运行分支保留木色。

状态图截取自专门创建的桌面演示会话;风格与对比图使用该会话的脱敏记录,在隔离的 DSH Web 实例中回放,并拼接滚动截图以展示多层分支。图片按采集时的外观设置展示;状态颜色可以自定义。
安装
0.8.2 声明支持 DSH 0.2.1-rc.2 和 0.2.1-rc.5。rc.5 已通过隔离 Web 宿主测试及 macOS 桌面版抽查;Windows、Linux 和其他桌面配置尚未验证。早期 npm 0.8.0 仅声明支持 rc.2;请核对所选版本的兼容范围,或使用下方 GitHub 固定版本。详见兼容性记录。
通过 Discover 安装
- 打开 插件 → 实验性插件,启用 自定义插件市场 / Custom plugin markets(部分版本显示为 Custom plugin indexes)。
- 进入 发现 / Discover,选择 添加索引源 / Add index source;已有索引时,从市场菜单进入 管理索引源…。
- 粘贴下面的完整地址,添加后选择 Bosaiting 过程树。
https://raw.githubusercontent.com/Bosaiting/dsh-process-tree/main/market/index.json
搜索 dsh-process-tree 或“过程树”,核对包名 dsh-process-tree、版本的 DSH 兼容范围和来源 https://registry.npmjs.org,确认安装并按提示重启。已安装时可直接打开现有插件。索引源按 profile 保存,其他用户需要各自添加。
这是项目维护者提供的独立社区索引。详细操作、加载排查和版本维护见 Discover 安装说明。
命令行或离线安装
从 npm 安装最新版本前,请确认其声明的 DSH 兼容范围:
npm view dsh-process-tree version engines
dsh plugin --profile web add dsh-process-tree@latest
从 GitHub 安装兼容 rc.5 的固定版本:
dsh plugin --profile web add "github:Bosaiting/dsh-process-tree#v0.8.2"
也可以先下载 npm 包,再从本地安装:
npm pack dsh-process-tree@latest
# 将文件名替换为 npm pack 实际输出的名称
dsh plugin --profile web add ./dsh-process-tree-版本.tgz
安装后重新启动对应的 DSH 实例。桌面版通过其插件管理入口安装到桌面配置;已验证的 macOS 版本也可由桌面程序自带的 CLI 管理 desktop profile,单独安装的 CLI 行为可能不同。不要直接修改桌面安装目录。该插件不需要安装时构建或构建脚本许可。
使用原版 DSH 即可;Claude Style 不属于运行依赖。建议停用重复提供缩进或过程连接线的插件,尤其是 dsh-tool-indent 和其他过程树/时间线装饰,以免同时修改相同的间距和 CSS 变量。
设置
打开 设置 → 插件 → 过程树。主设置提供风格、强度、动画和状态颜色:浅色与深色界面的运行、错误颜色可以分别选择或输入六位 HEX 值,修改后立即生效并自动保存。也可单独恢复状态颜色,不影响其他偏好。
经典曲线的轻、标准、鲜明三档线宽分别为 3.10、3.80、4.64 px;植物手稿分别为 3.20、4.60、6.28 px。已保存的线宽保持不变;重新选择强度后应用新的预设值。
| 风格 | 外观 |
|---|---|
经典曲线 classic,默认 |
流动曲线、粗细衰减,完成的工具步骤长出叶片 |
植物手稿 botanical |
原创小树冠、带明暗的木质根系和状态光晕 |
安静线条 quiet,低调模式 |
1.5 px 等宽线,直主干,圆角分支,各层级一致的圆点 |
其余细项(分支过渡、线宽、纹理、叶片、圆点、缩进、摘要浓度、行距、生长速度等)收在默认折叠的 高级设置 中;在高级设置里改动线宽或圆点后,强度显示为自定义,重新选择一档即可恢复。植物风格下另有树冠设置。设置预览与聊天区使用同一渲染器,可切换预览状态和浅色、深色主题。安静线条以节点显示状态色;植物手稿的运行分支保持木色,节点及微光使用运行色。
植物手稿的高级设置中可选择开启 植物滚动优化,该选项默认关闭。开启后可减少长过程滚动时的浏览器样式重算;其他插件或自定义 CSS 若直接查询或修改树根内部元素,可能无法继续生效。关闭选项即可恢复原有访问方式,设置预览不受影响。
减少动态效果会停止生长和状态微动效。远离视口的历史过程释放绘制资源并保留布局占位;滚回时重新创建。首次安装及缺少有效风格字段的早期设置使用经典曲线,保留行外观和树冠偏好;已保存的有效风格选择不变。
数据与权限
插件读取已显示的聊天结构和元素尺寸,追加装饰 SVG;不注册模型工具、不执行命令、不发送网络请求。偏好仅保存在当前界面的 localStorage,键为 dsh.process-tree.v1。它不修改会话内容,也不读取 API 密钥。卸载保留偏好;可在设置中恢复默认值。
卸载
dsh plugin --profile web remove dsh-process-tree
重新启动相应实例;桌面版使用插件管理界面。不要删除整个 DSH profile。
开发与验证
需要 Node.js 22.19 或更新版本。运行文件已入库,无须构建。开发依赖只有测试工具及测试使用的 React,不会打入插件。
npm ci
npm test
npx playwright install chromium
npm run test:browser
npm run check:package
npm pack
已有 Chromium 可通过 DSH_CHROMIUM_EXECUTABLE 指定;浏览器测试默认使用锁定的 React 依赖,完整执行设置预览检查。与其他插件共存的额外检查可通过 DSH_COMPOSER_SOURCE 和 DSH_CLAUDE_ROW_SKIP_CSS 指定独立取得的源码,不是基础测试的前提。
旧的三风格静态示意图可在安装浏览器后运行 node scripts/capture-previews.mjs 重新生成,同样支持 DSH_CHROMIUM_EXECUTABLE。上方的实录与回放截图需要通过 DSH 界面重新采集。
canopy.svg 保留原始树冠图稿;运行时使用 client.js 中经过参数化的内嵌图稿,修改原图不会自动更新运行文件。原图不重复放入安装包。
真实宿主测试的运行方式与证据范围见 兼容性记录。不要把 DOM 夹具中的测试结果写成桌面帧率结论。提交问题时请提供 DSH 版本、系统、风格、其他界面插件及复现步骤,避免附带私人聊天内容。
许可与致谢
MIT,见 LICENSE。树冠 SVG 为项目所有者原创。缩进、摘要浓度和行距部分改编自 Asheep233 的 dsh-tool-indent,原版权及许可完整保留在 THIRD_PARTY_NOTICES.md。