@czottmann/pi-zai-api

中文文档
1.1.0发布于 2026/06/22MITES Module零依赖构建来源已验证近 30 天下载 4577

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

中文使用文档
文档目录10 节
  1. 为什么会这样
  2. 所需资源
  3. 安装
  4. 设置认证
  5. 使用
  6. 如何运作
  7. 发展
  8. 关于本地 dev 和镜像列表的说明
  9. 出版
  10. 作者

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

Z.AI API 供应商扩展 毕登记 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 提供者未受影响.

所需资源

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

安装

从 npm :

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

从本地取出 :

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

设置认证

使用 pi 的 API- key 流量 :

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

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

export ZAI_API_KEY=your-key-here

从里面拿个钥匙 Z.AI 挂板。它必须设置为 API 密钥 /login而不是作为订阅.

使用

列出注册型号:

pi --list-models | grep zai-api

从提供者开始 pi :

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 版本相匹配 .

发展

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. 为检查本地已发布的行为, 安装一个已打包的构建 :

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

版本与发布记录

@czottmann/pi-zai-api 共发布 2 个版本,首次发布于 2026/06/22;过去 12 个月发布了 2 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.1.0latest2026/06/224 个月前
1.0.02026/06/224 个月前

关于 @czottmann/pi-zai-api 的常见问题

@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 和提交记录判断。