前言¶
DeepSeek Harness（DSH）侧栏的「会话」里，对已归档会话通常只有一个「显示/隐藏已归档」开关。会话一旦归档，往往既不好按日期或工作区翻找，也不方便批量恢复。若归档列表越积越长，单靠手动开关很难维持可读性。
下面介绍社区插件 DSH Archive Manager（@gsnowdrift/dsh-archive-manager）。它在 设置 → 归档会话 提供列表、筛选、批量取消归档，以及一套可预览、可撤销的自动清理策略，专门补这一块管理能力。
这是什么¶
DSH Archive Manager 由维护者 gsnowdrift 发布，在插件目录中归类为「记忆」。当前 npm 包版本为 0.2.3，采用 MIT 许可证，面向 DSH 0.2.x 的 Web 与桌面 profile（Host 侧未在纯 CLI profile 上验证）。
插件不发网络请求、不采集遥测；读写范围限于本机 profile 中的归档元数据、归档集合、插件自有 storage，以及用户主动确认后的会话日志目录。
核心功能¶
归档列表与筛选¶
设置页可查看已归档会话，字段包括标题、工作区、路径、归档时间、最近活动、来源（手动/自动）、运行状态。支持：
- 按归档日下拉筛选（展示每天数量）
- 搜索标题、路径或会话 ID
- 按工作区筛选
- 可选包含子代理会话
- 分页：每页 25 条，显示页码与总数
批量与单条操作¶
- 勾选多条后 取消归档，会话回到原工作区原来的位置
- 单条 取消归档
- 单条 删除：删除磁盘上的会话记录，需二次确认且不可恢复（仅在你主动点击时发生）
自动清理（可逆）¶
三种策略可组合，保存在插件 storage domain（archive_manager），跨重启保留。支持 预览计划 与 立即执行。
| 策略 | 作用 | 默认 |
|---|---|---|
cleanupEnabled |
定时清理总开关（每 cleanupIntervalMinutes 分钟一次，默认 30） |
关 |
autoArchiveDays |
闲置超过 N 天的普通会话自动归档（从侧栏隐藏） | 90 天，0 为关闭 |
retentionDays |
归档超过 N 天的会话自动取消归档（回到侧栏） | 180 天，0 为关闭 |
capCount |
归档数量超过 N 时，自动取消归档最旧的 | 0 为关闭 |
includeSubagents |
子代理会话是否参与清理 | 关 |
自动清理不会物理删除会话日志：只在归档集合与侧栏可见性之间移动会话，历史与工作区归属可恢复。运行中的会话一律跳过，不会打断正在执行的任务。
安装与启用¶
Web 版 profile 安装：
dsh plugin --profile web add @gsnowdrift/dsh-archive-manager
桌面版将 web 换成 desktop：
dsh plugin --profile desktop add @gsnowdrift/dsh-archive-manager
安装完成后重启 DSH 或重新打开客户端，在 设置 → 归档会话 进入管理界面。
插件以当前 DSH 进程权限运行。安装前建议在 GitHub 仓库 查看源码与许可证，确认符合你的环境策略。
典型用法¶
- 打开侧栏 设置（齿轮），左栏选择 归档会话。
- 顶部下拉选择归档日，或用搜索、工作区筛选；标题从会话日志折叠而来，冷启动时可能先显示会话 ID，数秒后自动替换为标题。
- 勾选若干行，点击 取消归档 N 项，会话回到原位置。
- 在下方「自动清理」卡片调整策略 → 保存设置 → 预览计划 确认影响 → 再 立即执行。
若你通过其他方式扩展 DSH，Host 侧暴露 remote.archiveManager（list、getSettings、setPolicy、unarchive、deleteSessions、preview、runCleanup 等），可与设置页同一套逻辑对接；一般用户只需使用设置界面即可。
适用场景与注意¶
适合谁： 长期用 DSH、会话归档较多，需要按日期或工作区找回历史、批量恢复，或希望用可逆策略自动归档闲置会话、控制归档数量的开发者。
已知限制（摘自官方说明）：
- 归档时间以插件观察到会话进入归档集合的时刻为准；插件首次启动前已归档的会话，用会话 header 创建时间兜底。
- 极少数无标题事件的会话显示为「（无标题）」加 ID。
- 若会话日志已被外部工具删除，列表可能出现无法删除的孤儿条目；插件会周期性从归档集合中清理这类条目，不删除磁盘上其它文件。
- 删除操作非原子；插件通过墓碑等方式避免列表继续展示已删会话。
- 入口注册在
settings.section；宿主变更 slot 时分区可能不出现。
DSH 生态强调「一切皆插件」；SkillHub 目录页 与 dsh-plugin.org 为社区收录，与 DeepSeek / 幻方无官方从属关系。
结尾¶
DSH Archive Manager 把「归档之后看不见、找不回」补成可浏览、可筛选、可批量恢复，并用可预览的自动清理减轻列表膨胀，且默认不替你删日志。需要时可从目录页或 GitHub 安装：
- 目录页：https://www.skillhub.cn/plugins/gsnowdrift/dsh-archive-manager
- GitHub：https://github.com/gsnowdrift/dsh-archive-manager
