dsh-process-tree

English

为 DeepSeek Harness 的任务过程提供代码块与树形展示。默认使用代码块，另有经典曲线、安静线条和植物树冠风格。支持嵌套工具调用、状态展示、按视口绘制和减少动态效果设置。

这是社区界面插件，适用于 DSH Web 和使用同一界面的桌面版。TUI 不显示此插件。已验证环境和限制见 兼容性记录。

效果预览

以下示例来自一段真实的 DSH 桌面对话：三组只读任务分别展开多个嵌套调用，其中一项有意失败。

三种风格

同一段对话的多分支片段，从上到下依次展示经典曲线、植物手稿和安静线条。

代码块：任务函数（0.10.0）

第四种风格默认显示为 Python 风格的任务函数：外层 def task_01(workspace="..."):，内部是工具的真实名称与参数，思考摘要显示为绿色注释。窄行号栏、缩进导引和等宽字体让过程更接近编辑器。短会话标题可作为函数名；没有合适标题时使用稳定的编号。带子调用的工具显示为 def 作用域，子调用排列在函数体内；没有子调用的工具仍显示为普通调用。右侧迷你地图按当前已加载且可见的调用位置标记状态，可点击跳转。隐藏的子调用不会显示在地图中，记录很多时标记会按位置合并并优先保留异常和运行状态。

当前源码还可在 代码形态 → 任务函数 → 展示语言 中选择 JavaScript、C 或 C++。JavaScript 用对象展示已记录的命名参数；C 和 C++ 用注释标注参数名，对数组和对象标明 JSON，对空值明确标注 null，不推断真实参数类型。特殊工具名按记录原文显示在注释中；C++ 对名称采用独立关键字规则，虚拟文件标签为 .cpp。这些风格使用 // 思考注释和花括号，带子调用的记录用独立花括号表示层级，不添加未记录的回调或类型。所有语言视图都是执行记录的可视化示意，不是原始源代码或可执行程序；展示顺序也不能证明子调用是串行执行的。已有语言选择保持不变，未指定语言的设置继续使用 Python；行尾大括号形态不受语言选择影响。此功能属于当前源码，公开安装版本请另行核对。

也可选择 Java 风格：简单参数值按原始记录顺序展示为类似 read("src/Main.java", 20) 的位置参数，点击省略号可查看带参数名的原始记录。对象、数组、未完整记录的参数或不适合 Java 方法名的工具保留原生摘要，并可展开已记录的原始参数。显示顺序不代表真实 Java 方法签名；该视图是只读示意，.java 标签不会生成源文件。

Go 风格使用 .go 虚拟标签、func 标题和位置参数；原始参数名可通过省略号查看，null 以 nil 示意。对象、数组、不完整记录和不适合 Go 标识符的工具名保留原生摘要；子调用使用独立分组表示记录层级，不推断函数签名或执行顺序。视图仅供阅读，不生成可执行源文件。

函数视图只读复用当前界面已加载的 Chat 投影，按原生行标识匹配记录。短调用保持单行；较长调用或空间不足时，每个参数独占一行并对齐括号。长字符串及超出展示上限的参数可点击省略号查看。展开的原生工具代码块与函数摘要使用相同字号，保留原生高亮、复制和换行。函数上方显示当前轮次已加载的调用数、已记录失败数，以及存在时的中断和未结束数量；嵌套调用也计入。已完成调用仅在起止时间均可用时显示耗时。顶部虚拟标签显示任务名和只读标识；作用域旁的独立箭头折叠子调用，不改变原生工具结果的折叠状态。悬停或聚焦时高亮当前行与所在缩进导线，悬停括号会突出括号对。失败行的行号旁显示标记；错误信息或类型有明确记录时优先显示，否则将失败结果的首行标为“结果摘要”，不会冒充错误原因。点击摘要可打开原生结果。点击“已记录失败”可查看当前已加载的失败调用并跳转；插件折叠的父作用域会自动展开，尚未由宿主显示的调用标为暂不可定位。折叠作用域会显示其中已记录的失败子调用数；失败、已中断和结果未知分别显示及统计，运行中的调用计入未结束；“结果未知”仅用于宿主明确标记未知或结果记录缺少有效成功／失败字段，不能据此推断操作是否执行。当前已验证的宿主提供失败与中断状态，未提供独立未知状态。父子调用各按自身结果计数。文件参数沿用原生文件打开操作，工具结果继续使用原生折叠。缺少结构化记录、不完整参数、特殊交互控件均保守处理，不根据摘要猜参数。语法颜色与运行、错误状态分开。

长记录会优先转换当前视口附近的调用，并分批处理其余内容；尚未转换的行继续显示原生摘要。转换期间迷你地图逐步补全，统计仍来自已加载的结构化记录。

当宿主将调用标为失败、但结构化工具结果记录为成功时，统计会另列“宿主标记失败”，不把它混入“已记录失败”；这不推断命令退出码。Python、JavaScript、C 和 C++ 视图遇到无法无损表示的数字或重复参数名时显示省略号，完整参数面板保留原始记录；无法安全保留文件按钮时继续显示原生摘要。参数面板过长时仍须查看原始调用详情。

