DeepSeek Harness (DSH) 在本地存储会话日志、缓存、索引、溢出文件以及附件等大量数据。单纯在 UI 中移除会话条目通常只会删除引用,而不会清理磁盘上的这些数据副本。这个插件用于永久删除会话及其所有本地数据副本。
核心功能¶
该插件不仅清理会话本身,还处理以下数据清理逻辑:
- 全面清理数据:删除会话日志目录、投影缓存记录、工作区索引、溢出工具输出、附件、子代理会话以及 DeepSeek 上传缓存。
- 运行时保护:在会话生成期间阻止删除(返回
409 session-running)。 - 空闲会话确认:对于空闲会话,要求进行双重确认(返回
409 session-live),防止误操作。 - 附件去重保护:在删除附件前证明其未被其他会话引用,防止误删共享文件。
- 实时 UI 同步:广播
api-session/removed事件,使侧边栏条目立即消失,无需等待刷新。 - 灵活安装:支持从 npm 或本地链接安装。
安装与启用¶
安装前请确保环境满足要求:DSH 版本需大于等于 0.2.1-rc.2,Node.js 版本需大于等于 20。
执行以下命令安装插件:
install_bundle target: @fufu1437/dsh-delete-chat
使用方法¶
- 在侧边栏将鼠标悬停在会话行上,点击
…打开菜单。 - 选择 “Delete conversation…”。
- 确认删除(如果会话正在生成,会拒绝操作)。
- 如果会话已打开且空闲,系统会要求进行第二次确认。
- 确认后,删除在后台进行,侧边栏条目会立即消失。
注意事项¶
- 不可逆操作:删除操作不可逆,请谨慎确认。
- 附件清理规则:仅删除未被任何会话引用的附件。
- 安全防护:会话 ID 经过转义处理,防止路径遍历攻击。
- 权限要求:插件以当前 DSH 进程的权限运行,请确保安装前检查源码与许可证。