前言¶
DeepSeek Harness（DSH）自带会话归档：归档后数据仍完整留在磁盘上，只是从活跃列表里隐藏。内置能力通常只有「隐藏归档 / 全部对话 / 仅归档」一类筛选，没有专门界面把「查看、归档、清理」放在一起，归档会话容易在磁盘上越积越多。
下面介绍社区插件 dsh-archive-manager（维护者 Joe-0202），分类为客户端插件。它复用 DSH 原生归档机制，用双 Tab 面板把归档、取消归档与彻底删除摆在同一行操作里。
这是什么¶
dsh-archive-manager 是 DeepSeek Harness 的归档管理插件：在一个面板里同时管理已归档会话与活跃会话，每行会话都提供归档类操作与删除并列入口。
- 仓库：github.com/Joe-0202/dsh-archive-manager
- 社区目录：skillhub.cn 插件页
- 许可证：MIT（见仓库 README）
- 当前 package 版本：0.1.0；Node 引擎要求
>=22.13
DSH 生态强调「一切皆插件」；SkillHub 等目录为社区站点，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
侧栏入口¶
侧栏底部（Settings 旁）增加 Archive Manager 图标，点击打开管理面板。
双 Tab 面板¶
| Tab | 内容 | 每行操作 |
|---|---|---|
| Archived | 全部已归档会话 | [Unarchive] [Delete] |
| Active sessions | 当前活跃会话 | [Archive] [Delete] |
每条记录展示：
- 会话标题（无标题时显示 “Untitled session”）
- 会话 ID（等宽字体）
- 绑定的工作区目录（可点击，用文件管理器打开）
- 状态徽章：
session log/cache/data missing/running
三种操作¶
- Archive：调用 DSH 原生
archiveSession；会话从活跃列表隐藏，数据保持原样。 - Unarchive：调用原生
unarchiveSession；会话回到活跃列表，数据从未被移动。 - Permanent delete：删除该会话的 session log 目录 + projection cache（不可恢复）。
- 绑定的工作区目录不会被删除（避免误删项目文件）。
- 操作前有确认对话框。
- 归档记录进入待清理队列，在下次启动 DSH 时由插件自动收尾，删除后不会在活跃列表里出现「空数据会话」。
幽灵条目¶
归档列表里若只剩归档记录、磁盘数据早已删掉，会标为 data missing；对此条目执行删除可清掉残留记录。
Agent 工具¶
提供 archive_list、archive_add、archive_remove、archive_delete，可用自然语言驱动。
安装与启用¶
将 <profile> 换成你的 profile 名；桌面端默认一般为 desktop。安装后重启 DSH，侧栏底部会出现 Archive Manager。
方式一：从 GitHub 安装（README 推荐）
dsh plugin --profile <profile> add github:Joe-0202/dsh-archive-manager
固定版本可加 ref，例如：
dsh plugin --profile <profile> add github:Joe-0202/dsh-archive-manager#v0.1.0
方式二：下载 Release 源码 zip 后本地安装
- 在 Releases 下载对应版本的 Source code (zip) 并解压。
- 用解压目录的绝对路径安装：
dsh plugin --profile <profile> add link:<解压目录的绝对路径>
卸载
dsh plugin --profile <profile> remove dsh-archive-manager
卸载只移除插件本身，不会删除任何会话数据或归档记录。
典型用法¶
- 点击侧栏底部 Archive Manager 打开面板。
- 在 Active sessions 里对暂时不用的会话点 [Archive]，它们会从活跃列表隐藏，数据仍保留。
- 在 Archived 里浏览全部归档会话。
- 需要恢复时点 [Unarchive]，会话回到活跃列表。
- 确定不再需要时点 [Delete] → 确认 → 永久删除（不可恢复）。
适用场景与注意¶
适合谁
- 长期用 DSH、归档会话较多，希望在一个界面里审查、恢复或清理的人。
- 希望归档与「彻底删会话数据」分开、且删除时不碰项目目录的开发者。
安全与行为（README 说明）
- 删除不可恢复：先弹确认，再删 session log 与 projection cache。
- 归档零风险：只写标记，不移动或复制数据，可随时取消归档。
- 会话数据路径通过扫描
$DSH_HOME/sessions/*/与 sessionId 精确匹配定位，降低删错目录的风险。 - 删除具幂等性：目标目录或缓存已不存在时视为已删除，不抛错。
安装前建议
插件在当前 DSH 进程权限下运行，安装前请自行查看仓库源码与 MIT 许可证，确认符合你的环境与安全要求。
结尾¶
dsh-archive-manager 不重新发明归档语义，而是在 DSH 原生归档之上补了一块专用 UI：双 Tab、行内归档/取消归档与删除并列，并处理删除后的归档记录清理与幽灵条目。若你正被「归档只能筛、不好管」困扰，可按上文命令安装并重启客户端试用。
- 目录页：https://www.skillhub.cn/plugins/Joe-0202/dsh-archive-manager
- GitHub：https://github.com/Joe-0202/dsh-archive-manager
