dsh-recycle-bin

dsh-recycle-bin

Recycle Bin for DeepSeek Harness 为 DSH 增加独立回收站：归档对话可移入回收站、批量还原、彻底删除，并支持左侧栏批量归档。

A standalone DSH recycle bin plugin: move archived conversations into a recoverable trash, batch restore or permanently purge, plus sidebar batch archive.

为 DeepSeek Harness (DSH) 提供独立的回收站管理能力。插件通过 DSH 官方 UI 插槽与独立 HTTP 路由工作，不修改 DSH 核心代码，也不修改其它插件源码；卸载后原界面可恢复。

This plugin adds a recycle-bin workflow to DSH through official UI slots and its own namespaced HTTP routes. It does not modify DSH core or any existing plugin source; uninstalling restores the original UI.

---

功能 / Features

中文

• 回收站入口
  • 左侧栏左下角、设置图标上方新增“回收站”入口
• 归档管理
  • 归档列表支持单个/批量/按工作区操作
  • 可“还原”到原工作区/文件夹
  • 可“移入回收站”
• 回收站管理
  • 支持批量“还原”
  • 支持批量“彻底删除”
• 安全确认
  • 移入回收站与彻底删除均有二次确认
  • 运行中的对话会红色高亮，并在确认弹窗中明确提示
• 左侧栏批量归档
  • 对话左侧提供隐形勾选框，鼠标移动到左侧区域时亮起
  • 勾选后可批量归档
  • 已勾选时，三个点菜单会变为“批量归档”
• 跨平台
  • 使用 Node.js path / os / fs，兼容 Windows、Linux、macOS

English

• Recycle bin entry
  • Sidebar footer entry above Settings
• Archive management
  • Single, batch, and workspace-level operations in the archive list
  • Restore to the original workspace/folder
  • Move to trash
• Trash management
  • Batch restore
  • Batch permanent delete
• Safety
  • Confirmations before moving to trash and before permanent deletion
  • Running conversations are highlighted in red and clearly warned in the dialog
• Sidebar batch archive
  • Invisible checkboxes on the left of conversation rows; they appear on hover
  • Batch archive after selection
  • The row overflow menu becomes “batch archive” while selections exist
• Cross-platform
  • Uses Node.js path / os / fs; supports Windows, Linux, and macOS

---

版本兼容 / Compatibility

同时适配 DSH 0.1.5 与 0.1.7（rc 线）。

中文：

• 图标组件（0.1.7 起的硬断点）：@deepseek-ai/dsh-client-ui-primitives 的图标导出从像素尺寸后缀（IconTrashOutline16 / …14 / …20）改成了描边粗细后缀（IconTrashOutlineRegular / …Medium）。客户端半包现在把两代名字都探一遍（primitives[modern] ?? primitives[legacy]），因此同一份 bundle 在 0.1.5 与 0.1.7+ 上都能拿到组件。旧写法在新版会解构成 undefined，React 报 error #130，slot 条目崩溃 —— 表现是界面完全没反应（而不是弹错误），这一点很容易误判成“插件没装好”。
• 归档集与工作区成员清理：0.1.7 把归档/置顶账本收拢到 Workspace registry，插件改用公开 API workspaceRegistry.unarchiveSession() / unpinSession() 与 Workspace.detachSession()（幂等、随 registry 写链串行）；0.1.5 及更早的 enqueueOperation + setState / 工作区表直写路径保留为回退。
• 「彻底删除」的磁盘定位：0.1.5+ 的会话目录是 sessions/--<项目 slug>--/<会话 id>/，更早是 sessions/<slug>/<id>/，无 cwd 的会话在 _no-cwd/；插件会同时按原样 id 与 DSH 的 encodeSegment 规则比对，两种布局都能定位（日志文件名从 session.jsonl[.zstd] 变为 session.vN.jsonl[.zstd] 不影响删除整目录）。
• 客户端：0.1.7 移除了 ctx.workspaces.refresh()（工作区快照改由 follow 流驱动），插件在该方法缺失时退化为 no-op；ctx.sessions.refresh() 仍存在。
• 归档运行中的会话：0.1.7 起 Host 会以 workspace/session-active 拒绝归档（不会中断任务），批量归档会跳过这些会话并在控制台记录。

English:

• Archive/pin bookkeeping is driven through the public registry API on 0.1.7 (unarchiveSession, unpinSession, Workspace.detachSession), with the pre-0.1.7 domain-state path kept as a fallback.
• Permanent purge locates session directories for both sessions/--<slug>--/<id>/ (0.1.5+) and sessions/<slug>/<id>/ (older), matching ids literally and via DSH's encodeSegment rule.
• The browser half tolerates the removal of ctx.workspaces.refresh() in 0.1.7 by degrading the manual refresh to a no-op.

安装 / Install

⚠️ 当前插件仍在测试阶段。请先在隔离沙盒、模拟环境或 DSH 测试实例中完整验证，再部署到生产环境或公开发布。

⚠️ This plugin is still in testing. Please validate it in an isolated sandbox, simulation environment, or a DSH test instance before deploying to production or publishing.

从本地源码安装 / Install from local source

dsh plugin --profile web add /path/to/dsh-recycle-bin

安装后重启 DSH Web 生效。
Restart DSH Web after installation.

从 Git 仓库安装 / Install from Git

