前言¶

DSH 的理念是「一切皆插件」，Web GUI 能力可以通过插件扩展。对于已经有归档会话的使用者，常见的问题是缺少一个集中的管理入口：需要确认某条归档会话是否还要继续，或在确认无用后清理磁盘上的会话日志。

下面介绍 @chushiz/dsh-archive-manager。它是 DeepSeek Harness Web GUI 的归档会话管理插件，用于浏览、恢复或物理删除已归档会话。该插件由 ChuShiZ 维护，许可证为 MIT。

这是什么¶

@chushiz/dsh-archive-manager 是一个 DSH Web GUI 插件，入口在 设置 > 归档会话。

它主要提供三类操作：

• 浏览与搜索：按工作区查看已归档会话，并支持标题、目录、id、预设、会话正文全文搜索。
• 恢复：取消归档并打开会话。
• 删除：物理移除会话日志目录，不可逆。

核心功能¶

浏览与搜索¶

• 按工作区分组浏览已归档会话。
• 支持标题、目录、id、预设、会话正文全文搜索。
• 基于 harness 的 sessionQuery SQLite FTS5 索引搜索用户消息、AI 回复、工具调用与参数、todo。
• 搜索结果命中高亮、关键词居中短窗口、每会话最多 5 条，并可按类型筛选。

预览、恢复与批量删除¶

• 点击标题展开最近 4 句对话预览。
• “恢复并打开”会取消归档并打开会话。
• 多选复选框 + 顶部批量删除。
• 删除前自动停掉活着的 agent。
• 删除会物理移除会话日志目录，操作不可逆。

安装与启用¶

先确认 DSH 版本与 Node.js 版本满足下文要求，再执行安装。

在 DSH 插件环境中执行官方安装命令：

dsh plugin --profile web add @chushiz/dsh-archive-manager

安装后重启 dsh web。

启用后进入 设置 > 归档会话 页面，即可使用本插件。

典型用法¶

下面按实际操作顺序说明。

1、进入 设置 > 归档会话，按工作区浏览已归档会话。

2、输入关键词搜索。搜索范围包括标题、目录、id、预设、会话正文全文。

3、需要确认目标会话时，点击标题查看最近 4 句对话预览。

4、如果会话仍有用，选择“恢复并打开”，插件会取消归档并打开会话。

5、如果会话无用，先使用多选复选框选择目标会话，再通过顶部批量删除执行删除。

6、批量删除前会自动停掉活着的 agent；删除会物理移除会话日志目录，不可逆。

版本与运行环境¶

已核实资料给出的版本与依赖要求如下：

dsh >= 0.1.0-rc.7：支持（FTS5 搜索 + 服务直连）
dsh < 0.1.0-rc.7：未验证（依赖 sessionQuery.searchSessions 与 webServer 载体）
Node.js ^22.19 || >=24（随 dsh 要求）
peerDependencies:
@deepseek-ai/cordis ^4.0.1
@deepseek-ai/dsh-client-runtime ^0.1.0-rc.8

运行时的回退行为：

• 无 FTS 后端（openAt: never）时自动回退逐会话扫描。
• 服务未代理到浏览器时自动回退 HTTP API。

权限边界¶

插件的 host 侧与 client 侧边界如下：

• host 侧操作工作区注册表的归档集合与持久化状态：list 只读、unarchive 反向归档、delete 经 shell 移除日志目录。
• 不写日志、不注册面向模型的工具。
• client 侧注册设置页 settings.section，通过 archiveManager 服务调用以上操作。

由于 delete 会经 shell 移除会话日志目录，因此需要按当前 DSH 进程权限理解其影响。安装前建议先检查源码与许可证，再执行物理删除。

结尾¶

@chushiz/dsh-archive-manager 把归档会话的常见管理动作集中在 DSH Web GUI 的设置页里：按工作区浏览、全文搜索、预览、恢复并打开，或在确认无用后物理删除。

已核实资料未提供目录页 URL。项目 GitHub 仓库：

https://github.com/ChuShiZ/dsh-archive-manager