English · 简体中文
**DSH Archive Manager** adds **permanent session deletion** to the DeepSeek Harness (DSH) Web GUI: the transcript directory, workspace accounting, archive/pin markers, projection-cache row, derived subagent sessions, and spill data all go, and the sidebar updates live. Since DSH 0.1.7 the harness itself owns archived sessions — `WorkspaceRegistry.archiveSession` / `unarchiveSession`, the archived-row filter (hide / show / only), archived row styling, pinning, and the session activity gate. This plugin therefore **does not fork or replace any browser surface**: it leaves the official `ui-workspace` row exactly where the composition put it and contributes one row-menu action plus its confirmation dialog into the official sidebar. - Host half (internal `dsh-archive-manager-workspace` / `dsh-archive-manager-projcache`): `WorkspaceRegistry` and `SessionProjectionCache` subclasses that add `deleteSession` and `delete(id)` / `whenIdle()`, exposed as a Typert Remote endpoint. - Client half (internal `dsh-archive-manager-client`): a small browser bundle registering `sidebar.workspaces.session.menu.item` (the destructive "Delete session" row) and a frame-wide `shell.overlay` confirmation dialog, in Simplified Chinese and English. The plugin ships as a **single npm package** (`@gamegeek-saikel/dsh-archive-manager`) containing the three implementations as internal submodules. Its `cordis.patch.yml` substitutes the two host rows it extends and inserts its own rows. **Official package files are never modified.** --- ## Installation ### Published package (recommended) ```bash npx @deepseek-ai/dsh plugin --profile web add @gamegeek-saikel/dsh-archive-manager ``` That installs the npm `latest` tag. The plugin publishes on the same three npm channels (`latest`, `next`, `alpha`) DSH itself uses, and a build only runs on the DSH line it was built for, so install the channel that matches your runtime: | npm dist-tag | Tracks | Install command | | --- | --- | --- | | `latest` | the current DSH release line | `dsh plugin --profile web add @gamegeek-saikel/dsh-archive-manager` | | `next` | the upcoming DSH release line | `dsh plugin --profile web add @gamegeek-saikel/dsh-archive-manager@next` | | `alpha` | alpha builds | `dsh plugin --profile web add @gamegeek-saikel/dsh-archive-manager@alpha` | `npm dist-tag ls @deepseek-ai/dsh` shows which DSH version serves each line, and `npm view @gamegeek-saikel/dsh-archive-manager dist-tags` shows which plugin version serves it. A DSH runtime refuses to load a bundle whose peer ranges reject it, so picking the wrong channel fails the install outright rather than half-loading the plugin. Then start DSH Web: ```bash npx @deepseek-ai/dsh web ``` > If you have the DSH CLI installed globally, you can use `dsh` instead of `npx @deepseek-ai/dsh`. This installs the single npm package through the DSH CLI, which applies the package's root `cordis.patch.yml` (disables the stock `workspace` and `session-projection-cache` rows; inserts `workspace-archive-manager`, `session-projection-cache-archive-manager`, and `ui-workspace-archive-manager`). The stock `ui-workspace` row is left enabled. The plugin declares and is verified against DSH `^0.2.0-rc.2`. Its `@deepseek-ai/dsh*` peer ranges name the DSH release line it runs on, and the harness refuses to load a bundle whose peers reject the running runtime — so a version built for one line is never installed into the other. ## Overview Deleting a session in DSH touches several independent stores whose ordering matters, and DSH's own UI deliberately offers no delete action: a live session must be flushed and detached first (or the browser keeps a composer bound to a session that no longer exists), and the projection cache writes one final checkpoint on disposal, which would resurrect a row deleted too early. **Archive Manager** solves this with one small, disciplined layer: - **One serialized deletion flow** — `deleteSession` runs inside the registry's operation queue with strict ordering: flush → detach (`session/disposed`) → wait for the projection cache's dispose write-behind (`whenIdle`) → remove the transcript directory → clear the archive and pin markers → remove workspace accounting → delete the cache row → best-effort subagent cascade + spill cleanup. Every failing step is idempotent and re-runnable, so a retry heals a half-delete. - **No duplicated UI** — archived sessions, their filter, their styling, and unarchiving stay entirely with the official `ui-workspace` surface; this plugin adds only the action DSH does not have. ## Key Properties | Property | Value | |---|---| | Scope | Permanent session deletion (action + confirmation + host flow) | | Delivery | Single npm package; official packages untouched; web-profile patch layer (`cordis.patch.yml`) | | Install / rollback | `npx @deepseek-ai/dsh plugin --profile web add @gamegeek-saikel/dsh-archive-manager` / `... remove ...` | | Remote API | Typert endpoint `workspaceRegistry/deleteSession`; legacy `/api/workspace.*` untouched | | Inheritance | Archive / unarchive / pin / activity gate are the shipped `WorkspaceRegistry` methods, unmodified | | Delete semantics | Permanent; live session flush → detach → `session/disposed`; cache write-behind awaited before row delete; subagent children cascade (origin `subagent` only — fork branches never) | | UI surfaces | One `sidebar.workspaces.session.menu.item` row + one `shell.overlay` dialog | | Locale | Simplified Chinese (source) + English | | Tests | 19 cases across 3 `node:test` suites (host, client bundle, client remote) | ## Usage Once installed and restarted: | Surface | Description | |---|---| | Session row menu | A destructive "Delete session" row, separated from the shipped pin/rename/fork/archive rows (order 500) | | Delete dialog | Body-portaled confirmation: what is removed, the fork-branch carve-out, a pending state, and a failure that keeps the dialog open with the Host's message | | Live session delete | Composer greys out, row disappears, UI does not crash | | Archived sessions | Unchanged: the official filter (hide / show / only), styling, guarding, and unarchive still own them | ### Restart verification checklist 1. A session row's "..." menu shows "Delete session" **after** the shipped rows, separated by a hairline. 2. Confirming permanently removes the session with no disk residue: - `~/.dsh\sessions\…\session-