前言¶

在 DeepSeek Harness（DSH）的 web profile 中，会话归档后往往需要重新找到它、确认内容，再恢复到原来的工作区。已有做法通常只提供归档动作，查看、预览和恢复归档会话的入口并不完整。

uwu9039/dsh-unarchive 是一个面向 DSH 的独立第三方插件，用于给已归档会话提供列表、预览、恢复，以及可选的归档二次确认。下面按功能、安装、用法和注意事项介绍。

这是什么¶

dsh-unarchive 可理解为 DSH 的“归档会话回收站”。

• 仓库：uwu9039/dsh-unarchive
• 许可证：MIT
• 维护者：uwu9039
• 与 DeepSeek 的关系：独立第三方插件，与 DeepSeek 无隶属关系

该插件面向 DSH 的 Web 插件场景，资料中给出的目标版本与 profile 如下：

DSH 0.1.0-rc.6
profile web

它不兼容 headless UI。

核心功能¶

归档列表¶

插件在右下角提供悬浮按钮。点击后打开浮层面板，已归档会话按工作区分组，组内按创建时间倒序排列。

面板会显示空态和总数，并支持中英文界面。

内容预览¶

在归档列表中，可以行内展开会话开头与最近消息。

预览规则如下：

• 单条内容不超过 200 字符
• 只提取 text 块
• 不展示工具参数与附件

单个恢复¶

列表中单个会话可以恢复。

恢复过程具备以下特点：

• 幂等
• 存在性校验
• 串行写入

恢复后，侧边栏会即时回到原工作区的原位置，不需要刷新页面，并支持多标签页同步。

全部恢复¶

当归档列表不少于 2 条时，可以使用“全部恢复”。

该操作会在面板内再次确认，然后逐个恢复。失败项不会导致整体回滚。

归档二次确认¶

归档二次确认默认关闭。

开启后，从侧边栏右键执行归档前，会先弹出确认框。确认框支持通过 Esc、点击遮罩或取消关闭。

资料中说明该能力包装了如下接口，并采用 fail-open 行为：

workspaces.archiveSession

设置¶

插件面板中的“设置”页签提供以下配置项：

confirmOnArchive
showButton
previewEnabled

设置即时生效，并持久化到本地文件：

~/.dsh/unarchive/settings.json

安装与启用¶

安装¶

按资料给出的命令，可以先安装插件：

dsh plugin --profile web add dsh-unarchive

这一步会在 DSH 的 web profile 下添加 dsh-unarchive 插件。

本地打包安装¶

如果使用本地打包产物，资料中给出的示例是先执行 npm pack，再安装生成的 .tgz 文件：

npm pack

dsh plugin --profile web add dsh-unarchive-0.1.8.tgz

这里的 .tgz 文件名来自资料示例，实际使用本地产物时以实际打包结果为准。

启用入口¶

安装完成后，插件会在右下角提供悬浮按钮。通过该按钮打开浮层面板，即可查看、预览和恢复已归档会话。

典型用法¶

下面按操作步骤说明常见用法。

打开归档面板¶

1、点击右下角悬浮按钮。

2、打开归档会话浮层面板。

3、查看按工作区分组的已归档会话。

预览并恢复¶

1、在面板中选择一个已归档会话。

2、行内展开内容预览。

3、确认会话开头和最近消息。

4、恢复单个会话。

如果列表中已有多个归档会话，也可以在面板内执行全部恢复。该操作会先给出二次确认，然后逐个恢复。

修改设置¶

1、打开面板中的“设置”页签。

2、修改以下配置项：

confirmOnArchive
showButton
previewEnabled

3、保存后设置即时生效。

设置会持久化到：

~/.dsh/unarchive/settings.json

开启归档二次确认¶

开启 confirmOnArchive 后：

1、从侧边栏右键执行归档。

2、插件先弹出确认框。

3、点击确认后才继续归档。

如果按 Esc、点击遮罩或取消，则不会执行归档。

适用场景与注意¶

该插件适合使用 DSH web profile、需要经常处理已归档会话的场景，例如：

• 误归档后需要找回会话
• 想恢复前先看会话开头和最近消息
• 需要把会话恢复回原来的工作区
• 希望归档前增加一次确认，降低误操作

需要注意以下边界：

• 不兼容 headless UI
• 不做删除或清空归档
• 不做归档内容搜索
• 不做“恢复并打开”
• 不展示工具参数与附件
• 任一依赖缺失时，相应功能降级，不阻塞原生归档

卸载后，资料中说明仅残留设置文件：

~/.dsh/unarchive/settings.json

其余内容由插件清理还原。

另外，该插件会以当前 DSH 进程的权限运行，并会访问本地设置路径、调用 DSH 插件能力。安装前应检查源码、许可证和依赖关系。

获取地址¶

已核实资料中未给出可确认的目录页地址。仓库地址如下：

https://github.com/uwu9039/dsh-unarchive