前言¶
DeepSeek Harness (DSH) 支持会话归档功能，用于长期管理项目会话。原有的归档页面仅提供「取消归档」操作，无法清理磁盘上的实际日志文件。随着使用时间增长，归档会话累积，磁盘占用会持续增加。本插件在设置 →「已归档会话」页面增加了删除能力，支持删除真实的会话记录。
核心功能¶
本插件为 DSH 客户端增加了会话清理能力，具体包括：
* 单条删除：在设置 →「已归档会话」页面为每条会话增加单独删除按钮。
* 全部删除：为列表顶部增加「全部删除」功能。
* 真实清理：删除操作会将会话记录从磁盘移除，而非仅从列表中移除。
* 残留处理：显示「会话记录已不在磁盘上」的条目，保留归档状态以便重试。
* 失败重试：删除失败时保持归档状态，不会从归档列表中消失。
安装与启用¶
安装插件后需要重启 dsh web 服务以挂载路由。
dsh plugin --profile web add <本仓库>/plugins/dsh-session-cleanup/0.2.1-rc.2/dsh-session-cleanup-0.1.3.tgz
dsh plugin --profile web install
典型用法¶
- 取消归档：点击每行右侧，将会话放回侧边栏，日志保留。
- 删除：点击每行右侧的删除按钮，删除该会话及其日志（需二次确认）。
- 全部删除：点击列表上方的全部删除按钮，删除所有已归档会话（需二次确认）。
安全边界¶
- 接口范围：删除接口监听
POST /plugins/dsh-session-cleanup/delete。 - 访问限制：仅限本机回环访问（
127.0.0.1/::1），其他来源返回 403。 - 路径约束：目标路径必须落在
<DSH_HOME>/sessions之内。 - 排除项：不删除
session_projcache/sessions/<id>。 - 不可逆：删除操作不可恢复，会话日志会被从磁盘上移除。
结语¶
该插件通过宿主侧能力补全了 DSH 的会话生命周期管理，适合需要定期清理归档日志的用户。
