前言¶
DeepSeek Harness（DSH）桌面端会长期积累 JSONL 会话日志。会话一多，列表变长，查找和清理都靠手工翻目录，既慢也容易误删还在用的记录。社区插件 dsh-session-archive 把「归档、恢复、搜索、按项目分组、永久删除」收进 Settings → Archive Management（归档管理），并可选按保留期自动归档不活跃会话。下面介绍它是什么、能做什么，以及如何安装与使用。
这是什么¶
dsh-session-archive 是面向 DeepSeek Harness 的社区插件（非 DeepSeek 官方发布或背书），维护者为 ailawu0409，在 SkillHub 目录中归类为「记忆」。它在 Harness 的 Settings 扩展里增加会话归档管理能力：支持手动与自动归档、恢复、搜索与筛选排序、按项目分组，以及对永久删除做会话 ID 与日志身份校验。
插件无遥测与第三方分析；设置与删除审计记录在本地 DSH profile 中维护。永久删除会移除会话日志目录且插件不提供回收站或撤销，重要会话应先导出或备份。
核心功能¶
依据仓库 README，当前版本（package.json 为 0.1.0）能力包括：
- 手动归档与恢复：在归档管理界面分别查看已归档与未归档会话；可将符合条件的未归档会话归档，或将已归档会话恢复为可用。运行中、已固定或正在使用的会话可能被 DSH 拒绝操作。
- 自动归档（默认关闭）：在设置中开启并选择保留期后，对「不活跃且超过保留期」的会话扫描归档。默认保留期 30 天、默认扫描间隔 60 分钟；界面提供 3、7、14、30 天选项。单次扫描最多处理 50 个候选会话。
- 扫描排除规则：自动扫描会跳过运行中、已固定、空白、当前加载、子智能体、不可用、已归档以及需要迁移的会话。
- 列表能力：搜索、筛选、排序，并按项目分组展示。
- 永久删除：在已归档流程中提供，需确认；Host 校验 session ID 与存储日志身份，拒绝存活或已固定的会话，随后删除会话日志目录并更新归档/工作区关系。
- 本地持久化：在 profile 内保存
plugin-state/session-archive.json（插件设置）与plugin-state/session-archive-audit.log（删除审计，约 1 MiB 轮转并保留一代旧文件）。设置界面支持中英文。
兼容性说明：需要支持 profile 插件与 Settings 扩展的 DSH 桌面端；本地开发与测试要求 Node.js 22+（初始发布在 Node.js 24.17.0 上测试）。同一环境只应安装一份该插件；若曾安装开发包 @local/session-archive，需先移除再安装本仓库包，勿新旧并存。
安装与启用¶
在已配置 DSH CLI 的环境中执行官方安装命令：
dsh plugin --profile desktop add github:ailawu0409/dsh-session-archive
安装指定 Release 时可带 tag，例如：
dsh plugin --profile desktop add github:ailawu0409/dsh-session-archive#v0.1.0
若仍保留旧开发包，先移除再安装：
dsh plugin --profile desktop remove @local/session-archive
dsh plugin --profile desktop add github:ailawu0409/dsh-session-archive
重启 DeepSeek Harness 后，打开 Settings → Archive Management（归档管理） 使用界面。
升级前建议备份重要会话数据，再次执行安装命令拉取目标版本并重启；变更见 Releases。卸载前请先关闭自动归档，再执行：
dsh plugin --profile desktop remove dsh-session-archive
卸载不会代为永久删除会话；profile 内设置与审计文件可能仍存在，需自行备份后手动清理。
典型用法¶
自动归档：进入归档管理设置，开启自动归档并选择保留期（如 7 天或 30 天）。只有满足「不活跃 + 超过保留期」且不在排除列表中的会话才会被纳入扫描。
手动归档与恢复：在「未归档」「已归档」两个标签页浏览列表，对 eligible 会话执行归档，或对已归档项执行恢复。
永久删除：仅在已归档工作流中发起，按界面确认。操作前务必确认无需再用的日志已备份；审计日志可能包含 session ID 与本地路径，提交公开 issue 前应脱敏。
适用场景与注意¶
适合长期在 DSH 桌面端做多项目、多会话开发的开发者：需要把历史会话从主列表里「收起来」而不是立刻删盘，或需要按项目整理后再决定是否永久清除。
使用前请注意：
- 插件以当前 DSH 进程权限读写 profile 与会话存储；安装前应查看 GitHub 源码 与 MIT License，自行评估是否满足环境要求。
- Harness 扩展 API 可能在版本间变化；README 标明此为非官方社区插件。
- 永久删除不可通过插件撤销；自动归档默认关闭，避免误配后立即移动大量会话。
结尾¶
dsh-session-archive 把会话生命周期管理放进 Settings，在本地完成归档、恢复与受控删除，并保留容量受限的删除审计。目录与说明见 SkillHub 插件页，源码与文档见 GitHub：ailawu0409/dsh-session-archive。
