前言¶

在 DSH 工作流里，会话归档后通常会落到本地目录中。如果只依赖 shell 命令处理归档会话，需要分别确认标题、创建时间、所属目录、磁盘文件路径和占用空间。dsh-archived-sessions 把这类操作集中到 DeepSeek Harness 的 Web 设置页中，作为一个可安装的设置页扩展使用。

这是什么¶

dsh-archived-sessions 是 MuWinds 维护的 DeepSeek Harness Web 界面设置页扩展，以单 bundle 包分发，一条命令即可安装。它用于查看已归档会话、释放归档会话、删除会话文件，并预览会话内容。

包名与仓库信息如下：

• npm 包名：@muwinds/dsh-archived-sessions
• GitHub 仓库：MuWinds/dsh-archived-sessions
• 目标 Harness 版本：0.1.0-rc.6（web profile 组合结构）
• 许可证：MIT

核心功能¶

在 Harness 的「设置 → 归档会话」页面中，该插件提供以下能力：

• 查看所有已归档会话，包括标题、创建时间、所属目录、磁盘上的实际文件路径。
• 显示每个会话占用的磁盘空间与总占用。
• 释放归档会话，即取消归档并回到原工作区，支持单个、批量、一键全部。
• 从硬盘删除会话文件，支持单个、批量、一键清空，并有两步确认。
• 点击会话标题展开查看会话内容，包括用户 / 助手 / 工具消息预览。

宿主端提供 POST /dsh-archived/* 路由，覆盖 list、unarchive、delete、detail 四类操作。该路由为同源、无鉴权，适合本地 Web 设置页环境使用。

安装与启用¶

从 GitHub 安装：

dsh plugin --profile web add github:MuWinds/dsh-archived-sessions

安装后重启 Harness：

npx @deepseek-ai/dsh web

设置面板底部会出现「归档会话」页面。

从本地目录安装，适合开发调试：

dsh plugin --profile web add ./dsh-archived-sessions

卸载：

dsh plugin --profile web remove @muwinds/dsh-archived-sessions

如果包已发布到 npm registry，可用包名安装：

dsh plugin --profile web add @muwinds/dsh-archived-sessions

只走 GitHub 也可以：

dsh plugin add github:MuWinds/dsh-archived-sessions

如果需要锁定版本，可以将仓库来源指定为：

github:MuWinds/dsh-archived-sessions#<sha>

这个包是纯 JavaScript 包，没有 prepare 构建脚本，因此不需要 pnpm allowBuilds 授权。宿主端插件无第三方运行时依赖，纯 ESM，不 import 任何 @deepseek-ai/*，所需能力全部从 ctx 获取；浏览器端仅依赖 react，由 Harness 前端运行时提供，属于 platform seed。

典型用法¶

1、安装插件并重启 Harness：

dsh plugin --profile web add github:MuWinds/dsh-archived-sessions
npx @deepseek-ai/dsh web

2、进入 DSH Web 界面，打开设置面板，在底部找到「归档会话」页面。

3、在列表中查看会话标题、创建时间、所属目录、磁盘文件路径和磁盘占用。

4、点击会话标题，展开预览用户 / 助手 / 工具消息。

5、如果要把会话恢复到原工作区，使用释放（取消归档）。如果需要清理磁盘空间，使用删除。删除前需要两步确认，且删除不可恢复。

适用场景与注意¶

适合使用 DSH web profile 的本地开发者，尤其是需要集中查看和清理归档会话的使用者。使用前需要注意：

• 本插件包含「从硬盘删除会话文件」能力，删除不可恢复。
• 安装即代表信任本仓库代码会在你的机器上以你的权限运行，安装前请审阅源码和 MIT 许可证。
• 宿主端 API 为 POST /dsh-archived/*，无鉴权、同源，仅适合本地 Web 设置页环境。
• 目标 Harness 版本为 0.1.0-rc.6，对应 web profile 组合结构。
• 国内镜像只读，发布时需显式带官方源。

结尾¶

dsh-archived-sessions 的价值是把归档会话管理从文件系统操作里拉回到 DSH Web 设置页：查看、释放、删除和详情预览都在同一页面完成。仓库地址：https://github.com/MuWinds/dsh-archived-sessions