dsh-session-unarchive
dsh 插件：在 Web GUI 中查看已归档的会话，并将其恢复到工作区（纯插件——无需修改文件，可在 dsh 升级后继续使用）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:dylan121322/dsh-session-unarchive#dbc61a49f5907038838dc3fdc9bff5e7e0bd0447Session Unarchive 以 dsh-session-unarchive 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
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.
host/archived-sessions-changed event.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-unarchiveworks as long as the bundle resolver reaches the profile'snode_modules; the localfile:form is the most reliable.
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.
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.
archivedSessionIds in ~/.dsh/storages/workspace.json no longer contains the id.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.