前言¶
DeepSeek Harness 的桌面版默认操作中,存档只会将会话移入存档列表,会话本身依然存在。若要彻底删除会话,通常需要手动清理文件。这个插件为桌面版 DeepSeek Harness 增加了一个真正的“删除会话”功能,利用回收站机制(默认 15 天)来管理会话,提供可逆的删除操作和批量管理能力。
插件定位¶
名称:cckbc/dsh-session-recycle-bin
维护者:cckbc
类别:记忆
许可证:MIT
这是一个为 DeepSeek Harness 桌面应用(desktop profile)定制的插件。它通过修改应用内部状态,将标准的“删除”操作转换为“移动到回收站”,支持 7/15/30 天的保留期设置,并在设置页面提供可视化的恢复或永久删除入口。
核心功能¶
- 可逆删除:删除操作实际上是将会话日志和缓存移动到回收站目录。恢复时会逐个文件放回,包含标题和工作目录。
- 即时反馈:侧边栏中的会话行会在删除后立即移除,应用无需重启。若删除当前正在查看的会话,主视图会自动切换到一个新会话,而非显示空页面。
- 多入口操作:
* 行菜单:会话行的...菜单末尾新增“删除会话”。
* 悬停按钮:鼠标悬停在会话行上时出现的垃圾桶图标。
* 批量按钮:侧边栏顶部工作区列表上方的批量删除按钮。 - 批量处理:批量删除时会打开选择器,在“设置 → 回收站”表格中勾选会话后,可通过表头的按钮进行批量恢复或永久删除。
- 统一保留期:回收站的保留期(默认 15 天)是全局设置,适用于所有条目,可调整为 7、15 或 30 天。
安装与启用¶
该插件仅支持 DeepSeek Harness 桌面应用(desktop profile)。
通过命令行安装(Web 配置文件示例)¶
dsh plugin --profile web add github:cckbc/dsh-session-recycle-bin
通过插件页面安装(桌面应用)¶
- 在 DSH 侧边栏打开“插件”页面,点击“添加插件”。
- 输入 Git 地址
github:cckbc/dsh-session-recycle-bin。 - 点击“安装”并启用插件。
- 必须完全退出应用并重新打开,插件才会生效。
通过本地目录安装¶
git clone https://github.com/cckbc/dsh-session-recycle-bin.git
将克隆的目录添加到插件管理中,使用绝对路径。安装后需保持该目录不变,否则依赖会失效。
典型用法¶
- 单次删除:在侧边栏会话行的菜单或悬停按钮中选择“删除会话”,确认后该会话即进入回收站。
- 批量删除:点击侧边栏顶部的工作区列表旁的批量按钮,勾选多个会话后确认。
- 查看回收站:进入“设置” -> “回收站”,这里以表格形式列出所有已删除会话。
- 恢复或清空:在回收站表格中勾选会话,使用表头出现的“恢复”或“删除”按钮操作。勾选“不再询问”后,后续删除将不再弹出确认框。
适用场景与注意¶
- 适用场景:需要定期清理大量会话,但又希望保留一段“后悔药”以备恢复的场景。
- 版本与系统限制:当前仅验证在 Windows + 0.2.0-rc.2 上有效。macOS/Linux 和其他 Harness 版本未经测试。
- 非原生功能:这不是 DSH 官方内置功能,而是通过打补丁的方式“嫁接”到应用上。应用更新可能导致插件失效,表现为删除或恢复报错或无效。
- 数据安全:
- 没有操作系统的回收站,也没有“撤销”按钮。永久删除或过期后文件直接移除。
- 没有级联清理:会话的附件(
<DSH_HOME>/attachments)、AgentTeams 工作目录等衍生数据不受回收站保护,不会被自动清理。 - 恢复操作不会恢复会话的“固定”或“归档”状态。
- 重复 ID 处理:如果同一 ID 存在于多个工作区目录中,删除操作只会移动第一个匹配的实例。
- 内存缓存:应用内存中维护的会话列表仅在下次启动时重建。
结语¶
该插件为 DeepSeek Harness 桌面版提供了实用的会话生命周期管理能力,通过回收站机制在便捷删除和数据安全之间提供了平衡。如需查看源码或目录详情,请参考下方链接。