@happyqu/dsh-plugin-archive-explorer

一个 deepseek-harness 插件：在设置里新增「归档会话」页面，按 workspace 分组浏览、搜索、查看，并可重新加入或永久删除归档会话。

功能

• 按 workspace 分组 — 复用工作区注册表，按工作区归组，无归属的归入「未分组」
• 搜索 — 匹配标题、路径、会话 id、工作区名，以及消息正文（正文命中会显示片段预览）
• 点击查看 — 点击卡片弹出对话内容（用户 / 助手 / 工具消息，带序号与时间）
• 重新加入会话 — 从归档集合移除，会话回到侧边栏（不删日志）
• 彻底删除 — 永久删除该会话的日志目录（二次确认，不可恢复）

安装

dsh plugin --profile web add @happyqu/dsh-plugin-archive-explorer
dsh --profile web --dump-config
# 重启 dsh web

dsh plugin add 会安装依赖并将 bundle 加入 profile。包自带 cordis.patch.yml，会以 insert 的方式追加插件行；--dump-config 可确认该行已进入配置树。

本地开发可从插件目录运行 dsh plugin --profile web add .。

发布

npm test
npm pack --dry-run
npm login
npm publish --access public

发布前确认 npm 账户拥有 @happyqu scope 的发布权限。prepublishOnly 会在发布时再次运行测试。

测试

npm test

三个套件，都不需要启动 dsh：

• verify-encoding.mjs — 路径编码与 dsh-session-persistence-jsonl 逐字节比对 （含真实磁盘目录名 --D-happy-deepseek--）
• verify-host.mjs — 用模拟的 Cordis 上下文驱动 RPC 路由，并在真实文件系统上 验证删除、墓碑保留、记账摘除、以及 415/405/未知方法等错误路径
• verify-client.mjs — 用最小 React shim 载入 __ModuleLoader__ bundle， 断言 slot 注册、渲染文本、以及 RPC 坐标与 Host 一致

工作方式

隐藏机制：归档集合就是「隐藏标记」

工作区注册表的归档集合（archivedSessionIds）是本插件唯一可用的、由注册表拥有的隐藏手段：客户端 sessionVisible() 要求 !archived.has(id)，因此被归档的 id 不会出现在任何侧边栏表面（分组行、平铺行、「未分组」）。

因此「彻底删除」会保留该 id（墓碑），只删除日志文件与工作区记账。若把 id 一并移除，会话会同时变得「可见」且「未被记账」——这正是它会重新出现在「未分组」的原因。

代价是 workspace.json 里多留一个 id 字符串。日志已被删除，因此该 id 不会出现在界面列表中（界面按 persisted === true 过滤）。

删除流程

1. 若该会话有 agent 正在运行 → 拒绝（日志被占用且仍在写入）
2. 先写墓碑 — 此时会话仍可被解析，官方 archiveSession() 的存在性校验能通过；日志删除后该校验就无法通过了
3. 删除日志目录（node:fs/promises rm，失败重试 5 次）
4. 通过工作区实体的 detachSession() 摘除记账

先写墓碑的另一个好处：即使日志删除失败，会话也仍处于「已归档」状态（可用「重新加入」恢复），不会变成半删除状态。

性能

查看对话使用 readSession()，一次加载即可拿到带 payload 的完整日志。

不要用 listEvents() + 每个事件 readEvent()：readEvent() 内部会调用 corpus.load()，对冷会话意味着每个事件都重新读取、解压、解析并克隆整个日志，即 O(n²)。

目录结构

@happyqu/dsh-plugin-archive-explorer/
├── package.json          # dsh.bundle.patch + dsh.client.platform
├── cordis.patch.yml      # 插入插件行
└── lib/
    ├── index.js          # Host：RPC 端点 + 日志删除
    └── client.js         # Client：settings.section 页面

Host 与 Client 通过 Connection RPC 通信（connection.rpc.call / connection.fetch.register），端点 archive-explorer。

说明

• 路径编码（projectKey / encodeSegment）按 @deepseek-ai/dsh-session-persistence-jsonl 的实现镜像，用于定位日志目录
• connection 是可选注入：它只由 Web bundle 提供，静态 inject 会让本插件在 headless profile 中永久 pending，导致整个 profile 启动失败

License

MIT