dsh-archive-ext
为 DeepSeek Harness（DSH）Web UI 提供归档管理与会话目录快捷入口的独立插件。
它把两类常用操作集中起来：
- 在会话 “…” 菜单中直接打开该会话的工作区文件夹或日志文件夹；
- 在「设置 → 归档管理」中集中查看、搜索、取消归档或永久删除已归档会话。
插件只向 DSH 的会话菜单添加入口，不替换或改写内置菜单项，也不依赖其他第三方插件。
预览
打开工作区文件夹
打开会话文件夹
功能特性
会话菜单快捷入口
- 打开工作区文件夹：打开当前会话所属的工作区目录。
- 打开会话文件夹：打开该会话的日志目录（通常在
~/.dsh/sessions/.../session-<id>/）。
- 使用系统文件管理器：Windows Explorer、macOS Finder、Linux
xdg-open。
- 会话日志尚未生成时，会显示可读提示，而不是打开错误路径。
归档管理
- 入口位于「设置 → 归档管理」；从侧栏入口打开的是同一个页面，全插件只有一个归档管理页面。
- 已归档会话按工作区分组、按更新时间倒序排列。
- 支持按标题 / 项目名 / 路径搜索，并可按工作区折叠。
- 取消归档：会话回到侧栏对应工作区。
- 永久删除：删除会话日志目录、立即移除归档记录，并尝试释放内存中的 live 会话；操作前需要二次确认。
- 运行中的智能体会被拒绝删除。
- 日志已不存在的无效归档记录会单独分组，可直接清理。
可选侧栏入口
- 设置页内提供「在侧栏显示归档管理」开关。
- 开启后，侧栏全局区域出现「归档管理」入口，点击在主界面打开同一个归档管理页面（同样带这个开关，内容与设置页完全一致）。
- 开关状态保存在当前浏览器的
localStorage，不跨浏览器同步。
兼容性
- DSH
0.1.7 及以上；当前验证运行时为 0.2.1-rc.2。
- Web UI 与 Desktop 均可使用。
- Windows 优先验证；macOS / Linux 使用对应的系统命令打开目录。
安装
从 npm 安装：
dsh plugin --profile desktop add @ancircle0/dsh-archive-ext
需要固定版本时：
dsh plugin --profile desktop add @ancircle0/dsh-archive-ext@0.1.5
本地开发（从仓库打包后安装，等价于 npm 安装形态）：
npm pack # 生成 ancircle0-dsh-archive-ext-0.1.5.tgz
dsh plugin --profile desktop add .\ancircle0-dsh-archive-ext-0.1.5.tgz
不要用目录 / 软链（link:）安装仓库目录。 那样插件会被放在 profile 之外，宿主只按插件自身的 node_modules 解析模块，@deepseek-ai/* 宿主包会找不到（ERR_MODULE_NOT_FOUND），整个插件不会激活。安装必须以 npm 包形态（registry 包或上面的 tarball）进行。
Windows 下 tarball 路径示例：
dsh plugin --profile desktop add E:\build\ancircle0-dsh-archive-ext-0.1.5.tgz
安装或更新后，请完全退出并重新启动 DSH。仅刷新页面不会重新加载 Host 插件代码。
卸载：
dsh plugin --profile desktop remove @ancircle0/dsh-archive-ext
桌面版 profile 由 Electron 应用管理；安装后请完全退出应用再启动，不要只刷新页面。
使用说明
打开会话目录
在任意会话行点击 “…”：
- 打开工作区文件夹：打开该会话所属的工作区目录。
- 打开会话文件夹：打开该会话的日志目录。
如果会话还没有生成日志（例如刚创建、尚未产生内容），「打开会话文件夹」会提示「会话日志尚未生成或已被删除」。
归档管理
打开 设置 → 归档管理：
- 已归档会话按工作区分组展示；
- 可用顶部搜索框按标题、项目名或路径过滤；
- 行内提供「取消归档」与「永久删除」；
- 无效归档记录会单独分组，仅允许清理。
永久删除不可恢复。 确认后会删除该会话的日志目录并立即移除归档记录。如果该会话仍驻留在内存中，插件会尝试释放；释放失败时，普通会话列表可能要到重启 DSH 后才完全消失，插件会显示提示。
侧栏入口
在设置页打开「在侧栏显示归档管理」后，侧栏会出现「归档管理」入口；关闭开关会移除该入口。开关只影响当前浏览器。点开该入口看到的就是设置页里的归档管理页面本身（同一个页面，同样带这个开关），插件不会维护第二份归档管理界面。
权限与数据
- 插件本身不发起网络请求，也不采集遥测数据。
- 通过 DSH 提供的服务读取工作区与会话元数据，并读写归档状态。
- 只对解析出的工作区目录或会话日志目录执行操作；不会浏览其他路径。
- 打开文件夹时调用系统文件管理器命令。
- 永久删除只在用户二次确认后执行，且不可恢复。
- 侧栏开关仅保存在浏览器
localStorage（key dsh-archive-ext.sidebar）。
已知限制
- 工作区行 “…” 菜单暂不支持插件添加入口，因此入口位于会话行 “…” 菜单；插件不替换 DSH 原生菜单项。
- 「打开会话文件夹」依赖会话日志已持久化。
- 永久删除不可恢复。
- DSH 升级若调整插件接口，插件可能需要同步适配。
开发
npm install --ignore-scripts
npm run check
npm test
npm run verify
npm run check：JavaScript 语法检查。npm test：核心逻辑与设置页图标增强的单元测试。npm run verify：Host/Client 接口契约与 client 装配冒烟测试。
设计决策、接口契约、实现细节、测试与变更记录统一维护在 PLAN.md。
贡献
欢迎提交 issue 或 PR。修改行为前请先阅读 PLAN.md：本项目以计划为单一事实来源，代码、测试、文档与验收项需要保持一致。
许可证
MIT
