dsh-session-manager
Manifest validDeepSeek Harness Plugin: Permanently Delete Chat Sessions (Backup First by Default) · Delete DSH sessions, backup-first
dsh-session-manager
在 DeepSeek Harness 里真正删除会话。 搜索、多选、按会话 id 删除 —— 默认先备份,再永久删除会话日志、投影缓存与工作区引用。
Permanently delete chat sessions in DeepSeek Harness — search, multi-select, delete by session id, backup-first, with a sidebar row menu entry and a full dialog.
为什么需要它
DeepSeek Harness 目前没有删除会话的能力:
| 现有能力 | 实际行为 |
|---|---|
sessionPersistence | 只有 create / open / flush / stat / list,没有 delete |
workspaceRegistry.delete() | 只删「工作区登记」,并显式保留会话日志 |
| 归档(archive) | 只是可逆的隐藏,文件仍在 |
本插件用文件系统操作补上这一块,并且默认先备份再删除:删除前把会话目录、投影缓存、 两个存储单位的原始文件复制到备份目录;备份失败则中止删除(fail-closed)。
功能
- 两个入口
- 会话行右侧 「⋯」菜单 → 删除会话(打开对话框并预先勾选该会话)
- 侧边栏底部 「删除会话」 按钮(批量清理)
- 准确的列表信息:真实会话名称、等宽会话 id、绝对本地时间(
2026-10-24 18:52, 悬停显示精确到秒;不再用「3 小时前」这种易混淆的相对时间)、体积、所在目录。 - 父子关系一眼可辨:父会话显示「含 N 个子会话」蓝色徽章;子会话显示「↳ 子会话」徽章 并注明「父会话:<名称>」,且父会话后紧跟其子会话。
- 与侧边栏一致:默认只列出侧边栏中存在的会话;子会话与孤立记录收在 「不在侧边栏(N)」开关后面,需要清理时再展开。
- 搜索 / 多选 / 全选 / 清空,并支持直接粘贴会话 id(支持逗号、空格、换行分隔多个)。
- 安全守卫:当前会话、它的子会话、正在运行的会话(需显式勾选「强制删除运行中的会话」) 不可被选中;非法 id 只作为单条结果返回错误,不影响整批。
- 删除前备份(默认开启) 到
<DSH_HOME>/session-delete-backup/<时间戳>/,含manifest.json、会话目录副本、投影缓存文档副本,以及编辑前的workspace.json/session_projcache.json。 - 清理彻底:会话目录(v4 与旧版 v0 两份日志)、
storages/session_projcache/sessions/<id>.json(含.bak兄弟文件)、旧版session_projcache.json中的行、以及workspace.json里的sessionIds/archivedSessionIds/pinnedSessionIds。 - 删除后自动刷新会话列表:删除顺序是 删磁盘 → 摘工作区 → 清 archived/pinned →
广播
api-session/removed。文件先消失,再经官方Workspace.detachSession()更新工作区 (内存 +workspace.json+domain/changed),最后通知所有页面把该行从会话列表移除 —— 侧边栏不会把它塞进「未分组(未设定工作区)」,也不需要重启或手动刷新。 前端还会额外做一次延迟刷新覆盖宿主的异步收敛;弹窗会提示「已刷新侧边栏会话列表」。 手动「刷新列表」按钮同样会刷新侧边栏。 - 结果可回滚:结果面板显示每个 id 的成功/失败原因、备份目录,以及「界面列表可能需要刷新 或重启后才会完全消失」的提示。
安装
方式一:用 DSH 的插件管理器(推荐)
在本会话里让 Agent 安装(bundle 形态,装完对整个 profile 生效):
plugin_manager install_bundle target: <本仓库目录的绝对路径>
方式二:npm / 本地 link
# 在 DSH profile 目录(例如 ~/.dsh/profiles/desktop)
dsh plugin --profile desktop add dsh-session-manager
# 或本地开发
dsh plugin --profile desktop add link:/path/to/dsh-session-manager
方式三:手工
把本目录加入 profile 的 dependencies(link: 或版本号),并在 profile 的
cordis.patch.yml 中加入:
- insert:
- id: dsh-session-manager
name: dsh-session-manager
安装后刷新一次页面(前端模块在页面加载时注入),侧边栏即可看到入口。
使用
- 打开任意会话行右侧的 「⋯」→ 删除会话,或点侧边栏底部的 「删除会话」。
- 列表默认只显示侧边栏里的会话;需要清理子会话/孤立记录时勾选 「不在侧边栏(N)」。
- 搜索或直接粘贴会话 id(例如
session-d1f0bb04-d11c-471d-86fa-6d2c4f97709f)。 - 勾选要删的会话 → 删除(默认勾选「删除前备份」)。
- 结果面板会给出每个 id 的结果与备份路径。
从备份还原
备份目录结构:
<DSH_HOME>/session-delete-backup/<timestamp>/
├─ manifest.json # 本次删除的 id、结果、时间、home
├─ sessions/<session-id>/… # 原始会话日志目录
└─ storages/
├─ workspace.json.bak # 编辑前的整份文件
├─ session_projcache.json.bak # 若存在
└─ session_projcache/<id>.json # 投影缓存文档
把 sessions/<session-id> 拷回 <DSH_HOME>/sessions/<项目目录>/ 即可恢复会话本体;
必要时把 storages/*.bak 覆盖回 ~/.dsh/storages/ 下对应文件。
安全模型
- 所有写操作先备份,备份失败立即中止(不会出现「备份失败但已经删了」)。
- 会话 id 先经严格格式校验,再在
<DSH_HOME>/sessions内做路径包含检查,不匹配只允许 删除该目录自身,不做前缀匹配。 - 当前会话 / 其后代 / 运行中的会话默认拒绝(运行中需显式
allowActive)。 - 宿主端点自带信任栅栏:只接受回环或同源请求;写请求必须是
application/json; 请求体上限 64 KB;跨站标记、伪造 Origin、非回环 Host 一律 403。 Electron 桌面壳的dsh-app://app反代会剥掉 Origin 并注入宿主 cookie,这种情况下 以「回环 Host + 宿主 cookie」作为同源证据(浏览器无法伪造该组合)。 - 修改
workspace.json前会留.bak-<时间戳>;检测到global.pendingMutation(工作区变更 正在进行)时跳过改写并如实回报,避免与宿主的内存副本互相覆盖。
宿主通道
| 通道 | 状态 | 说明 |
|---|---|---|
同源 HTTP(/dsh-session-manager/*) | 主通道,已验证 | 由插件在宿主自带 web server 上注册;支持 Electron 桌面壳的 dsh-app:// 反代。 |
ctx.remote.dshSessionManager.{list,resolve,delete} | 可选 / 实验性 | 需要 @deepseek-ai/dsh-typert-protocol 能从插件解析到,且 typert 网关的 SRC 扫描能找到该 Service。不可用时静默跳过,不影响 HTTP 通道。 |
端点一览:
GET /dsh-session-manager/status 探活(版本 / home / pid / 端点列表)
GET /dsh-session-manager/token 只读返回页面口令(回环/同源)
GET /dsh-session-manager/list 全量会话清单
POST /dsh-session-manager/resolve { sessionIds } -> 指定 id 的元数据
POST /dsh-session-manager/delete { sessionIds, backup, allowActive } -> 删除
GET /dsh-session-manager/client.js 前端 bundle
GET /dsh-session-manager/boot.js 可直接 <script> 引入的启动版本
已知限制
- 界面滞后已大幅改善:删除时会走官方的
Workspace.detachSession()并主动刷新前端列表, 侧边栏通常立即少一行;只有session_projcache(统计/上下文面板用的派生缓存)仍由宿主内存 持有,个别面板可能需要刷新或重启后才更新,结果里的restartRecommended: true提示的正是这一点。 - 不级联删除:删父会话不会连带删除子会话,子会话会变成可单独删除的孤儿。
- 「未分组」里的子会话是正常的:侧边栏把不属于任何工作区的会话(例如各子代理会话)收进 「未分组」,它们本来就不在工作区里,并非删除残留。
- 备份不自动清理:
<DSH_HOME>/session-delete-backup/需要自行清理。 - 不可逆:除非从备份恢复。
排错
| 现象 | 原因 / 处理 |
|---|---|
| 对话框显示「无法连接宿主端」 | 宿主里没有加载插件(常见于刚重启、插件行未挂载)。确认 GET /dsh-session-manager/status 返回 200;若 404,重启 Harness 后再刷新页面。 |
| 首次打开提示 404 | 宿主刚启动、路由还在注册。插件会自动重试 4 次;仍失败时点「重试」。 |
| 提示「请求被拒绝(非本机同源)」 | 请求没带任何可信凭据(非回环 Host 且无 Origin/cookie)。桌面壳下应是 cookie 凭据;命令行调试请带 cookie 或页面口令头。 |
| 删除成功但侧边栏仍有该会话 | 上述「界面滞后」,刷新或重启即可。 |
开发
# 语法检查
npm run check
# 全部离线测试(假 home,不会碰真实会话)
npm test
# 单独运行
node verify/host-e2e.mjs # 宿主端 35 项
node verify/http-routes.mjs # 端点栅栏 47 项
node verify/titles.mjs # 标题解析 11 项
node research/client-check.cjs # 前端 150+ 项
测试全部使用临时 <DSH_HOME>,不会触碰真实 ~/.dsh/sessions。
目录结构
| 文件 | 作用 |
|---|---|
lib/index.js | 宿主半段:会话清单 / 标题 / 解析 / 备份删除 / HTTP 端点 / 可选 Remote |
lib/store.js | 删除后尽力同步运行中的工作区登记 |
client.js | 浏览器半段:行菜单 + 侧边栏按钮 + 对话框(经典脚本 bundle) |
cordis.patch.yml | bundle patch(插入插件行) |
icon.svg | 插件图标 |
verify/ | 离线测试与验证报告 |
research/ | 开发期调研(DSH 存储布局、桌面壳通道等),运行期不需要 |
English
dsh-session-manager permanently deletes sessions in DeepSeek Harness, where no delete API
exists (sessionPersistence has no delete; workspace deletion keeps session logs; archive is a
reversible hide).
- Entry points: the per-session “…” menu and a sidebar footer action.
- Lists real names, session ids, absolute local timestamps, sizes, parents/children (parents show “N children”, children show “↳ child of …” and are hidden unless you enable the “not in sidebar” toggle).
- Backup-first: session directory, projection-cache document and the storage unit files are
copied to
<DSH_HOME>/session-delete-backup/<timestamp>/with a manifest; a failed backup aborts the delete. - After a delete it detaches the session from its workspace through the official
Workspace.detachSession()write path and refreshes the client session list, so the sidebar drops the row without a restart. - Refuses the current session, its descendants and running sessions (unless forced), validates
ids and keeps every path inside
<DSH_HOME>/sessions. - Served over same-origin HTTP endpoints registered on the host web server, fenced to
loopback/same-origin,
application/jsonfor writes, 64 KB body cap, and Electrondsh-app://proxy support via the host cookie. - Optional, experimental
ctx.remote.dshSessionManagernamespace when the typert protocol is resolvable.
Install with the DSH plugin manager (plugin_manager install_bundle), then refresh the page.
License
Comments
Loading…
Similar plugins
by luckamuu
DeepSeek Harness 插件:提供删除已归档会话的入口(可以彻底删除不会在次出现)
★ 0
MIT
JavaScript
Oct 8, 2026
dsh plugin --profile web add @local/archived-sessionsby lxchapu
DSH(DeepSeek Harness)插件:把会话从磁盘上彻底删除。任意会话的「…」菜单里可删单条,侧边栏切到「仅显示已归档」时可一键删除全部已归档会话;两者都先弹二次确认,正在运行的会话会被拒绝删除。
★ 1
MIT
JavaScript
Oct 3, 2026
dsh plugin --profile web add @lxchapu/dsh-session-purgeby WovenJunct
一个简单的删除dsh会话的插件,简单可用。
★ 9
MIT
JavaScript
Oct 6, 2026
dsh plugin --profile web add dsh-plugin-simple-delete-sessionby Dubai1210
DSH Plugin(DeepSeek Harness 插件):在会话菜单「归档会话」下方增加「删除会话」,一次点按删除该会话及其全部数据。Adds a Delete item under Archive that removes a session and all of its data.
★ 0
MIT
JavaScript
Oct 22, 2026
dsh plugin --profile web add dsh-session-deleteby Linusteller
DeepSeek Harness 插件:侧栏会话菜单「删除会话」(永久删除,非归档)
★ 6
↓ 417/wk
MIT
JavaScript
Oct 22, 2026
dsh plugin --profile web add dsh-delete-sessionsby xohmai
DeepSeek Harness 会话删除插件:设置页管理归档会话,真正删除磁盘日志(回收站可还原)+ 批量清理——官方归档只隐藏不删盘,这里补上。
★ 46
↓ 727/wk
Apache-2.0
JavaScript
Oct 19, 2026
dsh plugin --profile web add dsh-session-delete