dsh-session-port

Port a session in and out of DeepSeek Harness — bundle one session into a single ZIP and restore it anywhere.

中文

What it does

Export a session with everything it references — the log (root + subagents), media, and the workspace files — into one archive, then import that archive on another DSH, fully restored and re-attached to its workspace.

Action	What it does
Export	Streams one ZIP: manifest → logs → subagents → media → referenced workspace files
Import	Restores sessions, media, and workspace files; remaps paths; auto-attaches the session to its workspace
Repair	Re-attaches an imported session and re-folds its title (fixes "ungrouped" / missing name)

Install

Requires Node.js ≥ 22.10 and pnpm (dsh plugin uses pnpm underneath).

# From GitHub (default branch, or pin a tag)
dsh plugin --profile web add "github:seth-hg/dsh-session-port"
dsh plugin --profile web add "github:seth-hg/dsh-session-port#v0.1.4"

# From a local checkout
dsh plugin --profile web add /path/to/dsh-session-port

Restart dsh web. Two Export / Import buttons appear in the session header.

Usage

From the session header

• Export — downloads session-port-<id>.zip.
• Import — pick a .zip; it restores into the current session's workspace (the header cwd).

Import also accepts DSH's built-in session-log export (the header /export download): it restores the root session, subagents, and media. That export carries no workspace files, so none are expected.

From the HTTP routes (loopback-trusted)

# Export (scope=referenced by default, or workspace)
curl 'http://127.0.0.1:3080/wsx/session-pack?sessionId=<id>&scope=referenced' -o out.zip

# Import into a workspace (path remap: old::new)
curl -X POST 'http://127.0.0.1:3080/wsx/session-pack/import?workspace=/path/to/workspace&remap=/old::/new' \
  --data-binary @out.zip

# Repair an imported session (re-attach + re-fold title)
curl -X POST 'http://127.0.0.1:3080/wsx/session-pack/repair?sessionId=<id>'

HTTP API

Route	Method	Purpose
/wsx/session-pack?sessionId=<id>&scope=referenced|workspace&level=0-9	GET	Stream the ZIP archive
/wsx/session-pack/import?workspace=<dir>&remap=<old>::<new>	POST	Restore an archive (JSON summary)
/wsx/session-pack/repair?sessionId=<id>	POST	Re-attach + re-fold title (idempotent)

License

MIT