前言¶
DeepSeek Harness (DSH) 的理念是「一切皆插件」。当会话被归档后,它们会从侧边栏中隐藏,但 DSH 并未提供专门的 Web 界面来管理这些已归档的会话。dsh-archive-manager 是一个由 Ycet 维护的 Web 界面插件,它在 DSH Web 的设置窗口中新增了一个「归档」页面。你可以通过这个页面查看、筛选、排序已归档的会话,将其取消归档以恢复到侧边栏,或者彻底删除它们。
核心功能¶
- 按工作区分组查看:已归档的会话会按所属工作区分组展示,不属于任何工作区的会话归入「(未分组)」。
- 筛选与排序:支持按「全部工作区」、「具体工作区」或「未分组」进行筛选;支持按会话名称或创建时间进行排序。
- 取消归档:将选中的会话从归档集合中移除,它会重新出现在左侧边栏对应的工作区分组中。
- 彻底删除:支持删除单个会话或「删除全部」。所有删除操作均需二次确认。删除会移除会话日志文件、归档标记及工作区记账,不可恢复。
- 多语言界面:界面文案跟随 DSH 的活动语言(中文 / English)。
安装与启用¶
在安装前,请确保已安装 DSH CLI 和 pnpm(dsh plugin 内部会调用 pnpm)。
使用以下命令安装插件:
dsh plugin --profile web add github:Ycet/dsh-archive-manager
安装后,重启 DSH Web 应用即可生效。
使用步骤¶
- 重启 DSH Web 应用(
dsh web)并打开 http://127.0.0.1:3080。 - 点击左侧边栏底部的 设置。
- 在设置窗口左侧选择 归档 页面。
- 使用工具条上的筛选下拉菜单过滤工作区或未分组会话,使用排序下拉菜单调整顺序。
- 点击「删除全部」按钮或单个会话的删除操作,在弹出的二次确认窗口中点击确认即可。
注意事项¶
- 无官方 API:由于 DSH 没有提供官方的 unarchive 或删除会话 API,本插件直接读写
storageDomain(即~/.dsh/storages/workspace.json),严格保持其 schema 结构。 - 彻底删除:删除操作会移除会话日志文件(如
session.jsonl.zstd)、归档标记及工作区记账,不可恢复。 - 二次确认:所有删除操作(单个或全部)都需要二次确认。
- 无需配置:插件无需环境变量或配置文件,开箱即用。
- 版本兼容:插件依赖 DSH 0.1.0–rc.6 或更高版本。