“代码形态”可切回 行尾大括号：() {、组末 }、淡范围线和括号配对高亮。原有三个风格与已保存的视觉设置保留；新增 codeLayout 默认为 function。

配色参考 VS Code Dark+／Light+：官方主题、括号配色定义。函数预览使用合成示例；大括号图片来自隔离 rc.5 宿主与测试注入的嵌套 DOM。均未为截图执行模型或工具。

浅色与深色

同一段多分支过程使用植物手稿风格，在两种界面外观下的效果：

安装前后

上方为未安装插件的原始过程，下方为使用经典曲线风格展示的相同记录。

同时看见不同状态

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

状态图截取自专门创建的桌面演示会话；风格与对比图使用该会话的脱敏记录，在隔离的 DSH Web 实例中回放，并拼接滚动截图以展示多层分支。图片按采集时的外观设置展示；状态颜色可以自定义。

安装

0.11.0 包含任务函数与大括号两种代码形态，以及多组可独立选择的 IDE 配色。

当前源码不再通过 DSH 版本号限制安装或加载。已验证版本和未验证的平台仍分别记录在兼容性记录中；移除门槛不代表已经验证未来版本。

旧版 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。详见兼容性记录。

通过 Discover 安装

1. 打开 插件 → 实验性插件，启用 自定义插件市场 / Custom plugin markets（部分版本显示为 Custom plugin indexes）。
2. 进入 发现 / Discover，选择 添加索引源 / Add index source；已有索引时，从市场菜单进入 管理索引源…。
3. 粘贴下面的完整地址，添加后选择 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

也可以从 npm 安装固定版本：

dsh plugin --profile web add dsh-process-tree@0.11.0

也可以先下载 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 值后立即生效并自动保存；也可单独恢复状态颜色，不影响其他偏好。代码风格隐藏状态颜色控件，已保存的颜色仍会保留。

选择代码块风格后，默认以任务函数形态、Python 语言展示；浅色默认 VS Code Light+，深色默认 JetBrains Darcula，代码过程区域默认使用方案背景。在代码颜色中可分别选择 VS Code、JetBrains、Catppuccin 或 Dracula 风格，也可改为跟随 DSH 背景。实时预览可切换浅色和深色。配色针对本插件的语法角色调整，部分颜色为可读性微调，不能视为原 IDE 的完整复刻。已有明确保存的选项保持不变。

展开浅色或深色设置，可调整函数与工具、关键字、参数名、字符串与文件、数字、思考与注释、普通文字以及三级括号颜色。各方案分别记住自定义值；恢复按钮只恢复当前模式下选中方案的颜色，不重置其他方案或状态颜色。升级时原有颜色作为 VS Code 方案的自定义值保留；完整恢复默认会重置所有方案偏好。切换或调整配色不需要联网。

退回旧版后如果保存设置，当前生效的颜色仍会保留，但旧版可能丢弃方案选择和其他方案的自定义值；需要退回时建议先备份设置。

经典曲线的轻、标准、鲜明三档线宽分别为 3.10、3.80、4.64 px；植物手稿分别为 3.20、4.60、6.28 px。已保存的线宽保持不变；重新选择强度后应用新的预设值。

风格	外观
经典曲线 classic	流动曲线、粗细衰减，完成的工具步骤长出叶片
植物手稿 botanical	原创小树冠、带明暗的木质根系和状态光晕
安静线条 quiet，低调模式	1.5 px 等宽线，直主干，圆角分支，各层级一致的圆点
代码块 code，默认	任务函数、真实参数、注释和行号；可选行尾大括号，保留原生操作

树形风格的细项（分支过渡、线宽、纹理、叶片、圆点、缩进、摘要浓度、行距、生长速度等）收在默认折叠的 高级设置 中；在高级设置里改动线宽或圆点后，强度显示为自定义，重新选择一档即可恢复。植物风格下另有树冠设置。代码块风格隐藏强度与高级设置。设置预览与聊天区使用同一渲染器，可切换预览状态和浅色、深色主题。安静线条以节点显示状态色；植物手稿的运行分支保持木色，节点及微光使用运行色。

植物手稿的高级设置中可选择开启 植物滚动优化，该选项默认关闭。开启后可减少长过程滚动时的浏览器样式重算；其他插件或自定义 CSS 若直接查询或修改树根内部元素，可能无法继续生效。关闭选项即可恢复原有访问方式，设置预览不受影响。

减少动态效果会停止生长和状态微动效。远离视口的历史过程释放绘制资源并保留布局占位；滚回时重新创建。首次安装及缺少有效风格字段的早期设置使用代码块，保留行外观和树冠偏好；已保存的有效风格选择不变。

数据与权限

插件读取已显示的聊天结构和元素尺寸；任务函数还只读复用当前会话已加载的 Chat 投影，不额外加载历史。插件追加自有的 SVG、代码表达式或 CSS 装饰；不注册模型工具、不执行命令、不发送网络请求。偏好仅保存在当前界面的 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。