Jiangdl0220/dsh-archived-sessions

dsh-archived-sessions

查看、恢复和删除 DSH（DeepSeek Harness）中已归档的会话：在设置页找回归档列表、阅读完整对话（轮次 / 推理 / 工具执行 / Markdown 表格），一键把归档会话恢复回侧边栏活跃列表。桌面端与 Web 端通用。

DSH 中「归档会话」后，会话会从所有界面消失且没有官方入口找回。这个插件在设置面板新增「已归档会话」页面，把归档列表找回来，并支持取消归档（恢复）。

截图

已归档会话列表
会话详情弹窗（含恢复按钮）

功能

- 归档列表：标题、所属工作区、消息数、最后活跃时间一目了然；支持刷新；v0.3.0 起每页 10 条分页，并支持按标题 / 工作区即时搜索过滤。
- 对话查看器：点击会话弹出只读对话流（弹窗覆盖在设置面板之上，关闭后回到列表）。
- 按轮次分组，每轮把「工作过程」（推理、工具调用、命令执行）折叠起来，最终回答清晰呈现；
- Markdown 渲染：标题、无序/有序列表、引用、链接、代码块（自动美化 JSON）、表格（可横向滚动）；
- 工具执行以终端卡片展示：工具名、状态点（成功/失败）、$ 命令行、可展开的输出；
- 系统注入的消息（运行上下文快照、技能清单等）单独折叠，不会和用户消息混淆。
- 恢复归档会话（v0.2.0+）：两步确认，把归档会话取消归档，回到侧边栏活跃列表的原位置。
- 入口有两个：归档列表每个会话行右侧的「恢复」按钮；v0.2.3 起会话详情弹窗页脚也有「恢复」按钮。
- DSH 只有 archiveSession 没有取消归档 API，本插件通过 workspace 注册表自己的存储域（storageDomain.get('workspace').global）把会话 id 从 archivedSessionIds 移除——与产品归档共用同一条持久化写入链，改动实时生效、重启后保持，并会清除该会话在本插件中的墓碑记录。
- 删除归档记录：两步确认，从归档列表移除。DSH 产品本身没有会话删除 API，因此实现为「墓碑」——会话保持归档状态（产品 UI 永远隐藏它），数据文件保留在磁盘（与产品行为一致）。

安装

dsh plugin 必须指定 --profile（对应你要装到的运行环境）：

DSH Desktop 桌面应用
dsh plugin --profile desktop add @jiangdaoli/dsh-archived-sessions
或 dsh web
dsh plugin --profile web add @jiangdaoli/dsh-archived-sessions

（desktop 是 DSH Desktop 应用使用的 profile 名，web 对应 dsh web；用了自定义 profile 就换成自己的名字。）安装后重启 DSH，在 设置 → 已归档会话 查看。

请从 npm 安装（上方的包名）。GitHub 仓库只包含源码，构建产物（lib/）在发布时由 CI 生成，从仓库直接安装会缺文件。从源码安装请先 pnpm install && pnpm build。

工作原理

- Host 半部（src/index.ts → runtime.ts）：通过官方 DSH 服务读取数据 —— workspaceRegistry（归档集合）、sessionQuery（标题 / 对话投影）、sessionPersistence.readRaw（损坏日志的宽松兜底）。经 Typert Remote 暴露 archived/list、archived/surface、archived/delete、archived/restore。
- 删除只写入插件自己的 settings 命名空间（墓碑）；
- 恢复通过 storageDomain 写入 workspace 域（从 archivedSessionIds 移除），从不改动会话数据本身。
- Client 半部（src/client/index.ts）：挂载 Remote 命名空间，注册 settings.section（id archived-sessions）。查看器在设置面板内部渲染，天然处于最顶层。
- 兼容性：只使用官方 DSH contract，不注入任何 desktop 专属 service，桌面端 / Web / CLI 均可用。

开发

pnpm install
pnpm build   # esbuild 单文件 host + client 产物到 lib/
pnpm typecheck

发布流程（含本地验收门、CHANGELOG 与 Release 说明步骤）见 RELEASING.md。

说明与限制

- 删除仅移除归档记录；会话数据保留在磁盘（DSH 从不删除会话数据）。
- 日志损坏（seq 缺口）的会话会显示「日志损坏」标记，打开时展示可解析的部分内容。
- 恢复（取消归档）写 workspace 存储域的 archivedSessionIds——这是该数据的唯一持久位置，与产品归档动作共用写入链；会话数据本身不被触碰。
- 继续对话：恢复后会话回到侧边栏活跃列表，点开即可继续对话（原会话、原日志，直接接着聊）。

更新日志

各版本变更见 CHANGELOG.md；GitHub Releases 同步发布说明。

License

MIT