mslxdff 0.1.232 → 0.1.234

package/src/providers/AGENTS.md

@@ -0,0 +1,49 @@
+# src/providers — 供应商契约（改任何 provider 前必读）
+
+> 从 `AGENTS.md` 下沉（2026-09-29 分层，就近生效）。改完跑：`npm run docs:check` + 相关 provider 测试 + 裸调验证 `-provider <id> models`。
+> 相关 ADR：0007(前缀路由)/0010(allowlist)/0019(share-keys)/0023(key 直连)/0026(cline id)/0029(qoder)/0033(cline 自动同步)/0037(qwenwork)/0038(zcode)/0041(globalqwenwork)。
+
+## 通用机制（dispatcher / keyring / 门禁）
+
+- `src/providers/` 每供应商一文件，前缀路由 `<provider>/raw`（裸 id 归 opencode），dispatcher 剥前缀转发；`providerKeys: {id:[k1,k2]}` round-robin 30s 冷却；`shareKeys` via `x-mslxdff-share-keys` 瞬时借用且 opencode 恒排除。
+- `providerConfigs.allowAnyModels` 默认 `false`（`opencode:true` 例外）+ `allowlist` 空即 `403`；`isModelAllowed` 对未配置 provider 放行（兼容测试），`listModels` 同步过滤；`providerConfigs.{modelsPath,chatPath}` 可配异形路径（`workbuddy=/v3/config` & `/v2/chat/completions`，其余默认 `/models` & `/chat/completions`，`b.ai=/v1/models`、`cline=/api/v1/models` 已验证）。
+- `src/models.js` 的 `aggLoad`/`get` 二次过滤：`!allowed.length && !allowAny → 跳过整供应商`；`src/routes/chat/index.js` 的 `isAllowlistBlock` 在 `useAuto` 时软跳 `continue`（显式请求才硬 `403`）。
+- 定制 provider 启用门禁下沉为纯函数 `src/runtime/provider-gate.js` —— auth 号型（workbuddy/traework/qoder）**不要求 baseUrl**，旧门禁 `baseUrl && keys` 曾把 qoder 整家静默跳过（表现：`/v1/models` 零条目 + `Model qoder/x is not supported`，无日志）。
+- CLI：`provider <id> models` 与 `model list --provider` 为直查一级答案（`--json` 供脚本），HTTP `GET /v1/providers/:id/models`；价格列 `x0.00/浮动/—` 对齐展示（workbuddy 按 credits 升序）。
+- 新增 provider 三步走：registry 注册 + classify（local-only 判据见 ADR-0023）+ allowlist 只增不减补齐；必须裸调验证 `free` 是否免 Key；`free` 4 个仅目录免 Key ≠ 对话免 Key（cline 教训）。
+
+## qoder（原生 COSY 栈，ADR-0029/0036）
+
+- 凭证单一源 `auths/qoder-<uid>.json`（0600，含每号 `region` —— `state.normalizeAuths` 会剥该字段，故 region 只能存 auths 文件）；签到按每号 region 选域名（cn=`openapi.qoder.com.cn` 走 `daily-check-in/status→claim`，409=今日已领；global=`openapi.qoder.sh` 该端点 404 → 回落 `/sash/api/v1/me/campaigns→/{id}/claim`）；认证只需 `Bearer <device_token>` + `cosy-clienttype: 10`（**无 COSY 签名、claim 空 body**）；默认只领 `CLAIM_BENEFIT`，促销条目 `VIEW_DETAILS` 需 `-provider qoder checkin --any`（实测能 claim，但奖励是订阅折扣、不进 quota）；余额 `GET /api/v2/quota/usage`；daemon 每日 09:00 自动（`MSLXDFF_QODER_CHECKIN=0` 关，`_CHECKIN_HOUR` 改点）。
+- **流式坏号判决面有两条**：①首包 HTTP 非 200；②**HTTP 200 但 SSE 信封内 `statusCodeValue` 非 200**（限流裹成 `200` + `{"code":"403","message":{"isQueued":true,"retryAfterSeconds":30}}`，只盖①会漏掉②——实测后果：94 次 empty turn 502、0 次恢复）。②的取法：返回 Response **前预读上游首帧**取判决（`PEEK_MAX_FRAMES=8`，遇判决或首个有效载荷即停），预读字节原样回灌给 `reshapeQoderStream`（`prefetched` 参数），对外仍恒 200、状态码只走内部头 `x-mslxdff-qoder-upstream-status`（fetch 异常折 502）。`test/qoder-envelope-status.test.js` 4 例。
+- **同请求粘号**（`scope=reqId`，`MSLXDFF_QODER_STICKY_MS` 默认 600s，`0`=关）：一次客户端请求内复用同一号，仅 401/403/429/5xx 冷却才换；`pick=new|sticky|switch|forced` 经 `x-mslxdff-qoder-account` 回显、冷却经 `x-mslxdff-qoder-cooldown` 回显。`test/qoder-cooldown-stream.test.js` 3 例。
+- **wire 四条硬规矩**（openspec qoder-p0-fixes，`test/qoder-p0-fixes.test.js` 19 例）：① 推理模型 `model_config.is_reasoning` 与 `chat_context.extra.modelConfig` 必须**双写**（只写前者上游不吐 reasoning_content）；数据源=`models.js peekModels` 快照（不吃 TTL、chat 路径恒 0 额外上游调用、冷目录降级 false 不阻断，preheat 灌缓存）；② 客户端无 tools 发 `tools:[]`——baseprompt 模板内嵌 14 工具永不出门；③ 上游 `finish_reason` 如实透传（length 截断从此可见），仅全程未给才兜底 stop/tool_calls，stream 与 aggregate 收尾判定同构；④ SSE 未完结行超 2MiB 即断（完整行消费后判、不连坐合法帧；流式流内 error 收尾、聚合 502 走短冷却）。
+- **判决三分类与冷却三档（ADR-0044）**：同一个 `10605` 容器既裹额度也裹排队，`sse.js` 判序固定「先 `findQuotaSignal`（内层 code 110 / Billing 措辞）→ 后 `findQueueSignal`（code 10605 / `isQueued:true` / `serviceAvailable:false`）」。排队**不新增 kind**（仍 `upstream`，只挂 `err.queued`），经内部头 `x-mslxdff-qoder-queued` 交出门面，对外仍恒 200。门面冷却分三档：额度 `quotaCooldownMs`(1h) > **排队 `queueCooldownMs`(300s)** > 其它 `cooldownMs`(30s)，且额度与排队**都在同一请求内当场换号**（`isQuota || isQueued` 且 `ring.available()>0` → `continue`）；空转（模型零输出）仍不换号不冷却（ADR-0036 否决方案 D 的口径不变，别把两者混为一谈）。全号都在冷却时 `pickKey` 的 `ring.next() || keys[0]` 仍会 `forced` 补一发（冷却是轮转偏好不是硬拒）。`test/qoder-queue-switch.test.js` 8 例；`test/qoder-envelope-status.test.js` 现为 5 例（前者首已按新行为改写）。
+- `GET /v1/models` 在 `modelPicks` 非空时按勾选集裁剪（`filterByPicks`，空勾选=不裁剪，`?all=1` 绕过），`-models` 交互候选取数恒走 `?all=1`；交互选择器按终端行高开窗分页（`src/chooser.js`，多选行形状 `❯ [✓] <id>`）。
+
+
+## qwenwork（cn）与 globalqwenwork（国际站）— 同协议两租户（ADR-0037/0041）
+
+- 千问办公两站 `gateway.qwenwork.cn` / `gateway.qwenwork.ai`：COSY 签名（**同一枚 RSA 模数**）、SSE 端点 `/algo/api/v2/service/pro/sse/agent_chat_generation`、chat body、refresh `{refresh_token}` **逐字同构**（现网双站实测 200），故 globalqwenwork 的协议模块从 qwenwork 逐字 vendor（仓库约定：provider 目录自包含、不跨目录 import）。**差异只在三处租户参数**：auth 域名、OAuth `client_id`（cn `e883ade2…` / intl `cc65e5fc…`）、深链 `redirect_uri`（`qwenwork-cn://` / `qwenwork://`）；**凭证与积分池两站不互通**（cn token 打 .ai → 401 INVALID_TOKEN）。
+- ⚠ **registry.js 子串陷阱**：qwenwork 的 matcher 是 `includes("qwenwork")`，而 `globalqwenwork` / `globalqwenwork://native` 都含该子串且 `getCustomProviderFactory` first-match-wins —— **globalqwenwork 条目必须排在 qwenwork 之前**，否则国际站 token 被 cn 工厂接管（乱 401 + refresh 污染 cn 号）。`test/globalqwenwork-provider.test.js` 第 2 例锁死该顺序；动 registry 顺序前先跑它。
+- 模型池零交集：cn `flash`/`pro`/`qwen3.8-max-preview`（pf 0.1/1/1.8，reasoning）↔ intl 仅 `qwork-auto`(→qwen3.8-flash)/`qwork-advanced`(→gpt-5.6-sol)（pf 0，非 reasoning，is_vl，max_input 180000）。登录各自种 allowlist、`allowAnyModels=false`（额度池防 auto 烧分）。国际站官方客户端自身走 gRPC `model.chat.ChatService/ChatCompletionStream`（其 `region/endpoints` 在 .ai 404），本仓不走 —— 见 ADR-0041 决策 1。
+## workbuddy
+
+- 专用 `POST /v2/chat/completions` **强制 `stream:true`** + `GET /v3/config` 按 credits 升序前缀 `workbuddy/`（**2026-10-10 换端点**：旧 `GET /console/enterprises/personal/models` 对多数 token 恒 401/500 → 目录 0 条 → `aggLoad` 判 `!allowed.length` 把整家跳过；`/v3/config` 返回**随 UA 变**，本仓 UA 与 chat 同身份故目录即"自己能调的那套"；`listModels` 已改逐 key 轮换，单个坏 token 不再清空目录）；401/403 自动 `POST /v2/plugin/auth/token/refresh` 回写 `state.json`+`auths/workbuddy-<uid>.json`（0600 tmp+rename）。
+- 凭据目录 `authDirFor()` 跟账本走 + `authDirCandidates()` 只读兜底旧位置 + `listAccountDocs()` 单一读取出口（provider/CLI/token-auto 四处复制品合一）；`-workbuddy remove` 扫全部候选目录防旧副本「复活」（ADR-0025，`test/workbuddy-authdir.test.js` 6 例）。
+- 接入禁手填 `<key>`，必须 `node workbuddy-token-auto.js` 自动化（whistle MITM :8899；whistle/MITM 取 codex token 路径已证伪）；桌面登录态跨平台发现 `src/providers/workbuddy/desktop-info.js`（显式 `--file`/env > 后缀快查 > 文件名 BFS depth≤6；Win `%LOCALAPPDATA%`/`%APPDATA%`、mac `~/Library/Application Support`、Linux `~/.config`）；设备授权加号（0.1.93）：`POST /v2/plugin/auth/state?platform=CLI` → 浏览器登录 → 轮询 `token?state=`，UA `CLI/2.63.2 CodeBuddy/2.63.2` 可 `MSLXDFF_WORKBUDDY_UA` 覆盖；每日 `workbuddy-checkin.js` 双域幂等 `code 10001` 视为成功。
+- `share` 默认 `off` 需 `MSLXDFF_WORKBUDDY_SHARE_KEYS=1`；`-setto workbuddy [modelId]` 原子写 `~/.workbuddy/models.json`（仅 127.0.0.1/v1）。
+- 出网 11128 指纹剥离（`payload.js` CC_SENTENCES 清单式）：上游扫 system/assistant，命中行首 `x-anthropic-billing-header:` 整行或官方固定整句（"You are Claude Code…" / "To give feedback…anthropics/claude-code/issues"）即 400 "unapproved channel"（实测整句纯子串匹配、user/tool 不扫、换说法放行）——只剥固定形态，新拦句加清单。
+
+## cline
+
+- 指纹头：UA `Cline/3.0.47` + `X-CLIENT-TYPE: cline-sdk` + `X-CLIENT-VERSION` 同 UA；对话链 = `POST /api/v1/auth/refresh`（**每次 refresh 轮换 refreshToken 必须回写**）→ `Bearer workos:<accessToken>` + 固定 `<base>/api/v1/chat/completions`（**baseUrl 已含 /api/v1 时只拼 `/chat/completions`，否则双 /api/v1 会 401/empty response**）；deepseek/z-ai 免费通道必须 `stream:true` + SSE 聚合否则 `500 empty response content`；`X-Task-ID`/`session_id` 每次唯一。
+- 发上游剥 `provider/` 前缀（`cline/deepseek/X→deepseek/X`）恢复 forceStream 聚合 + 非 JSON 响应体 TypeError 加固（`test/cline-chat-id.test.js` 4 用例，0.1.91）。
+- 白名单自动同步（ADR-0033 → **ADR-0067 双向收敛**）：`allowlist-sync.js` 的 `planSync` 按 free 目录增删 `allowedModels`；移除只限 free 命名空间（`isFreeChannelId`），`cline-pass/*` 与手配 id 不动（目录接口只回 free，拿它判 pass 会误删付费通道），细节见 ADR-0067。`models.js` 仅在上游成功路径调 `notifyRefresh`（兜底不写盘）；无增删零写盘；`MSLXDFF_CLINE_AUTOSYNC=0` 关（含移除）；**教训：`saveProviderAllowedModels`/`saveProviderConfig` 重建 cfg 时起手 `{baseUrl,keys}` 未带 `allowAnyModels` 会静默抹成 false**（已修，勿回退）。
+- 登录走 WorkOS 设备授权流（client_id `client_01K3A541FN8TA3EPPHTD2325AR`），refreshToken 落 `providerConfigs.{cline}.keys`；bench 检测 keys 含 refreshToken 即走 refresh→指纹头→stream 测速专用分支。
+
+## bench 与额度保护（`src/bench/`）
+
+- `bench/bench --via` 仅测（allowlist ∩ 全局 picks）交集（`filterBenchModels`，picks 空回退 allowlist）；计费模型（无 `-free` 后缀）需显式点名才测（`max_tokens=5` 也计费）；`--via` 额度保护默认跳过 `opencode` 需 `--include-opencode` 且 TTY 二次确认 `y/N`；0.1.84 起完全串行 `直连→逐 peer`（`MSLXDFF_BENCH_DELAY_MS=120`）逐模型实时打印（`--json` 进度走 `stderr`）。
+- `aihubmix gemini 400 no_available_channel` 为上游无通道非 bench bug；peer name 统一短化 `host:port`。
+- **烧额度的实测必须先经用户明确同意**：付费/订阅/按量计费上游的裸调、A/B 长文生成一律先问（2026-09-23 教训）；免费池探针（public 免费模型、短 prompt 微量）可直接跑。

