mslxdff 0.1.199 → 0.1.203

package/src/plugins.js

@@ -1,107 +1,107 @@
-import { readdirSync, existsSync } from "node:fs";
-import { join, basename, extname } from "node:path";
-import { pathToFileURL } from "node:url";
-import os from "node:os";
-
-// mslxdff 插件系统：约定目录下的 *.mjs / *.js 模块，default export：
-//   { name?, version?, description?, hooks?: { "<hook-name>": async (ctx) => nextValue? } }
-// hook 返回数组时可替换流程值（如 model:select 的候选顺序）；返回 undefined 表示只观察。
-// 插件错误一律隔离：加载失败进 errors，hook 抛错不影响主链路。
-
-export function pluginsDir() {
-  return process.env.MSLXDFF_PLUGINS_DIR ||
-    join(os.homedir(), ".config", "mslxdff", "plugins");
-}
-
-// 安装目录下的 plugins/（随仓库/内置分发；auto-update 重装会丢，仅作开发/内置用）
-export function bundledPluginsDir(pkgRoot) {
-  if (!pkgRoot) return null;
-  return join(pkgRoot, "plugins");
-}
-
-// 解析扫描目录列表：env 完全接管；否则安装目录 plugins/ + 用户目录（同名文件用户目录优先）
-export function resolvePluginDirs({ pkgRoot } = {}) {
-  const env = process.env.MSLXDFF_PLUGINS_DIR;
-  if (env) return [env];
-  const dirs = [];
-  const bundled = bundledPluginsDir(pkgRoot);
-  if (bundled) dirs.push(bundled);
-  dirs.push(pluginsDir());
-  return dirs;
-}
-
-const PLUGIN_EXTS = new Set([".mjs", ".js"]);
-
-async function loadFromDir(dir, skipFiles) {
-  const plugins = [];
-  const errors = [];
-  if (!dir || !existsSync(dir)) return { plugins, errors };
-  let files = [];
-  try {
-    files = readdirSync(dir).filter((f) => PLUGIN_EXTS.has(extname(f).toLowerCase()));
-  } catch (err) {
-    errors.push({ file: dir, error: String(err?.message || err) });
-    return { plugins, errors };
-  }
-  files.sort();
-  for (const f of files) {
-    const file = join(dir, f);
-    if (skipFiles?.has(f)) continue; // 用户目录同名文件优先
-    try {
-      const mod = await import(pathToFileURL(file).href);
-      const plugin = mod?.default;
-      if (!plugin || typeof plugin !== "object") {
-        errors.push({ file, error: "no default export object" });
-        continue;
-      }
-      plugins.push({
-        name: typeof plugin.name === "string" && plugin.name ? plugin.name : basename(f, extname(f)),
-        version: typeof plugin.version === "string" ? plugin.version : "",
-        description: typeof plugin.description === "string" ? plugin.description : "",
-        hooks: plugin.hooks && typeof plugin.hooks === "object" ? plugin.hooks : {},
-        file,
-      });
-    } catch (err) {
-      errors.push({ file, error: String(err?.message || err) });
-    }
-  }
-  return { plugins, errors };
-}
-
-export async function loadPlugins({ dir, dirs } = {}) {
-  // 兼容旧签名 loadPlugins({ dir })；新签名 dirs 数组按优先级从低到高（后者覆盖前者同名文件）
-  const list = dirs || (dir ? [dir] : [pluginsDir()]);
-  let plugins = [];
-  const errors = [];
-  const seen = new Set(); // 已加载的 basename，先扫的目录跳过它们 → 后目录（高优先）覆盖
-  for (let i = list.length - 1; i >= 0; i--) {
-    const r = await loadFromDir(list[i], seen);
-    for (const p of r.plugins) seen.add(basename(p.file));
-    plugins = [...r.plugins, ...plugins]; // 低优先目录在前，目录内保持文件名序
-    errors.push(...r.errors);
-  }
-  return { plugins, errors };
-}
-
-// 串行执行某 hook。返回 { value, changed, errors }：
-// - value：最后一个返回非 undefined 值的插件的返回值（链式传递；数组、对象、布尔均可）
-// - changed：是否有插件返回了非 undefined 值（调用方可据此采用 value）
-export async function runHook(plugins, name, ctx) {
-  let value;
-  let changed = false;
-  const errors = [];
-  for (const p of plugins || []) {
-    const fn = p.hooks?.[name];
-    if (typeof fn !== "function") continue;
-    try {
-      const out = await fn(ctx);
-      if (out !== undefined) {
-        value = out;
-        changed = true;
-      }
-    } catch (err) {
-      errors.push({ plugin: p.name, error: String(err?.message || err) });
-    }
-  }
-  return { value, changed, errors };
-}
+import { readdirSync, existsSync } from "node:fs";
+import { join, basename, extname } from "node:path";
+import { pathToFileURL } from "node:url";
+import os from "node:os";
+
+// mslxdff 插件系统：约定目录下的 *.mjs / *.js 模块，default export：
+//   { name?, version?, description?, hooks?: { "<hook-name>": async (ctx) => nextValue? } }
+// hook 返回数组时可替换流程值（如 model:select 的候选顺序）；返回 undefined 表示只观察。
+// 插件错误一律隔离：加载失败进 errors，hook 抛错不影响主链路。
+
+export function pluginsDir() {
+  return process.env.MSLXDFF_PLUGINS_DIR ||
+    join(os.homedir(), ".config", "mslxdff", "plugins");
+}
+
+// 安装目录下的 plugins/（随仓库/内置分发；auto-update 重装会丢，仅作开发/内置用）
+export function bundledPluginsDir(pkgRoot) {
+  if (!pkgRoot) return null;
+  return join(pkgRoot, "plugins");
+}
+
+// 解析扫描目录列表：env 完全接管；否则安装目录 plugins/ + 用户目录（同名文件用户目录优先）
+export function resolvePluginDirs({ pkgRoot } = {}) {
+  const env = process.env.MSLXDFF_PLUGINS_DIR;
+  if (env) return [env];
+  const dirs = [];
+  const bundled = bundledPluginsDir(pkgRoot);
+  if (bundled) dirs.push(bundled);
+  dirs.push(pluginsDir());
+  return dirs;
+}
+
+const PLUGIN_EXTS = new Set([".mjs", ".js"]);
+
+async function loadFromDir(dir, skipFiles) {
+  const plugins = [];
+  const errors = [];
+  if (!dir || !existsSync(dir)) return { plugins, errors };
+  let files = [];
+  try {
+    files = readdirSync(dir).filter((f) => PLUGIN_EXTS.has(extname(f).toLowerCase()));
+  } catch (err) {
+    errors.push({ file: dir, error: String(err?.message || err) });
+    return { plugins, errors };
+  }
+  files.sort();
+  for (const f of files) {
+    const file = join(dir, f);
+    if (skipFiles?.has(f)) continue; // 用户目录同名文件优先
+    try {
+      const mod = await import(pathToFileURL(file).href);
+      const plugin = mod?.default;
+      if (!plugin || typeof plugin !== "object") {
+        errors.push({ file, error: "no default export object" });
+        continue;
+      }
+      plugins.push({
+        name: typeof plugin.name === "string" && plugin.name ? plugin.name : basename(f, extname(f)),
+        version: typeof plugin.version === "string" ? plugin.version : "",
+        description: typeof plugin.description === "string" ? plugin.description : "",
+        hooks: plugin.hooks && typeof plugin.hooks === "object" ? plugin.hooks : {},
+        file,
+      });
+    } catch (err) {
+      errors.push({ file, error: String(err?.message || err) });
+    }
+  }
+  return { plugins, errors };
+}
+
+export async function loadPlugins({ dir, dirs } = {}) {
+  // 兼容旧签名 loadPlugins({ dir })；新签名 dirs 数组按优先级从低到高（后者覆盖前者同名文件）
+  const list = dirs || (dir ? [dir] : [pluginsDir()]);
+  let plugins = [];
+  const errors = [];
+  const seen = new Set(); // 已加载的 basename，先扫的目录跳过它们 → 后目录（高优先）覆盖
+  for (let i = list.length - 1; i >= 0; i--) {
+    const r = await loadFromDir(list[i], seen);
+    for (const p of r.plugins) seen.add(basename(p.file));
+    plugins = [...r.plugins, ...plugins]; // 低优先目录在前，目录内保持文件名序
+    errors.push(...r.errors);
+  }
+  return { plugins, errors };
+}
+
+// 串行执行某 hook。返回 { value, changed, errors }：
+// - value：最后一个返回非 undefined 值的插件的返回值（链式传递；数组、对象、布尔均可）
+// - changed：是否有插件返回了非 undefined 值（调用方可据此采用 value）
+export async function runHook(plugins, name, ctx) {
+  let value;
+  let changed = false;
+  const errors = [];
+  for (const p of plugins || []) {
+    const fn = p.hooks?.[name];
+    if (typeof fn !== "function") continue;
+    try {
+      const out = await fn(ctx);
+      if (out !== undefined) {
+        value = out;
+        changed = true;
+      }
+    } catch (err) {
+      errors.push({ plugin: p.name, error: String(err?.message || err) });
+    }
+  }
+  return { value, changed, errors };
+}

