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

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

版本：0\.25\.93
npm 元数据更新时间：2026-10-15T00:43:49.751Z
中文译文更新时间：2026-11-05T19:04:58.240Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：2.9 MB，64 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：4 个
- peer 依赖：react \>=19\.0\.0
- 首次发布：2026-08-23T23:41:48.106Z
- 最新版本发布：2026-10-15T00:43:49.580Z
- 近 30 天下载量：46595（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：171（近 12 个月 171 个）

## 中文简介

共享的AI Matrx Content IR RENDER层:类型路由,组件解析器,临时(流取)渲染,运行时间-接合铬,以及通用结构地层——可移植回放.

## 安装

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

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

## README

# @ai-matrx/内容-ir-反应

共享 **渲染图层** 用于AI Matrx 内容 IR.

[`@ai-matrx/content-ir`](https://www.npmjs.com/package/@ai-matrx/content-ir) 实值 纯核——它描述一种,验证它,读取流出的部分 读取运行时间包装。 这个包是上面的一层: 决定 **某类组件通过**,并绘制 铬周围 那个决定.

这是框架便携式反应。 没有下一个J 没有Redux 没有Supabase 没有路由器, 没有主机错误抓取 。 每个特定东道方的能力都通过明确的 缝合.

```bash
npm install @ai-matrx/content-ir-react @ai-matrx/content-ir react
```

## 给主机接电一次

```tsx
import {
  ComponentResolver,
  ContentIrRenderProvider,
  applyIrKindRoute,
  type ContentIrHost,
} from "@ai-matrx/content-ir-react";

const components = new ComponentResolver({
  loadAll: () => fetchKindComponentRows(),
  loadForKind: (kind, platform) => fetchKindComponentRows({ kind, platform }),
  reportError: (report) => myErrorLog(report),
});

const host: ContentIrHost = {
  platform: "web",
  kinds: myKindDefinitionSource,
  components,
  reportError: (report) => myErrorLog(report),
  // The host's dispatch table — the ONE place a component key becomes a
  // component. Run the route here.
  renderBlock: (block) => <MyBlockRenderer block={applyIrKindRoute(block, env)} />,
  // The FLOOR: any JSON value as a human document.
  renderValue: ({ value, kind, note }) => (
    <MyStructuredValueView value={value} kind={kind} note={note} />
  ),
};

<ContentIrRenderProvider host={host}>
  <App />
</ContentIrRenderProvider>;
```

## 你得到的东西

| 导出 | 这是什么 |
| --- | --- |
| `applyIrKindRoute` | 类型路由: 信封 注册类型 右侧组件键 。 纯;从还原器或流积器中调用. |
| `resolveProvisionalKindRender` 编号 : `resolveAnnouncedKindLoading` | 流出部分类型的路由——一个暂定值使得通过 SAME 组件,最终值会. |
| `ComponentResolver` | `(kind, platform, role) → component`,编译出地板 + DB 覆盖,颗粒再油漆计数器,冷调图调取. |
| `KindInstanceRender` | 穿过真正的生产道路 将一个小犬类的例子 放在地上. |
| `GenericStructuredView` | 已知形状的R6处置没有引起任何信任的主张——可读、诚实、绝不是错误. |
| `NodeOutcomeView` 编号 : `RunResultView` | 运行时间 包装铬。 透明的路由器:它们代表,它们从来不产生有效载荷. |
| `ProvisionalKindBoundary` 编号 : `ProvisionalKindFrame` | 中游安全网和"还来"支付. |
| `useContentIrKindVersion` | 粒状晚到再喷漆的一种. |

## 此软件包是用来执行的

**形状有一个完全一样的成分,到处都是.** 第二次执行 路线决定——在一个仪表板、一个扩展、一个桌面网页视图、一个 顾客的应用——是一种有保障的差异,它被禁止。 如果这个软件包 无法表达您的主机需求, 添加接合; 永远不要叉开路径 .

## 文档

-   软件包内部和边界 : `FEATURE.md` 除了这个文件.
-   交叉检索记录系统 : `common-docs/systems/architecture/content-ir/FEATURE.md`。 。 。 .
-   形状系统语义 : `matrx-frontend/features/content-ir/docs/SHAPE_SYSTEM.md`。 。 。 .

## 常见问题

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

共享的AI Matrx Content IR RENDER层:类型路由,组件解析器,临时\(流取\)渲染,运行时间-接合铬,以及通用结构地层——可移植回放\.

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

在项目目录运行 npm install @ai-matrx/content-ir-react，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=19\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

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

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

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

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

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

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

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

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

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

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

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

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