Repository navigation
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是适配层的文档补丁)。