# @hank-warren/pi-cliproxyapi-provider 中文文档

规范地址：https://npmcn.com/package/%40hank-warren/pi-cliproxyapi-provider/

版本：0\.6\.0
npm 元数据更新时间：2026-11-16T20:50:45.696Z
中文译文更新时间：2026-11-17T19:33:40.815Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：170 kB，27 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.19\.0
- 运行依赖：0 个
- peer 依赖：@earendil-works/pi-ai \*，@earendil-works/pi-tui \*，@earendil-works/pi-coding-agent \*
- 首次发布：2026-09-10T18:34:32.011Z
- 最新版本发布：2026-11-16T20:50:45.507Z
- 近 30 天下载量：4472（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

0xRichardH/pi-cliproxyapi-professor:有模型发现,模型的CLIProxyAPI的Pi提供商. dev浓缩从pi的内置目录,Anthropic Messages为克洛德的路由,Codex的响应路由,并衍生出x高/最大思维水平

## 安装

```sh
npm install @hank-warren/pi-cliproxyapi-provider
```

也可以使用：`pnpm add @hank-warren/pi-cliproxyapi-provider`、`yarn add @hank-warren/pi-cliproxyapi-provider`、`bun add @hank-warren/pi-cliproxyapi-provider`

## README

# pi- cliproxyapi 提供者

