This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

dsh-trace-compare

— source: plugin_wiki.wiki_content

Install & verify

dsh plugin --profile web add dsh-maze

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

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

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

Do I need to do any configuration after installation?

No. After installation and restarting dsh web, the 'Trace Compare' entry automatically appears at the bottom of the sidebar, and each session view will also gain a 'Realtime Maze' tab.

Will the uploaded session log content be sent to the server?

No. The entire upload, parsing, and visualization run in an iframe srcDoc sandbox, completed on the browser side; log content will not reach the host or any external services.

What session log formats are supported?

Supports plain text .jsonl, as well as .jsonl.zstd from the ~/.dsh/sessions/ directory. zstd is decompressed directly in the browser (native DecompressionStream preferred, otherwise built-in fzstd soft decompression). Format is identified by content, filename can be anything.

Can the realtime maze tab view earlier historical steps?

No. The realtime tab only draws events within the currently loaded conversation window; steps outside the window are discarded and marked as 'Another N earlier history steps not loaded'. To view the complete history, you can download the log and use 'Trace Compare' to upload it.

What theme is the exported image?

Fixed light-colored background, regardless of whether the page is currently light or dark - for sharing scenarios.

Will sub-agent tasks appear in the maze?

They will appear on hosts with the ability to load sub-session history in the background (SessionFace.open). Official 0.1.0-rc.6 to rc.8 currently lack this capability; the plugin will automatically and silently hide without errors, other features are unaffected.

What method is used to determine if tool calls succeeded or failed?

Pure rules without LLM calls - four-layer judgment: error flags → strong failure characteristics (start and end windows) → weak failure characteristics (first 300 characters only) → tool classification. Paired with ethological blind retry cluster detection (parameter similarity + cluster containing failures). All thresholds are in src/client/verdict.js under VERDICT_RULES.

How to uninstall?

Remove via dsh's standard plugin command, then restart dsh web.

— source: plugin_wiki.faq_json

Compatibility

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

— source: plugin_wiki.compatibility_json

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule