← 返回列表
✓ 可直接安装
为 DeepSeek Harness 提供会话删除能力,支持侧边栏 ⋮ 菜单入口
自动检查通过:npm 包已发布且 engines 声明满足基线;该结论来自程序自动检查,未经人工实机验证。 · 最近上游提交 2026/8/15 · 已提供中文文档
综合分
34.9
GitHub 分
34.9
用户评分
—
★ Stars
6
周下载量
—
兼容 / 相关生态插件(非 dsh 原生,请按其对应运行时安装)
git clone https://github.com/fountunt/dsh-session-cleaner.git数据截至 2026/9/17(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查✓ 自动检查通过
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。
✓npm 包dsh-session-cleaner @ 1.0.2
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/18 02:58:30
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
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扫码进群