@raoxxxwq/pi-codex-fast

面向 Pi 的 Fast Mode 扩展。它为配置命中的 OpenAI Responses / Codex Responses 请求设置 serviceTier: "priority"，并提供 /fast 命令与状态指示。

本项目是 wobondar/pi-codex-fast 的公开 fork；npm package name 使用独立 scope，避免与上游包混淆。

特性

• 使用 /fast 命令启用、停用、切换或查看 Fast Mode。
• 通过 provider 与 model 白名单精确控制 Fast Mode 的适用范围。
• 支持 openai、openai-codex 和 openai-responses provider。
• model 白名单同时支持 provider/model 与 bare model id。
• 提供 static、rainbow 和 glow 三种状态栏样式。
• 未命中配置的请求沿用 Pi 原有 streamer，不改变请求行为。

priority service tier 的可用性和计费由 provider 决定。启用前请确认账号权限与当前价格。

环境要求

• Node.js >=24
• Bun（仅开发时的 check:import 与 release gate 需要；消费者运行扩展无需安装）
• 支持 Pi packages 的 Pi 版本

本项目当前使用 @earendil-works/pi-* 0.82.1 与 Bun 1.3.14 作为开发和发布验证基线；peerDependencies 由 Pi host 提供。

安装

安装 npm package：

pi install npm:@raoxxxwq/pi-codex-fast

临时试用固定版本，不写入 settings：

pi -e npm:@raoxxxwq/[email protected]

从本地 checkout 安装：

pi install ./path/to/pi-codex-fast

如果 Pi 已在运行，安装后执行 /reload。

上游 npm:pi-codex-fast 与本包都会注册 /fast 命令。请只启用其中一个，避免命令和 provider wrapper 重复注册。

命令

| 命令 | 作用 | | -------------- | --------------------------------------- | | /fast | 切换 Fast Mode | | /fast on | 启用 Fast Mode | | /fast off | 停用 Fast Mode | | /fast toggle | 切换 Fast Mode | | /fast status | 显示当前状态与匹配范围 | | /fast style | 在 static、rainbow、glow 之间循环 |

配置

首次加载时会创建：

~/.pi/agent/extensions/pi-codex-fast.json

配置文件名保留 pi-codex-fast，用于兼容既有本地配置；它与 scoped npm package name 不同。

默认配置：

{
  "enabled": false,
  "models": [
    "openai/gpt-5.4",
    "openai/gpt-5.5",
    "openai-codex/gpt-5.4",
    "openai-codex/gpt-5.5",
    "openai-responses/gpt-5.4",
    "openai-responses/gpt-5.5"
  ],
  "providers": ["openai", "openai-codex", "openai-responses"]
}

models 也可以使用 bare model id；style 省略时默认为 static：

{
  "enabled": true,
  "models": ["gpt-5.5", "gpt-5.6-sol"],
  "providers": ["openai", "openai-codex", "openai-responses"],
  "style": "glow"
}

只有同时满足以下条件的请求才会使用 Fast Mode：

1. enabled 为 true；
2. 当前 provider 位于 providers；
3. 当前 provider/model 或 bare model id 位于 models。

开发

git clone https://github.com/MuJianxuan/pi-codex-fast.git
cd pi-codex-fast
npm install
npm run verify

npm run verify 会依次运行：

1. format check；
2. lint；
3. TypeScript typecheck；
4. Vitest；
5. extension import smoke test；
6. Pi isolated-load smoke test；
7. npm tarball dry-run。

也可以单独运行：

npm test
npm run test:watch
npm run test:pi
npm run pack:check

发布

发布前检查步骤记录在 .docs/release-checklist.md。仓库不会通过脚本自动执行 Git commit、tag、push 或 npm publish。

License

MIT。保留上游作者的版权声明，并记录本 fork 的修改版权。