dsh-archive-viewer
English | 中文
A DeepSeek Harness (DSH) plugin that adds an Archived sessions page to Web settings, listing every archived conversation grouped by its folder with a one-click Restore and a two-tap Delete. Restoring clears the session from the registry-global archive set so it reappears in the sidebar; deleting permanently removes the stored session log.
No DSH core is modified: the host half registers two REST ops on ctx.webServer (/api2/archive/unarchive + /api2/archive/delete) over the live workspaceRegistry and sessionPersistence services; the browser half composes the list from the standard useSessions + useWorkspaces seats and registers a settings.section (id archive).
Why this exists
DSH's official workspace surface only exposes archiveSession — there is no unarchive or delete RPC, and the Web UI hides archived sessions from every grouping with no way to find, restore, or remove them. This plugin fills that gap without touching DSH core.
Install
dsh plugin add --profile web github:DimitriLIAN/dsh-archive-viewerThen restart the web profile (dsh --profile web) so the bundle layer loads. Open Settings → Archived sessions to list, restore, or delete archived conversations.
How it works
| Layer | Mechanism |
|---|---|
| Host half | ctx.inject(['webServer', 'workspaceRegistry', 'sessionPersistence']) → ctx.webServer.register() for unarchive + delete |
| Restore | remove the id from archivedSessionIds via setState → domain.global.set → host/archived-sessions-changed broadcast |
| Delete | sessionPersistence.locate() → rmSync the session directory, then clear the id from archivedSessionIds |
| Browser half | settings.section slot (id archive), list from useWorkspaces(archivedSessionIds) + useSessions(byId) |
Build
pnpm install
pnpm run buildbuild = host tsc + client tsc (declarations) + tsdown (the __ModuleLoader__.load client bundle).
Known limitations
- Reaches a runtime-visible method — the official workspace RPC has no unarchive, so the host half calls
workspaceRegistry.setState(declaredprivatein the types, present at runtime) to perform the inverse ofarchiveSession. It mirrorsarchiveSession's own write path exactly. - Delete is permanent — deleting removes the session log from disk with no undo.
- Delete settles on restart — the archive list drops the row immediately, but the sidebar's session list and the workspace
sessionIdsslot finish clearing on the next DSH restart (the bootstrap detects the missing header). DSH storage is append-only and has no official session-delete RPC.