Skip to content

core 0.2.1 —— 引擎支持 Bun(可在 opencode 里直接用)

Choose a tag to compare

@guoxing2024 guoxing2024 released this 18 Sep 10:10
· 14 commits to master since this release

一句话

引擎现在跑得起来在 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 是适配层的文档补丁)。