- Home
- Plugins
- Sessions & Messages
- dsh-del-chat
dsh-del-chat
slz2025/dsh-del-chat
Adds a Delete archive item to the sidebar Session menu for archived Sessions. A confirmation dialog shows the JSONL log size and projection cache state first; confirming removes the Session JSONL log, projection cache and Workspace record from disk. Unarchived Sessions never offer it, and attachments plus the cost ledger stay untouched. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.
Install
dsh plugin --profile web add github:slz2025/dsh-del-chatREADME
dsh-del-chat
Deleting an archived conversation in DeepSeek Harness, for real. Archiving a Session only hides it from the sidebar — the log stays on disk forever. This plugin adds a Delete archive item to the sidebar Session context menu and removes an archived Session's log, projection cache and Workspace record from disk.
| Before | After |
|---|---|
Session archived, still 2.3 MB of session.v4.jsonl.zstd under ~/.dsh/sessions/** | Log slot and projection cache gone; the sidebar row disappears; the archived id is gone from workspace.json |
What it adds
One item in the sidebar Session context menu — the menu that carries Rename, Fork Session, Copy Session ID and Unarchive — rendered in the danger style below a separator:
┌────────────────────────────┐
│ 重命名 Ctrl+Alt+G │
│ 分叉会话 Ctrl+Alt+F │
│ ────────────────────────── │
│ 复制 Session ID │
│ 在应用中打开 › │
│ 取消归档 │
│ ────────────────────────── │
│ 🗑 删除归档 │ ← this plugin
└────────────────────────────┘
The item only shows up for a Session that is already archived: an unarchived one may still be written to and must not be purged, while an archived one can no longer be opened, so the header "…" menu can never reach it.
Clicking it opens a confirmation dialog that reports the Session id, the size of
its log and whether a projection cache exists — then the Host half deletes it. The
Host keeps an independent guard: a Session that was never archived is refused
(409), so the flow is always archive → inspect → delete.
Requirements
- DeepSeek Harness with the Web client (Desktop app included), plus the
workspaceRegistryandsessionPersistenceservices — both ship with the desktop profile. - Node 22 or newer on the Host side (the routes use
Request/Response).
Install
Ask DSH to install the bundle, or use the Plugins page. The bundle is a normal DSH bundle whose patch inserts one row:
- insert:
- id: dsh-del-chat
name: dsh-del-chat
Install it from npm:
dsh plugin add dsh-del-chat
Or straight from this repository, pinning a revision:
dsh plugin add git+https://github.com/SLZ2025/dsh-del-chat.git#<commit>
A local checkout installs the same way: dsh plugin add D:\path\to\dsh-del-chat.
Either way, quit DSH completely and start it again afterwards. A page refresh loads only the client half: the menu item shows up, but the Host routes stay unregistered and the dialog says the Host half is not loaded.
Usage
- Archive the conversation you want gone — right-click the sidebar row → 归档 /
Archive, or the
Ctrl+Shift+Ashortcut on the open Session. - Right-click that (now greyed out) sidebar row and pick 删除归档 / Delete archive.
- Check the numbers in the dialog, then press 永久删除 / Delete permanently.
The session-<id>/ directory is gone immediately, and the plugin then asks the
Client to pull the Host-authoritative Session catalog again, so the row leaves
the sidebar without a reload. (The sidebar draws from that catalog; nothing
else tells it the row is gone.)
Where the bytes live
$DSH_HOME/sessions/<workspace-key>/session-<id>/session.v4.jsonl.zstd deleted
$DSH_HOME/storages/session_projcache/sessions/session-<id>.json deleted
$DSH_HOME/attachments/v1/objects/<2hex>/<sha256> kept (content addressed, shared)
$DSH_HOME/storages/cost-meter/ledger.json kept (third-party ledger)
The Workspace record and the archive mark are removed through the registry's own
write chain, never by editing workspace.json.
How it works
See docs/DETAIL.md for the reasoning, the guard table and the
known costs. In short: the client half registers a data-only menu contribution for
session (it asks the status route once when the menu opens, and only offers the
item for an archived Session) plus one shell.overlay dialog; the Host half
exposes GET /plugin/dsh-del-chat/status and POST /plugin/dsh-del-chat/purge,
checks that the id is archived and that the slot directory really is that Session's
slot under the persistence root, then deletes. It detaches and unarchives only when
the Host has already released the Session; while the Session is still resident in
the Host's in-memory store (a plugin cannot drop that entry) the delete keeps the
archive mark and settles the workspace record on session/disposed instead, so the
ghost row never reappears under Ungrouped.
Troubleshooting
- The item is missing — it only appears for archived Sessions. Archive first
(
Ctrl+Shift+A), refresh the page so the client half is loaded, then right-click the sidebar row. - "The Host half of this plugin is not loaded" — the plugin is installed but
the running DSH process predates it. Quit the app completely and start it
again;
%TEMP%\dsh-del-chat.logshould then contain[apply]. - "Only archived Sessions can be deleted permanently" — archive it first; that prerequisite is deliberate.
log-locked(423) — the log is still open in another process. Restart DSH and retry.- The row is still in the sidebar — two cases. If it is greyed and still sits in its own group, the Host was still holding the Session in memory; it disappears for good once the Host releases it (the plugin settles the record then). If it went to Ungrouped, the Session log still exists: check the dialog numbers and the Host log.
- Dialog works but nothing is deleted — check the Host log for
delete-failedand the reportedmessage.
Development
node --check index.js
node --check client.js
node test/purge-core.test.mjs
node test/host-routes.test.mjs
node test/smoke.mjs
test/purge-core.test.mjs exercises the filesystem helpers against temporary
trees; test/host-routes.test.mjs drives both routes with a stub Cordis context,
a stub registry and a temp DSH_HOME; test/smoke.mjs checks the manifest shape
and that every module imports.
CI runs the same commands on Ubuntu and Windows with Node 22 — see
.github/workflows/ci.yml.
License
MIT
Related plugins
billion-context
ranxianglei/billion-context
dsh-web-ui (dsh-chat-recovery)
zhu1090093659/dsh-web-ui
dsh-synapse
liangmianya/dsh-synapse
dsh-archive-manager
michengai/dsh-archive-manager