dsh-archived-conversation
DeepSeek Harness (DSH) 的已归档对话管理器插件。它在 设置 → 已归档 中按项目分组列出所有已归档对话,并支持搜索、取消归档与删除。0.2.10 起同时支持 Web profile 与 Desktop 桌面端。
DSH 本身已经提供"归档"能力(在左侧会话树右键会话即可归档,归档后从工作区视图消失,记录写入 ~/.dsh/storages/workspace.json 的 archivedSessionIds)。但 DSH 目前没有已归档对话的管理界面,也没有"取消归档 / 删除已归档"的入口——本插件正是填补这一空缺。
功能
- 按项目分组:复用 DSH 的 workspace 信息,把已归档对话归到其所属项目下展示。
- 子代理会话族:主对话存在后代时显示可展开箭头;点击整行可查看完整子代理树。子项只读,取消归档与删除统一由主对话管理。
- 即时搜索:按对话标题、项目名或会话 ID 过滤已归档对话;搜索在浏览器本地完成,不会增加会话日志读取。
- 取消归档:把对话从
archivedSessionIds 移除,对话会回到原工作区的原位置。
- 删除:从工作区与会话注册表中移除,并删除磁盘上的会话目录(不可恢复);正在执行任务的会话会立即返回"已排队"回执,由后台队列在会话释放后自动完成删除。
- Web / Desktop 双端(0.2.10+):管理 API 挂载在 Connection 共享
/api 通道,不依赖 webServer 服务;web profile 走 webserver 桥,Desktop 走 Electron 字节管道,同一套设置页与 API 两端可用。
- OpenViking 删除联动(0.2.4+):删除已归档会话时,同步删除 OpenViking 中对应的会话原始记录(
dsh-<会话ID>,含未提炼内容);已提炼的长期记忆不受影响。
- 设置页每 20 秒自动刷新,窗口重新获得焦点时也会立即刷新。
OpenViking 删除联动(0.2.4+)
- 行为:删除确认弹窗会显示"将同时删除 OpenViking 中该会话的记录与未提炼内容";删除成功后,结果区展示 OpenViking 清理状态:
deleted → 已同步删除 OpenViking 会话记录queued → 清理暂时失败,已排队,下次 DSH 启动/设置页打开时自动重试skipped → 未配置 OpenViking,仅删除本地会话
- 失败兜底:有 OpenViking 凭证时,若删除请求失败(网络/服务异常),记录进本地待删队列
~/.dsh/runtime/dsh-archived-conversation/archived-conversation-ov-pending.json,在启动时、20 秒定时、设置页打开时自动补删直到成功(404 视为成功);失败持久保留,不阻塞本地删除。
- 未配置 OpenViking(读不到
OPENVIKING_* 环境变量或 ~/.openviking/ovcli.conf 的 api_key)→ 零联动:不删除、不排队、不报错。
- 开关:环境变量
DSH_ARCHIVED_CONVERSATION_OV_LINK(默认 true;设为 0 或 false 关闭联动与补删)。
- 凭证解析链(与
@openviking/dsh-memory-plugin 一致):OPENVIKING_URL/OPENVIKING_API_KEY/OPENVIKING_ACCOUNT/OPENVIKING_USER 环境变量 → ~/.openviking/ovcli.conf → 默认端点 http://127.0.0.1:1933。
- 边界:目标仅 OpenViking 会话子树(
DELETE /api/v1/sessions/dsh-<id>);memories/ 下已提炼记忆永不触碰。
实现要点
-
客户端:通过 settings.section 插槽注册"已归档"标签页,用 react.createElement 渲染(无 JSX、无打包);列表数据未变化时跳过重渲染,20 秒轮询与焦点刷新不产生多余 DOM 更新。
-
宿主端:顶层注入仅 workspaceRegistry;API 通过 scoped ctx.inject(["connection"]) 在共享 /api 通道注册精确 Fetch 路由(/api/archived-conversation/*)。web profile 由 webserver 桥承载(信任围栏与浏览器鉴权在路由之前施加),Desktop 由 Electron 主进程经字节管道送入同一 handler,两端共用一套代码,不再依赖 webServer 服务。
-
性能:
- 元数据读取走有界工作池(stat 并发上限 8,标题慢路径并发上限 2),大归档下不会淹没文件系统队列。
- 目录发现由一次全量
readdir 扫描代替"逐会话逐项目"探测;未命中的缓存按请求局部重试,新建/移动的日志仍能被发现。
- 持久化标题缓存(
mtimeMs:size 指纹校验、跨重启生效)命中时零日志读取——DSH 的 JSONL 后端没有 seek 钩子,即使只读尾部也要整解压 zstd 日志,慢路径仅在日志真实变化时运行。
- 热刷新只读 header 中标题缓存未命中的会话;并发
/list 请求共享同一次列表重建。
-
全程复用 DSH 既有服务,不解析会话文件内部格式:
ctx.workspaceRegistry —— 归档状态与项目归属的权威来源;归档状态改写排入其自身操作队列,不与 DSH 原生归档操作交错。ctx.sessionController.inspect —— 读取完整逻辑会话日志并折叠最后一条 session/title 事件(与 DSH 自身的"title"投影单元同逻辑;sessionQuery.readTitleSnapshots 对冷会话不可靠)。
-
可靠性(0.2.9+,0.2.11 增强):
- 标题缓存与两个待删队列均为原子写(临时文件 + rename,权限 0600,与 DSH 自身存储一致),崩溃不会截断文件;待删队列截断意味着静默丢失排队删除。
- 延迟删除清扫与 OpenViking 队列操作均走进程内单写者 promise 链,并发触发(20 秒定时、启动清扫、设置页快扫、手动删除入队)不会互相覆盖。
- 取消归档会同步撤销该会话族排队中的删除;残留清扫仅清"不在归档集合且既不活跃也未持有工作区槽位"的会话目录,活会话不受影响(0.2.11)。
- 删除因文件占用(如 Windows 锁)重试成功后,清扫会补齐全部收尾:OpenViking 联动、移除事件、rewind/review 快照与插件缓存清理(0.2.11)。
- 待删队列加载时按会话 ID 形状校验条目,损坏的队列文件无法把任意字符串引入递归删除(0.2.11)。
- AgentHandle 注册表改用
WeakRef,不会把已终结会话的整个对象图钉在内存里。
-
安全护栏:变更请求拒绝跨源 Origin(浏览器 fetch 总是携带 Origin;Desktop 管道的同应用请求不带 Origin,予以放行)并要求 JSON Content-Type;loopback 信任围栏由 webserver 桥 / Desktop 管道在上游施加。正在执行任务的会话立即返回排队回执,空闲但已挂起的会话在释放后立即删除。
-
自 0.2.10 开始 - 仅支持 DSH 0.1.5-rc.1 及之后版本。标题读取先走 sessionProjectionCache.cachedSnapshot(header) 零 I/O 快路径,未命中则调用 sessionController.inspect(id)(不再回退 sessionPersistence.inspect);不依赖 readFrom 的事件序号/日志偏移参数,该参数已分型为独立的 SessionLogOffset。
安装 / 更新
需要已安装 DeepSeek Harness,且 PATH 上有 pnpm(dsh plugin 会转调它)。
安装:
dsh plugin --profile web add dsh-archived-conversation@latest
若没有全局 dsh:
npx -y --package @deepseek-ai/dsh dsh plugin --profile web add dsh-archived-conversation@latest
更新已安装的插件:
dsh plugin --profile web update dsh-archived-conversation@latest
随后重启 dsh --profile web 并刷新页面。插件通过 dsh.bundle.patch 自动激活,无需手动编辑 cordis.patch.yml。本插件无原生构建脚本,不必 pnpm approve-builds。
若 pnpm 11 提示 minimum release age(版本发布不足 24 小时),改为钉死版本:
dsh plugin --profile web add dsh-archived-conversation@0.2.12
也可从 GitHub Release 安装预构建包(不走 npm):
dsh plugin --profile web add https://github.com/Li-canghai/dsh-archived-conversation/releases/latest/download/dsh-archived-conversation.tgz
使用
- 在左侧会话树右键任意会话 → 归档(由 DSH 原生提供)。
- 打开 设置 → 已归档:按项目查看已归档对话,或在搜索框中输入标题、项目名、会话 ID。
- 对搜索结果中的每个对话可:
- 取消归档 —— 主对话及已归档后代一起回到原工作区原位置。
- 删除 —— 按子级优先彻底移除主对话及完整子代理树(弹窗二次确认,不可恢复)。
子代理对话在本页不提供独立操作;直接对子项调用变更 API 会返回 HTTP 409,要求改由主对话统一管理。
API
所有路由挂载在共享 /api 通道,web 与 Desktop 同路径:
| 方法 | 路径 | 说明 |
|---|
| GET | /api/archived-conversation/ping | 探活 |
| GET | /api/archived-conversation/list | 按项目分组的已归档对话列表(附带排队删除状态) |
| POST | /api/archived-conversation/unarchive | 取消归档,JSON body { "id": "<会话ID>" } |
| POST | /api/archived-conversation/delete | 删除,JSON body { "id": "<会话ID>" } |
变更接口拒绝跨源 Origin 请求并要求 JSON Content-Type;loopback 信任围栏由 webserver 桥 / Desktop 管道在上游施加。删除请求对正在执行任务的会话立即返回 { queued: true } 回执;直接对子代理会话调用变更 API 会返回 HTTP 409,要求改由主对话统一管理。
目录结构
dsh-archived-conversation/
package.json # 声明 dsh.client.inject 与 dsh.bundle.patch
cordis.patch.yml # 插件行(由 bundle.patch 激活)
lib/index.js # 宿主端:API + 归档状态读写
lib/ov-delete.mjs # 宿主端:OpenViking 会话删除联动(凭证解析 + 待删队列补删)
lib/runtime-paths.mjs # 宿主端:运行目录与旧文件迁移
lib/client.js # 客户端:设置页"已归档"界面
README.md / LICENSE
验证
本插件无需构建步骤。安装到 live profile 后,在浏览器打开 设置 → 已归档 即可验证(web 与 Desktop 均可);宿主 API 探活:GET /api/archived-conversation/ping。
