mslxdff 0.1.203 → 0.1.208

package/src/providers/qoder/models.js

@@ -1,77 +1,77 @@
- // qoder 模型服务（转译 bridge.go ListModels/extractModels）：原生 COSY 签名拉 /model/list，
- // 10min 缓存（按 region 分桶）；只暴露 enable=true 的可用模型（enable=false 调对话必挂，不展示）。
-import { compatFetch, timeoutSignal } from "../../compat.js";
-import { getEndpoints, normalizeRegion } from "./constants.js";
-import { buildCosyHeaders, pathSigFrom } from "./session.js";
-import { joinModelId } from "../model-id.js";
-
-const CACHE_TTL_MS = 10 * 60 * 1000;
-const CREATED = 1753600000;
-const OWNER = "qoder";
-
-export function extractModels(chatList) {
-  const out = [];
-  for (const m of Array.isArray(chatList) ? chatList : []) {
-    if (!m?.key) continue;
-    out.push({
-      id: m.key,
-      name: String(m.display_name || m.key),
-      enable: Boolean(m.enable),
-      isDefault: Boolean(m.is_default),
-      isReasoning: Boolean(m.is_reasoning),
-      contextLength: Number(m.max_input_tokens) || 0,
-      priceFactor: Number(m.price_factor) || 0,
-    });
-  }
-  return out;
-}
-
-export function createModelsService({ id = "qoder", fetchImpl, clock = Date.now } = {}) {
-  let cache = null, fetchedAt = 0;
-
-   // 按 region 分桶缓存：同一进程可能有 cn + global 双号，混用单桶会串区（cn 14 个/global 15 个各不同）。
-   const cacheByRegion = new Map();
-   async function listModels(sess, region = "global") {
-     const normRegion = normalizeRegion(region);
-     const now = clock();
-     const hit = cacheByRegion.get(normRegion);
-     if (hit && now - hit.at < CACHE_TTL_MS) return hit.list;
-     const ep = getEndpoints(normRegion);
-     const url = ep.modelListURL;
-     const headers = buildCosyHeaders(sess, pathSigFrom(url), "", "application/json");
-     const res = await fetchImpl(url, { headers, signal: timeoutSignal(15000) });
-     if (!res.ok) throw new Error(`models http ${res.status}`);
-     const j = await res.json().catch(() => ({}));
-     // extractModels 恒返回数组（空数组亦 truthy），必须按长度选 chat/assistant 分支
-     const chatModels = extractModels(j.chat);
-     const models = chatModels.length ? chatModels : extractModels(j.assistant);
-     if (!models.length) throw new Error("models list empty");
-     // 只留可用：enable=false 的 key（如 global 的 auto/ultimate，cn 的绝大多数）展示即误导
-     const usable = models.filter((m) => m.enable);
-     if (!usable.length) throw new Error("models list empty (no enabled models)");
-     const list = usable.map((m) => ({
-       id: joinModelId(id, m.id),
-       object: "model",
-       created: CREATED,
-       owned_by: OWNER,
-       name: m.name,
-       context_length: m.contextLength,
-       enable: true,
-       is_reasoning: m.isReasoning,
-       price_factor: m.priceFactor,
-     }));
-     cacheByRegion.set(normRegion, { list, at: now });
-     // 兼容旧单测 _getCache：默认读 global 桶
-     cache = normRegion === "global" ? list : cache;
-     fetchedAt = normRegion === "global" ? now : fetchedAt;
-     return list;
-   }
- 
-  function clearCache() { cache = null; fetchedAt = 0; cacheByRegion.clear(); }
-  // 快照语义（评审路2 P0：不吃 TTL）：daemon 稳态里 chat 不再回源，能力标记「过期」也比「丢失」强——
-  // is_reasoning 启动预热后持续有效；刷新走 listModels（preheat/CLI/聚合路由），chat 路径恒 0 额外上游调用。
-  function peekModels(region = "global") {
-    return cacheByRegion.get(normalizeRegion(region))?.list ?? null;
-  }
-  return { listModels, peekModels, clearCache, _getCache: () => cache ?? cacheByRegion.get("global")?.list ?? null };
- }
+ // qoder 模型服务（转译 bridge.go ListModels/extractModels）：原生 COSY 签名拉 /model/list，
+ // 10min 缓存（按 region 分桶）；只暴露 enable=true 的可用模型（enable=false 调对话必挂，不展示）。
+import { compatFetch, timeoutSignal } from "../../compat.js";
+import { getEndpoints, normalizeRegion } from "./constants.js";
+import { buildCosyHeaders, pathSigFrom } from "./session.js";
+import { joinModelId } from "../model-id.js";
+
+const CACHE_TTL_MS = 10 * 60 * 1000;
+const CREATED = 1753600000;
+const OWNER = "qoder";
+
+export function extractModels(chatList) {
+  const out = [];
+  for (const m of Array.isArray(chatList) ? chatList : []) {
+    if (!m?.key) continue;
+    out.push({
+      id: m.key,
+      name: String(m.display_name || m.key),
+      enable: Boolean(m.enable),
+      isDefault: Boolean(m.is_default),
+      isReasoning: Boolean(m.is_reasoning),
+      contextLength: Number(m.max_input_tokens) || 0,
+      priceFactor: Number(m.price_factor) || 0,
+    });
+  }
+  return out;
+}
+
+export function createModelsService({ id = "qoder", fetchImpl, clock = Date.now } = {}) {
+  let cache = null, fetchedAt = 0;
+
+   // 按 region 分桶缓存：同一进程可能有 cn + global 双号，混用单桶会串区（cn 14 个/global 15 个各不同）。
+   const cacheByRegion = new Map();
+   async function listModels(sess, region = "global") {
+     const normRegion = normalizeRegion(region);
+     const now = clock();
+     const hit = cacheByRegion.get(normRegion);
+     if (hit && now - hit.at < CACHE_TTL_MS) return hit.list;
+     const ep = getEndpoints(normRegion);
+     const url = ep.modelListURL;
+     const headers = buildCosyHeaders(sess, pathSigFrom(url), "", "application/json");
+     const res = await fetchImpl(url, { headers, signal: timeoutSignal(15000) });
+     if (!res.ok) throw new Error(`models http ${res.status}`);
+     const j = await res.json().catch(() => ({}));
+     // extractModels 恒返回数组（空数组亦 truthy），必须按长度选 chat/assistant 分支
+     const chatModels = extractModels(j.chat);
+     const models = chatModels.length ? chatModels : extractModels(j.assistant);
+     if (!models.length) throw new Error("models list empty");
+     // 只留可用：enable=false 的 key（如 global 的 auto/ultimate，cn 的绝大多数）展示即误导
+     const usable = models.filter((m) => m.enable);
+     if (!usable.length) throw new Error("models list empty (no enabled models)");
+     const list = usable.map((m) => ({
+       id: joinModelId(id, m.id),
+       object: "model",
+       created: CREATED,
+       owned_by: OWNER,
+       name: m.name,
+       context_length: m.contextLength,
+       enable: true,
+       is_reasoning: m.isReasoning,
+       price_factor: m.priceFactor,
+     }));
+     cacheByRegion.set(normRegion, { list, at: now });
+     // 兼容旧单测 _getCache：默认读 global 桶
+     cache = normRegion === "global" ? list : cache;
+     fetchedAt = normRegion === "global" ? now : fetchedAt;
+     return list;
+   }
+ 
+  function clearCache() { cache = null; fetchedAt = 0; cacheByRegion.clear(); }
+  // 快照语义（评审路2 P0：不吃 TTL）：daemon 稳态里 chat 不再回源，能力标记「过期」也比「丢失」强——
+  // is_reasoning 启动预热后持续有效；刷新走 listModels（preheat/CLI/聚合路由），chat 路径恒 0 额外上游调用。
+  function peekModels(region = "global") {
+    return cacheByRegion.get(normalizeRegion(region))?.list ?? null;
+  }
+  return { listModels, peekModels, clearCache, _getCache: () => cache ?? cacheByRegion.get("global")?.list ?? null };
+ }

