# @btravstack/pothos 中文文档

规范地址：https://npmcn.com/package/%40btravstack/pothos/

版本：0\.58\.0
npm 元数据更新时间：2026-11-07T21:11:45.974Z
中文译文更新时间：2026-11-08T18:13:36.369Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：23 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：0 个
- peer 依赖：zod ^4\.3\.0，graphql ^16\.10\.0 \|\| ^17\.0\.0，unthrown ^5\.12\.1，@orpc/client ^2\.0\.0-beta\.28，@pothos/core ^4\.15\.0，@orpc/contract ^2\.0\.0-beta\.28，@unthrown/pothos ^0\.1\.2，@btravstack/contract ^0\.58\.0，@pothos/plugin-relay ^4\.8\.0，@pothos/plugin-errors ^4\.9\.0
- 首次发布：2026-10-10T22:38:31.433Z
- 最新版本发布：2026-11-07T21:11:45.620Z
- 近 30 天下载量：6633（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：39（近 12 个月 39 个）

## 中文简介

Pothos 字段将 OLPC 程序调用, 每个已声明错误作为输入的 GraphQL 拒绝回答

## 安装

```sh
npm install @btravstack/pothos
```

也可以使用：`pnpm add @btravstack/pothos`、`yarn add @btravstack/pothos`、`bun add @btravstack/pothos`

## README

# @btravstack/pothos (英语)

[波索斯语Name](https://pothos-graphql.dev/) 调用字段 [oRPC 缩写:](https://orpc.dev/) 程序,用于图形QL网关 合同第一服务。 默认导出是插件, 列在 `@unthrown/pothos`': `plugins: [RelayPlugin, ErrorsPlugin, UnthrownPlugin, OrpcPlugin]`。 。 。 .

-   `t.procedureField(procedure, { type, call, input, output, refusals? })` 验证 字段在调用前通过程序本身的合同输入, 解码答案 `output`,并回答每个错误的程序 声明为其代码注册的 GraphQL 错误类 现场的结果结合。 外地-当地 `refusals` 覆盖建构器 共享 `orpc: { refusals }` 默认值。 地图必须覆盖每一个 错误 `call` 可返回并 `InvalidInput`; 缺少代码不编译. 由狭义处理的已声明错误 `call` 不需要输入 .
-   `t.procedureConnection(procedure, { …, connection })` 对一个 中继连接, 已解码的页面折叠由 `connection`。 。 。 .
-   `UNAUTHORIZED` 财务报告和审定财务报表 `FORBIDDEN` 解答为 GraphQL 自己的错误, 以 `extensions.code`无论程序是否宣布.
-   `loadProcedure` 财务报告和审定财务报表 `procedureErrors` 通过一个 数据记录器; `contractCall`, (中文(简体) ), `contractInput` 财务报告和审定财务报表 `contractOutput` 这是 单干一半.

每个依赖都是对等点: Pothos 插件和 `graphql` 每个人需要一份副本. 安装 `@btravstack/contract` 与他们一起; `contractInput` 重新使用该物质 `/orpc` 输入-schema访问器.

```sh
pnpm add @btravstack/pothos @btravstack/contract @pothos/core @pothos/plugin-errors @pothos/plugin-relay \
  @unthrown/pothos@^0.1.2 graphql unthrown zod \
  @orpc/client@2.0.0-beta.44 @orpc/contract@2.0.0-beta.44
```

见 [从 ORPC 程序中解析图QL 字段](https://btravstack.github.io/btravstack/how-to/resolve-graphql-fields-from-orpc)。 。 。 .

## 常见问题

### @btravstack/pothos 是什么？

Pothos 字段将 OLPC 程序调用, 每个已声明错误作为输入的 GraphQL 拒绝回答

### 如何安装 @btravstack/pothos？

在项目目录运行 npm install @btravstack/pothos，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：zod（^4\.3\.0）、graphql（^16\.10\.0 \|\| ^17\.0\.0）、unthrown（^5\.12\.1）、@orpc/client（^2\.0\.0-beta\.28）、@pothos/core（^4\.15\.0）、@orpc/contract（^2\.0\.0-beta\.28）、@unthrown/pothos（^0\.1\.2）、@btravstack/contract（^0\.58\.0）、@pothos/plugin-relay（^4\.8\.0）、@pothos/plugin-errors（^4\.9\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @btravstack/pothos 支持 TypeScript 吗？

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

### @btravstack/pothos 支持 ESM 还是 CommonJS？

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

### @btravstack/pothos 需要什么版本的 Node\.js？

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

### @btravstack/pothos 可以商用吗？

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

### @btravstack/pothos 的下载量有多少？

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

### @btravstack/pothos 还在维护吗？

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