DSH Session Rerun

English | 中文

dsh-session-rerun is an installable DeepSeek Harness Web plugin for inspecting and replaying a completed session Step.

Features

• Groups the durable session timeline by Turn and Step.
• Shows model replies, tool calls, Skills, failures, and elapsed time.
• Displays referenced script and Markdown filenames as compact badges on the right side of each Step.
• Replays a top-level Step in a new session without changing the source session.
• Replays a selected Subagent Step through a new main session in the original workspace. The new main Agent keeps only the recreated delegation, waits for the new child, and continues from that child's result.

Installation

From npm (recommended)

npx @deepseek-ai/dsh plugin --profile web add \
  dsh-client-ui-session-rerun \
  --registry=https://registry.npmjs.org/

For DSH Desktop, use the same package with the Desktop profile:

npx @deepseek-ai/dsh plugin --profile desktop add \
  dsh-client-ui-session-rerun \
  --registry=https://registry.npmjs.org/

From GitHub

npx @deepseek-ai/dsh plugin --profile web add \
  github:liuyangdongdong/dsh-session-rerun

Replace --profile web with --profile desktop to install the GitHub build in DSH Desktop.

Start Web

npx @deepseek-ai/dsh web

Restart an already running Web process after installing or replacing the plugin.

Behavior

The plugin never mutates the source session. A successful replay creates a new main session in the source workspace and opens it in the Web UI.

For a normal Step, the new Agent receives the durable history before the selected Step and that Step's logged user input. For a Subagent Step, the plugin creates a new main session and a new child session. The child replays the selected Step, while the new main session reconstructs only the delegation call, waits for the child, receives the new child result, and then continues.

Nested Subagent replay is intentionally unsupported. A Step must exist and have a matching step/end event before it can be replayed.

See Architecture for the package split and lifecycle.

Packages

| Package | Role | |---|---| | dsh-client-ui-session-rerun | Installable Web bundle, timeline projection, replay controls, and file badges | | dsh-session-rerun | Host Remote that reads durable sessions and creates replay sessions |

The root package declares dsh.bundle.patch in package.json; cordis.patch.yml mounts both roles. This follows the Harness profile and bundle model without modifying agent-loop.

Development

Requirements: Node.js ^22.19.0 || >=24.0.0 and pnpm 11.7.0.

pnpm install
pnpm typecheck
pnpm test
pnpm pack:check

The committed lib/ artifacts make npm and GitHub installations executable without an install-time build. The Web client artifact uses the DeepSeek Harness module-loader bundle format; regenerate it with a compatible Harness checkout after changing browser source.

The client accepts both the split conversation registries used by current Web profiles and the combined uiConversation service used by DSH Desktop 2.0.4.

The standalone CI checks the distributable bundle, package exports, Cordis patch, and pure timeline projection. The complete Host, browser registration, event-assembler, and React integration suites remain in packages/host/tests and tests; they run in a compatible DeepSeek Harness source checkout, where the source-plane module table is available.

DeepSeek Harness is in developer preview, so peer dependency versions may need to move with upstream releases.

License

MIT