mslxdff 0.1.97 → 0.1.99

package/src/providers/deepseek/health.js

@@ -0,0 +1,104 @@
+// DeepSeek health 探活（防禁言体系）：对池内每个账号发最小真实请求，检测 muted/限频/凭据坏
+// 语义对齐 NIyueeE/ds-free-api health_check（biz_code 非 0 = 异常；FINISHED/INCOMPLETE = 正常）
+import { androidHeaders, solveChallenge, DEEPSEEK_DEFAULT_BASE, DEEPSEEK_API_PREFIX } from "./pow.js";
+import { buildUpstreamBody } from "./bridge.js";
+import { createChatSession } from "./session.js";
+import { compatFetch } from "../../compat.js";
+import { dsDebug } from "./debug.js";
+
+const MUTED_RE = /user is muted|account is muted|\bmuted\b|禁言/i;
+const FREQ_RE = /消息发送过于频繁[\s，,、:：]*请稍后重试/;
+const HEALTH_PROMPT = "只回复Hello, world!";
+
+function tail(token) {
+  return String(token).slice(-6);
+}
+
+function extractBizMsg(text) {
+  try {
+    const j = JSON.parse(text);
+    return j?.data?.biz_msg || j?.msg || "";
+  } catch {
+    return "";
+  }
+}
+
+// 单账号探活：challenge → session → completion（SSE 判定）
+async function probeToken({ token, fetchImpl, dispatcher, baseUrl, connectTimeoutMs, onError }) {
+  try {
+    const pow = await solveChallenge({ token, fetchImpl, dispatcher, baseUrl, connectTimeoutMs });
+    let sessionId = "";
+    try {
+      sessionId = await createChatSession({ token, fetchImpl, dispatcher, baseUrl, connectTimeoutMs });
+    } catch (err) {
+      const msg = String(err?.message || err);
+      if (/401|403|未登录/i.test(msg)) {
+        onError(token, {});
+        return { ok: false, detail: `凭据被拒（创建会话失败: ${msg.slice(0, 80)}）` };
+      }
+      onError(token, {});
+      return { ok: false, detail: `创建会话失败: ${msg.slice(0, 120)}` };
+    }
+    const body = buildUpstreamBody({ sessionId, prompt: HEALTH_PROMPT, thinking: false, search: false, expert: false });
+    const url = `${baseUrl}${DEEPSEEK_API_PREFIX}/chat/completion`;
+    const res = await fetchImpl(url, {
+      method: "POST",
+      headers: androidHeaders(token, { "x-ds-pow-response": pow.header }),
+      body: JSON.stringify(body),
+      ...(dispatcher ? { dispatcher } : {}),
+    });
+    const text = await res.text();
+    dsDebug("health", { event: "probe", tokenTail: tail(token), status: res.status, len: text.length });
+
+    if (!res.ok) {
+      const bizMsg = extractBizMsg(text);
+      onError(token, {});
+      if (MUTED_RE.test(text)) return { ok: false, detail: "禁言（muted）：已冷却 5 分钟，解封后再次探活自动恢复" };
+      if (res.status === 429 || FREQ_RE.test(text)) return { ok: false, detail: `触发频率风控（${bizMsg || `http ${res.status}`}）` };
+      if (res.status === 401 || res.status === 403) return { ok: false, detail: `凭据被拒 (http ${res.status})` };
+      return { ok: false, detail: `HTTP ${res.status}: ${text.slice(0, 100)}` };
+    }
+
+    const contentType = res.headers.get("content-type") || "";
+    if (!contentType.includes("text/event-stream")) {
+      const bizMsg = extractBizMsg(text);
+      try {
+        const bizCode = JSON.parse(text)?.data?.biz_code;
+        if (bizCode != null && bizCode !== 0) {
+          onError(token, {});
+          if (MUTED_RE.test(text)) return { ok: false, detail: "禁言（muted）：已冷却 5 分钟，解封后再次探活自动恢复" };
+          return { ok: false, detail: `异常（biz_code=${bizCode} ${bizMsg}）` };
+        }
+      } catch {}
+      return { ok: false, detail: `非 SSE 响应: ${text.slice(0, 100)}` };
+    }
+
+    if (/"biz_code"\s*:\s*[^0]/.test(text)) {
+      const m = text.match(/"biz_msg"\s*:\s*"([^"]+)"/);
+      onError(token, {});
+      const msg = m?.[1] || "";
+      if (MUTED_RE.test(msg)) return { ok: false, detail: "禁言（muted）：已冷却 5 分钟，解封后再次探活自动恢复" };
+      return { ok: false, detail: `异常（biz_msg=${msg}）` };
+    }
+    if (!/"FINISHED"|"INCOMPLETE"|APPEND/.test(text)) {
+      return { ok: false, detail: "SSE 未正常结束（无 ready/response 事件）" };
+    }
+    return { ok: true, detail: "健康" };
+  } catch (err) {
+    dsDebug("health", { event: "error", tokenTail: tail(token), err: String(err?.message || err) });
+    // 网络异常不冷却（不误伤可用账号）
+    return { ok: false, detail: `网络失败: ${String(err?.message || err).slice(0, 100)}` };
+  }
+}
+
+// 对池内全部账号（绕过冷却——探活本来就是要测禁言状态）逐个探活，返回报告
+export async function deepseekHealth({ authPool, fetchImpl, dispatcher, baseUrl = DEEPSEEK_DEFAULT_BASE, connectTimeoutMs = 30_000 } = {}) {
+  const doFetch = fetchImpl || compatFetch;
+  const report = [];
+  for (const token of authPool.keys || []) {
+    const r = await probeToken({ token, fetchImpl: doFetch, dispatcher, baseUrl: String(baseUrl).replace(/\/+$/, ""), connectTimeoutMs, onError: (t, opts) => authPool.onError(t, opts) });
+    report.push({ tokenTail: tail(token), ...r });
+    dsDebug("health", { event: "result", tokenTail: tail(token), ok: r.ok, detail: r.detail });
+  }
+  return report;
+}

