# @buyong/pi-codex 中文文档

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

版本：0\.6\.4
npm 元数据更新时间：2026-11-06T20:07:12.381Z
中文译文更新时间：2026-11-08T20:46:16.133Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40buyong/pi-codex
原文对照：https://npmcn.com/package/%40buyong/pi-codex/?lang=original
项目主页：https://github.com/buYoung/pi-packages/tree/main/apps/pi-codex#readme
源码仓库：https://github.com/buYoung/pi-packages

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

- 包体积（解压后）：1.5 MB，205 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.19\.0
- 运行依赖：5 个
- peer 依赖：@earendil-works/pi-ai \*，@earendil-works/pi-tui \*，@earendil-works/pi-coding-agent \*
- 首次发布：2026-10-06T00:58:00.358Z
- 最新版本发布：2026-11-06T20:07:12.076Z
- 近 30 天下载量：2360（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 15 个）

## 中文简介

Pi 的 Codex 捆绑:安装自动批准审查,计算机使用,快取模式,图像生成,和内存一起.

## 安装

```sh
npm install @buyong/pi-codex
```

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

## README

# @ buyong/pi-codex (韩语)

**联合国** | [한국어](https://npmcn.com/package/%40buyong/pi-codex/README.ko.md)

安装自动批准审查,计算机使用和浏览器使用,OpenAI快取模式,图像生成,以及一个Pi包中的内存v2. 捆绑包括五个单独的 Codex 扩展(`@buyong/pi-codex-auto-review`, (中文(简体) ), `@buyong/pi-codex-computer-use`, (中文(简体) ), `@buyong/pi-codex-fast-mode`, (中文(简体) ), `@buyong/pi-codex-image-gen`,以及 `@buyong/pi-codex-memory`)和 `imagegen` 技能;每个组件都保留自己的命令和设置.

当您想要这些特性时使用捆绑 。 如果您只需要一个, 请使用下面的单个软件包指南 。 捆绑没有添加单独的自动化或审批引擎,也不提供Codex桌面或账户访问.

## 安装前

-   节点.js 22.19或以后,并配置了Pi对话提供者/模型.
-   完整捆绑的一分一分一分 内存使用Pi 1.4.0 API;其他组件保留了自己的相容性要求.
-   表中的特色特有要求. 你可以离开未使用的特性.

| 特性 | 所需额外经费 | 没有保存的设置的初始状态 |
| --- | --- | --- |
| [自动审查](https://github.com/buYoung/pi-packages/blob/main/apps/pi-codex-auto-review/README.md) | 自动审查模式访问,或用户确认需要批准的电话 | **批准给我**; 不是 OS 沙盒 |
| [计算机使用](https://github.com/buYoung/pi-packages/blob/main/apps/pi-codex-computer-use/README.md) | 已安装的 Codex 桌面运行时间; 在 Chrome 中的浏览器使用还需要 ChatGPT Chrome 扩展及其本地消息主机. 在 macOS 上检查了活性; Windows 未验证; Linux 不支持 . | 计算机使用和浏览器 使用两者, 这样扩展可以启动桌面运行时间; 用 `/computer-use` |
| [快取模式](https://github.com/buYoung/pi-packages/blob/main/apps/pi-codex-fast-mode/README.md) | 一个 `openai` 或者说 `openai-codex` fast 模式允许列表中的模型; Ultrafast 有额外的认证和端点要求 | 标准; 未选择加速度 |
| [图像生成](https://github.com/buYoung/pi-packages/blob/main/apps/pi-codex-image-gen/README.md) | 皮丝 `openai-codex` 订阅登录 | 不登录而隐藏工具和技能 |
| [内存 v2](https://github.com/buYoung/pi-packages/blob/main/apps/pi-codex-memory/README.md) | Pi 1.4.0;明确选定的取出/综合模型 | 仓库范围召回,在其工作树上共享;世代结束,直到启用 `/codex-memory` |

**不启用同一单个扩展旁的捆绑 .** 工具,命令,和事件处理器可以注册两次. 如果这些软件包已经安装, 请跟随 [移徙](https://npmcn.com/package/%40buyong/pi-codex/#readme-switch-from-individual-packages) 在装入捆绑之前.

## 安装已公布的发布

```sh
pi install npm:@buyong/pi-codex
pi list
pi
```

`pi list` 显示 `npm:@buyong/pi-codex` 及其已安装的路径 `User packages:`。 。 。 . `pi` 然后以装入的捆绑开始会话; 继续 [运行特性任务前确认设置](https://npmcn.com/package/%40buyong/pi-codex/#readme-confirm-setup-before-running-feature-tasks)。 。 。 .

未编辑的源选择最近发布的发布; 附加 `@<version>` 以针一. 只为当前工程安装, 添加 `--local` (单位:千美元)`pi install --local npm:@buyong/pi-codex`这需要项目信任,以及 `pi list` 显示在 `Project packages:`。在寄存器检出时的版本可能尚未在 npm 上。 要运行未释放的改变, [从源头构建和加载](https://npmcn.com/package/%40buyong/pi-codex/#readme-build-and-load-from-source)。 。 。 .

## 从单个软件包切换

1.  运行 `pi list` ,并在全局或项目设置中找到上述5个单个软件包中的任何一个.
2.  删除这些条目时使用 `pi remove <source>`,或 `pi remove --local <source>` 用于项目条目.
3.  在预定范围安装捆绑并重新启动 Pi .

使用报告来源 `pi list`,不是被猜测的版本字符串。 组件设置路径不改变,因此在切换后现有的首选项仍然可用.

## 运行特性任务前确认设置

内部 Pi, 配置对话访问权限 `/login` 如果需要的话。 然后运行 `/approve` 选择 **批准给我** 或者说 **请求批准**。为尝试一个限定范围的批准审查任务,请发送:

```text
Use bash to run exactly node --version and report the result. Do not install anything or change files.
```

根据默认政策,命令需要复核. 一个成功的运行报告已安装的Node.js版本;自定义规则和保存的审批可以改变路由. 自动审查会增加模式调用.

单独配置其他特性 :

| 目标 | 入境点 | 怎么办和检查 |
| --- | --- | --- |
| 操作应用程序或 Chrome | `/computer-use-check`,则 `/computer-use` | 解决缺失的前提条件,只保留您需要的功能: 计算机使用,浏览器使用,或者两者兼有(两者在初始状态上). 一个连接的运行时间曝光 `mcp__cua_repl__js`;运行时间批准适用于应用程序/原产地访问. |
| 请求更快的服务级别 | `/codex-fast`,则 `/codex-fast status` | 选择一个分级,然后检查所选分级以及它是否对当前模型有效。 状态显示在上一个请求中添加的分级,该分级不能确认服务器是如何处理或计费的. |
| 生成图像 | `/login openai-codex`,则 `/codex-imagen` | 签名, 选择图像模型, 请 Pi 使用 `image_gen`。结果包括图像。 扩展名还试图在 `<agentDir>/generated_images/`; 失败的保存不会从结果中删除图像 . |

如果不使用计算机使用,请关闭计算机使用和浏览器使用 `/computer-use`. 选择服务级或图像模型不会切换对话模型;层次活化仍然取决于对话模型的相容性. 现有保存的首选项凌驾于 [安装前](https://npmcn.com/package/%40buyong/pi-codex/#readme-before-installing) 页:1.

使用 `/codex-memory` 用于管理笔记,选择模型和预算,并启用背景内存生成. `/codex-memory status` 不叫模特儿。 使用 `repositories` 管理明确确认的其他储存库 `legacy` 有选择地导入旧的 cwd 记忆; 既不自动合并范围。 生成向选定的提供者发送蒙面会话副本并使用其计费或订阅配额.

构成部分指南还包括: `/approve-model`, (中文(简体) ), `/approve retry`,则 `/codex-fast` 子命令、设置文件和失败。 在给予持续应用许可或使用付费服务级别之前,请遵循这些指令.

## 保护启动是一个单独的选择

一般的 Pi 扩展发现在扩展失败加载后可以继续. 因此安装捆绑 **没有** 保证从批准控制开始执行.

如果需要这种担保,请使用 [自动审查保护的CLI或SDK](https://github.com/buYoung/pi-packages/blob/main/apps/pi-codex-auto-review/docs/usage.md#run-with-protected-startup)。它已经包括自动审查和禁用扩展发现。 逐一装入您需要的其他组件 `--extension` 选项( SDK : `trustedExtensionPaths`),将每个组件的条目文件传递到捆绑内,例如 `<bundle path>/node_modules/@buyong/pi-codex-fast-mode/dist/index.js`· ; `pi list` 显示捆绑路径。 不要通过整个捆绑, 因为那装上第二个自动审查扩展。 批准的命令仍然以主机权限运行,而不是OS sandbox.

## 从源头构建和加载

运行从 [包装](https://github.com/buYoung/pi-packages) 仓库根 :

```sh
pnpm install
pnpm --filter "@buyong/pi-codex..." build
pi -ne -e ./apps/pi-codex
```

构建首先构建组件,然后在捆绑内分级其可发布的文件和运行时间依赖性. `-ne` 禁用自动扩展发现,以及 `-e` 只为此运行加载此软件包, 而不保存到 Pi 的设置 。 桌面先决条件和订阅登录仍然有效 .

更改组件后重建:捆绑会加载其已上架的复制件,而不是组件源目录.

## 包内容和放行令(维护者)

清单列出5个延期: `workspace:*` 依赖性和包包通过 `bundleDependencies`; 包装书写工作空间版本. `pi.extensions` 财务报告和审定财务报表 `pi.skills` 指向他们的原始切入点和技能目录。 开发依赖,Pi主机,以及私人的Codex运行时间被排除在外.

先放出已更改的组件,然后放出捆绑. 捆绑在捆绑的放出标记上从这个寄存器中将每个组件放出,所以一个未放出组件的改变会在该组件的当前版本下在捆绑内运送. 见 [仓库发布进程](https://github.com/buYoung/pi-packages#shared-ci-and-per-package-releases) 供出版和特定软件包使用.

## 许可证

[阿帕奇 - 2.0](https://npmcn.com/package/%40buyong/pi-codex/LICENSE),作为 `LICENSE` 在 npm 归档中。 包括附属公司保留自己的许可证和归属通知.

## 常见问题

### @buyong/pi-codex 是什么？

Pi 的 Codex 捆绑:安装自动批准审查,计算机使用,快取模式,图像生成,和内存一起\.

### 如何安装 @buyong/pi-codex？

在项目目录运行 npm install @buyong/pi-codex，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@earendil-works/pi-ai（\*）、@earendil-works/pi-tui（\*）、@earendil-works/pi-coding-agent（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @buyong/pi-codex 支持 TypeScript 吗？

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

### @buyong/pi-codex 支持 ESM 还是 CommonJS？

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

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

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

### @buyong/pi-codex 可以商用吗？

@buyong/pi-codex 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @buyong/pi-codex 的下载量有多少？

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

### @buyong/pi-codex 还在维护吗？

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