package/src/providers/base.js

@@ -1,164 +1,164 @@
-import { createKeyRing } from "./keyring.js";
-import { joinModelId } from "./model-id.js";
-import { getUndici as compatGetUndici, compatFetch } from "../compat.js";
-import { createSdkDispatch } from "../upstream-engine/sdk/dispatch.js";
-
-const { fetch: UndiciFetch, Agent: UndiciAgent } = compatGetUndici();
-
-export function envInt(name, fallback) {
-  const v = Number(process.env[name]);
-  return Number.isInteger(v) && v > 0 ? v : fallback;
-}
-
-export function joinUrl(base, path) {
-  const b = String(base || "").trim().replace(/\/+$/, "");
-  const p = String(path || "").trim();
-  if (!p) return b;
-  const pp = p.startsWith("/") ? p : `/${p}`;
-  return `${b}${pp}`;
-}
-
-export function sleep(ms) {
-  return new Promise((r) => setTimeout(r, ms));
-}
-
-export function getUndici() {
-  return { UndiciAgent, UndiciFetch, fetch: UndiciFetch || compatFetch, Agent: UndiciAgent };
-}
-
-export function createAgent({ keepAliveTimeout = 30_000, keepAliveMaxTimeout = 60_000, connections = 20 } = {}) {
-  if (!UndiciAgent) return { agent: null, dispatcher: null };
-  try {
-    const agent = new UndiciAgent({ keepAliveTimeout, keepAliveMaxTimeout, connections, pipelining: 1 });
-    return { agent, dispatcher: agent };
-  } catch {
-    return { agent: null, dispatcher: null };
-  }
-}
-
-export function collectApiKeysGeneric(id, apiKeys, apiKey, loadKeys) {
-  const list = [
-    ...(Array.isArray(apiKeys) ? apiKeys : [apiKeys].filter(Boolean)),
-    apiKey,
-    ...(apiKeys === undefined && apiKey === undefined ? loadKeys(id) : []),
-  ].filter((k) => typeof k === "string" && k.trim().length);
-  return [...new Set(list.map((k) => k.trim()))];
-}
-
-export function createChatRunner({ id, ring, cooldownMs, retry, fetchImpl, dispatcher, buildHeaders, getUrl, connectTimeoutMs = 30_000, sdkDispatch } = {}) {
-  // SDK 通道（缺省）：仅流式；非流式委派原生，避免把 JSON 客户端 SSE 化。
-  const sdk = sdkDispatch === undefined ? createSdkDispatch({ id, providerName: id }) : sdkDispatch;
-
-  async function attemptOnce(url, body, key, activeRing) {
-    if (sdk?.enabled && body?.stream !== false) {
-      let r;
-      try { r = await sdk.trySdk({ url, body, headers: buildHeaders(body, key), fetchImpl }); }
-      catch (err) { return err; } // 交 runChat 的 network 重试/冷却
-      if (r) return r.status === 401 && !activeRing.size ? { __needKey: true } : r;
-    }
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(new Error(`${id} timed out after ${connectTimeoutMs}ms`)), connectTimeoutMs);
-    try {
-      const opts = { method: "POST", headers: buildHeaders(body, key), body: JSON.stringify(body), signal: controller.signal };
-      if (dispatcher) opts.dispatcher = dispatcher;
-      const res = await fetchImpl(url, opts);
-      if (res.status === 401 && !activeRing.size) return { __needKey: true };
-      return res;
-    } catch (err) {
-      return err;
-    } finally {
-      clearTimeout(timer);
-    }
-  }
-
-  async function runChat(body, activeRing, sourceKey) {
-    const url = getUrl();
-    const t0 = performance.now();
-    const attempts = [];
-    let waitMs = 0;
-    const key = activeRing.next();
-    if (!key && activeRing.size > 0) {
-      const err = new Error(`${id}: all API keys are in cooldown (last error < ${cooldownMs}ms ago) — provider temporarily unavailable`);
-      err._t = { attempts: [], waitMs: 0, totalMs: Math.round(performance.now() - t0), cooldownMs };
-      throw err;
-    }
-    for (let attempt = 0; ; attempt++) {
-      const t = performance.now();
-      const result = await attemptOnce(url, body, key, activeRing);
-      const type = result instanceof Error ? "network" : `http${result?.status}`;
-      attempts.push({ attempt, type, ms: Math.round(performance.now() - t) });
-      if (result?.__needKey) {
-        const err = new Error(`${id}: missing ${sourceKey} (chat requires a real key)`);
-        err._t = { attempts, waitMs, totalMs: Math.round(performance.now() - t0) };
-        throw err;
-      }
-      if (result instanceof Error) {
-        const entry = retry?.network;
-        if (entry && attempt < entry.attempts) { await sleep(entry.delayMs); waitMs += entry.delayMs; continue; }
-        activeRing.onError(key);
-        result._t = { attempts, waitMs, totalMs: Math.round(performance.now() - t0) };
-        throw result;
-      }
-      const entry = retry?.[result.status];
-      if (entry && attempt < entry.attempts) { await sleep(entry.delayMs); waitMs += entry.delayMs; continue; }
-      if (result.status === 401 || result.status === 403 || result.status === 429 || result.status >= 500) activeRing.onError(key);
-      result._t = { attempts, waitMs, totalMs: Math.round(performance.now() - t0) };
-      return result;
-    }
-  }
-
-  return { attemptOnce, runChat };
-}
-
-export function createListModelsRunner({ id, ring, dispatcher, fetchImpl, getUrl, mapModel }) {
-  const CACHE_TTL_MS = 10 * 60 * 1000;
-  let cache = null;
-  let fetchedAt = 0;
-  async function listModels() {
-    const now = Date.now();
-    if (cache && now - fetchedAt < CACHE_TTL_MS) return cache;
-    const url = getUrl();
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(new Error(`${id} models timed out`)), 15_000);
-    try {
-      const headers = { Accept: "application/json" };
-      const key = ring.next();
-      if (key) headers["Authorization"] = `Bearer ${key}`;
-      const opts = { headers, signal: controller.signal };
-      if (dispatcher) opts.dispatcher = dispatcher;
-      const res = await fetchImpl(url, opts);
-      if (!res.ok) return [];
-      const json = await res.json().catch(() => ({}));
-      const raw = Array.isArray(json.data) ? json.data : Array.isArray(json) ? json : [];
-      const mapped = mapModel ? mapModel(raw) : raw;
-      cache = mapped.filter((m) => m && typeof m.id === "string").map((m) => ({ ...m, id: joinModelId(id, m.id) }));
-      fetchedAt = now;
-      return cache;
-    } catch {
-      return [];
-    } finally {
-      clearTimeout(timer);
-    }
-  }
-  return { listModels, _cache: () => cache };
-}
-
-export function createPreheatRunner({ dispatcher, fetchImpl, getUrl, id, ring, loadKeys }) {
-  async function preheat() {
-    const url = getUrl();
-    const t0 = performance.now();
-    try {
-      const headers = { Accept: "application/json" };
-      const key = (loadKeys ? loadKeys(id)[0] : ring.next()) || ring.next();
-      if (key) headers["Authorization"] = `Bearer ${key}`;
-      const opts = { headers };
-      if (dispatcher) opts.dispatcher = dispatcher;
-      const res = await fetchImpl(url, opts);
-      try { if (res.body) await res.text().catch(() => {}); } catch {}
-      return { ok: res.ok, status: res.status, ms: Math.round(performance.now() - t0) };
-    } catch (err) {
-      return { ok: false, error: String(err?.message || err), ms: Math.round(performance.now() - t0) };
-    }
-  }
-  return { preheat };
-}
+import { createKeyRing } from "./keyring.js";
+import { joinModelId } from "./model-id.js";
+import { getUndici as compatGetUndici, compatFetch } from "../compat.js";
+import { createSdkDispatch } from "../upstream-engine/sdk/dispatch.js";
+
+const { fetch: UndiciFetch, Agent: UndiciAgent } = compatGetUndici();
+
+export function envInt(name, fallback) {
+  const v = Number(process.env[name]);
+  return Number.isInteger(v) && v > 0 ? v : fallback;
+}
+
+export function joinUrl(base, path) {
+  const b = String(base || "").trim().replace(/\/+$/, "");
+  const p = String(path || "").trim();
+  if (!p) return b;
+  const pp = p.startsWith("/") ? p : `/${p}`;
+  return `${b}${pp}`;
+}
+
+export function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+export function getUndici() {
+  return { UndiciAgent, UndiciFetch, fetch: UndiciFetch || compatFetch, Agent: UndiciAgent };
+}
+
+export function createAgent({ keepAliveTimeout = 30_000, keepAliveMaxTimeout = 60_000, connections = 20 } = {}) {
+  if (!UndiciAgent) return { agent: null, dispatcher: null };
+  try {
+    const agent = new UndiciAgent({ keepAliveTimeout, keepAliveMaxTimeout, connections, pipelining: 1 });
+    return { agent, dispatcher: agent };
+  } catch {
+    return { agent: null, dispatcher: null };
+  }
+}
+
+export function collectApiKeysGeneric(id, apiKeys, apiKey, loadKeys) {
+  const list = [
+    ...(Array.isArray(apiKeys) ? apiKeys : [apiKeys].filter(Boolean)),
+    apiKey,
+    ...(apiKeys === undefined && apiKey === undefined ? loadKeys(id) : []),
+  ].filter((k) => typeof k === "string" && k.trim().length);
+  return [...new Set(list.map((k) => k.trim()))];
+}
+
+export function createChatRunner({ id, ring, cooldownMs, retry, fetchImpl, dispatcher, buildHeaders, getUrl, connectTimeoutMs = 30_000, sdkDispatch } = {}) {
+  // SDK 通道（缺省）：仅流式；非流式委派原生，避免把 JSON 客户端 SSE 化。
+  const sdk = sdkDispatch === undefined ? createSdkDispatch({ id, providerName: id }) : sdkDispatch;
+
+  async function attemptOnce(url, body, key, activeRing) {
+    if (sdk?.enabled && body?.stream !== false) {
+      let r;
+      try { r = await sdk.trySdk({ url, body, headers: buildHeaders(body, key), fetchImpl }); }
+      catch (err) { return err; } // 交 runChat 的 network 重试/冷却
+      if (r) return r.status === 401 && !activeRing.size ? { __needKey: true } : r;
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(new Error(`${id} timed out after ${connectTimeoutMs}ms`)), connectTimeoutMs);
+    try {
+      const opts = { method: "POST", headers: buildHeaders(body, key), body: JSON.stringify(body), signal: controller.signal };
+      if (dispatcher) opts.dispatcher = dispatcher;
+      const res = await fetchImpl(url, opts);
+      if (res.status === 401 && !activeRing.size) return { __needKey: true };
+      return res;
+    } catch (err) {
+      return err;
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+
+  async function runChat(body, activeRing, sourceKey) {
+    const url = getUrl();
+    const t0 = performance.now();
+    const attempts = [];
+    let waitMs = 0;
+    const key = activeRing.next();
+    if (!key && activeRing.size > 0) {
+      const err = new Error(`${id}: all API keys are in cooldown (last error < ${cooldownMs}ms ago) — provider temporarily unavailable`);
+      err._t = { attempts: [], waitMs: 0, totalMs: Math.round(performance.now() - t0), cooldownMs };
+      throw err;
+    }
+    for (let attempt = 0; ; attempt++) {
+      const t = performance.now();
+      const result = await attemptOnce(url, body, key, activeRing);
+      const type = result instanceof Error ? "network" : `http${result?.status}`;
+      attempts.push({ attempt, type, ms: Math.round(performance.now() - t) });
+      if (result?.__needKey) {
+        const err = new Error(`${id}: missing ${sourceKey} (chat requires a real key)`);
+        err._t = { attempts, waitMs, totalMs: Math.round(performance.now() - t0) };
+        throw err;
+      }
+      if (result instanceof Error) {
+        const entry = retry?.network;
+        if (entry && attempt < entry.attempts) { await sleep(entry.delayMs); waitMs += entry.delayMs; continue; }
+        activeRing.onError(key);
+        result._t = { attempts, waitMs, totalMs: Math.round(performance.now() - t0) };
+        throw result;
+      }
+      const entry = retry?.[result.status];
+      if (entry && attempt < entry.attempts) { await sleep(entry.delayMs); waitMs += entry.delayMs; continue; }
+      if (result.status === 401 || result.status === 403 || result.status === 429 || result.status >= 500) activeRing.onError(key);
+      result._t = { attempts, waitMs, totalMs: Math.round(performance.now() - t0) };
+      return result;
+    }
+  }
+
+  return { attemptOnce, runChat };
+}
+
+export function createListModelsRunner({ id, ring, dispatcher, fetchImpl, getUrl, mapModel }) {
+  const CACHE_TTL_MS = 10 * 60 * 1000;
+  let cache = null;
+  let fetchedAt = 0;
+  async function listModels() {
+    const now = Date.now();
+    if (cache && now - fetchedAt < CACHE_TTL_MS) return cache;
+    const url = getUrl();
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(new Error(`${id} models timed out`)), 15_000);
+    try {
+      const headers = { Accept: "application/json" };
+      const key = ring.next();
+      if (key) headers["Authorization"] = `Bearer ${key}`;
+      const opts = { headers, signal: controller.signal };
+      if (dispatcher) opts.dispatcher = dispatcher;
+      const res = await fetchImpl(url, opts);
+      if (!res.ok) return [];
+      const json = await res.json().catch(() => ({}));
+      const raw = Array.isArray(json.data) ? json.data : Array.isArray(json) ? json : [];
+      const mapped = mapModel ? mapModel(raw) : raw;
+      cache = mapped.filter((m) => m && typeof m.id === "string").map((m) => ({ ...m, id: joinModelId(id, m.id) }));
+      fetchedAt = now;
+      return cache;
+    } catch {
+      return [];
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  return { listModels, _cache: () => cache };
+}
+
+export function createPreheatRunner({ dispatcher, fetchImpl, getUrl, id, ring, loadKeys }) {
+  async function preheat() {
+    const url = getUrl();
+    const t0 = performance.now();
+    try {
+      const headers = { Accept: "application/json" };
+      const key = (loadKeys ? loadKeys(id)[0] : ring.next()) || ring.next();
+      if (key) headers["Authorization"] = `Bearer ${key}`;
+      const opts = { headers };
+      if (dispatcher) opts.dispatcher = dispatcher;
+      const res = await fetchImpl(url, opts);
+      try { if (res.body) await res.text().catch(() => {}); } catch {}
+      return { ok: res.ok, status: res.status, ms: Math.round(performance.now() - t0) };
+    } catch (err) {
+      return { ok: false, error: String(err?.message || err), ms: Math.round(performance.now() - t0) };
+    }
+  }
+  return { preheat };
+}

package/src/providers/classify.js

@@ -1,22 +1,22 @@
-// ADR-0015：供应商路由分类三态 + EMA 纯函数（零依赖，防循环 import）
-// local-only：本机账号绑定（workbuddy/cline 系），组员转发无效
-// quota-pool：图额度不图速度（opencode free），直连先行、429 后组员兜底
-// latency-compare：key/token 类，direct vs link+remote 比延迟
-export function classifyProvider(id) {
-  const s = String(id || "").trim().toLowerCase();
-  if (s === "workbuddy" || s === "cline" || s === "codearts" || s === "traework" || s === "qoder" || s === "qwenwork" || s === "globalqwenwork" || s === "zcode" || s === "raccoon") return "local-only";
-  if (s === "opencode") return "quota-pool";
-  return "latency-compare";
-}
-
-// EMA（α=0.3）：prev 为空取 now；now 非法样本不参与；两者皆非法返 null
-// 0ms 是合法样本（本地/瞬时响应），只有 null/undefined/NaN/负数才非法
-export function emaMerge(prev, now, alpha = 0.3) {
-  const norm = (v) => (v === null || v === undefined ? null : (Number.isFinite(Number(v)) && Number(v) >= 0 ? Number(v) : null));
-  const a = norm(prev);
-  const b = norm(now);
-  if (a === null && b === null) return null;
-  if (a === null) return Math.round(b);
-  if (b === null) return Math.round(a);
-  return Math.round(a * (1 - alpha) + b * alpha);
-}
+// ADR-0015：供应商路由分类三态 + EMA 纯函数（零依赖，防循环 import）
+// local-only：本机账号绑定（workbuddy/cline 系），组员转发无效
+// quota-pool：图额度不图速度（opencode free），直连先行、429 后组员兜底
+// latency-compare：key/token 类，direct vs link+remote 比延迟
+export function classifyProvider(id) {
+  const s = String(id || "").trim().toLowerCase();
+  if (s === "workbuddy" || s === "cline" || s === "codearts" || s === "traework" || s === "qoder" || s === "qwenwork" || s === "globalqwenwork" || s === "zcode" || s === "raccoon") return "local-only";
+  if (s === "opencode") return "quota-pool";
+  return "latency-compare";
+}
+
+// EMA（α=0.3）：prev 为空取 now；now 非法样本不参与；两者皆非法返 null
+// 0ms 是合法样本（本地/瞬时响应），只有 null/undefined/NaN/负数才非法
+export function emaMerge(prev, now, alpha = 0.3) {
+  const norm = (v) => (v === null || v === undefined ? null : (Number.isFinite(Number(v)) && Number(v) >= 0 ? Number(v) : null));
+  const a = norm(prev);
+  const b = norm(now);
+  if (a === null && b === null) return null;
+  if (a === null) return Math.round(b);
+  if (b === null) return Math.round(a);
+  return Math.round(a * (1 - alpha) + b * alpha);
+}