Skip to content

Releases

0.4.0 —— 只做 V2:opencode 适配层换了一次宿主面,V1 面按裁决删除

Choose a tag to compare

@guoxing2024 guoxing2024 released this 07 Oct 08:39

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.mjs 34 项(工具注册与 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 与附注 tag v0.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 逐字节相同

Choose a tag to compare

@guoxing2024 guoxing2024 released this 06 Oct 15:31

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-memory 6 个(3 个代码),opencode-hippo-memory 4 个(1 个代码)。三枚的 package.json 与 0.3.2 只差 version 一个字段。
  • 引擎字节仍是 dist/memory.js 225,879 B / sha256-12 963693feee3b。

为什么号是 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 的每条出口都要读到它判的那个槽位

Choose a tag to compare

@guoxing2024 guoxing2024 released this 06 Oct 15:31

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.js 225,879 B / sha256-12 963693feee3b(memory.js.map 138,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)

Choose a tag to compare

@guoxing2024 guoxing2024 released this 24 Sep 16:41

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-memory settings 命名空间:改为导出 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(key dsh-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 误报订正

Choose a tag to compare

@guoxing2024 guoxing2024 released this 20 Sep 09:18

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 里直接用)

Choose a tag to compare

@guoxing2024 guoxing2024 released this 18 Sep 10:10

一句话

引擎现在跑得起来在 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:驱动上报、父目录自建、自定义驱动逃生口)。

文档

⚠️ 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 链接修正)

Choose a tag to compare

@guoxing2024 guoxing2024 released this 18 Sep 09:15

一句话

仅文档变更,无任何代码差异:包内 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 —— 抗幻觉大版本:纠正链 · 证据 · 投毒防护

Choose a tag to compare

@guoxing2024 guoxing2024 released this 18 Sep 09:15

一句话

把此前所有未发布的改动合并为一个大版本,并修掉了实测反馈里唯一会造成数据丢失的一类事故 —— 无 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%。

文档

提交:9dd39df — 28 files changed, +5406 / −538

core 0.1.6 + adapter 0.1.8 —— 召回可解释性

Choose a tag to compare

@guoxing2024 guoxing2024 released this 12 Sep 04:07

这次解决了什么

来自一位外部评审人的 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,adapter memory_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.8

47/47 测试通过(新增 10 项);npm 安装后已做功能冒烟验证。

Full Changelog: https://github.com/guoxing2024/hippo-memory/blob/master/CHANGELOG.md

HippoMemory v0.1.6 — 启动提速与 digest 修复

Choose a tag to compare

@guoxing2024 guoxing2024 released this 07 Sep 03:02

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)