dsh-session-delete: DeepSeek Harness True Session Deletion Plugin

DeepSeek Harness（DSH）目前只提供“归档”功能，归档后的会话依然保留在磁盘上，无法彻底清理。dsh-session-delete 插件在会话“…”菜单中补上“真删除”能力，二次确认后真正删除会话日志与工作区登记。

它是什么¶

这是一个客户端插件，由 EarthPretender 维护。它解决了 DSH 无法彻底移除会话数据的痛点，通过二次确认机制与官方注册表接口，实现会话的不可逆删除。

核心功能¶

菜单与确认
在会话“…”菜单的“归档会话”下方新增红色“删除会话”行。第一次点击变为“再次点击确认删除”，6秒内无操作自动还原。若会话有任务在跑，会显示“再次点击：停止任务并强行删除”。

删除逻辑
删除会话日志文件（路径 sessions/<工作区>/<会话id>/）并清理工作区注册表（执行 unpin → unarchive → detachSession）。删除成功后广播 api-session/removed 事件，列表行立即移除，无需重启。

安全与幂等
鉴权继承官方 /api 通道。支持幂等操作，重复点击不报错。当次启动使用过的会话先停用再删。正在执行任务的会话先停止任务再强制删除。

安装与启用¶

先编辑 profile 的 package.json（路径 ~/.dsh/profiles/desktop/package.json），在 dsh.profile.bundles 和 dependencies 中添加条目：

{
  "dsh": {
    "profile": {
      "bundles": [
        "dsh-session-delete"
      ]
    }
  },
  "dependencies": {
    "dsh-session-delete": "github:EarthPretender/dsh-session-delete"
  }
}

加入后进入 profile 目录，执行安装命令：

pnpm install

最后重启 DeepSeek Harness。

典型用法¶

重启 DeepSeek Harness（首次安装后生效）。
侧栏任意会话行 → “…” → 最底部红色 “删除会话”。
第一次点击 → “再次点击确认删除”，再点一次执行。
若会话有任务在跑 → “再次点击：停止任务并强行删除”，再点一次先停任务再删。

适用场景与注意¶

适合需要彻底清理会话数据的场景。插件以当前 DSH 进程权限运行，兼容 DSH 0.2.0-rc 系列，宿主端需 Node >= 22。删除不可逆，仅剩共享的附件/投影缓存等孤儿数据。

自检¶

插件包含零依赖自检命令：

npm test

参考资料¶

GitHub 仓库