会话记忆桥接GLFzr/dsh-hermes-memory-bridge

dsh-hermes-memory-bridge

把 DeepSeek Harness（DSH）的会话压缩总结，自动桥接进 Hermes Agent 的永久记忆。

DSH（DeepSeek Harness）是 DeepSeek 的开源 agent harness（"一切皆插件"），每个项目独立会话；Hermes Agent（Nous Research）是自带四层记忆与学习闭环的自进化 agent。本工具让两者互补：

- DSH 负责执行：项目级任务，会话压缩总结（）是天然的"项目快照"
- Hermes 负责记忆：MEMORY.md 常驻注入 + SQLite 全文检索，成为跨项目的全局记忆中枢
- 本桥接器负责搬运：发现 DSH 的新压缩总结 → 交给 Hermes 吸收，无需人工干预

架构

DSH 会话（多帧 zstd JSONL）
│  内置 dsh-compaction-basic 自动/手动触发压缩
▼
compaction/summary 事件（含  总结块）
│  watcher 每 60 秒轮询（bridge-state.json 去重）
▼
dsh-hermes-bridge.mjs
├─ mode=file：总结全文 → 项目 AGENTS.md「DSH 记忆总结」节
│              + 指针行 → Hermes MEMORY.md（2200 字符预算控制）
└─ mode=chat（推荐）：hermes -z 让 Hermes 自行蒸馏进记忆
（失败自动回退 file 模式，保证不丢）
▼
Hermes：MEMORY.md 蒸馏行 + 会话记录（session_search 可检索）
+ 项目 AGENTS.md 归档 → 下次会话自动注入，跨项目"记得"DSH 做过的一切

快速开始

依赖：Node.js ≥ 22.12（node:zlib 自带 zstd）、本机已安装 hermes CLI

单次扫描（调试）
node dsh-hermes-bridge.mjs --once --mode chat

常驻轮询（60s 间隔）
node dsh-hermes-bridge.mjs --daemon --mode chat

备选模式：不调用 hermes，纯文件路由（AGENTS.md + MEMORY.md 指针）
node dsh-hermes-bridge.mjs --daemon --mode file

配置（环境变量，全部可选）

| 变量 | 默认值 | 说明 |
|---|---|---|
| DSH_HOME | ~/.dsh | DSH 数据目录（会话在 $DSH_HOME/sessions） |
| HERMES_HOME | ~/.hermes | Hermes 数据目录 |
| HERMES_EXE | win32: $HERMES_HOME/hermes-agent/venv/Scripts/hermes.exe，其他: hermes | hermes 可执行文件 |
| HERMES_MEMORY | $HERMES_HOME/memories/MEMORY.md | Hermes 记忆文件 |
| BRIDGE_STATE | $DSH_HOME/bridge-state.json | 去重状态文件 |
| BRIDGE_LOCK | $DSH_HOME/bridge-daemon.lock | daemon 锁文件 |

三种模式（B / A / C）

| 模式 | 谁写记忆 | 用途 |
|---|---|---|
| B · file | 桥接器自己（全文进 AGENTS.md，指针进 MEMORY.md） | 手动/验证，无 LLM 开销 |
| A · watcher | 轮询自动化机制 | 与 B/C 组合使用 |
| C · chat（推荐） | Hermes 自己决定（蒸馏、修剪、归档） | 生产终态；MEMORY.md 满时 Hermes 会自我管理预算 |

工作原理细节

1. 会话解码：DSH 会话存档是"多帧 zstd"追加写（session.jsonl.zstd），按帧魔数拆分逐帧解压；也兼容明文 .jsonl
2. 事件提取：只认 type === "compaction/summary" 且带 data.summary 的事件，提取 text 块并剥掉  标签
3. 去重：(会话文件 + compactionId) 记录在 BRIDGE_STATE，重启不重放
4. 项目归属：从会话头事件的 cwd 字段定位工作区，各项目 AGENTS.md 独立维护（互不污染），每个项目保留最近 5 条
5. 失败安全：chat 调用失败自动回退 file 模式；单个事件异常不影响整轮扫描；daemon 用 PID 锁防重复实例；hermes 超时（240s）会杀掉整个进程树

测试与验证

仓库自带测试工具（均为合成事件，格式与 dsh-compaction-basic 写入 schema 一致）：

- make-test-event.mjs — 生成单个格式真实的压缩事件
- gen-deep-tests.mjs — 生成深度测试事件集（真实 zstd 帧 / 跨项目 / 回退 / 回读）
- scan-compactions.mjs — 只读扫描 DSH 会话里的压缩总结（不写任何东西）

已通过的验证路径：

| 测试 | 内容 | 结果 |
|---|---|---|
| T1 | 真实 zstd 多帧文件 + 追加帧 → 解码提取 | ✅ |
| T2 | 两个项目事件 → 各自 AGENTS.md 隔离 | ✅ |
| T3 | hermes 不可用 → 自动回退 file 模式 | ✅ |
| T4 | 吸收 → 全新 Hermes 会话回读测试标记（引用 MEMORY.md 与 AGENTS.md 两个来源） | ✅ |

已知限制

- Hermes MEMORY.md 官方上限 2200 字符；已满时 file 模式的指针行会跳过（chat 模式无此问题，Hermes 自己会修剪）
- hermes -z 每次吸收消耗一次 LLM 调用（本机默认 DeepSeek V4 Pro）
- DSH 为开发者预览版，会话存储格式未来可能变化

授权

MIT