package/src/providers/deepseek/index.js

@@ -0,0 +1,180 @@
+// DeepSeek 供应商工厂：把 chat.deepseek.com 免费 web/移动端对话包装成 OpenAI 兼容模型
+// 模型：deepseek/chat、deepseek/reasoner、deepseek/chat-search、deepseek/reasoner-search
+import { collectApiKeysGeneric, envInt, getUndici } from "../base.js";
+import { loadProviderKeys } from "../../state.js";
+import { createAuthPool } from "./auth.js";
+import { runDeepseekChat } from "./chat.js";
+import { createDeepseekSseParser } from "./bridge.js";
+import { DEEPSEEK_DEFAULT_BASE } from "./pow.js";
+import { dsDebug, dsDump } from "./debug.js";
+
+const { UndiciFetch } = getUndici();
+
+// 对外 id 带 -free 后缀（ADR-0002 免费过滤 + 客户端一眼识别免费）；上游 flags 由 bridge.mapModelToFlags 按 includes 判定，后缀不影响
+// expert = 官网「专家模式」（completion body model_type:"expert"，TQZHR 映射 deepseek-{chat,reasoner}-expert）
+export const DEEPSEEK_MODELS = [
+  { id: "deepseek-chat-free", object: "model", owned_by: "deepseek" },
+  { id: "deepseek-reasoner-free", object: "model", owned_by: "deepseek" },
+  { id: "deepseek-chat-search-free", object: "model", owned_by: "deepseek" },
+  { id: "deepseek-reasoner-search-free", object: "model", owned_by: "deepseek" },
+  { id: "deepseek-chat-expert-free", object: "model", owned_by: "deepseek" },
+  { id: "deepseek-reasoner-expert-free", object: "model", owned_by: "deepseek" },
+];
+
+export function createDeepseekProvider({
+  id = "deepseek",
+  baseUrl,
+  apiKeys,
+  apiKey,
+  connectTimeoutMs = envInt("MSLXDFF_DEEPSEEK_TIMEOUT_MS", 30_000),
+  cooldownMs = envInt("MSLXDFF_DEEPSEEK_COOLDOWN_MS", 30_000),
+  fetchImpl,
+  file,
+} = {}) {
+  const resolvedBase = String(baseUrl || DEEPSEEK_DEFAULT_BASE).trim().replace(/\/+$/, "");
+  if (!fetchImpl) fetchImpl = UndiciFetch;
+
+  const keys = collectApiKeysGeneric(id, apiKeys, apiKey, (pid) => loadProviderKeys(pid, file ? { file } : {}));
+  const authPool = createAuthPool({ tokens: keys, cooldownMs });
+
+  let modelsCache = null;
+  async function listModels() {
+    if (modelsCache) return modelsCache;
+    modelsCache = DEEPSEEK_MODELS.map((m) => ({ ...m, id: `${id}/${m.id}` }));
+    return modelsCache;
+  }
+
+  async function chat(body) {
+    const out = await runDeepseekChat({
+      body,
+      authPool,
+      fetchImpl,
+      baseUrl: resolvedBase,
+      connectTimeoutMs,
+    });
+
+    if (out.kind === "json") {
+      return new Response(JSON.stringify(out.data), { status: 200, headers: { "Content-Type": "application/json" } });
+    }
+
+    // 流式：把上游 DeepSeek SSE 翻译为 OpenAI chat.completion.chunk 流，读完后无痕删会话
+    return new Response(buildOpenAiSseStream({ upstream: out.res, model: body?.model || "deepseek/chat", cleanup: out.cleanup, startKind: startKind(body) }), {
+      status: 200,
+      headers: { "Content-Type": "text/event-stream", "Cache-Control": "no-cache", Connection: "keep-alive" },
+    });
+  }
+
+  async function chatWithKeys(body, keys) {
+    const tmpPool = createAuthPool({ tokens: keys || [], cooldownMs });
+    const out = await runDeepseekChat({ body, authPool: tmpPool, fetchImpl, baseUrl: resolvedBase, connectTimeoutMs });
+    if (out.kind === "json") {
+      return new Response(JSON.stringify(out.data), { status: 200, headers: { "Content-Type": "application/json" } });
+    }
+    return new Response(buildOpenAiSseStream({ upstream: out.res, model: body?.model || "deepseek/chat", cleanup: out.cleanup, startKind: startKind(body) }), {
+      status: 200,
+      headers: { "Content-Type": "text/event-stream", "Cache-Control": "no-cache", Connection: "keep-alive" },
+    });
+  }
+
+  async function close() {}
+
+  return {
+    id,
+    chat,
+    chatWithKeys,
+    listModels,
+    preheat: async () => ({ ok: true }),
+    close,
+    keyRing: { available: () => authPool.available(), size: authPool.size, cooldownMs },
+    _authPool: authPool,
+    baseUrl: resolvedBase,
+  };
+}
+
+function startKind(body) {
+  const id = String(body?.model || "");
+  return id.includes("reasoner") ? "reasoning" : "content";
+}
+
+function buildOpenAiSseStream({ upstream, model, cleanup, startKind: initialKind = "content" }) {
+  const parse = createDeepseekSseParser({ startKind: initialKind });
+  const completionId = `chatcmpl-deepseek-${Date.now()}`;
+  const created = Math.floor(Date.now() / 1000);
+  const encoder = new TextEncoder();
+  let first = true;
+  let finished = false;
+  const stat = { chunks: 0, bytes: 0, content: 0, reasoning: 0, finishEv: 0, t0: Date.now() };
+
+  function frame(delta, finishReason = null) {
+    return `data: ${JSON.stringify({
+      id: completionId,
+      object: "chat.completion.chunk",
+      created,
+      model,
+      choices: [{ index: 0, delta, finish_reason: finishReason }],
+    })}\n\n`;
+  }
+
+  const reader = upstream.body.getReader();
+  const decoder = new TextDecoder();
+
+  return new ReadableStream({
+    async pull(controller) {
+      try {
+        const { done, value } = await reader.read();
+        if (done) {
+          dsDebug("sse-stream", { event: "upstream-done", model, ...stat, elapsedMs: Date.now() - stat.t0, EMPTY_STREAM: stat.chunks === 0 || (stat.content === 0 && stat.reasoning === 0) });
+          if (!finished) {
+            finished = true;
+            controller.enqueue(encoder.encode(frame({}, "stop")));
+            controller.enqueue(encoder.encode("data: [DONE]\n\n"));
+          }
+          if (cleanup) { try { await cleanup(); } catch {} cleanup = null; }
+          controller.close();
+          return;
+        }
+        stat.chunks++;
+        stat.bytes += value?.byteLength || 0;
+        const text = decoder.decode(value, { stream: true });
+        dsDump("sse-stream", `upstream chunk #${stat.chunks} model=${model}`, text, 3000);
+        const events = parse(text);
+        dsDebug("sse-stream", { event: "parsed", chunkNo: stat.chunks, events: events.length, kinds: events.map((e) => (e.finish ? `finish:${e.finish}` : e.reasoning ? "reasoning" : e.content ? "content" : JSON.stringify(e).slice(0, 60))).join("|") });
+        for (const ev of events) {
+          if (first) {
+            first = false;
+            controller.enqueue(encoder.encode(frame({ role: "assistant", content: "" })));
+          }
+          // 上游拒绝（event:hint input_exceeds_limit / rate_limit_reached 等）：透传为 OpenAI error 事件，绝不静默
+          if (ev.error && !finished) {
+            finished = true;
+            controller.enqueue(encoder.encode(`data: ${JSON.stringify({ error: { message: ev.error, type: "upstream_error", ...(ev.finishReason ? { finish_reason: ev.finishReason } : {}) } })}\n\n`));
+            controller.enqueue(encoder.encode("data: [DONE]\n\n"));
+            break;
+          }
+          if (ev.reasoning) { stat.reasoning += ev.reasoning.length; controller.enqueue(encoder.encode(frame({ reasoning_content: ev.reasoning }))); }
+          if (ev.content) { stat.content += ev.content.length; controller.enqueue(encoder.encode(frame({ content: ev.content }))); }
+          if (ev.finish && !finished) {
+            stat.finishEv++;
+            finished = true;
+            controller.enqueue(encoder.encode(frame({}, ev.finish)));
+            controller.enqueue(encoder.encode("data: [DONE]\n\n"));
+          }
+        }
+      } catch (err) {
+        dsDebug("sse-stream", { event: "reader-error", model, ...stat, error: String(err?.message || err) });
+        if (!finished) {
+          finished = true;
+          controller.enqueue(encoder.encode(`data: ${JSON.stringify({ error: { message: String(err?.message || err), type: "upstream_error" } })}\n\n`));
+          controller.enqueue(encoder.encode("data: [DONE]\n\n"));
+        }
+        if (cleanup) { try { await cleanup(); } catch {} cleanup = null; }
+        controller.close();
+      }
+    },
+    async cancel() {
+      dsDebug("sse-stream", { event: "downstream-cancel", model, ...stat });
+      try { await reader.cancel(); } catch {}
+      if (cleanup) { try { await cleanup(); } catch {} cleanup = null; }
+    },
+  });
+}

