# @czottmann/pi-zai-api 中文文档

规范地址：https://npmcn.com/package/%40czottmann/pi-zai-api/

版本：1\.1\.0
npm 元数据更新时间：2026-06-22T11:49:53.289Z
中文译文更新时间：2026-11-11T07:32:31.040Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：8.1 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- peer 依赖：@earendil-works/pi-ai \*，@earendil-works/pi-coding-agent \*
- 首次发布：2026-06-22T11:25:20.817Z
- 最新版本发布：2026-06-22T11:49:53.003Z
- 近 30 天下载量：4577（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

Z.AI API 为 pi 编码代理的供应商扩展. 安装方式 `pi install npm:@czottmann/pi-zai-api`。 。 。 .

## 安装

```sh
npm install @czottmann/pi-zai-api
```

也可以使用：`pnpm add @czottmann/pi-zai-api`、`yarn add @czottmann/pi-zai-api`、`bun add @czottmann/pi-zai-api`

## README

# @czottmann/pi-zai-api (英语)

Z.AI API 供应商扩展 [毕](https://pi.dev/)登记 [Z.AI (英语)](https://z.ai/) A下的GLM模型 `zai-api` 指向一般 Z.AI API 终点的提供者.

## 为什么会这样

派已经内装了 `zai` 提供者,但它指向编码计划终点(`https://api.z.ai/api/coding/paas/v4`),需要Z.AI编码订阅. 如果你有固定的现收现付Z.AI API密钥,这个端点对你无效.

此扩展名将相同的 GLM 模型登记在单独的 `zai-api` 使用一般 API 端点的提供者( C)`https://api.z.ai/api/paas/v4`)代替,用 `ZAI_API_KEY`内置 `zai` 提供者未受影响.

## 所需资源

```bash
npm install -g @earendil-works/pi-coding-agent
```

## 安装

从 npm :

```bash
pi install npm:@czottmann/pi-zai-api
```

从本地取出 :

```bash
cd path/to/pi-zai-api
npm install
pi install "$PWD"
```

## 设置认证

使用 pi 的 API- key 流量 :

```bash
pi
/login
# Choose "Use an API key", then "ZAI" (same as with the built-in `zai` provider).
```

或者在启动 pi 之前设置环境变量 :

```bash
export ZAI_API_KEY=your-key-here
```

从里面拿个钥匙 [Z.AI 挂板](https://z.ai/manage-apikey/apikey-list)。它必须设置为 API 密钥 `/login`而不是作为订阅.

## 使用

列出注册型号:

```bash
pi --list-models | grep zai-api
```

从提供者开始 pi :

```bash
pi --provider zai-api
```

在互动模式中, `/zai-api-models` 列出扩展所注册的模型.

## 如何运作

启动时, 扩展为 pi 本身内置 `zai` 示范定义 `getModels("zai")` 从 `@earendil-works/pi-ai`,将每个模型的基址放下,然后重新登记 `zai-api` 具有一般 API 基础 URL 和 `ZAI_API_KEY`。 。 。 .

其他的都从 pi 的目录逐字记录中结转:上下文窗口,最大输出符,推理支持,输入类型,以及z.ai 特定相容标记(思维格式,工具流). 因为列表是运行时的镜像,它跟踪了Pi的内置 `zai` 更新 pi 时的模型 : 新的 GLM 模型 pi 也添加到这里, 并带有校正的终点 .

pi 解决 `@earendil-works/pi-ai` 当它装入扩展名时, 它会被捆绑到自己的副本中, 因此镜像列表总是与您运行的 pi 版本相匹配 .

## 发展

```bash
npm run check
npm run build
pi -e . --provider zai-api
```

### 关于本地 dev 和镜像列表的说明

当您从本地取出时加载扩展名( W)`pi -e .` 或者说 `pi install "$PWD"`),节点解析 `@earendil-works/pi-ai` 至此工程的复制件 `node_modules`而不是你Pi安装的那个 如果dev副本比您 pi 年长,镜像模型列表反映了dev副本,并且可以错过模型您 pi 实际的船.

已发布的软件包捆绑没有依赖性,所以一个真正的安装总是反射出您运行的 pi. 为检查本地已发布的行为, 安装一个已打包的构建 :

```bash
npm pack
mkdir -p /tmp/zai-test && tar -xzf czottmann-pi-zai-api-*.tgz -C /tmp/zai-test --strip-components=1
pi install /tmp/zai-test
```

## 出版

GitHub Actions发布一个 GitHub Release 时将软件包发布到 npm. 释放标记必须匹配 `package.json` 不管有没有线索 `v` (单位:千美元)`v1.0.0` 财务报告和审定财务报表 `1.0.0` 两个版本的工作 `1.0.0`) (中文(简体) ).

工作流程使用npm Trusted Publishing,因此不需要npm 令牌秘密. 使用此寄存器和工作流程文件配置 npm 上的此软件包( S)`.github/workflows/publish.yml`) (中文(简体) ). 工作流程构建软件包, 运行 `npm run check`,并用 npm出处出版.

## 作者

卡罗・佐特曼, [卡尔洛@zottmann.dev](mailto:carlo@zottmann.dev)

-   网站: [https://actions.work (英语)](https://actions.work/)
-   GitHub : (中文(简体) ) [https://github.com/czottmann (中文(简体) )](https://github.com/czottmann)
-   布鲁斯基: [https://bsky.app/profile/zottmann.dev 互联网档案馆的存檔,存档日期2013-12-21](https://bsky.app/profile/zottmann.dev)
-   马斯托登: https://norden.social/@czottmann

## 常见问题

### @czottmann/pi-zai-api 是什么？

Z\.AI API 为 pi 编码代理的供应商扩展\. 安装方式 pi install npm:@czottmann/pi-zai-api。 。 。 \.

### 如何安装 @czottmann/pi-zai-api？

在项目目录运行 npm install @czottmann/pi-zai-api，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@earendil-works/pi-ai（\*）、@earendil-works/pi-coding-agent（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @czottmann/pi-zai-api 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/czottmann\_\_pi-zai-api 是否存在。

### @czottmann/pi-zai-api 支持 ESM 还是 CommonJS？

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

### @czottmann/pi-zai-api 可以商用吗？

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

### @czottmann/pi-zai-api 的下载量有多少？

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

### @czottmann/pi-zai-api 还在维护吗？

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