dsh-delete-chat

dsh plugin --profile web add dsh-delete-chat

dsh-delete-chat

A DeepSeek Harness session manager: a settings page that lists every session and lets you archive (hide), unarchive (restore), and permanently delete sessions.

一个 DeepSeek Harness 会话管理插件：在设置页中列出全部会话，并支持归档（隐藏）、取消归档（恢复显示）与永久删除会话。

What it does / 功能

• List every session with its title, working directory, and creation time, split into archived and active groups.
• Archive a session to hide it from the sidebar. The log is kept, so archiving is fully reversible.
• Unarchive a session to make it visible again.
• Delete a session permanently: removes its persistence log file, then detaches it from workspace accounting and from the archive set.

Install / 安装

dsh plugin --profile web add dsh-delete-chat

The package declares dsh.bundle.patch, so the command installs it and reconciles it into dsh.profile.bundles — no profile file editing. Restart dsh web to mount it.

Usage / 使用

Open Settings → 会话管理 (Session Manager).

Safety / 安全边界

• Archive is not delete. Archiving only hides a session; its log stays on disk and 取消归档 restores it.
• Live sessions cannot be deleted. A running session's delete button is disabled, and the host refuses the call even if it is reached directly.
• Delete is permanent and two-step. The first click shows the exact file path that will be removed; only a second click deletes anything.
• Only the session's own artifact is touched. The host resolves the path through sessionPersistence.locate(), refuses anything whose filename is not session.jsonl*, and refuses backends that expose no per-session artifact (for example a SQLite store).
• Sandbox-aware. Session files live under $DSH_HOME/sessions, outside the workspace. If the host's shell sandbox denies the removal, the plugin surfaces that denial instead of forcing it, and the file can be deleted by hand.
• Search index. A deleted session disappears from the session list immediately; a full-text search index may keep a stale row until the next DSH restart, which is the documented reconciliation point.

Architecture / 结构

One dual-face package:

Piece · File · Role

Host plugin · lib/index.js · apply(ctx) provides the delChat service

Host manifest · lib/typert.host.js · the ./typert Typert contribution that exposes delChat over the gateway

Browser plugin · lib/client.js · the settings.section page, mounted through exports["./client"]

Mount · cordis.patch.yml · one insert row: del-chat → dsh-delete-chat

The browser half reaches the host through remote.delChat.. The host half imports no @deepseek-ai/ runtime package — it reads the host process's own services with ctx.get(...) and binds itself to the gateway with a hand-written typertRemote binding, so no code-generation step is needed to build this plugin.

Exposed Remote methods:

delChat.list()                      → { sessions: [...] }
delChat.archive({ sessionId })      → { archivedSessionIds: [...] }
delChat.unarchive({ sessionId })    → { archivedSessionIds: [...] }
delChat.inspectDelete({ sessionId })→ { deletable, reason, path, dir }
delChat.deleteSession({ sessionId })→ { path }

Development / 开发

npm install
npm run build     # esbuild → lib/index.js, lib/typert.host.js, lib/client.js
npm test          # structural validation of both halves

npm run build writes the published artifacts:

• lib/index.js — the host plugin, bundled to ESM.
• lib/typert.host.js — copied verbatim from src/typert.host.js.
• lib/client.js — the browser bundle wrapped in the window.__ModuleLoader__.load({ id, factory }) envelope the DSH client module system executes, with react left external for the shell's static module table.

npm test imports the built host half against a mock Cordis context (exports, provided service, typertRemote binding, manifest shape) and executes the built browser bundle against a fake window.__ModuleLoader__ plus a react shim, asserting the registration id, the exports, the Remote descriptors, and the settings.section registration.

License

MIT