Repository navigation
Releases
0.4.0 —— 只做 V2:opencode 适配层换了一次宿主面,V1 面按裁决删除
0.4.0 —— 只做 V2:opencode 适配层换了一次宿主面,V1 面按裁决删除
单发一枚:opencode-hippo-memory@0.4.0,取自 commit a757f0b(registry 的 gitHead 逐成员回读就是它)。npm 的 latest 现在指向 0.4.0。另外两枚不在这一版里:hippo-memory-core 与 dsh-hippo-memory 停在 0.3.3,两者的字节这一批一字未动——三枚包自此不再同号。
为什么发:触发的是宿主,不是我们
opencode 官方口径是 "V1 plugin implementations do not run in V2";本机读的是解包后的已发布 2.0.24 类型定义。裁决是路线 B:不在同一个包里养第二个入口,V1 那套 hooks 字典连同它的测试一起删掉。所以这一版记的不是"新增一枚能力",而是六个面各自换了一次宿主 API。
改了哪六个面
| 面 | V2 API |
|---|---|
| 入口 | export default { id, setup(ctx) };Plugin.define 在已发布的包里实测是 54 字节的恒等函数,所以运行期不 import 宿主 SDK |
| 4 个工具 | ctx.tool.transform(editor => editor.add(Tool.Info)),参数表换成裸 JSON Schema(ValueSchema 的第三支),zod 与 tool() 一起退场;可选 peer 从 @opencode-ai/plugin: ^1.18.31 换成 @opencode/plugin: ^2.0.24 |
| 每轮注入 | ctx.session.hook("context", ev => …),把纪律段与摘要块 push 进 ev.system——那是 SystemPart 对象,不再是 V1 的字符串数组 |
| 压缩保留 | ctx.session.hook("compaction", ev => …),只附 ev.system,不写 ev.result |
| 工具观测 | ctx.tool.hook("execute.after", ev => …);V2 的 ctx.app 没有 log 面,按官方 migrate 示例换 console.log |
| 空闲巡检 | ctx.event.subscribe({ signal }) 返回 AsyncIterable(V2 没有回调形态),自己起 for await 循环、在 Cleanup 里 abort |
三条语义上的变化值得单独讲:
- 注入的幂等性和 V1 是反的。V2 明写钩子的改动只影响这次发给模型的请求、不写回会话历史,所以每一次模型调用(含工具续轮的第二次请求)都要重新放一遍摘要;反过来,宿主若把同一个数组再交回来(重试会看到先前钩子的覆盖),我们按
SystemPart.metadata标记替换而不是再追加一份。V1 那套"同一轮只注入一次"的双钩子互斥标志在这个面上没有对应物,所以它连测试一起被删除,不是被移植。 - 库的键只取一次。V2 的
ToolContext里没有directory字段,按调用重键的结果是 A 项目的记忆回答 B 项目的问题,所以 store 从ctx.location.directory键一次。 - F5 那道边界照搬、形状换了。V1 读
definition.args,V2 读definition.input.properties;声明表取不到时仍直接透传,未声明的参数名一律拒并回显声明表。cue 改从ev.messages取(V2 形状{role, content:[{type:"text", text}]},V1 的info.parts已删)。
验证过什么
- 新测试
test/v2-plugin.test.mjs34 项(工具注册与 JSON Schema、注入幂等与替换、压缩、观测、错误兜底、F5 边界、store 键);V1 套件test/adapter.test.mjs随那个面一起删除。仓库套件 424 → 433(引擎 334 + DSH 65 + 本包 34),读数 433 / 433 / 0。引擎字节一字未动:dist/memory.js仍是 225,879 B / sha256 前 12 位963693feee3b,所以那 334 与 65 两项只是复跑。 - npm 侧不止"publish 返回 0":registry
latest逐成员回读为 0.4.0,gitHead指a757f0b,tarball 50,428 B、sha1 与发布时 npm 打印的 shasum 逐字相同,四枚成员与本地cmp全等。 master与附注 tagv0.4.0已推送,tag 剥开仍指向a757f0b(服务端 API 与git ls-remote两路回读同一对 sha)。
这一版没有证明的事(写在这里,不藏起来)
- 没有一台活的 opencode V2 宿主加载过这个插件。上面那 34 项跑在一台假宿主上;
import这个包不等于宿主自己的 plugin loader 认它。本机opencode plugin list回No plugins found,只有 V1 时代的 cache 目录里存着opencode-hippo-memory@0.3.0。这一条是本版最大的结构性缺口,装上之后的第一次真宿主对话轮仍欠着。 - 真宿主在
ev.messages里到底放什么,仍未在宿主上验过。 - "发完立刻装会拿不到包"不是包坏。npmjs 这一侧这次量到了:publish 返回 0 之后约 3 分钟内 12 次直取 packument 都读不到 0.4.0(
latest仍是 0.3.3),tarball 前 4 次直取 404、第 5 次才 200。桌面端那一侧走的是 npmmirror,它的延迟没量过(历史上 0.3.0 那次真装撞过一次ERR_PNPM_NO_MATCHING_VERSION)。 opencode plugin add把配置写在哪、V2 还吃不吃的.opencode/plugins/目录,本机都没量过;本包 README 安装一节里每条命令都标了它是--help实测还是按类型推的。
升级注意(这一版对 opencode 1.x 是破坏性的)
- opencode 2.x 用户请装 0.4.0 或更新;0.3.3 及更早是 V1 面,装上在 2.x 上什么都不会加载。
- opencode 1.x 用户自此不再受支持,请停在 0.3.3。这是路线 B 的代价,不是笔误。
- 依赖下限
hippo-memory-core@^0.3.2未动,因为移植不需要任何新引擎能力。装完核对引擎字节的 sha256 前 12 位 =963693feee3b。
功能与缺陷清单请看 v0.3.2 与 v0.3.3;随版发布的具名已知限制在 ROADMAP 在册。本版的移植细节与逐行落点在 本包 README 与 本包 CHANGELOG。
0.3.3 —— 只重发文档:代码成员与 0.3.2 逐字节相同
0.3.3 —— 只重发文档:代码成员与 0.3.2 逐字节相同
三枚同发:hippo-memory-core@0.3.3、dsh-hippo-memory@0.3.3、opencode-hippo-memory@0.3.3,取自 commit 16076a0(三枚的 registry gitHead 都是它)。latest 现在指向 0.3.3。
这一版没有任何行为改动。 它存在的唯一原因是:0.3.2 的 README / CHANGELOG 里带着一句写假的发布状态——"本地全绿 …… npm 未发布"(英文版 not yet on npm),那句话是在发布成功之前写下的。npm 不允许覆盖一个已经存在的版本号,所以只能发新的一枚。
改了什么
13 个文件:三份 package.json 的 version 字段,加 10 行文档文案,全部就地改写(不新增行,所以文档里所有 src/memory.ts:行号 的引用一格都没位移)。公开仓库里这 13 个文件之外没有任何改动,git diff v0.3.2 v0.3.3 在 src/ 下为空。
凭什么说"代码逐字节相同"
两次独立取证,都不是"我保证":
- 离线差分:先
npm pack出 0.3.3,再和已经解压的、registry 上当前 serving 的 0.3.2 逐成员比对 —— 65 项检查全过。 - registry 回读:直接从 npmjs 取回三枚 0.3.3 的 tarball,逐成员与 0.3.2 的发布件比、并与本地工作树比 —— 76 项检查全过。成员覆盖是结构化分类得出的(不是
.md也不是package.json的一律算代码成员),每枚包都断言"全部成员都被分类并比较过":core 26 个成员(22 个代码成员与 0.3.2 相同,3 个文档成员带清扫),dsh-hippo-memory6 个(3 个代码),opencode-hippo-memory4 个(1 个代码)。三枚的package.json与 0.3.2 只差version一个字段。 - 引擎字节仍是
dist/memory.js225,879 B / sha256-12963693feee3b。
为什么号是 0.3.3 而不是 0.3.2.1
0.3.2.1 不是合法的 semver。npm publish 在预检就拒(Invalid version: "0.3.2.1"),那枚从未上过 registry;而 npm pack 会静默接受它——所以"pack 检查通过"根本不能证明一个号可发布。0.3.2-1 是合法的预发布号,但预发布不会成为 latest,不是这里想要的效果。取 0.3.3 是为了让 latest 真的指向带正确状态句的那一枚。
这一版仍然没有证明的事
与 0.3.2 完全相同,一条都没变:
- 差分与回读都是字节层证明;没有任何一行引擎或适配层代码在这三枚发布件上执行过(套件跑的是工作树)。
- opencode 的 25 项测试从未对装机字节跑过,也没取过一次 opencode 宿主对话轮。
- 桌面 profile 在这次发版时未被触碰:它仍是手工暂存的那份字节,锁文件的重钉是发版链的下一步。
功能与缺陷清单请看 v0.3.2——那一页才是这一版内容的说明,包括随版发布的具名已知限制(RR1e / RR2e、逐字豁免、两条 P1、工具说明落差、同主体 belt 不管主语互换、ws/wss 一族、#5 保持 per-session、opencode 的 store 根与空 cue、sourceMonitor 的 fuzzy 层)。
升级注意
与 0.3.2 相同:三枚同批更新(适配层不检查引擎构建版本,旧配新会静默跑);dsh-hippo-memory 要求宿主 DSH >=0.1.7-0;hippo-memory-core 需要 Node >=22.5;opencode-hippo-memory 需要 Bun >=1.1。装完核对引擎字节的 sha256 前 12 位 = 963693feee3b。
0.3.2 —— 三枚同跳:verify 的每条出口都要读到它判的那个槽位
0.3.2 —— verify 的每一条出口都得读到它要判的那个槽位
三枚同跳:hippo-memory-core@0.3.2、dsh-hippo-memory@0.3.2、opencode-hippo-memory@0.3.2。2026-10-06 发布到 npm,发布取自 commit 15cf2de(registry 元数据里的 gitHead 就是它)。
代码与 0.3.3 逐字节相同。 0.3.3 只是把 README / CHANGELOG 里那句已经写假的发布状态重发了一次(npm 不允许覆盖一个已存在的号),改动清单见 v0.3.3。要读"这一版改了什么",就在这一页。
这一版在解决什么
memory_verify 是防幻觉的最后一道闸门。十二批复测交回的缺陷有一个共同形状:一条出口声称它读了什么,和它真正读的槽位,不是同一个。所以修法不在"加更多正则分支",而在把判据挪到槽位上、并给每条出口配上只在降级一侧生效的 belt。
- D1 越过召回线不再等于盖章:一条 yes 必须有锚,否则返回
weak_match: true,注以WEAK_MATCH:开头并给出实测的两个相似度。 - D2 前提否决扫整个过线候选集,而不是只看被选中的那一行。
- R1 中文断言里"值写错了"不再被当成"话题对上了"(判据在比较侧,不给解析器加中文系动词)。
- R2 矛盾出口也补了锚,锚点理由从布尔改成具名的
anchoredBy。 - R3 / R4 / R4b / R4c 标识符里的数字不再被读成"值的翻转";弱点最终定位在"两边是否各自私有"这条比较规则上,而不是分支表;
/\d/那版顺带废掉无数字 sha 的回归由同批收回。 - V1 值位第一次真正参与裁决——此前把
production换成一个不存在的词zzzqqq,裁决一个字都不变。新增按位置识别值槽的 belt(只会降级,不会升 y)。 - V2 那道 belt 的"前缀 ≥4 个实字符"门槛换成槽位判据 + 数量豁免:同一道门此前一侧漏进句首的真翻转、另一侧误伤 CJK 改写,两侧不可能靠调阈值同时修好。
- R7a / #64 并列连词与特定介词之后的数属于另一个参数,同数豁免不再跨过去豁免。
- R7b / R9 / R10 三字母值不再对 belt 隐身;
valueClash只做屈折词形还原;http/https、imaps/imap等七对按 pair 键抑制合并,不开词表。 - #65 / #65b 虚词作值时"空集合"不再被读成"值相同";组合值(
currently on→off、with→without)按完整有序词元序列比较,细化写法走严格子序列出口。 - 写路径 G4 / RR1 / G2 一句通说不再被"带前提的重述"原地窄化(两处退役站点都接了判据:闸门问"既有行是否声明了前提",不问"两笔是否逐字相同");混前提不合并。
- 读路径 RR2 / RR3 无前提行不得从支持席位上压过同主体的带键行("空真可比"不等于"高相关");
stale_support的注不再把读者指向一个空数组。 - 黑盒七条 F1–F5 / F4b(一份不读源码的报告):裸词写的前提进比较规则;关联行与反方行按被问的前提筛,note 不再对着无关的行说 "on this scope";
duplicates()认得出向量级重复;consolidated一词一义(list()那一侧原先是死字段);未声明参数返回明确拒绝而不是ok;无锚邻居不再拿relativeScore: 1。 - 适配层 A1:DSH 每轮自动注入用的 cue 此前恒为空串——检索从没按当前任务问过。
返回字段与文案的变化
新增或改义:weak_match、scope_conflicts、out_of_scope、具名的 anchoredBy、unknown argument(s) … — not declared, so nothing was read or written(并回显已声明的参数)。注里的不等式改用截断渲染,不再印出与自己数字相矛盾的 best similarity 0.54 < 0.54。
验证做到哪一步(如实)
- 套件 424 全绿 = 引擎 334 + DSH 65 + opencode 25(
# tests 424 / # pass 424 / # fail 0 / # cancelled 0)。 - 文档与注释里的源码行号引用有门禁逐处打开核对,这一版收口时 0 处失效。
- 引擎字节:
dist/memory.js225,879 B / sha256-12963693feee3b(memory.js.map138,945 /bfcadab3405d)。 - 每条修复的代价都是量出来的,不是推断的:会挡掉多少合法 yes、会不会把假矛盾换成假 yes,两个嵌入空间(哈希兜底与 bge)各跑一遍;RED 先行,先红后修,多处用减法复核证明某一臂确实承重。
- 活的 DSH 宿主里跑过真实的一轮:注入路径、四条
memory_*工具、裁决与注的取值都在宿主内量过。 - 仍未验证:opencode 的 25 项从未对装机字节跑过,也没取过一次 opencode 宿主对话轮;opencode 的
scope/verify_result透传只有包内测试与node --check。
随版发布的具名已知限制
2026-10-06 逐条裁决过,明确选择随版披露而不是折进这一版:
- RR1e:带键的既有行 + 无前提写入 + 不同值,这个反向窄化仍会覆盖。裁决为诊断口径问题——机器可读的判定是对的,歧义在席位字段的含义。
- RR2e:同主体、不同值的无前提行可以被锚住,因此按 RR2 的判它仍能保住席位;同样是判定正确、归因不准。
- 逐字豁免按裁决保留,它比 D2 的口径更窄——这是选择,不是疏漏。
- 两条 P1:召回排序不看锚点强度;
eligible把无锚噪声计在阈值之上(threshold 一字未动)。 - 工具说明的一处落差:两枚
memory_verify的描述承诺了一个scope_conflicts列表,而引擎在三条out_of_scope出口里的两条上把它留空。 - 同主体 belt 不管主语互换(round-13 Blocker 2,bge 侧):主语与值同时移动时没有单槽 belt 会触发。
ws/wss、ap south/on south,以及刻意保留的at/to/with一族仍会盖章;都各有格子,都还没有写死的夹具。- #5 保持 per-session:同一台机器上跨会话的 store key 不改
sharedStore默认值,也不做一次性合并迁移(产品裁决)。 - opencode 适配层的 store 根依赖环境变量(
XDG_CACHE_HOME→%LOCALAPPDATA%\opencode\hippo-memory→~/.cache/opencode/hippo-memory),同一项目可能因此分裂成两个库;opencode 丢弃插件时不写日志。 - opencode 的 digest cue 在它偏好的那条路径上按构造恒为空(与 A1 同族,记录 A1 时顺手量到的,本版未修)。
sourceMonitor的 fuzzy 层:逐字重述那条路径故意不设护栏。
升级注意
- 三枚请同批更新。两枚适配层的引擎下限都是
hippo-memory-core@^0.3.2,但包管理器不会拦下错配的组合——旧适配层配新引擎(或反之)会静默跑起来,而两侧的语义在这一版是耦合的。 - 适配层之间不可互换。
dsh-hippo-memory要求宿主 DSH>=0.1.7-0(这个下界含 alpha;裸写>=0.1.7会把它排除掉);更老的宿主请留在dsh-hippo-memory@0.3.0。 hippo-memory-core需要 Node>=22.5;opencode-hippo-memory需要 Bun>=1.1。- 装完之后请用引擎字节的 sha256 前 12 位核对
963693feee3b——它同时证明"装到的字节 = 验过的字节"。
完整改动明细与每一轮的取证过程在仓库的 CHANGELOG.md 与 ROADMAP.md。
0.3.1 —— dsh-hippo-memory 单发:跟上 DSH 0.1.7 的配置接口(引擎与 opencode 适配层仍 0.3.0)
hippo-memory dsh-hippo-memory 0.3.1 —— 跟上 DSH 0.1.7 的配置接口
只发 DSH 适配层:dsh-hippo-memory@0.3.1。引擎 hippo-memory-core 与 opencode-hippo-memory 没有跳号,仍在 0.3.0,本包的依赖下限也仍是 hippo-memory-core@^0.3.0(本版没有任何引擎改动)。
DSH 0.1.7 删掉了 settings.register() 与客户端的 settingsScope。旧版插件在 0.1.7 上不是"设置页少一格",而是挂载时抛 TypeError: settings.register is not a function,把整个插件带走——四个 memory_* 工具全部消失,启动日志报错。本版迁到宿主的新配置面。
宿主半侧:改用 volatile Config
- 不再注册
hippo-memorysettings 命名空间:改为导出Config = z.object({...}),五个字段全部.volatile()。命名空间由 profile 条目 id(hippo-memory)推导,插件自身不注册任何东西。 - 生效配置从 Loader 交来的引用
config.<field>.get()现读;引用缺失或宿主给的是裸值时回落到 schema 自己的meta.default,不再抛错。默认值只写在 schema 一处,插件与配置面不可能各说一套。 - 热更新改用
ctx.on('loader/volatile-update')(替换原sectionScope.watch())。监听器在stores/lastSig/setEnabled等状态声明之后才注册:cordis 的 emit 是同步的,挂载期间到达的更新若早于状态初始化会踩 temporal dead zone 而中止整个插件。
浏览器半侧:改用 configForms + 插件页槽位
ctx.configForms.get('hippo-memory')+ctx.configForms.whileServed(...),配置页槽位从settings.plugin.item换成插件页的plugins.row.config(keydsh-hippo-memory#hippo-memory)。宿主没服务这个条目时页面上不留痕迹,而不是报错。- GUI 入口从「设置 → 插件 → 插件配置」移到 插件 → dsh-hippo-memory 包 → hippo-memory 行。
- 一行摘要里不允许出现控件,故原来的手风琴卡片头/箭头删除,进入即展开:宿主按
view: 'summary'/view: 'page'各渲染一次,只有 page 那一次是交互的。 - 配置页现在会跟随宿主的表单重绘(订阅
scope.subscribe)——之前别处保存过、或 Loader 提交了新 revision,页面会停在首次渲染的内容上。保存仍是一次带 revision 围栏的mutate(ops, expectedRevision),围栏取"本批第一处草稿落定时"的 revision;被拒绝的写入保留草稿,不吞掉用户输入。
谁该升 / 谁该留
- 宿主 DSH ≥ 0.1.7:升。
engines.dsh已提到>=0.1.7-0(-0让 0.1.7 的 prerelease 也算满足)。 - 宿主 不到 0.1.7:停在
dsh-hippo-memory@0.3.0(.volatile()在更早的 schemastery 上不存在)。注意 DSH 的加载器并不强制engines,装错了不会被拦下。 - opencode 用户与本引擎版本无关,无需动作。
验证状态(如实说明)
- 测试:本包 53 项全绿(35 适配层 + 10 新增浏览器卡片 + 8 新增宿主配置契约),仓库 233 项全绿(引擎 163 + DSH 53 + opencode 17)。
- 启动验证:
dsh --profile web启动无本插件报错(旧版就是在这一步挂掉),dsh-hippo-memory/client.js进入浏览器 bundle 清单,被服务的那份 bundle 含configForms/plugins.row.config且settingsScope为零。 - 尚未人工验证:在真实配置页上改一次并保存、以及真实对话里跑一轮
memory_recall。这两项还没有执行过,本版不声称它们通过。
完整变更记录见 packages/dsh-hippo-memory/CHANGELOG.md,使用说明见 docs/USER-GUIDE.zh-CN.md。
0.3.0 —— core + dsh + opencode 三包同步:前提作用域 scope · 重复合并 · 兜底提示 · 库分裂可见 · fuzzy 误报订正
hippo-memory 0.3.0 —— 把"看起来没有"和"其实不是那样"分开
五组改动同源于外部实测反馈。三个包已同步发布到 npm:hippo-memory-core@0.3.0、dsh-hippo-memory@0.3.0、opencode-hippo-memory@0.3.0。
- ① 前提作用域
scope:同一句话在不同口径下真假相反时,一行扁平摘要会把两次结论折成一条,verify于是拿旧口径的答案给新口径的问题盖章。现在记忆可以声明自己成立的前提(scope: "population=…; comparator=…")。判定纯结构化、不新增相似度阈值:前提冲突的写入不覆盖、不合并,各存自己的痕迹(different-scope:警告);sourceMonitor(claim, { scope })冲突时答OUT_OF_SCOPE,前提没被核对时注记CONDITIONAL SCOPE;recall(cue, { scope })对前提冲突的行硬过滤并回scopeExcluded。旧库走ensureColumns()自动补列,无需迁移。 - ② 重复可以合并了(
mergeDuplicates/memory_maintain merge):以前duplicates只能看一眼再手动delete(连版本历史一起删)。现在预览 → 落地一步到位,多余行折叠进幸存行(还在库里、默认召回不出现、undemote可恢复)。两种前提下的同一句话不算重复:duplicates()每组带mixedPremises,merge永不折冲突行。 - ③ 门槛没过也不再空白:召回全部低于门槛时,过去只回一句"没有相关记忆",与"库里根本没东西"同形。现在最接近的那条会以第 1 行 +
[low-confidence sim … < floor …]给出,明确它不是记忆、断言前须复查,也不借用[VERIFIED]/[ASSERTED]。零命中时不再回填[recent]装样子。diagnostics().coverage记录本进程的turns / misses / guesses。 - ④
status看得见隔壁那个库:DSH 按 agent id 分库、opencode 按项目目录分库,于是"没记住"与"记在另一个文件里"在输出上完全同形。diagnostics()现在带sibling_stores与scope_rule;两家status各加path_rule,health第一件事就是判"本库空、隔壁满"。 - ⑤ fuzzy 归档误报订正 + 适配层透传补齐:
sourceMonitor的模糊归档匹配此前只按余弦收录,一个自身值翻转过、又与 claim 有词面重叠的无关主体会被误置contested/stale_support;现要求该归档行与支持行共享实体才纳入,exact 复述层不受影响。适配层补齐两处:memory_recall透传scope并回scopeExcluded、memory_remember回显verify_result/verified_at。
适配层提示
- 两个适配层的
hippo-memory-core底线已抬到^0.3.0,必须一起升级,否则scope会被静默忽略。 dsh-hippo-memory是 DSH 专属、opencode-hippo-memory是 opencode 专属,两者不通用,别装错宿主。
验证状态(如实说明)
- 测试:引擎 163 / DSH 35 / opencode 17 全绿(共 215)。
- DSH 适配层的第二波改动(
scope透传、verify_result回显)已由作者手工在真实 DSH 会话里 10/10 验证通过。 - opencode 适配层的同名改动只做了
node --check与包内测试,尚未在真实 opencode 宿主里跑过一轮对话验证。 - 已知真实缺陷(未修):opencode 适配层的 store 根目录依赖环境(
XDG_CACHE_HOME,Windows 上%LOCALAPPDATA%\opencode\hippo-memory,否则~/.cache/opencode/hippo-memory),同一个项目可能落到两个不同的库。
完整变更记录见 CHANGELOG.md,使用说明见 docs/USER-GUIDE.zh-CN.md。
core 0.2.1 —— 引擎支持 Bun(可在 opencode 里直接用)
一句话
引擎现在跑得起来在 Bun 上 —— 也就是能在 opencode 里用了。
此前 hippo-memory-core 静态 import { DatabaseSync } from 'node:sqlite',这在加载期就把自己锁死在 Node ≥ 22.5。opencode 内嵌的是 Bun 1.3.14(node:sqlite 要 Bun 1.4 才有),于是导入直接报 No such built-in module: node:sqlite —— 加载期错误,catch 不到,不打包也没法打垫片。
改了什么
- 运行时驱动探测(新文件
src/sqlite-runtime.ts):Node 走node:sqlite,Bun 走bun:sqlite;通过createRequire/process.getBuiltinModule惰性加载,模块图里不再出现当前运行时解析不了的说明符 ⇒ 导入永不抛错,只有真正开库才会报错(且信息里写清该升级什么)。 - Bun 适配:
bun:sqlite的Database包装成DatabaseSync的最小同构面(exec/prepare/close,语句对象自带run/get/all,prepare()自带语句缓存)。Bun ≥ 1.4 实现了node:sqlite,届时自动改走 Node 驱动。 - 新导出:
sqliteDriver('node:sqlite'|'bun:sqlite')、setSqliteDriver(ctor)(自备适配器 / 测试替身)、DatabaseCtorRef,以及SqliteStatementLike/SqliteDatabaseLike/SqliteDatabaseCtor类型。 - store 自建父目录:两个驱动在父目录不存在时都只报
unable to open database file(新项目 / 新宿主首次运行的坑),现在开库自动mkdir -p。
实测(真实 npm 包,无打包、无垫片)
opencode 1.18.31 / Bun 1.3.14:
import("hippo-memory-core") -> driver=bun:sqlite
remember -> new / override(旧版归档 + 指名警告)
recall -> 命中 mysql(sim 0.733)
verify -> superseded_matches=[postgres]
digest -> [memory data …] 数据框架正常
兼容性
- Node 侧零影响:
sqliteDriver在 Node 上仍是'node:sqlite',引擎行为、数据格式、阈值、API 全部未变,旧库零迁移。 - 测试:140 项全绿(含新增
test/runtime-binding.test.mjs:驱动上报、父目录自建、自定义驱动逃生口)。
文档
- 📘 使用说明 · 新增第 14 节:在 opencode 里用(为什么之前不行、怎么确认引擎活着、手写插件示例、opencode 钩子速查)
- 🏗 架构 · 运行时绑定
- 📋 完整变更 CHANGELOG
⚠️ DSH 插件dsh-hippo-memory依旧不能装到 opencode —— 适配层是宿主专属的。面向 opencode 的适配包opencode-hippo-memory正在本仓库packages/下开发(见 ROADMAP)。
提交:
85dda22| 说明:本仓库 tag 仍按发布顺序编号,v0.2.2即 core 0.2.1(v0.2.1是适配层的文档补丁)。
adapter 0.2.1 —— 文档补丁(README 链接修正)
一句话
仅文档变更,无任何代码差异:包内 README 的完整使用说明链接改为 GitHub 绝对地址(npm 页面上 ../../docs/… 这类相对路径无法解析)。
| 包 | 版本 | 说明 |
|---|---|---|
dsh-hippo-memory |
0.2.1 | 与 0.2.0 的唯一差异是 README 里一个链接 |
hippo-memory-core |
0.2.0 | 无变化 |
提交:
18a3ff2
core 0.2.0 + adapter 0.2.0 —— 抗幻觉大版本:纠正链 · 证据 · 投毒防护
一句话
把此前所有未发布的改动合并为一个大版本,并修掉了实测反馈里唯一会造成数据丢失的一类事故 —— 无 warning 的静默覆盖。引擎与适配层同步发布。
| 包 | 版本 | 安装 / 升级 |
|---|---|---|
hippo-memory-core |
0.2.0 | npm i hippo-memory-core@0.2.0 |
dsh-hippo-memory |
0.2.0(随后 0.2.1 为文档补丁) | dsh plugin --profile web update dsh-hippo-memory |
本版做了什么
1. 纠正链:裁决不再只看一行
memory_verify/sourceMonitor除三值裁决外,返回四组邻域证据:contradicting[](同主题反着说的行)、newer_related[](换了措辞的更新结论)、superseded_matches[](被显式退役的行)、stale_support(支持依据已不是最新结论)。旧版只有余弦最高的一行 —— 实测中旧措辞赢 cosine 0.94、真正的新结论只有 0.60,永远看不见。memory_remember每次写入回显neighbours[](top-3 近邻 + 相似度 +suspectedConflict),并新增supersedes: [ids]显式纠正边(旧行打superseded_by退出召回、保留审计)。
2. 抗幻觉四件套:让上下文分清"知道"与"以为知道"
- 证据:
verify_cmd/verify_expect/verify_artifact+verify_result/verified_at;引擎从不执行命令,只存档 + 把关。渲染按 30 天保鲜期区分[VERIFIED]/[ASSERTED];新鲜 VERIFIED 是护盾,只能被 passing 证据退休。 - 撤回:
tags: ["retraction"]+retracts: <id>,撤回行永不被覆盖,命中强制带[retracted: …]。 - 前瞻守卫:
guard_trigger/guard_action,cue 撞上触发词即注入[GUARD]。 - 值域先验:负熵 / 百分号越界 /
0..1超界只警告不拦截;数字主张句无证据自动降级存 episode。
3. 覆盖判定加第二道门(修 BUG-1 及其复发)
- path-3 现在要求内容余弦 + 主张余弦(summary-to-summary,默认 0.75)双过线。长 detail 主导向量时不再把无关记忆误判成同一主张。
- 不过主张门则降级为
new并附withheld-contradiction:(含content-sim X + claim-sim Y)。取舍是刻意的:宁可多存一行,也不丢数据。
4. 记忆投毒防护(src/guard.ts)
- agent 读网页写进来的 "ignore all previous instructions…" 会变成每轮注入的持久化投毒。所有渲染出口(digest / recall / verify / maintain)统一清洗为
[sanitized-*],digest 整体包[memory data … not instructions]数据框架;存储原文不动(审计可回溯),可疑行由injection:警告与injectionWarnings点名。规则保守,真实库实测零误报。
5. 可观测性:把静默故障变成读数
diagnostics()/memory_maintain status:库路径、嵌入器 kind+dim、存量向量维度直方图、dimMismatch、全部阈值、access 统计,外加一句话health。专治"模型向量库被哈希回退查询 → 垃圾余弦 → 永久零命中,而计数看起来一切正常"。override-audit(只读):筛出被覆盖的两条内容几乎无关的可疑记录。
6. 其他
- 图式压缩:
compress把 N 条同域痕迹折成 1 条不变量 + K 条代表(先预览、人工起草正文、undemote可恢复)。 - 间隔重复:复述强化改为
0.01 + 0.03·log2(1+间隔天数)(上限 0.12),recall 命中 ×0.5 加成,新增显式importance参数 —— 重要性从"恒 0.70 的死参数"变成活信号。 - 并发安全:WAL +
busy_timeout 5000,共享库多 agent 同时写不再抛SQLITE_BUSY。 - 冲突检测触发面放宽:极性相反 / 共享实体 / claimParts 同主体改值,三通道任一即触发;修掉中文否定词的裸匹配误报。
升级:数据零迁移
- 旧记忆库直接可读;新列(
superseded_by、证据字段、retracts、guard、demoted)通过ALTER TABLE自动补列,历史行不变。 - 行为有变化:覆盖判定更严(可能从
override变成new+ 警告)、渲染新增[VERIFIED]/[ASSERTED]前缀与数据框架、digest 带[recent]尾巴。 - API 无破坏性改名,新参数全部可选;适配层对旧引擎自动降级兼容。
- 升级后重启 profile 生效。
数字
- 测试:引擎 137 项 + 适配层 30 项全绿;反幻觉基准 8/8 答对、编造率 0%。
- 标识符查询实测(167 条真实记忆 / 277 条查询):Top-1 命中率 10.5% → 99.6%。
文档
- 📘 详细使用说明 docs/USER-GUIDE.zh-CN.md(设置项逐条、对话模板、十种场景话术、16 条 FAQ)
- 🏗 架构 docs/ARCHITECTURE.md(数据模型、写入/读取路径、双口径门设计、神经科学映射)
- 📋 完整变更 CHANGELOG.md
提交:
9dd39df— 28 files changed, +5406 / −538
core 0.1.6 + adapter 0.1.8 —— 召回可解释性
这次解决了什么
来自一位外部评审人的 7 条召回质量建议,逐条在真实生产库(167 条记忆)+ bge-small-zh-v1.5 实测后采纳 6 条、驳回 1 条,并顺带修了两个真 bug。
召回可解释性(adapter memory_recall / core recall())
- 空结果不再是黑箱:返回
reason(below-threshold有相关记忆但没过门槛 /no-candidates库里没有或全被筛掉 /empty-cue)、eligible、bestSimilarity、threshold、nearMisses(最接近的几条) - 三个分数分开看:
similarity(原始余弦,与阈值、与memory_verify同口径)、score(含重要性加权sim × (0.6 + 0.4·importance),上限 1.0)、relativeScore(本次查询内相对分,1.0 = 最佳)。此前只给score,出现过 "verify 0.604 / recall 0.449" 的误判——那是口径差异,不是能力差异 - 标识符精确命中:query 与记忆共享
0x…/D-387/ commit sha / 版本号时,即使余弦低于门槛也召回,标literalMatch。生产库 277 条标识符查询实测:Top-1 命中率 10.5% → 99.6%,MRR 0.195 → 0.998 - 默认条数 5 → 8(上限 20)
其他
memory_maintain duplicates:只读报告近似重复记忆(跨 kind 比对,忽略FACT:前缀与大小写/标点差异),不删任何数据,确认后用delete清理memory_remember覆盖时返回superseded(被替换的 id / 版本 / 摘要 / 恢复方式),版本化覆盖不再静默- 懒打开 + 空库清理(core
createFile: false/pruneEmptyStores,adaptermemory_maintain prune+ 启动后台清理):只读访问不再堆积空库文件(实测此前一天新增 35 个、24 个为空) - 默认阈值文档勘误:0.4 → 0.32(0.1.0 起的实际默认值)
修复
- 跨类型合并漏判(17 对重复的根因):consolidate 把 episode 抽象成规则时写
FACT: <原文>,而合并比对未剥离前缀,导致同一事实长期两份并存。现统一剥离后比对,重述正确并入原记忆 - adapter 依赖从
^0.1.0收紧到^0.1.6(新字段与新动作依赖该版本)
驳回的建议(有据)
- 「
memory_verify适合作为首选召回入口」——它只取单条最佳 1-NN、不含重要性加权、无 provenance 列表,是断言前的是非裁决而非检索器;观察到的分差是口径不同,已用similarity字段消除歧义 - 长度惩罚——实测长度分布 min 36 / p50 84 / max 333,长摘要非主流,无证据支持
升级
dsh plugin --profile web add dsh-hippo-memory@0.1.847/47 测试通过(新增 10 项);npm 安装后已做功能冒烟验证。
Full Changelog: https://github.com/guoxing2024/hippo-memory/blob/master/CHANGELOG.md
HippoMemory v0.1.6 — 启动提速与 digest 修复
v0.1.6 — 启动提速 + digest 永不空白 + 收尾自提醒 + delete(2026-09-07)
Changed
- 启动懒加载:embedding 模型预热移出
dsh web启动路径(apply 3ms);首次对话渲染才后台加载——启动显著提速,GLib/libvips 噪音推迟到首次对话 - digest 空白修复:同 cue 空结果允许重查;无内容时显示记忆数 fallback(永不空白)
- 读取保障:recall/verify 先确保模型 ready(带超时,回退哈希),不再静默返回空结果
Added
- B 收尾自提醒:digest 命中时附一句"本轮有持久结论请用 memory_remember 写入",减少该记不记
memory_maintain delete:按 id 永久删除记忆(含历史)
验证
- 33/33 测试全过(引擎 22 + 适配器 11)
- 真实 web 实测:digest 全链路(记忆注入 + 提醒句)、delete 实战删除成功
- 引擎配套 hippo-memory-core 0.1.4(空 cue 兜底 + delete API)