前言¶
DeepSeek Harness（DSH）在本地会保留会话 JSONL、投影缓存，以及子智能体产生的日志。归档只会把会话从默认侧栏列表里藏起来，磁盘上的目录和缓存通常仍在。长期开发或反复跑子智能体时，~/.dsh 下会积累大量已不再需要的归档会话，既占空间，也不便于区分「还能恢复」和「可以彻底清掉」的数据。
下面介绍社区插件 dsh-archived-session-cleaner（维护者 zhangfan0529，分类 admin-security）。它在 Web UI 里为已归档会话提供「永久删除」入口，并可选通过智能体工具按 Session ID 删除单条记录。删除不可恢复，且仅在本地执行，不发起网络请求。
这是什么¶
dsh-archived-session-cleaner 是 DeepSeek Harness 插件：从侧栏与本地存储中永久移除已归档会话及其子智能体日志，而不是仅做归档标记。
- 仓库：zhangfan0529/dsh-archived-session-cleaner
- 社区目录页：skillhub.cn 插件条目
- 版本（package.json）：1.0.0
- 许可证：MIT（
assets/下文件不在 MIT 范围内） - 运行环境：DeepSeek Harness 0.2.x 且带 Web UI（
engines.dsh:>=0.2.1-0 <0.3.0-0）
DSH 生态强调「一切皆插件」；SkillHub 等目录为独立社区站点，与 DeepSeek / 幻方无官方从属关系。安装前建议自行阅读仓库源码与许可证——插件以当前 DSH 进程权限操作本机 $DSH_HOME 下的文件。
核心功能¶
README 中已说明的能力如下：
- 在已归档会话行的
...菜单中增加 Delete session permanently（永久删除会话）。 - 删除时会移除会话日志、投影缓存、该会话下记录的子智能体日志；侧栏中对应行消失。
- 仅针对已归档会话，且带确认步骤；删除为永久性操作。
- 可选智能体工具
delete_archived_sessions：每次调用处理一个 Session ID。
安装与启用¶
在 DSH 中打开 Settings → Plugins → Add，填入官方 README 给出的安装标识：
github:zhangfan0529/dsh-archived-session-cleaner
添加后刷新页面。若使用本地检出目录，可将该目录的绝对路径粘贴到同一处，例如 /Users/you/plugins/dsh-archived-session-cleaner（路径仅作 README 示例，请换成你本机实际路径）。
典型用法¶
通过 Web UI 删除¶
- 若会话尚未归档，先归档：
...→ Archive session。 - 将侧栏筛选切换为 All conversations (show archived)，以便看到已归档项。
- 在目标会话行
...→ Delete session permanently，在确认对话框中确认。
通过智能体删除单条¶
若希望由智能体代为删除一条已归档会话，可从该归档行菜单 Copy Session ID 复制 ID，把 Session ID 发给智能体；智能体可调用工具 delete_archived_sessions（一次一个 Session ID）。
实际删除的内容¶
插件在本地删除（README 原文路径，$DSH_HOME 默认为 ~/.dsh）：
$DSH_HOME/sessions/<project>/<sessionId>/（JSONL 日志）$DSH_HOME/storages/session_projcache/sessions/<sessionId>.json- 该会话下记录的子智能体 session 日志
- 对应的 workspace 条目与 archive-set 条目
适用场景与注意¶
适合谁： 需要在本机 DSH 上清理已不再需要的归档会话、连同子智能体日志一并释放磁盘、并从侧栏彻底移除行的开发者或管理员。
务必注意：
- 仅已归档会话。 仍在运行、或当前应用运行中仍被加载的会话会被跳过——可先重启应用，再尝试删除。
- 删除不可恢复。
- 完全在本机运行： 无网络请求、无遥测。
- 插件以当前 DSH 进程权限读写
$DSH_HOME；安装与启用前请检查 GitHub 仓库 源码与 MIT 许可证说明。
结尾¶
dsh-archived-session-cleaner 补上了 DSH 归档流程里「彻底清掉本地会话与子智能体痕迹」这一步：UI 菜单、确认步骤与可选的 delete_archived_sessions 工具，边界在 README 里写得很清楚（仅归档、永久、本地）。
- 目录页：https://www.skillhub.cn/plugins/zhangfan0529/dsh-archived-session-cleaner
- GitHub：https://github.com/zhangfan0529/dsh-archived-session-cleaner
