🗑️ dsh-session-trash

给 DeepSeek Harness 补上「可恢复的会话删除」

删错了？7 天内随时找回来。

快速开始 · 功能 · 使用 · 配置 · 工作原理 · 常见问题 · 开发

为什么需要它

DSH 官方只有归档（archive）——归档是把会话藏起来，可以反悔；但删除这个动作官方没有提供。

你可能遇到过这些情况：

• 会话列表越堆越长，想清理掉不用的
• 手滑点错，把还要用的会话处理掉了
• 想彻底删掉某些内容，却只能归档，数据还占着磁盘

这个插件把「删除」做成安全版本：不是抹掉，而是移进回收站。7 天内随时恢复，到期自动清理。

❌ 没有它

会话太多 → 只能归档
误操作   → 无法挽回
想清理   → 数据一直占着

✅ 有它之后

会话太多 → 删除，进回收站
误操作   → 6 秒内点撤销
想清理   → 彻底删除，释放空间

✨ 功能

🚀 快速开始

> ✅ 已发布到 npm：@lazyra/dsh-session-trash，
> 并已完成安装验证 —— 从 npm 装好后 DSH 正常启动，删除、撤销、回收站均可正常使用。

方式一：插件管理器（推荐）

1. 侧栏点击 插件
2. 点击 添加插件
3. 输入 @lazyra/dsh-session-trash
4. 安装 → 启用 → 重启 DSH

方式二：命令行

dsh plugin --profile desktop add @lazyra/dsh-session-trash

方式三：从源码安装

git clone https://github.com/LazyRa/dsh-session-trash.git
dsh plugin --profile desktop add /path/to/dsh-session-trash

> [!TIP]
> 安装后需要重启 DSH 才会生效。如果侧栏没出现「回收站」，检查插件是否已启用。

升级到新版本

pnpm 默认带 minimumReleaseAge —— 发布不满 24 小时的包会被静默跳过。
所以插件发新版后，pnpm update 可能悄悄停在旧版本，看起来像没生效。

在 profile 的 pnpm-workspace.yaml 里放行一次即可：

minimumReleaseAgeExclude:
- '@lazyra/dsh-session-trash@0.1.1 || 0.1.2'

然后：

pnpm update @lazyra/dsh-session-trash --latest

确认版本：

node -e "console.log(require('./node_modules/@lazyra/dsh-session-trash/package.json').version)"

> 之后每次发新版，把新的版本号补进 || 后面即可。

📖 使用

删除会话

侧栏会话行 → 悬停显示 ⋯ → 删除会话

删完立刻可撤销：

管理回收站

侧栏 回收站 进入管理页面：

彻底删除有二次确认，使用 DSH 原生对话框样式：

快捷键

⚙️ 配置

在 profile 的 cordis.patch.yml 中给插件加 config：

- id: dsh-session-trash
name: "@lazyra/dsh-session-trash"
config:
retentionDays: 7          # 会话保留天数，默认 7
sweepIntervalMs: 21600000 # 自动清理间隔（毫秒），默认 6 小时
home: null                # DSH home 路径，默认读 $DSH_HOME 或 ~/.dsh

🔬 工作原理

数据怎么存

/
├── sessions/
│   └── //
│       └── session.v4.jsonl.zstd        ← 会话原始位置
│
└── trash/
└── 2026-10-19T09-19-52-123-session-xxxx/
├── meta.json                     ← 原位置、标题、删除时间
├── session.v4.jsonl.zstd         ← 会话本体
└── projcache.json                ← 投影缓存（含标题）

删除 = 把整个目录 rename 到 trash/。恢复 = 反向搬回。没有任何数据被删改。

三处状态必须同步

只移动目录是不够的 —— 不同步注册表就会留下「幽灵会话」：

为什么被删的会话必须「留在归档集合里」

这是本插件最容易踩空的一处，也是「删完的会话又出现在未分组」的原因。

DSH 的会话语料是「落盘 ∪ 活会话」：

// session-query/src/corpus.ts
const persisted = await listPersisted(persistence, signal)   // 磁盘上的会话
for (const session of this._ctx.sessions.list()) {            // 内存里活着的会话
records.set(session.id, { ... })
}

把目录移进回收站只清掉了「落盘」那一半。只要会话还活在 ctx.sessions 里
（挂着 agent 的会话会一直活到它的生命周期结束），下一次拉取列表它就会回来；
而插件已经把它移出了工作区，于是客户端把它归到「未分组」：

// ui-workspace/src/client/tree.ts
const stray = list.ids.filter((s) => !accounted.has(s.id) && sessionVisible(...))
//                                              ↑ 不属于任何工作区 → 未分组

客户端判定可见性的官方口径是归档集合：

// ui-workspace/src/client/tree.ts
case 'default': return !archived.has(session.id)

所以插件在删除时做的是 archive + detach：归档（隐藏）＋ 摘掉工作区成员关系，
并保持归档状态不变；直到恢复时才 unarchiveSession 撤销归档。

> 早先的实现是在删除时把会话从归档集合里摘掉的，那正好等于「让它重新可见」——
> 于是被删的会话在下一轮列表同步后回到「未分组」。

界面为什么能即时刷新

不靠轮询，走 DSH 自己的事件链路：

sequenceDiagram
participant UI as 侧栏/面板
participant Host as Host 插件
participant FS as 文件系统
participant Reg as workspaceRegistry

