DeepSeek Harness 插件

dsh-session-cleaner

Delete DeepSeek Harness sessions from the running web runtime: live store detach, workspace records, and on-disk artifacts.(英文原文)

跳到安装方式

来源信息

GitHub 仓库
fountunt/dsh-session-cleaner
最近更新
2026年8月15日
分类
记忆
GitHub stars
5
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/fountunt/dsh-session-cleaner
插件名:dsh-session-cleaner
作者:fountunt

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器4 个文件
README.zh.md来源说明 · 只读预览
README 语言

dsh-session-cleaner

运行中的 DeepSeek Harness Web 运行时删除会话——文件、内存 live store、工作区记录,无需重启 dsh web

官方 Web API 只有 workspace.archiveSession(隐藏),没有 session.delete。本 bundle 补上这个缺口。

安装

dsh plugin --profile web add dsh-session-cleaner            # 从 npm
dsh plugin --profile web add github:fountunt/dsh-session-cleaner   # 从 git

# 或使用本地 checkout
dsh plugin --profile web add file:/path/to/dsh-session-cleaner

然后重启 dsh web(运行中的实例不会热加载新 bundle)。

使用

Web UI(v1.0.0)

客户端部分在侧边栏会话行 ⋮ 菜单底部添加一个 🗑 "删除此会话" 菜单项——标题有歧义(重名)时会话的菜单项会被跳过以保证安全。

点击确认后,会话被删除并刷新侧边栏。会话运行时菜单项为灰色禁用状态;在 UI 打开过的会话(挂着空闲 agent)会先自动停止再删除。当前正在运行的对话永远无法被删除。

API

插件在 Web 服务器上注册一个路由:

POST /api-ext/session.delete
Content-Type: application/json

{ "sessionId": "session-1bb8d361-ea6b-4b92-bab2-c858c92e8822" }

同源调用可直接在 Harness 页面的浏览器控制台执行:

await fetch("/api-ext/session.delete", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({ sessionId: "session-1bb8d361-ea6b-4b92-bab2-c858c92e8822" }),
}).then(r => r.json());

响应格式(与宿主 RPC 风格一致):

{ "ok": true, "value": { "detached": true, "workspaces": 1, "files": 1 } }
{ "ok": false, "error": { "code": "refused", "message": "..." } }
  • detached — 会话已从内存 live store 移除(这就是它立刻从侧边栏消失、无需重启的原因)。
  • workspaces — 从多少个工作区记录中摘除了该会话。
  • files — 删除了多少个磁盘上的会话目录。

安全性

  • 有 agent 附着(运行中或空闲)的会话会被拒绝——当前对话永远无法通过此端点删除。
  • 删除不可逆:文件、工作区成员关系、live 条目都会被移除。session-projection 缓存可能保留一条无害的过期记录,直到下次重启。

工作原理

session.list 由 live SessionStore 加磁盘扫描共同提供。冷会话在列出时会被*准备进 live store*,因此文件删除后它们会以"幽灵"形式残留到服务器重启。本插件移除 live 条目(走 store 自身的 detach 通道)、从工作区记录摘除会话,并删除磁盘上的会话目录——让该行立即、永久消失。

开发

pnpm install        # peer: @deepseek-ai/cordis
node --test test/   # 单元测试

许可证

MIT