# @fabricorg/sdui-release 中文文档

规范地址：https://npmcn.com/package/%40fabricorg/sdui-release/

版本：0\.7\.17
npm 元数据更新时间：2026-11-12T21:33:20.027Z
中文译文更新时间：2026-11-14T08:01:21.917Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40fabricorg/sdui-release
原文对照：https://npmcn.com/package/%40fabricorg/sdui-release/?lang=original
项目主页：https://github.com/Fabric-Pro/fabric-platform/tree/main/packages/sdui-release#readme
源码仓库：https://github.com/Fabric-Pro/fabric-platform

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

- 包体积（解压后）：533 kB，24 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：2 个
- peer 依赖：@fabricorg/platform ^1\.17\.0
- 首次发布：2026-08-31T00:13:00.987Z
- 最新版本发布：2026-11-12T21:33:19.777Z
- 近 30 天下载量：2749（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）

## 中文简介

已版本的SDUI文件、碎片、符号集、组件包并推广独立于任何出厂器的释放合同.

## 安装

```sh
npm install @fabricorg/sdui-release
```

也可以使用：`pnpm add @fabricorg/sdui-release`、`yarn add @fabricorg/sdui-release`、`bun add @fabricorg/sdui-release`

## README

# `@fabricorg/sdui-release`

已版本的SDUI文档、碎片、符号集、组件包和推动发布 合同在独立于任何制作人的情况下得到验证.

浏览器安全 `@fabricorg/sdui-release/contracts` 条目添加释放 v3 路由和 树形范围赠款合同,RFC 8785 Cononicalization,ASync加密适配器,ES256 JWS验证,并签名单调放出-通道指针. 里面没有节点 内建或运行时平台导入。 释放 v2 并保留现有的根项 兼容.

## 此软件包拥有什么

-   **`SduiDocument`** - 带有符号集参考的一棵有版本的碎片树和 已声明组件包范围. `variants` 列出每个备选树a 堆肥商可按请求的时间选择;每个堆肥都根据同一时间进行验证 授权,并包括在发行摘要中,这就是“选择可以 永远不要扩大赠款" 可执行性,而不是仅仅说明.
-   **`SduiFragment`** - 一个节点,使一个组件,将数据从一个能力中绑起 视图,并宣布操作处理器。 行动总是 `capability://` 参考文献 对公开的动作意图——绝不是直接的突变.
-   **`SduiTokenSet`** ——外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观外观. 两道耗用同一同物集的频道通过 不同的渲染.
-   **`SduiComponentPack`** - 一套装有道具设计的组件, 槽申报,以及已出版的由组装使用的文物摘要. A 类 联邦包还宣布 `remote`: 条目 URL, a 子资源集成值及其已曝光模块。 联合包执行 不管它输入有什么作用,所以 文物文摘单描述了包 而不是运行的代码.
-   **`SduiRelease`** - 一种促进的、经过验证的、不可改变的装有罐头的捆绑 SHA-256摘要. 它包括经批准的组装身份和准确 授权赠款。 两个频道(网络、移动、CLI)可以同样消费 阅读时发布,行动仍然是能力参考.

## 验证

`validateSduiRelease(input)` 是单一的建筑门。 它拒绝:

-   **未知组件** - 片段引用未在任何申报的部件 包或核心词汇.
-   **不兼容包** ——组件包版本不能满足文档的 已声明范围.
-   **未经核准的组成** 包件文物或使用合同不符 所提供合同的确切来源和包装内容 组装锁文件.
-   **未经授权的数据引用** - 碎片或道具参照能力 认为没有公布已知的合同.
-   **拒绝提供数据参考** —— 投入中未包含已发表的观点 明确 `grants.views` 列表中选择一个选项。 合同可见度不是授权。 A 类 任何位置的引用都会得到解决:在道具键上,在数组内,或 由于一个阵列是列表道具的普通形状,所以在其中之一筑巢.
-   **扩大的赠款** —— 说 `grants.fragments` 将片段子树缩小为 由孩子继承的全发行补助金的子集,所以建立了一个网页 从几个球队的碎片 得到的特权最少 而不是工会. 缩小是一个相交点, 所以一个碎片进入 永远不能扩大,并命名 报告而不是忽略了不准许释放的参考资料.
-   **解锁的联邦远程** ——一包所申报的遥控器不匹配 输入和完整性组件锁定,或者在之后添加或投放一个远程 锁定.
-   **变异绕行** - 操作处理器不是 `capability://` 参考或 提及未宣布已知能力的意图.
-   **拒绝意图** - 投入中没有公开的行动意图 明确 `grants.intents` 列表中选择一个选项.
-   **破坏意图声明** - 经验行动意图表明: 动作 ID 能力不声明 .

它返回每个发现 而不是扔, 所以一个CI运行告诉一个垂直 所有它必须改变。 使用 `assertSduiReleaseValid(input)` 扔到一个 第一个无效结果。 每次发布输入都必须提供完整性验证 装配锁文件和两个赠款清单:

```ts
validateSduiRelease({
  document,
  tokenSet,
  componentPacks,
  contracts: usageContractDocuments,
  assembly,
  grants: {
    views: ["capability://orders/summary"],
    intents: ["capability://orders/submit"],
  },
});
```

作曲者或有收养约束力的构筑物的经验可以来自 经审查的赠款。 提供合同,或只是寻找匹配 能力参考,绝不授权读取或突变.

## 通道消费

`createSduiChannel(id, coreComponents)` 创建一个会消耗一个 有效释放。 该频道验证它面前的不可改变释放摘要 检查文档使用的每一个核心组成部分是否都在其词汇中; pack-namespaced 组件从释放的锁定包中解析出. 这个 完整性门还验证了从 在计算其文摘之前是持久性或网络。 这个 频道从不解释或绕过能力参考——它使 片段和转发动作意图 `ProjectionHost` (阅读)和 `PlatformHost` (行动).

## 与其他软件包的关系

此软件包取决于 `@fabricorg/assembly` 用于共享分解, `@fabricorg/gen-capability` 页:1 `UsageContractDocument` 审定,和 `@fabricorg/platform` 页:1 `PortableJsonSchema`它不依赖于一个渲染器, a 主机,或特定的运行时间。 SDUI 渲染、主题和组成 在便携式内核之外,并管理主机。 单独版本的经验级 一揽子方案支持ADR 0015确定的这些关切.

## 常见问题

### @fabricorg/sdui-release 是什么？

已版本的SDUI文件、碎片、符号集、组件包并推广独立于任何出厂器的释放合同\.

### 如何安装 @fabricorg/sdui-release？

在项目目录运行 npm install @fabricorg/sdui-release，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@fabricorg/platform（^1\.17\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @fabricorg/sdui-release 支持 TypeScript 吗？

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

### @fabricorg/sdui-release 支持 ESM 还是 CommonJS？

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

### @fabricorg/sdui-release 需要什么版本的 Node\.js？

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

### @fabricorg/sdui-release 可以商用吗？

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

### @fabricorg/sdui-release 的下载量有多少？

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

### @fabricorg/sdui-release 还在维护吗？

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