装上执行迷宫，先看懂第一条失败支路

装上执行迷宫先看懂第一条失败支路这篇是操作路径不是评测。目标只有一个在一台干净的机器上把 dsh-maze 装出来画出你自己的第一张迷宫图并且能独立看懂里面那条红色支路到底发生了什么。每一步都写了命令和「你应该看到什么」对不上就先停下别急着往下走。装之前先把三件事对清楚dsh-maze 是 DSH 的原生插件装错版本线的表现不是报错而是「装成功了但什么都看不见」所以装之前值得花两分钟确认三件事。宿主版本。0.1.2及以后是一条线装2.xnpm 上的 latest0.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低于这个范围宿主本身就不在支持范围内别在这种环境上排插件的故障。第一步查宿主与 Nodenpmls--globaldeepseek-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-maze1.1.2桌面版建议直接钉精确版本避免 pnpm 11 的解析延迟把新版解析回上一版dsh plugin--profiledesktopadddsh-maze2.4.0预期现象命令正常结束输出里出现安装成功的包名与版本号。如果走的是 npm 源2.4.0是 2026-10-08 发布的 latest与仓库版本一致。装完先别急着找入口。想先了解这一类插件还有哪些、各自踩过什么坑可以顺手看一眼这份 完整插件清单与汉化避坑指南比在多个仓库之间来回翻要快。第三步重启 dsh webdsh web这一步不能省。插件是宿主启动时加载的装完不重启侧边栏和页签都不会出现——不是插件没装上是进程还没重新读过插件目录。预期现象浏览器打开dsh web的地址后侧边栏底部多出一个「执行迷宫」入口随便进一个会话会话视图顶部多出一个「实时迷宫」页签。两个入口都出现说明安装这一步真正完成了。只有其中一个出现先怀疑宿主版本0.1.7以上的宿主配2.2.x典型表现就是侧边栏空着、页签点开是白的。第四步在实时页签里跑一次会失败的会话这一步建议故意制造一次失败否则你看到的第一张图会全是实线学不到东西。让 Agent 执行一条会报错的命令比如读一个不存在的文件或者跑一个不存在的脚本。预期现象切到「实时迷宫」页签图随着会话推进向右生长。成功的步骤连成实线主干失败的那一步从主干上分出一条红色支路端点带 ✗。把鼠标悬在那条弧上会浮出该次调用的命令、返回摘要与判定依据。注意实时页签只画对话已经加载的事件窗口。窗口边缘更早的轮次会被丢弃并标注「⏮ 另有 N 步更早历史未加载」。短会话一般碰不到长会话一定会碰到。第五步下载 session log上传看全场要复盘一整场长会话走这条路先把会话的 session log 下载下来再在「执行迷宫」入口里上传。ls~/.dsh/sessions/预期现象目录里是原样的.jsonl.zstd文件。插件支持两种格式——纯文本.jsonlsession 格式 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 自动整理数据来源于插件详情页。