前言¶
DeepSeek Harness（DSH）可以把会话归档，归档后会从主列表消失，但会话日志目录和投影缓存仍留在磁盘上，界面也没有公开的「删除会话」入口。若只在文件系统里手动删目录，容易漏掉工作区归属、投影缓存或内存里的会话引用，侧边栏仍可能出现点开会报错的「幽灵」行。
下面介绍社区插件 luckamuu/dsh-sessions-plugin（包名 @local/archived-sessions）：在侧边栏增加「已归档会话」页面，列出当前归档集合中的会话，并提供经两步确认后的彻底删除。维护者为 luckamuu，分类为客户端插件；当前 Release 为 v1.0.0，MIT 许可证，零运行时依赖。README 标明在 @deepseek-ai/dsh-desktop 0.2.0-rc.1 上验证，兼容基线徽章为 DSH 0.2.0-rc.2。
这是什么¶
这是一个 DeepSeek Harness 插件，由宿主半边（index.js）与浏览器半边（client.js）组成：宿主注册 archivedSessions 服务并负责在确认后从硬盘删除；客户端在侧边栏注册入口并渲染管理页。两半通过 DSH 的 Typert Remote 通信，前端只调用 archivedSessions/list 与 archivedSessions/deleteSession，不直接做文件操作。
核心功能¶
| 能力 | 说明 |
|---|---|
| 归档会话列表 | 按最近活动时间倒序，展示标题、时间、工作目录、占用空间与文件数 |
| 彻底删除 | 每行仅一个操作；先点「彻底删除」，再点「确认删除」，不可撤销 |
| 空间统计 | 递归统计会话目录大小，删除前可见将释放的空间 |
| 缺失文件标记 | 仍在归档集合中但目录已不在磁盘上的会话会标注「文件已不在」 |
| 宿主版本自检 | 面板发现宿主端点与界面不一致时说明原因并禁用删除，而非静默 404 |
| 中英双语 | 随 DSH 语言切换，文本走 ctx.locale |
删除只在会话确实处于归档集合（workspaceRegistry.archivedSessionIds）时执行；正在跑回合的会话（agent.status === 'running'）会被拒绝，需先停止。子代理会话不在归档集合中，不会出现在列表里。
安装与启用¶
前置条件¶
- 已安装 DSH 桌面版。
- 安装目标可以是本地目录的绝对路径（包管理器记为
link:），或 Git 仓库简写github:<owner>/<repo>（无需事先克隆仓库）。 - 安装或卸载后必须完全退出并重新打开 DSH（确认托盘或任务管理器中没有
DeepSeek Harness进程）。宿主import()插件与界面插件清单均在启动时生成，不会热生效。
步骤¶
- 打开 DSH，左侧边栏进入 插件 页面。
- 点 安装，在输入框填入其一，例如：
C:\Users\you\Desktop\dsh-sessions-plugin (Windows，本地目录绝对路径)
/home/you/tools/dsh-sessions-plugin (macOS / Linux)
github:luckamuu/dsh-sessions-plugin (Git 仓库地址)
- 确认安装。插件无依赖、无安装脚本，不会触发构建确认。
- 完全退出并重新打开 DSH。
- 重启后侧边栏在「插件／计划」附近会出现 已归档会话 入口。
若需固定某一 Release 版本，可在安装前自行取得对应 tag 的源码目录，再向插件页填写该目录的绝对路径；Release 无额外构建产物，源码包即为全部内容。手改 ~/.dsh/profiles/<profile>/package.json 也可行，但 README 建议优先使用插件页，且改完同样必须重启 DSH。
典型用法¶
面板顶部会显示实际读取的 DSH 主目录（DSH_HOME，否则 ~/.dsh），便于排查「曾归档却列表为空」等问题。
- 打开 已归档会话，必要时点 刷新。
- 在某行点 彻底删除。
- 在确认条上点 确认删除（或 取消 放弃）。
- 成功后顶部提示「已删除 \<会话 id>」，列表自动刷新。
删除会按既定顺序解除归档标记、工作区归属、内存会话、投影缓存，并递归删除 sessions 下对应目录及 session_projcache 相关文件，最后通过 api-session/removed 通知界面。附件等共享内容不会被删。
适用场景与注意¶
适合谁： 长期用 DSH 归档旧会话、磁盘被日志占满，又希望按正确顺序清理注册表与缓存、避免幽灵会话行的开发者。
权限与安全： 插件以当前 DSH 进程权限运行，删除使用 node:fs 与解析后的绝对路径，不走 shell。安装前应阅读 GitHub 仓库 源码与 MIT 许可证，确认符合你的环境策略。删除不可恢复，务必依赖界面两步确认。
生态说明： DSH 强调「一切皆插件」；SkillHub 目录页 为社区收录站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
luckamuu/dsh-sessions-plugin 补上了 DSH 归档后缺少的「从硬盘彻底移除」入口：列表、统计、版本自检与严格归档边界，把原先需要手动对齐的多步清理收成侧边栏里的可确认操作。
- 目录页：https://www.skillhub.cn/plugins/luckamuu/dsh-sessions-plugin
- GitHub：https://github.com/luckamuu/dsh-sessions-plugin
