# @godspeedai/cognate-store-memory 中文文档

规范地址：https://npmcn.com/package/%40godspeedai/cognate-store-memory/

版本：0\.10\.0
npm 元数据更新时间：2026-11-16T03:51:00.231Z
中文译文更新时间：2026-11-16T18:41:48.921Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40godspeedai/cognate-store-memory
原文对照：https://npmcn.com/package/%40godspeedai/cognate-store-memory/?lang=original
项目主页：https://github.com/GodSpeedAI/Cognate#readme
源码仓库：https://github.com/GodSpeedAI/Cognate

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：37.7 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2026-10-09T02:32:50.548Z
- 最新版本发布：2026-11-16T03:50:59.855Z
- 近 30 天下载量：3600（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：20（近 12 个月 20 个）

## 中文简介

具有与SQLite商店相同的语义学(测试,麻风跑步时间)的内相可持久.

## 安装

```sh
npm install @godspeedai/cognate-store-memory
```

也可以使用：`pnpm add @godspeedai/cognate-store-memory`、`yarn add @godspeedai/cognate-store-memory`、`bun add @godspeedai/cognate-store-memory`

## README

# @godspideai/cognate-store-memory (英语)

一个可观测语义与 [`@godspeedai/cognate-store-sqlite`](https://www.npmjs.com/package/@godspeedai/cognate-store-sqlite)数字 : 原子多部分承诺、乐观的货币、同能承诺、投影 检查点 内容处理器 以及有效载荷去除.

**何时使用此软件包 :** 测试,例子,和丢弃的原型。 万事俱备 进程内存 —— 没有东西能活过重启 —— 所以生产应用程序必须活过 进程需要 SQLite 存储。 两者执行相同 [`@godspeedai/cognate-events`](https://www.npmjs.com/package/@godspeedai/cognate-events) 存储 合同,所以一个应用软件可以在它们之间切换一行.

## 安装

```sh
bun add @godspeedai/cognate-store-memory
```

要求数 [阿宝](https://bun.sh/) >= 1.4.0.

## 快开始

```ts
import { createMemoryStore } from "@godspeedai/cognate-store-memory";

const store = createMemoryStore();

const outcome = await store.commit({
  idempotency: { scope: "alice:order", key: "order-1", fingerprint: "fp-1" },
  appends: [
    {
      streamId: "order-1",
      expectedVersion: 0,
      events: [
        {
          eventType: "order.placed",
          schemaVersion: 1,
          occurredAt: new Date().toISOString(),
          tenant: "tenant-a",
          correlationId: "corr-1",
          causationId: null,
          runId: null,
          scopeId: "root",
          payload: { sku: "widget", quantity: 2 },
        },
      ],
    },
  ],
  result: { placed: true },
});
// { kind: "committed", events: [...], records: [], result: { placed: true } }
```

把店递给 `createRuntime` 从 [`@godspeedai/cognate-runtime-bun`](https://www.npmjs.com/package/@godspeedai/cognate-runtime-bun) ephemeral runtime——快速创建,每个测试隔离:

```ts
const runtime = await createRuntime({ store: { store: createMemoryStore() } /* agents, policy, ... */ });
```

(运行时间) `store: ":memory:"` 快捷键是一个不同的存储—— SQLite 执行 运行一个从未写入文件的数据库。 同样的短暂,但与SQLite的 后有耐用配置. )

## 商店的担保

-   **原子决定.** 串行附件、记录书、发箱意图和一能结果 共同行动;失败在任何地方都看不到.
-   **乐观的货币.** 向 Stale 流版本投掷 `ConcurrencyError`· ; 一个 stale 记录的掷出 `RecordConflictError`几个赛车作家中就有一个赢了.
-   **引证无能.** 重复键返回记录的结果而不写入第二个事实; a 用不同请求的指纹丢出重用密钥 `IdempotencyMismatchError`。 。 。 .
-   **决取之令.** 读取以每个流序和全库位置返回,以及 key/id上市使用代码点顺序——与SQLite商店生产的顺序相同,所以重放 比较是存储独立的.
-   **释迦.** `erasePayload` 取消有效载荷,保存信封,并附上墓碑事件 页:1 `$erasures` 流线.

提交内容在内部序列化( 承诺队列), 因此并行 `commit` 要求解决一个问题 尽管API是Aync。 从商店返回的每个值都是深层副本 结果永远不会影响存储状态.

## 限制

-   **不执着.** 所有状态都活在进程内存中,并在进程退出时消失. 没有 `reopen`,没有耐久性,也没有备份故事——使用 [`@godspeedai/cognate-store-sqlite`](https://www.npmjs.com/package/@godspeedai/cognate-store-sqlite) 数据必须存活.
-   **单一过程.** 存储只存在于创建它的过程之内; 无法共享 跨过程或机器.

## 相关软件包

-   [`@godspeedai/cognate-events`](https://www.npmjs.com/package/@godspeedai/cognate-events) - 那个 存储合同,并装入该套件工具.
-   [`@godspeedai/cognate-store-sqlite`](https://www.npmjs.com/package/@godspeedai/cognate-store-sqlite) —— 说 长期执行同一合同.
-   [`@godspeedai/cognate`](https://www.npmjs.com/package/@godspeedai/cognate) - SDK伞; 最容易获得运行时间的方法(这家商店回溯到它的发光模式).

## 许可证

阿帕奇 - 2.0

## 常见问题

### @godspeedai/cognate-store-memory 是什么？

具有与SQLite商店相同的语义学\(测试,麻风跑步时间\)的内相可持久\.

### 如何安装 @godspeedai/cognate-store-memory？

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

### @godspeedai/cognate-store-memory 支持 TypeScript 吗？

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

### @godspeedai/cognate-store-memory 支持 ESM 还是 CommonJS？

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

### @godspeedai/cognate-store-memory 可以商用吗？

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

### @godspeedai/cognate-store-memory 的下载量有多少？

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

### @godspeedai/cognate-store-memory 还在维护吗？

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

