Repository navigation
v0.32.0 · 自动注入:记忆能自己进到对话上下文了(补上「取」这一半)
[0.32.0] - 2026-10-26
自动注入:记忆能自己进到对话上下文了(补上「取」这一半)
问题:v0.31 及以前只解决了「存」——写入、加密、跨设备同步都通了;「取」却
全靠 agent 自觉:要么手动 membridge context "查询",要么它自己想起调用 MCP 工具。
真机表现就是「记忆明明在库里、在云盘上,agent 一开新对话就像失忆」。用户原话:
该注入的时候,为什么 agent 没有自动注入。
改动
- 新增
membridge hook:钩子模式。从 stdio 读宿主给的任务 JSON(prompt字段),
输出可直接并入上下文的文本块;--json输出hookSpecificOutput.additionalContext。 - 新增
membridge hook --warm预热:闲时/开机把「热度候选池 + 交接卡工作台」算好
落盘~/.membridge/inject-cache.json。这是唯一碰库和向量的路径。 - 新增
--install / --status / --uninstall:幂等把钩子接进本机检测到的宿主配置
(Claude Code / CodeBuddy / WorkBuddy 同一套 settings.json 格式)。只增自己那条
(命令含-m membridge hook),别人的钩子原样保留,写前自动备份配置文件。 --events session|prompt|both:注入时机可选——每个会话一次 / 每条消息 / 两者。
延迟(真机实测,Windows)
| 方案 | 每条消息 |
|---|---|
v0.31 手动 context(现场检索+向量) |
2.4–4.2s |
| v0.32 钩子读缓存 + 关键词过滤 | ≈1.1s,其中 ~0.9s 是 Python 解释器启动 |
缓存文件本身是毫秒级;剩下的开销是进程启动,不可避免——所以给出 --events session
(每会话只付一次)与 --events prompt 的取舍开关,且缓存缺失时立即返回空并在后台
detached 预热,绝不阻塞用户这条消息。
相关性(省 token 的第一道闸)
- 候选池按记忆桥既有的热度排序取(
heat.preload_candidates),不另造指标; - 匹配分:2 字词 1 分、3 字及以上 2 分,低于 2 分算噪音不注入("今天/这个"这类);
- 命中不到 → 只输出工作台;工作台也没有 → 一个字节都不输出(沉默契约原样保留);
- 交接卡不进候选池(工作台小节已恒定注入,避免重复占 token)。
测试:新增 tests/test_hook.py 6 例——缓存往返、相关性过滤(不相关的一条不许进)、
沉默契约、JSON 形状、幂等安装且不碰别人的钩子、卸载只摘自己那条。