前言¶
在 DeepSeek Harness（DSH）里，会话可以归档，但平台本身没有「删除会话」的入口——归档后的记录会一直留在磁盘上。长期开发、反复开新会话时，旧归档和记账不一致、侧栏出现「未分组」、子智能体目录无人清理等问题会逐渐堆积。社区插件 dsh-archive-session-manager（维护者 felixpu，分类：客户端）针对的是已归档会话及若干低频维护场景：单条删除、管理页批量操作，以及只改记账或按需扫描磁盘的清理工具。
下面按定位、功能、安装与典型用法说明；事实以 GitHub 仓库 README 为准。
这是什么¶
dsh-archive-session-manager 是 DSH 客户端插件：在会话「···」菜单里为已归档会话增加「删除会话」（带确认，永久删除磁盘记录）；在 设置 → 归档会话 提供归档会话管理页（标题、时间、目录、磁盘占用），支持多选、全选、批量删除、批量取消归档与刷新。维护入口集中在设置页，而不是侧栏——作者将其定位为低频批量维护，而非会话内日常动作。
DSH 生态主张「一切皆插件」；插件目录站 skillhub.cn 为社区收录，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
删除与归档管理¶
- 删除单个归档会话：先归档，再在「···」中选「删除会话」并确认。未归档会话没有删除入口；接口层也会以
not-archived拒绝。正在执行任务的会话拒绝删除；仅被打开过、处于空闲的会话允许删除。 - 归档会话管理页：批量删除、批量取消归档；删除不可恢复，确认与结果提示中会说明：父会话派生的子智能体会话会一并删除（平台会话级删除不会自动级联，子智能体又不作为列表行显示，插件有意做级联清理）。
记账与磁盘维护（管理页）¶
| 入口 | 作用 | 是否动磁盘 | 何时运行 |
|---|---|---|---|
| 归位失效会话 | 把磁盘有、记账无的会话挂回工作目录对应工作区（消侧栏「未分组」） | 否 | 打开页面自动预览 |
| 摘除误记账的子智能体 | 从工作区归属记账摘掉子智能体 | 否 | 打开页面自动预览 |
| 清理幽灵记账 | 删掉记账里仍记着、磁盘已不存在的条目 | 否 | 打开页面自动预览 |
| 清理遗留空会话 | 删除「从未有过对话」的空会话目录 | 是 | 点「开始扫描」后才扫描 |
「清理遗留空会话」是唯一按内容判据批量删文件的功能：需读取全部会话日志，服务端重算判据，有对话内容一律拒删；两步确认，且不会在打开页面时自动跑全库扫描。
删除在平台上的实现方式（使用时的预期）¶
README 说明：DSH 没有会话级删除 API，插件删除大致为四步——先驱逐内存态（避免收尾落盘把目录建回来），再删磁盘目录、从归档集合移除、从工作区记账摘除。若驱逐被平台拒绝，管理页会出现「待重启」条目，可点「重试驱逐」或重启 DSH 收敛。
界面文案支持中英文，跟随 设置 → 通用 → 语言，切换后立即生效。
安装与启用¶
安装命令（README 原文）：
dsh plugin --profile web add github:felixpu/dsh-archive-session-manager
安装或升级后需要重启 DSH：宿主与客户端 bundle 在进程启动时装载，不重启不生效。
当前 package.json 中版本为 0.1.0，许可证 MIT。插件以当前 dsh 进程权限运行；安装前建议自行查看仓库源码与许可证。
典型用法¶
删除一个归档会话¶
- 用平台自带「归档」归档该会话；
- 打开该会话「···」菜单，选择「删除会话」；
- 在确认对话框中确认（不可恢复；子智能体会连带删除）。
需要备份时，可自行复制 ~/.dsh/sessions/ 下对应目录。
使用归档会话管理页¶
进入 设置 → 归档会话，勾选行后批量删除或批量取消归档，右侧可刷新。按需使用「归位失效会话」「摘除误记账的子智能体」「清理幽灵记账」——前两者与幽灵清理会先给只读预览再执行。
清理空会话：在该项右侧点 「开始扫描」，预览后再确认删除。
适用场景与注意¶
适合谁：长期用 DSH、归档很多但想真正删掉磁盘记录的人；侧栏出现「未分组」、记账与磁盘不一致、或想清理从未对话的空会话目录时，可用管理页维护项处理。
安全边界（插件设计）：
- 只有已归档会话可删；会话目录路径限制在
$DSH_HOME/sessions/下并做前缀校验。 - 空会话清理不信任前端传来的 id，服务端逐条校验。
常见问题（README）：删了列表还在——先刷新；有「待重启」则重试驱逐或重启。侧栏「未分组」可用「归位失效会话」处理，不一定都是删除造成的。
开发者细节见仓库 docs/DEVELOPMENT.md，升级验证见 docs/VERIFICATION.md。
结尾¶
dsh-archive-session-manager 补的是 DSH 默认缺失的「已归档会话删除」与集中维护面板，并区分「只改记账」与「动磁盘」的操作，对归档堆积和记账漂移场景更实用。
- 目录页：https://www.skillhub.cn/plugins/felixpu/dsh-archive-session-manager
- GitHub：https://github.com/felixpu/dsh-archive-session-manager
