前言¶
DeepSeek Harness (DSH) 的 Web GUI 支持归档会话，但侧栏菜单只能隐藏它们，没有取消归档的入口，也无法删除会话日志。这个插件由 JIUYUE-SEP 维护，补上了这一页：列出所有已归档会话，并提供还原、排队删除和彻底删除等缺失的操作。
核心功能¶
插件提供以下能力：
* 列表查看：列出所有已归档会话，显示标题、工作区、目录、归档时间与磁盘占用。
* 还原会话：将归档会话移除并回到侧栏原位。
* 彻底删除：二次确认后删除会话日志目录、投影缓存与工作区记账。
* 排队删除 / 取消排队：将无法立即删除的会话排队，下次启动时自动删除；可随时取消。
* 释放会话：需宿主提供 agents.release(id) 能力，用于卸载常驻会话。
* 清理失效记录：移除磁盘上已不存在的记录。
安装与启用¶
使用官方安装命令即可完成依赖挂载：
dsh plugin --profile web add github:JIUYUE-SEP/dsh-plugin-archive-shelf
安装后，必须重启 DeepSeek Harness（Ctrl+C 后重新执行 dsh web）并刷新页面。静态客户端插件随页面 boot graph 下发，单纯刷新不保证生效。
典型用法¶
- 打开 设置 页面，在 归档架（位于「Agent 预设」下方）查看已归档会话列表。
- 点击 「还原」 将会话恢复到侧栏原位。
- 点击 「彻底删除」 移除会话日志。
- 点击 「排队删除」 处理无法立即删除的会话（如正在运行或常驻的会话）。
- 点击 「清理」 移除磁盘上已不存在的记录。
重要说明¶
- 内部 API 依赖：取消归档依赖 DSH 的内部 API，若产品内部结构变更，插件会报错。
- 会话删除限制：常驻或运行中的会话无法直接删除。需使用“排队删除”（下次启动时生效）或宿主提供的“释放”能力。
- 释放能力要求：“释放”按钮需宿主提供
agents.release(id)能力。若宿主未提供此能力，按钮不会出现。 - 附件与不可恢复：删除操作不回收附件，且不可恢复。
- 运行中归档：产品允许归档正在运行的会话，归档架中的“运行中”徽标用于提示。
开发与维护¶
插件无构建步骤，直接发布纯 JavaScript 代码。开发测试可通过 npm test 运行两套件（客户端契约/渲染 + 宿主行为）。
- 许可证：MIT
- 维护者：JIUYUE-SEP
