前言¶
在 DeepSeek Harness（DSH）里长期跑智能体会积累大量会话：有的已经归档、侧栏不再显示，但日志仍留在 ~/.dsh/sessions/；有的会话需要对照工作区里的代码或本地日志排错，却要在设置和文件管理器之间来回找路径。DSH 内置能力可以归档会话，但集中查看、搜索、恢复或彻底清理归档记录，以及从 UI 一键打开工作区或会话日志目录，并不是默认就凑在一起完成的。
@ancircle0/dsh-archive-ext（仓库 ancircle0/dsh-archive-ext）是社区维护的独立插件，归类为「记忆」相关扩展。下面介绍它的定位、能力与安装用法；事实以 GitHub README 为准。
这是什么¶
该插件面向 DSH Web UI 与 Desktop，做两件事：在会话行的「…」菜单里提供「打开工作区文件夹」「打开会话文件夹」；在「设置 → 归档管理」里集中管理已归档会话。它只向会话菜单添加入口，不替换或改写 DSH 内置菜单项，也不依赖其他第三方插件。维护者为 ancircle0，许可证为 MIT；npm 包当前版本为 0.1.3。
核心功能¶
会话菜单快捷入口¶
在任意会话行点击「…」后可用：
- 打开工作区文件夹：用系统文件管理器打开该会话所属工作区目录（Windows Explorer、macOS Finder、Linux 下通过
xdg-open）。 - 打开会话文件夹：打开会话日志目录，通常在
~/.dsh/sessions/.../session-<id>/。
若会话尚未生成日志（例如刚创建、尚无内容），「打开会话文件夹」会提示「会话日志尚未生成或已被删除」，而不是打开错误路径。
说明：工作区行「…」菜单暂不支持插件添加入口，因此上述入口仅在会话行菜单中提供。
归档管理¶
入口位于 设置 → 归档管理：
- 已归档会话按工作区分组，按更新时间倒序排列。
- 顶部搜索框可按标题、项目名或路径过滤，并可按工作区折叠。
- 取消归档：会话回到侧栏对应工作区。
- 永久删除：在用户二次确认后，删除会话日志目录、立即移除归档记录，并尝试释放内存中的 live 会话；操作不可恢复。运行中的智能体会被拒绝删除。
- 日志已不存在的无效归档记录会单独分组，可直接清理。
可选侧栏入口¶
设置页提供「在侧栏显示归档管理」开关。开启后，侧栏全局区域出现「归档管理」，点击可在主界面打开归档管理面板。开关状态保存在当前浏览器的 localStorage（key：dsh-archive-ext.sidebar），不跨浏览器同步。
兼容性与权限¶
- 要求 DSH
0.1.7及以上；README 记载当前验证运行时为0.2.1-rc.2。Web UI 与 Desktop 均可使用；Windows 优先验证，macOS / Linux 使用对应系统命令打开目录。 - 插件本身不发起网络请求，也不采集遥测数据；通过 DSH 提供的服务读取工作区与会话元数据，并读写归档状态；只对解析出的工作区或会话日志目录执行操作。永久删除仅在用户确认后执行。
DSH 插件以当前 dsh 进程权限运行。安装前建议查看仓库源码与 MIT 许可证，确认行为符合你的环境策略。
安装与启用¶
从 npm 安装（Desktop profile 示例）：
dsh plugin --profile desktop add @ancircle0/dsh-archive-ext
需要固定版本时：
dsh plugin --profile desktop add @ancircle0/dsh-archive-ext@0.1.3
本地开发可使用仓库目录路径安装，例如 Linux：
dsh plugin --profile desktop add /path/to/dsh-archive-ext
Windows 示例：
dsh plugin --profile desktop add C:\path\to\dsh-archive-ext
安装或更新后，请完全退出并重新启动 DSH；仅刷新页面不会重新加载 Host 插件代码。桌面版 profile 由 Electron 应用管理，同样需要完全退出应用再启动。
卸载：
dsh plugin --profile desktop remove @ancircle0/dsh-archive-ext
典型用法¶
打开会话相关目录¶
- 在侧栏选中目标会话，点击该行「…」。
- 选择「打开工作区文件夹」或「打开会话文件夹」。
- 若日志尚未生成，按界面提示处理，勿依赖不存在的路径。
管理归档¶
- 打开 设置 → 归档管理（或开启侧栏开关后从侧栏进入）。
- 用搜索框按标题、项目名或路径过滤；按需展开或折叠工作区分组。
- 需要恢复侧栏显示时使用「取消归档」。
- 确认不再需要会话数据时，使用「永久删除」并完成二次确认；注意不可恢复，且运行中的智能体无法删除。若释放 live 会话失败，普通会话列表可能需重启 DSH 后才完全消失，插件会给出提示。
- 对「无效归档」分组中的记录，可直接清理。
适用场景与注意¶
适合经常归档旧会话、又需要偶尔恢复或彻底清理磁盘占用的 DSH 用户；也适合在排错时快速跳到工作区或 session-<id> 日志目录，减少手抄路径。
已知限制包括：「打开会话文件夹」依赖会话日志已持久化；永久删除不可恢复；DSH 升级若调整插件接口，插件可能需要同步适配。
社区插件目录页（与 DeepSeek / 幻方无官方从属关系）：skillhub.cn/plugins/ancircle0/dsh-archive-ext。源码与详细设计见 GitHub 仓库 及其中的 PLAN.md。