package/src/providers/deepseek/pow.js

@@ -0,0 +1,99 @@
+// DeepSeek PoW 编排：challenge 获取 + 求解 + x-ds-pow-response header 编码
+// 上游协议参考 iidamie/deepseek2api（GPL-3.0，协议事实）与 TQZHR/deepseek2api（MIT）
+import { deepSeekHashV1, findPowNonce } from "./hash.js";
+import { compatFetch } from "../../compat.js";
+
+export const DEEPSEEK_DEFAULT_BASE = "https://chat.deepseek.com";
+export const DEEPSEEK_API_PREFIX = "/api/v0";
+export const COMPLETION_TARGET_PATH = "/api/v0/chat/completion";
+
+export function androidHeaders(token, extra = {}) {
+  return {
+    "User-Agent": "DeepSeek/1.0.13 Android/35",
+    Accept: "application/json",
+    "Content-Type": "application/json",
+    "x-client-platform": "android",
+    "x-client-version": "2.0.0",
+    "x-client-locale": "zh_CN",
+    "accept-charset": "UTF-8",
+    ...(token ? { Authorization: `Bearer ${token}` } : {}),
+    ...extra,
+  };
+}
+
+function apiError(payload, status) {
+  const bizMsg = payload?.data?.biz_msg || payload?.msg || payload?.error || "";
+  const code = payload?.data?.biz_code ?? payload?.code ?? status;
+  const err = new Error(`DeepSeek PoW 挑战获取失败${bizMsg ? `: ${bizMsg}` : ""}${code ? ` (code=${code})` : ""}`);
+  err.status = status;
+  err.bizCode = code;
+  return err;
+}
+
+// 网络层抖动重试（换新连接）：TUN 断流后 keepAlive 坏 socket 会 fetch failed/aborted，
+// 重试即建新 socket。只重试"拿到响应前"的失败，不重试业务错（4xx/5xx 有响应）。
+const NET_ERR_PATTERN = /fetch failed|aborted|ECONNRESET|ECONNREFUSED|ETIMEDOUT|EAI_AGAIN|ENOTFOUND|UND_ERR|socket hang up|network/i;
+export async function netRetry(fn, { attempts = 2, delayMs = 400 } = {}) {
+  for (let i = 0; ; i++) {
+    try {
+      return await fn();
+    } catch (err) {
+      const msg = `${err?.message || err} ${err?.cause?.code || err?.cause?.message || ""}`;
+      if (i >= attempts || !NET_ERR_PATTERN.test(msg)) throw err;
+      await new Promise((r) => setTimeout(r, delayMs * (i + 1)));
+    }
+  }
+}
+
+export async function fetchPowChallenge({ token, fetchImpl, dispatcher, baseUrl = DEEPSEEK_DEFAULT_BASE, connectTimeoutMs = 30_000 }) {
+  const doFetch = fetchImpl || compatFetch;
+  const url = `${String(baseUrl).replace(/\/+$/, "")}${DEEPSEEK_API_PREFIX}/chat/create_pow_challenge`;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(new Error("DeepSeek PoW challenge timed out")), connectTimeoutMs);
+  let res;
+  try {
+    res = await netRetry(() => doFetch(url, {
+      method: "POST",
+      headers: androidHeaders(token),
+      body: JSON.stringify({ target_path: COMPLETION_TARGET_PATH }),
+      ...(dispatcher ? { dispatcher } : {}),
+      signal: controller.signal,
+    }), { attempts: 2, delayMs: 400 });
+  } catch (err) {
+    throw new Error(`DeepSeek PoW 挑战请求失败: ${String(err?.message || err)}`);
+  } finally {
+    clearTimeout(timer);
+  }
+
+  let payload = null;
+  try { payload = await res.json(); } catch {}
+  if (!res.ok || payload?.data?.biz_code !== 0 || !payload?.data?.biz_data?.challenge) {
+    throw apiError(payload, res.status);
+  }
+  return payload.data.biz_data.challenge;
+}
+
+export function buildPowHeader(challenge, answer) {
+  const payload = {
+    algorithm: challenge.algorithm,
+    challenge: challenge.challenge,
+    salt: challenge.salt,
+    answer,
+    signature: challenge.signature,
+    target_path: challenge.target_path || COMPLETION_TARGET_PATH,
+  };
+  return Buffer.from(JSON.stringify(payload), "utf8").toString("base64");
+}
+
+// 单次全编排：取 challenge → 穷举 nonce → 编 header。
+// 返回 { challenge, answer, header }，供 completion 请求直接使用。
+export async function solveChallenge({ token, fetchImpl, dispatcher, baseUrl, connectTimeoutMs } = {}) {
+  const challenge = await fetchPowChallenge({ token, fetchImpl, dispatcher, baseUrl, connectTimeoutMs });
+  const expireAt = challenge.expire_at ?? challenge.expireAt;
+  const prefix = `${challenge.salt}_${expireAt}_`;
+  const answer = findPowNonce(prefix, challenge.challenge, challenge.difficulty);
+  if (answer < 0) {
+    throw new Error(`DeepSeek PoW 求解失败: difficulty=${challenge.difficulty} 空间内无解（challenge 不匹配）`);
+  }
+  return { challenge, answer, header: buildPowHeader(challenge, answer) };
+}

