前言¶
DeepSeek Harness (DSH) 0.1.1-rc.2 提供了“归档会话”功能,但设计上是单向的:右键归档后,系统不提供取消归档或恢复的界面。归档的会话会从侧边栏消失,若要找回通常依赖特定的内部操作,缺乏通用的管理手段。
dsh-archive-manager 是一个 DSH 插件,旨在补全这一缺失。它在设置页提供归档会话的列表视图,并提供一键恢复功能,让会话即时回到侧边栏,无需重启服务。
插件介绍¶
名称:dsh-archive-manager
维护者:zengcj-dev
许可证:MIT
该插件在 DSH 的设置页注入了一个新的分区,列出所有已归档会话的标题、创建时间和所属工作区。同时,它通过服务端注册同源路由,实现将指定会话从归档名单中移除的操作。
核心功能¶
- 查看归档列表:列出所有已归档会话的元数据。
- 一键恢复:点击恢复按钮,会话立即返回到侧边栏会话列表。
- 页面注入:利用 DSH slots 机制在设置页增加分区。
- 服务端路由:
-GET /plugins/dsh-archive-manager/list:读取并返回归档名单。
-POST /plugins/dsh-archive-manager/unarchive:执行恢复操作。
安装与启用¶
发布到 GitHub 后,可以通过以下命令安装:
dsh plugin --profile web add git+https://github.com/zengcj-dev/dsh-archive-manager.git
安装完成后,重启 dsh web,在 设置 → 归档会话 页面即可使用。
使用步骤¶
- 打开 DSH 设置页面,导航至 归档会话。
- 在列表中找到需要恢复的会话。
- 点击会话右侧的 恢复 按钮。
- 会话会立即回到侧边栏会话列表,历史内容完整保留。
兼容性与注意事项¶
- 依赖版本:需要 DSH 0.1.1-rc.2(web profile)。
- 内部接口:恢复功能调用了该版本的内部接口
workspaceRegistry.setState。若 DSH 升级并提供了官方 unarchive API,建议改用官方接口。 - 运行环境:服务端为 ESM,无构建依赖;浏览器端为 React 18 + 原生 fetch,无构建步骤。
- 权限说明:插件以当前 DSH 进程的权限运行,安装前建议检查源码与许可证。
结语¶
归档会话是 DSH 0.1.1-rc.2 的基础功能,但单向设计给用户带来了不便。dsh-archive-manager 通过补全“恢复”这一环,恢复了会话管理的闭环。更多详情可查阅 GitHub 仓库。