前言¶
在 DeepSeek Harness（DSH）里整理工作区时，侧边栏会话会越积越多。DSH 自带的归档仍会保留磁盘上的会话日志；若你只想「先移出列表、确认后再清空间」，单靠归档并不够，也缺少统一的「误删可撤」路径。社区插件 dsh-session-recycle（目录名 daimingxing/dsh-session-recycle，npm 包名 dsh-session-recycle）由维护者 daimingxing 发布，在 DSH 上提供会话回收站：侧边栏删除先进回收站，可预览、还原，或在确认后彻底删除日志。
这是什么¶
会话回收站是面向 DSH 0.2.x 的插件，分类上属于「记忆」相关能力扩展。它不改变 DSH 核心，而是通过插件机制接入侧边栏与会话设置：普通删除只更新回收站索引与工作区记录，日志仍留在原路径；只有「彻底删除」才会按校验规则物理清除日志并释放空间。运行时代码仅 index.js 与 client.js，无额外 npm 依赖。
核心功能¶
下面按 README 中已说明的能力归纳，均可在安装后从 UI 或回收站设置中使用。
删除可反悔¶
从会话「⋯」菜单执行删除时，会话及其 subagent 子会话会一并进入回收站。误操作后可在约 3 秒内通过提示一键撤销。运行中的会话会被拒绝删除；已打开但空闲的会话可直接处理。
查看与还原¶
在 设置 → 会话回收站 中可预览最近内容，并将条目还原回工作区；标题与原有归档状态会一并恢复。还原后的会话会出现在工作区列表顶部。
安心清理与幽灵扫描¶
彻底删除前会校验日志目录；遇到未知文件会拒绝操作，以降低误删风险。彻底删除不可撤销。 回收站还提供幽灵会话扫描，用于集中处理空白会话、失去父会话的子会话以及登记残留，便于在确认后再清理不需要的记录。
与归档、卸载的关系¶
插件索引维护回收站状态。若卸载插件或索引丢失，仍留在磁盘原位的会话可能再次出现在列表中。全局附件存储与 SQLite 全文索引不在本插件清理范围内。保护范围限定为当前 DSH 进程；不宜在另一个 DSH 实例中同时对相同会话做清理操作。
安装与启用¶
适用于 DSH 0.2.1-rc.1 及以上、低于 0.3.0 的 0.2.x（package.json 中 engines.dsh 为 >=0.2.1-rc.1 <0.3.0-0）。安装命令须使用官方文档形式，按你实际使用的 profile 替换 desktop、web 或 headless。
从 npm 安装（包发布后 DSH 会安装并注册插件）：
dsh plugin --profile desktop add dsh-session-recycle@latest
从本地 tgz 安装（示例路径需替换为实际文件）：
dsh plugin --profile desktop add "D:/Downloads/dsh-session-recycle-0.2.0.tgz"
卸载：
dsh plugin --profile desktop remove dsh-session-recycle
开发时可用 link 方式挂载本地目录（将路径改为本机绝对路径）：
dsh plugin --profile desktop add link:/绝对路径/dsh-session-recycle
插件以当前 DSH 进程权限运行；安装前可在 GitHub 查看源码与 MIT License。
典型用法¶
README 建议按三步上手，下面与文档一致。
- 整理侧边栏 — 打开目标会话的「⋯」菜单，点击删除项；若误删，在提示中撤销。
- 管理回收站 — 进入「设置 → 会话回收站」，查看内容、还原会话，或在确认后彻底删除。
- 清理隐藏残留 — 在回收站运行幽灵会话扫描，根据结果清理不再需要的记录。
记住文档中的原则：先收纳，再清除。 只有彻底删除才会从磁盘移除会话日志。
适用场景与注意¶
适合长期在 DSH 桌面版、Web（dsh web）或无界面（dsh headless）中维护大量会话、需要「移出列表但保留反悔窗口」的开发者。不适合把回收站当作跨实例或跨机器的同步删除方案：索引与进程内保护都绑定当前 DSH 运行环境。
使用前请确认 DSH 版本落在 0.2.1-rc.1 与 0.3.0 之间；社区目录 SkillHub 插件页 与 GitHub 仓库为独立信息来源，与 DeepSeek / 幻方无官方从属关系，安装与审阅源码仍建议以仓库 README 为准。
结尾¶
dsh-session-recycle 用回收站补齐 DSH 侧栏删除链路：软删除可撤销、硬删除有校验，并附带子会话整理与幽灵残留扫描。需要进一步了解安装细节与行为说明时，可查阅 GitHub：daimingxing/dsh-session-recycle 与 SkillHub 目录页。