UI->>Host: POST /move
Host->>Reg: archiveSession（隐藏会话 + 活动准入）
Host->>FS: rename 到 trash/
Host->>Reg: detachSession（摘出工作区）
Host-->>UI: api-session/removed
Note over UI: 该行立即消失

UI->>Host: POST /restore
Host->>FS: rename 回原位
Host->>Reg: attachSession + unarchiveSession
Host-->>UI: api-session/added (含标题投影)
Note over UI: 该行立即出现，标题正确

运行中的会话怎么拦

用 DSH 官方的 workspace/session-activity waterfall 做准入检查，家族有
turn（Agent 正在跑）、job（后台任务）、subagent（子会话）。
有活动且用户没确认「停止并删除」时，删除会被拒绝并弹确认框；
确认后走官方 workspace/session-stop 停止工作。

为什么不能用 sessions.refresh()

恢复后如果调客户端 refresh() 整体重拉列表，会和 api-session/removed 写入的本地移除标记冲突，导致已永久删除的会话被重新捞出来、掉进「未分组」。所以恢复必须发带完整 summary 的 api-session/added。

> 顺带一提：客户端的移除标记只活在当前那一轮拉取里。下一轮拉取会新建一个空的
> 突变数组，旧的移除记录就丢了 —— 所以真正的修复必须落在服务端（归档），
> 不能只靠一条通知。

附件不参与回收站

attachments/v1/objects/ 是 SHA-256 内容寻址存储 —— 多个会话可能引用同一个对象。删除会破坏其他会话的历史，所以附件始终保留。

🔌 HTTP 接口

挂在 /api/dsh-session-trash/ 下，全部为精确路由（DSH 的 /api 只认精确路径，前缀路由会被 404）。

❓ 常见问题

删掉的会话还能找回来吗？

能。7 天内都可以从回收站恢复，也可以点删除后顶部提示条的「撤销」立即恢复。

7 天后真的会删掉吗？

会。插件在 DSH 启动时扫一次，之后每 6 小时扫一次，把过期条目彻底删除。想保留更久可以调大 retentionDays。

删除会话会影响其他会话吗？

不会。每个会话的目录独立，附件是共享的但不会被删除。

会话正在运行时点删除会怎样？

会先检测到它在运行，弹出确认框询问是否停止后再删除。不会悄悄打断你的工作。

升级 DSH 后插件会失效吗？

插件会探测会话日志的实际格式版本（session.v.jsonl.zstd），不写死版本号。但如果 DSH 引入全新的存储结构，可能需要更新插件。

数据存在哪里？可以手动备份吗？

回收站在 /trash/ 下，每个条目是一个独立目录，直接复制走就行。

装了新版却没生效？

多半是 pnpm 的 minimumReleaseAge 把新版本跳过了（发布不满 24 小时会被静默拒绝）。
在 profile 的 pnpm-workspace.yaml 里加一行放行：

minimumReleaseAgeExclude:
- '@lazyra/dsh-session-trash@0.1.1 || 0.1.2'

然后 pnpm update @lazyra/dsh-session-trash --latest 并重启 DSH。详见升级到新版本。

删掉的会话又出现在「未分组」里？

那是 0.1.2 之前的旧版本的行为：插件只把会话目录移进回收站，没让 DSH 彻底不再列出它，
下一次拉列表时它就回来了（又不属于任何工作区，于是归到「未分组」）。

0.1.2 起删除时会把会话留在归档集合里（DSH 判定会话不可见的官方机制），恢复时才撤销。
升级到 0.1.2 即可。

🧑‍💻 开发

git clone https://github.com/LazyRa/dsh-session-trash.git
cd dsh-session-trash
npm test

纯 ESM，零构建 —— lib/*.js 就是直接运行的源码，改完重启 DSH 即生效。

lib/
├── index.js           Host 半侧：HTTP 路由、生命周期、定时清理
├── trash-service.js   核心逻辑：编码、移动、恢复、清理
└── client.js          浏览器半侧：菜单项、横幅、回收站页面

测试

node test/service.test.mjs
node test/host-e2e.test.mjs

设计取舍

• 不引入构建：插件接口就是 { name, inject, apply }，手写 ESM 足够，省掉一整条工具链
• 不碰附件：内容寻址存储没有引用计数，删除会连带破坏其他会话
• 复用官方组件：菜单行、对话框、图标都用 ui-primitives，和内置 UI 保持同一套视觉语言
• 降级可用：拿不到 primitives 时有自绘回退，功能不丢

⚠️ 已知限制

• 路径编码有损：DSH 的 projectKey 会把 D:\a-b\c 和 D:\a\b\c 编码成同一个 key，这是 DSH 的既有行为，插件通过记录原始 key 规避恢复错位
• 会话格式版本：会探测实际版本号，但全新存储结构仍需适配
• 仅桌面端验证：Web 端理论可用，但未充分测试

🤝 贡献

欢迎 Issue 和 PR！

• 发现 Bug → 提 Issue，附上 DSH 版本和复现步骤
• 想加功能 → 先开 Issue 讨论，避免白做
• 提交代码 → 确保 npm test 全绿

📄 许可

MIT © dsh-session-trash contributors

如果这个插件帮到了你，给个 ⭐ 就是最好的支持