对话回收站 wusoudiaowei/dsh-conversation-trash

dsh-conversation-trash

给 DeepSeek Harness 会话用的回收站。 从侧边栏删除会话，8 秒内可撤销，之后还能恢复或彻底清除。

DeepSeek Harness 自带归档，但没有删除：它的持久层没有暴露删除原语，Workspace 注册表也刻意保留每一份会话日志。这个插件把删除实现为若干受支持操作的组合——它从不给宿主二进制打补丁，也从不改动日志格式。

功能

- 从会话行的 … 菜单移入回收站（危险样式，位于 Archive 下方）
- 8 秒内可撤销——弹出带撤销操作的 toast，而不是静默、不可逆的删除
- 子代理级联——被删会话名下的子代理会话一并移走
- 分叉保留——分叉是独立会话，不受影响
- 先停掉正在运行的工作，走宿主自己的归档路径
- 侧边栏底部按钮打开回收站面板，带数量角标：恢复条目、永久删除单条，或清空回收站
- 之后可恢复或清除；回收站位于 ~/.dsh/session-trash/

安装

dsh plugin --profile desktop add github:wusoudiaowei/dsh-conversation-trash

或者把这个文件夹复制到 %USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-conversation-trash，再把它加进该配置档的 dsh.profile.bundles，然后重启 DSH。install.ps1 在 Windows 上完成这两步，且可重复执行。

用法

1. 在侧边栏悬停到某个会话行，打开 … 菜单
2. 选择 删除对话 / Delete conversation
3. 对话框会预览标题，以及有多少个子代理会话会一起移走
4. 确认——该行从列表消失，toast 提供 Undo，持续 8 秒

工作原理

| 步骤 | 发生什么 |
| 1 | workspaceRegistry.archiveSession(id, { stopActivity: true })——停掉正在运行的工作并隐藏该行 |
| 2 | 会话目录从 ~/.dsh/sessions/<workspace>/<session-id>/ 移到 ~/.dsh/session-trash/<session-id>/ |
| 3 | 向 ~/.dsh/session-trash/index.json 写入一条记录（临时文件 + 重命名，原子操作） |

恢复会把目录移回，并取消会话的归档状态。清除则永久删除。

两个 Windows 特有的细节：移动执行时日志文件往往还开着，所以移动会带退避重试，失败的尝试记为 moved: false，由启动时的清扫补完；另外会话 id 本身已带 session- 前缀，所以宿主在边界处规范化 id，而不是重新推导。

HTTP 接口

仅限回环地址、同源、application/json 的 POST：

| 方法 | 路径 | 用途 |
| GET | /dsh-conversation-trash/list | 回收站条目与总大小 |
| POST | /dsh-conversation-trash/preview | {sessionId} → 标题、子代理 id |
| POST | /dsh-conversation-trash/delete | {sessionId, displayTitle} |
| POST | /dsh-conversation-trash/restore | {sessionId} |
| POST | /dsh-conversation-trash/purge | {sessionId} |
| POST | /dsh-conversation-trash/purge-all | {} |

测试

node test/smoke.mjs # delete → list → restore → purge against a throwaway HOME
node test/client-shape.mjs # the browser bundle registers the right slots
node test/dry-run.mjs # read-only pass over the real ~/.dsh (skips cleanly if none)

CI 在 Windows 上跑前两个。

已知限制

- 删掉的会话在下次重启前仍会出现在 All conversations (show archived) 下——它已被归档，日志也已经移走。
- 删除你当前正在查看的会话，页面不会跳转。
- 彻底删除还没有设置界面，请走 HTTP 路由。
- 依赖宿主内部实现（slot 名称、archiveSession、日志目录结构）。未来的 DSH 版本可能让它失效；出错时看得见，但不会破坏数据。
- 如果上游哪天真的提供了 session/delete，这个插件就该退休了。

设计说明

docs/design.md 讲清了各项约束、被否掉的备选方案，以及塑造了实现方式的四个 bug。

许可证

MIT

中文摘要

对话回收站：侧栏 … 菜单把会话移入回收站，8 秒内可撤销，之后可恢复或彻底删除；子代理会话随父会话一起删，分叉保留。详见 使用说明.md。