# @agentapprove/pi 中文文档

规范地址：https://npmcn.com/package/%40agentapprove/pi/

版本：0\.1\.13
npm 元数据更新时间：2026-08-31T02:12:13.860Z
中文译文更新时间：2026-11-06T16:02:52.480Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40agentapprove/pi
原文对照：https://npmcn.com/package/%40agentapprove/pi/?lang=original
项目主页：https://www.agentapprove.com/

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

- 包体积（解压后）：82.4 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-05-01T02:20:31.315Z
- 最新版本发布：2026-08-31T02:12:13.668Z
- 近 30 天下载量：2800（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

Agent 批准 Pi 的扩展 - 批准或拒绝您的 iPhone 和 Apple Watch 的 AI 代理工具呼叫

## 安装

```sh
npm install @agentapprove/pi
```

也可以使用：`pnpm add @agentapprove/pi`、`yarn add @agentapprove/pi`、`bun add @agentapprove/pi`

## README

# @ agentapprove/ pi (英语)

[代理核准](https://agentapprove.com/) 扩展名 [Pi](https://pi.dev/)批准或拒绝 Pi 工具从您的 iPhone 或 Apple Watch 调用 。 把应用程序拿上 [应用程序存储](https://apps.apple.com/us/app/agent-approve/id6756645367)。 。 。 .

## 安装

运行代理批准安装器并选择 Pi :

```bash
npx agentapprove
```

如果代理批准已经在此机器上对齐, 您可以直接安装 Pi 包 :

```bash
pi install npm:@agentapprove/pi@0.1.12
```

## 包含什么

-   `tool_call` 屏蔽核准
-   本地工具补全事件
-   MCP 工具批准和完成事件由 MCP 服务器分组
-   迅速、反应、思考、压缩、停止和会话结束活动
-   代理代理的可选后续输入

## 运行时间映射

| Pi 活动 | 代理批准事件 |
| --- | --- |
| `session_start` | `session_start` |
| `before_agent_start` | `user_prompt` |
| `tool_call` | 屏蔽批准请求 |
| `tool_result` | `command_executed`, (中文(简体) ), `tool_complete`,或 `mcp_complete` |
| `tool_execution_end` | 如果 `tool_result` 未观察到 |
| `message_end` | `thought`, (中文(简体) ), `response`,或 `plan_generated` |
| `session_compact` | `context_compact` |
| `agent_end` | `stop`,带有可选后续输入 |
| `session_shutdown` | `session_end` |

核准请求包括:

```ts
{
  agent: "pi",
  hookType: "tool_call",
  toolName: string,
  toolType: string,
  toolInput?: object,
  command?: string,
  conversationId: string,
  generationId?: string,
  toolCallId?: string,
  model?: string,
  mcpServer?: RuntimeMcpServer,
  metadata: {
    sessionId: string,
    piEventName: "tool_call",
    cwd?: string,
    workspaceRoots?: string[],
    turnId?: string,
    messageId?: string,
    provider?: string,
    model?: string,
    toolCallId?: string
  },
  timestamp: number
}
```

事件使用相同的代理批准事件信封 `agent: "pi"`, (中文(简体) ), `eventType`, (中文(简体) ), `conversationId`选项 `generationId`,可选工具元数据,可选 `mcpServer`选项 `sessionStats`, (中文(简体) ), `metadata`,以及 `timestamp`。 。 。 .

## 配置

扩展读取标准代理批准配置 `~/.agentapprove/env`。 。 。 .

| 变量 | 默认 | 说明 |
| --- | --- | --- |
| `AGENTAPPROVE_API` | `https://api.agentapprove.com` | 代理批准 API URL |
| `AGENTAPPROVE_API_VERSION` | `v001` | API 版本 |
| `AGENTAPPROVE_TOKEN` | 密钥链或配置令牌 | CLI API 符号 |
| `AGENTAPPROVE_PRIVACY` | `full` | `minimal`, (中文(简体) ), `summary`,或 `full` |
| `AGENTAPPROVE_FAIL_BEHAVIOR` | `ask` | `allow`, (中文(简体) ), `deny`,或 `ask` 如果代理批准无法到达 |
| `AGENTAPPROVE_AGENT_NAME` | `Pi` | 显示此 Pi 代理的名称 |
| `AGENTAPPROVE_PI_NAME` | `Pi` | 遗留 Pi 特定显示名倒置 |

## 警卫

请求与代理批准HMAC信头签署,并包括已安装包捆的SHA256散列. API允许列表通过钩子版本发布了捆绑散列.

## 常见问题

### @agentapprove/pi 是什么？

Agent 批准 Pi 的扩展 - 批准或拒绝您的 iPhone 和 Apple Watch 的 AI 代理工具呼叫

### 如何安装 @agentapprove/pi？

在项目目录运行 npm install @agentapprove/pi，或使用 pnpm add / yarn add / bun add。

### @agentapprove/pi 支持 TypeScript 吗？

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

### @agentapprove/pi 支持 ESM 还是 CommonJS？

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

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

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

### @agentapprove/pi 可以商用吗？

@agentapprove/pi 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @agentapprove/pi 的下载量有多少？

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

### @agentapprove/pi 还在维护吗？

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