dsh-archived-conversation
简体中文 | English
An archived-conversation manager plugin for DeepSeek Harness (DSH). It adds a Settings → 已归档 (Archived) page where archived conversations can be searched, browsed by project, unarchived, or deleted.
DSH already ships the archive capability (right-click a conversation in the left sidebar → Archive; the conversation disappears from the workspace view and its id is written to archivedSessionIds in ~/.dsh/storages/workspace.json). But DSH currently has no management UI for archived conversations and no unarchive / delete entry point — this plugin fills that gap.
Features
- Grouped by project — reuses DSH's workspace info to group archived conversations under their owning project.
- Instant search — filters archived conversations by title, project name, or session ID in the browser, without additional session-log reads.
- Unarchive — removes the id from
archivedSessionIds; the conversation returns to its original position in its workspace. - Delete — detaches from the workspace, drops from the archive set, and removes the on-disk session directory (irreversible).
- Auto-refreshes every 20 seconds and immediately whenever the window regains focus.
How it works
- Pure ESM, zero runtime dependencies (Node built-ins only), same shape as
dsh-mcp-manager. - Client: registers the "已归档" tab via the
settings.sectionslot, rendered withreact.createElement(no JSX, no bundler). - Host: mounts the
/archived-conversation/api/*same-origin JSON API viactx.webServer.register. - Performance: each refresh performs one parallel
statper archived log and reuses workspace/file metadata; title-cache hits skip header reads, while concurrent refreshes share one list rebuild. - Reuses DSH's own services; never parses the session file format:
- ctx.workspaceRegistry — the authority on archive state and project membership. - ctx.sessionPersistence.readFrom — reads each archived session's log and folds its last session/title event (the same logic as DSH's own "title" projection unit; sessionQuery.readTitleSnapshots is unreliable for cold persisted sessions). - ctx.webServer — mounts the management API.
- Guard rails: mutation requests require a same-origin Origin, JSON Content-Type, and loopback Host; sessions still in use are queued for deferred deletion instead of being corrupted.
Install
npx -p @deepseek-ai/dsh dsh plugin --profile web add <path-or-repo>Then restart dsh --profile web and reload the page. The plugin self-activates through dsh.bundle.patch; no manual cordis.patch.yml edits needed.
Usage
1. In the left sidebar, right-click any conversation → Archive (provided natively by DSH). 2. Open Settings → 已归档: browse by project or search by title, project name, or session ID. 3. For each matching conversation you can: - Unarchive — return it to its original workspace position. - Delete — remove it permanently (confirmation dialog; irreversible).
API
| Method | Path | Description |
|---|---|---|
| GET | /archived-conversation/api/ping | Liveness probe (no Origin required) |
| GET | /archived-conversation/api/list | Archived conversations grouped by project (no Origin required) |
| POST | /archived-conversation/api/:id/unarchive | Unarchive (same-origin Origin + JSON Content-Type + loopback Host) |
| DELETE | /archived-conversation/api/:id | Delete (same-origin Origin + JSON Content-Type + loopback Host) |
Layout
dsh-archived-conversation/
package.json # dsh.client.inject + dsh.bundle.patch
cordis.patch.yml # plugin row (activated by bundle.patch)
lib/index.js # host: API + archive-state read/write
lib/client.js # client: Settings "已归档" UI
README.md / README.zh-CN.md / LICENSEVerification
No build step. After installing into a live web profile, open Settings → 已归档 in the browser. Host liveness: GET /archived-conversation/api/ping.