# @felan-ai/ext-codex 中文文档 规范地址：https://npmcn.com/package/%40felan-ai/ext-codex/ 版本：0\.12\.0 npm 元数据更新时间：2026-11-04T17:25:43.625Z 中文译文更新时间：2026-11-14T14:01:47.034Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40felan-ai/ext-codex 原文对照：https://npmcn.com/package/%40felan-ai/ext-codex/?lang=original 项目主页：https://github.com/felan-ai/felan#readme 源码仓库：https://github.com/felan-ai/felan ## 关键信息（来自 npm 元数据） - 包体积（解压后）：134 kB，56 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=22\.19\.0 - 运行依赖：1 个 - peer 依赖：@felan-ai/agent-core ^0\.15\.0 - 首次发布：2026-08-06T13:11:19.833Z - 最新版本发布：2026-11-04T17:25:43.289Z - 近 30 天下载量：2290（2026-10-15 至 2026-11-13，npm 官方下载统计） - 已发布版本数：37（近 12 个月 37 个） ## 中文简介 Felan 的可编码兼容结构化工具和 OpenAI 请求控制 ## 安装 ```sh npm install @felan-ai/ext-codex ``` 也可以使用：`pnpm add @felan-ai/ext-codex`、`yarn add @felan-ai/ext-codex`、`bun add @felan-ai/ext-codex` ## README # @ felan-ai/ext-codex (英语) 第一党Felan支持GPT编码工具和Codex图像生成. 结构化工具仅在选定模式ID为 GBT- family 时激活 而提供者正是 `openai` 或者说 `openai-codex`。 。 。 . 活动模式保持常态 `read`, (中文(简体) ), `bash`工具,仅替换 `edit` 财务报告和审定财务报表 `write` 与 `apply_patch`。切换到另一个模型可以恢复 普通编辑工具。 文件操作使用当前 `AgentRuntime`。 。 。 . 本地 TUI 呈现带有友好动作标签的补丁呼叫, 而无头 模式继续显示稳定的工具名和原始结果. ## 入境点 - `@felan-ai/ext-codex` 是守护进程和 无头装入. 内容 `createCodexTools` 导出只执行的工具. - `@felan-ai/ext-codex/runtime` 仍然是直接进入的无渲染器条目 改为 `createCodexExtension`, (中文(简体) ), `createCodexExecutionTools`,并请求控制. 所有默认条目都带有相同的执行贡献. 代理核心解析 它来自已验证的扩展配置并应用已配置的流 包装;主机不需要有 Codex 专用的包装或包名分支. 丰富的补丁调用渲染属于 `apps/felan`; 包输出无 TUI 条目 . 根和(或) `/runtime` 导出相同的便携式 API,包括 `createCodexTools`。 。 。 . 已配置的主机应该导入根而无需重写特定软件包路径 . 对于符合条件的答复请求, `extensionConfig.codex.priority` 接受 `normal`, (中文(简体) ), `fast`,或 `ultrafast`数字 : ```json { "extensionConfig": { "codex": { "priority": "ultrafast" } } } ``` 这个 `fast` 布尔被腐烂并隐藏在 `/settings`; 已存在的配置 文件和 CLI 选项仍然支持。 明确的优先权凌驾于它之上。 奥米 `priority` 改为 保留 `fast: true` (优先处理)或 `fast: false` (无分级覆盖). 既未配置, 也不要求分级 . `normal` 明确 请求标准 `default` 等级,即使 `fast` 这是真的. 超快板目前适用于精确的 `gpt-6-astra` 财务报告和审定财务报表 `gpt-6.1-sol` 模式 符合资格的OpenAI和Codex Response线路的ID. 其他合格的GBT模型 变回快( e)`priority`) (中文(简体) ). Pi不暴露服务能力 元数据, 因此此模式规则在扩展名中保留, 而不是获取 从目录. 账户、计划、工作空间和终点资格仍然适用;被拒绝 请求不会自动在另一层次重新审理. 快速和Ultrafast消耗了溢价。 通常引用的 2x/8x 数字 并不是通用的计费乘数或保证任务速度的增加. 咨询 [OpenAI 速度文档](https://learn.chatgpt.com/docs/agent-configuration/speed) 和您认证方法的 API 定价 。 皮的本土成本估计 目前不包括Ultrafast特定定价。 优先选择确实 不改变模型的推理努力或迁移. `postAgentRunCompaction` 默认启用。 它使得符合资格的GPT运行推迟 皮的自动阈值收缩,直到当前代理运行结束 保留0.84.4前的时间,同时允许已完成的工具循环 结束。 准备吧 `false` 使用 Pi 的标准时间。 手动和 溢出回收的收缩仍然迫在眉睫。 Pi仍然拥有摘要生成; 此设置无法启用上游 OpenAI 本地响应收缩 . 对于符合条件的回复请求,扩展将 Pi 转换为无效 函数工具 `strict` 值为 `false` 因此,可选参数仍然是可选的. 明确 `true` 或者说 `false` 值、缺失值和无效工具 保持不变. Pi在其内置的OpenAI和OpenAI Codex目录中包括了GPT-6 Astra. 现有的GPT政策可以使这一扩展系统具有结构化的工具和本土 没有习惯的响应控制 `models.json` 输入. 用于GPT-6 Astra、Sol、Luna和GPT-6.1 使用 `openai-responses` 带有 OpenAI API 密钥, Pi 发送本地 `configuration_update` 项本身并保存 请求级别 `reasoning.effort` 固定在 `medium`用于 `openai-codex-responses` 在任一符合条件的提供者上,此扩展保留初始请求级别 努力和项目a `configuration_update` 在下一个用户消息之前. 老年人 `openai`编号 :`openai-responses` 届会忽略持续 `codex-reasoning-update` 输入并恢复到 Pi 固定位置 `medium` 请求努力, 所以,如果最初的努力没有成功,预计会出现一次即时缓存 `medium`。 。 。 . 延长的更新保留到会话续会和叉 Pi收缩,新背景确定了自己的努力基线. 已排队 用户后续在下次回复前收到更改; 仅限工具 继续没有。 没有其他用户回合的更改记录在 跑步会解决的 这些扩展更新需要标准,单一代理 响应请求; 亲模式, 服务器侧多代理模式, 聊天补全, 其他 GPT 模型,和 Anthropic 不支持。 自动服务器切换 和收缩不能与本地更新相结合; Pi 的现有本地更新 仍可收缩. 实际缓存点击也取决于提供者缓存 符合条件,并可以使用响应用量缓存到的计数来检查. 原因更新不会改变提供者运输. `forceCachedWebSockets` 仍仅适用于 `openai-codex` 编号 : `openai-codex-responses`; 官员 OpenAI API继续使用Pi的本土交通. 扩展不包括可重新开始的工作、网页访问、, 代码模式/响应 列表 快速替换 本地响应收缩, 语音和UI部件. ## 代码图像生成 `extensionConfig.codex.imageGeneration` 默认为 `true`当主机 用品 `MODELS_SERVICE`,扩展名只登记图像 `openai-codex-images` 提供者为 `gpt-image-2` 财务报告和审定财务报表 `gpt-image-2.5`。 。 。 . `@felan-ai/ext-model-tools` 揭露这些通过 `generate_images` 当 会话已认证 `openai-codex` 登录。 运行 `/login openai-codex` 改为 使用遗留的 Codex 登录。 与 ChatGPT 签约 `openai` 提供者这样做 不启用这些图像模型 。 选中的聊天模式不需要使用 密码 限定的会话 `enabledModels` 未列出图像模型, 因为 范围只包含聊天模式. 请求使用 `POST https://chatgpt.com/backend-api/codex/images/generations`, (中文(简体) ), 或者说 `/images/edits` 在同一后端上,最多有5个参考图像。 他们 设定 `background` 改为 `opaque`, (中文(简体) ), `quality` 财务报告和审定财务报表 `size` 改为 `auto`,则 `originator` 页眉到 `pi`。请求数与 ChatGPT 计划编码 使用,不是OpenAI API计费. 这些模型没有API的价格,所以Felan报告 返回的代号数,不计算美元成本. 设定 `imageGeneration` 改为 `false` 以禁用提供者注册而无需 更改 Codex 聊天行为 。 更改后恢复或创建会话 . ## 发展 ```sh pnpm --filter @felan-ai/ext-codex build pnpm --filter @felan-ai/ext-codex type-check pnpm --filter @felan-ai/ext-codex test ``` 见 [通知](https://npmcn.com/package/%40felan-ai/ext-codex/NOTICE) 上游归属. ## 一揽子边界和要求 Agent Core拥有运行时间合同,而Pi拥有聊天提供运输. 这个 软件包拥有提供者/模型资格、结构化补丁替换、请求 控件,以及只显示图像的提供者。 它不会取代 Pi 的聊天提供商. 文件操作通过活动 `AgentRuntime`。 。 。 . 软件包需要兼容 `@felan-ai/agent-core` 鼠标和类型框. 没有根,也没有 `/runtime` 装入终端渲染器。 主机模式尚存 当前用户访问,而不是沙盒. ## 相关文件 - [代码工具配置](https://npmcn.com/package/docs/user-guide/configuration.md#codex-tools) - [运行时间和安全](https://npmcn.com/package/docs/concepts/runtime-and-security.md) - [扩展目录](https://npmcn.com/package/docs/reference/extension-catalog.md) ## 归属 部分实施行为从审查中调整 `@howaboua/pi-codex-conversion` 财务报告和审定财务报表 `@howaboua/pi-codex-imagegen` 来源. 见 [通知](https://npmcn.com/package/%40felan-ai/ext-codex/NOTICE) 财务报告和审定财务报表 [自由主义](https://npmcn.com/package/%40felan-ai/ext-codex/LICENSE) 来源的承担和归属. ## 常见问题 ### @felan-ai/ext-codex 是什么？ Felan 的可编码兼容结构化工具和 OpenAI 请求控制 ### 如何安装 @felan-ai/ext-codex？ 在项目目录运行 npm install @felan-ai/ext-codex，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@felan-ai/agent-core（^0\.15\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @felan-ai/ext-codex 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @felan-ai/ext-codex 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @felan-ai/ext-codex 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22\.19\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @felan-ai/ext-codex 可以商用吗？ @felan-ai/ext-codex 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @felan-ai/ext-codex 的下载量有多少？ 根据 npm 官方下载统计，@felan-ai/ext-codex 在 2026/10/15 – 2026/11/13 这 30 天内被下载 2,290 次，日均约 76 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @felan-ai/ext-codex 还在维护吗？ 最新版本 0\.12\.0 发布于 2026/11/05（9 天前）；至今共发布 37 个版本，其中过去 12 个月发布了 37 个；首次发布于 2026/08/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。