dsh-session-cleaner：DeepSeek Harness 归档会话管理插件

DeepSeek Harness 长期运行后，归档会话会积累大量数据，可能占用存储空间或干扰当前的会话管理。手动管理这些数据不仅繁琐，还容易误删或造成状态不一致。dsh-session-cleaner 插件通过提供专门的“归档会话”页面，解决了这一问题。它不修改现有菜单，而是复用 DSH 的语义设计，专注于对已归档会话的集中管理。

该插件由 TheM14 维护，采用 MIT 许可证。核心价值在于对已归档会话的集中管理，支持恢复、安全删除、清理残留以及基于新预设的历史延续。

核心功能¶

会话列表：按工作区列出归档会话，包含标题、创建时间、日志状态和在线状态。
预设检查：显示每个会话的有效预设，并标记缺失或损坏的预设。
恢复会话：将会话恢复到原工作区，并立即更新官方侧边栏。
永久删除：通过回滚感知的隔离和提交流程，永久删除归档会话。
清理残留：清理幽灵归档条目、孤立工作区槽位、孤立投影缓存行和隔离日志。
历史延续：创建完整的历史延续，选择任意可用系统或用户预设继续对话。

安装与启用¶

在本地克隆仓库并构建后，将插件添加到 dsh Web 配置中。

cd path\to\dsh-session-cleaner
dsh plugin --profile web add .
dsh web

使用方法¶

打开 dsh 设置，选择“归档会话”。
选择“恢复”将对话返回原工作区。
选择“删除”并确认，永久移除日志和注册表数据。
选择目标预设并选择“使用预设继续”，创建带有完整继承历史的新会话。
选择“清理残留”以移除安全可识别的残留物。

数据安全与限制¶

删除操作具有严格的顺序，以确保数据安全：

验证 archived + not live
  -> rename log into quarantine
  -> commit workspace registry
  -> commit projection cache
  -> purge quarantined log

如果在提交注册表或投影缓存时失败，插件会停止并尝试回滚先前的更改。如果逻辑删除提交成功但文件清理失败，隔离日志将保留在 $DSH_HOME/storages/.dsh-session-cleaner-trash/ 目录中，可通过“清理残留”功能移除。

注意以下限制：
* 删除是永久的，活动会话永不删除。
* 如果主机仍拥有会话，请重启 dsh 并在删除前不再打开该会话。
* 每次请求都需要插件特定的哨兵头。
* 请求体限制为 64KB。

适用场景与注意¶

此插件适合需要彻底清理归档数据或需要基于旧会话历史开启新任务的用户。由于插件以当前进程权限运行，安装前应检查源码与许可证。