前言¶
DeepSeek Harness(DSH)的理念是“一切皆插件”。在 DSH WebUI 里,原生侧边栏通常只提供一个 “archive” 动作:把当前会话从侧边栏隐藏。但隐藏之后,归档会话不容易再查看,也不方便恢复或彻底删除。
jasonrale/dsh-archive-manager 就是针对这个缺口做的插件:在侧边栏底部增加 “Archived” 入口,把归档会话集中展示出来,并支持继续聊天、恢复回原工作区,或彻底删除会话。
这是什么¶
dsh-archive-manager 是 DSH Web 的归档会话管理器。
它解决的核心问题是:原生 DSH 只能把会话归档并隐藏,但缺少对归档会话的查看、恢复、删除和搜索能力。安装后,插件会在侧边栏底部提供入口,让你在一个面板里管理历史归档会话。
它声明的平台是 Web,许可证为 MIT,仓库地址为:
https://github.com/jasonrale/dsh-archive-manager
核心功能¶
下面介绍已核实的主要能力。
归档面板¶
侧边栏底部会提供 “Archived” 入口。点击后打开归档面板,归档会话按工作区分组展示,样式与官方侧边栏保持一致。
继续归档会话¶
点击一个归档会话,可以打开它并继续聊天。这个操作不会改变会话的归档状态。
恢复到原位置¶
插件支持一键将归档会话恢复到原工作区,并保留原始位置。
彻底删除¶
删除前,插件会先安全停止会话,再移除完整磁盘记录。删除操作前有确认对话框。
过滤与搜索¶
支持按标题或工作区即时过滤,也支持消息搜索,包括用户提示和助手回复。
与官方侧边栏同步¶
分组方式、排序方式(手动 / 最近更新)和拖拽排序,都会与官方侧边栏保持实时双向同步。
多语言与会话状态¶
界面支持英文和中文,并自动跟随系统语言。
会话状态显示为:
- 运行中
- 已完成
- 等待用户
显示方式与官方侧边栏一致。
安装与启用¶
先确认环境满足要求。package.json 声明 Node.js 引擎要求为:
"node": ">=22"
安装命令如下:
npx @deepseek-ai/dsh plugin --profile web add dsh-archive-manager
安装完成后,重新打开或重启 DSH Web,然后在侧边栏底部查找 “Archived” 入口。
更新插件¶
如果已有插件需要更新,使用:
npx @deepseek-ai/dsh plugin --profile web update dsh-archive-manager
卸载插件¶
卸载命令如下:
npx @deepseek-ai/dsh plugin --profile web remove dsh-archive-manager
卸载后需要重启 dsh web。
典型用法¶
下面是从 README 和已核实事实中可以复现的使用路径。
1、进入 DSH WebUI。
2、在侧边栏底部点击 “Archived” 入口,打开归档面板。
3、在归档面板中选择一个会话。
根据需求执行下面任一操作:
- 点击会话,打开并继续聊天;
- 将归档会话恢复到原工作区;
- 删除会话,删除前会先停止会话并移除完整磁盘记录;
- 按标题或工作区过滤归档列表;
- 搜索用户提示或助手回复中的消息。
适用场景与注意¶
适合以下场景:
- 使用 DSH WebUI 管理多个工作区;
- 归档了较多历史会话,但不希望彻底丢失;
- 希望把归档会话找回来继续对话;
- 需要按工作区、标题或消息内容快速定位历史会话。
使用前注意以下几点。
依赖版本¶
该插件声明基于 @deepseek-ai/dsh 0.1.0-rc.6 开发,并依赖官方内部接口,例如 workspaceRegistry.enqueueOperation、AgentHandle.dispose,以及 client-runtime 的服务形态。
因此,如果后续升级 dsh,插件可能需要适配。升级后如果出现异常,需要确认插件是否已跟进新版本。
已知限制¶
如果插件热重载时某个会话正在运行,之后这个会话可能无法删除。此时需要先进入重启 dsh 的状态,再执行删除。
普通使用不受此影响:先安装插件,之后管理的归档会话,包括插件存在之前已经归档的会话,都可以继续处理。
权限与源码检查¶
插件会以当前 dsh 进程权限运行。安装前建议检查源码、依赖声明和许可证。
package.json 中还声明了若干 peerDependencies,包括:
@deepseek-ai/cordis ^4.0.1
react ^18.2.0
多个 @deepseek-ai/dsh-* ^0.1.0-rc.6
同时声明了:
dsh.client.platform = web
dsh.bundle.patch = ./cordis.patch.yml
链接¶
插件目录页:
https://www.skillhub.cn/plugins/jasonrale/dsh-archive-manager
GitHub 仓库:
https://github.com/jasonrale/dsh-archive-manager
dsh-archive-manager 的价值比较具体:把 DSH WebUI 原本只能“隐藏”的归档会话,变成可继续、可恢复、可搜索、可删除的管理对象。如果你需要频繁处理历史归档会话,它适合作为 DSH Web 的配套插件使用。