dsh plugin --profile web add github:qwertyuiop314/dsh-recycle-bin

卸载 / Uninstall

dsh plugin --profile web remove dsh-recycle-bin

卸载并重启后，回收站入口和批量归档增强会移除。
After uninstall and restart, the recycle-bin entry and sidebar batch-archive enhancement are removed.

---

使用 / Usage

中文

1. 重启 DSH 后打开 WebUI
2. 点击左侧栏左下角的“回收站”
3. 在“归档”页：
   • 鼠标悬停单条对话可单独“还原”或“移入回收站”
   • 点击“批量操作”可多选或按工作区勾选后批量操作
4. 在“回收站”页：
   • 可单条/批量“还原”
   • 可单条/批量“彻底删除”
5. 左侧栏批量归档：
   • 鼠标移动到对话左侧空白处，隐形勾选框亮起
   • 勾选多个对话后，点击浮动“批量归档”或三个点菜单中的“批量归档”

English

1. Restart DSH and open the WebUI
2. Click “Trash” at the bottom-left of the sidebar
3. In “Archived”:
   • Hover a row for single “Restore” or “Move to trash”
   • Use “Batch” to select multiple items or whole workspaces
4. In “Trash”:
   • Restore items individually or in batch
   • Delete items forever individually or in batch
5. Sidebar batch archive:
   • Hover the blank left area of a conversation to reveal its checkbox
   • Select multiple rows, then use the floating “Archive selected” button or the overflow menu

---

安全与隐私 / Security & Privacy

中文

• 插件仅在本机 DSH 内工作，不收集、不上传任何对话内容或个人信息
• 不包含遥测、统计、广告或第三方请求
• 回收站状态只保存在本机：
  • <DSH_HOME 或 ~/.dsh>/cache/dsh-recycle-bin/state.json
• “移入回收站 / 还原”只做逻辑状态管理，不修改本地对话文件
• “彻底删除”会先二次确认，再删除对应的本地会话文件，并清理 DSH 元数据
• Host 路由固定为 /dsh-recycle-bin/*，不占用其它插件命名空间
• 请勿将 DSH Web 暴露到不可信网络或公网；若必须暴露，请在反向代理层增加鉴权

English

• The plugin works locally inside DSH only; it does not collect or upload conversation content or personal data
• No telemetry, analytics, ads, or third-party requests
• Trash state is stored locally only:
  • <DSH_HOME or ~/.dsh>/cache/dsh-recycle-bin/state.json
• “Move to trash / restore” is logical state management and does not modify local conversation files
• “Delete forever” requires confirmation, then removes the local session files and cleans DSH metadata
• Host routes are namespaced under /dsh-recycle-bin/* and do not conflict with other plugins
• Do not expose DSH Web to untrusted networks or the public internet; if exposure is required, add authentication at a reverse proxy layer

---

原理 / How it works

cordis.patch.yml is the bundle patch layer: it inserts the dsh-recycle-bin row when the bundle is listed in the profile.

---

数据存储说明 / Data storage

• 回收站索引：<DSH_HOME 或 ~/.dsh>/cache/dsh-recycle-bin/state.json
• 该文件只包含回收站条目的 sessionId、trashedAt、deletedAt 等元数据，不包含对话正文
• 删除该文件只会丢失回收站视图，不会删除 DSH 会话文件
• 彻底删除操作会按用户确认删除本地会话文件，属于不可恢复操作

---

已知限制 / Known limitations

中文

• 左侧栏批量归档的隐形勾选框通过 DOM 增强实现，可能随 DSH UI 版本变化而需要适配
• 回收站面板打开时，左侧栏批量选择会暂时禁用，避免两个批量操作界面冲突
• 彻底删除后会在插件状态中保留 tombstone，避免已删除对话在刷新前重新出现

English

• The sidebar batch-archive checkboxes are a DOM enhancement and may need adjustment when DSH UI class names change
• While the recycle-bin panel is open, sidebar batch selection is disabled to avoid conflicting batch modes
• Permanent deletion keeps a local tombstone so deleted conversations do not reappear before a UI refresh

---

开发 / Development

dsh-recycle-bin/
├── package.json
├── cordis.patch.yml
├── README.md
├── README.en.md
├── lib/
│   ├── index.js       # Host: HTTP routes + state + purge/unarchive logic
│   └── client.js      # Browser: sidebar entry + recycle-bin panel + batch archive
└── test/
    └── plugin.test.mjs # Automated tests

运行测试 / Run tests:

npm test

---

License

MIT

---

关于本插件的“出生证明”

本插件同样是人类与 AI 的混合双打产物：需求是人类提的，方向是人类定的，代码的“手”（其实是 token）主要出自模型。

请把它当作一份参考实现来用——就像菜谱：照着做可以，但别指望不粘锅：

• 用之前自己先过目：代码翻一翻、测试跑一跑、按你的场景调一调；
• 代码按 “现状”（AS-IS） 提供，没有保修卡，也没有延保服务；
• 要是翻车了，那大概率是 AI 的锅——欢迎提 issue 或 PR 帮它“补课”；
• 欢迎 fork、修改、分发，也欢迎提 issue 或 PR 一起改进——独乐乐不如众乐乐。

说人话：回收站能正常清空是缘，误删能救回来是福；踩坑了一起填，改好了记得回来分享 😄