Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions CLIENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -711,11 +711,13 @@ Verified entry points (community-maintained list — the mechanism is generic):
| **Void** | custom OpenAI-compatible endpoint setting |
| **Cursor** (single-model channel) | Settings → Models → OpenAI API key → **Override Base URL** |
| **Warp** | custom-model base URL setting |
| **PI-Desktop** (Electron + embedded pi SDK) | per-model custom entry — **Endpoint** field ("Model Freedom" / connect-your-own-provider) |

Notes:

- **Crush** is a launcher lane now — prefer `bili crush` (config untouched, HTTPS domains MITM'd automatically).
- **Zed** is a launcher lane too — prefer `bili zed` (Linux; config untouched, model domains MITM'd automatically, loopback providers stay direct). The settings.json `api_url` path above remains the cross-platform alternative.
- **PI-Desktop** (Electron + embedded pi SDK, 0.18.x): zero-code path = point the per-model **Endpoint** at `http://127.0.0.1:8787/bili/<upstream>`, keep the API key as-is, run `bili start`. First-class support (.piplug embedded proxy + plugins.aiuo.net listing) is tracked in #2677 — session-identity anchoring on this client awaits a real-machine wire capture (#2677 G4), so it is documented here as the supported configuration path, not as a verified 95–97% cache-hit lane. Do not stack the in-process bcp extension route on top of this one (#3238 documents its multi-turn limits on this host); coexistence relies on bcp's proxied-baseURL stand-down (real-machine check pending, #2677 G7).
- Clients you **sign into** (OAuth/subscription) usually hardcode the endpoint — the prefix trick doesn't apply; see the [MITM section below](#client-uses-httpproxy-connect-but-nothing-compresses) instead.
- Plain **web apps** (browser-only products) have no local traffic to intercept.
- VS Code extensions keep their base-URL fields in plain-text settings but secrets in the OS keychain — only the base URL ever needs editing here.
Expand Down
2 changes: 2 additions & 0 deletions CLIENTS.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -209,11 +209,13 @@ pi-subagents(pi.dev 上的包)为前台/后台子代理运行派生**子会话**
| **Void** | 自定义 OpenAI 兼容端点设置 |
| **Cursor**(单模型通道) | Settings → Models → OpenAI API key → **Override Base URL** |
| **Warp** | 自定义模型 base URL 设置 |
| **PI-Desktop**(Electron + 内嵌 pi SDK) | 每模型自定义条目 —— **Endpoint** 字段("Model Freedom"/接入自有 provider 入口) |

注意:

- **Crush** 已有启动器车道——直接用 `bili crush`(配置零改动,HTTPS 域自动 MITM)。
- **Zed** 也已有启动器车道——直接用 `bili zed`(Linux;配置零改动,模型域自动 MITM,环回 provider 保持直连)。上面的 settings.json `api_url` 路径仍是跨平台替代。
- **PI-Desktop**(Electron + 内嵌 pi SDK,0.18.x):零代码路径 = 把每模型 **Endpoint** 指到 `http://127.0.0.1:8787/bili/<上游>`,API key 原样保留,跑 `bili start`。一等支持(.piplug 内嵌代理 + plugins.aiuo.net 上架)在 #2677 跟踪——该客户端上的会话身份锚定尚待实机抓包确认(#2677 G4),故此处按「受支持的配置路径」而非「已验证 95–97% 缓存命中车道」记录。不要在这条路线上叠加进程内 bcp 扩展(#3238 记录了它在该宿主上的多轮局限);共存依赖 bcp 的 proxied-baseURL stand-down(真机核对待做,#2677 G7)。
- **账号登录**型客户端(OAuth/订阅)通常焊死端点——前缀技巧不适用,改看[下方 MITM 节](#客户端用-httpproxyconnect接入但从不压缩)。
- 纯 **web 应用**(只在浏览器里的产品)本地没有流量可截。
- VS Code 扩展的 baseURL 字段在明文设置里,密钥在系统钥匙串——这里只需要改 baseURL。
Expand Down
Loading