dsh-archived-sessions

English | 中文

DeepSeek Harness（dsh）Web 插件：在**设置（Settings）**页面新增"归档会话"分区，用于集中管理已归档的对话。

官方来源： 本仓库是 npm 包 dsh-archived-sessions 的官方来源——dsh plugin add dsh-archived-sessions 安装的正是本仓库的代码。

功能

• 列出归档会话：每行显示会话自身的名称（与侧边栏一致的标题）、工作目录、日志大小与最近更新时间。
• 取消归档：一键将会话恢复到侧边栏，并保持其在工作区中的原始位置。
• 彻底删除：删除会话的本地日志目录（~/.dsh/sessions/...），并删除日志中引用、且不再被其他会话使用的附件对象，最后从工作区记账中移除该会话；删除前必须通过确认对话框。
• 原生观感：复用与内置设置分区相同的 UI 组件与设计令牌，界面完全一致。

前置要求

• DeepSeek Harness 0.2.0-rc.2 或更新版本——插件依赖 @deepseek-ai/dsh-client-store 快照 store，以及 remote.session / workspaces 客户端服务；它们取代了早期的 dsh-client-runtime / connection.api 接口。
• 核心需具备工作区归档接口（workspaceRegistry.archivedSessionIds / unarchiveSession）。
• 删除功能不需要核心额外支持。它通过已有的 unarchiveSession 清理归档集合，而该方法的契约恰好就是删除所需的：把 id 从 archivedSessionIds 摘掉、不碰任何记账槽位、不做会话存在性检查、对未归档的 id 直接 no-op。工作区 sessionIds 同样无需写入——该 getter 本身就按 canonical-cwd 头索引过滤，日志一删，会话自动从工作区投影中掉出去。
• 若核心早于归档接口，插件会优雅降级而非报错：列表仍可用，缺失的能力以结构化的 partial 结果返回，而不是抛出异常。

安装

从 npm 安装：

dsh plugin add dsh-archived-sessions

安装后插件会自动挂载（其 dsh.bundle patch 会加入 profile 的 bundle 栈）。刷新页面（强刷）加载客户端半，打开 设置 → 归档会话 即可使用。

也可以从源码安装：

git clone https://github.com/Jxy-hy/dsh-archived-sessions.git
cd dsh-archived-sessions
pnpm install
pnpm run build
dsh plugin --profile web add link:./dsh-archived-sessions

然后将以下内容追加到 ~/.dsh/profiles/web/cordis.patch.yml（或通过你偏好的 bundle 机制挂载）：

- insert:
    - id: dsh-archived-sessions
      name: 'dsh-archived-sessions'

Host 半会通过 profile 的配置 HMR 热挂载；刷新页面（强刷）加载客户端半。打开 设置 → 归档会话 即可使用。

使用

1. 在侧边栏会话菜单选择"归档会话"，会话从侧边栏隐藏。
2. 打开 设置 → 归档会话：
   • 取消归档：会话恢复到侧边栏的原始位置。
   • 删除：弹出确认对话框；确认后永久删除本地日志与关联附件（其他会话仍引用的附件对象会被保留），并从工作区记账中移除该会话。

架构

• Host 半（src/index.ts）：在共享 Web 服务上注册 GET/POST /__dsh-archived-sessions/{list,unarchive,delete}。删除流程：若会话处于打开状态则先 dispose 活动会话（让内存 store 移除它、持久化层退役其状态）→ 等待 write-behind flush 落盘日志 → 删除会话日志目录 → 解析日志中的附件引用（sha256:）→ 仅删除不再被任何其他会话引用的附件对象 → 通过 workspaceRegistry.unarchiveSession 清理归档集合。
• Client 半（src/client/）：注册 settings.section 分区"归档会话"；列表数据合并 remote.session 列表（含投影标题）与插件 host 接口（创建时间、日志大小）；两种变更操作都走插件 host 接口，因为核心 RPC 面不提供这两个操作。删除成功后，client 会重新拉取会话列表基线：删除冷会话（已持久化、当前未打开）不会触发 session/disposed，否则侧边栏会把这个残留行一直显示在未分组下，直到下次重连。

验证

本仓库没有测试框架；两个检查都是针对已构建产物的独立 Node 脚本，因此请先执行 pnpm run build。

pnpm run verify

• verify:delete：把 DSH_HOME 指向一次性目录，通过真实 HTTP socket 驱动 lib/index.js：列表返回带日志信息的行；删除会移除日志目录、只回收不再被任何存活会话引用的附件对象（共享对象必须保留）、清空归档集合，并返回完整成功；核心缺少 unarchiveSession 时降级为 partial 而非抛错。
• verify:client：用壳的冻结模块表桩执行 lib/client.js，然后挂载并渲染该分区。它专门捕捉曾经导致设置页白屏的那类故障：壳未导出的具名导入（例如已被移除的 IconTrashOutline16）会解析为 undefined，只在渲染时才抛错，而异常被插槽的错误边界吞掉，于是页面呈现为空白而不是响亮地失败。bundle 导入的每个名字都必须是壳 primitives 的真实导出。

社区与支持

• 欢迎通过 GitHub Discussions 提交反馈或 bug 报告。
• 本仓库已添加 dsh-plugin 话题，便于被发现。

许可证

MIT