本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-trace-compare

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-maze

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• Trace 对比（侧边栏入口）：上传 1 个 session log 看单次运行的迷宫，或上传 2 个做同轴对比（比如同一任务 flash 与 pro 的跑法差异）——按轮次自动对齐两边的回答节点，可手动钉锚点，并按轮次盘点两边的支路差额。
• 实时迷宫（会话内页签）：同一张迷宫图随当前会话执行实时生长；某一步的工具结果一旦落定，支路立刻显现。
• 实线：主干路径——工具调用成功推进的步骤和回答节点。
• 时长胶囊条：每个步骤画成从开始到结束的圆角条，判定色填充——3 分钟的 bash 和 0.2 秒的 read 一眼可辨；条够宽时耗时直接写在条内。
• 并行工具分行（v0.3.2 起）：一步内 ≥2 次工具调用时，每次调用画成胶囊条下方的细小条（瀑布惯例），按各自真实起止摆位、按各自判定上色——一眼看出并行发的几个调用里哪个拖了时间、哪个失败；悬停单条看该次调用的命令/返回/判定依据，泳道高度随最大并行数自适应。支路节点保持「+N」标签（其空间为固定泳道格，详情面板已列全）。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后要做任何配置吗？

不需要。安装、重启 dsh web 后侧边栏底部自动出现「Trace 对比」入口，每个会话视图也会多出一个「实时迷宫」页签。

上传的 session log 内容会发到服务器吗？

不会。整个上传、解析、可视化都跑在 iframe srcDoc 沙箱里，浏览器端完成；日志内容不会到达宿主或任何外部服务。

支持哪些 session log 格式？

支持纯文本 .jsonl，以及 ~/.dsh/sessions/ 目录下的 .jsonl.zstd。zstd 在浏览器里直接解压（原生 DecompressionStream 优先，否则用内置 fzstd 软解压）。按内容识别格式，文件名任意。

实时迷宫页签能看历史更早的步骤吗？

不能。实时页签只画当前对话已加载的事件窗口，窗口外的陈旧步会被丢弃并标注「另有 N 步更早历史未加载」。要看完全量历史，可以下载 log 后用「Trace 对比」上传。

导出的图是什么主题？

固定浅色底，与页面当前是明是暗无关——为了分享场景。

子代理任务会出现在迷宫里吗？

在具备后台加载子会话历史（SessionFace.open）能力的宿主上会。官方 0.1.0-rc.6 至 rc.8 暂缺此能力，插件自动静默隐藏，不会报错，其余功能不受影响。

判定工具调用成功还是失败用的什么方法？

纯规则、不调用 LLM——四层判定：错误标志 → 强失败特征（开头与末尾窗口）→ 弱失败特征（仅开头 300 字符）→ 按工具分类。配上行为学盲目重试簇检测（参数相似 + 簇内含失败）。阈值都在 src/client/verdict.js 的 VERDICT_RULES。

怎么卸载？

通过 dsh 的标准插件命令移除，然后重启 dsh web 即可。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+ （peer 范围覆盖 rc.6 到当前 rc 线；已对 rc.6 全量验证、rc.8 插槽与类型实机验收）
• Node: ^22.19.0 || >=24.0.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则