MichengAI/dsh-archive-manager

DSH Archive Manager

在 DeepSeek Harness 中安全管理已归档会话

English · 更新日志 · Apache-2.0

许可证：Apache-2.0
npm package
npm 下载量
DSH Web Plugin

DSH Archive Manager 是社区维护的 DeepSeek Harness（DSH）插件，并非 DeepSeek AI 官方产品。

你可以用它做什么

把暂时不用的会话收起来，需要时再找回，让日常任务列表更清爽。

- 归档会话：收起单条聊天，或整个工作区的未归档聊天。
- 找回历史：搜索会话标题，按项目筛选，按时间或标题排序。
- 恢复任务：恢复单条、选中的会话、整个项目或全部归档会话。
- 清理记录：确认后永久删除不再需要的归档会话。

界面预览

从侧栏会话菜单归档聊天：

从会话菜单归档会话

在「设置 → 归档会话」集中查找、恢复和清理：

归档会话管理页

前置条件

- 已能正常使用 DeepSeek Harness Web，并可在终端运行 dsh。
- 当前支持 DSH 0.1.0-rc.8、0.1.1-rc.2、0.1.2-rc.1、0.1.5-rc.1、0.1.5-rc.2、0.1.6-alpha.1、0.1.6-alpha.2；其他版本暂未纳入支持范围。
- Node.js 版本需满足 ^22.19.0 || >=24.0.0；从源码安装还需要 pnpm。

安装

以下示例使用 web profile，请替换为你实际使用的 profile。

让 Agent 帮你安装

把下面这段话发给能执行本机终端命令的 Agent：

请将 @michengai/dsh-archive-manager 最新版安装到本机 DSH 的 web profile，使用官方 npm 源。安装后检查插件配置，并告诉我如何重新加载 DSH、进入归档会话管理页。

手动安装

在 PowerShell 中执行：

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8

dsh plugin --profile web add @michengai/dsh-archive-manager@latest --registry=https://registry.npmjs.org/

安装后重启 DSH Web，并按 Ctrl+Shift+R 硬刷新浏览器。打开「设置 → 归档会话」即可使用。

使用

| 你想做什么 | 操作 |
| --- | --- |
| 归档一条会话 | 打开侧栏会话菜单，选择「归档会话」 |
| 归档整个工作区 | 打开工作区菜单，选择归档该工作区的会话 |
| 查找归档 | 打开「设置 → 归档会话」，搜索标题或按项目筛选 |
| 调整排列顺序 | 按更新时间、创建时间或标题排序 |
| 恢复一条会话 | 点击会话右侧的「恢复」 |
| 归档某个项目或未分组 | 在「未归档」页点击分组右侧“…”菜单，确认归档该组全部聊天；不受搜索筛选影响 |
| 跨项目批量归档 | 切换到「未归档」，跨项目勾选会话后点击「归档」并确认 |
| 批量恢复或删除 | 勾选会话后使用批量操作；也可使用项目菜单或页面顶部的全部操作 |

页面默认打开「已归档」，右侧「未归档」用于批量归档。切换 TAB 会清空选择；切换搜索或项目筛选会保留已选会话。批量操作前留意隐藏的已选数量，或先清空选择。

「全部恢复 / 全部删除」仅在已归档页显示，作用于所有项目的归档会话，不受筛选影响。未归档页排除子代理和空白占位会话，支持按更新时间或标题排序。

设置页与侧栏的批量归档、批量恢复均串行调用单条接口：归档在所有支持的宿主走官方 ctx.workspaces.archiveSession；恢复在 DSH 0.1.6+ 走官方 ctx.workspaces.unarchiveSession，更早宿主回退到本插件的 workspaceRegistry.unarchiveSession。

查看并继续归档对话

从 0.1.40 起支持以下操作：

- 打开会话：打开 DSH 原生会话页，查看消息、附件和工具详情；可直接继续聊天，保持归档状态。
- 恢复并打开：取消归档后进入原会话，继续工作。

更新

在归档管理页标题处点击「检查更新」。支持自动更新的 DSH CLI 或 Desktop 环境可直接更新；其他环境会提供适用于当前 profile 的手动命令。也可重新执行上面的安装命令。

常见问题

安装后找不到入口？

先重启 DSH Web 并硬刷新浏览器，确认安装到了当前使用的 profile。仍未显示时，执行：

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8

dsh --profile web --dump-config

配置中应包含 workspace-archive-manager 和 ui-workspace-archive-manager。DSH 0.1.6+ 上官方 ui-settings-unarchive-sessions 应为 disabled: true，设置里只保留本插件的「归档会话」。若曾在 profile 的 cordis.patch.yml 中手动将官方 ui-workspace 设为 disabled: true，请移除该禁用覆盖，再重启。

归档和删除有什么区别？

归档只是收起会话，可以恢复。永久删除无法撤销，并可能一并清理该会话的附件；不会删除你的项目工作目录。删除前会要求确认。

可以和 Codex UI 一起使用吗？

可以。保留 Codex UI 的侧栏样式和交互，归档管理仍在「设置 → 归档会话」中。

遇到其他问题，请提交 Issue，附上 DSH 与插件版本、复现步骤和错误信息。

从源码安装

开发或测试未发布改动时展开

在你选择的源码目录中执行以下命令。未推送的本地改动需使用已有工作副本。

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8

git clone https://github.com/MichengAI/dsh-archive-manager.git
Set-Location .\dsh-archive-manager
pnpm install --frozen-lockfile
pnpm build
dsh plugin --profile web add .

完成后重启 DSH Web 并硬刷新浏览器。修改 src 中的源码，不直接编辑生成目录 lib；使用 pnpm test 验证修改，使用 pnpm verify 执行完整检查。

DSH 产品生态

想使用桌面工作台，可下载 DSH Codex Desktop；已有 DeepSeek Harness 环境，可按各项目 README 按需安装。以下列出 11 个自研插件；桌面端实际随附范围以对应版本的发行说明和内置清单为准。

| 插件 | 你可以用它做什么 |
| --- | --- |
| Codex UI | 整理项目与会话、搜索任务、跳转对话轮次 |
| Agency Agents | 按任务选择并召唤专业角色 |
| Skills Manager | 统一查找、启停、创建和导入本机技能 |
| Archive Manager | 搜索、恢复或清理已归档会话 |
| IM Connect | 从消息平台下任务、收回复 |
| Automation | 按计划执行任务，查看每次运行的结果 |
| BTW | 在当前上下文中临时旁问，不打断主任务 |
| Simplify | 用 /simplify 整理 Git 改动范围内的代码 |
| PUA | 引导 Agent 在失败时换方法、查原因，并在完成前验证结果 |
| Code Review | 用 /review 发起独立 Agent 代码审查，在当前会话接收报告 |
| Codex Pet | 通过桌面宠物查看会话提醒、处理工具审批和问题回答 |

许可证

本项目采用 Apache License 2.0。