Skip to content

Plugin lanes: host declares exposed bili tools per request via x-bili-plugin-exposed-tools (structural fix for #3884/#3600 name-guessing) | 插件车道:宿主按请求声明暴露的 bili 工具(根治 #3884/#3600 认名字脆弱性) #3906

Open

Description

@ranxianglei

来源: #3884 (#3884) 分析 DSH 0.2.x code_run 压缩面永久压制(#3603 修复复发)时发现
查重: 无(open+closed 检索 omnibus/reachability/exposed-tools/declaration 均无同题;本 issue 是 #3417/#3482 Step3+「可达性真源 = 宿主声明」方向的具体落地第一步,非重复立项)

背景

#3600 与 #3884 是同一条判定链的两次失配:插件车道里 bili 无法查询宿主实际注册了哪些工具,只能靠 wire 顶层工具形状推断「compress 够不够得到」,推断依赖认拢子工具的名字。宿主每改一次名字就静默失配一次(run_code → code_run)。#3885 已把已知形态收敛为集合 + 双向测试 + off 面日志点名,但未知新形态仍需事故报告触发——结构性修法是让宿主直接声明。

owner 已在 #3884 线程批准此方向并给出两条硬约束(2026-10-20):①新 header 不向上游转发(注:实测发现存量 x-bili-plugin* 头目前会转发到上游,已另立 #3905 跟踪;本机制的新头与其同生命周期,随 #3905 一并收敛);②没加 header 的请求必须兜底——行为逐位不变,「不要因为有请求没加就嘎」。

设计(已实现,分支 2026-10-20_exposed-tools-declaration,PR 随后开在此 issue 下)

新增入站 header x-bili-plugin-exposed-tools(逗号分隔的 bili 工具名;在场但为空 = 「一个都没暴露」):

  • 声明在场 = 真源:压过全部推断档位(含 profile 默认 toolsHostScopedByDefault)。顶层含 compress 仍是 ground truth(观察到的即可调);否则以声明为准——含 compress → 可达;不含 → 不可达(即使顶层是认识的 omnibus 名也照关,双向钉死)。
  • 声明缺省 = legacy 推断逐位保持:top-level compress / CODE_MODE_OMNIBUS_TOOL_NAMES / profile 默认三档照旧。
  • proxy 车道结构性开面,不受该 header 影响(stray header 不能关掉它)。
  • 解析器归一化:trim + 小写;多值头按逗号连接。

dsh 侧后续(独立跟进,不阻塞本 PR)

dsh 在 code-mode preset 的请求上补发该 header(值 = 该 preset 注册表里 bili manifest 工具的暴露子集)。manifest 握手已有 headers 通道(src/plugin.ts),宿主实现成本约一行 join。落地后本机制即为其服务,改名从此非事件。

验收

  • b-class 单测:优先级规则 9 行(救未知形态 / 压认识形态 / 空声明 / 缺省双向 / 顶层 compress ground truth / proxy 免疫 / profile 默认被压)+ 解析器 5 行。
  • 矩阵 e2e:四 wire × 双向行(code_run2 + 声明 compress → 开面;run_code + 空声明 → 关面),全走真实 server 链。
  • 本地定向绿(typecheck + b-class 7/7 + matrix 74/74);全量回归看 CI。

Activity

  1. ranxianglei commented on Oct 20, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

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

    查重:不重复。 本 issue 是「宿主声明暴露的 bili 工具」机制的唯一跟踪项,PR #3907 已引用它(Closes #3906);相关条目各管各的——#3884 = 事故诊断与名字收敛修复(PR #3885)、#3905 = 存量 x-bili-plugin* 头被转发上游(卫生缺口)。open+closed 无第四个覆盖同一机制的条目。

    标签:bug / dsh / scope/wiring / p2 —— 缺陷类(认名字推断脆弱,#3600/#3884 两次静默失配);动机与落地客户端是 dsh;改动面是新增入站头的协议边界(wiring);严重度按 #3885 落地后的残余风险判——已知形态已收敛、未知形态 fail-closed 且日志可见,属「能用但有明显问题」= p2。

    现状:本 issue 的设计已由前序会话实现完毕(分支 2026-10-20_exposed-tools-declaration,PR #3907,叠在 #3885 之上)。该 PR 对最新 master 目前处于冲突状态(分支切出后 master 前进了 41 个提交)。我接手做四件事:① 独立核对 diff 与本 issue 设计/验收逐条对齐;② rebase 到当前 master 解冲突;③ 本地定向绿(typecheck + b-class 单测 + 矩阵 e2e);④ push 后交 CI 全量回归。完成后按八问回报。

  2. added a commit that references this issue on Oct 27, 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

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions