Back to directory

dsh-maze

Curated pickMaintenance: Active

lamost423/dsh-maze

Visualizes DSH agent sessions as a maze timeline: main path, failed branches, data tracks, failure-recovery analysis, replay.

View on GitHubHomepage
$ npm install --global @deepseek-ai/dsh@0.1.0-rc.8

59

stars

3

forks

HTML

Language

MIT

License

2026-08-18

Created

2026-08-29

Last push

A native dsh web plugin that turns DeepSeek Harness agent sessions into an inspectable execution maze — maze timeline, data tracks, deterministic failure analysis, multi-session comparison and replay — with no data leaving the browser.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-08-30

License

MIT

01What can it help you accomplish?

  • Turn a DeepSeek Harness agent session into an inspectable execution maze

    A single timeline of the main path, failed branches and data tracks (tool density, token pulses, context pressure), with deterministic failure-recovery analysis

    DSH users and developers who want to see exactly how an agent worked — main path, failed branches, retries and recovery

  • Compare runs of the same task and replay a session to understand its path to the result

    Co-axis comparison of 2–5 runs (round alignment, branch inventory, manual anchors) and up to 300× replay of the whole execution

    Engineers and evaluators comparing model behavior across runs or reviewing how a long session actually reached its outcome

02How to install into DeepSeek Harness

Prerequisites

  • Official dsh host installed — the README verifies against 0.1.0-rc.6 and rc.8, with the peer range covering rc.6 to the current rc line
  • Node.js toolchain with pnpm if installing from source (`corepack enable && pnpm install && pnpm build`)

Installation steps

  1. 01

    Install the host globally: `npm install --global @deepseek-ai/dsh@0.1.0-rc.8`

    $ npm install --global @deepseek-ai/dsh@0.1.0-rc.8

  2. 02

    Add the plugin: `dsh plugin --profile web add dsh-maze`

    $ dsh plugin --profile web add dsh-maze

  3. 03

    Launch the host: `dsh web`

    $ dsh web

Verify the integration

  • 重启 `dsh web` 后,侧边栏底部出现「执行迷宫」入口,每个会话视图多一个「实时迷宫」页签。

03DSH integration and capability boundaries

DSH integrationNative runtime

Installed as a first-class dsh web plugin via `dsh plugin --profile web add dsh-maze`; injects a 'Maze' sidebar entry and a live 'Maze' tab into the host.

  • Maze timeline visualization

    DSH session event stream (.jsonl / .jsonl.zstd)One timeline of the main path, failed branches and data tracks (tool density, token pulses, context pressure)

  • Failure-recovery & execution analysis

    Judged tool calls and their verdictsFailure-recovery chain, tool result matrix, duration scatter, and an agent relation graph

  • Multi-session comparison & replay

    2–5 runs of the same taskCo-axis comparison (round alignment, branch inventory, manual anchors) and up to 300× replay

  • Maze UI injection into dsh web

    A running dsh web hostA 'Maze' sidebar entry plus a per-session 'live maze' tab

    Injects a 'Maze' entry into the dsh web sidebar and adds a 'live maze' tab to every session view

04Who is it for? When not to use it?

Good for

  • DSH users and developers who want to see exactly how an agent worked — main path, failed branches, retries and recovery
  • Engineers and evaluators comparing model behavior across runs or reviewing how a long session actually reached its outcome

Not for

  • Tied to the official dsh host rc line: the README verifies against 0.1.0-rc.6 and rc.8 (peer range covers rc.6 to the current rc line) and re-verifies on each new rc, so an unsupported host version will not load the plugin correctly.
  • The upstream-master host 0.1.2 re-split its client packages and changed the session snapshot data model; the two host lines are not plugin-compatible. The 1.1.x line (npm install path) and the 2.x line (host 0.1.2) are separate, so picking the wrong line means the plugin will not work.

05Compatibility, maintenance and safety notes

  • Tied to the official dsh host rc line: the README verifies against 0.1.0-rc.6 and rc.8 (peer range covers rc.6 to the current rc line) and re-verifies on each new rc, so an unsupported host version will not load the plugin correctly.
  • The upstream-master host 0.1.2 re-split its client packages and changed the session snapshot data model; the two host lines are not plugin-compatible. The 1.1.x line (npm install path) and the 2.x line (host 0.1.2) are separate, so picking the wrong line means the plugin will not work.
2026-08-182026-08-29v1.1.0

MIT · actively maintained (latest release v1.1.0, 2026-08-26)

06Frequently asked questions

How do I install dsh-maze for DeepSeek Harness?

Install the official dsh host first (e.g. `npm install --global @deepseek-ai/dsh@0.1.0-rc.8`), then run `dsh plugin --profile web add dsh-maze` and start it with `dsh web`. After restart, a 'Maze' entry appears in the sidebar and each session gains a 'live maze' tab.

What session log formats does dsh-maze read?

It identifies format by file content (any filename). It reads plain-text `.jsonl` session v0 event streams and native `.jsonl.zstd` from `~/.dsh/sessions/`, decompressed in the browser.

Does dsh-maze send my session logs anywhere?

No. The upload/visualization page is a self-contained HTML running in a sandboxed iframe; parsing and rendering happen entirely in the browser, and uploaded log content never reaches the host.

Which dsh host versions are supported?

It is verified against the official 0.1.0-rc.6 and rc.8 host lines (peer range covers rc.6 to the current rc line) and re-verified on each new rc. A separate 2.x line tracks the upstream host 0.1.2 package split via `dsh plugin --profile web add dsh-maze@2.0.0-alpha.2`.

08Data and sources

  • Author-claimedgithub.com66abee3bbcdd…

    dsh plugin --profile web add dsh-maze

  • Author-claimedgithub.com66abee3bbcdd…

    重启 `dsh web` 后,侧边栏底部出现「执行迷宫」入口,每个会话视图多一个「实时迷宫」页签。

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-30. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.