dsh-session-flow

English | 中文

Restructures DSH session message streams into a foldable information flow with session-level summaries: every session becomes an archive card for cross-workspace review, search, and export. The built-in session views (Trajectory / Chat) excel at the microscopic inspection of what is happening right now; this plugin fills the missing layer of post-hoc review / archival / insight.

Interface tour

Overview workbench	Session Flow tab
Session cards with status, conclusion line, first task; hover ✎ to rename inline	"Session Flow" tab embedded in the native conversation page

Turn rail	Cross-session full-text search
Turn navigation on the left of the Chat tab: collapsed dashes ⇄ expanded cards, one-click jump	Free text in the overview triggers full-text mode: recall across workspaces, hits jump & locate

Dock details right	Folded detail view
Dock the detail into the official right panel: conversation + flow side by side, drag to resize	Turns folded by default; expand in true chronological order; four-tab navigation

Features

Install

# From the plugin market (search dsh-session-flow), or:
dsh plugin add dsh-session-flow
dsh plugin add github:YeqingTang/dsh-session-flow

After installing: restart the DSH Web service and hard-refresh the browser (Ctrl+Shift+R). Success shows the "Session Flow" entry in the sidebar.

Requirements: DSH Web GUI (latest stable); Node.js ≥ 22.19 (built-in zstd decoding, zero third-party dependencies).

Usage

• Overview: sidebar "Session Flow" → all session cards. Search supports tool: / file: / err: prefixes; free text of ≥2 characters additionally triggers cross-session full-text search.
• Detail: click a card. Turns are folded by default — click a turn header to expand; the four-tab navigation locates entries; the header offers LLM summary, ZIP export, dock right, and lineage.
• Native conversation page: the "Session Flow" tab reviews the current session in place; the turn rail on the Chat tab jumps to any turn; hover the title for ✎ rename (synced with the official title in real time).
• Health status: the health chip right of the mode label in the header (vertical bar: green = active / amber = tool running / red = likely stalled) expands on hover; click to open the Session Flow detail. Overview cards and the live bar show the same badges.
• Live: click "Live" on a running session, auto-refresh every 3 seconds.

External dependencies & requirements

• Runtime: DSH Web GUI (0.1.2-rc.1 through 0.2.1-rc.2; per-release declaration in package.json → dsh.compatibility.dshReleases); Node.js ≥ 22.19 (uses Node's built-in zstd decoding; no third-party decoder).
• Runtime dependency: only @deepseek-ai/schemastery (the DSH-vendored schema library used for the settings form schema and .volatile() hot updates).
• No lifecycle scripts: preinstall / install / postinstall / prepare are not declared, so installation runs no scripts.
• Mounted as a Bundle Patch: cordis.patch.yml only inserts this plugin's own entry — it never disables, replaces, or shadows official components.
• An independent third-party project, not an official DeepSeek component; the package name does not use the @deepseek-ai/* namespace.

Permissions & data boundaries

• No telemetry, no usage reporting; ZIP exports are local files.
• Settings are saved into the DSH profile patch (~/.dsh/profiles/<profile>/cordis.patch.yml), the same store as official settings.

Known limitations & risks

• Archive files are host implementation details: each dsh archive-generation migration (v1→v2→v3→v4) may change how logs are read. This plugin adapts to the highest generation and handles the v4 isError change, but future formats are not guaranteed to work unchanged.
• The index is an incremental cache: the first open after install/upgrade performs a full scan; very large sessions (hundreds of MB) can take a while on that first scan. Host data is never affected.
• "Dock details right" needs the official right-bar tab system (dsh ≥ 0.1.5) or the legacy details column (≤ 0.1.4); in a custom shell with neither, the button is disabled with an explanation.
• LLM summaries require a configured model in DSH; without one, only rule summaries are available.
• DOM-level enhancements (turn rail / official rail enhancement / health chip) are DOM-observation layers (the host exposes no extension slots); a major host DOM change can silently disable them until adapted.
• Does not take over or modify official UI behavior; coexistence with third-party skin/layout plugins may need extra adaptation.

Acknowledgements

• DeepSeek Harness (dsh) — the runtime this plugin builds on.
• @deepseek-ai/dsh-session-persistence-jsonl — the zstd multi-frame scanning algorithm (lib/archive.js adapted, MIT licensed).
• dsh-web-ui (@linxin666 family) — reference for the sidebar-entry / panel mounting pattern; no code copied.
• dsh-webui-market-plugin — plugin-market mechanism and distribution channel.

Apache-2.0 licensed; original license notices for third-party code are retained.

License

Apache-2.0