package/src/providers/qoder/oauth.js

@@ -1,85 +1,85 @@
-// qoder OAuth 设备授权（转译 qoder2api account/oauth.go）：
-// 1. startLogin: PKCE(S256) + nonce → 返回授权链接
-// 2. pollDeviceToken: 轮询 deviceToken/poll，404=未授权继续，200={token:dt-xxx, refresh_token:drt-xxx}
-// 3. fetchUserInfo: GET /api/v1/userinfo（Bearer dt-xxx）→ uid/name/organization_id
-import { randomBytes, createHash } from "node:crypto";
-import { compatFetch, timeoutSignal } from "../../compat.js";
-import { OAUTH_CLIENT_ID, getEndpoints } from "./constants.js";
-
-const POLL_MS = 3000;
-export const POLL_TIMEOUT_MS = 10 * 60 * 1000; // 对齐 qoder2api 10 分钟
-
-export function pkce() {
-  const verifier = randomBytes(32).toString("base64url");
-  const challenge = createHash("sha256").update(verifier).digest("base64url");
-  return { verifier, challenge };
-}
-
-export function hex16() {
-  return randomBytes(16).toString("hex");
-}
-
-export function buildLoginUrl({ region = "global", nonce, challenge } = {}) {
-  const ep = getEndpoints(region);
-  const params = new URLSearchParams({
-    nonce,
-    challenge,
-    challenge_method: "S256",
-    client_id: OAUTH_CLIENT_ID,
-  });
-  return `${ep.deviceLoginBase}?${params.toString()}`;
-}
-
-// 单次轮询：404/空 token → 未授权（返回 null）；200 且有 token → bundle；5xx → 抛错。
-export async function pollDeviceToken({ region = "global", nonce, verifier, fetchImpl = compatFetch } = {}) {
-  const ep = getEndpoints(region);
-  const url = `${ep.pollEndpoint}?nonce=${encodeURIComponent(nonce)}&verifier=${encodeURIComponent(verifier)}&challenge_method=S256`;
-  let res;
-  try {
-    res = await fetchImpl(url, { signal: timeoutSignal(20000) });
-  } catch (e) {
-    throw new Error(`轮询失败: ${e.message}`);
-  }
-  if (res.status === 404) return null; // 还没授权
-  if (res.status >= 500) throw new Error(`deviceToken 端点故障: HTTP ${res.status}`);
-  const txt = await res.text().catch(() => "");
-  let j;
-  try { j = JSON.parse(txt); } catch { throw new Error(`deviceToken 返回非 JSON: ${txt.slice(0, 200)}`); }
-  const deviceToken = String(j.token || "");
-  if (!deviceToken) return null;
-  return { deviceToken, refreshToken: String(j.refresh_token || "") };
-}
-
-// userinfo：ResolveOAuthUserID 优先 id/userId/uid（qoder2api bridge.go）。
-export async function fetchUserInfo({ region = "global", deviceToken, fetchImpl = compatFetch } = {}) {
-  const ep = getEndpoints(region);
-  const res = await fetchImpl(ep.userinfoBase, {
-    headers: { Authorization: `Bearer ${deviceToken}` },
-    signal: timeoutSignal(20000),
-  });
-  const txt = await res.text().catch(() => "");
-  let j;
-  try { j = JSON.parse(txt); } catch { throw new Error(`userinfo 返回非 JSON: HTTP ${res.status} ${txt.slice(0, 200)}`); }
-  if (!res.ok) throw new Error(`userinfo HTTP ${res.status}: ${txt.slice(0, 200)}`);
-  const uid = String(j.id || j.userId || j.uid || "");
-  if (!uid) throw new Error(`userinfo 无 uid: ${txt.slice(0, 200)}`);
-  return {
-    uid,
-    name: String(j.name || ""),
-    email: String(j.email || ""),
-    userType: String(j.userType || j.user_type || "personal_standard"),
-    organizationId: String(j.organization_id || ""),
-    organizationName: String(j.organization_name || ""),
-  };
-}
-
-// 轮询直到授权成功，返回 bundle；超时抛错。deps.log 便于测试注入。
-export async function waitForAuth({ region, nonce, verifier, fetchImpl = compatFetch, log = console.log, deadline = Date.now() + POLL_TIMEOUT_MS } = {}) {
-  for (;;) {
-    if (Date.now() > deadline) throw new Error("授权超时（10 分钟），请重新运行 mslxdff -provider qoder login");
-    const bundle = await pollDeviceToken({ region, nonce, verifier, fetchImpl });
-    if (bundle) return bundle;
-    await new Promise((r) => setTimeout(r, POLL_MS));
-    try { process.stdout.write("."); } catch {}
-  }
+// qoder OAuth 设备授权（转译 qoder2api account/oauth.go）：
+// 1. startLogin: PKCE(S256) + nonce → 返回授权链接
+// 2. pollDeviceToken: 轮询 deviceToken/poll，404=未授权继续，200={token:dt-xxx, refresh_token:drt-xxx}
+// 3. fetchUserInfo: GET /api/v1/userinfo（Bearer dt-xxx）→ uid/name/organization_id
+import { randomBytes, createHash } from "node:crypto";
+import { compatFetch, timeoutSignal } from "../../compat.js";
+import { OAUTH_CLIENT_ID, getEndpoints } from "./constants.js";
+
+const POLL_MS = 3000;
+export const POLL_TIMEOUT_MS = 10 * 60 * 1000; // 对齐 qoder2api 10 分钟
+
+export function pkce() {
+  const verifier = randomBytes(32).toString("base64url");
+  const challenge = createHash("sha256").update(verifier).digest("base64url");
+  return { verifier, challenge };
+}
+
+export function hex16() {
+  return randomBytes(16).toString("hex");
+}
+
+export function buildLoginUrl({ region = "global", nonce, challenge } = {}) {
+  const ep = getEndpoints(region);
+  const params = new URLSearchParams({
+    nonce,
+    challenge,
+    challenge_method: "S256",
+    client_id: OAUTH_CLIENT_ID,
+  });
+  return `${ep.deviceLoginBase}?${params.toString()}`;
+}
+
+// 单次轮询：404/空 token → 未授权（返回 null）；200 且有 token → bundle；5xx → 抛错。
+export async function pollDeviceToken({ region = "global", nonce, verifier, fetchImpl = compatFetch } = {}) {
+  const ep = getEndpoints(region);
+  const url = `${ep.pollEndpoint}?nonce=${encodeURIComponent(nonce)}&verifier=${encodeURIComponent(verifier)}&challenge_method=S256`;
+  let res;
+  try {
+    res = await fetchImpl(url, { signal: timeoutSignal(20000) });
+  } catch (e) {
+    throw new Error(`轮询失败: ${e.message}`);
+  }
+  if (res.status === 404) return null; // 还没授权
+  if (res.status >= 500) throw new Error(`deviceToken 端点故障: HTTP ${res.status}`);
+  const txt = await res.text().catch(() => "");
+  let j;
+  try { j = JSON.parse(txt); } catch { throw new Error(`deviceToken 返回非 JSON: ${txt.slice(0, 200)}`); }
+  const deviceToken = String(j.token || "");
+  if (!deviceToken) return null;
+  return { deviceToken, refreshToken: String(j.refresh_token || "") };
+}
+
+// userinfo：ResolveOAuthUserID 优先 id/userId/uid（qoder2api bridge.go）。
+export async function fetchUserInfo({ region = "global", deviceToken, fetchImpl = compatFetch } = {}) {
+  const ep = getEndpoints(region);
+  const res = await fetchImpl(ep.userinfoBase, {
+    headers: { Authorization: `Bearer ${deviceToken}` },
+    signal: timeoutSignal(20000),
+  });
+  const txt = await res.text().catch(() => "");
+  let j;
+  try { j = JSON.parse(txt); } catch { throw new Error(`userinfo 返回非 JSON: HTTP ${res.status} ${txt.slice(0, 200)}`); }
+  if (!res.ok) throw new Error(`userinfo HTTP ${res.status}: ${txt.slice(0, 200)}`);
+  const uid = String(j.id || j.userId || j.uid || "");
+  if (!uid) throw new Error(`userinfo 无 uid: ${txt.slice(0, 200)}`);
+  return {
+    uid,
+    name: String(j.name || ""),
+    email: String(j.email || ""),
+    userType: String(j.userType || j.user_type || "personal_standard"),
+    organizationId: String(j.organization_id || ""),
+    organizationName: String(j.organization_name || ""),
+  };
+}
+
+// 轮询直到授权成功，返回 bundle；超时抛错。deps.log 便于测试注入。
+export async function waitForAuth({ region, nonce, verifier, fetchImpl = compatFetch, log = console.log, deadline = Date.now() + POLL_TIMEOUT_MS } = {}) {
+  for (;;) {
+    if (Date.now() > deadline) throw new Error("授权超时（10 分钟），请重新运行 mslxdff -provider qoder login");
+    const bundle = await pollDeviceToken({ region, nonce, verifier, fetchImpl });
+    if (bundle) return bundle;
+    await new Promise((r) => setTimeout(r, POLL_MS));
+    try { process.stdout.write("."); } catch {}
+  }
 }

package/src/providers/qoder/payload.js

@@ -1,162 +1,162 @@
-// qoder 消息/payload 组装（转译 qoder2api bridge.go CallQoderWithOpts + messages.go）
-// 模板：baseprompt.json（vendored 数据文件，含 {UUID1..5}/{TIME1} 占位符，加载时替换一次）
-import { readFileSync } from "node:fs";
-import { join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-import { newUUID, unixMs } from "./fingerprint.js";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-// 模板单例：进程内加载一次（替换占位符后 JSON.parse），每请求深拷贝
-let _template = null;
-export function loadTemplate(templatePath) {
-  if (_template && !templatePath) return _template;
-  let tmpl = readFileSync(templatePath || join(__dirname, "baseprompt.json"), "utf8");
-  for (const k of ["{UUID1}", "{UUID2}", "{UUID3}", "{UUID4}", "{UUID5}"]) tmpl = tmpl.split(k).join(newUUID());
-  tmpl = tmpl.split("{TIME1}").join(String(unixMs()));
-  _template = JSON.parse(tmpl);
-  return _template;
-}
-
-export function blankResponseMeta() {
-  return {
-    id: "",
-    usage: {
-      prompt_tokens: 0, completion_tokens: 0, total_tokens: 0,
-      completion_tokens_details: { reasoning_tokens: 0 },
-      prompt_tokens_details: { cached_tokens: 0 },
-    },
-  };
-}
-
-// OpenAI user 消息 → Qoder contents 形状
-export function buildUserMessage(text) {
-  return {
-    role: "user", content: "",
-    contents: [{ type: "text", text: String(text || "") }],
-    response_meta: blankResponseMeta(),
-    reasoning_content_signature: "",
-  };
-}
-
-export function buildStructuredMessage(role, text) {
-  return { role, content: String(text || ""), response_meta: blankResponseMeta(), reasoning_content_signature: "" };
-}
-
-export function normalizeContent(content) {
-  if (typeof content === "string") return content;
-  if (content == null) return "";
-  if (Array.isArray(content)) {
-    let out = "";
-    for (const b of content) {
-      const t = typeof b === "object" && b ? b.text : b;
-      if (typeof t === "string") out += (out ? "\n\n" : "") + t;
-    }
-    return out;
-  }
-  return JSON.stringify(content);
-}
-
-// 提取最后一条 user 消息文本（仿 ExtractLatestUserPrompt）
-export function extractLatestUserPrompt(messages) {
-  for (let i = messages.length - 1; i >= 0; i--) {
-    const m = messages[i];
-    if (m?.role === "user") return normalizeContent(m.content);
-  }
-  return "";
-}
-
-// OpenAI messages → Qoder messages（仿 BuildQoderMessages：无 system 前置模板 system；
-// user 含 tool_result 数组拆成 tool 行；assistant tool_calls 透传）
-export function buildQoderMessages(template, incoming, toolsEnabled) {
-  const rebuilt = [];
-  const hasSystem = (incoming || []).some((m) => m?.role === "system");
-  if (!hasSystem && template) {
-    for (const m of template.messages || []) {
-      if (m?.role === "system") rebuilt.push(JSON.parse(JSON.stringify(m)));
-    }
-  }
-  for (const m of incoming || []) {
-    if (!m || typeof m !== "object") continue;
-    const text = normalizeContent(m.content);
-    if (m.role === "user") {
-      // tool_result 数组形态 → tool 行
-      if (Array.isArray(m.content) && m.content[0]?.type === "tool_result") {
-        for (const b of m.content) {
-          if (b?.type !== "tool_result") continue;
-          rebuilt.push({ role: "tool", tool_call_id: b.tool_use_id || "", content: normalizeContent(b.content) });
-        }
-        continue;
-      }
-      rebuilt.push(buildUserMessage(text));
-    } else if (m.role === "assistant" && toolsEnabled && Array.isArray(m.tool_calls) && m.tool_calls.length) {
-      const out = buildStructuredMessage("assistant", text);
-      out.tool_calls = m.tool_calls;
-      rebuilt.push(out);
-    } else if (m.role === "tool") {
-      const out = buildStructuredMessage("tool", text);
-      if (m.tool_call_id) out.tool_call_id = m.tool_call_id;
-      if (m.name) out.name = m.name;
-      rebuilt.push(out);
-    } else if (text) {
-      rebuilt.push(buildStructuredMessage(m.role === "system" ? "system" : m.role || "user", text));
-    }
-  }
-  return rebuilt;
-}
-
-// 组装上游请求体（仿 CallQoderWithOpts）
-export function buildQoderBody({ template, userType, model, messages, tools, maxTokens, isReasoning }) {
-  const body = JSON.parse(JSON.stringify(template || loadTemplate()));
-  const nid = newUUID();
-  body.request_id = nid;
-  body.chat_record_id = nid;
-  body.request_set_id = newUUID();
-  body.session_id = newUUID();
-  body.stream = true;
-  body.aliyun_user_type = userType || "personal_standard";
-  if (body.model_config) {
-    body.model_config.key = model;
-    if (isReasoning) body.model_config.is_reasoning = true;
-  }
-  // 推理标志两处镜像写（对齐官方 CLI 请求形状），只写 model_config 上游不吐 reasoning_content
-  if (isReasoning && body.chat_context?.extra?.modelConfig) {
-    body.chat_context.extra.modelConfig.is_reasoning = true;
-    body.chat_context.extra.modelConfig.key = model; // 与 model_config.key 同步，不留模板 "auto"（评审路1 P1#5）
-  }
-  if (maxTokens > 0 && body.parameters) body.parameters.max_tokens = maxTokens;
-  const prompt = extractLatestUserPrompt(messages);
-  if (body.business) {
-    body.business.id = newUUID();
-    body.business.begin_at = unixMs();
-    body.business.name = prompt.length > 30 ? prompt.slice(0, 30) : prompt;
-  }
-  if (body.chat_context) {
-    if (body.chat_context.text) body.chat_context.text.text = prompt;
-    if (body.chat_context.extra?.originalContent) body.chat_context.extra.originalContent.text = prompt;
-  }
-  body.messages = messages;
-  // tools 空数组契约：模板内嵌的 14 个 Qoder CLI 工具永不出门；无工具时上游官方亦发 []
-  body.tools = Array.isArray(tools) && tools.length ? tools : [];
-  return { body, prompt, mcSource: body.model_config?.source || "system" };
-}
-
-// 客户端模型名 → 上游 key（仿 defaultModelMapping 双向 substring，家族关键字兜底）
-const DEFAULT_MAPPING = {
-  opus: "qmodel_38max", sonnet: "gmodel", haiku: "qfmodel",
-  gpt: "dmodel", gemini: "gmodel", glm: "gmodel", kimi: "kmodel", deepseek: "dmodel",
-  qwen: "qfmodel", flash: "qfmodel", mini: "efficient", pro: "performance", max: "performance",
-};
-// 上游原生 key 白名单（model/list 实测 15 个）——精确命中直接透传，防被家族关键字抢走
-const UPSTREAM_KEYS = new Set(["auto", "ultimate", "performance", "efficient", "qmodel_38max", "qfmodel", "qmodel_latest", "qmodel", "kmodel_latest", "kmodel", "gmodel", "gfmodel", "dmodel", "dfmodel", "mmodel"]);
-export function mapModel(model) {
-  const m = String(model || "").trim();
-  if (!m || m.toLowerCase() === "auto") return "qfmodel";
-  const low = m.toLowerCase();
-  if (UPSTREAM_KEYS.has(low)) return low;
-  if (DEFAULT_MAPPING[low]) return DEFAULT_MAPPING[low];
-  for (const [k, v] of Object.entries(DEFAULT_MAPPING)) {
-    if (low.includes(k) || k.includes(low)) return v;
-  }
-  return low;
-}
+// qoder 消息/payload 组装（转译 qoder2api bridge.go CallQoderWithOpts + messages.go）
+// 模板：baseprompt.json（vendored 数据文件，含 {UUID1..5}/{TIME1} 占位符，加载时替换一次）
+import { readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { newUUID, unixMs } from "./fingerprint.js";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+// 模板单例：进程内加载一次（替换占位符后 JSON.parse），每请求深拷贝
+let _template = null;
+export function loadTemplate(templatePath) {
+  if (_template && !templatePath) return _template;
+  let tmpl = readFileSync(templatePath || join(__dirname, "baseprompt.json"), "utf8");
+  for (const k of ["{UUID1}", "{UUID2}", "{UUID3}", "{UUID4}", "{UUID5}"]) tmpl = tmpl.split(k).join(newUUID());
+  tmpl = tmpl.split("{TIME1}").join(String(unixMs()));
+  _template = JSON.parse(tmpl);
+  return _template;
+}
+
+export function blankResponseMeta() {
+  return {
+    id: "",
+    usage: {
+      prompt_tokens: 0, completion_tokens: 0, total_tokens: 0,
+      completion_tokens_details: { reasoning_tokens: 0 },
+      prompt_tokens_details: { cached_tokens: 0 },
+    },
+  };
+}
+
+// OpenAI user 消息 → Qoder contents 形状
+export function buildUserMessage(text) {
+  return {
+    role: "user", content: "",
+    contents: [{ type: "text", text: String(text || "") }],
+    response_meta: blankResponseMeta(),
+    reasoning_content_signature: "",
+  };
+}
+
+export function buildStructuredMessage(role, text) {
+  return { role, content: String(text || ""), response_meta: blankResponseMeta(), reasoning_content_signature: "" };
+}
+
+export function normalizeContent(content) {
+  if (typeof content === "string") return content;
+  if (content == null) return "";
+  if (Array.isArray(content)) {
+    let out = "";
+    for (const b of content) {
+      const t = typeof b === "object" && b ? b.text : b;
+      if (typeof t === "string") out += (out ? "\n\n" : "") + t;
+    }
+    return out;
+  }
+  return JSON.stringify(content);
+}
+
+// 提取最后一条 user 消息文本（仿 ExtractLatestUserPrompt）
+export function extractLatestUserPrompt(messages) {
+  for (let i = messages.length - 1; i >= 0; i--) {
+    const m = messages[i];
+    if (m?.role === "user") return normalizeContent(m.content);
+  }
+  return "";
+}
+
+// OpenAI messages → Qoder messages（仿 BuildQoderMessages：无 system 前置模板 system；
+// user 含 tool_result 数组拆成 tool 行；assistant tool_calls 透传）
+export function buildQoderMessages(template, incoming, toolsEnabled) {
+  const rebuilt = [];
+  const hasSystem = (incoming || []).some((m) => m?.role === "system");
+  if (!hasSystem && template) {
+    for (const m of template.messages || []) {
+      if (m?.role === "system") rebuilt.push(JSON.parse(JSON.stringify(m)));
+    }
+  }
+  for (const m of incoming || []) {
+    if (!m || typeof m !== "object") continue;
+    const text = normalizeContent(m.content);
+    if (m.role === "user") {
+      // tool_result 数组形态 → tool 行
+      if (Array.isArray(m.content) && m.content[0]?.type === "tool_result") {
+        for (const b of m.content) {
+          if (b?.type !== "tool_result") continue;
+          rebuilt.push({ role: "tool", tool_call_id: b.tool_use_id || "", content: normalizeContent(b.content) });
+        }
+        continue;
+      }
+      rebuilt.push(buildUserMessage(text));
+    } else if (m.role === "assistant" && toolsEnabled && Array.isArray(m.tool_calls) && m.tool_calls.length) {
+      const out = buildStructuredMessage("assistant", text);
+      out.tool_calls = m.tool_calls;
+      rebuilt.push(out);
+    } else if (m.role === "tool") {
+      const out = buildStructuredMessage("tool", text);
+      if (m.tool_call_id) out.tool_call_id = m.tool_call_id;
+      if (m.name) out.name = m.name;
+      rebuilt.push(out);
+    } else if (text) {
+      rebuilt.push(buildStructuredMessage(m.role === "system" ? "system" : m.role || "user", text));
+    }
+  }
+  return rebuilt;
+}
+
+// 组装上游请求体（仿 CallQoderWithOpts）
+export function buildQoderBody({ template, userType, model, messages, tools, maxTokens, isReasoning }) {
+  const body = JSON.parse(JSON.stringify(template || loadTemplate()));
+  const nid = newUUID();
+  body.request_id = nid;
+  body.chat_record_id = nid;
+  body.request_set_id = newUUID();
+  body.session_id = newUUID();
+  body.stream = true;
+  body.aliyun_user_type = userType || "personal_standard";
+  if (body.model_config) {
+    body.model_config.key = model;
+    if (isReasoning) body.model_config.is_reasoning = true;
+  }
+  // 推理标志两处镜像写（对齐官方 CLI 请求形状），只写 model_config 上游不吐 reasoning_content
+  if (isReasoning && body.chat_context?.extra?.modelConfig) {
+    body.chat_context.extra.modelConfig.is_reasoning = true;
+    body.chat_context.extra.modelConfig.key = model; // 与 model_config.key 同步，不留模板 "auto"（评审路1 P1#5）
+  }
+  if (maxTokens > 0 && body.parameters) body.parameters.max_tokens = maxTokens;
+  const prompt = extractLatestUserPrompt(messages);
+  if (body.business) {
+    body.business.id = newUUID();
+    body.business.begin_at = unixMs();
+    body.business.name = prompt.length > 30 ? prompt.slice(0, 30) : prompt;
+  }
+  if (body.chat_context) {
+    if (body.chat_context.text) body.chat_context.text.text = prompt;
+    if (body.chat_context.extra?.originalContent) body.chat_context.extra.originalContent.text = prompt;
+  }
+  body.messages = messages;
+  // tools 空数组契约：模板内嵌的 14 个 Qoder CLI 工具永不出门；无工具时上游官方亦发 []
+  body.tools = Array.isArray(tools) && tools.length ? tools : [];
+  return { body, prompt, mcSource: body.model_config?.source || "system" };
+}
+
+// 客户端模型名 → 上游 key（仿 defaultModelMapping 双向 substring，家族关键字兜底）
+const DEFAULT_MAPPING = {
+  opus: "qmodel_38max", sonnet: "gmodel", haiku: "qfmodel",
+  gpt: "dmodel", gemini: "gmodel", glm: "gmodel", kimi: "kmodel", deepseek: "dmodel",
+  qwen: "qfmodel", flash: "qfmodel", mini: "efficient", pro: "performance", max: "performance",
+};
+// 上游原生 key 白名单（model/list 实测 15 个）——精确命中直接透传，防被家族关键字抢走
+const UPSTREAM_KEYS = new Set(["auto", "ultimate", "performance", "efficient", "qmodel_38max", "qfmodel", "qmodel_latest", "qmodel", "kmodel_latest", "kmodel", "gmodel", "gfmodel", "dmodel", "dfmodel", "mmodel"]);
+export function mapModel(model) {
+  const m = String(model || "").trim();
+  if (!m || m.toLowerCase() === "auto") return "qfmodel";
+  const low = m.toLowerCase();
+  if (UPSTREAM_KEYS.has(low)) return low;
+  if (DEFAULT_MAPPING[low]) return DEFAULT_MAPPING[low];
+  for (const [k, v] of Object.entries(DEFAULT_MAPPING)) {
+    if (low.includes(k) || k.includes(low)) return v;
+  }
+  return low;
+}