dsh-vault

English | 中文

A DeepSeek Harness (DSH)
plugin that keeps every conversation and log inside the workspace folder, so
the folder becomes a self-contained, portable archive.

When dsh-vault is installed, each workspace folder gains a
dsh-session-vault/ directory:

my-project/
  dsh-session-vault/
    workspace.json          # the workspace title (name) + a vault marker
    sessions/
      <session-id>.jsonl    # one append-only conversation log per session

• Every session whose cwd is the workspace is mirrored into
  dsh-session-vault/sessions/ as it happens.
• The workspace title is cached in dsh-session-vault/workspace.json.

Why this works on a new computer

1. Copy the workspace folder (the whole directory, including the
   dsh-session-vault/) to the new computer.
2. Install DSH and this plugin there.
3. Open the copied folder as a workspace.

On open, dsh-vault imports every session from the vault back into DSH
persistence (rebinding each session's cwd to the folder's current location),
and restores the workspace name from workspace.json. All conversations —
including the workspace title — come back.

Install

# from GitHub (works immediately — no npm publish required)
dsh plugin --profile web add git+https://github.com/XiaoWind/dsh-vault.git

# or from npm, once published
dsh plugin --profile web add dsh-vault

dsh plugin forwards to pnpm inside the web profile directory, then
reconciles the profile's dsh.profile.bundles layer list. Because this package
declares dsh.bundle.patch, it joins the layer stack automatically. Restart the
Web app after installing.

The plugin injects sessionPersistence, workspaceRegistry, and commands,
so it activates only in profiles that compose those host services — the
shipped web profile does.

Update

Pull the latest version into an installed profile:

dsh plugin --profile web update dsh-vault

dsh plugin forwards to pnpm update dsh-vault, which re-resolves the
github:XiaoWind/dsh-vault dependency to the latest commit on the default
branch. The lockfile pins a git dependency by commit hash, so a version bump
is not required for the update to land. If pnpm has cached an old resolution,
re-pin it explicitly:

dsh plugin --profile web add github:XiaoWind/dsh-vault

Restart the Web app after updating — the bundle layer is composed at boot, so a
running Web process does not hot-reload an installed plugin.

Usage

The vault runs automatically — no setup required. A /vault slash command
provides visibility and manual control:

How it behaves

• Continuous mirroring. As a session appends events, they are written to
  the workspace's dsh-session-vault/sessions/<id>.jsonl in order. On session
  disposal the file is rewritten as a clean snapshot.
• Automatic restore. At boot, and whenever a workspace is opened, the
  plugin imports any vault session missing from DSH persistence and applies the
  vaulted title. On a brand-new machine, opening the copied folder as a
  workspace triggers the same restore.
• Portable paths. Session cwds are rebound to the workspace's current
  absolute path on import, so a folder copied to a different location restores
  cleanly.
• Idempotent. Sessions already in persistence are never re-imported, and
  attaching/renaming is a no-op when nothing changed.

Configuration

No configuration is required. The plugin inserts with an empty config; the
vault directory name (dsh-session-vault) and the JSONL format are fixed so
vaults stay interchangeable across machines.

Each vault's workspace.json also carries a kind: "dsh-vault" marker, so the
plugin recognizes a vault by its content rather than relying on the directory
name alone.

Development

# syntax check
node --check lib/index.js
node --check lib/vault.js

The plugin is dependency-free ESM (lib/index.js + lib/vault.js) with no
build step. It exports apply, inject, and name, and the bundle layer
cordis.patch.yml inserts it into the profile composition. The JSONL format is
self-contained and independent of the harness, so lib/vault.js can be
unit-tested directly.

License

MIT