前言¶

在 DeepSeek Harness 官方版本里，会话一旦归档，就会从所有分组视图中消失，且没有查看或恢复入口。也就是说，目前唯一的“已有做法”就是：归档即消失，误归档的会话找不回来。

dsh-restore-archived-sessions 补上这块缺口：把所有已归档会话集中列在一个设置页里，显示基本信息，并支持一键恢复。

这是什么¶

一句话定位：查看并恢复 Harness 中已被归档的会话。项目由 le-soleil-se-couche 维护，许可证为 MIT，目录页将其归入「记忆」分类（package keywords 为 session-management、archive-restore）。

先说清交付形态，这直接决定安装方式：

1、它不是可以经 dsh plugin add 安装的独立插件，而是定制 Harness 的 prebuilt host/client 替换包。dist/ 会替换 sibling package layout 下的 dsh-workspace、dsh-host-apiproxy 和三个 client bundle。

2、之所以这么做，是因为恢复功能依赖 Harness 主线的 workspace.unarchiveSession RPC，旧版本官方 Harness 没有这个接口，因此项目以「补丁包 + 安装脚本」的方式交付。

核心功能¶

已核实的能力有六项：

• 在设置页集中列出所有已归档会话
• 显示会话标题、所属工作区（或“未分组”）和最后活动时间
• 恢复：仅把会话移出归档，会话回到原工作区位置
• 恢复并查看：恢复后直接打开会话，并自动关闭设置面板
• 归档与恢复使用完整快照同步，多标签页状态一致
• 归档集合持久化保存，重启 Harness 后仍然有效

其中「恢复」和「恢复并查看」是两个独立动作：前者只改归档状态，后者恢复完直接进入会话。

安装与启用¶

安装分三步：先克隆仓库，再跑只读预检，预检通过后才执行安装，最后启动。

git clone https://github.com/le-soleil-se-couche/dsh-restore-archived-sessions.git
cd dsh-restore-archived-sessions
bash install.sh --check
# 仅在定制 host 的预检与隔离验证均通过后：bash install.sh --install
dsh web --host 127.0.0.1 --port 3080

bash install.sh --check 是只读预检：失败时会在创建 backup 或覆盖任意安装文件前退出。本机已有旧 build 是独立候选，只有其 package layout 与 archive-state anchor 都通过预检，并在隔离 profile 做过 synthetic archive/restore 验证后，才可评估安装。

bash install.sh --install 执行替换：安装脚本仅替换 dsh-workspace、dsh-host-apiproxy 和三个客户端 bundle，安装前自动备份。装完后以 dsh web --host 127.0.0.1 --port 3080 启动。

两个不能省略的前提：

1、预检不证明源码 provenance 或完整 ABI 兼容，也不会读写真实 archive record。

2、发布版 @deepseek-ai/dsh@0.1.2-rc.1 不暴露 dsh-host-apiproxy 这个替换目标，禁止直接复制；固定的 0.1.3-alpha.1 源码点 d347e703908d0406b7a7ef80e3a0e594d86b2215 使用 dsh-api-workspace-controller 等不同 transport seam，也不能把本 dist/ 当作兼容产物。

典型用法¶

1、在会话列表中归档任意一个会话。

2、打开左下角「设置」。

3、进入「已归档对话」。

4、点击「恢复」只恢复归档；点击「恢复并查看」则恢复并打开会话。

经过上面的步骤，归档的会话会回到原工作区位置。归档与恢复使用完整快照同步，多标签页打开时状态一致；归档集合持久化保存，重启 Harness 后仍然有效。

回滚¶

bash install.sh --rollback

--rollback 会验证 backup 与精确目标路径，不要求当前待恢复文件仍通过 archive ABI 预检——损坏的安装正是需要回滚的场景。

适用场景与注意事项¶

适合的用户：习惯用归档整理 Harness 会话列表、但担心归档后找不回会话的人。前提是你的环境能通过预检与隔离验证。

下面几条务必留意：

1、兼容性范围有限。原始 artifact 仅在定制 DeepSeek Harness master 源码环境验证过，不构成对当前发布版或本机任何旧 build 的兼容性承诺。

2、若要迁移到 0.1.3-alpha.1，应从该源码点通过 dsh-api-workspace-controller 和 dsh-client-ui-workspace 重建恢复界面及 workspace.unarchiveSession transport，保留 archive set 的位置语义与跨 tab snapshot 通知；靠覆盖发布版 package 或去掉恢复动作来声称兼容，是行不通的。

3、权限与审查。该补丁包以当前 dsh 进程的权限运行，安装前应检查源码与许可证（本项目为 MIT）。

4、DSH 的理念是「一切皆插件」，但像本文这类涉及 host/client 替换的包，安装门槛和风险都高于普通插件，按「先预检、再隔离验证、最后安装」的顺序走。

顺带说明：文中提到的社区目录（skillhub.cn）是独立站点，与 DeepSeek / 幻方无官方从属关系。

结语¶

dsh-restore-archived-sessions 做的事不复杂：给 Harness 中“归档即消失”的会话一个集中查看和恢复的入口。由于它以替换包形式交付，预检、备份与回滚是使用流程的一部分，按文档顺序执行即可。

• 目录页：https://www.skillhub.cn/plugins/le-soleil-se-couche/dsh-restore-archived-sessions
• GitHub：https://github.com/le-soleil-se-couche/dsh-restore-archived-sessions