前言¶
在 DeepSeek Harness（DSH）的日常使用中，随着会话数量的增加，对已归档会话的管理和清理成为维护工作的一部分。现有的 Web UI 提供了基础的归档操作，但缺乏集中的浏览界面和自动化清理策略。dsh-plugin-archive-manager 插件为此提供了集中的归档管理界面，以及基于规则的自动归档能力。
插件定位¶
这是一个客户端插件，旨在为 DSH Web UI 补上会话归档管理功能，并附带 Codex 风格的对话刻度尺轨道。该插件前身为 dsh-plugin-atlas，在 0.3.0 版本起，由于官方 Web UI 已内置对话刻度尺与输入历史，插件不再重复内置这些功能，转而专注于归档管理本身。
核心功能¶
插件提供以下核心能力：
- 浏览与分组：已归档会话按工作区分组显示，支持通过关键词搜索。
- 批量取消归档：支持对多个会话执行取消归档操作，还原后侧边栏会实时恢复，无需重启。
- 自动归档：默认关闭，可配置“不活跃超过 N 天”或“每个工作区保留最近 M 条”的规则，系统每日核查一次。
- 试运行：在执行自动归档前，支持预览清单。
安装与启用¶
通过命令行安装：
dsh plugin --profile web add dsh-plugin-archive-manager
也可以在 Web UI 的 设置 → 插件 路径下，按包名进行安装。
卸载与升级：
- 卸载时将 add 替换为 remove。
- 若从旧版 dsh-plugin-atlas 升级，需先执行 remove dsh-plugin-atlas 再安装本包，归档规则会自动沿用。
典型用法¶
- 在 Web UI 的设置中找到该插件入口。
- 进入归档管理界面，浏览或搜索已归档会话。
- 在自动归档配置页，设定保留策略。
- 每日核查一次自动归档规则，执行前可使用预览清单确认操作对象。
适用场景与注意事项¶
该插件适用于需要长期维护 DSH 会话历史、希望自动化清理旧会话的开发者或运维人员。
注意事项：
- 插件的所有写操作要求同源 POST。
- 自动归档只调用 DSH 公开的 archiveSession 接口，取消归档经由注册表预留的状态写入路径完成。
- 规则数值有范围校验。
- 插件不删除任何会话或文件，仅改变其归档状态。若未来 DSH 的改动使其失效，插件会明确报错而不是损坏数据。
- DSH Desktop 内嵌同一 Web UI，插件安装后即刻在桌面端生效。
总结¶
dsh-plugin-archive-manager 通过集中的界面和自动化规则，解决了 DSH 会话归档管理的痛点。它不破坏数据安全，仅在注册表层面进行状态变更，适合作为 Harness 生态中会话生命周期管理的补充工具。
