# @collective-intelligence/extensions-sdk-backend-zod 中文文档

规范地址：https://npmcn.com/package/%40collective-intelligence/extensions-sdk-backend-zod/

版本：0\.2\.1
npm 元数据更新时间：2026-11-05T12:21:45.673Z
中文译文更新时间：2026-11-10T11:47:48.236Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40collective-intelligence/extensions-sdk-backend-zod
原文对照：https://npmcn.com/package/%40collective-intelligence/extensions-sdk-backend-zod/?lang=original

弃用说明：Use @collective-intelligence/extensions-sdk-backend with its /effect export\.

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

- 包体积（解压后）：12.3 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：zod \>=4\.4\.2 \<5
- 首次发布：2026-10-08T14:19:39.312Z
- 最新版本发布：2026-11-05T07:39:58.580Z
- 近 30 天下载量：5019（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：35（近 12 个月 35 个）

## 中文简介

集体智能扩展包的可选 Zod 4 schema适配器.

## 安装

```sh
npm install @collective-intelligence/extensions-sdk-backend-zod
```

也可以使用：`pnpm add @collective-intelligence/extensions-sdk-backend-zod`、`yarn add @collective-intelligence/extensions-sdk-backend-zod`、`bun add @collective-intelligence/extensions-sdk-backend-zod`

## README

# `@collective-intelligence/extensions-sdk-backend-zod`

可选 Zod 4 作者适配器 `@collective-intelligence/extensions-sdk`。 。 。 . 核心SDK保持提供者中立;这个软件包拥有Zod并曝光一个 公用适配器.

`zod` (单位:千美元)`>=4.4.2 <5`)是同级依赖关系。 安装在适配器旁边这样 适配器和你的计划分享一个Zod实例:

```sh
bun add @collective-intelligence/extensions-sdk \
  @collective-intelligence/extensions-sdk-backend-zod zod
```

```ts
import type { PackageCodec } from "@collective-intelligence/extensions-sdk"
import { zodSchema } from "@collective-intelligence/extensions-sdk-backend-zod"
import { z } from "zod"

const identifier = zodSchema(
  z.codec(z.string().regex(/^item:[0-9]+$/), z.number().int(), {
    decode: (wire) => Number(wire.slice(5)),
    encode: (value) => `item:${value}`
  })
)

const outputSchema: PackageCodec<string, number> = identifier
```

`zodSchema(...)` 推断Zod `input` 作为电线类型和Zod `output` 作为 执行价值。 审定用途 `safeParseAsync`; 编码用途 `safeEncodeAsync`,所以同步的改进和编码 保留了他们的原生 行为.

适配器还创建决定性输入和输出 JSON Schema Draft 2020-12 仅限交换消费者预测. 运行时间验证和 编码总是直接给Zod打电话. 两个方向都描述了Zod的 `input` 线型:输入验证消耗了该线型,输出编码 生产它。 佐德号 `output` 类型仍然是进程内域值,并由本地验证 反向编码,而不是作为运输JSON的广告。 解码器, 改造、预处理器、成功计划、强迫、捕获、覆盖和 对定制的改进保守地报告如下: `structural` 忠诚 因为他们的原生回调或语义可以比便携式更严格 计划 不支持的 JSON Schema 构造在适配器创建时失败 而不是默默地拓宽.

## 单向转变

Zod变换和预处理器不提供反向编码. 他们 因此,适配器结果只解码器,没有输出预测:

```ts
const parsedNumber = zodSchema(z.string().transform(Number))

await parsedNumber.validate("42") // { value: 42 }
// parsedNumber does not satisfy PackageCodec<string, number>
```

对于嵌入的物体、阵列、联盟、拖累、记录、精确 选项、承诺和其他包装. `z.success(...)` 也是只解码器. 使用明确的 `z.codec(inputSchema, outputSchema, { decode, encode })` 何时 计划必须在输出位置被接受。 懒人计划被视为 保守地解码器,因为其递归类型无法证明编码器 能力静态.

提供者字符串( N)`zod/4`)只是诊断元数据。 主机发送 结构 `validate` 财务报告和审定财务报表 `encode` 能力; `project(...)` 仅是 适用于便携式消费者。 没有注册或供应商开关.

## 包装边界

运行 `bun run test:pack` 以验证已公布的边界。 它会建立和包装 此软件包和 `@collective-intelligence/extensions-sdk`,安装包装 文物和同龄人 `zod` 临时副本 `test/consumer`,则 检查和运行该消费者。 建筑需要底座SDK 因此,建立 `@collective-intelligence/extensions-sdk` 先说.

## 常见问题

### @collective-intelligence/extensions-sdk-backend-zod 是什么？

集体智能扩展包的可选 Zod 4 schema适配器\.注意：该包已被作者标记为弃用——Use @collective-intelligence/extensions-sdk-backend with its /effect export\.

### 如何安装 @collective-intelligence/extensions-sdk-backend-zod？

在项目目录运行 npm install @collective-intelligence/extensions-sdk-backend-zod，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：zod（\>=4\.4\.2 \<5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @collective-intelligence/extensions-sdk-backend-zod 支持 TypeScript 吗？

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

### @collective-intelligence/extensions-sdk-backend-zod 支持 ESM 还是 CommonJS？

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

### @collective-intelligence/extensions-sdk-backend-zod 可以商用吗？

@collective-intelligence/extensions-sdk-backend-zod 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @collective-intelligence/extensions-sdk-backend-zod 的下载量有多少？

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

### @collective-intelligence/extensions-sdk-backend-zod 还在维护吗？

最新版本 0\.2\.1 发布于 2026/11/05（5 天前）；至今共发布 35 个版本，其中过去 12 个月发布了 35 个；首次发布于 2026/10/08。作者已将其标记为弃用，新项目建议寻找替代方案。