package/src/providers/agentrouter.js

@@ -1,238 +1,238 @@
-// AgentRouter 定制供应商：OpenAI 兼容聚合网关，有四道硬门槛（2026-10-21 现网 curl 实测）：
-//   ① 客户端身份白名单 —— UA 为 `mslxdff`/`curl`/浏览器一律 401 `unauthorized client detected`，
-//      只放行 `opencode/*` 与 `claude-cli/<ver> (external…)`；
-//   ② 模型分端点 —— `deepseek-v4-flash` 吃 /v1/chat/completions，`gpt-6.1-sol`/`gpt-6-astra`
-//      对该端点回 400「请改用 /v1/responses」，只在 responses 通道可用；
-//   ③ 内容闸 —— 正文含 `x-anthropic` 字样稳定 500 `sensitive words detected`（连 user 消息也拦，
-//      与 workbuddy 只扫 system/assistant 不同），见 stripAgentRouterSensitive；
-//   ④ 传输层 —— 上游对 Node/undici 的**新建 TCP 连接**选择性丢包（现网对照：undici 0/4~0/6
-//      全 connect 超时，curl 同刻 100% 200，走系统代理亦不稳）⇒ 本家 fetchImpl 缺省换
-//      curl-fetch 子进程通道（`MSLXDFF_AGENTROUTER_FETCH=undici` 可切回）。
-// 故不复用 generic（其 UA 写死 `mslxdff`、responses 判定只认 models.dev npm 索引），这里自组装，
-// 底层仍复用 base.js 的 runner 与 responses-channel 的协议互转。
-import { createKeyRing } from "./keyring.js";
-import { loadProviderBaseUrl, loadProviderKeys } from "../state.js";
-import { createChatRunner, createAgent, envInt, getUndici, joinUrl, collectApiKeysGeneric } from "./base.js";
-import { createResponsesChannel, resolveResponsesPath } from "./responses-channel.js";
-import { createCurlFetch } from "./curl-fetch.js";
-import { compatFetch } from "../compat.js";
-import { opencodeUa } from "../opencode-identity.js";
-import { joinModelId } from "./model-id.js";
-
-const { UndiciFetch } = getUndici();
-
-export const DEFAULT_AGENTROUTER_BASE = "https://agentrouter.org";
-export const MODELS_PATH = "/v1/models";
-export const CHAT_PATH = "/v1/chat/completions";
-export const RESPONSES_PATH = "/v1/responses";
-
-// 只吃 responses 的模型族：现网实测 gpt-6* 打 chat 端点回 400 并显式要求改 /v1/responses。
-const RESPONSES_PREFIXES = ["gpt-6"];
-
-export function isAgentRouterResponsesModel(model) {
-  const m = String(model || "").trim().toLowerCase();
-  if (!m) return false;
-  return RESPONSES_PREFIXES.some((p) => m.startsWith(p));
-}
-
-// baseUrl 归一：缺省取 state/env，剥掉尾部 `/v1`（路径常量自带 `/v1`，避免 /v1/v1）
-export function resolveAgentRouterBase(baseUrl) {
-  const raw = baseUrl || loadProviderBaseUrl("agentrouter") || DEFAULT_AGENTROUTER_BASE;
-  return String(raw).trim().replace(/\/+$/, "").replace(/\/v1$/i, "");
-}
-
-// responses 通道内部两处 stream 判据不一致（响应通道用 `!== false` 决定读法，body 转换用
-// `=== true` 决定发什么）：客户端不显式给 stream 时，会去把未转换的上游 JSON 当 chat 形状读。
-// 这里先把意图钉成布尔，两条路径就同源了。
-export function normalizeResponsesBody(body) {
-  if (!body || typeof body !== "object") return body;
-  return { ...body, stream: body.stream === true };
-}
-
-// AgentRouter 内容闸：稳定拦截正文里含 `x-anthropic` 字样的请求（2026-10-21 现网实测：
-// `500 sensitive words detected` / `400 content-blocked`，连 `x-anthropic` 一个词也拦；
-// `x-google`/`x-meta`/`x-openai`/`anthropic` 均放行——这是对 Anthropic 内部计费头/代理指纹的反代理风控）。
-// 与 workbuddy 的 CC_SENTENCES 剥离同类，但**必须覆盖所有 role**（workbuddy 只扫 system/assistant，
-// 而 agentrouter 连 user/tool 消息里出现该串也拦）。用零宽空格断开子串匹配、不动其余内容。
-// 返回新对象（messages 浅拷贝），不污染调用方 body（dispatcher 可能复用同一 body 做兜底重试）。
-const AR_SENSITIVE = /x-anthropic/gi;
-
-export function stripAgentRouterSensitive(obj) {
-  if (!obj || typeof obj !== "object") return obj;
-  if (!Array.isArray(obj.messages)) return obj;
-  const mask = (text) => (typeof text === "string" && AR_SENSITIVE.test(text) ? text.replace(AR_SENSITIVE, "x​anthropic") : text);
-  const out = { ...obj, messages: obj.messages.map((m) => {
-    if (!m || typeof m !== "object") return m;
-    const nm = { ...m };
-    if (typeof m.content === "string") nm.content = mask(m.content);
-    else if (Array.isArray(m.content)) nm.content = m.content.map((p) => (p && typeof p === "object" && typeof p.text === "string" ? { ...p, text: mask(p.text) } : p));
-    if (typeof m.name === "string") nm.name = mask(m.name);
-    return nm;
-  }) };
-  return out;
-}
-
-export function createAgentRouterProvider({
-  id = "agentrouter",
-  baseUrl,
-  apiKeys,
-  apiKey,
-  connectTimeoutMs = envInt("MSLXDFF_AGENTROUTER_TIMEOUT_MS", 60_000),
-  cooldownMs = envInt("MSLXDFF_AGENTROUTER_COOLDOWN_MS", 30_000),
-  fetchImpl,
-  file,
-} = {}) {
-  if (id !== "agentrouter") throw new Error(`agentrouter provider id mismatch: ${id}`);
-  const resolvedBase = resolveAgentRouterBase(baseUrl);
-  // 传输层缺省走 curl 子进程（见文件头门槛④）：上游对 undici 新建连接选择性丢包，
-  // 实测 curl 同刻稳定。`MSLXDFF_AGENTROUTER_FETCH=undici` 切回 undici（配好上游修复后或对照排查用）。
-  const useCurl = !fetchImpl && String(process.env.MSLXDFF_AGENTROUTER_FETCH || "curl").toLowerCase() !== "undici";
-  if (!fetchImpl) fetchImpl = useCurl ? createCurlFetch() : (UndiciFetch || compatFetch);
-
-  const ring = createKeyRing(
-    collectApiKeysGeneric(id, apiKeys, apiKey, (pid) => loadProviderKeys(pid, file ? { file } : {})),
-    { cooldownMs },
-  );
-
-  let agent = null; let dispatcher = null;
-  {
-    const a = createAgent({
-      keepAliveTimeout: envInt("MSLXDFF_AGENTROUTER_KEEPALIVE_TIMEOUT", 30_000),
-      keepAliveMaxTimeout: envInt("MSLXDFF_AGENTROUTER_KEEPALIVE_MAX_TIMEOUT", 60_000),
-      connections: envInt("MSLXDFF_AGENTROUTER_KEEPALIVE_CONNECTIONS", 20),
-    });
-    agent = a.agent; dispatcher = a.dispatcher;
-  }
-
-  // 身份 UA：白名单只认 opencode / claude-cli，缺了恒 401。单独 env 可覆盖，不联动全局。
-  function identityUa() {
-    return process.env.MSLXDFF_AGENTROUTER_UA || opencodeUa();
-  }
-
-  function buildHeaders(body, key) {
-    const isStream = body?.stream !== false;
-    const h = {
-      "Content-Type": "application/json",
-      Accept: isStream ? "text/event-stream" : "*/*",
-      "User-Agent": identityUa(),
-    };
-    if (key) h.Authorization = `Bearer ${key}`;
-    return h;
-  }
-
-  function jsonHeaders(key) {
-    const h = { Accept: "application/json", "User-Agent": identityUa() };
-    if (key) h.Authorization = `Bearer ${key}`;
-    return h;
-  }
-
-  // 网络重试：agentrouter 只有 1 把 key，任何一次瞬时连接抖动（现网实测 ECONNRESET 偶发，
-  // 上游高频时会触发）若直接 onError，= 立刻冷却 30s、把后续请求全挡成
-  // "all keys in cooldown"。补 attempts=2（对齐 generic/cline/workbuddy），让网络层重试先扛一下。
-  const chatRetry = { network: { attempts: 2, delayMs: 300 }, 429: { attempts: 1, delayMs: 100 }, 502: { attempts: 1, delayMs: 100 }, 503: { attempts: 1, delayMs: 100 }, 504: { attempts: 1, delayMs: 100 } };
-
-  const { runChat } = createChatRunner({
-    id, ring, cooldownMs, retry: chatRetry, fetchImpl, dispatcher, buildHeaders,
-    getUrl: () => joinUrl(resolvedBase, CHAT_PATH),
-    connectTimeoutMs,
-    // 非流式走原生（SDK 通道只服务 opencode zen 的形状），responses 另走专用通道
-    sdkDispatch: { enabled: false },
-  });
-
-  const responses = createResponsesChannel({
-    id,
-    url: joinUrl(resolvedBase, resolveResponsesPath(id, RESPONSES_PATH)),
-    connectTimeoutMs,
-    cooldownMs,
-    retry: chatRetry,
-    // 关 SDK：其缺省会强塞 include:["reasoning.encrypted_content"] / store:false，agentrouter 未验证支持
-    sdkEnabled: false,
-    buildHeaders,
-    fetchImpl,
-    dispatcher,
-  });
-
-  async function chat(body, opts) {
-    const sourceKey = `MSLXDFF_AGENTROUTER_KEY`;
-    const clean = stripAgentRouterSensitive(body);
-    if (isAgentRouterResponsesModel(clean?.model)) return responses.run(normalizeResponsesBody(clean), ring, sourceKey, opts);
-    return runChat(clean, ring, sourceKey);
-  }
-
-  async function chatWithKeys(body, keys, opts) {
-    const tmp = createKeyRing(keys, { cooldownMs });
-    const clean = stripAgentRouterSensitive(body);
-    if (isAgentRouterResponsesModel(clean?.model)) return responses.run(normalizeResponsesBody(clean), tmp, "shared provider keys", opts);
-    const scoped = createChatRunner({
-      id, ring: tmp, cooldownMs, retry: chatRetry, fetchImpl, dispatcher, buildHeaders,
-      getUrl: () => joinUrl(resolvedBase, CHAT_PATH),
-      connectTimeoutMs,
-      sdkDispatch: { enabled: false },
-    });
-    return scoped.runChat(clean, tmp, "shared provider keys");
-  }
-
-  let modelsCache = { at: 0, list: [] };
-  const MODELS_TTL_MS = 10 * 60 * 1000;
-
-  async function fetchModels() {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(new Error(`${id} models timed out`)), 15_000);
-    try {
-      const key = ring.next() || ring.keys[0];
-      const opts = { headers: jsonHeaders(key), signal: controller.signal };
-      if (dispatcher) opts.dispatcher = dispatcher;
-      const res = await fetchImpl(joinUrl(resolvedBase, MODELS_PATH), opts);
-      if (!res.ok) throw new Error(`${id} models: http ${res.status}`);
-      const json = await res.json().catch(() => ({}));
-      return Array.isArray(json?.data) ? json.data : Array.isArray(json) ? json : [];
-    } finally {
-      clearTimeout(timer);
-    }
-  }
-
-  async function listModels() {
-    if (modelsCache.list.length && Date.now() - modelsCache.at < MODELS_TTL_MS) return modelsCache.list;
-    let raw = [];
-    try {
-      raw = await fetchModels();
-    } catch {
-      return modelsCache.list; // 拉取失败给上次缓存（首次为空），不阻断启动
-    }
-    const list = raw
-      .filter((m) => m && typeof m.id === "string" && m.id.trim())
-      .map((m) => ({
-        id: joinModelId(id, m.id),
-        object: "model",
-        name: m.name || m.id,
-        owned_by: m.owned_by || "agentrouter",
-        ...(m.created ? { created: m.created } : {}),
-      }));
-    modelsCache = { at: Date.now(), list };
-    return list;
-  }
-
-  async function preheat() {
-    try {
-      const m = await listModels();
-      return { ok: m.length > 0, models: m.length };
-    } catch (err) {
-      return { ok: false, error: String(err?.message || err).slice(0, 120) };
-    }
-  }
-
-  async function close() { if (agent?.close) try { await agent.close(); } catch {} }
-
-  return {
-    id,
-    chat,
-    chatWithKeys,
-    listModels,
-    preheat,
-    close,
-    agent,
-    keyRing: ring,
-    baseUrl: resolvedBase,
-    responsesUrl: responses.url,
-  };
-}
+// AgentRouter 定制供应商：OpenAI 兼容聚合网关，有四道硬门槛（2026-10-21 现网 curl 实测）：
+//   ① 客户端身份白名单 —— UA 为 `mslxdff`/`curl`/浏览器一律 401 `unauthorized client detected`，
+//      只放行 `opencode/*` 与 `claude-cli/<ver> (external…)`；
+//   ② 模型分端点 —— `deepseek-v4-flash` 吃 /v1/chat/completions，`gpt-6.1-sol`/`gpt-6-astra`
+//      对该端点回 400「请改用 /v1/responses」，只在 responses 通道可用；
+//   ③ 内容闸 —— 正文含 `x-anthropic` 字样稳定 500 `sensitive words detected`（连 user 消息也拦，
+//      与 workbuddy 只扫 system/assistant 不同），见 stripAgentRouterSensitive；
+//   ④ 传输层 —— 上游对 Node/undici 的**新建 TCP 连接**选择性丢包（现网对照：undici 0/4~0/6
+//      全 connect 超时，curl 同刻 100% 200，走系统代理亦不稳）⇒ 本家 fetchImpl 缺省换
+//      curl-fetch 子进程通道（`MSLXDFF_AGENTROUTER_FETCH=undici` 可切回）。
+// 故不复用 generic（其 UA 写死 `mslxdff`、responses 判定只认 models.dev npm 索引），这里自组装，
+// 底层仍复用 base.js 的 runner 与 responses-channel 的协议互转。
+import { createKeyRing } from "./keyring.js";
+import { loadProviderBaseUrl, loadProviderKeys } from "../state.js";
+import { createChatRunner, createAgent, envInt, getUndici, joinUrl, collectApiKeysGeneric } from "./base.js";
+import { createResponsesChannel, resolveResponsesPath } from "./responses-channel.js";
+import { createCurlFetch } from "./curl-fetch.js";
+import { compatFetch } from "../compat.js";
+import { opencodeUa } from "../opencode-identity.js";
+import { joinModelId } from "./model-id.js";
+
+const { UndiciFetch } = getUndici();
+
+export const DEFAULT_AGENTROUTER_BASE = "https://agentrouter.org";
+export const MODELS_PATH = "/v1/models";
+export const CHAT_PATH = "/v1/chat/completions";
+export const RESPONSES_PATH = "/v1/responses";
+
+// 只吃 responses 的模型族：现网实测 gpt-6* 打 chat 端点回 400 并显式要求改 /v1/responses。
+const RESPONSES_PREFIXES = ["gpt-6"];
+
+export function isAgentRouterResponsesModel(model) {
+  const m = String(model || "").trim().toLowerCase();
+  if (!m) return false;
+  return RESPONSES_PREFIXES.some((p) => m.startsWith(p));
+}
+
+// baseUrl 归一：缺省取 state/env，剥掉尾部 `/v1`（路径常量自带 `/v1`，避免 /v1/v1）
+export function resolveAgentRouterBase(baseUrl) {
+  const raw = baseUrl || loadProviderBaseUrl("agentrouter") || DEFAULT_AGENTROUTER_BASE;
+  return String(raw).trim().replace(/\/+$/, "").replace(/\/v1$/i, "");
+}
+
+// responses 通道内部两处 stream 判据不一致（响应通道用 `!== false` 决定读法，body 转换用
+// `=== true` 决定发什么）：客户端不显式给 stream 时，会去把未转换的上游 JSON 当 chat 形状读。
+// 这里先把意图钉成布尔，两条路径就同源了。
+export function normalizeResponsesBody(body) {
+  if (!body || typeof body !== "object") return body;
+  return { ...body, stream: body.stream === true };
+}
+
+// AgentRouter 内容闸：稳定拦截正文里含 `x-anthropic` 字样的请求（2026-10-21 现网实测：
+// `500 sensitive words detected` / `400 content-blocked`，连 `x-anthropic` 一个词也拦；
+// `x-google`/`x-meta`/`x-openai`/`anthropic` 均放行——这是对 Anthropic 内部计费头/代理指纹的反代理风控）。
+// 与 workbuddy 的 CC_SENTENCES 剥离同类，但**必须覆盖所有 role**（workbuddy 只扫 system/assistant，
+// 而 agentrouter 连 user/tool 消息里出现该串也拦）。用零宽空格断开子串匹配、不动其余内容。
+// 返回新对象（messages 浅拷贝），不污染调用方 body（dispatcher 可能复用同一 body 做兜底重试）。
+const AR_SENSITIVE = /x-anthropic/gi;
+
+export function stripAgentRouterSensitive(obj) {
+  if (!obj || typeof obj !== "object") return obj;
+  if (!Array.isArray(obj.messages)) return obj;
+  const mask = (text) => (typeof text === "string" && AR_SENSITIVE.test(text) ? text.replace(AR_SENSITIVE, "x​anthropic") : text);
+  const out = { ...obj, messages: obj.messages.map((m) => {
+    if (!m || typeof m !== "object") return m;
+    const nm = { ...m };
+    if (typeof m.content === "string") nm.content = mask(m.content);
+    else if (Array.isArray(m.content)) nm.content = m.content.map((p) => (p && typeof p === "object" && typeof p.text === "string" ? { ...p, text: mask(p.text) } : p));
+    if (typeof m.name === "string") nm.name = mask(m.name);
+    return nm;
+  }) };
+  return out;
+}
+
+export function createAgentRouterProvider({
+  id = "agentrouter",
+  baseUrl,
+  apiKeys,
+  apiKey,
+  connectTimeoutMs = envInt("MSLXDFF_AGENTROUTER_TIMEOUT_MS", 60_000),
+  cooldownMs = envInt("MSLXDFF_AGENTROUTER_COOLDOWN_MS", 30_000),
+  fetchImpl,
+  file,
+} = {}) {
+  if (id !== "agentrouter") throw new Error(`agentrouter provider id mismatch: ${id}`);
+  const resolvedBase = resolveAgentRouterBase(baseUrl);
+  // 传输层缺省走 curl 子进程（见文件头门槛④）：上游对 undici 新建连接选择性丢包，
+  // 实测 curl 同刻稳定。`MSLXDFF_AGENTROUTER_FETCH=undici` 切回 undici（配好上游修复后或对照排查用）。
+  const useCurl = !fetchImpl && String(process.env.MSLXDFF_AGENTROUTER_FETCH || "curl").toLowerCase() !== "undici";
+  if (!fetchImpl) fetchImpl = useCurl ? createCurlFetch() : (UndiciFetch || compatFetch);
+
+  const ring = createKeyRing(
+    collectApiKeysGeneric(id, apiKeys, apiKey, (pid) => loadProviderKeys(pid, file ? { file } : {})),
+    { cooldownMs },
+  );
+
+  let agent = null; let dispatcher = null;
+  {
+    const a = createAgent({
+      keepAliveTimeout: envInt("MSLXDFF_AGENTROUTER_KEEPALIVE_TIMEOUT", 30_000),
+      keepAliveMaxTimeout: envInt("MSLXDFF_AGENTROUTER_KEEPALIVE_MAX_TIMEOUT", 60_000),
+      connections: envInt("MSLXDFF_AGENTROUTER_KEEPALIVE_CONNECTIONS", 20),
+    });
+    agent = a.agent; dispatcher = a.dispatcher;
+  }
+
+  // 身份 UA：白名单只认 opencode / claude-cli，缺了恒 401。单独 env 可覆盖，不联动全局。
+  function identityUa() {
+    return process.env.MSLXDFF_AGENTROUTER_UA || opencodeUa();
+  }
+
+  function buildHeaders(body, key) {
+    const isStream = body?.stream !== false;
+    const h = {
+      "Content-Type": "application/json",
+      Accept: isStream ? "text/event-stream" : "*/*",
+      "User-Agent": identityUa(),
+    };
+    if (key) h.Authorization = `Bearer ${key}`;
+    return h;
+  }
+
+  function jsonHeaders(key) {
+    const h = { Accept: "application/json", "User-Agent": identityUa() };
+    if (key) h.Authorization = `Bearer ${key}`;
+    return h;
+  }
+
+  // 网络重试：agentrouter 只有 1 把 key，任何一次瞬时连接抖动（现网实测 ECONNRESET 偶发，
+  // 上游高频时会触发）若直接 onError，= 立刻冷却 30s、把后续请求全挡成
+  // "all keys in cooldown"。补 attempts=2（对齐 generic/cline/workbuddy），让网络层重试先扛一下。
+  const chatRetry = { network: { attempts: 2, delayMs: 300 }, 429: { attempts: 1, delayMs: 100 }, 502: { attempts: 1, delayMs: 100 }, 503: { attempts: 1, delayMs: 100 }, 504: { attempts: 1, delayMs: 100 } };
+
+  const { runChat } = createChatRunner({
+    id, ring, cooldownMs, retry: chatRetry, fetchImpl, dispatcher, buildHeaders,
+    getUrl: () => joinUrl(resolvedBase, CHAT_PATH),
+    connectTimeoutMs,
+    // 非流式走原生（SDK 通道只服务 opencode zen 的形状），responses 另走专用通道
+    sdkDispatch: { enabled: false },
+  });
+
+  const responses = createResponsesChannel({
+    id,
+    url: joinUrl(resolvedBase, resolveResponsesPath(id, RESPONSES_PATH)),
+    connectTimeoutMs,
+    cooldownMs,
+    retry: chatRetry,
+    // 关 SDK：其缺省会强塞 include:["reasoning.encrypted_content"] / store:false，agentrouter 未验证支持
+    sdkEnabled: false,
+    buildHeaders,
+    fetchImpl,
+    dispatcher,
+  });
+
+  async function chat(body, opts) {
+    const sourceKey = `MSLXDFF_AGENTROUTER_KEY`;
+    const clean = stripAgentRouterSensitive(body);
+    if (isAgentRouterResponsesModel(clean?.model)) return responses.run(normalizeResponsesBody(clean), ring, sourceKey, opts);
+    return runChat(clean, ring, sourceKey);
+  }
+
+  async function chatWithKeys(body, keys, opts) {
+    const tmp = createKeyRing(keys, { cooldownMs });
+    const clean = stripAgentRouterSensitive(body);
+    if (isAgentRouterResponsesModel(clean?.model)) return responses.run(normalizeResponsesBody(clean), tmp, "shared provider keys", opts);
+    const scoped = createChatRunner({
+      id, ring: tmp, cooldownMs, retry: chatRetry, fetchImpl, dispatcher, buildHeaders,
+      getUrl: () => joinUrl(resolvedBase, CHAT_PATH),
+      connectTimeoutMs,
+      sdkDispatch: { enabled: false },
+    });
+    return scoped.runChat(clean, tmp, "shared provider keys");
+  }
+
+  let modelsCache = { at: 0, list: [] };
+  const MODELS_TTL_MS = 10 * 60 * 1000;
+
+  async function fetchModels() {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(new Error(`${id} models timed out`)), 15_000);
+    try {
+      const key = ring.next() || ring.keys[0];
+      const opts = { headers: jsonHeaders(key), signal: controller.signal };
+      if (dispatcher) opts.dispatcher = dispatcher;
+      const res = await fetchImpl(joinUrl(resolvedBase, MODELS_PATH), opts);
+      if (!res.ok) throw new Error(`${id} models: http ${res.status}`);
+      const json = await res.json().catch(() => ({}));
+      return Array.isArray(json?.data) ? json.data : Array.isArray(json) ? json : [];
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+
+  async function listModels() {
+    if (modelsCache.list.length && Date.now() - modelsCache.at < MODELS_TTL_MS) return modelsCache.list;
+    let raw = [];
+    try {
+      raw = await fetchModels();
+    } catch {
+      return modelsCache.list; // 拉取失败给上次缓存（首次为空），不阻断启动
+    }
+    const list = raw
+      .filter((m) => m && typeof m.id === "string" && m.id.trim())
+      .map((m) => ({
+        id: joinModelId(id, m.id),
+        object: "model",
+        name: m.name || m.id,
+        owned_by: m.owned_by || "agentrouter",
+        ...(m.created ? { created: m.created } : {}),
+      }));
+    modelsCache = { at: Date.now(), list };
+    return list;
+  }
+
+  async function preheat() {
+    try {
+      const m = await listModels();
+      return { ok: m.length > 0, models: m.length };
+    } catch (err) {
+      return { ok: false, error: String(err?.message || err).slice(0, 120) };
+    }
+  }
+
+  async function close() { if (agent?.close) try { await agent.close(); } catch {} }
+
+  return {
+    id,
+    chat,
+    chatWithKeys,
+    listModels,
+    preheat,
+    close,
+    agent,
+    keyRing: ring,
+    baseUrl: resolvedBase,
+    responsesUrl: responses.url,
+  };
+}