🗑️ dsh-session-trash

为什么需要它

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 才会生效。如果侧栏没出现「回收站」，检查插件是否已启用。

📖 使用

删除会话

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

删完立刻可撤销：

管理回收站

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

彻底删除有二次确认，使用 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

🔬 工作原理

数据怎么存

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

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

三处状态必须同步

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

界面为什么能即时刷新

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

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

    UI->>Host: POST /move
    Host->>FS: rename 到 trash/
    Host->>FS: 更新 workspace.json
    Host-->>UI: api-session/removed
    Note over UI: 该行立即消失

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

为什么不能用 sessions.refresh()

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

附件不参与回收站

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

🔌 HTTP 接口

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

❓ 常见问题

🧑‍💻 开发

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