前言¶
DeepSeek Harness 支持归档会话,但这通常只是隐藏会话,无法真正清除日志。随着会话增多,磁盘占用会持续增长。dsh-session-delete 插件为 DSH 增加了“删除”这一动词。它允许通过侧边栏菜单或代理工具删除会话,并将会话日志移入本地垃圾箱,实现可恢复的删除操作。
插件介绍¶
该插件由 hakulat2023 维护,是一个 MIT 许可证的开源插件。它解决了 DeepSeek Harness 无法彻底移除会话的问题,提供了一套完整的会话生命周期管理能力,包括 UI 菜单、远程调用接口以及 Agent 工具。
安装与启用¶
在安装前,请确保你的运行环境满足以下要求:
* DeepSeek Harness 版本:0.2.x(已验证 0.2.0-rc.2)
* Node.js 版本:>= 20
执行以下命令进行安装:
dsh plugin --profile desktop add github:hakulat2023/dsh-session-delete#v0.1.0
安装完成后,必须重启应用程序才能使插件生效。
核心功能¶
- UI 入口:在会话列表行点击“…”菜单,出现“删除会话”选项。
- 代理工具:提供
session_delete和session_restore工具。 - 远程调用:提供
remote.sessionDelete命名空间。 - 可恢复删除:默认将日志移动到系统垃圾箱,而非直接删除文件。
- 强制删除:支持
purge选项,可跳过垃圾箱直接永久删除。
使用方法¶
通过 UI 操作¶
在会话行点击“…”,选择“删除会话”并确认。
通过代理工具¶
调用 session_delete 函数:
session_delete(session_id, stop_activity?, force?, purge?)
调用 session_restore 函数恢复会话:
session_restore(session_id)
通过远程命名空间¶
remote.sessionDelete.delete({ sessionId, stopActivity?, force?, purge? })
remote.sessionDelete.restore({ sessionId })
平台限制与注意事项¶
- 重启生效:插件修改了 host 侧的模块加载机制,安装后必须重启应用。
- macOS 限制:由于 macOS TCC 限制,插件无法列出
~/.Trash目录。恢复功能依赖元数据记录,而非遍历回收站。 - Windows 限制:插件无法读取 Windows 回收站内容,恢复操作需要手动进行。
- 无构建依赖:该插件没有 npm 依赖和构建步骤。
总结¶
dsh-session-delete 为 DeepSeek Harness 增加了会话清理能力。通过将日志移入垃圾箱,它平衡了数据安全与存储清理的需求。更多细节请参考 GitHub 或 SkillHub 目录。