package/src/providers/deepseek/session.js

@@ -0,0 +1,114 @@
+// DeepSeek 会话：无痕模式（每次 completion 前建、后删）
+import { androidHeaders, netRetry } from "./pow.js";
+import { DEEPSEEK_API_PREFIX } from "./pow.js";
+import { dsDebug, dsDump, dsError } from "./debug.js";
+
+export async function createChatSession({ token, fetchImpl, dispatcher, baseUrl = "https://chat.deepseek.com", connectTimeoutMs = 30_000 } = {}) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(new Error("DeepSeek 会话创建超时")), connectTimeoutMs);
+  let res;
+  try {
+    res = await netRetry(() => fetchImpl(`${String(baseUrl).replace(/\/+$/, "")}${DEEPSEEK_API_PREFIX}/chat_session/create`, {
+      method: "POST",
+      headers: androidHeaders(token),
+      body: JSON.stringify({ agent: "chat" }),
+      ...(dispatcher ? { dispatcher } : {}),
+      signal: controller.signal,
+    }), { attempts: 2, delayMs: 400 });
+  } catch (err) {
+    dsError("session", err);
+    throw new Error(`DeepSeek 会话创建失败: ${String(err?.message || err)}`);
+  } finally {
+    clearTimeout(timer);
+  }
+
+  let data = null;
+  try { data = await res.json(); } catch {}
+  dsDebug("session", { event: "create", status: res.status, bizCode: data?.data?.biz_code });
+  if (data?.data?.biz_code !== 0) dsDump("session", "create body", JSON.stringify(data), 800);
+  // 新版协议（x-client-version 2.0.0）id 在 biz_data.chat_session.id；旧版在 biz_data.id
+  const id = data?.data?.biz_data?.chat_session?.id ?? data?.data?.biz_data?.id;
+  if (!res.ok || data?.data?.biz_code !== 0 || !id) {
+    const msg = data?.data?.biz_msg || data?.msg || "响应缺少会话 id";
+    throw new Error(`DeepSeek 会话创建失败: ${msg}${res.ok ? "" : ` (http ${res.status})`}`);
+  }
+  return id;
+}
+
+export async function deleteChatSession({ token, sessionId, fetchImpl, dispatcher, baseUrl = "https://chat.deepseek.com", connectTimeoutMs = 15_000 } = {}) {
+  // 收尾动作：任何失败都静默（不抛），避免污染主流程
+  try {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(new Error("timeout")), connectTimeoutMs);
+    try {
+      await fetchImpl(`${String(baseUrl).replace(/\/+$/, "")}${DEEPSEEK_API_PREFIX}/chat_session/delete`, {
+        method: "POST",
+        headers: androidHeaders(token),
+        body: JSON.stringify({ chat_session_id: sessionId }),
+        ...(dispatcher ? { dispatcher } : {}),
+        signal: controller.signal,
+      });
+    } finally {
+      clearTimeout(timer);
+    }
+  } catch {}
+}
+
+// 中止生成（官方协议：stop_stream 不需要 PoW header；message_id 取 ready 的 response_message_id）
+// ds-free-api raw-api-reference §6
+export async function stopDeepseekStream({ token, sessionId, messageId, fetchImpl, dispatcher, baseUrl = "https://chat.deepseek.com", connectTimeoutMs = 15_000 } = {}) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(new Error("DeepSeek stop_stream 超时")), connectTimeoutMs);
+  try {
+    const res = await fetchImpl(`${String(baseUrl).replace(/\/+$/, "")}${DEEPSEEK_API_PREFIX}/chat/stop_stream`, {
+      method: "POST",
+      headers: androidHeaders(token),
+      body: JSON.stringify({ chat_session_id: sessionId, message_id: messageId }),
+      ...(dispatcher ? { dispatcher } : {}),
+      signal: controller.signal,
+    });
+    dsDebug("session", { event: "stop_stream", sessionId, messageId, status: res.status });
+    if (!res.ok) dsDump("session", `stop_stream non-ok http=${res.status}`, await res.text().catch(() => ""), 400);
+  } catch (err) {
+    dsError("session", err);
+    throw err;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+// 从 SSE 流读 event:ready 的 response_message_id（跨块缓冲）
+function parseReadyMessageId(buf) {
+  const idx = buf.indexOf("event: ready");
+  if (idx < 0) return null;
+  const m = buf.slice(idx).match(/event: ready\s*\ndata: (\{[^\n]*\})/);
+  if (!m) return null;
+  try {
+    const j = JSON.parse(m[1]);
+    return j?.response_message_id != null ? Number(j.response_message_id) : null;
+  } catch { return null; }
+}
+
+// 分块喂养：等 ready 拿 message_id → 等 update_session（上游把消息落库的信号；真机实测
+// ready 后立刻 stop，下一块 parent_message_id 会报 biz_code:26 invalid message id）
+// → stop_stream 中止生成 → drain 上游到关。update_session 未出现（流已关）也继续，宽松兜底。
+export async function feedChunkToSession({ res, token, sessionId, fetchImpl, dispatcher, baseUrl, connectTimeoutMs = 30_000 } = {}) {
+  const reader = res.body.getReader();
+  const decoder = new TextDecoder();
+  let buf = "";
+  let messageId = null;
+  for (;;) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    buf += decoder.decode(value, { stream: true });
+    if (messageId == null) messageId = parseReadyMessageId(buf);
+    if (messageId != null && buf.includes("event: update_session")) break;
+  }
+  if (messageId == null) throw new Error("DeepSeek 分块喂养失败：ready 事件缺少 response_message_id");
+  await stopDeepseekStream({ token, sessionId, messageId, fetchImpl, dispatcher, baseUrl, connectTimeoutMs });
+  for (;;) {
+    const { done } = await reader.read();
+    if (done) break;
+  }
+  return messageId;
+}

