dsh-archived-list

A DeepSeek Harness (dsh) plugin: view and restore archived sessions from a dedicated page in the web Settings.

• A 已归档 / Archived nav row (own settings.section page) lists every

archived session grouped by workspace, newest first inside each group.

• Each row shows the title (log-backed title fold via the host service, with

client-list and directory-name fallbacks) and the full session id (selectable text); the group header shows the workspace name and its count.

• Multi-select: checkbox per row and per workspace group, plus a toolbar

(已选 N 项) with 恢复所选 / 删除所选 / 取消选择.

• 恢复 / Restore removes the session id from the durable archivedSessionIds

set through workspaceRegistry's own serialized write path. By default it does not auto-open the restored conversation and keeps Settings open; the page includes two toggles to enable auto-open and close Settings after restore (persisted in browser localStorage).

• 删除 / Destroy permanently deletes one archived session (or the whole

selection, behind the same double confirmation): the host reads the durable header to locate the log, detaches workspace accounting, removes the id from the archived set through the serialized write path, then removes the session log directory from disk. Live sessions are refused.

Layout

The host half is discovered by the Loader as an ordinary plugin entry; the browser half is discovered through package.json's dsh.client declaration and served at /plugins/dsh-archived-list/client.js. Client -> host calls ride the shared connection RPC carrier (connection.rpc.call("/api", "archvList/…")) resolved by the api gateway's SRC (source-mode) discovery - no generated typert schemas are required.

Install into a profile

Install from GitHub:

npx @deepseek-ai/dsh plugin --profile web add github:Yiklek/dsh-archived-list

For development, a link: install instead keeps this checkout live (dsh plugin forwards to pnpm inside the profile directory; edits to lib/*.js apply on the next dsh restart; client bundle edits need no build step because the bundle is hand-written in the module-loader format):

dsh plugin --profile web add link:../../projects/dsh-archived-list

This package is a standard dsh bundle plugin: package.json declares dsh.bundle.patch pointing at its cordis.patch.yml, so dsh plugin add automatically adds the package to dsh.profile.bundles and loads this plugin's own patch layer. No manual edit to ~/.dsh/profiles/web/cordis.patch.yml is needed.

Restart dsh (dsh web) to activate. To verify the composition without booting

the app: dsh --profile web --dump-config | grep -A2 archived-list.

Notes

• The remote service is namespace archvList; endpoints are archvList/list,

archvList/restore, and archvList/destroy. Parameter names are parsed from the method source (gateway SRC mode), so keep restore(sessionId)'s and destroy(sessionId)'s parameter a simple identifier and avoid the reserved lookup names (agent, session).

• destroy is ordered so a mid-flight failure never strands accounting:

refuse live sessions -> read the durable header (proves the log exists and locates it via sessionPersistence.locate; the directory basename must equal the session id) -> detachSession while the registry's path index still resolves the id -> serialized archived-set removal -> rm -r the log directory last. The UI additionally requires an explicit second click ("确认删除") before each destroy.

• Remote(...) markers are applied without decorator syntax in markRemote;

this follows the decorator-context contract of @deepseek-ai/dsh-typert-protocol.

• **Keep @deepseek-ai/dsh-typert-protocol (and @deepseek-ai/cordis) as symlinks

to the dsh installation's own copies.** The gateway discovers SRC-mode Remote endpoints through remoteMethods(), which reads a module-private marker table (markers WeakMap). A second physical copy installed by this checkout (e.g. by a local pnpm install pulling devDependencies) becomes a different module instance, so archvList/list is never claimed and every archived session shows "(无标题)". If the panel regresses, check the symlinks are still valid: node_modules/@deepseek-ai/{cordis,dsh-typert-protocol} should resolve to the dsh installation's node_modules/@deepseek-ai/...; re-run the ln -s from the Install section after any pnpm install here, then restart dsh web.

• Archiving never touches workspace accounting, so restore is exactly the

inverse set removal; the session keeps its position in the workspace.