DSH Archive Manager

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

English · 更新日志 · Apache-2.0

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

你可以用它做什么

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

• 归档会话：收起单条聊天，或整个工作区的未归档聊天。
• 找回历史：搜索标题与正文，组合项目、收藏和日期筛选，按时间、标题或轮次排序。
• 恢复任务：恢复单条、选中的会话或整个项目；可全选当前筛选结果后批量操作。
• 清理记录：确认后永久删除不再需要的归档会话，查看批量进度并重试剩余项。
• 整理重要会话：收藏常用聊天，预览闲置归档候选，保护收藏与活跃任务。
• 查看与排障：不恢复即可快速预览，复制会话 ID／路径，诊断异常并定向修复支持的旧日志。

本文对应 1.0.0 版本，完整功能清单与升级边界见更新日志。

异常会话诊断与修复

归档页自动汇总读取异常，展开「诊断与修复」可查看原因和处理建议。点击「诊断会话」，符合规则时再点击「确认修复」。当前支持旧自动化来源，以及早期的参考文档提示和工作约定来源，保留原日志与正文。修复要求会话已归档且未在任何 DSH 进程中打开；文件缺失、权限问题与未知损坏只给出处理建议，不删除或截断日志。

检索与预览

• 已归档与未归档统一支持标题／正文搜索、日期、项目、收藏及创建时间排序；两边均可通过星标收藏和取消收藏。未归档的正文命中点击打开完整会话。

• 快速预览默认以 Markdown 排版展示，支持表格、引用与代码块，区分用户和助手；可切换为原文与关键词高亮。

• 在搜索框左侧选择「标题与正文」，可搜索当前页签会话中的用户和助手文本；默认仍只搜索标题。

• 搜索框右侧「日期」可选择或清除更新时间范围；项目、收藏和更新时间范围可组合使用；结束日期包含本地当天。已归档和未归档页均支持正文搜索与这些筛选条件。

• 正文命中显示片段和关键词高亮；已归档页点击片段或「更多 → 快速预览」查看上下文，不恢复会话；未归档页点击片段打开完整会话。没有关键词时预览最近八条消息，有关键词时定位首个命中附近。

• 检索逐批读取，每批最多 20 条会话，批内逐条读取；关键词最多 200 字符。预览每条最多 2000 个 UTF-16 码元，截断保留完整 Unicode 字符，较长内容请打开完整会话。

• 搜索与预览不包含工具输出、附件、推理、系统或插件注入消息；读取失败会显示详情并支持重试。检索的是持久化原始文本，不等同于模型当前上下文。

• 未建立持久化全文索引，大量或超长会话可能需要较久，建议先缩小项目、日期或收藏范围；尚无可承诺的会话数量上限或响应时延；更改条件会停止后续批次，正在读取的单批仍会完成，但旧结果不会覆盖新筛选。

轮次与定位

• 已归档和未归档列表均在时间旁显示轮次。每条用户提交消息算一轮，包括图片消息；助手回复、工具调用和插件注入不计入。
• 排序菜单新增「轮次最多／轮次最少」，轮次相同按更新时间及标题排序。读取失败显示「轮次未知」，放在已知轮次之后，并提供失败明细和重试。
• 每行「更多」菜单提供「复制会话 ID／复制会话路径」。官方 JSONL 存储复制会话目录，其他后端复制宿主提供且存在的文件路径；路径缺失会提示，不猜测路径。
• 详情每批读取最多 20 条，不激活或恢复会话。统计来自原始日志；分支中继承的用户消息也计入。较多长日志可能需要等待，未建立持久化轮次索引。
• 剪贴板需要 HTTPS 或本机地址及浏览器权限；复制失败会明确提示，不显示成功。

界面预览

在「设置 → 归档会话 → 已归档」检索、收藏、预览、恢复和清理：

切换到「未归档」，使用相同筛选条件整理会话，预览闲置归档或按项目批量归档：

截图来自发布前开发版，界面中版本标识为 0.1.44；本次发行版本为 1.0.0。侧栏由当前安装的 UI 插件提供，不代表本插件新增的侧栏功能。

前置条件

• 已能正常使用 DeepSeek Harness Web，并可在终端运行 dsh。
• 当前支持 DSH 0.1.2-rc.1、0.1.5-rc.1、0.1.5-rc.2、0.1.5-rc.3、0.1.7-rc.1、0.1.7-rc.2、0.2.0-rc.1、0.2.0-rc.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 硬刷新浏览器。打开「设置 → 归档会话」即可使用。

使用

