@henjicc/ai-sdk 0.9.0 → 0.10.0

package/dist/llm/chat.js

@@ -59,15 +59,27 @@ export async function runLlmChatStream(request, taskId, emit, runtime, hooks = {
             requestPayload: cloneJsonObject(requestPayload),
             processedRequest,
         });
+        // 首字时间从真正发出请求算起，不含前面的媒体预处理
+        const requestSentAtMs = Date.now();
+        let firstTokenAtMs = null;
         const output = await streamOpenAiCompatibleChat({
             endpoint,
             apiKey,
             providerId: identity.providerFamilyId,
             payload: requestPayload,
             signal: controller.signal,
-            emit,
+            emit: (event) => {
+                if (firstTokenAtMs === null && (event.type === 'Token' || event.type === 'ReasoningToken') && event.data)
+                    firstTokenAtMs = Date.now();
+                emit(event);
+            },
             transport: runtime.transport,
         });
+        const finishedAtMs = Date.now();
+        const firstTokenMs = firstTokenAtMs === null ? null : firstTokenAtMs - requestSentAtMs;
+        const streamingSeconds = firstTokenAtMs === null ? 0 : (finishedAtMs - firstTokenAtMs) / 1000;
+        const outputTokens = output.usage?.outputTokens ?? null;
+        const outputTokensPerSecond = outputTokens !== null && streamingSeconds > 0 ? outputTokens / streamingSeconds : null;
         if (isCancelled('llm', taskId)) {
             throw new Error(`[task_cancelled] LLM task cancelled: ${taskId}`);
         }
