# @averyyy/pi-client 中文文档

规范地址：https://npmcn.com/package/%40averyyy/pi-client/

版本：1\.5\.0-piclient\.4
npm 元数据更新时间：2026-11-05T01:10:13.347Z
中文译文更新时间：2026-11-07T08:02:31.546Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：27.8 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.19\.0
- 运行依赖：1 个
- 首次发布：2026-07-01T23:48:47.265Z
- 最新版本发布：2026-11-05T01:10:12.971Z
- 近 30 天下载量：6164（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：96（近 12 个月 96 个）

## 中文简介

连接到 pi- server 实例的轻量级 CLI 包装器

## 安装

```sh
npm install @averyyy/pi-client
```

也可以使用：`pnpm add @averyyy/pi-client`、`yarn add @averyyy/pi-client`、`bun add @averyyy/pi-client`

## README

# @ averyyy/ pi- 客户端

连接 Pi 到 a 的客户端 CLI `pi-server` 举个例子.

## 安装

```bash
npm i -g --ignore-scripts --legacy-peer-deps @averyyy/pi-client
```

`--legacy-peer-deps` 当上游 Pi 已经在全球安装时, 避免 npm 对等端覆盖警告 .

## 使用

连接到您的服务器 :

```bash
PI_SERVER_URL=https://pi-server.example.com pi-client
```

发送一个快速退出 :

```bash
PI_SERVER_URL=https://pi-server.example.com pi-client -p "Say exactly: ok"
```

向服务器发送文件或文件夹 :

```bash
PI_SERVER_URL=https://pi-server.example.com pi-client send /path/to/file-or-folder
```

服务器将其保存在其配置的上传目录下, 上传目录默认为 `~/.pi/upload_files`。 。 。 .

启动浏览器 UI :

```bash
pi-client install npm:@averyyy/pi-tau-codex
# or: pi install npm:@averyyy/pi-tau-codex
PI_SERVER_URL=https://pi-server.example.com pi-client web
```

开始网络命令 `pi-client` 在 Tau 镜像模式中。 单独安装 `@averyyy/pi-tau-codex` 扩展到共享 `~/.pi/agent` 首先设置。 小陶听着 `http://127.0.0.1:1838` 默认.

## 服务器 Auth

如果您的服务器使用认证符, 请设置在客户端上 :

```bash
PI_SERVER_AUTH_TOKEN=your-token PI_SERVER_URL=http://127.0.0.1:4217 pi-client
```

使用匹配的客户端和服务器发布 。 客户端上配置了普通的提供者证书、环境覆盖和请求信头,并提交推论。 Devin和Google Antigravity账户存储,并在服务器上解决其证书.

一般的内置模型目录来自pi-server的共享 pi.dev 缓存. 服务器元数据优先于同一模型类型和ID的捆绑元数据,独立于包构建日期. 客户端只为拥有已配置认证的提供者请求目录,并从自己的证书和配置中确定聊天,图像,以及分类器的可用性. OpenRouter的证书专用模型过滤在客户端上运行. Devin和Google Antigravity账户目录来自服务器. 扩展和代码脚本使用普通的模型注册API;推断运行在服务器上. MCP连接、工具和其他提供者的登录仍在客户端过程中.

`PI_CLIENT_MAX_REQUEST_KB=64` 将每个客户端HTTP请求正文限制在65,536 UTF-8字节. 更大的提示、工具定义、图像、有效载荷和会话树使用共享块运输.

## 只读服务器查看器

在浏览器中打开服务器 URL, 用它的 Bearer 令牌签名以浏览项目保存的线索 。 客户端通过独立观察频道发布承诺的对话历史和现场思考/工具活动. 观察者连接错误在终端中报告,而不中断提示或工具. 重新连接可以刷新服务器对当前分支的只读投影.

浏览器可以查看线程但不能操作客户端. 运行和闲置指标遵循客户端生命周期;明确显示中断的观测连接. 客户端和服务器都必须包括现场更新和项目元数据的观察员功能.

正常运行时间关闭最多可等10秒,以进行最后观测更新. 报告交付失败时不改变及时结果或退出状态.