| 你想做什么 | 操作 | | --- | --- | | 归档一条会话 | 打开侧栏会话菜单，选择「归档会话」 | | 归档整个工作区 | 打开工作区菜单，选择归档该工作区的会话 | | 查找归档 | 打开「设置 → 归档会话」，选择标题／正文搜索，组合项目、收藏和日期筛选 | | 调整排列顺序 | 按更新时间、创建时间、标题、轮次最多／最少排序 | | 恢复一条会话 | 点击会话右侧的恢复图标；更多菜单可「恢复打开」 | | 归档某个项目或未分组 | 在「未归档」页点击分组右侧“…”菜单，确认归档该组全部聊天；不受搜索筛选影响 | | 收藏会话 | 点击行右侧星标，使用收藏下拉菜单筛选 | | 快速查看归档内容 | 点击命中片段或「更多 → 快速预览」 | | 整理闲置会话 | 在未归档页设置天数，预览、检查候选后确认归档 | | 定位会话文件 | 在更多菜单复制会话 ID 或路径 | | 处理读取异常 | 展开诊断与修复，先诊断，再按资格确认修复 | | 跨项目批量归档 | 切换到「未归档」，跨项目勾选会话后点击「归档」并确认 | | 批量恢复或删除 | 勾选会话后使用批量操作；也可使用项目菜单；页面不再提供独立的全部恢复／全部删除按钮 |

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

收藏与闲置整理

会话使用紧凑分组列表，点击项目标题可以折叠；右侧提供星标和恢复／归档图标，已归档会话的「更多」菜单提供恢复打开和删除。折叠只影响展示，「全选当前筛选结果」仍包含折叠组内符合筛选的会话。

• 在已归档或未归档会话行右侧点击星标，通过收藏下拉菜单中的「只看收藏」找回重要会话。收藏保存在宿主数据中，归档、恢复或更换浏览器不会清除；其他页面修改的收藏可在重新打开管理页后读取。
• 在「未归档」设置 1～36500 的整数闲置天数，结合当前项目、搜索、日期和收藏筛选，点击「预览闲置归档」。确认清单允许逐条取消，默认排除收藏、当前打开、正在执行（含子代理）以及等待交互的会话；缺少有效最后活动时间的会话不参与。
• 归档前再次检查收藏和活动状态。批量归档、恢复、删除显示进度与成功／跳过／失败／未处理数量；首个失败后停止，支持只重试剩余项。删除重试仍需确认。
• 「撤回本次归档」只恢复最近一批实际归档成功的会话，包括该批重试成功的部分。仅在本次打开管理页期间有效，关闭页面或刷新会清除记录；不会撤回原有归档，也不能恢复永久删除的会话。
• 收藏会话仍可手动归档；收藏保护只针对闲置整理。没有定时自动归档，不会在后台自行整理。

「全选当前筛选结果」只选择符合当前条件的会话。项目菜单的整体操作仍作用于该项目全部会话，不受搜索筛选影响。未归档页排除子代理和空白占位会话。

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

查看并继续归档对话

原生会话导航自 0.1.40 起提供，1.0.0 的操作入口如下：

• 点击会话标题：打开 DSH 原生会话页，查看消息、附件和工具详情；可直接继续聊天，保持归档状态。
• 更多菜单 → 恢复打开：取消归档后进入原会话，继续工作。

检索接口兼容约定（集成开发者）

正式入口为 workspaceRegistry.searchSessionContent({ sessionIds, query })，支持已归档与未归档会话。输入为 1～20 个会话 ID 和 1～200 字符非空关键词，ID 去重后处理。成功返回 { items: [{ sessionId, seq, snippet }], failures: [{ sessionId, message }] }；单条读取失败进入 failures，参数不合法则拒绝整个调用。

searchArchivedContent 是旧客户端兼容入口，仅接受归档范围，保持原有语义。两者通过宿主 Typert 的既有连接与权限边界调用，无新增 HTTP 端点或鉴权配置。当前受支持版本范围内保留旧描述符，不在补丁版本移除；只有未来明确收窄兼容范围、完成客户端迁移并发布弃用说明后才删除。新客户端优先使用正式入口，旧入口仅用于旧版本回退；不应向两个入口重复发送同一检索。

更新

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

常见问题

安装后找不到入口？

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

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

dsh --profile web --dump-config

配置中应包含 ui-workspace-archive-manager，且不应再禁用官方 workspace 或 session-projection-cache。若还留着 archive-manager-host 的禁用覆盖，可以删掉。DSH 0.1.6+ 上官方 ui-settings-unarchive-sessions 应为 disabled: true，设置里只保留本插件的「归档会话」。若 profile 的 cordis.patch.yml 仍禁用 workspace、session-projection-cache 或 ui-workspace，请移除这些覆盖，再重启。

归档和删除有什么区别？

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

可以和 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 中使用 TypeScript 严格模式；共享协议在 contracts.ts，宿主版本适配在 host-compat.ts、client-compat.ts，客户端组件与状态类型在 client-types.ts。GitHub 与 npm 都包含可直接运行的 lib。改了源码后，提交前运行 pnpm build，否则源码安装仍是旧的运行文件。pnpm typecheck 检查业务源码和类型负例，pnpm test 先检查类型、构建再执行回归，pnpm verify 还执行兼容矩阵和打包检查。测试与构建脚本继续使用 .mjs；对外发布仍为 JavaScript，不要求宿主加载 TypeScript。

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。