From f291dca54523d87f665b901631812183b39718f2 Mon Sep 17 00:00:00 2001 From: awork Date: Thu, 15 Oct 2026 23:36:44 +0800 Subject: [PATCH] docs(clients): PI-Desktop zero-code /bili/ entry + boundary notes (#2677 G6) --- CLIENTS.md | 2 ++ CLIENTS.zh-CN.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/CLIENTS.md b/CLIENTS.md index 0e650fdbb9..525b86ea84 100644 --- a/CLIENTS.md +++ b/CLIENTS.md @@ -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/`, 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. diff --git a/CLIENTS.zh-CN.md b/CLIENTS.zh-CN.md index b11a4bc9c3..408d5e9ad3 100644 --- a/CLIENTS.zh-CN.md +++ b/CLIENTS.zh-CN.md @@ -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。