装上执行迷宫，先看懂第一条失败支路
装上执行迷宫，先看懂第一条失败支路
这篇是操作路径，不是评测。目标只有一个：在一台干净的机器上把 dsh-maze 装出来，画出你自己的第一张迷宫图，并且能独立看懂里面那条红色支路到底发生了什么。每一步都写了命令和「你应该看到什么」，对不上就先停下，别急着往下走。
装之前，先把三件事对清楚
dsh-maze 是 DSH 的原生插件，装错版本线的表现不是报错，而是「装成功了但什么都看不见」，所以装之前值得花两分钟确认三件事。
宿主版本。0.1.2及以后是一条线，装2.x（npm 上的 latest）；0.1.0-rc.6到0.1.1-rc.2是另一条线，必须手动钉1.1.2。两条线不通用，因为0.1.2重新拆分了客户端包，还换掉了会话快照的数据模型。
宿主0.1.7及以后要求 dsh-maze2.3.0以上。更早的2.x也能装上，但侧边栏入口不显示、实时迷宫页签是空白——这个坑后面单独说。
Node 版本。要求^22.19.0 || >=24.0.0，低于这个范围宿主本身就不在支持范围内，别在这种环境上排插件的故障。
第一步：查宿主与 Node
npmls--global@deepseek-ai/dshnode-v第一条命令会打印全局安装的@deepseek-ai/dsh版本，比如0.2.0-rc.2。桌面版没有这条命令的输出，看安装包或「关于」里标注的内核版本即可。第二条确认 Node 落在^22.19.0 || >=24.0.0里。
预期现象：两行版本号都能读出来。如果npm ls报(empty)，说明你的 dsh 不是 npm 全局装的，先弄清楚它从哪来，再决定装哪条线——版本线判断错了，后面所有步骤都会白做。
第二步：装插件
宿主在0.1.2及以后：
dsh plugin--profilewebadddsh-maze宿主是0.1.0-rc.6~0.1.1-rc.2的老线：
dsh plugin--profilewebadddsh-maze@1.1.2桌面版建议直接钉精确版本，避免 pnpm 11 的解析延迟把新版解析回上一版：
dsh plugin--profiledesktopadddsh-maze@2.4.0预期现象：命令正常结束，输出里出现安装成功的包名与版本号。如果走的是 npm 源，2.4.0是 2026-10-08 发布的 latest，与仓库版本一致。
装完先别急着找入口。想先了解这一类插件还有哪些、各自踩过什么坑，可以顺手看一眼这份 完整插件清单与汉化避坑指南，比在多个仓库之间来回翻要快。
第三步：重启 dsh web
dsh web这一步不能省。插件是宿主启动时加载的，装完不重启，侧边栏和页签都不会出现——不是插件没装上，是进程还没重新读过插件目录。
预期现象：浏览器打开dsh web的地址后，侧边栏底部多出一个「执行迷宫」入口；随便进一个会话，会话视图顶部多出一个「实时迷宫」页签。两个入口都出现，说明安装这一步真正完成了。
只有其中一个出现，先怀疑宿主版本：0.1.7以上的宿主配2.2.x，典型表现就是侧边栏空着、页签点开是白的。
第四步：在实时页签里跑一次会失败的会话
这一步建议故意制造一次失败，否则你看到的第一张图会全是实线，学不到东西。让 Agent 执行一条会报错的命令，比如读一个不存在的文件，或者跑一个不存在的脚本。
预期现象：切到「实时迷宫」页签，图随着会话推进向右生长。成功的步骤连成实线主干，失败的那一步从主干上分出一条红色支路，端点带 ✗。把鼠标悬在那条弧上，会浮出该次调用的命令、返回摘要与判定依据。
注意实时页签只画对话已经加载的事件窗口。窗口边缘更早的轮次会被丢弃，并标注「⏮ 另有 N 步更早历史未加载」。短会话一般碰不到，长会话一定会碰到。
第五步：下载 session log，上传看全场
要复盘一整场长会话，走这条路：先把会话的 session log 下载下来，再在「执行迷宫」入口里上传。
ls~/.dsh/sessions/预期现象：目录里是原样的.jsonl.zstd文件。插件支持两种格式——纯文本.jsonl（session 格式 v0 事件流）和这种.jsonl.zstd，浏览器端直接解压：原生DecompressionStream('zstd')可用时优先，否则用内置的 fzstd。格式按文件内容识别，文件名任意，macOS 复制出来的「session.jsonl 2」也能直接选。
上传后你会拿到完整时间轴，不会再有「更早历史未加载」的缺角。
第一张图该看什么
先看骨架，不要一上来就点分析区。
实线是主干，代表工具调用成功推进的步骤和回答节点。红色 ✗ 是失败支路，灰色 · 是检索扑空，灰色 ↻ 是盲目重试，虚线弧是折返回分支点的回程线。
再看时长。每一步画成一根从开始到结束的圆角条，按判定色填充，条够宽时耗时直接写在条里。3 分钟的 bash 和 0.2 秒的 read 摆在一起，不用看数字也知道时间花在哪。
一步里并行发了多个工具调用时，胶囊条下方会有几根细条，按各自真实起止摆位、各自上色。这是 v0.3.2 起的并行分行，泳道高度随最大并行数自适应——哪次调用拖了时间、哪次失败了，一眼就能分出来。
八小时的会话不要硬看。整图先给「×N」聚合徽标，点击放大，标签才逐级补齐。空闲超过 60 秒的区间会压成一条带⏸的细缝并标明省略时长，轴被压缩了，但步骤时长、工具耗时、总耗时仍是墙钟真值。
第一条失败支路：从红 ✗ 点到原始命令
这是整个工具最值得练熟的动作。
把鼠标移到红色支路上，先看浮层里的命令和判定依据；然后点击，右侧会打开固定详情面板，里面有完整命令、返回内容（保留前 5000 字）、耗时、判定与思考摘要。命令和返回各带一个复制按钮，Esc 或 × 关闭。
再往下是执行分析区的失败恢复链。每个失败调用后面发生了什么，被归成四类：原样重试、换参数、换工具、未恢复，恢复耗时如实标注。点其中一条，视图会缩放到那次失败并打开详情。
这时候你才第一次看清：那次失败之后，Agent 是换了个参数重试，还是原封不动又发了一遍。后者就是无效重试，链上不会把它算成「已恢复」——链只统计失败（✗），扑空和盲重试各进结果矩阵的列，不单独进链。
安全与适用范围
上传与可视化页面是一份自包含 HTML，跑在沙箱化的 iframe 里，解析和渲染全部在浏览器端完成，上传的日志内容不会到达宿主。
安全档位需要说清楚：本站在静态扫描下的结论是 🟢 未发现敏感能力，但尚无人工评估，也尚未做风险分级。这三句话要一起读，扫描没发现问题不等于有人逐行审过。
最后一句实话：这套东西的价值随会话长度上升。跑十几分钟的小任务，图上只有几根实线，分析区也报不出几个信号，不如直接看对话。
总结
装 dsh-maze 的关键只有三步——对清宿主版本线、装完重启dsh web、用一条会失败的命令跑出第一支红叉；更多同类插件的中文清单见 完整插件清单与汉化避坑指南。
适合与不适合
适合：刚开始用 DSH、想先把执行过程看明白的新手；需要向同事解释「这一步为什么失败」的工程师；要在长会话里定位时间黑洞的人；想拿一张图做事故复盘材料的人。
不适合：宿主还停在0.1.1以前又不愿意钉1.1.2的环境；只跑几分钟短会话、本来就没有支路的场景；不愿意把 session log 交给浏览器端解析的合规团队；期待它替你做性能优化建议的人——它只呈现证据，不给结论。
标签：dsh-maze、DeepSeek Harness、插件安装、执行可视化、新手教程
本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。