dsh-archive-workbench
归档工作台 — DeepSeek Harness 的会话删除 + 归档管理插件。
中文 | English
DeepSeek Harness 官方只能归档会话（隐藏，不删盘），也没有一个方便的地方查看已归档的会话。这个插件补上这两块：
- 永久删除会话 —— 侧边栏会话行的「...」菜单里多一项「删除会话」，真正删掉磁盘上的日志，而不是只隐藏。
- 归档会话面板 —— 侧边栏底部多一个归档图标，点开是一整页已归档会话列表，每行可恢复归档或删除。
功能
1. 会话菜单：删除会话
在任一会话行的「...」菜单最下方（复制 Session ID 之后，带分隔线）：
置顶 → 重命名 → 分叉 → 归档 → 复制 Session ID → 删除会话
点击后弹出确认框，确认即永久删除：
- 删除该会话自己的日志目录（
~/.dsh/sessions/<项目>/<会话ID>/）
- 清理它的投影缓存（
~/.dsh/storages/session_projcache/sessions/<会话ID>.json）
- 把该 id 从归档/置顶集合里移除（避免重启后出现"幽灵行"）
- 通知前端立即移除该行（无需刷新页面）
已归档的会话同样支持 —— 菜单项不区分状态。
2. 归档会话面板
侧边栏底部图标栏（与「插件」「定时」并排）多一个归档图标，点开后在主区域显示整页列表：
已归档会话 2
归档的会话会显示在这里，可随时恢复或删除。
┌─────────────────────────────────────────────────────────┐
│ 会话标题 [恢复归档] [删除] │
│ session-cf676d08-1890-427e-aa64-34a910d31600 │
└─────────────────────────────────────────────────────────┘
- 每行显示标题 + 原始会话 ID（取不到标题时显示「未命名」）
- 恢复归档：调官方
unarchiveSession，该行立即消失，会话回到原工作区位置
- 删除：复用同一个确认框，永久删除
- 顺序：最近归档的在最上
- 空状态：「暂无已归档会话」
顺便说明：官方其实也有查看归档会话的入口（侧边栏顶部「视图选项」→ 全部对话（显示已归档）），但入口较深，且那里没有恢复/删除按钮 —— 恢复还得回到会话行的「...」菜单。本面板把这两件事集中到一个地方。
安装
方式一：插件市场（推荐）
在 DeepSeek Harness 里打开 设置 → 插件，搜索 dsh-archive-workbench。
方式二：命令行
dsh plugin add dsh-archive-workbench
方式三：从 GitHub 直接安装
dsh plugin add https://github.com/CHYMZXS/dsh-archive-workbench
方式四：本地开发目录
dsh plugin add /path/to/dsh-archive-workbench
安装后重启一次 DeepSeek Harness（插件含 Host 端代码，首次安装需要重启生效）。
已知限制
正在运行的会话（重要）
DeepSeek Harness 没有任何公开 API 能让一个会话从内存中退出。因此对于本次运行中打开过、还驻留在内存里的会话，删除文件不够 —— 它可能立刻把日志重新写回来。
插件的处理方式是：
- 先调用官方
archiveSession({ stopActivity: true })，停掉它正在跑的工作并封住后续写入
- 等它空闲（最多 8 秒）
- 再删文件
- 删完反复复查（最多 6 次）确认文件没有重新出现
如果文件仍然被重建，插件会明确报错（而不是假装成功）：
the session is still resident in this application and keeps recreating its log; restart the application and delete it again
建议：如果要删的是"当前正在用/刚用过"的会话，先重启一次应用再删 —— 重启后它变成冷会话，删除是干净的。
附件不会被删除
~/.dsh/attachments/ 里的图片/附件不会被删除。它们按内容哈希全局共享，多个会话可能引用同一个对象 —— 按会话去删会破坏其他会话。
子智能体会话
子智能体（subagent）产生的会话不会出现在侧边栏，因此无法从 UI 删除。这是官方行为。
工作原理
插件完全建立在官方扩展点上，不修改官方任何一行代码：
| 部分 | 用到的官方扩展点 |
|---|
| 删除菜单项 | sidebar.workspaces.session.menu.item 槽位（官方为插件预留，order 500） |
| 确认弹窗 | shell.overlay 槽位 + 官方 Modal / Button 组件 |
| 归档面板图标 | sidebar.panellist 槽位（order 20） |
| 归档面板页面 | main 键值槽位（key = dsh-archive-workbench-archived） |
| 删除动作 | Host 端 ctx.webServer.register() 注册私有路由；客户端 fetch 调用 |
| 前端移除行 | 发官方 api-session/removed 事件（在官方转发白名单内） |
| 恢复归档 | 官方 uiWorkspace.unarchiveSession() |
| 清理投影缓存 | 官方 storageDomain 的 table.delete() |
删除逻辑在 Host 端（index.js），UI 在客户端（client.js），通过一条私有 HTTP 路由通信。
开发
git clone https://github.com/CHYMZXS/dsh-archive-workbench
cd dsh-archive-workbench
dsh plugin add .
改完 client.js 会自动热重载；改 index.js（Host 端）需要重启应用。
License
MIT
