# @ai-matrx/content-ir 中文文档

规范地址：https://npmcn.com/package/%40ai-matrx/content-ir/

版本：0\.24\.50
npm 元数据更新时间：2026-10-30T12:00:14.376Z
中文译文更新时间：2026-11-05T18:19:11.229Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40ai-matrx/content-ir
原文对照：https://npmcn.com/package/%40ai-matrx/content-ir/?lang=original
项目主页：https://github.com/AI-Matrix-Engine/aidream/tree/main/apps/shared/content-ir-core#readme
源码仓库：https://github.com/AI-Matrix-Engine/aidream

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

- 包体积（解压后）：8.8 MB，184 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：6 个
- peer 依赖：react \>=19\.0\.0
- 首次发布：2026-08-22T23:27:48.349Z
- 最新版本发布：2026-10-30T12:00:14.138Z
- 近 30 天下载量：81244（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：132（近 12 个月 132 个）

## 中文简介

AI Matrx Content IR包:纯解析器,正版信封,会话,计划转换和验证内核,外加React渲染层(kind routing,组件解析器,指令,kind kidg)作为单独的分节.

## 安装

```sh
npm install @ai-matrx/content-ir
```

也可以使用：`pnpm add @ai-matrx/content-ir`、`yarn add @ai-matrx/content-ir`、`bun add @ai-matrx/content-ir`

## README

# @ai-matrx/内容-ir

AI Matrx应用程序所使用的框架独立内容IR内核. 它将分流或完整的结构化内容分解成条形信封,管理递增的剖析会话,转换等同的策略,并进行结构验证.

```bash
pnpm add @ai-matrx/content-ir
```

## 入境点

根导出是完整的表面,永远是. 由于每个内部区域都有0.10.0可以单独解决——更喜欢这些,所以只读取有线合同的消费者从不拉出解析器(或 `ajv`输入其图表.

| 导入 | 它所持有的 |
| --- | --- |
| `@ai-matrx/content-ir` | 下面的一切 |
| `@ai-matrx/content-ir/core` | IR 类型 + 树、 JSON 符号化器、 类型解析器、快照、 常态化、 指纹、 歧义化器、 信封读取/ 值/ 缓存、 区域、 方案结构 |
| `@ai-matrx/content-ir/session` | `ParseSession` 以及一人写作的登记簿 |
| `@ai-matrx/content-ir/registry` | 类型登记类型、存储转换、双门、, `createKindValidator` 超过主机 `SchemaSourcePort` |
| `@ai-matrx/content-ir/convert` | 类型 JSON Schema, OpenAI 结构化输出转换器 |
| `@ai-matrx/content-ir/wire` | 部分实物活动、运行时间包装阅读器、发射有效载荷 |
| `@ai-matrx/content-ir/directives` | Kind 指令: sult 语法, one 解码器 |
| `@ai-matrx/content-ir/source` | 相抵- 保存源代码化器, 相接保存 + 锁定- 映射变化集, 单美元数学规则 |

```ts
import { createKindStreamParser, envelopeFromCompleteValue } from "@ai-matrx/content-ir/core";
import { validateStructuralLeg } from "@ai-matrx/content-ir/registry";
import {
  readPartialKindEvent,
  makePartialKindStalenessGate,
  rehydrateNodeOutcome,
  rehydrateRunResult,
  withRootKind,
} from "@ai-matrx/content-ir/wire";
```

## 读取信封 : `kindState`永远 `kind` 一个人

`root.kind` 实值 **保留** 当有效载荷失败时 `flashcard_set` 保留a `flashcard_set` 所以,你可以说什么破了. `root.status` 仅报告解析完成。 有效性信号是 `root.kindState`数字 :

-   `"resolved"` ——打字消费者唯一可以采取行动的状态.
-   `"unverified"` ——该类没有注册计划,所以从未检查过;它仍然通向它的部件.
-   `"raw"` 编号 : `"pending_*"` 编号 : `"speculative"` ——不作为打出的数据消耗.

该软件包没有浏览器, React 运行时间,应用程序存储,数据库客户端,路由,或渲染器依赖性. `ajv` 是它唯一的运行时间依赖。 特定主机的登记册获取、组件汇编、渲染和错误捕捉仍然是围绕这个内核的适配器.

## `/source` 流出模式:“解决”承诺

`tokenizeSource(text)` 读取所存储的文本; `tokenizeSource(prefix, { streaming: true })` 读到一个消息 仍然到达。 在流模式中, 下个字节可以包含的任何内容 仍保留更改为普通道词( 打开最后一行, 未关闭代码) 跨度, a `$$` 仍可相配的脚注, 在下面仍然形成的框画树可声称其根标签,a 以可能仍会溶解的块来缩短段落,.), 这样 **报告的一个岛屿 `complete` 是完成文本的岛屿** 与 一个记录在案的例外:

-   **晚期的孤儿推理更接近.** 模型确实释放出更紧密的推理(即 `<thinking>` 打开器在上游丢失)。 当a `</thinking>` 编号 : `</think>` 编号 : `</reasoning>` 抵达时没有打开器,一发就折叠了一切 进入一个思维区域——追溯。 没有任何流媒体阅读器 事先知道,在流出之前,不能暂时保留所有传言 (主席裁决,2026-09-26;共同文件) `projects/rich-content-unification/REGISTER.md`,RC-B3裁决.

**消费者合同:** 当一个流完成时,请在 一发模式( x)`tokenizeSource(text)`,没有 `streaming`并显示—— 最后屏幕总是等于一发的结果,这也是重新装入的结果 显示。 存储的文本从不经过流媒体模式, 所以这些都无法 更改存储的字节。 (matrx-frontend的聊天渲染器对它的 自己的活式累积器 : `components/mardown-display/chat-markdown/settle-stream-blocks.ts`. ) (中文(简体) )

## 释放门

```bash
pnpm --filter @ai-matrx/content-ir typecheck
pnpm --filter @ai-matrx/content-ir test
pnpm --filter @ai-matrx/content-ir check:package
```

该出入口运行了剖析器的共享固定装置和等价向量,验证了已包装的申报和出口,在空项目中安装了焦油球,并导入了公共API.

## 常见问题

### @ai-matrx/content-ir 是什么？

AI Matrx Content IR包:纯解析器,正版信封,会话,计划转换和验证内核,外加React渲染层\(kind routing,组件解析器,指令,kind kidg\)作为单独的分节\.

### 如何安装 @ai-matrx/content-ir？

在项目目录运行 npm install @ai-matrx/content-ir，或使用 pnpm add / yarn add / bun add。

### @ai-matrx/content-ir 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @ai-matrx/content-ir 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @ai-matrx/content-ir 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @ai-matrx/content-ir 可以商用吗？

@ai-matrx/content-ir 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @ai-matrx/content-ir 的下载量有多少？

根据 npm 官方下载统计，@ai-matrx/content-ir 在 2026/10/05 – 2026/11/03 这 30 天内被下载 81,244 次，日均约 2,708 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @ai-matrx/content-ir 还在维护吗？

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