dsh-session-export

English | 中文

Session export for DeepSeek Harness: /transcript writes a human-readable Markdown/JSON transcript, and /archive writes raw session logs as per-session ZIPs — both to a host path, on any persistence backend (JSONL or SQLite).

Why

The shipped @deepseek-ai/dsh-session-log-export downloads a raw JSONL/zstd ZIP through the browser and supports the JSONL backend only. This plugin covers what it explicitly defers:

	official /export	this plugin /transcript
Output	raw log ZIP (browser download)	Markdown / JSON written to a host path
Persistence backends	JSONL only	any backend behind ctx.sessionQuery (JSONL, SQLite, …)
Content	machine artifacts	human transcript: messages, tool calls, editor diffs, subagent lineage, token totals

Transcript semantics follow @deepseek-ai/dsh-session/surface: the plugin renders append-origin surface events — everything the user actually saw — instead of the model-visible surface, whose compaction replacements would erase conversation the user already read.

/archive fills the second gap: the official browser /export requires a raw-artifact backend — SQLite persistence declares supportsRawArtifacts: false, so SQLite deployments get no export at all. /archive reads the complete, replay-validated log through sessionQuery.readSession (backend-agnostic) and writes one ZIP per session (session.jsonl + manifest.json) to a directory, with --all batch and --since time-range support.

Command contract

Input	Result
/transcript	Export the current session → <session cwd>/dsh-transcripts/transcript-<id8>-<timestamp>.md
/transcript <path>	Write to the given path (.md appended when missing)
/transcript --out <path>	Like positional, but the rest of the line is the path (spaces allowed)
/transcript --id <sessionId>	Export another session
/transcript --json / --md	Pick the output format(s); default --md
/transcript --full	Append the log-only events appendix (command lifecycles, compaction markers)

Like every ctx.commands command, /transcript runs on the human-command plane: the result never enters model history and costs zero tokens.

Archive

Input	Result
/archive	Archive the current session (incl. subagent descendants) → <cwd>/.dsh-archives/dsh-session-<id8>-<date>.zip
/archive --id <sessionId>	Archive that session (incl. descendants unless --no-descendants)
/archive --all	Archive every session in the current project directory
/archive --since 7d	Restrict --all to sessions created in the last 7 days (7d/12h/30m/90s)
/archive --out <dir>	Write to the given directory (rest of the line; default .dsh-archives/)
/archive --no-descendants	Exclude subagent children

Each ZIP holds session.jsonl (the complete raw event log, replay-validated, 1:1) and manifest.json (id, timestamps, cwd, event count, lineage). Like /transcript, /archive runs on the human-command plane — zero tokens. Per-session failure isolation keeps a batch running when one session fails to read.

Install (out-of-tree plugin)

From npm:

dsh plugin --profile web add dsh-session-export

Or from GitHub:

dsh plugin --profile web add github:kittimzhe/dsh-session-export

Then add to the profile's cordis.patch.yml (the row requires commands and sessionQuery services, which the shipped profiles already mount):

- id: session-export
  name: 'dsh-session-export'

What the Markdown contains

• Header table: session id, project, created, agent preset, message/tool-call counts, token totals, generator
• Lineage: ancestor chain and recursive subagent descendant tree
• Transcript in log order: user messages, assistant messages (provider/model provenance, token usage, collapsible reasoning), tool calls (arguments truncated; str_replace_editor rendered as ```diff blocks), tool results (error-aware)
• --full: log-only events appendix

Configuration

Plugin row config (all optional):

- id: session-export
  name: 'dsh-session-export'
  config:
    defaultDir: /absolute/output/dir   # default: session cwd + dsh-transcripts/
    argCharLimit: 512                  # rendered tool-argument cap
    resultCharLimit: 2048              # rendered tool-result cap
    archiveDir: /absolute/output/dir   # default: session cwd + .dsh-archives/
    includeDescendants: true           # /archive --id default
    maxSessionsPerRun: 100             # safety cap on /archive --all

Known limitations

• Exports run through the trusted ctx.sessionQuery seam; a composition without it cannot mount this plugin.
• Token totals sum per-assistant-message usage records; steps whose adapter reported no usage contribute zero.
• Markdown escapes nothing inside fenced blocks; a diff whose own lines start with +/- renders as additional diff lines (acceptable for a diff view).
• /archive is export-only: there is no restore/import because DSH exposes no write-side session seam, so the ZIP is a backup, not a round-trip.

License

MIT