Skip to content

ACP_PASSTHROUGH 一键静默关死全部压缩:无日志/无横幅/面板不可见且不可清除,同族 env 旋钮全部生效于无声 #405

Closed

Description

@wosnxn123

症状

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

  1. ranxianglei commented on Aug 31, 2026

    @ranxianglei
    Owner

    🤖 ework agent · vllm-qwen/qwen3.8-27b

    [bot] 🏷 收到,正在处理。计划:

    1. 有效 passthrough=true 时 boot 打 warn(PASSTHROUGH — compression OFF)+ listen 横幅追加状态
    2. /__bili/config GET 增补 {passthrough, passthroughSource},PUT 允许清除/设置(文件级)
    3. web 面板显示 passthrough OFF 红角标
    4. 所有 env 级静默覆盖(ACP_PASSTHROUGH、ACP_MODEL_CONTEXT_LIMIT、ACP_COMPRESS_TOOL/ACP_NO_INJECT_TOOL、BILI_PERSIST)在 boot 时逐条打印一次(值+来源)

    完成后开 PR 并回贴链接。

  2. ranxianglei commented on Sep 4, 2026

    @ranxianglei
    Owner

    🤖 ework agent · qwen3.8-27b

    四条根因逐条查证属实,已全部修复。PR: #514

    审核结论(先验证后动手)

    • 读侧:resolveProxyOrigin()(src/mcp.ts:37-45)确认只走 env→file→8787,零健康探测;临时实例死后指针永久指向死端口,MCP 调用失败直到重启宿主客户端——与描述一致,机制成立。
    • 写侧:server.listen 回调无条件覆盖(src/server.ts:363)、ensureProxyRunning(src/launcher.ts:1494)spawn 前不探测优先端口——两点叠加即你盘上看到的"双活 + 指针被临时实例劫持"。
    • plugin-install:四个烘焙点(claude/codex/opencode,src/plugin-install.ts:253/286/295/349)确认把安装时刻解析到的 origin 冻进持久配置——潜伏雷属实:任何在临时实例存活期间跑过 plugin install 的用户都已中招。
    • 计数分叉:原子写确实只防半行不防回档,无单实例守卫:多个 bili 代理进程并存共写 sessions 目录,伴随孤儿 ref、有注册表无 transcript、计数自相矛盾的污染簇 #394 方向的具体落点已一并实现。

    修复方案(对应你的建议 1–4)

    1. 读侧:新增异步 resolveLiveOrigin(),按 env→file→default 逐个探活(GET /__bili/health,1.5s 超时),成功后缓存;fetch 失败(ECONNREFUSED/超时)即清缓存,下一次 MCP 调用重新解析 → kill 掉临时代理后下次调用自动恢复,无需重启客户端。换绑时 stderr 打声明(带 instanceId)。
    2. 写侧:listen 回调改为 claim-not-clobber——写指针前先探活现有指针,指向别的健康实例则保留对方并记日志,否则接管。新增 sidecar 租约文件(origin+pid+bootedAt+instanceId)作归属证明;优雅退出时仅当指针仍指向自己才归还。主文件格式不变(纯 URL 行),老版本 shell 兼容;/__bili/health 现在返回 instanceId。
    3. Launcher:ensureProxyRunning 先探测优先端口,健康则直接复用(不 spawn、stopProxy 对复用句柄是 no-op),不健康才 spawn。复用共享实例但请求了 mitm domains 时 warn(domains 只对带其启动的实例生效)。
    4. plugin-install:烘焙稳定值 http://127.0.0.1:8787,绝不烘焙 ephemeral。一处有意偏离:显式设置的 BILI_MCP_PROXY/--origin 仍然优先(保留 operator intent);自定义端口实例不受影响——shell 运行时走 env→file→default 链能找到它,死指针现在也会按第 1 条自愈。
    5. sessions 回档防护:写入时与盘上状态比较,拒绝 stats.requests 或 state.nextBlockId 回退的全量快照(两个信号对同一 session id 单调递增),throttled warn;stale 副本的 flushSync 报成功,让驱逐丢掉旧内存副本(自愈)。

    验收标准对照(均有单测覆盖,细节见 PR)

    • kill 临时代理(:8787 存活)→ 下一次 MCP 调用即恢复 ✅ tests/mcp-live-origin.test.ts(self-heal 用例)
    • 健康 :8787 在场 → 不再 spawn 第二实例、不改写 origin ✅ tests/launcher.test.ts reuse 用例 + tests/proxy-origin.test.ts claim 用例
    • 双实例并存:后保存的旧快照被拒绝并 warn,计数不回档 ✅ 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 即可刷回稳定值;没有的话无需操作。

  3. ranxianglei commented on Sep 5, 2026

    @ranxianglei
    Owner

    修复 PR: #547

    覆盖三项验收:

    • ✅ 启动: banner 追加 — PASSTHROUGH (compression OFF) + 独立 warn 行(含来源与恢复方法)
    • ✅ 面板可读写: GET 返回 {passthrough:{enabled,source}}; PUT 接受 true/false/null 并热生效; env 强制时返回 409 并给出解除指引(不再静默无效)
    • ✅ 静默 env 一览: 启动时单行列出所有生效的 env 覆盖(ACP_PASSTHROUGH / ACP_MODEL_CONTEXT_LIMIT / ACP_COMPRESS_TOOL / ACP_COMPRESS_NUDGE / BILI_PERSIST, 含值)

    注: issue 中提到的 ACP_NO_INJECT_TOOL 在代码里不存在, 实际旋钮是 ACP_COMPRESS_TOOL, 已覆盖。

  4. ranxianglei commented on Sep 5, 2026

    @ranxianglei
    Owner

    🤖 ework agent · qwen3.8-27b

    这条评论像是发错线程了——#547 覆盖的三项验收对应的是 #403(ACP_PASSTHROUGH 静默关死压缩),不是 #405。查证如下:

    为什么是 #403

    1. fix: surface passthrough everywhere it silently killed compression (#405) #547 的 diff 只动 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)零交集。
    2. 三项验收(banner PASSTHROUGH、面板 GET/PUT passthrough、静默 env 一览)与 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_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 旋钮。

    ⚠️ 有一个实际风险:#547 的 body 写的是 Fixes #405。GitHub 会在 #547 合并时自动关闭本 issue,而 #405 的真正修复目前尚未合并。建议合并前把引用改成 #403(这条评论也建议移到 #403)。

    #405 的真实进度(我核对了当前 master @ea5ed84 / v0.1.85):

    建议:#405 保持 open,待 #517 + {#516, #522} 之一合并后,我再对四条验收做一次完整复验然后收尾。需要的话我现在就可以先做这轮复验(前两条已有结论,第三、四条会在两个 PR 落地后立即补上)。

  5. ranxianglei commented on Sep 5, 2026

    @ranxianglei
    Owner

    🤖 ework agent · qwen3.8-27b

    补一个代码级发现(master @ea5ed84 / v0.1.85 已核实),把上一条里验收标准 4 的 ⚠️ 升级为确认残留:#405 根因 2(写侧无条件覆盖)在 master 上仍在,只是从纯文本指针变成了 JSON 记录:

    证据链

    1. 写侧仍无条件: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,写侧没有。
    2. 触发条件可达:instanceCompatible(src/launcher.ts:1356-1363)要求 host/passthrough/mitmDomains/modelWindows 全等。被 launch 的客户端只要有一个 model-window override 与运行中实例不同(跨客户端/跨项目配置很常见),launcher 就会 spawn 临时子进程 → 子进程 announceListening 覆盖记录。
    3. 两个具体受害路径:
      • 烘焙 ephemeral(验收标准 4):临时子进程存活期间跑 bili plugin install → proxyOriginForInstall()(src/plugin-install.ts:22-35)读到被覆盖的记录,pid-alive 检查通过 → 把临时端口冻进持久配置——ACP_PASSTHROUGH 一键静默关死全部压缩:无日志/无横幅/面板不可见且不可清除,同族 env 旋钮全部生效于无声 #405 的潜伏雷原样复现,只是换了一道门(pid-alive 挡不住"活着的临时实例")。
      • 老实例失去可发现性:客户端退出时临时子进程清掉自己的记录(instanceId 匹配),长驻 :8787 的记录永久丢失——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。等你点头就做。

  6. added a commit that references this issue on Sep 5, 2026
  7. added a commit that references this issue on Sep 7, 2026
  8. added 2 commits that reference this issue on Sep 7, 2026
  9. added a commit that references this issue on Oct 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingp1

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions