## 症状 `ACP_PASSTHROUGH=1`(环境变量)或配置文件 `passthrough: true` 会**静默关闭 100% 压缩**:无启动日志、无横幅提示、web 面板零显示、`/__bili/config` GET 不含该键、PUT 甚至**不接受该键**(面板无法查看也无法解除),launcher 还会把它透传给子代理(`proxyStartArgs`)。用户以为 bili 在工作(代理活着、面板绿、请求正常转发),实际一个 token 都没省——排查方向还被"看起来健康"的面板引偏。 同族静默旋钮:`ACP_MODEL_CONTEXT_LIMIT`、`ACP_COMPRESS_TOOL=0`/`ACP_NO_INJECT_TOOL`、`BILI_PERSIST=0`——全部生效于无声。 ## 根因 `loadOptions`(config.ts:359,dist 47768)读 env/file → `server.ts:881`(dist 56045)`if (!opts.passthrough …)` 直接跳过压缩分支;listen 横幅(server.ts:370,dist 55721)逐项打印 MITM/overrides/debug 配置**独缺 passthrough**;`handleConfigGet`(dist 50995-51006)字段集不含它。 ## 建议修复 - 有效 passthrough=true 时:启动打一行 warn(`PASSTHROUGH — compression OFF`)+ 横幅追加状态 + 面板红角标; - `/__bili/config` GET 增补 `{passthrough, passthroughSource}`、PUT 允许清除; - 所有 env 级静默覆盖在 boot 时逐条打印一次(值+来源)。 ## 验收标准 - [ ] `ACP_PASSTHROUGH=1 bili start`:日志有 warn、面板显示 OFF;去掉即恢复 - [ ] 面板可读写 passthrough 状态 - [ ] 任一静默 env 生效时 boot 有痕
Activity
ranxianglei commentedon Aug 31, 2026
[bot] 🏷 收到,正在处理。计划:
passthrough=true时 boot 打 warn(PASSTHROUGH — compression OFF)+ listen 横幅追加状态/__bili/configGET 增补{passthrough, passthroughSource},PUT 允许清除/设置(文件级)ACP_PASSTHROUGH、ACP_MODEL_CONTEXT_LIMIT、ACP_COMPRESS_TOOL/ACP_NO_INJECT_TOOL、BILI_PERSIST)在 boot 时逐条打印一次(值+来源)完成后开 PR 并回贴链接。
fix: /bili/ tunnel destination admission + management-plane tunnel bl…
refactor: drop the dead SSE rewriters that kept causing mis-triage
ranxianglei commentedon Sep 4, 2026
四条根因逐条查证属实,已全部修复。PR: #514
审核结论(先验证后动手)
resolveProxyOrigin()(src/mcp.ts:37-45)确认只走 env→file→8787,零健康探测;临时实例死后指针永久指向死端口,MCP 调用失败直到重启宿主客户端——与描述一致,机制成立。server.listen回调无条件覆盖(src/server.ts:363)、ensureProxyRunning(src/launcher.ts:1494)spawn 前不探测优先端口——两点叠加即你盘上看到的"双活 + 指针被临时实例劫持"。src/plugin-install.ts:253/286/295/349)确认把安装时刻解析到的 origin 冻进持久配置——潜伏雷属实:任何在临时实例存活期间跑过plugin install的用户都已中招。修复方案(对应你的建议 1–4)
resolveLiveOrigin(),按 env→file→default 逐个探活(GET /__bili/health,1.5s 超时),成功后缓存;fetch 失败(ECONNREFUSED/超时)即清缓存,下一次 MCP 调用重新解析 → kill 掉临时代理后下次调用自动恢复,无需重启客户端。换绑时 stderr 打声明(带 instanceId)。/__bili/health现在返回 instanceId。ensureProxyRunning先探测优先端口,健康则直接复用(不 spawn、stopProxy 对复用句柄是 no-op),不健康才 spawn。复用共享实例但请求了 mitm domains 时 warn(domains 只对带其启动的实例生效)。http://127.0.0.1:8787,绝不烘焙 ephemeral。一处有意偏离:显式设置的BILI_MCP_PROXY/--origin仍然优先(保留 operator intent);自定义端口实例不受影响——shell 运行时走 env→file→default 链能找到它,死指针现在也会按第 1 条自愈。stats.requests或state.nextBlockId回退的全量快照(两个信号对同一 session id 单调递增),throttled warn;stale 副本的 flushSync 报成功,让驱逐丢掉旧内存副本(自愈)。验收标准对照(均有单测覆盖,细节见 PR)
tests/mcp-live-origin.test.ts(self-heal 用例)tests/launcher.test.tsreuse 用例 +tests/proxy-origin.test.tsclaim 用例tests/proxy-persist.test.ts三个新用例plugin install产物 BILI_MCP_PROXY = 稳定端口 ✅tests/plugin-agent.test.ts新用例(模拟指针文件含 ephemeral 端口的场景)预检:typecheck ✅;npm test 887/888;build ✅(proxy-origin 内联进 dist)。唯一失败用例
resolveClientCommand: codex/claude resolve to themselves在 clean master 上同样失败——环境依赖:存在 /usr/bin/codex 的环境下 PATH 查找会解析成绝对路径,而该测试硬编码裸名期望。属小问题,按规范只在此报告不另开 issue(建议后续改成用受控空目录做 PATH 断言)。完整 E2E 在本沙箱跑不了(upstream 不可达),preflight 已通过。等你 review + merge(合并是人工操作)。合并后建议:若本机配置里已有 BILI_MCP_PROXY 指向某临时端口,重跑一次
bili plugin install即可刷回稳定值;没有的话无需操作。ranxianglei commentedon Sep 5, 2026
修复 PR: #547
覆盖三项验收:
— PASSTHROUGH (compression OFF)+ 独立 warn 行(含来源与恢复方法){passthrough:{enabled,source}}; PUT 接受true/false/null并热生效; env 强制时返回 409 并给出解除指引(不再静默无效)注: issue 中提到的
ACP_NO_INJECT_TOOL在代码里不存在, 实际旋钮是ACP_COMPRESS_TOOL, 已覆盖。ranxianglei commentedon Sep 5, 2026
这条评论像是发错线程了——#547 覆盖的三项验收对应的是 #403(ACP_PASSTHROUGH 静默关死压缩),不是 #405。查证如下:
为什么是 #403
src/config.ts、src/server.ts(banner)、src/web/api.ts|client.ts|page.ts、tests/passthrough-visibility.test.ts——与 ACP_PASSTHROUGH 一键静默关死全部压缩:无日志/无横幅/面板不可见且不可清除,同族 env 旋钮全部生效于无声 #405 的四个根因(读侧零验活 / listen 无条件抢写 / launcher 双 spawn / plugin-install 冻结 ephemeral)零交集。ACP_NO_INJECT_TOOL也是 ACP_PASSTHROUGH one-click silent kill of all compression: no logs / no banners / panel invisible and non-clearable, all sibling env knobs take effect in silence | ACP_PASSTHROUGH 一键静默关死全部压缩:无日志/无横幅/面板不可见且不可清除,同族 env 旋钮全部生效于无声 #403 正文里的旋钮——ACP_PASSTHROUGH 一键静默关死全部压缩:无日志/无横幅/面板不可见且不可清除,同族 env 旋钮全部生效于无声 #405 正文通篇没有 ACP_PASSTHROUGH 或任何 env 旋钮。Fixes #405。GitHub 会在 #547 合并时自动关闭本 issue,而 #405 的真正修复目前尚未合并。建议合并前把引用改成#403(这条评论也建议移到 #403)。#405 的真实进度(我核对了当前 master @ea5ed84 / v0.1.85):
src/instance.ts已并入),拆成两个聚焦 PR,均仍 open:fix: skip dead-pid proxy-origin records in MCP shell origin resolution (#405) #516(MCP shell 跳过 dead-pid 指针)、fix: reject stale in-memory snapshots that would roll back persisted session state (#405) #517(persist 回档防护)。另有 fix: skip dead-pid proxy-origin records in MCP shell origin resolution (#405) #522 标题与 fix: skip dead-pid proxy-origin records in MCP shell origin resolution (#405) #516 完全相同("skip dead-pid proxy-origin records…(ACP_PASSTHROUGH 一键静默关死全部压缩:无日志/无横幅/面板不可见且不可清除,同族 env 旋钮全部生效于无声 #405)")——疑似重复或替代关系,我不擅自关任何一个,请定夺留哪个。ensureProxyRunning(src/launcher.ts:1441)先probeExistingInstance,兼容则 attach 不 spawn;且 bili启动器模式,默认不要启动8787端口 #446 起默认 launch 用 OS 临时端口,不再 squat 8787。proxyOriginForInstall()(src/plugin-install.ts:22-35)——env 显式值优先,否则要求记录实例 pid-alive,死指针直接 throw。原"永久错配"雷已拆掉,但烘焙值是"存活记录实例的 origin"(可能是自定义端口),严格意义上的"稳定端口"语义变了,最终验收时需再确认一次。src/mcp.ts:37的resolveProxyOrigin()在 master 上仍无 dead-pid/验活逻辑——等 fix: skip dead-pid proxy-origin records in MCP shell origin resolution (#405) #516/fix: skip dead-pid proxy-origin records in MCP shell origin resolution (#405) #522 其一落地。建议:#405 保持 open,待 #517 + {#516, #522} 之一合并后,我再对四条验收做一次完整复验然后收尾。需要的话我现在就可以先做这轮复验(前两条已有结论,第三、四条会在两个 PR 落地后立即补上)。
ranxianglei commentedon Sep 5, 2026
补一个代码级发现(master @ea5ed84 / v0.1.85 已核实),把上一条里验收标准 4 的⚠️ 升级为确认残留:#405 根因 2(写侧无条件覆盖)在 master 上仍在,只是从纯文本指针变成了 JSON 记录:
证据链
src/server.ts:420-435的announceListening()每次启动直接atomicWriteInstanceFile({...}),覆盖单一全局发现记录(stateDir()/proxy-origin)——写入前没有任何归属检查。fix: instance registry lost-update — per-instance marker files (#527) #528 明确写了 "proxy-origin… was already ownership-guarded and is unaffected",但被 guard 的只是清除侧(clearProxyInstanceFile校验 instanceId,写侧没有。instanceCompatible(src/launcher.ts:1356-1363)要求 host/passthrough/mitmDomains/modelWindows 全等。被 launch 的客户端只要有一个 model-window override 与运行中实例不同(跨客户端/跨项目配置很常见),launcher 就会 spawn 临时子进程 → 子进程 announceListening 覆盖记录。bili plugin install→proxyOriginForInstall()(src/plugin-install.ts:22-35)读到被覆盖的记录,pid-alive 检查通过 → 把临时端口冻进持久配置——ACP_PASSTHROUGH 一键静默关死全部压缩:无日志/无横幅/面板不可见且不可清除,同族 env 旋钮全部生效于无声 #405 的潜伏雷原样复现,只是换了一道门(pid-alive 挡不住"活着的临时实例")。announceListening只在启动时跑一次,无重广播机制,后续 MCP shell/install 都找不到它(除非显式BILI_MCP_PROXY)。结论:supersede review 里"fixes 2–4 已被实例注册表以更强形式覆盖"对写侧这部分不成立——注册表(#527/#528)修的是多实例列表的 lost-update,attach-or-spawn 修的是兼容配置下的双 spawn,但单一发现记录仍是 last-writer-wins。
建议:补一个小而聚焦的 PR(比我 #514 的原 fix 2 小得多——记录本身已带 instanceId/pid/startedAt,不再需要 lease sidecar):
announceListening写入前读现有记录,若指向另一个健康实例则保留对方记录并记日志,否则接管;清除侧维持现状。设计时需保留 launchToken 握手路径(launcher 的 spawn-wait 靠它,已有 stale-record fallback 兜底)。随时可以提交,独立于 #516/#517。等你点头就做。Merge pull request #547 from ranxianglei/2026-09-05_passthrough-visib…
fix: surface passthrough everywhere it silently killed compression (r…
Merge pull request #522 from ranxianglei/2026-09-04_mcp-dead-pid-origin
fix: skip dead-pid proxy-origin records in MCP shell origin resolution (
fix: reject stale in-memory snapshots that would roll back persisted …
Merge pull request #517 from ranxianglei/2026-09-04_persist-rollback-…
docs: declare shared-state-dir multi-instance security boundary (ranx…
fix: converge stale resident's in-memory state to newer disk record o…
Merge pull request #2744 from ranxianglei/2026-10-11_multi-instance-p…
fix(web): derive tokensSaved from active blocks; label frozen context…
test: two-live-instance proofs over one sessions dir (ranxianglei#394/r…
perf(persist): stale-guard ownership fast path skips the per-save env…
fix: break the proxy-origin hijack chain (ranxianglei#405)
fix: skip dead-pid proxy-origin records in MCP shell origin resolution (
fix: keep the multi-instance stale-write guard observable in the dura…