# @contentful/experiences-sdk-core 中文文档

规范地址：https://npmcn.com/package/%40contentful/experiences-sdk-core/

版本：0\.13\.13
npm 元数据更新时间：2026-11-06T17:14:29.532Z
中文译文更新时间：2026-11-10T16:59:29.891Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40contentful/experiences-sdk-core
原文对照：https://npmcn.com/package/%40contentful/experiences-sdk-core/?lang=original
项目主页：https://github.com/contentful/experiences#readme
源码仓库：https://github.com/contentful/experiences

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

- 包体积（解压后）：236 kB，10 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-07-21T10:27:10.968Z
- 最新版本发布：2026-11-06T17:14:29.344Z
- 近 30 天下载量：5782（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：54（近 12 个月 54 个）

## 中文简介

运行时间中性类型 + 经验解析度

## 安装

```sh
npm install @contentful/experiences-sdk-core
```

也可以使用：`pnpm add @contentful/experiences-sdk-core`、`yarn add @contentful/experiences-sdk-core`、`bun add @contentful/experiences-sdk-core`

## README

# @ contentful/ 经验- sdk- core

> ⚠️ **内部包裹.** 你不直接安装这个——框架适配器(例如. [`@contentful/experiences-react`](https://npmcn.com/package/%40contentful/adapter-react/))再出口所需要一切.

在所有框架中共享无依赖性、运行时间中立的原始物 适应器. 此软件包没有运行时间依赖性 .

## 住在这里的东西

-   **类型** —— 说 `PortableRenderPlan`, (中文(简体) ), `PortableRenderNode`, (中文(简体) ), `PortableRegistration`, (中文(简体) ), `ExperiencePayload`, (中文(简体) ), `ExperienceNode`歧视 `DesignPropValue` 工会`ManualDesignValue` 编号 : `DesignToken`, (中文(简体) ), `ExperienceContext`, (中文(简体) ), `ResolveContext`。 。 。 .
-   **`resolveExperience(payload, config, opts)`** ——单自动同步条目,走XDA有效载荷,分解内容与设计属性,解析设计值和符号,捕捉槽,运行任何组件声明 `resolveData` 并列挂钩,发出运行时中性 `PortableRenderPlan` 任何框架适配器都可以打开。 有效载荷中的每个节点都变成一个 `PortableRenderNode`· ; `registration.kind` 记录适配器是否针对 `config.components` 或者说 `config.experienceTemplates`. 一个编码的经验模板是一个普通的节点—— `payload.sys.experienceTemplate` 永远不读.
-   **诊断和设计支助** —— 说 `createDebugLogger`, (中文(简体) ), `resolveDesignProperties`,以及 `applyTokenResolver`。 。 。 .

交付运输属于客户,事件构建属于运行时, 在任何运行时间保持此软件包的可用性而不拉入送货客户端 或框架.

## 提供诊断

`resolveExperience` 已确认项目 `payload.errors` 输入可选 `plan.deliveryDiagnostics: readonly ExperienceDeliveryDiagnostic[]`。每次新鲜 记录只包含只读字符串 `fieldPath` 财务报告和审定财务报表 `message`; 输入顺序为 保存,以及 `originalError`中,删除了额外的字段和输入引用. 缺失、非阵列或未识别出的错误使外地不存在。 一样 正常化服务于原始解析呼叫和现有的客户端/运行时/叶取 路径,包括目的地; 核心进口没有生成交付类型.

这些是上游现场分辨率诊断,与现有的 当地 `plan.diagnostics: Error[]`它们保存可翻译的内容并序列化 作为普通记录。 投影是故意局部的:永远没有 证明个性化成功或不存在所有上游错误. 上游字符串可能包含私人信息. 更喜欢普通访客 警告/计数,检查明确用于诊断的字段,将其排除于 公共靴子/接头有效载荷和日志。 白名单不是隐私过滤器.

## 为什么是单独的包裹?

未来Angular,Svelte,Vue,SwiftUI,和Confose适配器消耗相同的计划. 共享核心意味着每个适配器都有零计划构建或prop-分类逻辑来重复——接合是 `PortableRenderPlan` 合同.

见 [`../../AGENTS.md`](https://npmcn.com/package/AGENTS.md) 整个建筑和设计决定.

## 许可证

麻省理工学院. 见寄存器 [`LICENSE`](https://npmcn.com/package/LICENSE) 财务报告和审定财务报表 [`NOTICE`](https://npmcn.com/package/NOTICE) 完全归属.

## 常见问题

### @contentful/experiences-sdk-core 是什么？

运行时间中性类型 \+ 经验解析度

### 如何安装 @contentful/experiences-sdk-core？

在项目目录运行 npm install @contentful/experiences-sdk-core，或使用 pnpm add / yarn add / bun add。

### @contentful/experiences-sdk-core 支持 TypeScript 吗？

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

### @contentful/experiences-sdk-core 支持 ESM 还是 CommonJS？

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

### @contentful/experiences-sdk-core 可以商用吗？

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

### @contentful/experiences-sdk-core 的下载量有多少？

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

### @contentful/experiences-sdk-core 还在维护吗？

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