dsh-session-manager

Session recycle bin & permanent delete for DeepSeek Harness.

Move the current session into a recycle bin from the conversation header, restore or permanently delete archived sessions (single or batch), with live-session protection.

The interface automatically follows the browser language: Chinese locales use Chinese and all other locales use English.

English | 中文

---

✨ Features

• Conversation-header archive button — move the current session into the recycle bin from the header (no confirmation; always recoverable).
• No duplicate of DSH's own affordance — archiving from the sidebar uses DSH's built-in hover button; this plugin no longer injects a second, differently worded icon (0.4.4 removed the old row trash icon and the document-wide MutationObserver that drove it).
• Recycle-bin manager (Settings → 🗑 会话回收站) — archived sessions with multi-select: batch restore, batch permanent delete; each item shows its ID and path.
• True permanent delete — physically removes the session log from disk and the projection-cache record; ghost sessions (records without a log) are cleaned up so they vanish instead of lingering.
• Live-session protection — sessions with an active agent are refused deletion.
• Sub-session aware — each row can show how many sub-agent sessions it left behind (whole tree, any depth) and open them inline: title, size, time and running state, with a checkbox per sub-session. Permanent delete removes the whole tree; the ones you uncheck are kept and stay reachable as a "deleted main session · N sub-sessions kept" row instead of becoming invisible leftovers.
• Running sub-agents block the row — a session is refused while any sub-session in its tree is still running, and the refusal names it.
• Batch fault tolerance — batch operations delete per-session with error collection and reporting.
• Light/dark adaptive UI — all colors are CSS custom properties in client.css; components follow the resolved DSH appearance (data-ds-dark-theme) with prefers-color-scheme as the OS-level fallback (no hardcoded palette). UI and code text follow the app font too (--dsw-font-family / --ds-font-family-code), so the Settings → 字体 choice applies here as well.

---

📋 Requirements

• DSH 0.2.0-rc.2 or newer (this release is tested on that version only; older hosts are untested).

  The recycle-bin list no longer reads session logs: its titles and turn counts come from the Session projection cache (SessionProjectionCache.cachedSnapshot, plus cachedPredecessorTitle for checkpoints written by an older format generation) — the same zero-I/O face DSH's own session list uses. On a host without those two methods the plugin still mounts, archives and restores, but the list degrades to 「未命名会话」 with no turn counts.

  The floor is declared as dsh.engines.dsh. Note that DSH 0.2.0-rc.2 does not read that field: it is documentation for users and marketplaces, not a runtime gate.

---

📦 Install

One-click from the plugin market (dsh-market)

Once listed in the awesome-dsh-plugin registry: open Settings → Plugin Market → search dsh-session-manager → install.

Manual

dsh plugin --profile web add dsh-session-manager

Then restart the web app (stop the dsh web process and run dsh web again).

Local development install

dsh plugin --profile web add link:/absolute/path/to/harness-session-delete

Uninstall

dsh plugin --profile web remove dsh-session-manager

---

🚀 Usage

1. Move to the recycle bin — click the 「移入回收站」 icon in the conversation header: the session is archived and an undo toast appears. Whether an archived session keeps showing in the left sidebar is decided by DSH's own View options → Filter sessions setting (Hide archived / All conversations / Archived only); this plugin does not touch it, exactly like DSH's built-in archive button.
2. Settings recycle bin — open Settings ⚙️ → 🗑 会话回收站:
   • Checkbox multi-select → Restore (batch unarchive) or Permanent delete (batch purge).
   • Each entry shows the session name, ID and working path (hover for full details).
3. Permanent delete physically removes the log and projection cache; live sessions are protected.
4. Undo — restoring shows an undo toast that re-archives the session.

---

🛠 Development

pnpm test          # run the test suite (host logic + HTTP routes)

Repo layout:

harness-session-delete/
├── package.json            # single bundle manifest (dsh.bundle.patch + dsh.client)
├── cordis.patch.yml        # bundle patch: one insert mounting the host row
├── index.js                # node half: host entry (inject + apply)
├── client.js               # browser half: conversation-header action + settings recycle bin
├── client.css              # plugin stylesheet: design tokens + light/dark adaptive components
└── packages/
    └── session-trash-host/ # host implementation (persistence/workspace/cache patches, HTTP routes)

Changelog convention

CHANGELOG.md and CHANGELOG.zh.md mirror each other. Every entry follows:

• Version section ## [version] - YYYY-MM-DD, with only the ### Added / ### Changed / ### Fixed / ### Performance / ### Removed headings it actually uses.
• One topic per bullet: a short bold lead stating the outcome, then 1-2 sentences on what changed and why it matters.
• No implementation detail, no code, no test or verification results — those belong in the commit or the PR.
• Write only user-visible or breaking changes; skip internal refactors with no visible effect.

---

🔌 How it works

• A single npm bundle covers both halves, same as other published plugins: the host row mounts via cordis.patch.yml; the browser half joins automatically through dsh.client + exports["./client"].
• The browser talks to the host over the plugin's own /api/session-trash/* HTTP routes (registered on the webserver; non-GET requests carry an x-dsh-plugin CSRF header).

---

📄 License

MIT