前言¶
DSH（DeepSeek Harness）是智能体开发与调试的重要工具。在 Web 界面中，原本的会话管理仅支持重命名、分叉和归档。归档操作只是将会话从列表中隐藏（修改 archivedSessionIds），并不会清理磁盘上的日志、工作区挂账等数据，无法彻底移除。
本插件补上了这一缺失的“删除”能力。安装后，它会在会话头部提供删除入口，通过二次确认机制，彻底移除工作区挂账、归档集合、内存记录及磁盘日志。
核心功能¶
本插件在 DSH Web 界面提供以下能力：
- 删除入口：在会话标题右侧的操作区新增“删除会话”按钮。
- 彻底清理：删除会话的同时，清理工作区挂账、归档集合条目、内存会话记录以及磁盘上的事件日志。
- 安全机制：
- 二次确认：删除前弹出模态框，防止误操作。
- 运行保护：拒绝删除正在运行的会话，防止写入冲突。
- 信任篱笆：API 使用 Loopback-only 信任模型，仅允许本地同源访问。
- 交互反馈：删除成功后自动切换视图，并通过 Toast 提示结果。
安装与启用¶
安装过程需要执行构建和插件注册两步：
- 克隆仓库并构建浏览器端 Bundle：
git clone https://github.com/huimingli666/dsh-session-delete.git
cd dsh-session-delete
node scripts/build-client.mjs
- 将插件注册到 Web Profile 的 Bundle 列表中：
dsh plugin --profile web add "$PWD"
重启 DSH 并刷新浏览器即可生效。
典型用法¶
激活后，打开任意会话，在标题右侧的操作区找到垃圾桶图标，点击并在弹出的确认模态框中确认即可永久删除该会话。
限制与注意事项¶
- 入口限制：删除按钮仅位于已打开会话的头部操作区，无法从列表行的菜单中调用。
- 归档清理依赖：归档集合的清理依赖原型补丁。若补丁不可用，插件仅发出警告而不阻断删除流程。
- 版本要求：需要 Node.js 版本
^22.0.0或>=24.0.0。插件在dsh 0.1.x上开发与测试。 - 删除管线：插件在宿主端依次执行校验、运行保护、工作区挂账移除、归档集合清理、磁盘日志删除及内存摘除。
总结¶
该插件解决了 DSH 原生会话管理中“删不掉”的问题，提供了彻底清理会话数据的方案。
