mslxdff 0.1.96 → 0.1.98

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mslxdff",
-  "version": "0.1.96",
+  "version": "0.1.98",
   "description": "测试项目，请勿使用。",
   "type": "module",
   "bin": {

package/src/chat-pipeline/serial-trial.js

@@ -112,7 +112,7 @@ export async function runSerialTrial(ctx, deps = {}) {
       const isStream = Boolean(body.stream);
       const d = hedgeDelayMs();
       const hasPeers = Boolean(peers) && peers.ordered().length > 0;
-      const doHedge = shouldHedge({ isStream, canForwardPeers, hedgeDelayMs: d, hasPeers }) && upRes.status === 200 && upRes.body;
+      const doHedge = shouldHedge({ isStream, canForwardPeers, hedgeDelayMs: d, hasPeers, model }) && upRes.status === 200 && upRes.body;
       if (doHedge) {
         const hr = await hedge({ upRes, model, body, order, idx, lastErr, requested, useAuto, lockModel, auto, peers, handlerCtx, evt, logCall, logError, mark, perf0, stages, startedAt, plugins, res, hedgeDelayMs: d });
         if (hr.handled) return { done: true };

package/src/cli/commands/model/picks.js

@@ -15,8 +15,11 @@ export async function handlePicksCommand(args, idx, sub) {
     process.exit(0);
   }
   if (sub === "pick" && args[idx + 2] && args[idx + 2] !== "clear") {
-    const picks = [...new Set([...loadModelPicks(), args[idx + 2]])];
+    // 多 id 勾选：`-model pick a b c`（空格分隔）与 `-model pick a,b`（逗号）均支持
+    const ids = args.slice(idx + 2).flatMap((x) => String(x).split(",")).map((x) => x.trim()).filter(Boolean);
+    const picks = [...new Set([...loadModelPicks(), ...ids])];
     saveModelPicks(picks);
+    console.log(`picked ${ids.length} model(s): ${ids.join(", ")}`);
     console.log(`picked: ${picks.join(", ") || "(none)"} (auto will pick within these)`);
     process.exit(0);
   }
@@ -26,8 +29,10 @@ export async function handlePicksCommand(args, idx, sub) {
     process.exit(0);
   }
   if (sub === "unpick" && args[idx + 2]) {
-    const picks = loadModelPicks().filter((x) => x !== args[idx + 2]);
+    const removeSet = new Set(args.slice(idx + 2).flatMap((x) => String(x).split(",")).map((x) => x.trim()).filter(Boolean));
+    const picks = loadModelPicks().filter((x) => !removeSet.has(x));
     saveModelPicks(picks);
+    console.log(`unpicked ${removeSet.size}: ${[...removeSet].join(", ")}`);
     console.log(`picked: ${picks.join(", ") || "(none)"}${picks.length === 0 ? " (auto uses full list)" : ""}`);
     process.exit(0);
   }

package/src/cli/commands/provider/bench-via.js

@@ -54,6 +54,13 @@ export function filterBenchModels({ providerId, allowed, picks, allowAny = false
 }
 
 export async function handleVia({ providerId, opts, fetchImpl, loadConfigs, loadKeys, loadAllowed, loadBaseUrl, loadAllowAny, loadModelPicks, getOnlinePeersFn }) {
+  // DeepSeek 防禁言：via 也不测（显式传入直接返回；all 形态在 targetIds 收集处排除）
+  if (String(providerId || "").trim().toLowerCase() === "deepseek") {
+    const msg = "跳过 deepseek bench-via —— 网页通道易触发禁言/频率风控，体检用 mslxdff -provider deepseek health";
+    if (opts.json) console.log(JSON.stringify({ meta: { at: new Date().toISOString(), samples: opts.samples, timeout: opts.timeoutMs, includeOpencode: false, peers: [], opencodeSkipped: true, deepseekSkipped: true }, results: [], advice: msg }, null, 2));
+    else console.log(msg);
+    return;
+  }
   const { getOnlinePeers, orchestrateVia, resolveIncludeOpencode } = await import("../../../bench/via.js");
   const peers = await (typeof getOnlinePeersFn === "function" ? getOnlinePeersFn() : getOnlinePeers());
   if (!peers.length) {
@@ -99,6 +106,8 @@ export async function handleVia({ providerId, opts, fetchImpl, loadConfigs, load
     const ids = new Set(Object.keys(configs));
     ids.add("opencode"); ids.add("openrouter");
     for (const pid of [...ids]) {
+      // DeepSeek 网页通道防禁言：all 形态直接排除，即使 allowlist 非空也不进候选
+      if (String(pid).toLowerCase() === "deepseek") continue;
       const allowed = loadAllowed(pid) || [];
       if (allowed.length) targetIds.push(pid);
     }

package/src/cli/commands/provider/bench.js

@@ -36,6 +36,14 @@ export async function handleProviderBench(id, sub, rest, args, deps = {}) {
   const isBench = sub === "bench" || sub === "benchmark" || sub === "eval" || sub === "test" || _isBenchViaAll;
   if (!isBench) return false;
   const opts = parseBenchArgs(_restArr);
+  // DeepSeek 网页通道防禁言：bench 轰炸易触发 muted/频率风控，一律跳过（体检用 health 探活代替）
+  const benchPidLower = String(id || "").trim().toLowerCase();
+  if (benchPidLower === "deepseek" || benchPidLower === "ds") {
+    const advice = "DeepSeek 网页通道（本机私有凭据）易触发禁言/频率风控，不支持 bench 测速。请用轻量体检：mslxdff -provider deepseek health";
+    if (opts.json) console.log(JSON.stringify({ ok: false, skipped: "deepseek", advice }, null, 2));
+    else console.log(`跳过 deepseek bench —— ${advice}`);
+    return true;
+  }
   if (opts.via) {
     const stateMod = await import("../../../state.js");
     const loadConfigs = deps.loadProviderConfigs || stateMod.loadProviderConfigs;

package/src/cli/commands/provider/deepseek-health.js

@@ -0,0 +1,46 @@
+// -provider deepseek health：逐账号探活（防禁言体系）
+// 用法：mslxdff -provider deepseek health [--json]
+// 对池内每个账号发最小真实请求（Hello world + PoW），检测 muted/限频/凭据坏；
+// 禁言账号自动冷却 5min（解封后再次探活即自动恢复）。不经过组员、直连本机凭据。
+export async function handleDeepseekHealth(id, sub, rest) {
+  if (id !== "deepseek" && id !== "ds") return false;
+  if (sub !== "health" && sub !== "check") return false;
+
+  const args = rest || [];
+  const jsonOut = args.some((a) => a === "--json" || a === "-json");
+
+  const { loadProviderKeys } = await import("../../../state.js");
+  const keys = loadProviderKeys("deepseek") || [];
+  if (!keys.length) {
+    console.error("❌ 没有 DeepSeek 凭据，先登录：");
+    console.error("  mslxdff -provider deepseek login --token <userToken>");
+    process.exit(1);
+  }
+
+  const { createAuthPool } = await import("../../../providers/deepseek/auth.js");
+  const { deepseekHealth } = await import("../../../providers/deepseek/health.js");
+  const authPool = createAuthPool({ tokens: keys });
+
+  if (!jsonOut) {
+    console.log(`🔍 DeepSeek 探活中（${keys.length} 个账号，逐个发最小请求）...`);
+  }
+  const report = await deepseekHealth({ authPool });
+
+  if (jsonOut) {
+    console.log(JSON.stringify(report, null, 2));
+  } else {
+    for (const r of report) {
+      console.log(`  ${r.ok ? "✓" : "✗"} ...${r.tokenTail}  ${r.detail}`);
+    }
+    const okCount = report.filter((r) => r.ok).length;
+    console.log(`\n结果：${okCount}/${report.length} 健康`);
+    if (okCount === 0) {
+      console.log("全部账号异常 —— 修复建议：");
+      console.log("  1. chat.deepseek.com 登录后 F12 → Application → Local Storage → 复制 userToken");
+      console.log("  2. mslxdff -provider deepseek login --token <userToken>  追加账号");
+      console.log("  3. 禁言账号等待解除后再次探活即自动恢复");
+    }
+  }
+  if (report.length && report.every((r) => !r.ok)) process.exitCode = 1;
+  return true;
+}

package/src/cli/commands/provider/deepseek-login.js

@@ -0,0 +1,89 @@
+// -provider deepseek login：把 chat.deepseek.com 凭据落盘 providerConfigs.deepseek.keys
+// 三种用法：
+//   login --token <userToken>     浏览器贴 token（F12 → Application → Local Storage → userToken）
+//   login <email|mobile> <password>  账密登录换 token（Android 协议）
+//   login                          打印用法引导
+export async function handleDeepseekLogin(id, sub, rest) {
+  if (id !== "deepseek" && id !== "ds") return false;
+  if (sub !== "login" && sub !== "auth") return false;
+
+  const args = rest || [];
+  const tokenFlagIdx = args.findIndex((a) => a === "--token" || a === "-token" || a === "token");
+
+  if (tokenFlagIdx < 0 && args.filter((a) => !String(a).startsWith("-")).length < 2) {
+    printUsage();
+    process.exit(0);
+  }
+
+  const { loadProviderKeys, saveProviderConfig, loadProviderConfig } = await import("../../../state.js");
+
+  let token = null;
+  let label = "";
+
+  if (tokenFlagIdx >= 0) {
+    token = String(args[tokenFlagIdx + 1] || "").trim();
+    if (!token) {
+      console.error("❌ --token 后面要贴 userToken 值");
+      printUsage();
+      process.exit(1);
+    }
+    label = "userToken（浏览器）";
+  } else {
+    const [loginValue, password] = args.filter((a) => !String(a).startsWith("-"));
+    console.log("🚀 DeepSeek 账密登录中（Android 协议）...");
+    try {
+      const { loginDeepseek } = await import("../../../providers/deepseek/auth.js");
+      const out = await loginDeepseek({ loginValue, password });
+      token = out.token;
+      label = `账密（${String(loginValue).slice(0, 3)}***）`;
+      console.log(`✅ 登录成功，拿到 token`);
+    } catch (e) {
+      console.error(`❌ ${e.message}`);
+      console.error(`\n换浏览器贴 token 方式：chat.deepseek.com 登录后 F12 → Application → Local Storage → 复制 userToken →`);
+      console.error(`  mslxdff -provider deepseek login --token <userToken>`);
+      process.exit(1);
+    }
+  }
+
+  if (!token) {
+    console.error("❌ 未拿到 token");
+    process.exit(1);
+  }
+
+  const cur = loadProviderKeys("deepseek");
+  if (cur.includes(token)) {
+    console.log(`ℹ️ 该 token 已存在（现 ${cur.length} 个账号），跳过`);
+  } else {
+    const cfg = loadProviderConfig("deepseek") || {};
+    const nextKeys = [...new Set([...(cfg.keys || cur), token].filter(Boolean))];
+    saveProviderConfig("deepseek", { ...cfg, keys: nextKeys });
+    console.log(`✅ 已写入 deepseek（现 ${nextKeys.length} 个账号）· 来源: ${label}`);
+  }
+
+  console.log("=".repeat(60));
+  console.log("\n下一步：");
+  console.log("  mslxdff -provider deepseek allowAny on   放行模型（默认 allowlist 空=全 blocked）");
+  console.log("  mslxdff -provider deepseek models        查看支持的模型");
+  console.log("  mslxdff -restart                         重启网关生效");
+  console.log("\n用法：model 字段填 deepseek/deepseek-chat 或 deepseek/deepseek-reasoner");
+  console.log("      （-search 后缀开启联网搜索：deepseek/deepseek-chat-search）");
+  console.log("\n多账号：重复 login 追加，自动轮换 + 401/429/风控切号");
+  console.log("注意：单账号同时仅 1 路输出；触发验证码时换号或稍后再试");
+  process.exit(0);
+}
+
+function printUsage() {
+  console.log("DeepSeek 登录（两种方式任选）：");
+  console.log("");
+  console.log("  方式 1（推荐，免密码）：浏览器贴 token");
+  console.log("    1. 浏览器登录 https://chat.deepseek.com");
+  console.log("    2. F12 → Application → Local Storage → https://chat.deepseek.com");
+  console.log("    3. 找到 userToken，复制值");
+  console.log("    4. mslxdff -provider deepseek login --token <userToken>");
+  console.log("");
+  console.log("  方式 2：账号密码（邮箱或手机号）");
+  console.log("    mslxdff -provider deepseek login you@example.com yourpassword");
+  console.log("    mslxdff -provider deepseek login 13800138000 yourpassword");
+  console.log("");
+  console.log("  登录后：mslxdff -provider deepseek allowAny on && mslxdff -restart");
+}

package/src/cli/commands/provider/index.js

@@ -65,6 +65,10 @@ export async function handleProvider(args) {
   }
   const { handleClineLogin } = await import("./cline-login.js");
   if (await handleClineLogin(id, sub)) return true;
+  const { handleDeepseekLogin } = await import("./deepseek-login.js");
+  if (await handleDeepseekLogin(id, sub, rest)) return true;
+  const { handleDeepseekHealth } = await import("./deepseek-health.js");
+  if (await handleDeepseekHealth(id, sub, rest)) return true;
   const { handleWorkbuddyLogin } = await import("./workbuddy-login.js");
   if (await handleWorkbuddyLogin(id, sub, rest)) return true;
   const { handleProviderConfig } = await import("./config.js");

package/src/cli/commands/provider/models.js

@@ -28,12 +28,15 @@ export async function handleProviderModels(id, sub, args, rest) {
   try {
     const { createGenericProvider } = await import("../../../providers/generic.js");
     const { createWorkbuddyProvider } = await import("../../../providers/workbuddy.js");
+    const { createDeepseekProvider } = await import("../../../providers/deepseek.js");
     const baseUrl = cfg?.baseUrl || (id === "workbuddy" ? "https://copilot.tencent.com" : "");
     const keys = loadProviderKeys(id);
     const auths = cfg?.auths || [];
     let provider;
     if (id === "workbuddy") {
       provider = createWorkbuddyProvider({ baseUrl, apiKeys: keys, auths, file: defaultStateFile() });
+    } else if (id === "deepseek") {
+      provider = createDeepseekProvider({ apiKeys: keys, file: defaultStateFile() });
     } else {
       if (!baseUrl) {
         console.error(`provider ${id}: missing baseUrl — set via: mslxdff -provider ${id} set-url <baseUrl>`);

package/src/groups.js

@@ -1,4 +1,5 @@
 import { timingSafeEqual, createHash } from "node:crypto";
+import { compatFetch } from "./compat.js";
 import { loadGroups, saveGroups, loadBans, saveBans } from "./state.js";
 import { normalizePeerUrl } from "./peers.js";
 
@@ -159,7 +160,7 @@ export function createGroupsService({ file } = {}) {
 
 // Re-register with the leader (join is idempotent) and return the fresh member list.
 // No key is needed once registered: the leader verifies our bearer token.
-export async function refreshGroupMembers(name, { leaderUrl, memberName, url, token, kind, fetchImpl = fetch } = {}) {
+export async function refreshGroupMembers(name, { leaderUrl, memberName, url, token, kind, fetchImpl = compatFetch } = {}) {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), SYNC_TIMEOUT_MS);
   try {

package/src/providers/cline/index.js

@@ -1,6 +1,7 @@
 import { createKeyRing } from "../keyring.js";
 import { loadProviderKeys, loadProviderBaseUrl, loadProviderModelsPath, loadProviderChatPath, saveProviderConfig } from "../../state.js";
 import { envInt, joinUrl, getUndici, createAgent, collectApiKeysGeneric, createChatRunner } from "../base.js";
+import { compatFetch } from "../../compat.js";
 import { joinModelId } from "../model-id.js";
 import { createAuthPool } from "./auth.js";
 import { clineHeaders, isRefreshToken } from "./headers.js";
@@ -34,7 +35,7 @@ export function createClineProvider({
   const resolvedModelsPath = modelsPath || (_cfgModels && _cfgModels !== "/models" ? _cfgModels : null) || "/ai/cline/recommended-models";
   const defaultChat = String(resolvedBase).includes("/api/v1") ? "/chat/completions" : "/api/v1/chat/completions";
   const resolvedChatPath = chatPath || loadProviderChatPath(id, file ? { file } : {}) || defaultChat;
-  if (!fetchImpl) fetchImpl = UndiciFetch || fetch;
+  if (!fetchImpl) fetchImpl = UndiciFetch || compatFetch;
 
   const rawKeys = collectApiKeysGeneric(id, apiKeys, apiKey, (pid) => loadProviderKeys(pid, file ? { file } : {}));
   // 同时兼容 cline 与 clinebot 两个 id 的 keys（用户可能配在任一）

package/src/providers/cline/models.js

@@ -1,4 +1,5 @@
 import { joinUrl, getUndici } from "../base.js";
+import { compatFetch } from "../../compat.js";
 import { joinModelId } from "../model-id.js";
 
 const { UndiciFetch } = getUndici();
@@ -8,7 +9,7 @@ function isClineBotHost(baseUrl) {
 }
 
 export function createModelsService({ id, baseUrl, modelsPath, fetchImpl, dispatcher, ring, loadKeys } = {}) {
-  if (!fetchImpl) fetchImpl = UndiciFetch || fetch;
+  if (!fetchImpl) fetchImpl = UndiciFetch || compatFetch;
   const resolvedBase = String(baseUrl).trim().replace(/\/+$/, "");
   const resolvedPath = modelsPath || "/ai/cline/recommended-models";
   const CACHE_TTL = 10 * 60 * 1000;

package/src/providers/deepseek/auth.js

@@ -0,0 +1,111 @@
+// DeepSeek 账号池 + 登录（Android 协议）
+// 上游协议参考 iidamie/deepseek2api（GPL-3.0，协议事实）
+import { compatFetch } from "../../compat.js";
+import { androidHeaders } from "./pow.js";
+import { DEEPSEEK_DEFAULT_BASE, DEEPSEEK_API_PREFIX } from "./pow.js";
+import { dsDebug } from "./debug.js";
+
+export { androidHeaders };
+
+const DEFAULT_COOLDOWN_MS = 30_000;
+// 差异化冷却（防禁言体系）：频率前兆 60s（TQZHR 重试间隔同量级）、禁言 5min；防同号轰炸拖成禁言
+export const COOLDOWN_PRESETS = Object.freeze({ default: DEFAULT_COOLDOWN_MS, frequency: 60_000, muted: 300_000 });
+
+function isEmail(v) {
+  return String(v || "").includes("@");
+}
+
+export async function loginDeepseek({ loginValue, password, areaCode = "+86", fetchImpl, dispatcher, baseUrl = DEEPSEEK_DEFAULT_BASE, connectTimeoutMs = 30_000 } = {}) {
+  const doFetch = fetchImpl || compatFetch;
+  const email = isEmail(loginValue);
+  const payload = {
+    email: email ? String(loginValue).trim() : "",
+    mobile: email ? "" : String(loginValue).trim(),
+    area_code: email ? "" : areaCode,
+    password: String(password ?? ""),
+    device_id: "mslxdff",
+    os: "android",
+  };
+  const url = `${String(baseUrl).replace(/\/+$/, "")}${DEEPSEEK_API_PREFIX}/users/login`;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(new Error("DeepSeek 登录超时")), connectTimeoutMs);
+  let res;
+  try {
+    res = await doFetch(url, {
+      method: "POST",
+      headers: androidHeaders(null),
+      body: JSON.stringify(payload),
+      ...(dispatcher ? { dispatcher } : {}),
+      signal: controller.signal,
+    });
+  } catch (err) {
+    throw new Error(`DeepSeek 登录失败: ${String(err?.message || err)}`);
+  } finally {
+    clearTimeout(timer);
+  }
+
+  let data = null;
+  try { data = await res.json(); } catch {}
+  const biz = data?.data;
+  const bizCode = biz?.biz_code ?? data?.code;
+  if (!res.ok || bizCode !== 0 || !biz?.biz_data?.user?.token) {
+    const msg = biz?.biz_msg || data?.msg || (biz?.biz_data?.user ? "响应缺少 token" : "登录响应格式错误");
+    throw new Error(`DeepSeek 登录失败: ${msg}${res.ok ? "" : ` (http ${res.status})`}`);
+  }
+  return { token: biz.biz_data.user.token, userId: biz.biz_data.user.id };
+}
+
+// 多账号轮换池：空闲最久优先 + 冷却 + onError；轮换语义对齐 NIyueeE/ds-free-api（选空闲最久者，最大化每次使用间隔）
+export function createAuthPool({ tokens = [], cooldownMs = DEFAULT_COOLDOWN_MS, clock = Date.now } = {}) {
+  const list = [...new Set((tokens || []).map((t) => String(t).trim()).filter(Boolean))];
+  const until = new Map(); // token → 冷却到期时刻
+  const lastUsedAt = new Map(); // token → 最近一次被取用时刻（空闲最久排序依据）
+
+  function isCooling(token) {
+    const u = until.get(token);
+    return u != null && clock() < u;
+  }
+
+  // 空闲最久优先：平局按 list 顺序（与 round-robin 常规场景兼容，间隔拉开时倾向复用久未用号）
+  function next() {
+    if (!list.length) return null;
+    let best = null;
+    let bestIdle = -1;
+    for (const token of list) {
+      if (isCooling(token)) continue;
+      const idle = clock() - (lastUsedAt.get(token) || 0);
+      if (idle > bestIdle) {
+        bestIdle = idle;
+        best = token;
+      }
+    }
+    if (best) lastUsedAt.set(best, clock());
+    return best;
+  }
+
+  // cooldownMsOverride 可覆盖池默认（frequency/muted 走差异化冷却）
+  function onError(token, { cooldownMs: cooldownMsOverride } = {}) {
+    if (!list.includes(token)) return;
+    const ms = Number(cooldownMsOverride) > 0 ? Number(cooldownMsOverride) : cooldownMs;
+    until.set(token, clock() + ms);
+    dsDebug("auth", { event: "rotate", tokenTail: String(token).slice(-6), cooldownMs: ms, cooling: list.length - available(), total: list.length });
+  }
+
+  function available() {
+    return list.filter((t) => !isCooling(t)).length;
+  }
+
+  function requireToken() {
+    const token = next();
+    if (!token) {
+      const err = new Error(list.length
+        ? `DeepSeek: 所有账号都在冷却中（${list.length} 个），稍后再试或 -provider deepseek login 追加`
+        : "缺少 DeepSeek 凭据，请先 -provider deepseek login 或设置 providerConfigs.deepseek.keys");
+      err._deepseekNoAuth = true;
+      throw err;
+    }
+    return token;
+  }
+
+  return { next, onError, available, requireToken, size: list.length, cooldownMs, keys: [...list] };
+}

package/src/providers/deepseek/bridge.js

@@ -0,0 +1,158 @@
+// DeepSeek bridge：OpenAI messages ↔ DeepSeek web 协议互转
+// prompt 构造参考 iidamie/deepseek2api messages_prepare（协议事实）
+// SSE 事件层（event/data 分块 + 流尾 flush）+ 调 sse-decoder.js 纯解码
+import { createDeepseekDeltaParser } from "./sse-decoder.js";
+
+const USER_TAG = "<｜User｜>";
+const ASSISTANT_OPEN = "<｜Assistant｜>";
+const ASSISTANT_CLOSE = "<｜end▁of▁sentence｜>";
+
+export function buildPrompt(messages) {
+  const list = (messages || []).map((m) => {
+    let text = "";
+    if (Array.isArray(m?.content)) {
+      text = m.content
+        .filter((p) => p?.type === "text" && typeof p.text === "string")
+        .map((p) => p.text)
+        .join("\n");
+    } else if (m?.content != null) {
+      text = String(m.content);
+    }
+    return { role: String(m?.role || ""), text };
+  });
+  if (!list.length) return "";
+
+  const merged = [list[0]];
+  for (const msg of list.slice(1)) {
+    if (msg.role && msg.role === merged[merged.length - 1].role) {
+      merged[merged.length - 1].text += `\n\n${msg.text}`;
+    } else {
+      merged.push(msg);
+    }
+  }
+
+  const parts = [];
+  for (let idx = 0; idx < merged.length; idx++) {
+    const { role, text } = merged[idx];
+    if (role === "assistant") {
+      parts.push(`${ASSISTANT_OPEN}${text}${ASSISTANT_CLOSE}`);
+    } else if (role === "user" || role === "system") {
+      parts.push(idx > 0 ? `${USER_TAG}${text}` : text);
+    } else {
+      parts.push(text);
+    }
+  }
+  return parts.join("");
+}
+
+// 输入字符上限（ds-free-api 实测标定：default/vision≈1M tokens；expert≈64K tokens 与官方 API 一致）
+// 超限时上游 HTTP 200 + event:hint(input_exceeds_limit) + 立即 close；阈值取上限 75% 留余量
+const INPUT_CHAR_LIMITS = { expert: 163_840, default: 2_621_440, vision: 2_621_440 };
+
+export function promptThresholdFor(flags = {}) {
+  const limit = flags?.expert ? INPUT_CHAR_LIMITS.expert : INPUT_CHAR_LIMITS.default;
+  return Math.floor(limit * 0.75);
+}
+
+// 硬切（对齐 ds-free-api split_prompt_chunks：不感知标签边界，按字符数）
+export function splitPromptChunks(prompt, chunkSize) {
+  const s = String(prompt ?? "");
+  if (!chunkSize || chunkSize <= 0) return s ? [s] : [];
+  const chunks = [];
+  for (let i = 0; i < s.length; i += chunkSize) chunks.push(s.slice(i, i + chunkSize));
+  return chunks;
+}
+
+export function mapModelToFlags(modelId) {
+  const id = String(modelId || "");
+  // 官网「专家模式」：completion body 显式 model_type:"expert"（真机抓包，model_type 取值 default/chat/reasoner/vision/expert）
+  return {
+    thinking: id.includes("reasoner"),
+    search: id.includes("search"),
+    expert: id.includes("expert"),
+  };
+}
+
+export function buildUpstreamBody({ sessionId, prompt, thinking, search, expert, parentMessageId = null }) {
+  const body = {
+    chat_session_id: sessionId,
+    parent_message_id: parentMessageId ?? null,
+    prompt: String(prompt ?? ""),
+    ref_file_ids: [],
+    thinking_enabled: !!thinking,
+    search_enabled: !!search,
+  };
+  // 非 expert 不传 model_type（v2.0.0 实测缺省走 session 的 default；expert 模式显式声明）
+  if (expert) body.model_type = "expert";
+  return body;
+}
+
+// SSE 事件层：喂入文本（可跨块断行），产出标准 delta 事件数组。
+// 上游形态（Android x-client-version 2.0.0 真机抓包）：
+//   event: ready / update_session / title / close
+//   data: {"v":{"response":{fragments:[{type,content}]}}}   → 快照（decoder 做 unseen 后缀去重）
+//   data: {"p":"response/fragments/-1/content","o":"APPEND","v":"字"} → 定向增量
+//   data: {"v":"字"}                                        → 裸值：沿用 currentKind
+//   data: {"p":"response/status","o":"SET","v":"FINISHED"}  → 结束
+// startKind：thinking 请求首个 THINK fragment 可能以空对象 {} 下发（无 type），靠请求方兜底
+export function createDeepseekSseParser({ startKind = "content" } = {}) {
+  let buffer = "";
+  let closeSeen = false;
+  const decoder = createDeepseekDeltaParser({ startKind });
+
+  function processEventBlock(rawEvent, out) {
+    let eventName = "";
+    const dataLines = [];
+    for (const line of rawEvent.split("\n")) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      if (trimmed.startsWith("event:")) { eventName = trimmed.slice(6).trim(); continue; }
+      if (trimmed.startsWith("data:")) dataLines.push(trimmed.slice(5).trim());
+    }
+    if (eventName === "close" && !closeSeen && !decoder._state.finished) {
+      closeSeen = true;
+      out.push({ finish: "stop" });
+      return;
+    }
+    // 上游拒绝信号（真机抓包）：event: hint + {"type":"error","content":"内容超长，请删减后再试","finish_reason":"input_exceeds_limit"}
+    // 后跟 event: close，HTTP 仍是 200 —— 不透传就是"成功但空回复"
+    if (eventName === "hint") {
+      for (const dataStr of dataLines) {
+        let d = null;
+        try { d = JSON.parse(dataStr); } catch {}
+        if (d?.type === "error") {
+          out.push({ error: String(d.content || "上游拒绝"), finishReason: d.finish_reason || null, clearResponse: d.clear_response === true });
+          return;
+        }
+      }
+      return;
+    }
+    for (const dataStr of dataLines) {
+      if (!dataStr || dataStr === "[DONE]") continue;
+      for (const delta of decoder.consume(dataStr)) {
+        if (delta.kind === "finish") out.push({ finish: "stop" });
+        else if (delta.kind === "reasoning") out.push({ reasoning: delta.text });
+        else out.push({ content: delta.text });
+      }
+    }
+  }
+
+  return function parse(chunk) {
+    buffer += String(chunk ?? "");
+    const out = [];
+    let idx;
+    while ((idx = buffer.indexOf("\n\n")) >= 0) {
+      const rawEvent = buffer.slice(0, idx);
+      buffer = buffer.slice(idx + 2);
+      processEventBlock(rawEvent, out);
+    }
+    // 流尾 flush：仅当剩余 buffer 以换行结尾（data 行已完整终止）才处理，
+    // 半截 JSON 保持缓冲等待下一块；否则 FINISHED/close 等尾部事件会永久卡在 buffer
+    if (buffer.endsWith("\n") && buffer.trim()) {
+      const rest = buffer;
+      buffer = "";
+      processEventBlock(rest, out);
+    }
+    return out;
+  };
+}