@@ -82,6 +94,8 @@ export async function runLlmChatStream(request, taskId, emit, runtime, hooks = {
             output: output.output,
             reasoningOutput: output.reasoningOutput,
             usage: output.usage,
+            firstTokenMs,
+            outputTokensPerSecond,
             finishReason: output.finishReason,
             truncated: output.truncated,
             toolCalls: output.toolCalls,
@@ -97,6 +111,8 @@ export async function runLlmChatStream(request, taskId, emit, runtime, hooks = {
             output: output.output,
             reasoningOutput: output.reasoningOutput,
             usage: output.usage,
+            firstTokenMs,
+            outputTokensPerSecond,
             finishReason: output.finishReason,
             truncated: output.truncated,
             toolCalls: output.toolCalls,
@@ -130,7 +146,7 @@ export async function runLlmChatStream(request, taskId, emit, runtime, hooks = {
 async function preprocessLlmRequest(request, runtime) {
     const body = { messages: request.messages };
     const params = request.metadata ?? {};
-    const processed = await preprocessRequestBody(request.providerFamilyId ?? request.providerId, '/v1/chat/completions', body, runtime, params);
+    const processed = await preprocessRequestBody(request.providerFamilyId ?? request.providerId, '/v1/chat/completions', body, runtime, params, undefined, undefined, undefined, 'llm');
     const processedBody = isJsonObject(processed) ? processed : body;
     const processedMessages = Array.isArray(processedBody.messages)
         ? processedBody.messages

package/dist/llm/chatTypes.d.ts

@@ -51,6 +51,12 @@ export interface LlmTraceDto {
     elapsedMs: number;
     inputChars: number;
     outputChars: number;
+    /** 发出请求到第一个字的毫秒数（含思考内容） */
+    firstTokenMs?: number | null;
+    /** 首字之后的输出 token 速度（个/秒） */
+    outputTokensPerSecond?: number | null;
+    inputTokens?: number | null;
+    outputTokens?: number | null;
 }
 export type LlmStreamEventDto = {
     type: 'Token';

package/dist/llm/defaults.d.ts

@@ -13,7 +13,7 @@ export declare const DEFAULT_DEEPSEEK_BASE_URL = "https://api.deepseek.com";
 export declare const DEFAULT_DEEPSEEK_MODEL_ID = "deepseek-flash";
 export declare const DEFAULT_PPIO_PROVIDER_ID = "ppio";
 export declare const DEFAULT_PPIO_BASE_URL = "https://api.ppio.com/openai";
-export declare const DEFAULT_PPIO_MODEL_ID = "deepseek/deepseek-v4-flash";
+export declare const DEFAULT_PPIO_MODEL_ID = "deepseek/deepseek-v4.1-flash";
 export declare const DEFAULT_LLM_REASONING_EFFORT: LlmReasoningEffort;
 export declare const DEEPSEEK_V4_CONTEXT_WINDOW = 1000000;
 export declare const DEEPSEEK_V4_MAX_OUTPUT_TOKENS = 384000;
@@ -24,6 +24,6 @@ export declare const DEFAULT_LLM_CAPABILITIES: LlmCapabilities;
  * 添加模型的两个入口（手动添加、获取模型列表）和内置模型清单都走这里，保证"同一个模型 ID
  * 无论从哪个入口进来，标出来的能力一致"。
  */
-export declare function createLlmCapabilitiesForModel(modelId: string): LlmCapabilities;
+export declare function createLlmCapabilitiesForModel(modelId: string, providerId?: string): LlmCapabilities;
 /** DeepSeek 官方要求思考模式默认开启，其余供应商默认关闭；具体档位见 `DEFAULT_LLM_REASONING_EFFORT`。 */
 export declare function createDefaultProviderReasoning(adapter?: string): LlmReasoningConfig;

package/dist/llm/defaults.js

@@ -13,7 +13,7 @@ export const DEFAULT_DEEPSEEK_BASE_URL = 'https://api.deepseek.com';
 export const DEFAULT_DEEPSEEK_MODEL_ID = 'deepseek-flash';
 export const DEFAULT_PPIO_PROVIDER_ID = 'ppio';
 export const DEFAULT_PPIO_BASE_URL = 'https://api.ppio.com/openai';
-export const DEFAULT_PPIO_MODEL_ID = 'deepseek/deepseek-v4-flash';
+export const DEFAULT_PPIO_MODEL_ID = 'deepseek/deepseek-v4.1-flash';
 export const DEFAULT_LLM_REASONING_EFFORT = 'high';
 export const DEEPSEEK_V4_CONTEXT_WINDOW = 1_000_000;
 export const DEEPSEEK_V4_MAX_OUTPUT_TOKENS = 384_000;
@@ -41,8 +41,8 @@ export const DEFAULT_LLM_CAPABILITIES = {
  * 添加模型的两个入口（手动添加、获取模型列表）和内置模型清单都走这里，保证"同一个模型 ID
  * 无论从哪个入口进来，标出来的能力一致"。
  */
-export function createLlmCapabilitiesForModel(modelId) {
-    const entry = findLlmModelCatalogEntry(modelId);
+export function createLlmCapabilitiesForModel(modelId, providerId) {
+    const entry = findLlmModelCatalogEntry(modelId, providerId);
     return entry
         ? applyLlmModelCatalogEntry(DEFAULT_LLM_CAPABILITIES, entry)
         : { ...DEFAULT_LLM_CAPABILITIES };

package/dist/llm/groq/preset.js

@@ -1,3 +1,4 @@
+import { tokenListPrice } from '../../pricing/tokenPricing.js';
 import { findProviderMetadata } from '../../providers/metadata.js';
 export const GROQ_PROVIDER_ID = 'groq';
 export const GROQ_BASE_URL = 'https://api.groq.com/openai/v1';
@@ -14,11 +15,26 @@ export const GROQ_PROVIDER_PRESET = {
     baseUrl: GROQ_BASE_URL,
     reasoning: { enabled: true, effort: 'medium' },
     reasoningConfigurable: true,
-    modelIds: [GROQ_DEFAULT_MODEL_ID],
+    // 2026-11-07 按官方模型页核对：自助账号可用的对话模型只有 GPT-OSS 两款正式版与 Qwen3.8-27B 预览版；
+    // Llama 系列为企业版，Prompt Guard / Safeguard 是安全分类器，Orpheus 是语音合成，均不进对话预设。
+    modelIds: [GROQ_DEFAULT_MODEL_ID, 'openai/gpt-oss-120b', 'qwen/qwen3.8-27b'],
+    // 托管限制以 Groq 模型页为准：Qwen3.8-27B 上下文 131,072、最大输出 16,384、每次最多 3 张图，支持 JSON Schema。
+    modelCapabilities: {
+        'qwen/qwen3.8-27b': {
+            image: true, video: false, audio: false, file: false,
+            toolCall: true, jsonOutput: true, structuredOutputMode: 'schema', reasoning: true,
+            contextWindow: 131_072, maxOutputTokens: 16_384,
+        },
+    },
+    modelPricing: {
+        [GROQ_DEFAULT_MODEL_ID]: tokenListPrice('USD', 0.075, 0.3),
+        'openai/gpt-oss-120b': tokenListPrice('USD', 0.15, 0.6),
+        'qwen/qwen3.8-27b': tokenListPrice('USD', 0.8, 4),
+    },
     websiteUrl: GROQ_PROVIDER_METADATA.websiteUrl,
     apiKeyUrl: GROQ_PROVIDER_METADATA.apiKeyUrl,
     docs: 'docs/model-adaptation/供应商/Groq.md',
-    note: 'GroqCloud（providerId=groq）不是 xAI Grok；GPT-OSS 不支持 reasoning_format。',
+    note: 'GroqCloud（providerId=groq）不是 xAI Grok；GPT-OSS 不支持 reasoning_format；Qwen3.8-27B 为预览模型，可能随时下线。',
 };
 /** 可直接交给统一能力发现器的默认模型；不会触发模型列表网络请求。 */
 export const GROQ_DEFAULT_MODEL_CONFIG = {

package/dist/llm/modelCatalog.d.ts

@@ -18,6 +18,11 @@ export interface LlmModelCatalogEntry {
     vendor: string;
     /** 规范化后仍与 `id` 不同的其他写法（例如同能力的价格变体） */
     aliases?: readonly string[];
+    /**
+     * 同一模型的不同快照能力不同时，按完整 Model ID（去掉厂商前缀与档位标记、小写）覆盖的字段。
+     * 例：方舟 doubao-seed-2-1-pro 的 260915 快照上下文 1024K，旧快照 260628 只有 256K。
+     */
+    snapshots?: Readonly<Record<string, Partial<Pick<LlmModelCatalogEntry, 'contextWindow' | 'maxOutputTokens' | 'input' | 'reasoning' | 'structuredOutputMode'>>>>;
     /** 本项目当前请求路径下真实可用的输入模态，取值依据见 `modelCatalogEntries.ts` 顶部注释 */
     input: {
         image: boolean;
@@ -38,6 +43,8 @@ export interface LlmModelCatalogEntry {
     /** 模型原厂已确认支持的协议；最终使用协议还要与接入供应商的端点能力取交集。 */
     apiProtocols?: readonly LlmApiProtocol[];
     note?: string;
+    /** 已过时的原因；填写后预设不再自动添加、能力发现不再列出，已有配置不受影响。 */
+    deprecated?: string;
     /** 该条目的资料出处，仓库内相对路径 */
     docs: string;
 }
@@ -47,10 +54,10 @@ export declare function modelSupportsLlmApiProtocol(entry: LlmModelCatalogEntry,
  *
  * 同一个模型经不同渠道进来写法不同：聚合网关带厂商前缀（`deepseek/deepseek-v4-flash`、
  * `xiaomimimo/mimo-v2.5-pro`），官方渠道带快照日期后缀（`doubao-seed-2-1-pro-260628`），
- * 部分网关还带 `:free` 之类的档位标记。这些都指向同一份能力。
+ * 部分网关还带 `:free` 之类的档位标记。规范化只收敛名称，原厂重定向等渠道差异仍按供应商查表。
  */
 export declare function normalizeCatalogModelId(modelId: string): string;
-export declare function findLlmModelCatalogEntry(modelId: string): LlmModelCatalogEntry | null;
+export declare function findLlmModelCatalogEntry(modelId: string, providerId?: string): LlmModelCatalogEntry | null;
 /**
  * 把目录条目盖到一份基础能力上。
  *

package/dist/llm/modelCatalog.js

@@ -1,4 +1,4 @@
-import { LLM_MODEL_CATALOG_ENTRIES } from './modelCatalogEntries.js';
+import { DEEPSEEK_OFFICIAL_FLASH_ALIASES, LLM_MODEL_CATALOG_ENTRIES } from './modelCatalogEntries.js';
 export function modelSupportsLlmApiProtocol(entry, protocol) {
     return (entry.apiProtocols ?? ['openai-compatible']).includes(protocol);
 }
@@ -7,7 +7,7 @@ export function modelSupportsLlmApiProtocol(entry, protocol) {
  *
  * 同一个模型经不同渠道进来写法不同：聚合网关带厂商前缀（`deepseek/deepseek-v4-flash`、
  * `xiaomimimo/mimo-v2.5-pro`），官方渠道带快照日期后缀（`doubao-seed-2-1-pro-260628`），
- * 部分网关还带 `:free` 之类的档位标记。这些都指向同一份能力。
+ * 部分网关还带 `:free` 之类的档位标记。规范化只收敛名称，原厂重定向等渠道差异仍按供应商查表。
  */
 export function normalizeCatalogModelId(modelId) {
     const trimmed = modelId.trim().toLowerCase();
@@ -23,9 +23,22 @@ const CATALOG_BY_KEY = new Map(LLM_MODEL_CATALOG_ENTRIES.flatMap(entry => [
     [entry.id, entry],
     ...(entry.aliases ?? []).map(alias => [normalizeCatalogModelId(alias), entry]),
 ]));
-export function findLlmModelCatalogEntry(modelId) {
+export function findLlmModelCatalogEntry(modelId, providerId) {
     const key = normalizeCatalogModelId(modelId);
-    return key ? CATALOG_BY_KEY.get(key) ?? null : null;
+    const provider = providerId?.trim().toLowerCase();
+    // 无前缀的旧名默认指原厂；显式供应商优先，聚合前缀不能继承原厂重定向。
+    if (provider === 'deepseek' || (!provider && !modelId.includes('/'))) {
+        const official = DEEPSEEK_OFFICIAL_FLASH_ALIASES.find(entry => entry.id === key);
+        if (official)
+            return official;
+    }
+    const entry = key ? CATALOG_BY_KEY.get(key) ?? null : null;
+    const snapshot = entry?.snapshots?.[withoutRouting(modelId)];
+    return entry && snapshot ? { ...entry, ...snapshot } : entry;
+}
+function withoutRouting(modelId) {
+    const trimmed = modelId.trim().toLowerCase();
+    return trimmed.slice(trimmed.lastIndexOf('/') + 1).split(':')[0];
 }
 /**
  * 把目录条目盖到一份基础能力上。

package/dist/llm/modelCatalogEntries.d.ts

@@ -13,3 +13,5 @@ import type { LlmModelCatalogEntry } from './modelCatalog.js';
  * 否则用户会得到"勾了但发过去没反应"的静默失效。
  */
 export declare const LLM_MODEL_CATALOG_ENTRIES: readonly LlmModelCatalogEntry[];
+/** 原厂旧名已转到新 Flash；网关同名仍保留上方的独立旧契约。 */
+export declare const DEEPSEEK_OFFICIAL_FLASH_ALIASES: readonly LlmModelCatalogEntry[];

package/dist/llm/modelCatalogEntries.js

@@ -12,9 +12,27 @@
  * 否则用户会得到"勾了但发过去没反应"的静默失效。
  */
 export const LLM_MODEL_CATALOG_ENTRIES = [
+    {
+        id: 'deepseek-v4.1-flash',
+        displayName: 'DeepSeek V4.1 Flash',
+        vendor: 'DeepSeek',
+        // 方舟写作 deepseek-v4-1-flash-<快照>（含经济版），百炼另有四位快照 -1017。
+        aliases: ['deepseek-v4-1-flash', 'deepseek-v4-1-flash-economy', 'deepseek-v4.1-flash-1017'],
+        input: { image: true, video: false, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        sampling: true,
+        contextWindow: 1_000_000,
+        maxOutputTokens: 384_000,
+        apiProtocols: ['openai-responses', 'openai-compatible'],
+        note: '能力按 DeepSeek 官方 V4.1 Flash（与原厂 deepseek-flash 一致）：图片理解、函数工具、JSON、思考，上下文 1,000,000、最大输出 384,000。派欧云与方舟走 Chat；百炼官方列入 Responses 支持清单。各平台价格见对应供应商资料。',
+        docs: 'docs/model-adaptation/供应商/派欧云.md',
+    },
     // 硅基流动模型页与 Chat VLM 契约；未确认的视频字段和输出上限不猜测。
     ...[
-        { id: 'kimi-k2.7-code', displayName: 'Kimi K2.7 Code', vendor: 'Moonshot' },
+        { id: 'kimi-k2.7-code', displayName: 'Kimi K2.7 Code', vendor: 'Moonshot', deprecated: 'Kimi 于 2026 年底下线全部 K2 系列，10-31 起不再对新用户开放；请改用 K3 / K3.1 Pro' },
         { id: 'qwen3.8-27b', displayName: 'Qwen3.8-27B', vendor: 'Qwen' },
     ].map(model => ({
         ...model,
@@ -45,6 +63,22 @@ export const LLM_MODEL_CATALOG_ENTRIES = [
         note: 'Groq Production 模型；reasoning_effort 仅支持 low / medium / high，且不支持 reasoning_format。',
         docs: 'docs/model-adaptation/GPT-OSS-20B/GPT-OSS-20B_Groq.md',
     },
+    {
+        id: 'gpt-oss-120b',
+        displayName: 'GPT-OSS 120B',
+        vendor: 'OpenAI',
+        input: { image: false, video: false, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        structuredOutputWithReasoning: true,
+        reasoning: true,
+        sampling: true,
+        contextWindow: 131_072,
+        maxOutputTokens: 65_536,
+        note: 'Groq Production 模型，参数约定与 20B 相同；reasoning_effort 仅支持 low / medium / high，且不支持 reasoning_format。',
+        docs: 'docs/model-adaptation/供应商/Groq.md',
+    },
     // ---------------- DeepSeek ----------------
     {
         id: 'deepseek-flash',
@@ -66,6 +100,7 @@ export const LLM_MODEL_CATALOG_ENTRIES = [
         id: 'deepseek-v4-flash',
         displayName: 'DeepSeek V4 Flash',
         vendor: 'DeepSeek',
+        aliases: ['deepseek-v4-flash-ga', 'deepseek-v4-flash-0731'],
         input: { image: false, video: false, audio: false },
         toolCall: true,
         parallelTools: false,
@@ -82,6 +117,7 @@ export const LLM_MODEL_CATALOG_ENTRIES = [
         id: 'deepseek-v4-pro',
         displayName: 'DeepSeek V4 Pro',
         vendor: 'DeepSeek',
+        aliases: ['deepseek-v4-pro-ga', 'deepseek-v4-pro-0813'],
         input: { image: false, video: false, audio: false },
         toolCall: true,
         parallelTools: false,
@@ -93,22 +129,6 @@ export const LLM_MODEL_CATALOG_ENTRIES = [
         apiProtocols: ['openai-responses', 'openai-compatible'],
         docs: 'docs/llm-adaptation/供应商/DeepSeek.md',
     },
-    {
-        id: 'deepseek-v4-flash-vision-exp',
-        displayName: 'DeepSeek V4 Flash Vision (实验)',
-        vendor: 'DeepSeek',
-        input: { image: true, video: false, audio: false },
-        toolCall: true,
-        parallelTools: false,
-        structuredOutputMode: 'json',
-        reasoning: true,
-        sampling: true,
-        contextWindow: 1_000_000,
-        maxOutputTokens: 384_000,
-        apiProtocols: ['openai-responses', 'openai-compatible'],
-        note: '图片输入只在 Responses API 下可用；SDK 会在直连 DeepSeek 时自动选择 Responses。',
-        docs: 'docs/llm-adaptation/供应商/DeepSeek.md',
-    },
     // ---------------- Kimi（Moonshot） ----------------
     {
         id: 'kimi-k3',
@@ -128,6 +148,40 @@ export const LLM_MODEL_CATALOG_ENTRIES = [
         note: '思考模式始终开启无法关闭；图片必须用 base64 data URL，不接受公网直链；视频要先经 Files API 上传再用 ms://<file-id> 引用。',
         docs: 'docs/llm-adaptation/供应商/Kimi.md',
     },
+    {
+        id: 'kimi-k3.1-pro',
+        displayName: 'Kimi K3.1 Pro',
+        vendor: 'Moonshot',
+        aliases: ['kimi-k3-1-pro'],
+        // 方舟把它列在视觉理解能力里，但没写明是否收视频，视频保守不开。
+        input: { image: true, video: false, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        // 原厂文档写明 K3 系列采样参数固定、必须省略。
+        sampling: false,
+        contextWindow: 1_048_576,
+        maxOutputTokens: null,
+        note: '经方舟与百炼托管调用：思考默认开启，可关闭；百炼标注结构化输出为 JSON Mode，内置工具只在 Responses 下可用（项目走 Chat）。原厂直连的能力见 Kimi 供应商预设。',
+        docs: 'docs/llm-adaptation/供应商/火山引擎.md',
+    },
+    {
+        id: 'kimi-k3.1-pro-highspeed',
+        displayName: 'Kimi K3.1 Pro Highspeed',
+        vendor: 'Moonshot',
+        input: { image: true, video: false, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'schema',
+        structuredOutputWithReasoning: true,
+        reasoning: true,
+        sampling: false,
+        contextWindow: 1_048_576,
+        maxOutputTokens: 131_072,
+        note: 'K3.1 Pro 的高速版，速度约 2～3 倍，只在 Kimi 原厂提供；思考无法关闭。',
+        docs: 'docs/llm-adaptation/供应商/Kimi.md',
+    },
     {
         id: 'kimi-k2.6',
         displayName: 'Kimi K2.6',
@@ -141,6 +195,7 @@ export const LLM_MODEL_CATALOG_ENTRIES = [
         contextWindow: null,
         maxOutputTokens: null,
         note: '沿用项目既有内置配置的模态标注，未逐项核对官方文档；上下文与输出上限留空由动态验证或用户补齐。',
+        deprecated: 'Kimi 于 2026 年底下线全部 K2 系列，10-31 起不再对新用户开放；请改用 K3 / K3.1 Pro',
         docs: 'docs/llm-adaptation/供应商/Kimi.md',
     },
     // ---------------- 智谱 GLM ----------------
@@ -149,6 +204,8 @@ export const LLM_MODEL_CATALOG_ENTRIES = [
         { id: 'glm-5.3-flashx', displayName: 'GLM-5.3-FlashX' },
     ].map(model => ({
         ...model,
+        // 方舟托管写作 glm-5-3-flash-<快照>。
+        ...(model.id === 'glm-5.3-flash' ? { aliases: ['glm-5-3-flash'] } : {}),
         vendor: '智谱',
         input: { image: true, video: true, audio: false, file: true },
         toolCall: true,
@@ -179,6 +236,24 @@ export const LLM_MODEL_CATALOG_ENTRIES = [
         note: '始终开启思考且无法关闭；官方明确只支持文本模态，需要看图看视频请改用 GLM-5V-Turbo。',
         docs: 'docs/llm-adaptation/供应商/智谱GLM.md',
     },
+    {
+        id: 'glm-5.2',
+        displayName: 'GLM-5.2',
+        vendor: '智谱',
+        aliases: ['glm-5-2'],
+        input: { image: false, video: false, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        // 方舟与百炼都没有给 GLM-5.2 标结构化输出，保守不开。
+        structuredOutputMode: 'none',
+        reasoning: true,
+        sampling: true,
+        contextWindow: 1_048_576,
+        maxOutputTokens: 131_072,
+        apiProtocols: ['openai-responses', 'openai-compatible'],
+        note: '经方舟与百炼托管调用；纯文本。百炼列入 Responses 支持清单。',
+        docs: 'docs/llm-adaptation/供应商/火山引擎.md',
+    },
     {
         id: 'glm-5v-turbo',
         displayName: 'GLM-5V-Turbo',
@@ -221,8 +296,9 @@ export const LLM_MODEL_CATALOG_ENTRIES = [
         structuredOutputMode: 'json',
         reasoning: true,
         sampling: true,
-        contextWindow: 262_144,
+        contextWindow: 1_048_576,
         maxOutputTokens: 262_144,
+        snapshots: { 'doubao-seed-2-1-pro-260628': { contextWindow: 262_144 } },
         apiProtocols: ['openai-responses', 'openai-compatible'],
         docs: 'docs/llm-adaptation/供应商/火山引擎.md',
     },
@@ -241,6 +317,58 @@ export const LLM_MODEL_CATALOG_ENTRIES = [
         apiProtocols: ['openai-responses', 'openai-compatible'],
         docs: 'docs/llm-adaptation/供应商/火山引擎.md',
     },
+    {
+        id: 'doubao-seed-2-1-lite',
+        displayName: 'Doubao-Seed-2.1-Lite',
+        vendor: '火山引擎',
+        // 官方另支持音频理解，但项目还没核对方舟的音频内容块写法，先不开。
+        input: { image: true, video: true, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        sampling: true,
+        contextWindow: 1_048_576,
+        maxOutputTokens: 262_144,
+        apiProtocols: ['openai-responses', 'openai-compatible'],
+        docs: 'docs/llm-adaptation/供应商/火山引擎.md',
+    },
+    ...[
+        { id: 'doubao-seed-2-0-lite', displayName: 'Doubao-Seed-2.0-Lite' },
+        { id: 'doubao-seed-2-0-mini', displayName: 'Doubao-Seed-2.0-Mini' },
+    ].map(model => ({
+        ...model,
+        vendor: '火山引擎',
+        input: { image: true, video: true, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        sampling: true,
+        // 上下文 256K，单次最大输入 224K。
+        contextWindow: 262_144,
+        maxOutputTokens: 131_072,
+        apiProtocols: ['openai-responses', 'openai-compatible'],
+        note: '长期支持版（LTS）快照 260428；260215 快照即将下线。官方另支持音频理解，项目暂未开放。',
+        docs: 'docs/llm-adaptation/供应商/火山引擎.md',
+    })),
+    {
+        id: 'doubao-seed-character',
+        displayName: 'Doubao-Seed-Character',
+        vendor: '火山引擎',
+        input: { image: true, video: true, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        sampling: true,
+        contextWindow: 131_072,
+        maxOutputTokens: 32_768,
+        apiProtocols: ['openai-responses', 'openai-compatible'],
+        note: '角色扮演模型；能力按 260628 快照，旧快照 251128 不支持思考与多模态。',
+        snapshots: { 'doubao-seed-character-251128': { input: { image: false, video: false, audio: false }, reasoning: false, structuredOutputMode: 'none' } },
+        docs: 'docs/llm-adaptation/供应商/火山引擎.md',
+    },
     // ---------------- 小米 MiMo ----------------
     ...[
         { id: 'mimo-v2.6-pro', displayName: 'MiMo-V2.6-Pro' },
@@ -261,11 +389,13 @@ export const LLM_MODEL_CATALOG_ENTRIES = [
         note: '支持 Chat Completions 与 Responses；思考只有开关，无强度分级。UltraSpeed 需要联系供应商开通。',
         docs: 'docs/llm-adaptation/供应商/小米MiMo.md',
     })),
+    // ---------------- 阿里云百炼 Qwen ----------------
     {
-        id: 'mimo-v2.5-pro',
-        displayName: 'MiMo-V2.5-Pro',
-        vendor: '小米',
-        input: { image: false, video: false, audio: false },
+        id: 'qwen3.8-max',
+        displayName: 'Qwen3.8-Max',
+        vendor: '阿里云百炼',
+        aliases: ['qwen3.8-max-prime', 'qwen3.8-max-0902'],
+        input: { image: true, video: true, audio: false },
         toolCall: true,
         parallelTools: false,
         structuredOutputMode: 'json',
@@ -273,14 +403,17 @@ export const LLM_MODEL_CATALOG_ENTRIES = [
         sampling: true,
         contextWindow: 1_000_000,
         maxOutputTokens: 131_072,
-        note: '多轮工具调用时官方建议把历史轮次的 reasoning_content 一并回传。',
-        docs: 'docs/llm-adaptation/供应商/小米MiMo.md',
+        apiProtocols: ['openai-responses', 'openai-compatible'],
+        note: '必须走多模态接口：即使是纯文字对话，content 也要写成内容块数组，直接传字符串会报 url error。',
+        docs: 'docs/llm-adaptation/供应商/百炼Qwen.md',
     },
-    {
-        id: 'mimo-v2.5',
-        displayName: 'MiMo-V2.5',
-        vendor: '小米',
-        input: { image: true, video: true, audio: true },
+    ...[
+        { id: 'qwen3.8-flash', displayName: 'Qwen3.8-Flash' },
+        { id: 'qwen3.7-plus', displayName: 'Qwen3.7-Plus' },
+    ].map(model => ({
+        ...model,
+        vendor: '阿里云百炼',
+        input: { image: true, video: true, audio: false },
         toolCall: true,
         parallelTools: false,
         structuredOutputMode: 'json',
@@ -288,29 +421,42 @@ export const LLM_MODEL_CATALOG_ENTRIES = [
         sampling: true,
         contextWindow: 1_000_000,
         maxOutputTokens: 131_072,
-        note: '官方标注全模态理解，图片 / 音频 / 视频均可作为输入。',
-        docs: 'docs/llm-adaptation/供应商/小米MiMo.md',
-    },
-    // ---------------- 阿里云百炼 Qwen ----------------
+        apiProtocols: ['openai-responses', 'openai-compatible'],
+        docs: 'docs/llm-adaptation/供应商/百炼Qwen.md',
+    })),
     {
-        id: 'qwen3.8-max',
-        displayName: 'Qwen3.8-Max',
-        vendor: '阿里云百炼',
-        aliases: ['qwen3.8-max-prime'],
-        input: { image: true, video: true, audio: false },
+        id: 'step-5-preview',
+        displayName: 'Step-5-Preview',
+        vendor: '阶跃星辰',
+        // 只在百炼三方直供核对过：未写明输入模态，按纯文本处理。
+        input: { image: false, video: false, audio: false },
         toolCall: true,
         parallelTools: false,
         structuredOutputMode: 'json',
         reasoning: true,
         sampling: true,
-        // 官方文档只写"超长文档与长视频"，没有给出可引用的上下文 token 数，留空走回退预算。
-        contextWindow: null,
+        contextWindow: 1_000_000,
         maxOutputTokens: null,
-        apiProtocols: ['openai-responses', 'openai-compatible'],
-        note: '必须走多模态接口：即使是纯文字对话，content 也要写成内容块数组，直接传字符串会报 url error。',
         docs: 'docs/llm-adaptation/供应商/百炼Qwen.md',
     },
     // ---------------- MiniMax ----------------
+    {
+        id: 'minimax-m3.1-flash',
+        displayName: 'MiniMax-M3.1-Flash',
+        vendor: 'MiniMax',
+        // 百炼资料没写输入模态，按纯文本处理。
+        input: { image: false, video: false, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        // 百炼标注不支持结构化输出、仅思考模式。
+        structuredOutputMode: 'none',
+        reasoning: true,
+        sampling: true,
+        contextWindow: 1_000_000,
+        maxOutputTokens: null,
+        note: '经百炼三方直供调用，只有思考模式；不支持结构化输出与内置工具。',
+        docs: 'docs/llm-adaptation/供应商/百炼Qwen.md',
+    },
     {
         id: 'minimax-m3',
         displayName: 'MiniMax-M3',
@@ -328,3 +474,12 @@ export const LLM_MODEL_CATALOG_ENTRIES = [
         docs: 'docs/llm-adaptation/供应商/MiniMax.md',
     },
 ];
+/** 原厂旧名已转到新 Flash；网关同名仍保留上方的独立旧契约。 */
+export const DEEPSEEK_OFFICIAL_FLASH_ALIASES = [
+    'deepseek-v4-flash', 'deepseek-v4-flash-vision-exp',
+].map(id => ({
+    ...LLM_MODEL_CATALOG_ENTRIES.find(entry => entry.id === 'deepseek-flash'),
+    id,
+    displayName: 'DeepSeek V4.1 Flash（原厂旧别名）',
+    note: '原厂旧实体已下线，旧名称重定向到 deepseek-flash；支持图片及 Chat / Responses API。网关同名条目不使用此覆盖。',
+}));

package/dist/llm/providerPresets.d.ts

@@ -1,4 +1,5 @@
 import type { LlmApiProtocol } from './providerProtocol.js';
+import { type TokenListPricing } from '../pricing/tokenPricing.js';
 import type { LlmCapabilities, LlmModelConfig, LlmProviderConfig, LlmReasoningEffort } from './types.js';
 /**
  * 内置供应商预设。
@@ -29,6 +30,8 @@ export interface LlmProviderPreset {
     modelCapabilities?: Readonly<Record<string, Partial<LlmCapabilities>>>;
     /** 这家供应商已确认可走 Responses 的具体模型；未列出的模型继续走 Chat Completions。 */
     responsesModelIds?: readonly string[];
+    /** 这家供应商对推荐模型公布的按量标准价，出处写在 docs 指向的资料里；没查到的模型不登记。 */
+    modelPricing?: Readonly<Record<string, TokenListPricing>>;
     websiteUrl: string;
     apiKeyUrl: string;
     /** 该预设的资料出处，仓库内相对路径 */