Skip to content

[Root Cause] config-knobs (auto-maintained, do not manually disable) | [根因] config-knobs(自动维护,勿手动关闭) #6343

Closed as not planned

Description

@ranxianglei

同一根本原因(config-knobs)的 open issue 汇聚,由根因归类板自动维护(10min 刷新,勿手编)。

本批 issue

任务

对本批 issue 做一个根本性修复 PR:

  • PR 描述里用 Fixes #... 逐个列出上面每一个 GitHub issue 号(没有 GitHub 号的写镜像号)
  • 若某个 issue 已有自己的 PR 且方向一致,cherry-pick 其 commit 并保留原作者署名(-x);由你判断是否值得
  • 标签按本 PR 的 diff 独立判断(类别 + 优先级),不要抄任何来源 issue
  • 修完后回帖本线程:改了什么、为什么一次修了整批

Activity

  1. changed the title [-][根因] config-knobs(自动维护,勿手动关闭)[/-] [+][Root Cause] config-knobs (auto-maintained, do not manually disable) | [根因] config-knobs(自动维护,勿手动关闭)[/+] on Nov 12, 2026
  2. ranxianglei commented on Nov 12, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

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

    进程被强制重启(32 分钟无输出)后已恢复,本批三个 issue 已重新读完,汇报状态、判断与下一步。

    逐个状态

    issue 主题 状态
    镜像 #5833 / GitHub #5831 TTFB 空闲预算拆分 已完成——owner 2026-11-08 拍板「两阶段拆分」并直接落地:#5917(已合入,新增 BILI_UPSTREAM_FIRST_BYTE_MS,unset=逐字节零变化)+ #5947(开放、CI 绿、已独立 review,首字节超时拆成可重放类 upstream-headers-timeout)。该 issue 自身已标 superseded、留待 owner 关闭。板面把它列进来是 10min 刷新的滞后,本批无需再修。
    镜像 #6222 / GitHub #6220 x-bili-plugin-bypass 强制指定 已获拍板,待实现——owner 确认「通用名 + proxy 层」方向(BILI_PLUGIN_BYPASS 三态:unset=现状零变化 / 1=强制 bypass / 0=永不 bypass)并回「继续」。无决策依赖,我现在就动手。
    镜像 #6317 / GitHub #6307 远程公告 / models.dev 预取无关闭开关 外部 feature request,需 owner 拍板形状——新增配置面(owner-gate),BBleae 给了 4 个形状,未拍板前不实现(config-surface gate)。

    我的明确建议(不甩选择题)

    1. fix: keep system prompt byte-stable for prefix cache #1 不动——已 shipped([PR] Upstream hang on compressed summary no longer silent: added first-byte budget + watchdog/preflight logging (#5904) | 压缩摘要上游卡死不再静默:新增首字节预算+看门狗/预检日志(#5904) #5917 合入 + [PR] Fix #5807: Classify TTFB timeout separately on gateway hang and replay within the proxy | 修 #5807:网关装死时,首字节超时单独分类并在代理内重放 #5947 在途),板面滞后。
    2. fix: address all code review findings (condense, routing, session-id, dead code) #2 现在就做,独立成 PR——已获批、无决策依赖,按「无决策依赖的部分先修」立即落地,不阻塞在 Use kernel renderTags:"text-only" + forbid tag echoing in prompt #3 后面。
    3. Use kernel renderTags:"text-only" + forbid tag echoing in prompt #3 推荐「总开关 offline(issue 选项 3)+ 出站请求文档表(选项 4)」——逐车道开关(选项 1/2)每新增一条出站车道就得再加一个开关,而运维的真实诉求是「让这个代理只跟我的上游说话」,一个总开关一次到位且天然覆盖未来新车道;文档表独立有价值(operator 能查到「代理自己会联系哪些 host」)。请拍板 Use kernel renderTags:"text-only" + forbid tag echoing in prompt #3 的形状(我推荐 offline 总开关 + 文档表)。
    4. 一个 PR 还是两个:我推荐两个——fix: address all code review findings (condense, routing, session-id, dead code) #2 已获批可立即 ship;Use kernel renderTags:"text-only" + forbid tag echoing in prompt #3 要先等你拍形状。捆成一个 PR 会把已获批的 fix: address all code review findings (condense, routing, session-id, dead code) #2 阻塞在 Use kernel renderTags:"text-only" + forbid tag echoing in prompt #3 的决策后面,违背「先修无决策依赖部分」。若你更想要单 PR,回一句,我在 Use kernel renderTags:"text-only" + forbid tag echoing in prompt #3 拍板后把两者并进一个「补齐运维控制配置面」的 PR。

    下一步:我这就开始实现 #2(BILI_PLUGIN_BYPASS @ proxy 层,单点改 src/server/handle.ts:640 判定 + 正负用例单测 + docs/configuration.md 双语一段),完成后开 PR 并在本线程回帖;#3 等你拍形状。

  3. ranxianglei commented on Nov 12, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 (ai: vllm-qwen/qwen3.8-27b)

    本批三个 issue 已处理完,汇报结果。

    逐个结果

    issue 结果
    镜像 #5833 / GitHub #5831 无需再修——owner 2026-11-08 已拍板并落地(#5917 合入 + #5947 在途、CI 绿),板面 10min 刷新滞后。
    镜像 #6222 / GitHub #6220 已实现,PR #6360 已开(见下)。
    镜像 #6317 / GitHub #6307 等 owner 拍形状(config-surface gate),未实现——推荐「offline 总开关 + 出站请求文档表」,见 floor 4。

    PR #6360(修 #6220)— #6360

    Fixes #6220。按 owner 在 #6222 拍板(通用名 + proxy 层 + 三态 + env-only)落地 BILI_PLUGIN_BYPASS 运维开关:

    1. 是什么问题:入站 x-bili-plugin-bypass: 1 头决定请求是否原样透传(legacy opencode-acp 会话的 in-process 压缩契约,opencode v1: keep opencode-acp legacy sessions working after switching to bili #920),但运维没有强制/禁止该 bypass 的开关。
    2. 什么原因:判定是单点二进制(头在则 bypass),没有运维侧覆盖位。
    3. 影响范围与严重程度:仅影响需要强制透传(或禁止透传)的运维场景;默认 unset=逐字节零变化,无现有用户受影响。属运维能力补齐,非缺陷。
    4. 怎么修复的:在唯一判定点 src/server/handle.ts 加三态覆盖——bypass = override=="on" || (override=="auto" && header=="1");on=强制透传、off=忽略头永不透传、auto/unset=现状由头决定。逐请求读取(无需重启)。
    5. 是否有回归:无——unset 路径与改前逐字节一致(opencode v1: keep opencode-acp legacy sessions working after switching to bili #920 两个既有单测仍绿);新增 4 个正负用例(含关键的 force-off 覆盖头→注入 compress 工具)。
    6. 是否破坏缓存:不涉及——bypass 路径本就原样透传(不进管线、不绑会话),覆盖只改变「走哪条路」,不触碰缓存/重试/游标。
    7. 是否改了设计方向:不涉及——仍是单点判定,只加运维覆盖位,不改数据流/边界。
    8. 是否引入新配置:是——BILI_PLUGIN_BYPASS(env-only,无配置文件键、无 CLI flag;owner 在 [Bug][storage] Verification digests ignore own __proto__ fields in retained JSON content #6222 拍板 env-only)。默认 unset=auto。已写进 docs/configuration.md 双语(生成表 + 叙述表)+ config-reference seed。

    验证:typecheck 干净、build 成功、tests/plugin-bypass.test.ts 6/6 过、config-surface-guard + gen-config-docs check-coverage 均过;全量回归由 CI 在推上去的 head 上跑。

    为什么不是「一个 PR 修整批」:#1 已 shipped(板面滞后);#2 已获批可立即 ship;#3 要先拍形状。捆一个 PR 会把已获批的 #2 阻塞在 #3 决策后面,违背「无决策依赖部分先修」。故 #2 独立成 PR #6360;#3 待你拍形状后单独成 PR(或你拍板后我并入一个「补齐运维控制配置面」PR)。

    待 owner:#6307 的形状拍板(推荐 offline 总开关 + 出站请求文档表)。

  4. ranxianglei commented on Nov 12, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 (ai: vllm-qwen/qwen3.8-27b)

    PR #6360 CI 状态更新(floor 7 之后):首跑出现两个红,均本分支 born-red(非继承,master 侧该两项绿),已逐一诊断修复:

    1. lifecycle-ledger-guard——新增的 BILI_PLUGIN_BYPASS 读点(src/knobs.ts)未登 lifecycle 台账 → 补 §2.6 常设面登记(commit 108530e)。
    2. unused-exports——PluginBypassOverride 类型只作同文件返回注解、无外部消费 → 去掉 export(INTERNAL_ONLY,commit bab01fd)。

    新 head bab01fd:本地 typecheck / build / 定向单测 6/6 / 全套 guard(config-surface、gen-config-docs check-coverage、lifecycle、unused-exports)全绿;CI 现 0 失败(18/30 绿,12 个 test shard 在跑)。

    PR 可 review,全量回归以 CI 在 bab01fd 上的结果为准。#6307 仍等你拍形状(推荐 offline 总开关 + 出站请求文档表)。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions