前言¶
在 DeepSeek Harness(DSH)里,会话一旦归档,就从侧栏消失了。日志文件还在本地,但 Web UI 没有提供浏览归档的入口,想找回只能靠记标题、翻目录。dsh-archive-manager 解决的就是这个问题:把已归档的会话重新变得可见、可管理——按项目分组、支持搜索,每个归档都能一键还原或永久删除。
这是什么¶
dsh-archive-manager 是由 MoonlitDropOfBlood 维护的社区插件,基于 DeepSeek Harness 构建,并非 DeepSeek 官方产品,许可证为 MIT。一句话定位:为 DSH Web UI 打造的归档管理面板。
核心功能¶
浏览与查找
- 归档会话按工作区(项目)分组展示,没有归属的会话进「未分组」桶
- 每个项目组内按最新更新时间从新到旧排序
- 顶部搜索框按会话标题 / 项目名实时过滤
还原与删除
- 一键还原:从归档集合移除,会话回到侧栏项目原位
- 永久删除:删除会话日志并移除归档记录。点一下变成「确认删除?」,再点一次才真正执行;运行中的智能体会被拦截
数据清理
- 无效归档记录(日志已不存在的残留)单独分组,可一键清理
- 已删除但仍驻留内存的 ghost 会话自动隐藏,并提示重启后彻底清除
体验与兼容
- 主题适配:全部使用 DSH 设计 token,明暗主题自动跟随
- 跨平台:Host 半只用 Node.js
fsAPI,Windows / macOS / Linux 均可运行
安装与启用¶
插件是标准 DSH bundle:package.json 声明 dsh.bundle.patch,包内自带 cordis.patch.yml,用官方 dsh plugin 命令安装:
dsh plugin --profile web add https://github.com/MoonlitDropOfBlood/dsh-archive-manager/releases/download/v1.3.0/dsh-archive-manager-1.3.0.tgz
dsh plugin add 会把插件装成 profile 的 npm 依赖并追加到 dsh.profile.bundles,启动时 DSH 自动应用包内的 cordis.patch.yml 挂载插件。安装后重启 DSH,侧栏底部(Cordis Plugin 下方、设置上方)会出现「归档」按钮。
包通过 peerDependencies 依赖 @deepseek-ai/cordis ^4.0.1、@deepseek-ai/dsh-storage-domain ^0.1.0-rc.6 和 @deepseek-ai/dsh-typert-protocol ^0.1.0-rc.6,另依赖 zod ^4.4.3。
卸载命令:
dsh plugin --profile web remove dsh-archive-manager
典型用法¶
- 点侧栏底部的「归档」按钮(带归档数量),打开管理面板。
- 面板按项目列出所有归档会话。要找回某个会话,点还原,它会回到侧栏对应项目下。
- 要彻底清理,点删除:第一次点击变成「确认删除?」,再点一次才执行。这一步永久删除会话日志,不可恢复。
- 日志已不存在的无效归档记录单独分组,点删除即可清理记录。
- 顶部搜索框按会话标题或项目名实时过滤。
如果你想本地开发或修改插件,仓库支持直接从本地路径安装:
dsh plugin --profile web add /path/to/dsh-archive-manager
改完代码后可以跑一次语法检查:
npm run check
这个脚本等价于 node --check index.js client.js typert.host.js,依次检查三个入口文件的语法。
适用场景与注意¶
适合经常归档会话、又希望保留「找回」和「清理」能力的 DSH Web UI 用户。如果归档对你只是「丢掉就不管」,这个插件的价值不大;如果你偶尔需要翻旧会话,或者想清掉残留的无效记录,它就是一个直接的入口。
几点注意:
- 删除是永久操作。运行中的智能体会被拦截,但一旦二次确认,日志不可恢复。
- 这是社区插件,以当前
dsh进程的权限运行,能读写本地会话文件。安装前建议查看源码(GitHub 仓库)和许可证(MIT),确认可接受再装。 - 生态说明:DSH 的理念是「一切皆插件」;本文提到的社区插件目录是独立站点,与 DeepSeek、幻方没有官方从属关系。
结尾¶
归档不该等于失联。dsh-archive-manager 把归档会话重新摆到你面前:按项目分组、可搜索、可还原、可清理,删除前有二次确认。项目地址与目录页如下:
- GitHub:https://github.com/MoonlitDropOfBlood/dsh-archive-manager
- 目录页:https://www.skillhub.cn/plugins/MoonlitDropOfBlood/dsh-archive-manager