# @averyyy/pi-coding-agent 中文文档

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

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

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

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

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

- 包体积（解压后）：26 MB，1326 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：22 个
- 首次发布：2026-07-02T00:42:05.131Z
- 最新版本发布：2026-11-05T01:13:24.955Z
- 近 30 天下载量：6337（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：94（近 12 个月 94 个）

## 中文简介

编码代理 CLI , 包含读取、 击打、 编辑、 写入工具和会话管理

## 安装

```sh
npm install @averyyy/pi-coding-agent
```

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

## README

[![Pi logo](https://pi.dev/logo-auto.svg)](https://pi.dev/)

[![Discord](https://img.shields.io/badge/discord-community-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.com/invite/3cU7Bz4UPx) [![npm](https://img.shields.io/npm/v/@earendil-works/pi-coding-agent?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@earendil-works/pi-coding-agent)

> 新问题和来自新捐助者的公关自动关闭。 维护者每天审查已关闭的呈件。 见 [捐款额](https://github.com/earendil-works/pi/blob/main/CONTRIBUTING.md)。 。 。 .

# Pi

Pi是一种最小的,可扩展的毒剂绳,你可以自己制造.

让Pi适应你的工作流程 而不是相反 自定义 Pi 与 [扩展](https://npmcn.com/package/%40averyyy/pi-coding-agent/docs/extensions.md), (中文(简体) ), [技能](https://npmcn.com/package/%40averyyy/pi-coding-agent/docs/skills.md), (中文(简体) ), [提示模板](https://npmcn.com/package/%40averyyy/pi-coding-agent/docs/prompt-templates.md),以及 [主题](https://npmcn.com/package/%40averyyy/pi-coding-agent/docs/themes.md)装入 [Pi 软件包](https://npmcn.com/package/%40averyyy/pi-coding-agent/docs/packages.md) 并通过 npm 或 git 分享 .

具有强大的默认但跳过子代理和计划模式等特性的皮船. 请 Pi 构建您想要的东西, 或者安装一个可以按您的方式操作的软件包 .

使用 Pi 键 [互动](https://npmcn.com/package/%40averyyy/pi-coding-agent/docs/usage.md)自动输入 [打印或 JSON 模式](https://npmcn.com/package/%40averyyy/pi-coding-agent/docs/cli.md),控制着它 [难民保护委员会](https://npmcn.com/package/%40averyyy/pi-coding-agent/docs/rpc.md),或用 [Pi 类型脚本 SDK](https://npmcn.com/package/%40averyyy/pi-coding-agent/docs/sdk.md)。见 [打开Claw](https://github.com/OpenClaw/OpenClaw) 实现现实世界的一体化.

## 开始

安装命令行接口 :

```bash
curl -fsSL https://pi.dev/install.sh | sh
```

在视窗上 :

```shell
powershell -c "irm https://pi.dev/install.ps1 | iex"
```

安装者将所有依赖性标出并更新 Pi `pi update`。或者,直接安装 npm,而 npm 不标注转接依赖性 :

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

皮需要节点.js 22.19或更新. macOS,Linux和Windows安装器在需要时可以安装. Pi对于正常npm安装不需要依赖生命周期脚本.

在 macOS 和 Linux 上, Nix 用户可以通过 `nix profile add github:earendil-works/pi/stable`见 [快速启动](https://npmcn.com/package/%40averyyy/pi-coding-agent/docs/quickstart.md#1-install-pi) 用于更新和锁定释放.

将 Pi 启动到目录中您想要它工作的地方 :

```bash
cd /path/to/project
pi
```

对于内置的 AI 供应商,运行 `/login` 在 Pi 内部连接订阅或 API 密钥。 那就给皮一个任务.

见 [文档](https://npmcn.com/package/%40averyyy/pi-coding-agent/docs/index.md) 用于完整的设置和使用指令.

## 共享您的 OSS 编码代理会话

如果您使用 Pi 进行开源工作, 请分享您的编码代理会话 .

公共开放源码软件会议数据有助于利用真正的开发工作流程改进模型、提示、工具和评价.

详细解释见: [这篇文章在X](https://x.com/badlogicgames/status/2037811643774652911)。 。 。 .

发布会话,使用 [`badlogic/pi-share-hf`](https://github.com/badlogic/pi-share-hf) 使用 Hugging Face 账户和 Hugging Face CLI.

-   [演示视频](https://x.com/badlogicgames/status/2041151967695634619) 如何出版 Pi 会话
-   出版 Pi 开发会: [`badlogicgames/pi-mono` 在拥抱的脸上](https://huggingface.co/datasets/badlogicgames/pi-mono)。 。 。 .

## 发展

清除寄存器,安装其依赖,并从源头运行 Pi :

```bash
git clone https://github.com/earendil-works/pi
cd pi
npm install --ignore-scripts
./pi-test.sh
```

`pi-test.sh` 可以从任何目录中调用,并保存调用者的工作目录.

提交更改前, 运行 :

```bash
npm run check
./test.sh
```

读取 [捐款额](https://github.com/earendil-works/pi/blob/main/CONTRIBUTING.md) 在打开问题或拉动请求之前。 它界定了贡献门,发行了质量栏并需要检查. 读取 [一般事务人员(其他职等)](https://github.com/earendil-works/pi/blob/main/AGENTS.md) 用于特定存储器的执行、测试、依赖和发布规则.

## 许可证

麻省理工学院

## 常见问题

### @averyyy/pi-coding-agent 是什么？

编码代理 CLI , 包含读取、 击打、 编辑、 写入工具和会话管理

### 如何安装 @averyyy/pi-coding-agent？

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

### @averyyy/pi-coding-agent 支持 TypeScript 吗？

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

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

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

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

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

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

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

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

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

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

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