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-viewer

Then 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 build

build = 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 (declared private in the types, present at runtime) to perform the inverse of archiveSession. It mirrors archiveSession'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 sessionIds slot 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.