[ranxianglei]

Refs #2677(G6 缺口项)。驱动:owner 于 #3238 确认「本项目支持」(2026-10-15)+ 2026-10-10 指示「我们重点维护 billion-context」——PI-Desktop 支持在本项目落地,G6(零代码过渡 lane)是无决策依赖、可立即落地的部分。

What

纯文档,CLIENTS.md(en)+ CLIENTS.zh-CN.md(zh)镜像同步,「Adopting unlisted clients (#2340)」节各加两处:

1. 表格行:PI-Desktop(Electron + 内嵌 pi SDK)的 baseURL 所在——每模型自定义条目的 Endpoint 字段("Model Freedom"/接入自有 provider 入口)。
2. 注意条目:零代码路径(Endpoint 指到 http://127.0.0.1:8787/bili/<上游>,API key 原样保留,bili start),外加三条如实边界:
   • 一等支持(.piplug 内嵌代理 + plugins.aiuo.net 上架)在 [Feature] PI-Desktop support: embed bili proxy as a .piplug background service + register loopback provider (published on plugins.aiuo.net) — follows up on #1400 | [Feature] PI-Desktop 支持:bili 代理内嵌为 .piplug 后台服务 + 注册 loopback provider(plugins.aiuo.net 上架)—承接 #1400 #2677 跟踪;
   • 该客户端上的会话身份锚定尚待实机抓包确认([Feature] PI-Desktop support: embed bili proxy as a .piplug background service + register loopback provider (published on plugins.aiuo.net) — follows up on #1400 | [Feature] PI-Desktop 支持:bili 代理内嵌为 .piplug 后台服务 + 注册 loopback provider(plugins.aiuo.net 上架)—承接 #1400 #2677 G4)——故按「受支持的配置路径」记录,不宣称已验证 95–97% 缓存命中车道;
   • 不要叠加进程内 bcp 扩展路线([Bug][pi] PI-Desktop Host Support: getBranch-only Host Misidentified as Unsupported by Detection Gate + Per-Round View Rebuild Causes Compressed Blocks to Be Lost Across Rounds | [Bug][pi] PI-Desktop 宿主支持：getBranch-only 宿主被检测门误判 Unsupported + 每轮视图重建致压缩块跨轮丢失 #3238 D2 记录了它在该宿主上的多轮局限);共存依赖 bcp 的 proxied-baseURL stand-down(真机核对待做,[Feature] PI-Desktop support: embed bili proxy as a .piplug background service + register loopback provider (published on plugins.aiuo.net) — follows up on #1400 | [Feature] PI-Desktop 支持:bili 代理内嵌为 .piplug 后台服务 + 注册 loopback provider(plugins.aiuo.net 上架)—承接 #1400 #2677 G7)。

证据基础

vastsa/PI-Desktop 公开 README("Model Freedom" 一节):每个模型可独立配置 API Key + Endpoint,且有 connect-your-own-provider 入口 → 客户端暴露用户可编辑的模型端点,直接落在既有通用 /bili/ 机制(#2340)上。无代码改动、无新配置面、无行为变更。查重:无——CLIENTS.md en/zh 现无任何 PI-Desktop 条目;#2677 floor 3 已给出同一结论但尚未落地为文档。

Scope

仅 G6。路线 B(G1–G3:.piplug 构建目标、manifest、配置映射)仍阻塞在 G4 实机数据 + #2677 的路线/优先级拍板上,本 PR 不触碰。

[github-actions]

📦 Built Package Artifact

Branch: 2026-10-15_clients-pi-desktop-g6 (f291dca)

Option A — Install this exact build (recommended)

npm install -g billion-context@0.0.3846-pr.3306.1e2e962

This exact version is immutable and reproducible. The rolling pr tag tracks the newest test build across all PRs.

Option B — Download artifact

1. Download the artifact from the Actions run
2. Extract the tarball and install:

tar xzf billion-context-pr3306.tgz
npm install -g package

---

Install instructions are refreshed on each push.

[ranxianglei]

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

查重：不重复——CLIENTS.md en/zh 现无任何 PI-Desktop 条目；相关项 #2677（一等支持路线）/ #3238（bcp 局限记录）是不同 scope，非重复。

本 PR 是另一会话已完成的交付（floor 1 接单 + floor 2 构建产物 + #2677 floor 5 已公告），按 [PR] 规则走「拉分支核对代码、确认 CI 状态、报告结论」，未重做。

核对结论：diff 与 spec 逐字一致，内容可合；CI test 分片红是 master 既有问题，与本 PR 无关。

diff 核对（分支 2026-10-15_clients-pi-desktop-g6 @ f291dca，4 行 = 2 文件 × +2）：

• EN 表格行：PI-Desktop（Electron + 内嵌 pi SDK）→ 每模型自定义条目的 Endpoint 字段（"Model Freedom"/接入自有 provider 入口）✓
• EN 注意条目：零代码路径（Endpoint → http://127.0.0.1:8787/bili/<上游>，API key 原样保留，bili start）+ 三条边界齐全——① 一等支持（.piplug 内嵌代理 + plugins.aiuo.net 上架）在 [Feature] PI-Desktop support: embed bili proxy as a .piplug background service + register loopback provider (published on plugins.aiuo.net) — follows up on #1400 | [Feature] PI-Desktop 支持:bili 代理内嵌为 .piplug 后台服务 + 注册 loopback provider(plugins.aiuo.net 上架)—承接 #1400 #2677 跟踪；② 会话身份锚定尚待实机抓包确认（[Feature] PI-Desktop support: embed bili proxy as a .piplug background service + register loopback provider (published on plugins.aiuo.net) — follows up on #1400 | [Feature] PI-Desktop 支持:bili 代理内嵌为 .piplug 后台服务 + 注册 loopback provider(plugins.aiuo.net 上架)—承接 #1400 #2677 G4），故按「受支持的配置路径」记录、不宣称已验证 95–97% 缓存命中车道；③ 不要叠加进程内 bcp 扩展路线（[Bug][pi] PI-Desktop Host Support: getBranch-only Host Misidentified as Unsupported by Detection Gate + Per-Round View Rebuild Causes Compressed Blocks to Be Lost Across Rounds | [Bug][pi] PI-Desktop 宿主支持：getBranch-only 宿主被检测门误判 Unsupported + 每轮视图重建致压缩块跨轮丢失 #3238），共存依赖 bcp proxied-baseURL stand-down（真机核对待做，[Feature] PI-Desktop support: embed bili proxy as a .piplug background service + register loopback provider (published on plugins.aiuo.net) — follows up on #1400 | [Feature] PI-Desktop 支持:bili 代理内嵌为 .piplug 后台服务 + 注册 loopback provider(plugins.aiuo.net 上架)—承接 #1400 #2677 G7）✓
• zh-CN 镜像逐条一致 ✓（唯一微差：spec 写「[Bug][pi] PI-Desktop Host Support: getBranch-only Host Misidentified as Unsupported by Detection Gate + Per-Round View Rebuild Causes Compressed Blocks to Be Lost Across Rounds | [Bug][pi] PI-Desktop 宿主支持：getBranch-only 宿主被检测门误判 Unsupported + 每轮视图重建致压缩块跨轮丢失 #3238 D2」、diff 写「[Bug][pi] PI-Desktop Host Support: getBranch-only Host Misidentified as Unsupported by Detection Gate + Per-Round View Rebuild Causes Compressed Blocks to Be Lost Across Rounds | [Bug][pi] PI-Desktop 宿主支持：getBranch-only 宿主被检测门误判 Unsupported + 每轮视图重建致压缩块跨轮丢失 #3238」，无实质差异，不动他人分支）

CI 状态（head f291dca）：全部静态门禁 / build / e2e hermetic 车道绿；test 分片（ubuntu/windows × node 22/24）红——但失败签名与 master HEAD 6ee4a2a 自己的运行逐字节相同：tests/golden-storage-render.test.ts 四个子测试（chat/anthropic/responses/google）state-key divergence: stats=…（分片汇总 pass 2181 / fail 4）。纯文档 diff 不可能触及该金标；这是 master 既有红风暴，不是本 PR 引入。

顺手把该 master 红的根因查清并修了：

• 根因：金标最后再生成于 700722d（image_full 无法被正确调用：同一张图每轮重复降采样（38 次）、restore 提示注入 38 次，模型只能猜 ref → 每轮一次失败+重发，缓存命中从 75% 掉到 28% #3266 移除图片预压缩主提交）之后，PR feat!: remove image pre-compression and the image_full tool (#3266) #3295 的收尾提交 5bcc345 从 createInitialState()（kernel/src/state.ts）删掉了 imagesShrunk/imageBytesSaved/imageTokensSaved 三个死字段，持久化 state.stats 形状少 3 键 → 金标 digest 与现网行为不一致。
• 本地复现钉死：origin/master worktree 跑再生成脚本，diff 恰好只有那 3 处 digest × 4 wires，新值与 CI 报错里的 live 值逐位一致；定向测试 5/5 通过。
• 交付：修复 PR https://github.com/ranxianglei/billion-context/pull/3314（纯夹具再生成、无源码改动）+ 记录 issue https://github.com/ranxianglei/billion-context/issues/3313（[no-dispatch]、带来源标记）。#3314 合入后所有在途 PR（含本 PR）的 test 分片即转绿。

八问：

1. 是什么问题：PI-Desktop 零代码 /bili/ 入口文档（[Feature] PI-Desktop support: embed bili proxy as a .piplug background service + register loopback provider (published on plugins.aiuo.net) — follows up on #1400 | [Feature] PI-Desktop 支持:bili 代理内嵌为 .piplug 后台服务 + 注册 loopback provider(plugins.aiuo.net 上架)—承接 #1400 #2677 G6 缺口项）——已提交的文档 PR 是否符合 spec、CI 红能否放行。
2. 什么原因导致的：文档本身无缺陷；CI 红源于 storage-render 金标未随 feat!: remove image pre-compression and the image_full tool (#3266) #3295 删除死 stats 字段而重新生成（master 既有、波及所有 PR）。
3. 影响范围与严重程度：文档 diff 无运行时影响；master 红阻塞一切 PR 合并判定（对开发流程严重、对终端用户无影响）。
4. 怎么修复的：文档侧无需改动；CI 侧按测试内置流程重生成 4 个金标 JSON（PR test: rebaseline storage-render goldens after #3295 dropped dead image-stats fields from state.stats #3314）——修夹具对齐已合入的有意行为变更，不改任何行为。
5. 是否有回归问题：无。审过的既有行为：金标再生成仅动 digest 字段，wire 形状、持久化格式、缓存/重试策略均未变；旧会话读回按 image_full 无法被正确调用：同一张图每轮重复降采样（38 次）、restore 提示注入 38 次，模型只能猜 ref → 每轮一次失败+重发，缓存命中从 75% 掉到 28% #3266 back-compat 契约由白名单读取方 DROP 遗留键（storage-corpus 测试已钉住）。
6. 是否破坏缓存：不涉及。
7. 是否改了设计方向：不涉及。
8. 是否引入了新的配置：不涉及。

判定：本 PR 4 行 diff 与 spec 完全一致，内容可合；建议与金标准生成 PR #3314 一并或在其后合并（#3314 合入后 CI 全绿）。