dsh-archived-sessions:DSH 归档会话管理插件

在 DeepSeek Harness (DSH) 中,归档会话通常只是文件系统中的日志文件。在 UI 中查看它们、恢复它们或彻底删除它们,通常需要直接操作文件系统或依赖 DSH 的内置行为,这并不总是直观或安全的。dsh-archived-sessions 插件通过在 DSH 设置页提供一个统一的入口来解决这个问题,实现了对归档会话的列表、预览、恢复和彻底删除。

是什么

这是一个 Memory 类别的 DSH 插件,由开发者 Zalpha263 维护,采用 MIT 许可证。它旨在解决 DSH 用户在管理大量已归档会话时遇到的操作不便问题,提供了一套完整的界面化操作流程。

核心功能

该插件提供了以下四种核心操作:

  1. 列表查看:列表加载迅速,直接显示会话标题、原工作区和最后活跃时间(绝对时间戳)。消息数在后台统计并缓存,反复打开列表不会重复解析日志,避免卡顿。
  2. 内容预览:点击“预览”按钮,可以查看会话开头的 6 条对话(用户/助手消息)以及调用了哪些工具。
  3. 恢复会话:点击“恢复到工作区”,归档记录会被移除,会话回到原来的工作区位置,侧边栏会立即刷新。
  4. 彻底删除:一次性清理日志文件、工作区归属和归档记录。删除前必须输入会话标题确认(防误删);系统会拦截有子会话的归档;删除后还会验证日志确实已经消失,避免会话“复活”。

安装与启用

安装前请确保已安装 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。

典型用法

  1. 入口:打开 DSH 设置,找到“归档会话”菜单。
  2. 查看:在列表中查看会话的基本信息,消息数已缓存,刷新速度极快。
  3. 预览:点击卡片上的“预览”,快速查看前 6 条对话和工具调用记录。
  4. 恢复:点击“恢复到工作区”,会话即刻回到原位置,侧边栏自动更新。
  5. 删除:
    • 点击删除按钮,输入确认值(标题、工作区目录名、会话 ID 或界面显示的标题均可)。
    • 如果该会话有子会话,系统会先询问选择:“仅删父会话”或“连同 N 个子会话一起删除”。
    • 系统会自动拦截正在运行的会话(删除后日志会被重新写入),并将其标记为“无法删除 · 仍在运行”,重启 DSH 后方可再次删除。

适用场景与注意

  • 依赖环境:插件依赖 DSH 0.1.5-rc.2 及以上版本。
  • 权限与安全:插件以当前 DSH 进程权限运行,安装前应检查源码与许可证。
  • 删除限制:如果在本次运行中被打开过的归档会话,直接删除会导致日志被重新写入,表现为“删了又回来”。界面会将其标为“无法删除 · 仍在运行”,重启 DSH 后即可正常删除。
  • 子会话处理:删除有子会话的父会话不会损坏子会话的日志。删除时会给出二次确认,允许选择仅删除父会话,或者连同子会话树一起删除(仍在运行的子会话会被跳过)。

该插件通过封装底层文件操作,为 DSH 用户提供了安全、高效的归档会话管理能力。更多细节可参考其 GitHub 仓库。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