## 快速缓存温暖

缓存升温器通过 pi- server 重放符合条件的请求,使用原始的即时,工具,模型,以及缓存选项,将输出限制在一个令牌上. 默认 `streaming` 模式在活动代理运行时温暖。 要在等待输入时同时取暖, 请在您的全局 Pi 设置中设置 :

```json
{
  "cacheWarming": "idle"
}
```

服务器确认每个请求使用的缓存保留,客户端使用此政策来刷新时间和成本决定. 该模型必须宣布快速缓存寿命,预期的节余必须达到0.05美元. `/session` 显示变暖的决定。 设定 `cacheWarming` 改为 `"off"` 来禁用它。 刷新使用量算到会话总数而不添加模型信息;取消和更改模型/文字停止变暖。 请求使用相同的64KiB运输限制.

## 开发 Pro

更新两者 `@averyyy/pi-client` 财务报告和审定财务报表 `@averyyy/pi-server` 到一个有本地Devin支持的版本。 开始 `pi-client` 并配置了服务器连接,然后:

```text
/login devin
/model devin/swe-2-medium
```

登录显示 Devin 的浏览器授权链接. 完整登录并粘贴全部最终重定向 URL 到登录提示 。 PiServer 交换代码并保存到其账号商店中的会话符. 登录后账户目录加载; `pi-client --list-models swe-2` 列出已发现的 SWE-2 变种。 选择精确的变体( 例如 ) `swe-2-high` 或者说 `swe-2-max`改革努力.

认证,账户模型的发现, 和推论运行在PiServer。 服务器在启动时恢复所保存的目录,在后台和登录后刷新,每4小时刷新一次. 发现失败保留已保存的目录并报告错误 。 Pi继续拥有工具,代理循环,会话历史,以及子代理. 不需要Devin CLI安装或供应商扩展. 在启用本地提供者之前删除相冲突的 Devin 扩展 .

集成暴露出具体的模型,而不是德文的"融合"(Fusion)/"路由"(router habel). 取消的会话需要 `/login devin` ;没有创建更新终点或符号寿命.

参考议定书: [pi -devin (意大利语)](https://github.com/mizorewww/pi-devin), (中文(简体) ), [pi-devin 提供者](https://github.com/fadlee/pi-devin-provider),则 [修改协议描述符](https://github.com/can1357/oh-my-pi/tree/main/packages/ai/src/providers/devin/proto)。 。 。 .

## 谷歌反重力

运行 `/login google-antigravity`,完整浏览器授权,并粘贴全部重定向 URL 到登录提示。 PiServer存储了OAuth的证书和项目,刷新了过期的令牌,并发现了该账户的精确型号ID. `pi-client --list-models google-antigravity` 读取服务器保存的账户目录 .

两个账户提供者都使用配置的服务器目录 `PI_SERVER_ACCOUNT_STORE_DIR`,默认为 `~/.pi/pi-server/accounts`。 。 。 . `/logout` 删除选中的服务器账户及其目录。 提供信使留在服务器上. 本地的 Pi 课程使用本地的证书存储 .

## 更新

`pi-client update` 在不停止活动客户端会话的情况下安装最新的客户端和服务器包。 现有会话会阻断新提示直到运行 `/reload`· ; `/reload` 在新的运行时间重新开始会议,并恢复其持续的历史.

## 相关软件包

单独安装服务器 :

```bash
npm i -g --ignore-scripts @averyyy/pi-server
```

## 常见问题

### @averyyy/pi-client 是什么？

连接到 pi- server 实例的轻量级 CLI 包装器

### 如何安装 @averyyy/pi-client？

在项目目录运行 npm install @averyyy/pi-client，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 pi-client，可以用 npx pi-client 直接运行。

### @averyyy/pi-client 支持 TypeScript 吗？

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

### @averyyy/pi-client 支持 ESM 还是 CommonJS？

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

### @averyyy/pi-client 需要什么版本的 Node\.js？

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

### @averyyy/pi-client 可以商用吗？

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

### @averyyy/pi-client 的下载量有多少？

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

### @averyyy/pi-client 还在维护吗？

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