前言¶
用 DeepSeek Harness（DSH）做智能体开发时，会话会不断积累。归档能先把列表收拢，但磁盘上仍保留会话目录和归档登记；若只靠手动删文件夹，容易和 DSH 工作区、侧栏列表不同步。下面介绍社区插件 @very12345/dsh-archive-delete：在 Web GUI 侧栏对已归档会话提供删除控件，并同步清理会话目录与归档登记，可单独使用，不绑定特定网页模型后端或飞书桥接。
这是什么¶
维护者为 Very12345，分类为客户端插件。包名 @very12345/dsh-archive-delete，当前资料中的版本为 0.3.5，许可证 MIT。
插件定位：独立 DSH 插件，在侧栏为已归档会话行提供删除能力；普通未归档会话不显示删除控件。删除范围与 DSH 原生接口、GUI 一致，默认只处理已归档会话。
核心功能¶
侧栏与归档状态¶
从 0.2.5 起，侧栏删除控件直接订阅 DSH Workspace 的归档状态：新归档确认后自动出现控件，无需刷新或切窗；取消归档时自动隐藏并移出批量选择。
确认与批量操作¶
从 0.3.4 起，单条删除、批量删除和悬空记录清理均使用 DSH 官方页面内确认弹窗，由宿主管理焦点、Tab 和 Esc；取消不发送删除请求。批量删除失败的条目保留控件，可重试。
删除边界与登记¶
删除时会移除会话目录，通过 DSH 原生 Workspace Registry 清理工作区成员、归档与置顶登记，并发布原生会话列表移除事件。正在运行或结束中的任务会拒绝删除；已停止会话可立即从列表移除。若宿主仍持有会话对象或文件写锁，删除意图会记为待清理，在资源释放或宿主重启后完成文件与登记清理。
Windows 通过独占文件共享探测句柄占用；其他平台使用 flock。删除成功后会更新原生会话列表；待清理及已删除标记保存在 DSH home 的 archive-delete/deletions/，刷新页面不会恢复已移除行。界面会显示待文件清理数量。
设置页¶
设置页提供归档摘要与无效记录清理入口，样式与分区与 Windows 电脑操作页一致，支持窄屏；归档管理仍保留侧栏选择与删除确认。
宿主路由为 /plugins/dsh-archive-delete/list 和 /plugins/dsh-archive-delete/delete（exact route）。会话目录按 DSH_HOME、WEBAGENT_HOME/deepseek-harness、~/.dsh 顺序解析。
安装与启用¶
安装命令以仓库 README 为准：
dsh plugin --profile desktop add github:Very12345/dsh-archive-delete
# CLI WebUI 可选择 --profile web
也可在本仓库执行 npm pack，再用本地包安装：
dsh plugin --profile <name> add file:/absolute/path/package.tgz
资料说明：npm 公共仓库暂无可直接安装的 scoped 包，当前以 GitHub 源码安装为主。加载新版本后需重启对应 DSH 宿主/profile。
环境要求：DSH 的 Web GUI 接口、Node.js >= 20；当前工作区兼容目标为 DSH 0.2 系列。
典型用法¶
- 按上文命令为 desktop 或 web profile 安装插件并重启 DSH。
- 在 Web GUI 侧栏找到已归档的会话行，使用该行上的删除控件。
- 在页面内确认弹窗中确认删除；需要时可配合设置页做批量选择与无效记录清理。
普通会话侧栏不会出现删除控件，这是预期行为。
适用场景与注意¶
适合谁：长期在本地或自托管 DSH 上跑会话、归档后仍希望从磁盘和登记里彻底移除的开发者。
权限与安全：插件以当前 DSH 进程权限运行，安装前请自行查看 GitHub 源码 与 LICENSE、NOTICE。社区插件目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系。
依赖说明：package.json 中 peer 依赖包括 @deepseek-ai/cordis、@deepseek-ai/dsh-api-workspace-controller（均为 optional meta）；客户端注入 workspace controller 与 UI 相关模块，platform 为 web。
结尾¶
dsh-archive-delete 把「删已归档会话」收进 DSH 侧栏与原生登记流程，减少手删目录与列表不一致的问题。进一步了解可访问目录页 https://www.skillhub.cn/plugins/Very12345/dsh-archive-delete 与仓库 https://github.com/Very12345/dsh-archive-delete。
