[bug] 模型 id 含中文时 x-bili-plugin-model 触发 undici ByteString 异常，整轮请求发不出去（7 文件 8 处写入点，pi/omp/opencode/dsh） #2455

Description *

模型 id 含非 ASCII 字符（中文）时，插件把它原样写进 HTTP 请求头 x-bili-plugin-model，Node/undici 构造头时直接抛 TypeError，请求在本地发出前就失败，该模型 100% 不可用。

复现步骤（Windows，pi + bili 0.1.188 插件模式）：

1. 配置一个模型 id 含中文的供应商（本例 浮***/gpt-6.1-sol），加载 bili 扩展。
2. 起会话，发任意一条消息。
3. 该轮直接失败，宿主透出的一手错误文本就是：

Cannot convert argument to a ByteString because the character at index 0 has a value of 28014 which is greater than 255.

（28014 = U+6D6E = 「浮」，正是该 model id 的首字符。）

对照组与取证：

• 同一模型、同一指令，不加载 bili 扩展时正常返回；加载扩展即 100% 复现。
• 失败轮在会话记录里 usage 全 0、durationMs 仅 4–10 ms；~/.local/state/billion-context/bili.log 中该会话一行都没有 → 请求根本没到代理。
• 换成 ASCII 的模型 id（deepseek-v4.1-flash）一切正常。

bili version *

0.1.188（npm latest，实测自安装包 package.json）

Usage mode *

Plugin native（以宿主扩展方式安装 npm 包，进程内加载 dist/agent/pi-native.js）

Client and version *

pi 1.1.0（Windows 桌面壳 PiDeck 内嵌运行；已用命令行 pi -p 独立复现，与桌面壳无关）

Operating system *

Windows 11（原生，非 WSL2）

Upstream and model *

第三方聚合站；模型 id 浮***/gpt-6.1-sol（供应商名与模型名都是中文）。与本 bug 无关——报错发生在请求发出之前，上游与窗口声明都不参与。

最小复现（与 bili 无关，纯 Node 即可）

// node v22.20.0
await fetch("http://127.0.0.1:8317/v1/responses", {
  method: "POST",
  headers: { "x-bili-plugin-model": "浮***/gpt-6.1-sol" },
  body: "{}",
});
// TypeError: Cannot convert argument to a ByteString because the character at index 0 has a value of 28014 which is greater than 255.

同一脚本换 ASCII 值、或换 percent-encoded 的中文（percent:%E6%B5%AE%E7%94%9F%E4%BA%91%E7%AE%97%2Fgpt-6.1-sol）都不抛、能正常发出（本机拿到代理的 401，说明已送达）。

根因

dist/agent/pi-native.js（0.1.188）L278 附近：

const modelId=ctx.model?.id;
if(typeof modelId==="string"&&modelId.length>0){
  headers["x-bili-plugin-model"]=modelId;   // ← model id 含中文时在这里抛

HTTP 头值只能是 latin1 / ByteString，非 ASCII 的 model id 不可能直接塞进头，必须在写入前处理。

影响面（0.1.188 的 dist，共 7 个文件 8 处写入点）

• dist/agent/pi-native.js:278 — headers["x-bili-plugin-model"]=modelId;
• dist/agent/pi.js:276 — 同上
• dist/agent/omp-native.js:278 — 同上
• dist/agent/omp.js:276 — 同上
• dist/agent/dsh-native.js:132 — headers["x-bili-plugin-model"]=modelInfo.cached.model;
• dist/agent/opencode-native.js:321（2 处）— headers.set("x-bili-plugin-model",model.id)
• dist/agent/opencode.js:321 — output.headers["x-bili-plugin-model"]=model.id;

（行号为 npm 包内 dist 的，源码行号不同。）中文供应商名/模型名在中文聚合站场景里很常见，所以这条在 pi / omp / opencode / dsh 各 lane 都会摸到；

为什么直接跳过该头是安全的

代理侧 dist/index.js（0.1.188）L684：

function pluginReportedModel(headers){if(pluginAgentHeader(headers)===void 0)return void 0;const raw=headerValue(headers,PLUGIN_MODEL_HEADER);return raw!==void 0&&/^\S{1,256}$/.test(raw)?raw:void 0}
function pluginHeadersMatchModel(headers,bodyModel){const reported=pluginReportedModel(headers);if(reported===void 0||bodyModel===void 0)return true; ...}

缺头 → reported===void 0 → pluginHeadersMatchModel 直接 return true，模型识别走 body / registry 兜底，当前没有副作用。

建议修复

最小改动：每个写入点加一个 ASCII 守卫，或抽一个共用 helper（asciiHeaderValue(v)）在写入前统一过滤：

const modelId = ctx.model?.id;
if (typeof modelId === "string" && /^[\x20-\x7E]{1,256}$/.test(modelId)) {
  headers["x-bili-plugin-model"] = modelId;
}

本地验证（只改 pi-native.js 这一个文件）：报错消失，代理日志能看到该请求被正常转发 —— model=浮生云算/gpt-6.1-sol → forward POST → http://127.0.0.1:8317/v1/responses。

若希望非 ASCII 模型仍上报身份，则要插件端 encodeURIComponent + 代理端解码，并且 pluginHeadersMatchModel 的等值 / split("/").pop() 比较得一起改；成本更高，可另开 issue。

可选加固（同类风险）

1. 头构造包一层兜底（漏该头 + 一行 warn），别让一个元数据头把整轮请求打死——现在这个失败的归因成本太高。
2. 同类「用户可控字符串进头」的还有 x-bili-plugin-conversation（会话 id）等，建议统一走上面那个 sanitizer。