dsh-session-unarchive
Adds an archived-sessions view and a restore action to the dsh Web GUI — implemented as a pure Cordis plugin (host half + client half), with zero file patches. It survives dsh upgrades: nothing is written under the dsh install directory.
What it does
- Adds an Archived button at the bottom of the sidebar (beside Settings), showing the archived-session count.
- Clicking it opens a popover panel listing every archived session, with a title filter and a per-row Restore action.
- Restoring a session returns it to its original workspace position; the panel and the built-in sidebar update automatically via dsh's
host/archived-sessions-changed event.
- Works in both zh-CN and en locales.
Install
cd "$DSH_HOME/profiles/web" # e.g. ~/.dsh/profiles/web
# add the local plugin dependency
# "dsh-session-unarchive": "file:plugins/session-unarchive" → package.json dependencies
# register the entry in cordis.patch.yml:
# - id: session-unarchive
# name: dsh-session-unarchive
pnpm install
# restart dsh, then refresh the browser
For a dsh plugin add-style install of this exact repo, dsh plugin add github:dylan121322/dsh-session-unarchive works as long as the bundle resolver reaches the profile's node_modules; the local file: form is the most reliable.
Architecture
Two files under the plugin package:
| File | Role |
|---|
index.js | Host half — a Cordis plugin (apply(ctx) + inject: ["webServer","workspaceRegistry"]) that registers two HTTP routes on webServer: POST /api/session-unarchive/restore and GET /api/session-unarchive/list. |
client.js | Client half — a prebuilt browser bundle (window.__ModuleLoader__.load({ id, factory })) that registers a sidebar.footer.action slot occupant (replaceRisk: none) for the Archived button + panel. |
How unarchive works without patching dsh. Archiving in dsh is one-way: a session id is recorded in ~/.dsh/storages/workspace.json (global.archivedSessionIds) and hidden from every view. The host half calls the workspace registry's runtime methods (enqueueOperation / requireState / setState — the same internal API the built-in archiveSession uses) to remove the id from the archive set and persist it. After setState, dsh's own workspace stream detects the change and broadcasts host/archived-sessions-changed, so the client store and the built-in sidebar refresh with no extra wiring.
Data for the UI. The panel uses the sidebar.footer.action slot's standard props: useWorkspaces((s) => s.archivedSessionIds) for the archived set and useSessions((s) => s) for titles — both already kept live by dsh's client runtime.
Upgrade resilience. Because the plugin only touches runtime service methods (and those are detected at load time), a dsh upgrade that renames or removes enqueueOperation/requireState/setState fails the plugin's capability check and the endpoint returns a clear 500 — it never corrupts dsh or the registry. No file under the dsh install is ever written, so npm update @deepseek-ai/dsh cannot overwrite this plugin.
Compatibility
Tested on @deepseek-ai/dsh@0.1.0-rc.8 (web profile). It does not depend on the patched-package layout of the older rc.6-era file-patch build; the runtime-API approach is version-agnostic as long as the registry exposes the three internal methods above.
Verify
- Archive any session: the Archived · n button appears at the sidebar foot.
- Click it: the popover lists archived sessions (title filter + per-row Restore).
- Click Restore: the session disappears from the panel and reappears in its workspace group;
archivedSessionIds in ~/.dsh/storages/workspace.json no longer contains the id.
- With several archived sessions the list scrolls inside the panel.
Notes
- The repository previously shipped as a boot-time patcher (file patches over five dsh packages). That design is superseded by this pure-plugin form; the old
patches/, originals/, apply.sh, and cordis.patch.yml were removed.
client.js is a prebuilt CJS bundle (dsh's client module system). Rebuild it from source with your own tsdown/esbuild step if you change it; the shipped file is the canonical artifact.