package/src/providers/deepseek/sse-decoder.js

@@ -0,0 +1,160 @@
+// DeepSeek SSE JSON-Patch decoder（对齐 TQZHR/deepseek2api MIT src/utils/deepseek-sse.js 范式）
+// 纯解码层：consume(payloadText) → deltas[{kind,text,snapshot?}]，kind ∈ content|reasoning|finish
+// Android 通道特有补充：startKind（expert 空 THINK fragment 无 type 字段时兜底）+
+// elapsed_secs SET 边界（THINK→RESPONSE 静默切换，新 fragment 首块带路径但无 o）。
+const FRAGMENT_KIND_BY_TYPE = Object.freeze({
+  ANSWER: "content",
+  THINKING: "reasoning",
+  THINK: "reasoning",
+  RESPONSE: "content",
+});
+
+function resolveFragmentKind(type) {
+  return FRAGMENT_KIND_BY_TYPE[String(type || "").toUpperCase()] ?? null;
+}
+
+function normalizePatchPath(basePath, path) {
+  const b = String(basePath || "").replace(/^\/+|\/+$/g, "");
+  const p = String(path || "").replace(/^\/+|\/+$/g, "");
+  if (!p) return b;
+  if (p === "response" || p.startsWith("response/")) return p;
+  return b ? `${b}/${p}` : p;
+}
+
+function isSnapshotOperation(op) {
+  const t = String(op || "").toUpperCase();
+  return t === "SET" || t === "REPLACE";
+}
+
+// TQZHR takeUnseenSuffix：快照是某类全量文本，取相对已累积的未见过后缀
+function unseenSuffix(previous, next) {
+  if (!next) return "";
+  if (!previous) return next;
+  if (next.startsWith(previous)) return next.slice(previous.length);
+  if (previous.endsWith(next)) return "";
+  const max = Math.min(previous.length, next.length);
+  for (let len = max; len > 0; len--) {
+    if (previous.endsWith(next.slice(0, len))) return next.slice(len);
+  }
+  return next;
+}
+
+export function createDeepseekDeltaParser({ startKind = "content" } = {}) {
+  const state = { currentKind: startKind, finished: false };
+  const acc = { content: "", reasoning: "" };
+
+  function push(kind, text, snapshot, deltas) {
+    if (typeof text !== "string" || !text) return;
+    const unseen = snapshot ? unseenSuffix(acc[kind], text) : text;
+    if (!unseen) return;
+    acc[kind] += unseen;
+    deltas.push({ kind, text: unseen });
+  }
+
+  function appendFragmentDeltas(fragments, { snapshot = false } = {}, deltas) {
+    if (!Array.isArray(fragments)) return;
+    const grouped = new Map();
+    for (const frag of fragments) {
+      const kind = resolveFragmentKind(frag?.type);
+      // type 明确才更新 currentKind（空 fragment {} 不改变判定，Android expert 真机形态）
+      if (kind) state.currentKind = kind;
+      const content = typeof frag?.content === "string" && frag.content ? frag.content : "";
+      if (content) grouped.set(state.currentKind, (grouped.get(state.currentKind) ?? "") + content);
+    }
+    for (const [kind, text] of grouped) push(kind, text, snapshot, deltas);
+  }
+
+  function appendResponseSnapshot(response, deltas) {
+    if (Array.isArray(response?.fragments)) {
+      appendFragmentDeltas(response.fragments, { snapshot: true }, deltas);
+      return;
+    }
+    // 旧版字段（web 1.x 通道）
+    push("reasoning", response?.thinking_content, true, deltas);
+    push("content", response?.content, true, deltas);
+  }
+
+  function decodePatch(payload, deltas, basePath = "") {
+    if (!payload || typeof payload !== "object") return;
+    const path = normalizePatchPath(basePath, payload.p ?? "");
+    const value = payload.v;
+
+    // 流结束信号（TQZHR 放在 completion-stream 层，我们在 decoder 内处理）
+    if (value === "FINISHED" && (path === "response/status" || /\/status$/.test(path))) {
+      if (!state.finished) {
+        state.finished = true;
+        deltas.push({ kind: "finish" });
+      }
+      return;
+    }
+
+    const response = value?.response ?? (!path ? payload.response : null);
+    if (response && typeof response === "object") {
+      appendResponseSnapshot(response, deltas);
+      return;
+    }
+
+    if (payload.o === "BATCH" && Array.isArray(value)) {
+      for (const op of value) decodePatch(op, deltas, path);
+      return;
+    }
+
+    if (path === "response" && Array.isArray(value)) {
+      for (const op of value) decodePatch(op, deltas, "response");
+      return;
+    }
+
+    if (path === "response/fragments" && Array.isArray(value)) {
+      appendFragmentDeltas(value, { snapshot: payload.o !== "APPEND" }, deltas);
+      return;
+    }
+
+    if (/^response\/fragments\/-?\d+$/.test(path) && value && typeof value === "object") {
+      appendFragmentDeltas([value], { snapshot: isSnapshotOperation(payload.o) }, deltas);
+      return;
+    }
+
+    if (/^response\/fragments\/-?\d+\/type$/.test(path)) {
+      state.currentKind = resolveFragmentKind(value) ?? state.currentKind;
+      return;
+    }
+
+    if (path === "response/thinking_content" && typeof value === "string") {
+      push("reasoning", value, isSnapshotOperation(payload.o), deltas);
+      return;
+    }
+
+    if (path === "response/content" && typeof value === "string") {
+      push("content", value, isSnapshotOperation(payload.o), deltas);
+      return;
+    }
+
+    if (/^response\/fragments\/-?\d+\/content$/.test(path) && typeof value === "string") {
+      push(state.currentKind, value, isSnapshotOperation(payload.o), deltas);
+      return;
+    }
+
+    // 裸 v：沿用 currentKind（流式优化，无 p）
+    if (!("p" in payload) && typeof value === "string") {
+      push(state.currentKind, value, false, deltas);
+      return;
+    }
+
+    // elapsed_secs SET：Android 通道 THINK→RESPONSE 静默边界（单轮 THINK→RESPONSE 固定交替）
+    if (/^response\/fragments\/-?\d+\/elapsed_secs$/.test(path) && payload.o === "SET") {
+      if (state.currentKind === "reasoning") state.currentKind = "content";
+    }
+    // 其余（accumulated_token_usage / quasi_status / search_status 等）忽略
+  }
+
+  return {
+    consume(payloadText) {
+      const deltas = [];
+      let payload = null;
+      try { payload = JSON.parse(String(payloadText ?? "")); } catch { return deltas; }
+      decodePatch(payload, deltas);
+      return deltas;
+    },
+    _state: state,
+  };
+}

package/src/providers/deepseek.js

@@ -0,0 +1 @@
+export { createDeepseekProvider, DEEPSEEK_MODELS } from "./deepseek/index.js";

package/src/providers/registry.js

@@ -15,6 +15,11 @@ export const customProviders = [
     match: (id, baseUrl) => id === "cline" || id === "clinebot" || String(baseUrl).includes("cline.bot"),
     load: () => import("./cline.js").then((m) => m.createClineProvider),
   },
+  {
+    id: "deepseek",
+    match: (id, baseUrl) => id === "deepseek" || String(baseUrl).includes("chat.deepseek.com"),
+    load: () => import("./deepseek.js").then((m) => m.createDeepseekProvider),
+  },
 ];
 
 // 供 bench/probe 等需要定制化解析模型列表的场景