> **出版分叉.** 这是 `pi-cliproxyapi-provider` 0.15.23 (麻省理工学院,Richard Hao),在 [`hank-warren/pi-cliproxyapi-provider@3a4d021`](https://github.com/hank-warren/pi-cliproxyapi-provider/tree/3a4d021), (中文(简体) ), 6项在上游之前承付 [`0xRichardH/pi-cliproxyapi-provider`](https://github.com/0xRichardH/pi-cliproxyapi-provider)数字 : 用于克洛德模型的Anthropic Messages路由, stale模型的自动刷新. dev元数据, 财务报告和审定财务报表 `xhigh`编号 :`max` 思考水平来自模型.dev 努力列表. 4.7 MB 捆绑起来 模特们 dev种子已去;首发的元数据来自pi自己的内置模型目录取而代之. 永远不要同时安装此软件包和上游软件包,否则供应商会被注册两次.

`pi-cliproxyapi-provider` 登记号 1 [CLIProxyAPI (英语)](https://github.com/router-for-me/CLIProxyAPI) 作为Pi模型提供者。 它从CLIProxyAPI的OpenAI相容性中发现了模型 `/v1/models` 端点,从 CLIProxyAPI 自己的模型注册簿中取出每个模型的名称,限制,输入模式和思维水平,并填入成本和CLIProxyAPI 不发布的任何信息 [模式.dev](https://models.dev/)。混合目录默认使用 OpenAI 补全,而 Codex 服务的 GBT 模型( pi 中的每个模型) `openai-codex` catalog,外加GPT-5.5,GPT-5.6和GPT-6 ids the running pi does not list)使用响应API,使pi能够读取他们的用法数据,克洛德模型使用Anthropic Messages API,因此签名的思维块和每回转的思维努力活过多回转的对话. 光学 `/v1/models` 拥有者,例如 `openai` 选择匹配的提供者元数据; 当代理路由计费不同时, 别名可以覆盖该选择 .

## 安装

```bash
pi install npm:@hank-warren/pi-cliproxyapi-provider
```

安装后重新启动 pi, 然后运行 :

```text
/cliproxyapi config
/login cpa
/model
```

在不安装的情况下尝试它, 从此寄存器的检出 :

```bash
CLIPROXYAPI_BASE_URL=http://localhost:8317/v1 \
CLIPROXYAPI_API_KEY=your-key \
pi -ne -e ./packages/pi-cliproxyapi-provider --list-models cpa
```

## 配置

运行交互命令 :

```text
/cliproxyapi config
```

它写全局连接/自动配置为:

```text
~/.pi/agent/pi-cliproxyapi-provider/config.json
```

环境变量覆盖配置 :

```text
CLIPROXYAPI_BASE_URL
CLIPROXYAPI_PROVIDER_NAME
CLIPROXYAPI_AUTH_REQUIRED
CLIPROXYAPI_AUTH_HEADER
CLIPROXYAPI_MODELS_DEV_ENABLED
CLIPROXYAPI_METADATA_FALLBACK_PROVIDER
```

`CLIPROXYAPI_API_KEY` 为非交互运行提供发现证书。 设定 `CLIPROXYAPI_METADATA_FALLBACK_PROVIDER=none` 以禁用未解决的模型元数据回落.

项目配置支持 `metadataFallbackProvider`,元数据化名, 和每个模型的边框覆盖。 设定 `metadataFallbackProvider` 改为 `null` 或者说 `"none"` 以禁用倒转。 连接和认证设置, 如 `baseUrl`, (中文(简体) ), `providerName`, (中文(简体) ), `authRequired`, (中文(简体) ), `authHeader`,以及 `headers` 必须设置在全局配置或环境变量中.

### GPT-5.6 / GPT-6 上下文窗口

CLIProxyAPI为每个Codex服务GPT路由发布两个窗口: `context_window`,该路径的默认值,以及 `max_context_window`上限a `max-context-length` 覆盖打开 。 默认提供商会发布广告 `context_window` (单位:千美元)`272000` 对于大多数 Codex 路线, `500000` 用于GPT-6.1 Sol, `1000000` 为德文的GPT-5.6路线. 小皮的原生窗户 `272000`中,仅用于 CLIProxyAPI 发布无窗口.

要选择全部上下文限制,请在全局设置中添加此套件专用设置 `~/.pi/agent/settings.json`数字 :

```json
{
  "pi-cliproxyapi-provider": {
    "gpt56ContextWindow": "full"
  }
}
```

相同的设置可以放置在工程中 `.pi/settings.json`; 项目设置覆盖全局设置 。 支持的值为:

-   `"canonical"` (默认):广告CLIProxyAPI的 `context_window` 为路线.
-   `"full"`:广告路线的天花板,CLIProxyAPI的 `max_context_window` (单位:千美元)`872000` 为GPT-6在Codex路线上,倒回模型. dev限制,允许pi在收缩前保留大量历史.

使用 `"full"` 仅当选定的 CLIProxyAPI 路由和上游账户实际支持此限制时. 以上要求 `272000` 输入符也使用更高的模型. 确定上下文定价等级.

### 模型和显示配置

运行 `/cliproxyapi config` 在 pi 的 TUI 中编辑每个软件包级别 `settings.json` 数值。 标签面板有 `Connection`, (中文(简体) ), `Models`,以及 `Display` ;它控制了GPT-5.6上下文窗口模式,每回合Claude努力,Claude中对话更新,Claude消息线索,以及模型选择器是否显示已公布的严格工具-schema能力.

```json
{
  "pi-cliproxyapi-provider": {
    "gpt56ContextWindow": "canonical",
    "perTurnEffort": true,
    "midConversationUpdates": true,
    "messageThreads": false,
    "showStrictMode": false
  }
}
```

`showStrictMode` 默认为 `false` 因为选取者会保持紧凑,以便正常使用。 诊断工具- schema 行为时启用它; 模型细节总是显示 `Strict tool schema` 当然 保存通过 `/cliproxyapi config` 重新装入 pi。 选择 `Connection` 打开端点和认证编辑器.

## 认证

使用 pi 的正常 API- key 登录流量 :

```text
/login cpa
```

如果您更改了提供者名称, 请使用该名称 。 对于非交互运行,设置 :

```bash
export CLIPROXYAPI_API_KEY=your-key
```

## 图标

```text
/cliproxyapi config             # tabbed connection, model, and display configuration
/cliproxyapi config connection  # open endpoint and authentication editor
/cliproxyapi status             # show snapshots, capabilities, and enrichment counts
/cliproxyapi refresh            # refresh models and metadata, then update pi immediately
/cliproxyapi refresh models     # refresh CLIProxyAPI availability only
/cliproxyapi refresh metadata   # refresh models.dev metadata only
/cliproxyapi aliases            # show unmatched model IDs for metadata aliases
/cliproxyapi models             # inspect effective model settings and set bounded overrides
/cliproxyapi help               # show this list
```

## 思考层面

派只提供延期 `xhigh` 财务报告和审定财务报表 `max` 当一个模型发布一个 `thinkingLevelMap` 命名它们; 没有一个,每个推理模型都停止在 `high`。 。 。 .

**CLIProxyAPI的努力列表首先决定.** 其模式目录(参见 [元数据是如何来源的](https://npmcn.com/package/%40hank-warren/pi-cliproxyapi-provider/#readme-how-metadata-is-sourced)列出其登记册接受的每个路线的工作,该清单决定pi提供何种级别:每个列出的级别地图, `none` 地图到 `off`,而一个级别 CPA 不列表则隐藏。 列表中不能说的两件事来自别处:

-   **`off` 克劳德.** CPA的目录 放弃注册 `zero_allowed` 旗帜,所以它只能说 `off` 通过列表 `none`这对克洛德来说从未如此 Pi的本地克洛德定义决定了:Opus 4.7和4.8保留 `off`,会计师协会接受为 `thinking.type = disabled`,而Fable 5.x和Opus 5则隐藏它,因为上游拒绝残疾思维. Claude模特儿不知道要什么 `off` 从元数据, 否则pi的默认。 没有其他模型 `none` 隐藏 `off`。 。 。 .
-   **`minimal` 代码路径**,没有这样的努力: pi 发送 `low` 对于它来说,正如它的原生 Codex 定义所做的,而不是隐藏关卡.

CPA的清单在两个案件中无法使用,由以下资料来源决定。 空列表指登记册按预算说明思维,或根本不说明。 确切名单 `low`编号 :`medium`编号 :`high`编号 :`xhigh` 这是 `gpt-5.5` 模板, CPA 在任何模型上贴上它登记册没有思考数据, 所以除了真实数据外,它不能被告诉, 被忽略 .

没有可用的 CPA 列表, 软件包将地图取自它已经拥有的元数据: pi 的内置目录 发布一个完成的目录 `thinkingLevelMap` 每个模型,和一个模型。 dev 条目中缺少一个条目的,其地图来源于 `reasoning_options` - 提供者接受的每一项努力(`low` . `max`地图到自己,而提供者不接受地图到任何 pi 级别 `null` 所以Pi隐藏了那个关卡 Claude Fable 5.x、Opus 4.7+和Sonnet 5因此曝光 `xhigh` 财务报告和审定财务报表 `max`; Opus 4.6 曝光 `max` 但没有 `xhigh`;模型描述时只使用思维预算来保持pi默认的预算映射.

`off` 遵循相同的数据。 A 类 `none` 工作地图,a `toggle` 选项可以使用,一个既无(Claude Fable 5.x)的模型标记它 `null`,因为上游拒绝 `thinking.type = disabled` 这些模型.

在这些倒计时中,pi自己的本土定义为克洛德和Codex服务的GBT模型取胜. 模特们 dev 描述公共API,而 CLIProxyAPI 前置 Anthropic 和 Codex 后端,这是 pi 的 `anthropic` 财务报告和审定财务报表 `openai-codex` catalogs 精确描述——例如, Codex 路由没有 `minimal` 努力( CLIProxyAPI 拒绝), 所以 pi 的本地地图发送 `low` 对于它。 软件包读取了运行中的 pi 的这两个目录,所以 pi 升级带来了新的模型和能力变化,没有在此发布. 手写出GPT-5.5,GPT-5.6和GPT-6地图仅保留为正在运行的pi没有列出的ID的倒置图,无论它们比它更新,还是后来的pi被丢弃. Pi的原始克洛德地图也曝光了 `off` 用于 Opus 4.7 和 4.8, CLIProxyAPI 接受为 `thinking.type = disabled`。 。 。 .

一个既无可用《全面和平协定》清单的模型, 也没有这些来源 `/cliproxyapi models` 能够覆盖.

### (克洛德)

**需要 CLIProxyAPI v8.0. 3 或 后期 .** 旧版本拒绝每轮指令 `messages.N.output_config: Extra inputs are not permitted`,该选项不满足对这些模型的每个请求;设置 `"perTurnEffort": false` (或在其下方禁用) `/cliproxyapi config` → `Models`对于他们来说,努力可以追溯到请求的上层 `output_config`。 。 。 .

Claude模型Pi的本地目录标记 `supportsMidConvoEffort` (Opus 5, Opus 5.5, Sonnet 5.5和Fable 5.1 in pi 1.0)也在这里发表,当CLIProxyAPI在下行报告时 `anthropic` 拥有者。 它服务于另一个上游(Antigravity,一个OpenAI相容的提供者)的模型被翻译出脱离了Messages形状,指令无法存活,因此它保持了顶级努力. 改变思维层面的会中,然后变成每回合指令,而不是改变请求的顶级 `output_config`,因此即时缓存在开关中幸存:通过CLIProxyAPI v8.0.3进行校验,其中跨越一个工具循环的一次努力切换持续读取了整个缓存的对话,而顶层形式则重写. 已签名的思维在切换处重放 。 其他克洛德模型保持顶级努力.

### 中交更新 (克洛德语)

**需要 CLIProxyAPI v8.0.4 或较后.** 较早的发布不会在内部重写工具名 `tool_addition`编号 :`tool_removal` oAuth 证书的块[路由器换我/CLIProxyAPI#6174](https://github.com/router-for-me/CLIProxyAPI/issues/6174)),因此工具更改后的第一个请求与“引用未知工具”失败;设置 `"midConversationUpdates": false` (或在其下方禁用) `/cliproxyapi config` → `Models`为他们.

Claude模型Pi的本地目录标记 `supportsMidConvoSystemMessages` (和 `supportsMidConvoToolChanges`在同一个地方出版 `anthropic`\-所有者统治,每回合努力。 Pi 然后发送一个后期系统即时变化作为 `role: "system"` 信件和工具更改为 `tool_addition`编号 :`tool_removal` 块相对于被推迟的声明,而不是重写请求的系统即时和工具列表。 缓存前缀可以存活 。 在 Opus 5 和 Sonnet 5.5 上通过 CLIProxyAPI v8.0.15 验证,并附有 OAuth 证书:

-   在一个切换去一个工具并添加另一个工具的转弯上,缓存读取了大约6300个令牌;倒塌的表单读取了0并重写了整个前缀.
-   添加的工具是用它自己的名字命名的,《全面和平协议》将其OAuth别名绘制回图.
-   同一转弯上的转动也保留了缓存.

Models pi不标记已倒闭的窗体,任何系统即时或工具都会更改缓存.

### 信件线索 (Claude)

**默认关闭.** 打开它 `"messageThreads": true`,或低于 `/cliproxyapi config` → `Models`。它需要 CLIProxyAPI v8.0.63 或稍后,它转发 `message-threads-2026-08-12` β和通向每个创建其线程的证书的续作;v8.0.68或后作也使一线程的β剖面在转弯上保持稳定.

Pi 默认只为自身打开信件线索 `anthropic` 打开 `api.anthropic.com`。随着设置的启动,本软件包将出版 `supportsMessageThreads` 每一个Claude model pi的本地目录都知道, 在同一下 `anthropic`\- 所有权规则作为轮回努力; `devin/` 路由被排除,因为 Devin 没有Anthropic 线程状态。 Pi 然后发送会议的第一个请求 `thread: {"type": "create"}` 之后的每个 `thread: {"type": "continue", "previous_message_id": …}` 仅包含新信件,没有系统提示或工具。 它需要一个会话 ID, 所以会话有缓存保留 `none` 发送全部请求.

CLIProxyAPI保持了续作在内存中需要的状态. 重启后, 或线程被拆卸后, 它会回答 `404` 与 `error_code: "thread_not_found"`,Pi将整个对话重放为新线索. 一个直接拒绝线程的代理 `400` 把他们关了 剩下的时间.

续作只能在创建其线程的证书上运行. 当证书被禁用时, 删除、 冷却或退出配额, 发布 CLIProxyAPI 版本的答案为普通 `503` 或者说 `429` 改为 `thread_not_found`。主会话通过 pi 的自动重试恢复,在出现一个明显的错误后;像自动权限审查器这样的单发呼叫失败了。 路由器- for- me/ CLIProxyAPI#7611 使 CLIProxyAPI 回答 `thread_not_found` 那样的话,Pi就毫无错误地重放. 这就是为什么设定是默认的.

## 元数据别名

异名只影响元数据. 该套件仍会将原来的CLIProxyAPI型号ID发送给代理.

带有路由前缀的型号代号——账户被标注的别名如: `team/gpt-6-sol`,或诸如 `devin/claude-opus-5-5` - 不需要别名 当完整的ID与无相匹配时, 后面的基ID `/` 因此,在请求保留选择路由的前缀时,路径会获得模型的成本和能力。 完全id的别名,或为基id的别名,仍能取胜.

何时 `/v1/models` 报告犬类所有者,例如 `openai`,包中即使模型也使用该提供者的元数据. dev在多家提供者之下列出该模型. 非漫画主人可以嵌入一个提供者提示,所以 `feedmob-opencode-go` 决定: `opencode-go` 当提供商发布模型。 如果所有权仍未解决,当有一个匹配的OpenRouter条目时,包默认使用OpenRouter元数据. 设定 `metadataFallbackProvider` 给另一个模型。 dev 提供者 ID ,或到 `null`编号 :`"none"` 以禁用此倒计时 。 当 CLIProxyAPI 报告的拥有者或倒置者不匹配其限制和定价适用于您的设置的提供者时,添加一个别名.

将全局化名添加到 :

```text
~/.pi/agent/pi-cliproxyapi-provider/config.json
```

手动添加工程别名到 :

```text
.pi/pi-cliproxyapi-provider/config.json
```

工程配置读取 `metadataFallbackProvider`, (中文(简体) ), `modelAliases`,以及 `modelOverrides`; 其它字段被忽略.

```json
{
  "metadataFallbackProvider": "openrouter",
  "modelAliases": {
    "claude-opus-4-6-thinking": "anthropic/claude-opus-4-6",
    "gpt-5.6-sol": "openai/gpt-5.6-sol"
  },
  "modelOverrides": {
    "gpt-5.6-sol": {
      "contextWindow": 512000,
      "maxTokens": 32768
    }
  }
}
```

## 模范检查员和超标

运行 `/cliproxyapi models` 在Pi的TUI 检查模型 在目前的CPA快照。 选择器显示有效的API,推理模式,以及上下文窗口. 细节视图还显示输入模式,成本,思维水平,以及pi会公布的相容值.

仅 `reasoning`, (中文(简体) ), `contextWindow`,以及 `maxTokens` 可编辑。 值受安全预设的约束; 选择 `auto` 以删除一个覆盖并重载后恢复衍生值。 API 路由和兼容性保留提供商拥有: Codex 服务GPT 模型仍在使用 `openai-responses` 与克洛德模型在 `anthropic-messages`,而 CLIProxyAPI 则出版 `supportsStrictMode: false`。 。 。 .

对于SCPA答复请求,扩展还适用了Codex兼容的功能工具电线合同,该合同用于: `pi-codex-conversion`:每个功能工具明确带有 `strict: null`中选择工具参数,例如 `interactive_shell.listBackground` 不以ChatGPT 支持的 ChatGPT 取代 SA 认证、传输、发现或流 `openai-codex-responses` 供养.

## 抓图和启动

```text
CPA /v1/models:      local snapshot at startup, then a background refresh on every model discovery
CPA model specs:     fetched alongside each discovery (/v1/models?client_version=); a failure keeps the previous specs
models.dev metadata: persistent local snapshot, re-fetched in the background once it is a week old
first-run seed:      pi's own built-in model catalog, read in-process, no file and no network
```

快照在下面 :

```text
~/.cache/pi-cliproxyapi-provider/
```

启动后立即从当地已知的快照中注册提供者,从不自己获取任何东西. 由于磁盘上没有元数据快照,所以Pi的内置目录中的种子,所以寒冷的起步已经具备了Anthropic,OpenAI,Codex,xAI,Google和OpenRouter模型CLIProxyAPI通常前方的实际成本,上下文窗口和思维水平. 在第一次无《全面和平协定》快照的运行中,Pi在背景发现成功之前登记占位符.

每个模型发现 pi 触发器( 启动, 打开) `/model`)重新检查CLIProxyAPI的模型列表,并 **猪背一个模型。 当元数据快照被扭曲时 dev 抓取**:有的仍然是内置种子,有的则被缓存取来已超过7天了. 这让新上市的模型无法使用Pi的赤倒元数据(16384输出令牌,仅文本,零成本)渲染,直到有人注意到. 一个新鲜的快照从不自行再被取回,因此~7MB的下载仍然罕见. `/cliproxyapi status` 标出一幅刻薄的快照; `/cliproxyapi refresh metadata` 迫使现在得到.

因此种子是一层,从来就是天花板:第一个成功的模型. dev 获取写入缓存快照 **彻底取代它**,从那时起,除非该缓存被删除或变成没有源码提供者身份的后遗症,否则将不再咨询种子. `/cliproxyapi status` 命名当前来源 - `builtin (pi catalog generated <age>)` 在第一次接货之前, `cache, <age>` 后结.

手动刷新即刻更新运行的提供者; `/reload` 无需。 失败刷新保留每个源的最后一个已知好数据——一个模型. Dev outage从来不会阻止CLIProxyAPI模型的发现.

## 元数据是如何来源的

本节总结了叉子的架构决定记录("用CLIProxyAPI来进行发现和模型.dev来进行元数据"),它不作为单独的文件被运出.

CLIProxyAPI 是唯一的来源 _可用性_: 软件包从 `GET <baseUrl>/models` 并且从不要求管理API访问,所以不需要强大的管理密钥,代理则会保留存在的事实来源. 仅仅相信端点是不够的——它返回了ID和所有者,而没有其他东西——所以pi所需要的一切(文本窗口,输出限制,推理旗,图像支持,成本,思维级别)都从一个元数据目录中丰富而来,该目录按键是: `<provider>/<model-id>`。在同一决定中,在安装时间下载该目录被拒绝:安装时间的取取方式不灵活,并被固定下来.

**限制首先来自CLIProxyAPI.** 它的 OpenAI 形状 `/v1/models` 将每个条目划入 `id`, (中文(简体) ), `object`, (中文(简体) ), `created` 财务报告和审定财务报表 `owned_by`,但相同的 API 键可以读取 Codex CLI 的 CLIProxyAPI 构建目录(`/v1/models?client_version=`),包含其上下文窗口,输出限制,努力水平,输入方式和显示名称——包括自定义条目 `models.catalog` 以及像德文这样的供应商的命名空间 其限制与赤裸的模型不同 CLIProxyAPI是接受或拒绝请求的代理,所以 **它的出版都赢了**: 显示名称,上下文窗口,输出限制,输入模式和努力水平. 皮丝 `max_tokens` 然后匹配路由允许的内容(`devin/claude-opus-5-5`:64000,而非Anthropic's 128000),一个路由CPA作为仅提供文本的图像不提供. 该目录复制了每个模型的 Codex 模板,并覆盖了登记册所知道的内容,因此登记册缺少保留模板填充器的字段。 条目仅在携带时使用 `max_tokens`,仅来自登记处。 除非是空的或模板填充器,否则将使用其努力级别(见 [思考层面](https://npmcn.com/package/%40hank-warren/pi-cliproxyapi-provider/#readme-thinking-levels)) (中文(简体) ). 一个不是 CLIProxyAPI 的服务器忽略了查询并返回不产生光谱的平原列表 。 该目录为~2.5MB未压缩,因此它得到元数据获取时间预算而不是发现2 s,它的失败永远不会失败发现.

有两个目录按此顺序填写了《全面和平协定》没有公布的内容——费用始终如此,而《全面和平协定》模型目录的名称、模式和思维则被遗漏或只用填充器描述:

1.  **一个缓存模型. dev快照** 下级 `~/.cache/pi-cliproxyapi-provider/`,当存在并带有源提供者身份。 模特们 医生 _提供者_ 使用目录而不是它的实验室一级,因此有针对供应商的具体价格和上下文定价级别。 这是新鲜度层:模型上列出的一个模型. 在Pi下次发布前先出现.
2.  **Pi的内置模型目录**读取 `@earendil-works/pi-ai`是因为 `providers/all` 子路径,作为首发种子——取代 4.7 MB `data/models-dev-fallback.json` 备案上游船只。 它是纯粹的静态数据(没有证书,没有网络,没有我们的文件),从模型中再生. 在每一个 pi 发布, 所以它永远不能 比你运行的 pi 年长, 它已经携带每个模型的完成 `thinkingLevelMap` - 哪一个模型。 dev完全不发表. 六个供应商是种子: `anthropic`, (中文(简体) ), `openai`, (中文(简体) ), `openai-codex`, (中文(简体) ), `xai`, (中文(简体) ), `google`, (中文(简体) ), `openrouter`。 。 。 . `openai-codex` 条目也登记在 `openai/` 当键是免费的,所以CLIProxyAPI `owned_by: openai` 匹配 Codex 唯一的标识。 没有`cache` 快照算作stale,所以第一个模型发现仍然将其升级为活的模型. dev 获取 .

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}一个叫Pi的 `@earendil-works/pi-ai` 不导出 `providers/all` ——更古老的放出,或将来改名的放出——读取失败软:种子是空的,一个警告被记录下来,每个模型都用Pi的赤裸的默认来制取到第一个模型. 采取地盘 完全没有种子 没有什么变化,Pi的升级会缩小差距.

将一个 CLIProxyAPI 模型 id 匹配到目录条目是身份第一:一个明确的别名胜出,然后是精确的 id , 然后是条条条 `owned_by` 例如 `openai`,比较所有者提供商内部的不敏感点(Devin) `gpt-5-6-sol` → `openai/gpt-5.6-sol`; CLIProxyAPI 软件 `moonshot` 财务报告和审定财务报表 `zhipu` 拥有者映射到 `moonshotai` 财务报告和审定财务报表 `zhipuai`),然后是嵌入在非卡通所有者的提供者提示(`feedmob-opencode-go` → `opencode-go`时 `ken-team-litellm` 意思是没有上游),然后是一个独特的正统后缀. 所配置的 `metadataFallbackProvider` 应用,并且只有在提供者完全具备一个正常匹配时。 一个仍与无相匹配的前缀代号作为它的底号被重试. 一个模型.dev 极限 `0` (图像生成模型)计为未知. 没有源代码的后遗症平缓缓存会被忽略,有利于种子,直到被刷新取而代之. 异名只是元数据:已注册的 pi 模型保留了原来的 CLIProxyAPI id,因此请求仍然通过代理正确路由.

API的路由源于同一决定. 提供者默认其混合目录的 OpenAI 补全; Codex 服务的 GBT 模型( pi's) `openai-codex` catalog,回落到GPT-5.5/GPT-5.6/GPT-6 id图案)采取模型级响应超标,因为pi的符和成本核算需要它们的响应用法;克洛德模型采取Anthropic Messages超标,因为 CLIProxyAPI 代理Anthropic 上游在 `/v1/messages` 与签名的思维块保持完整,而"Chat Professions"形状既不能代表这些签名,也不能代表每个回合的思维努力——因此克洛德通过它路由失去了跨多回合工具循环的推理连续性. 这些模型还出版 `forceAdaptiveThinking`符合Pi的Claude本土定义 初始注册和动态刷新都公布了同样的实用模型定义.

## 归属

从 [`0xRichardH/pi-cliproxyapi-provider`](https://github.com/0xRichardH/pi-cliproxyapi-provider) (MIT,版权 (c) 2026 Richard Hao.). 见 [自由主义](https://npmcn.com/package/%40hank-warren/pi-cliproxyapi-provider/LICENSE)。 。 。 .

## 常见问题

### @hank-warren/pi-cliproxyapi-provider 是什么？

0xRichardH/pi-cliproxyapi-professor:有模型发现,模型的CLIProxyAPI的Pi提供商\. dev浓缩从pi的内置目录,Anthropic Messages为克洛德的路由,Codex的响应路由,并衍生出x高/最大思维水平

### 如何安装 @hank-warren/pi-cliproxyapi-provider？

在项目目录运行 npm install @hank-warren/pi-cliproxyapi-provider，或使用 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 需要手动安装。

### @hank-warren/pi-cliproxyapi-provider 支持 TypeScript 吗？

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

### @hank-warren/pi-cliproxyapi-provider 支持 ESM 还是 CommonJS？

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

### @hank-warren/pi-cliproxyapi-provider 需要什么版本的 Node\.js？

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

### @hank-warren/pi-cliproxyapi-provider 可以商用吗？

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

### @hank-warren/pi-cliproxyapi-provider 的下载量有多少？

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

### @hank-warren/pi-cliproxyapi-provider 还在维护吗？

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

