前言¶
DeepSeek Harness 的核心设计理念是「一切皆插件」。随着使用时间的增长,对话记录会不断堆积,尤其是那些未分组的默认工作区对话或无工作区的对话,官方界面无法直接删除,也无法通过常规操作清理。deepseek-harness-session-cleaner 插件为 DSH 增加了一个侧栏面板,允许用户勾选并删除任意对话记录——包括未分组的对话,填补了官方功能的缺口。
插件介绍¶
这是一个由维护者开发的 DSH 插件。它通过侧栏面板提供对话管理功能,支持搜索、筛选、批量删除和归档。该插件旨在解决用户无法清理未分组对话及管理对话记录的需求。
核心功能¶
- 面板入口:侧栏底部新增「删除对话」垃圾桶图标,点击打开面板。
- 列表展示:列出所有对话,包含标题、所属工作区或「未分组」标签、轮数、大小、最后活动时间,以及归档/置顶/运行中/已打开状态。
- 操作能力:支持搜索和筛选(全部/未分组/已归档/使用中),支持多选、全选,支持批量删除或逐条删除(点击标题可直接打开对话)。
- 安全机制:删除操作需两步确认;正在打开或运行的对话默认不允许删除(有提示),勾选「同时删除正在运行的对话」选项可强制删除。
- 归档替代:提供「归档」功能,将对话隐藏但保留数据,作为彻底删除前的缓冲方案。
- 界面适配:支持中英双语,界面自适应明暗主题。
安装与启用¶
安装插件前,必须确保 DeepSeek Harness 已完全退出。
"%LOCALAPPDATA%\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "file:<本仓库路径>"
安装完成后,重新启动 DeepSeek Harness。在侧栏底部(设置图标上方)会出现「删除对话」垃圾桶图标。
典型用法¶
- 清理未分组对话:打开面板后,使用「未分组」筛选条件,查看并勾选需要删除的对话。
- 批量清理:勾选多条或全选对话,执行批量删除。
- 强制清理:勾选「同时删除正在运行的对话」选项,清理当前占用的会话。
- 安全清理:对于不确定是否需要的对话,先使用「归档」功能隐藏,确认无误后再彻底删除。
适用场景与注意¶
- 数据安全:删除操作不可恢复,请谨慎确认。
- 运行时限制:正在打开或运行的对话,重启应用后新产生的消息不会保留。
- 文件保护:附件(图片/文件字节)按内容寻址共享存储,删除对话不会删除附件文件;插件仅删除对话记录本身,不会改动任何工作区目录里的文件。
- 运行环境:插件以当前 DSH 进程权限运行,安装前请检查源码与许可证。
结尾¶
该插件通过侧栏面板实现了对 DeepSeek Harness 对话记录的精细化管理,特别是针对未分组对话的清理提供了直接手段。更多细节与源码可访问 GitHub。