在 DeepSeek Harness (DSH) 中,归档会话通常只是文件系统中的日志文件。在 UI 中查看它们、恢复它们或彻底删除它们,通常需要直接操作文件系统或依赖 DSH 的内置行为,这并不总是直观或安全的。dsh-archived-sessions 插件通过在 DSH 设置页提供一个统一的入口来解决这个问题,实现了对归档会话的列表、预览、恢复和彻底删除。
是什么¶
这是一个 Memory 类别的 DSH 插件,由开发者 Zalpha263 维护,采用 MIT 许可证。它旨在解决 DSH 用户在管理大量已归档会话时遇到的操作不便问题,提供了一套完整的界面化操作流程。
核心功能¶
该插件提供了以下四种核心操作:
- 列表查看:列表加载迅速,直接显示会话标题、原工作区和最后活跃时间(绝对时间戳)。消息数在后台统计并缓存,反复打开列表不会重复解析日志,避免卡顿。
- 内容预览:点击“预览”按钮,可以查看会话开头的 6 条对话(用户/助手消息)以及调用了哪些工具。
- 恢复会话:点击“恢复到工作区”,归档记录会被移除,会话回到原来的工作区位置,侧边栏会立即刷新。
- 彻底删除:一次性清理日志文件、工作区归属和归档记录。删除前必须输入会话标题确认(防误删);系统会拦截有子会话的归档;删除后还会验证日志确实已经消失,避免会话“复活”。
安装与启用¶
安装前请确保已安装 pnpm,并且 DSH 版本为 0.1.5-rc.2 或兼容的 0.1.x 系列。
使用发布态(钉死提交,最稳定)进行安装:
dsh plugin --profile web add github:Zalpha263/dsh-archived-sessions#<40位commit>
安装完成后重启 DSH。之后只有界面(Client)改动,刷新页面(Ctrl+F5)即可;Host 改动需要重启 DSH。
典型用法¶
- 入口:打开 DSH 设置,找到“归档会话”菜单。
- 查看:在列表中查看会话的基本信息,消息数已缓存,刷新速度极快。
- 预览:点击卡片上的“预览”,快速查看前 6 条对话和工具调用记录。
- 恢复:点击“恢复到工作区”,会话即刻回到原位置,侧边栏自动更新。
- 删除:
- 点击删除按钮,输入确认值(标题、工作区目录名、会话 ID 或界面显示的标题均可)。
- 如果该会话有子会话,系统会先询问选择:“仅删父会话”或“连同 N 个子会话一起删除”。
- 系统会自动拦截正在运行的会话(删除后日志会被重新写入),并将其标记为“无法删除 · 仍在运行”,重启 DSH 后方可再次删除。
适用场景与注意¶
- 依赖环境:插件依赖 DSH
0.1.5-rc.2及以上版本。 - 权限与安全:插件以当前 DSH 进程权限运行,安装前应检查源码与许可证。
- 删除限制:如果在本次运行中被打开过的归档会话,直接删除会导致日志被重新写入,表现为“删了又回来”。界面会将其标为“无法删除 · 仍在运行”,重启 DSH 后即可正常删除。
- 子会话处理:删除有子会话的父会话不会损坏子会话的日志。删除时会给出二次确认,允许选择仅删除父会话,或者连同子会话树一起删除(仍在运行的子会话会被跳过)。
该插件通过封装底层文件操作,为 DSH 用户提供了安全、高效的归档会话管理能力。更多细节可参考其 GitHub 仓库。