@averyyy/pi-client

中文文档
1.5.0-piclient.4发布于 2026/11/05MITES Module构建来源已验证近 30 天下载 6164

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

中文使用文档
文档目录9 节
  1. 安装
  2. 使用
  3. 服务器 Auth
  4. 只读服务器查看器
  5. 快速缓存温暖
  6. 开发 Pro
  7. 谷歌反重力
  8. 更新
  9. 相关软件包

@ averyyy/ pi- 客户端

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

安装

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

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

使用

连接到您的服务器 :

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

发送一个快速退出 :

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

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

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

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

启动浏览器 UI :

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

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

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 设置中设置 :

{
  "cacheWarming": "idle"
}

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

开发 Pro

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

/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 (意大利语), (中文(简体) ), pi-devin 提供者,则 修改协议描述符。 。 。 .

谷歌反重力

运行 /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 在新的运行时间重新开始会议,并恢复其持续的历史.

单独安装服务器 :

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

版本与发布记录

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

版本发布日期距今
1.5.0-piclient.4latest2026/11/052 天前
1.5.0-piclient.32026/11/043 天前
1.5.0-piclient.22026/11/043 天前
1.5.0-piclient.12026/11/035 天前
1.4.0-piclient.192026/11/025 天前
1.4.0-piclient.182026/10/308 天前

关于 @averyyy/pi-client 的常见问题

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