@godspeedai/cognate-store-sqlite

中文文档
0.10.0发布于 2026/11/16Apache-2.0ES Module构建来源已验证近 30 天下载 3652

Bun:sqlite上具有权威性的可持久性(第13节).

中文使用文档
文档目录6 节
  1. 安装
  2. 快开始
  3. 计划保证
  4. 限制
  5. 相关软件包
  6. 许可证

@godspideai/ cognate- store- sqlite (英语)

建立于 bun:sqlite一个 SQLite 文件持有应用程序的全部权威历史:事件、记录、一能结果, 和blobs ——在解剖上 每一个决定.

何时使用此软件包 : 任何必须幸存的 Cognate app 程序。 使用 @godspeedai/cognate-store-memory 测试和丢弃原型 两者执行相同 @godspeedai/cognate-events 商店合同,所以一个应用程序可以用一行来切换商店.

安装

bun add @godspeedai/cognate-store-sqlite

要求数 阿宝 >= 1.4.0 (商店使用Bun的内置) bun:sqlite) (中文(简体) ).

快开始

import { openSqliteStore } from "@godspeedai/cognate-store-sqlite";

const store = openSqliteStore({ path: "./app.sqlite" });

把店递给 createRuntime 从 @godspeedai/cognate-runtime-bun 使整个特工运行时间持久.. createRuntime 也直接接受文件路径 (单位:千美元)store: "./app.sqlite"),选择此商店:

import { createRuntime } from "@godspeedai/cognate-runtime-bun";

const runtime = await createRuntime({ store: "./app.sqlite" /* agents, policy, ... */ });

商店执行 DurableStore 合同来源 @godspeedai/cognate-events数字 : commit 应用每个决定的原子批量(流程附件与预期版本,记录) 比较和扫描写作、发包意向、一能结果) ConcurrencyError 被丢弃 当同时代的编剧输掉一个流版种族.

计划保证

每一个承诺的决定都是SQLite交易(BEGIN IMMEDIATE: 信封验证, 每流版本检查、记录比较和扫描书写、出箱意图和一能 录音成功或滚回一起。 重复的一等键返回原值 而不是重新适用该决定.

为正确度大于速度而配置可忽略性 : journal_mode=WAL 与 synchronous=FULL (对每项犯罪进行调查),因此,从未报告过任何犯罪 SQLite证实了这一点. 有效载荷去除覆盖已释放的页面( U)secure_delete和 检查WAL,所以被删除的内容 不再停留在侧车文件.

限制

  • 一个写作过程. 同时 commit 在一个过程中自然地序列化,但是 编写相同文件的多个进程会被击中 SQLITE_BUSY 5秒钟后 暂停 而不是被这家店连载.
  • 仔细退后. 复制 .sqlite 文件加其内容 -wal编号 :-shm 兄妹们只待 WAL 检查站(或使用 SQLite 的备份 API) – WAL 活动期间的赤拷贝可以丢失 承诺数据.

许可证

阿帕奇 - 2.0

版本与发布记录

@godspeedai/cognate-store-sqlite 共发布 20 个版本,首次发布于 2026/10/09;过去 12 个月发布了 20 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.10.0latest2026/11/16今天
0.9.22026/11/152 天前
0.9.12026/11/143 天前
0.9.02026/11/0610 天前
0.8.02026/10/2720 天前
0.7.12026/10/2523 天前

关于 @godspeedai/cognate-store-sqlite 的常见问题

@godspeedai/cognate-store-sqlite 是什么?

Bun:sqlite上具有权威性的可持久性(第13节).

如何安装 @godspeedai/cognate-store-sqlite?

在项目目录运行 npm install @godspeedai/cognate-store-sqlite,或使用 pnpm add / yarn add / bun add。

@godspeedai/cognate-store-sqlite 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/godspeedai__cognate-store-sqlite 是否存在。

@godspeedai/cognate-store-sqlite 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@godspeedai/cognate-store-sqlite 可以商用吗?

@godspeedai/cognate-store-sqlite 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@godspeedai/cognate-store-sqlite 的下载量有多少?

根据 npm 官方下载统计,@godspeedai/cognate-store-sqlite 在 2026/10/17 – 2026/11/15 这 30 天内被下载 3,652 次,日均约 122 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@godspeedai/cognate-store-sqlite 还在维护吗?

最新版本 0.10.0 发布于 2026/11/16(今天);至今共发布 20 个版本,其中过去 12 个月发布了 20 个;首次发布于 2026/10/09。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。