归档清理 iTimes6/dsh-archive-cleaner

dsh-archive-cleaner · 归档清理

DSH Web GUI 侧边栏插件：把归档会话列成一屏，勾选后批量删除。

装 / 卸

node scripts/install.mjs # 装进 ~/.dsh/profiles/desktop（会先备份 package.json）
node scripts/install.mjs --remove # 卸载

装完要重启 DSH（宿主半在启动时加载）。之后侧边栏顶部 + → 「归档清理」。

DSH_HOME / DSH_PROFILE_DIR 环境变量可覆盖默认路径。

用法

面板里每一行是一个归档会话：勾选框、标题、工作区、大小、归档时间。

- 「全选」/「反选」/「清空」
- 搜索框按标题或 id 过滤
- 「删除选中 (n)」→ 再点一次确认 → 调宿主 POST /archive-cleaner/api/delete

删除操作做的事（按 id）：

1. rm -r ~/.dsh/sessions/<bucket>/<id>/ —— 会话本体（session.v4.jsonl.zstd 在里面）
2. ~/.dsh/storages/session_projcache/sessions/<id>.json —— 标题/预览缓存
3. 从 ~/.dsh/storages/workspace.json 的 global.archivedSessionIds、各工作区 sessionIds、global.pinnedSessionIds 里摘掉

不可恢复，所以面板里有二次确认。未归档的会被拒；只有文件真被系统占用（EBUSY / EPERM）才报 locked——不再看宿主内存里「这个会话好像还开着」那种靠不住的判断。

个别归档会话死活塞不掉时，用命令行后门（做的是同一套事，绕开面板）：

node scripts/purge-one.mjs session-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

结构

| 文件 | 作用 |
| lib/index.js | 宿主半：注册 GET /archive-cleaner/api/list、POST /archive-cleaner/api/delete |
| client/client.js | 浏览器半：ctx.betterSidebar.registerTab() 注册侧边栏页签，手写 window.__ModuleLoader__ 包装 |
| cordis.patch.yml | 往插件树里 insert 一行 |
| package.json | dsh.bundle.patch + dsh.client.inject: ["betterSidebar"] + exports["./client"] |

依赖注入：宿主半 inject: ['webServer']；客户端半的 package.json 只声明 dsh.client.inject: ["@deepseek-ai/dsh-client-connection"]（模块加载顺序），真正的服务依赖写在 bundle 里——client/client.js 导出的 inject 为 ['betterSidebar']。

从源码装

git clone https://github.com/iTimes6/dsh-archive-cleaner.git
cd dsh-archive-cleaner
node scripts/install.mjs

scripts/install.mjs 会把本目录以 junction 链到 ~/.dsh/profiles/desktop/node_modules/dsh-archive-cleaner，往该 profile 的 package.json 里加依赖和 bundle 登记，并备份改动前的 package.json。--remove 撤干净。

要删掉插件本身：node scripts/install.mjs --remove，然后把目录删了即可。

要求

- DSH 0.2.1-rc.1+（要 ctx.betterSidebar 这个扩展点）
- 装了 dsh-better-sidebar（侧边栏本体；本插件只往它的页签里加一格）
- 无第三方运行时依赖

License

MIT

接口

GET /archive-cleaner/api/list
→ { ok, totalBytes, sessions: [{ id, title, size, archived, onDisk, workspace }] }

POST /archive-cleaner/api/delete { ids: string[] }
→ { ok, deleted: string[], skipped: [{ id, reason }], freedBytes }

reason ∈ not-archived / locked / invalid-id。请求带 Origin 时必须同源，否则 403。