@dsh-plus/llm-pi 0.1.6 → 0.1.7

package/lib/index.js

@@ -9,29 +9,29 @@ import { dirname, join } from "node:path";
 import HttpsProxyAgentModule from "https-proxy-agent";
 import { credentialRef } from "@deepseek-ai/dsh-credentials";
 import { pathToFileURL } from "node:url";
+import * as vendoredAnonId from "@deepseek-ai/dsh-anonymous-user-id";
 import * as vendoredLlm from "@deepseek-ai/dsh-llm";
+import * as vendoredDeepseek from "@deepseek-ai/dsh-llm-deepseek";
 import * as vendoredPiAiAdapter from "@deepseek-ai/dsh-llm-pi-ai";
 import * as vendoredPiAi from "@earendil-works/pi-ai";
 import { anthropicMessagesApi } from "@earendil-works/pi-ai/api/anthropic-messages.lazy";
 import { openAICompletionsApi } from "@earendil-works/pi-ai/api/openai-completions.lazy";
 import { openAIResponsesApi } from "@earendil-works/pi-ai/api/openai-responses.lazy";
 import * as vendoredCatalog from "@earendil-works/pi-ai/providers/all";
-
-//#region src/ns.ts
-/**
-* settings 命名空间字面量（纯常量，零依赖，浏览器半可安全引入）。
-* 服务端经 settingsNamespace() 品牌化后使用（config.ts），浏览器半将其作为
-* settings.plugin.item keyed 槽位的 key —— 同一字面量两处共用，防止漂移。
-* 契约：dsh rc7 起该槽位按「卡片编辑的 settings 命名空间」作 key 分发，
-* 官方配置页只渲染 key 命中 Host 已注册命名空间的卡片。
-* @module llm-pi/ns
-*/
-const SETTINGS_NS$1 = "dsh-plus-llm-pi";
-
 //#endregion
 //#region src/config.ts
+/**
+* 配置单一事实源：cordis 行级 Config（组合默认值）与 settings namespace
+*（用户层，经 dsh-settings-file 持久化到 $DSH_HOME/settings.yaml）共用同一
+* schemastery schema。无密钥字段（apiKeyEnv 是凭据引用名而非密钥本身）。
+*
+* 与官方 llm-pi-ai 的差异：
+* - compat 是开放 dict，物化时按协议校验（见 compat.ts），写入即拒绝未知键；
+* - provider/model 均支持 extends 继承（见 inherit.ts）。
+* @module llm-pi/config
+*/
 /** settings 命名空间；webui 配置卡片与插件运行期读取同一份（字面量见 ./ns.ts）。 */
-const SETTINGS_NS = settingsNamespace(SETTINGS_NS$1);
+const SETTINGS_NS = settingsNamespace("dsh-plus-llm-pi");
 /** 本插件可为手写 route 提供的协议实现（与官方 PROTOCOLS 表一致）。 */
 const PROTOCOL_IDS = [
 	"openai-completions",
@@ -49,12 +49,17 @@ const THINKING_LEVELS = [
 	"max"
 ];
 const MODALITIES = ["text", "image"];
-const DEFAULT_CONTEXT_WINDOW = 262144;
-const DEFAULT_MAX_TOKENS = 32768;
-const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 3e5;
-/** 单请求 base64 图片载荷上限（rc8 起官方 ResolvedPiAiProviderProfile 必需字段；
-*  缺省取官方默认 20MiB，旧配置无需改动即自动生效）。 */
-const DEFAULT_MAX_REQUEST_IMAGE_BYTES = 20 * 1024 * 1024;
+/** 路由适配器种类：pi = PiAiAdapter（默认）；deepseek = 官方 DeepSeekAdapter（文件通道）。 */
+const ADAPTER_KINDS = ["pi", "deepseek"];
+/** deepseek 路由的思考/推理档位（线协议枚举，对齐官方 llm-deepseek）。 */
+const DEEPSEEK_THINKING = ["enabled", "disabled"];
+const DEEPSEEK_REASONING_EFFORTS = [
+	"off",
+	"low",
+	"high",
+	"max"
+];
+const DEEPSEEK_IMAGE_DETAILS = ["auto", "low"];
 /** dsh-timeout 的定时器上限（与官方 MAX_TIMER_DELAY_MS 对齐）。 */
 const MAX_TIMER_DELAY_MS = 2 ** 31 - 1;
 /** 键为可选档位，值为线协议拼写；仅 off 可留空（支持但不发送参数）。 */
@@ -79,9 +84,13 @@ const modelEntry = z.object({
 	maxTokens: z.number().step(1).min(1).description("输出能力上限；显式配置同时成为无 cap 请求的默认 cap"),
 	input: z.array(z.union(MODALITIES)).description("请求模态；缺省继承内置目录，再退化 route defaultInput"),
 	reasoningEfforts: z.union([z.const(false), reasoningEfforts]).description("可选 reasoning 档位：false=非推理模型；dict=档位→线值映射；缺省继承内置目录能力"),
-	compat: compatDict.description("模型级 compat（字段级合并，压过 route 级与继承值）")
+	compat: compatDict.description("模型级 compat（字段级合并，压过 route 级与继承值）"),
+	imagePixelBudget: z.number().step(1).min(1).description("（仅 adapter: deepseek）单张请求图片的总像素预算；缺省继承官方目录"),
+	imageMaxBytes: z.number().step(1).min(1).description("（仅 adapter: deepseek）单张请求图片的编码字节上限；缺省继承官方目录"),
+	imageDetail: z.union(DEEPSEEK_IMAGE_DETAILS).description("（仅 adapter: deepseek）图片细节档位；low 使用 512x512 像素预算")
 });
 const providerProfile = z.object({
+	adapter: z.union(ADAPTER_KINDS).description("路由适配器：pi=PiAiAdapter（默认，三协议）；deepseek=官方 DeepSeekAdapter（图片走 Files API 文件通道，失败自动降级 base64）").default("pi"),
 	extends: z.string().description("provider 级继承：内置 provider id，提供 api/baseURL 默认值与模型 extends 的缺省查找源"),
 	displayName: z.string().description("选择器显示名；缺省为 route 键"),
 	api: z.union(PROTOCOL_IDS).description("线协议；缺省逐模型取继承值的 api，全部一致时作为 route 协议"),
@@ -110,6 +119,17 @@ const providerProfile = z.object({
 	streamIdleTimeoutMs: z.number().min(Number.MIN_VALUE).max(MAX_TIMER_DELAY_MS).description("单支流式读取的最大空闲间隔毫秒"),
 	maxRequestImageBytes: z.natural().description("单请求 base64 图片载荷上限字节；缺省 20MiB（rc8 起生效，旧配置免改）"),
 	retryPolicy: z.any().description("provider 重试策略（dsh-llm RetryPolicy 形状，构建期校验）"),
+	thinking: z.union(DEEPSEEK_THINKING).description("（仅 adapter: deepseek）思考模式开关；缺省用提供商默认"),
+	reasoningEffort: z.union(DEEPSEEK_REASONING_EFFORTS).description("（仅 adapter: deepseek）推理档位；缺省为 high"),
+	maxRequestFilesBytes: z.number().step(1).min(1).description("（仅 adapter: deepseek）单请求文件引用图片累积上限字节；缺省 128MiB"),
+	maxInlineRequestImageBytes: z.number().step(1).min(1).description("（仅 adapter: deepseek）文件通道降级后 base64 图片载荷上限字节；缺省 20MiB"),
+	maxImagesPerRequest: z.number().step(1).min(1).description("（仅 adapter: deepseek）单请求图片数量上限；缺省 600（调低时需同步调低 imageOffloadCountQuantum）"),
+	imageOffloadByteQuantum: z.number().step(1).min(1).description("（仅 adapter: deepseek）文件引用超限后的原始字节削减步长；缺省 64MiB，不可超过 maxRequestFilesBytes"),
+	inlineImageOffloadByteQuantum: z.number().step(1).min(1).description("（仅 adapter: deepseek）base64 降级超限后的削减步长；缺省 10MiB，不可超过 maxInlineRequestImageBytes"),
+	imageOffloadCountQuantum: z.number().step(1).min(1).description("（仅 adapter: deepseek）图片数量超限后的削减步长；缺省 20，不可超过 maxImagesPerRequest"),
+	filesApiTimeoutMs: z.number().min(Number.MIN_VALUE).max(MAX_TIMER_DELAY_MS).description("（仅 adapter: deepseek）单次 Files API 图片解析超时毫秒；缺省 60s"),
+	fileExpiresAfterSeconds: z.number().step(1).min(3600).max(2592e3).description("（仅 adapter: deepseek）上传文件的远端存活秒数；缺省 7 天"),
+	fileRefreshMarginSeconds: z.number().step(1).min(0).description("（仅 adapter: deepseek）文件过期前提前重传的余量秒数；缺省 3600"),
 	models: z.array(modelEntry).description("本 route 的模型目录；缺省且 provider 有 extends 时继承该源全部模型")
 });
 const Config = z.object({
@@ -119,7 +139,6 @@ const Config = z.object({
 	catalogProxy: z.string().description("拉取 models.dev 目录时的 HTTP 代理地址（如 http://127.0.0.1:7890）；留空直连").default(""),
 	providers: z.dict(providerProfile).description("provider 路由表，键即 route 名").default({})
 });
-
 //#endregion
 //#region src/catalog/builtin.ts
 /** 内置 provider 的端点（provider 级 extends 的 baseURL 缺省值）。 */
@@ -165,7 +184,6 @@ function inheritedCatalogEntries(kit, provider) {
 		base: builtinModelBase(kit, provider, model.id) ?? {}
 	}));
 }
-
 //#endregion
 //#region src/config-api.ts
 const ROUTE_CATALOG = "/dsh-plus/llm-pi/catalog";
@@ -220,14 +238,30 @@ function registerCatalogApi(ctx, runtime) {
 		handler: guard((req, res) => handleCatalog(runtime, req, res))
 	});
 }
-
 //#endregion
 //#region src/catalog/models-dev.ts
+/**
+* models.dev 兜底目录源：继承解析的第二级数据源。
+*
+* 只用于内置目录尚未收录的新模型/新供应商。数据是公开快照
+*（默认 https://models.dev/api.json），**默认不自动拉取**（catalogRefreshHours=0）；
+* 拉取方式二选一：
+* - 配置 catalogRefreshHours > 0：启动/过期后后台自动刷新；
+* - 配置卡片「手动拉取」或 POST /catalog/refresh：立即拉取。
+* 拉取可经 catalogProxy 代理（HTTP 代理，如 http://127.0.0.1:7890）。
+* 成功落盘缓存（storages/dsh-plus-llm-pi/models-dev.json）；任何失败都退化为
+* "仅内置目录"，绝不阻塞 route 注册。
+*
+* 保守原则：models.dev 数据未经 pi 官方校正（无 compat/thinkingLevelMap），
+* 且模态声明不被采信——继承自本源的模型 input 一律走 text-only 兜底，
+* 视觉等模态须用户在条目上显式声明（防 over-claiming 导致会话重复失败请求）。
+* @module llm-pi/catalog/models-dev
+*/
 /** 仅 https 目标走代理（http 目标直连；代理通常只提供 CONNECT 隧道）。 */
 const { HttpsProxyAgent } = HttpsProxyAgentModule;
 const FETCH_TIMEOUT_MS = 2e4;
 /** 目录文档体上限（api.json 全量约 1-2MB，放宽到 20MB 防未来膨胀）。 */
-const MAX_RESPONSE_BYTES$1 = 20 * 1024 * 1024;
+const MAX_RESPONSE_BYTES$1 = 20971520;
 /**
 * 极简 JSON GET（node:http(s) 实现）：支持 HTTP 代理（仅 https 目标）与超时。
 * 不跟随重定向（models.dev 直链无重定向；自定义端点需自行保证可直达）。
@@ -383,11 +417,136 @@ var ModelsDevSource = class {
 		}
 	}
 };
-
+//#endregion
+//#region src/deepseek-routes.ts
+/** 凭据解析（逐行对齐官方 llm-deepseek resolveApiKey）：凭据服务优先，启动环境兜底。 */
+function makeResolveApiKey$1(ctx, kit) {
+	return async (connection) => {
+		const ref = connection.apiKeyEnv;
+		const credentials = ctx.get("credentials");
+		const hit = credentials !== void 0 ? (await credentials.resolve(ref))?.value : launchEnvironmentOf(ctx).get(ref)?.value;
+		if (hit !== void 0 && hit.length > 0) return kit.assertUsableApiKey(hit, "llm-pi", ref);
+		throw new kit.LlmError(`llm-pi: deepseek route 的凭据引用 ${String(ref)} 未解析到值——请经凭据服务（web Models 页）存放或导出环境变量`, "MISSING_CREDENTIAL");
+	};
+}
+var DeepseekRouteRegistrar = class {
+	deps;
+	registrations = /* @__PURE__ */ new Map();
+	resolveApiKey;
+	userId;
+	constructor(deps) {
+		this.deps = deps;
+		this.resolveApiKey = makeResolveApiKey$1(deps.ctx, deps.kit);
+	}
+	/** 同步注册表与目标 route 集：新增注册、移除 dispose、retryPolicy 变化原地 replace。 */
+	sync(target) {
+		for (const [route, registration] of this.registrations) {
+			if (target.has(route)) continue;
+			registration.handle();
+			this.registrations.delete(route);
+			this.deps.logger.warn(`llm-pi: deepseek route "${route}" 已随配置移除而注销`);
+		}
+		for (const [route, built] of target) {
+			const existing = this.registrations.get(route);
+			if (existing !== void 0) {
+				this.refreshPolicy(route, built, existing);
+				continue;
+			}
+			this.register(route, built);
+		}
+	}
+	refreshPolicy(route, built, registration) {
+		const policy = built.connection.retryPolicy;
+		if (deepEqualJson(policy, registration.retryPolicy)) return;
+		try {
+			registration.handle.replace([route]);
+			registration.retryPolicy = policy;
+		} catch (error) {
+			this.deps.logger.error(`llm-pi: deepseek route "${route}" 重试策略更新被拒，保留此前注册`);
+			this.deps.logger.error(error);
+		}
+	}
+	/** 匿名用户 id（首次调用时生成并备忘；register 前已确认 kit.deepseek 存在）。 */
+	resolveUserId() {
+		if (this.userId === void 0) this.userId = this.deps.kit.deepseek?.getOrCreateAnonymousUserId();
+		return this.userId;
+	}
+	register(route, built) {
+		const { ctx, kit, logger, routes } = this.deps;
+		if (kit.deepseek === void 0) return;
+		const adapter = new kit.deepseek.DeepSeekAdapter({
+			options: () => {
+				const current = routes().get(route);
+				if (current === void 0) throw new kit.LlmError(`llm-pi: deepseek route "${route}" 已注销`, "INVALID_REQUEST");
+				return current.connection;
+			},
+			resolveApiKey: this.resolveApiKey,
+			resolveUserId: () => this.resolveUserId(),
+			resolveAttachments: () => ctx.get("attachments")
+		});
+		try {
+			const handle = ctx.llm.registerAdapter([route], adapter);
+			this.registrations.set(route, {
+				handle,
+				retryPolicy: built.connection.retryPolicy
+			});
+		} catch (error) {
+			logger.error(`llm-pi: deepseek route "${route}" 注册失败（可能与其他 adapter 重名），该 route 不可用`);
+			logger.error(error);
+		}
+	}
+};
+//#endregion
+//#region src/catalog/official.ts
+/** 按 kit 备忘（kit 实例在进程内唯一，目录随 dsh 树版本固定）。 */
+const cache = /* @__PURE__ */ new WeakMap();
+function catalogOf(kit) {
+	const hit = cache.get(kit);
+	if (hit !== void 0) return hit;
+	if (kit.deepseek === void 0) throw new Error("llm-pi: 官方模型目录需要 dsh-llm-deepseek（当前运行时套件不含）");
+	const resolved = kit.deepseek.resolveAdapterOptions({}, void 0);
+	const models = /* @__PURE__ */ new Map();
+	for (const model of resolved.models) models.set(model.id, {
+		...model.name === void 0 ? {} : { name: model.name },
+		...model.contextWindow === void 0 ? {} : { contextWindow: model.contextWindow },
+		...model.maxTokens === void 0 ? {} : { maxTokens: model.maxTokens },
+		...model.inputModalities === void 0 ? {} : { input: [...model.inputModalities] },
+		...model.imagePixelBudget === void 0 ? {} : { imagePixelBudget: model.imagePixelBudget },
+		...model.imageMaxBytes === void 0 ? {} : { imageMaxBytes: model.imageMaxBytes },
+		...model.imageDetail === void 0 ? {} : { imageDetail: model.imageDetail }
+	});
+	const catalog = {
+		baseUrl: resolved.baseURL,
+		models
+	};
+	cache.set(kit, catalog);
+	return catalog;
+}
+/** 官方端点（route 配 extends: 'deepseek' 且未显式 baseURL 时的缺省值）。 */
+function officialBaseUrl(kit) {
+	return catalogOf(kit).baseUrl;
+}
+/** 查单个官方模型为继承 base；未命中返回 undefined。 */
+function officialModelBase(kit, modelId) {
+	const base = catalogOf(kit).models.get(modelId);
+	return base === void 0 ? void 0 : { ...base };
+}
+/** 官方目录的全部模型 id（route 级 extends: 'deepseek' 的全量继承与诊断用）。 */
+function officialModelIds(kit) {
+	return [...catalogOf(kit).models.keys()];
+}
 //#endregion
 //#region src/discovery.ts
-const LISTABLE_PROTOCOLS = new Set(["openai-completions", "openai-responses"]);
-const MAX_RESPONSE_BYTES = 4 * 1024 * 1024;
+/**
+* 模型发现：配置面"拉取可用模型"动作的后端（对齐官方 discoverModels 语义）。
+*
+* 与官方的差异：本插件 route 不是内置目录 id，目录直答改为"provider 级
+* extends 的内置源目录直答"；其余（手写 route 仅 openai 系协议走
+* GET {baseURL}/models、4MB 上限、署名头）与官方一致。结果不落盘。
+* @module llm-pi/discovery
+*/
+const LISTABLE_PROTOCOLS = /* @__PURE__ */ new Set(["openai-completions", "openai-responses"]);
+const MAX_RESPONSE_BYTES = 4194304;
 /** 读取有界响应体：声明超长或累计超长都拒绝（对齐官方 readBounded）。 */
 async function readBounded(kit, response, url) {
 	const oversized = () => new kit.LlmError(`${url} 响应超过 ${MAX_RESPONSE_BYTES} 字节`, "DISCOVERY_FAILED");
@@ -428,8 +587,8 @@ function readListing(kit, body) {
 		const entry = raw;
 		if (typeof entry?.["id"] !== "string" || entry["id"].length === 0) continue;
 		const out = { id: entry["id"] };
-		const name$1 = entry["name"] ?? entry["display_name"];
-		if (typeof name$1 === "string" && name$1.length > 0) out.name = name$1;
+		const name = entry["name"] ?? entry["display_name"];
+		if (typeof name === "string" && name.length > 0) out.name = name;
 		for (const [key, field] of [
 			["context_window", "contextWindow"],
 			["context_length", "contextWindow"],
@@ -443,6 +602,19 @@ function readListing(kit, body) {
 	}
 	return models;
 }
+/** deepseek 路由直答：extends 'deepseek' 给官方目录全量；否则给 route 自配模型。 */
+function deepseekCatalogAnswer(kit, route) {
+	if (kit.deepseek === void 0) throw new kit.LlmError("当前运行时套件不含 dsh-llm-deepseek，无法读取官方目录", "DISCOVERY_FAILED");
+	if (route.extends === "deepseek") return officialModelIds(kit).map((id) => ({ id }));
+	const models = (route.models ?? []).map((entry) => ({
+		id: entry.id,
+		...entry.name === void 0 ? {} : { name: entry.name },
+		...entry.contextWindow === void 0 ? {} : { contextWindow: entry.contextWindow },
+		...entry.maxTokens === void 0 ? {} : { maxTokens: entry.maxTokens }
+	}));
+	if (models.length === 0) throw new kit.LlmError("该 route 未配置 models 且未 extends deepseek；请手工录入模型", "DISCOVERY_FAILED");
+	return models;
+}
 /** 内置目录直答（route 配了 provider 级 extends 时）。 */
 function catalogAnswer(kit, source) {
 	return builtinModelIds(kit, source).map((id) => {
@@ -456,19 +628,21 @@ function catalogAnswer(kit, source) {
 	});
 }
 /**
-* 回答"该 provider 可服务哪些模型"：extends 内置源零网络直答；
-* 否则仅 openai 系协议走 GET {baseURL}/models；其余协议明确不支持。
+* 回答"该 provider 可服务哪些模型"：deepseek 路由读官方目录/自有配置直答；
+* extends 内置源零网络直答；否则仅 openai 系协议走 GET {baseURL}/models；
+* 其余协议明确不支持。
 */
-async function discoverModels(request$2, deps) {
+async function discoverModels(request, deps) {
 	const { kit } = deps;
-	const route = request$2.provider === void 0 ? void 0 : deps.configProviders()[request$2.provider];
+	const route = request.provider === void 0 ? void 0 : deps.configProviders()[request.provider];
+	if ((route?.adapter ?? "pi") === "deepseek") return deepseekCatalogAnswer(kit, route);
 	if (route?.extends !== void 0 && hasBuiltinProvider(kit, route.extends)) return catalogAnswer(kit, route.extends);
-	const baseURL = request$2.baseURL ?? route?.baseURL;
-	if (baseURL === void 0 || baseURL.length === 0) throw new kit.LlmError(`route ${JSON.stringify(request$2.provider ?? "")} 未配 baseURL 且 extends 源无内置目录；无法探测模型清单`, "DISCOVERY_FAILED");
-	const api = request$2.api ?? route?.api ?? "openai-completions";
+	const baseURL = request.baseURL ?? route?.baseURL;
+	if (baseURL === void 0 || baseURL.length === 0) throw new kit.LlmError(`route ${JSON.stringify(request.provider ?? "")} 未配 baseURL 且 extends 源无内置目录；无法探测模型清单`, "DISCOVERY_FAILED");
+	const api = request.api ?? route?.api ?? "openai-completions";
 	if (!LISTABLE_PROTOCOLS.has(api)) throw new kit.LlmError(`协议 "${api}" 无可读取的模型清单端点；请手工录入模型`, "DISCOVERY_UNSUPPORTED");
 	const url = `${baseURL.replace(/\/+$/, "")}/models`;
-	const supplied = request$2.apiKey ?? await deps.storedApiKey(request$2.provider);
+	const supplied = request.apiKey ?? await deps.storedApiKey(request.provider);
 	let authorization;
 	if (supplied !== void 0) {
 		const checked = kit.normalizeApiKey(supplied);
@@ -484,10 +658,10 @@ async function discoverModels(request$2, deps) {
 				...authorization === void 0 ? {} : { authorization },
 				...kit.attributionHeaders()
 			},
-			...request$2.signal === void 0 ? {} : { signal: request$2.signal }
+			...request.signal === void 0 ? {} : { signal: request.signal }
 		});
 	} catch (error) {
-		if (request$2.signal?.aborted) throw new kit.LlmError("模型发现被调用方中止", "ABORTED", { cause: error });
+		if (request.signal?.aborted) throw new kit.LlmError("模型发现被调用方中止", "ABORTED", { cause: error });
 		throw new kit.LlmError(`无法连接 ${url}`, "DISCOVERY_FAILED", { cause: error });
 	}
 	if (!response.ok) throw new kit.LlmError(`${url} 返回 ${response.status}${response.status === 401 || response.status === 403 ? "；请检查 API key" : ""}`, "DISCOVERY_FAILED");
@@ -499,78 +673,71 @@ async function discoverModels(request$2, deps) {
 		throw new kit.LlmError(`${url} 未返回 JSON`, "DISCOVERY_FAILED", { cause: error });
 	}
 }
-
 //#endregion
 //#region src/compat.ts
-/** openai-completions 的 21 个字段（pi-ai OpenAICompletionsCompat）。 */
-const COMPLETIONS_FIELDS = {
-	supportsStore: "boolean",
-	supportsDeveloperRole: "boolean",
-	supportsReasoningEffort: "boolean",
-	supportsUsageInStreaming: "boolean",
-	maxTokensField: ["max_completion_tokens", "max_tokens"],
-	requiresToolResultName: "boolean",
-	requiresAssistantAfterToolResult: "boolean",
-	requiresThinkingAsText: "boolean",
-	requiresReasoningContentOnAssistantMessages: "boolean",
-	thinkingFormat: [
-		"openai",
-		"openrouter",
-		"deepseek",
-		"together",
-		"zai",
-		"qwen",
-		"chat-template",
-		"qwen-chat-template",
-		"string-thinking",
-		"ant-ling"
-	],
-	chatTemplateKwargs: "object",
-	openRouterRouting: "object",
-	vercelGatewayRouting: "object",
-	zaiToolStream: "boolean",
-	supportsOpenAIGrammarTools: "boolean",
-	supportsStrictMode: "boolean",
-	cacheControlFormat: ["anthropic"],
-	sendSessionAffinityHeaders: "boolean",
-	deferredToolsMode: ["kimi"],
-	sessionAffinityFormat: [
-		"openai",
-		"openai-nosession",
-		"openrouter"
-	],
-	supportsLongCacheRetention: "boolean"
-};
-/** openai-responses 的 7 个字段（pi-ai OpenAIResponsesCompat）。 */
-const RESPONSES_FIELDS = {
-	supportsDeveloperRole: "boolean",
-	sessionAffinityFormat: [
-		"openai",
-		"openai-nosession",
-		"openrouter"
-	],
-	supportsLongCacheRetention: "boolean",
-	supportsStrictMode: "boolean",
-	supportsOpenAIGrammarTools: "boolean",
-	supportsToolSearch: "boolean",
-	supportsExplicitPromptCacheMode: "boolean"
-};
-/** anthropic-messages 的 9 个字段（pi-ai AnthropicMessagesCompat）。 */
-const ANTHROPIC_FIELDS = {
-	supportsEagerToolInputStreaming: "boolean",
-	supportsLongCacheRetention: "boolean",
-	sendSessionAffinityHeaders: "boolean",
-	supportsCacheControlOnTools: "boolean",
-	supportsTemperature: "boolean",
-	forceAdaptiveThinking: "boolean",
-	allowEmptySignature: "boolean",
-	supportsStrictTools: "boolean",
-	supportsToolReferences: "boolean"
-};
 const FIELDS_BY_PROTOCOL = {
-	"openai-completions": COMPLETIONS_FIELDS,
-	"openai-responses": RESPONSES_FIELDS,
-	"anthropic-messages": ANTHROPIC_FIELDS
+	"openai-completions": {
+		supportsStore: "boolean",
+		supportsDeveloperRole: "boolean",
+		supportsReasoningEffort: "boolean",
+		supportsUsageInStreaming: "boolean",
+		maxTokensField: ["max_completion_tokens", "max_tokens"],
+		requiresToolResultName: "boolean",
+		requiresAssistantAfterToolResult: "boolean",
+		requiresThinkingAsText: "boolean",
+		requiresReasoningContentOnAssistantMessages: "boolean",
+		thinkingFormat: [
+			"openai",
+			"openrouter",
+			"deepseek",
+			"together",
+			"zai",
+			"qwen",
+			"chat-template",
+			"qwen-chat-template",
+			"string-thinking",
+			"ant-ling"
+		],
+		chatTemplateKwargs: "object",
+		openRouterRouting: "object",
+		vercelGatewayRouting: "object",
+		zaiToolStream: "boolean",
+		supportsOpenAIGrammarTools: "boolean",
+		supportsStrictMode: "boolean",
+		cacheControlFormat: ["anthropic"],
+		sendSessionAffinityHeaders: "boolean",
+		deferredToolsMode: ["kimi"],
+		sessionAffinityFormat: [
+			"openai",
+			"openai-nosession",
+			"openrouter"
+		],
+		supportsLongCacheRetention: "boolean"
+	},
+	"openai-responses": {
+		supportsDeveloperRole: "boolean",
+		sessionAffinityFormat: [
+			"openai",
+			"openai-nosession",
+			"openrouter"
+		],
+		supportsLongCacheRetention: "boolean",
+		supportsStrictMode: "boolean",
+		supportsOpenAIGrammarTools: "boolean",
+		supportsToolSearch: "boolean",
+		supportsExplicitPromptCacheMode: "boolean"
+	},
+	"anthropic-messages": {
+		supportsEagerToolInputStreaming: "boolean",
+		supportsLongCacheRetention: "boolean",
+		sendSessionAffinityHeaders: "boolean",
+		supportsCacheControlOnTools: "boolean",
+		supportsTemperature: "boolean",
+		forceAdaptiveThinking: "boolean",
+		allowEmptySignature: "boolean",
+		supportsStrictTools: "boolean",
+		supportsToolReferences: "boolean"
+	}
 };
 function checkValue(_api, field, spec, value, where) {
 	if (spec === "boolean") {
@@ -610,7 +777,6 @@ function mergeCompat(...layers) {
 	}
 	return Object.keys(merged).length > 0 ? merged : void 0;
 }
-
 //#endregion
 //#region src/inherit.ts
 var ExtendsError = class extends Error {};
@@ -663,9 +829,181 @@ function resolveModelBase(route, profile, entry, kit, modelsDev) {
 	if (hit === void 0) throw new ExtendsError(`${where}: extends 引用 "${provider}/${ref.model}" 在内置目录与 models.dev 快照中都不存在`);
 	return hit;
 }
-
+//#endregion
+//#region src/profiles-deepseek.ts
+/** 报告不可服务的 route，命名出错配置键（与 profiles.ts 的 invalid 同格式）。 */
+function invalid$1(provider, detail) {
+	throw new Error(`llm-pi: provider "${provider}" ${detail}`);
+}
+/** pi 专有字段在 deepseek 路由上显式拒绝（静默忽略会让用户误以为生效）。 */
+const PI_ONLY_FIELDS = [
+	"api",
+	"compat",
+	"headers",
+	"transport",
+	"websocketConnectTimeoutMs",
+	"thinkingBudgets",
+	"cacheRetention",
+	"reasoning",
+	"defaultInput",
+	"maxRequestImageBytes",
+	"timeoutMs"
+];
+/** schema 解析会把 dict 字段物化为 {}（schemastery 行为）；空字典视为未配置。 */
+function nonEmptyDict(value) {
+	return typeof value === "object" && value !== null && Object.keys(value).length > 0;
+}
+/** defaultInput 的 schema 物化默认（['text']）；显式写同值无害，同样视为未配置。 */
+function isMaterializedDefaultInput(value) {
+	return Array.isArray(value) && value.length === 1 && value[0] === "text";
+}
+function rejectPiOnlyFields(route, profile) {
+	for (const field of PI_ONLY_FIELDS) {
+		const value = profile[field];
+		if (value === void 0) continue;
+		if (field === "compat" || field === "headers" || field === "thinkingBudgets") {
+			if (!nonEmptyDict(value)) continue;
+		} else if (field === "defaultInput" && isMaterializedDefaultInput(value)) continue;
+		invalid$1(route, `的 ${field} 仅 adapter: pi 可用；adapter: deepseek 的 route 请移除该字段`);
+	}
+}
+/** 解析模型条目的官方目录继承 base；extends 仅允许裸 id 或 "deepseek/id"。 */
+function resolveOfficialBase(route, entry, deps) {
+	const ref = entry.extends;
+	if (ref !== void 0) {
+		const slash = ref.indexOf("/");
+		const source = slash < 0 ? "deepseek" : ref.slice(0, slash);
+		const id = slash < 0 ? ref : ref.slice(slash + 1);
+		if (source !== "deepseek" || id.length === 0 || id.includes("/")) invalid$1(route, `model "${entry.id}" 的 extends 引用 ${JSON.stringify(ref)} 非法：adapter: deepseek 的路由仅支持 "deepseek/model" 或裸 model id（官方目录）`);
+		const base = officialModelBase(deps.kit, id);
+		if (base === void 0) {
+			if (deps.lenient) {
+				deps.warn?.(`llm-pi: provider "${route}" model "${entry.id}" 的 extends 引用 "${ref}" 在当前官方目录未命中；已降级为手写条目`);
+				return {};
+			}
+			invalid$1(route, `model "${entry.id}" 的 extends 引用 "${ref}" 在官方目录中不存在`);
+		}
+		return base;
+	}
+	return officialModelBase(deps.kit, entry.id) ?? {};
+}
+/** 条目的声明模态；schema 物化的空数组视为"无答案"，交官方继承 base（同 profiles.ts declaredInput）。 */
+function declaredModalities(configured) {
+	return configured === void 0 || configured.length === 0 ? void 0 : [...configured];
+}
+/** 物化单个模型目录条目：官方 base 在下，条目显式字段逐字段覆盖。 */
+function materializeModel$1(route, entry, deps) {
+	if (entry.reasoningEfforts !== void 0 || nonEmptyDict(entry.compat)) invalid$1(route, `model "${entry.id}" 的 reasoningEfforts/compat 仅 adapter: pi 可用`);
+	const base = resolveOfficialBase(route, entry, deps);
+	const input = declaredModalities(entry.input) ?? base.input;
+	const imageFields = {
+		imagePixelBudget: entry.imagePixelBudget ?? base.imagePixelBudget,
+		imageMaxBytes: entry.imageMaxBytes ?? base.imageMaxBytes,
+		imageDetail: entry.imageDetail ?? base.imageDetail
+	};
+	if (!(input?.includes("image") ?? false) && Object.values(imageFields).some((value) => value !== void 0)) invalid$1(route, `model "${entry.id}" 未声明 image 模态，不可配置 imagePixelBudget/imageMaxBytes/imageDetail`);
+	return {
+		id: entry.id,
+		...(entry.name ?? base.name) === void 0 ? {} : { name: entry.name ?? base.name },
+		...(entry.contextWindow ?? base.contextWindow) === void 0 ? {} : { contextWindow: entry.contextWindow ?? base.contextWindow },
+		...(entry.maxTokens ?? base.maxTokens) === void 0 ? {} : { maxTokens: entry.maxTokens ?? base.maxTokens },
+		...input === void 0 ? {} : { inputModalities: [...input] },
+		...Object.fromEntries(Object.entries(imageFields).filter(([, value]) => value !== void 0))
+	};
+}
+/** 物化一个 route 的模型目录；models 缺省时以官方目录全量继承（要求 extends: 'deepseek'）。 */
+function materializeModels(route, profile, deps) {
+	if (profile.models !== void 0 && profile.models.length > 0) {
+		const seen = /* @__PURE__ */ new Set();
+		return profile.models.map((entry) => {
+			if (entry.id.length === 0) invalid$1(route, "存在空 id 的模型条目");
+			if (seen.has(entry.id)) invalid$1(route, `模型 "${entry.id}" 重复列出`);
+			seen.add(entry.id);
+			return materializeModel$1(route, entry, deps);
+		});
+	}
+	if (profile.extends === "deepseek") return officialModelIds(deps.kit).map((id) => materializeModel$1(route, { id }, deps));
+	invalid$1(route, "未配置 models；adapter: deepseek 的 route 可配 extends: deepseek 全量继承官方目录");
+}
+/** 组装官方 resolveAdapterOptions 的输入：仅放入显式配置的键，其余走官方默认值。 */
+function rawAdapterConfig(profile, baseURL, models) {
+	const passthrough = [
+		"apiKeyEnv",
+		"thinking",
+		"reasoningEffort",
+		"streamIdleTimeoutMs",
+		"maxRequestFilesBytes",
+		"maxInlineRequestImageBytes",
+		"maxImagesPerRequest",
+		"imageOffloadByteQuantum",
+		"inlineImageOffloadByteQuantum",
+		"imageOffloadCountQuantum",
+		"filesApiTimeoutMs",
+		"fileExpiresAfterSeconds",
+		"fileRefreshMarginSeconds",
+		"retryPolicy"
+	];
+	const raw = {
+		baseURL,
+		models
+	};
+	for (const key of passthrough) if (profile[key] !== void 0) raw[key] = profile[key];
+	if (profile.defaultMaxTokens !== void 0) raw["maxTokens"] = profile.defaultMaxTokens;
+	if (profile.defaultContextWindow !== void 0) raw["defaultContextWindow"] = profile.defaultContextWindow;
+	return raw;
+}
+/** 物化单个 deepseek route；lenient 下失败告警并返回 null（调用方跳过注册）。 */
+function buildRoute(route, profile, deps) {
+	try {
+		if (deps.kit.deepseek === void 0) invalid$1(route, "使用 adapter: deepseek，但当前运行时套件不含 dsh-llm-deepseek（需 dsh ≥ 0.1.1-rc.2）");
+		rejectPiOnlyFields(route, profile);
+		if (profile.extends !== void 0 && profile.extends !== "deepseek") invalid$1(route, `的 extends ${JSON.stringify(profile.extends)} 非法：adapter: deepseek 仅支持 "deepseek"（官方目录）`);
+		if (profile.apiKeyEnv === void 0 || profile.apiKeyEnv.length === 0) invalid$1(route, "需要 apiKeyEnv：DeepSeekAdapter 无环境自发现，凭据引用必须显式配置");
+		const baseURL = profile.baseURL ?? (profile.extends === "deepseek" ? officialBaseUrl(deps.kit) : void 0);
+		if (baseURL === void 0 || baseURL.length === 0) invalid$1(route, "需要 baseURL（或 extends: deepseek 继承官方端点）");
+		const models = materializeModels(route, profile, deps);
+		const connection = deps.kit.deepseek.resolveAdapterOptions(rawAdapterConfig(profile, baseURL, models), void 0);
+		return {
+			route,
+			displayName: profile.displayName ?? route,
+			connection
+		};
+	} catch (error) {
+		if (!deps.lenient) throw error;
+		deps.warn?.(`llm-pi: deepseek route "${route}" 不可服务（${error instanceof Error ? error.message : String(error)}），已跳过注册`);
+		return null;
+	}
+}
+/**
+* 校验并物化全部 adapter: deepseek 的 route。严格模式任一 route 失败即整体
+* 抛错（settings 写入校验），lenient 模式跳过坏 route（运行期热更新）。
+*/
+function buildDeepseekRoutes(providers, deps) {
+	const resolved = /* @__PURE__ */ new Map();
+	for (const [route, profile] of Object.entries(providers ?? {})) {
+		if ((profile.adapter ?? "pi") !== "deepseek") continue;
+		if (route.length === 0) throw new Error("llm-pi: provider 名不能为空");
+		if (profile.displayName !== void 0 && profile.displayName.length === 0) invalid$1(route, "displayName 为空");
+		const built = buildRoute(route, profile, deps);
+		if (built !== null) resolved.set(route, built);
+	}
+	return resolved;
+}
 //#endregion
 //#region src/profiles.ts
+/**
+* profile 构建器：插件 Config → ResolvedPiAiProviderProfile 映射。
+*
+* 语义与官方 dsh-llm-pi-ai 的 resolveProfiles 链逐点对齐（index.js:1068-1471），
+* 差异仅在两点扩展：
+* - base 来源从"route 同名内置目录"换为 extends 三级数据源（inherit.ts）；
+* - compat 从 2 字段枚举扩展为逐协议全量字段（compat.ts），写入即校验。
+*
+* 产物经 `new PiAiAdapter({ profiles })` 进入官方消息链路；
+* 任何不可服务的配置在此处抛错（命名 route/model），配合 settings 写入校验，
+* 非法配置在写入时被拒绝、运行期保留上一份好配置。
+* @module llm-pi/profiles
+*/
 /** 内置目录未描述时的零价目（harness 不消费 cost 元数据，同官方 NO_COST）。 */
 const NO_COST = {
 	input: 0,
@@ -717,12 +1055,12 @@ function resolveModelReasoning(provider, entry, base) {
 	};
 }
 /** Harness 自管凭据的 api-key auth（对齐官方 harnessApiKeyAuth，index.js:1215）。 */
-function harnessApiKeyAuth(name$1) {
+function harnessApiKeyAuth(name) {
 	return {
-		name: name$1,
+		name,
 		resolve: ({ credential }) => Promise.resolve({
 			auth: credential?.key === void 0 ? {} : { apiKey: credential.key },
-			source: name$1
+			source: name
 		})
 	};
 }
@@ -744,8 +1082,8 @@ function materializeModel(route, profile, entry, base, routeApi, providerBaseUrl
 		}
 		invalid(route, `model "${entry.id}" 需要 baseURL：继承源未提供，请在 route 上设置 baseURL`);
 	}
-	const contextWindow = entry.contextWindow ?? base.contextWindow ?? profile.defaultContextWindow ?? DEFAULT_CONTEXT_WINDOW;
-	const maxTokens = entry.maxTokens ?? base.maxTokens ?? profile.defaultMaxTokens ?? DEFAULT_MAX_TOKENS;
+	const contextWindow = entry.contextWindow ?? base.contextWindow ?? profile.defaultContextWindow ?? 262144;
+	const maxTokens = entry.maxTokens ?? base.maxTokens ?? profile.defaultMaxTokens ?? 32768;
 	if (entry.maxTokens !== void 0) configuredMaxTokens.set(entry.id, entry.maxTokens);
 	validateCompat(api, profile.compat, `provider "${route}"`);
 	validateCompat(api, entry.compat, `provider "${route}" model "${entry.id}"`);
@@ -823,10 +1161,11 @@ function materializeRouteModels(route, profile, deps, defaultInput) {
 function buildProfiles(providers, deps) {
 	const resolved = /* @__PURE__ */ new Map();
 	for (const [route, profile] of Object.entries(providers ?? {})) {
+		if ((profile.adapter ?? "pi") === "deepseek") continue;
 		if (route.length === 0) throw new Error("llm-pi: provider 名不能为空");
 		if (profile.baseURL !== void 0 && profile.baseURL.length === 0) invalid(route, "baseURL 为空");
 		if (profile.displayName !== void 0 && profile.displayName.length === 0) invalid(route, "displayName 为空");
-		const streamIdleTimeoutMs = profile.streamIdleTimeoutMs ?? DEFAULT_STREAM_IDLE_TIMEOUT_MS;
+		const streamIdleTimeoutMs = profile.streamIdleTimeoutMs ?? 3e5;
 		if (!Number.isFinite(streamIdleTimeoutMs) || streamIdleTimeoutMs <= 0 || streamIdleTimeoutMs > MAX_TIMER_DELAY_MS) invalid(route, `streamIdleTimeoutMs 必须是 (0, ${MAX_TIMER_DELAY_MS}] 内的有限数`);
 		const defaultInput = [...profile.defaultInput ?? ["text"]];
 		if (defaultInput.length === 0) invalid(route, "defaultInput 至少要声明一种模态");
@@ -850,7 +1189,7 @@ function buildProfiles(providers, deps) {
 			displayName,
 			...profile.apiKeyEnv === void 0 ? {} : { apiKeyEnv: credentialRef(profile.apiKeyEnv) },
 			streamIdleTimeoutMs,
-			maxRequestImageBytes: profile.maxRequestImageBytes ?? DEFAULT_MAX_REQUEST_IMAGE_BYTES,
+			maxRequestImageBytes: profile.maxRequestImageBytes ?? 20971520,
 			retryPolicy: deps.kit.resolveRetryPolicy(profile.retryPolicy, `llm-pi: provider "${route}" retryPolicy`),
 			...profile.headers === void 0 ? {} : { headers: { ...profile.headers } },
 			...profile.reasoning === void 0 ? {} : { reasoning: profile.reasoning },
@@ -868,10 +1207,25 @@ function buildProfiles(providers, deps) {
 /** settings 写入校验钩子：完整试跑解析，非法配置在写入处拒绝。 */
 function assertServiceable(config, deps) {
 	buildProfiles(config.providers, deps);
+	buildDeepseekRoutes(config.providers, deps);
 }
-
 //#endregion
 //#region src/resolve-dsh.ts
+/**
+* dsh 运行时套件解析：让插件跑在 dsh 当前安装树的同一份
+* dsh-llm-pi-ai / dsh-llm / pi-ai 之上，从而 dsh 升级即自动跟随上游。
+*
+* 解析策略（全部模块同源地整体成功或整体回退，杜绝跨源混用）：
+* 1. dsh-tree：从 process.argv[1]（systemd/CLI 启动的 dsh 即 bin.js  shim，
+*    realpath 后落在 dsh 安装树内）向上找到同时含有
+*    node_modules/@deepseek-ai/dsh-llm-pi-ai 与 node_modules/@earendil-works/pi-ai
+*    的目录，按文件路径动态 import——与 dsh 官方插件共享同一模块实例；
+* 2. vendored：回退到本插件 dependencies 里的固定版本副本（裸 import）。
+*
+* 两条路径产物都过形状自检（assertKitShape）：上游 rc 重构导致形状漂移时
+* 抛错，由调用方决定回退或放弃注册——绝不让坏套件进入消息链路。
+* @module llm-pi/resolve-dsh
+*/
 /** kit 必备形状清单：缺失即视为上游不兼容。 */
 function assertKitShape(kit, origin) {
 	const problems = [];
@@ -891,6 +1245,15 @@ function assertKitShape(kit, origin) {
 	if (typeof kit.resolveRetryPolicy !== "function") problems.push("dsh-llm resolveRetryPolicy 缺失");
 	if (problems.length > 0) throw new Error(`llm-pi: ${origin} 来源的运行时套件形状不兼容：${problems.join("；")}`);
 }
+/** deepseek 模块形状自检；返回问题清单（空 = 可用），由调用方决定降级。 */
+function checkDeepseekShape(kit) {
+	const problems = [];
+	if (typeof kit.DeepSeekAdapter !== "function") problems.push("DeepSeekAdapter 不是类");
+	else if (typeof kit.DeepSeekAdapter.prototype["stream"] !== "function") problems.push("DeepSeekAdapter.prototype.stream 缺失");
+	if (typeof kit.resolveAdapterOptions !== "function") problems.push("resolveAdapterOptions 缺失");
+	if (typeof kit.getOrCreateAnonymousUserId !== "function") problems.push("getOrCreateAnonymousUserId 缺失");
+	return problems;
+}
 /** 从 startDir 向上找同时含有 dsh-llm-pi-ai 与 pi-ai 的安装树根。 */
 function findDshTreeRoot(startDir) {
 	let dir = startDir;
@@ -925,6 +1288,24 @@ async function importTreeModules(root) {
 		anthropic
 	};
 }
+/** 从同一 dsh 安装树加载 deepseek 适配器模块（失败返回 undefined，不拖垮核心套件）。 */
+async function importTreeDeepseek(root) {
+	const nm = join(root, "node_modules");
+	const load = (absPath) => import(pathToFileURL(absPath).href);
+	try {
+		const [deepseek, anonId] = await Promise.all([load(join(nm, "@deepseek-ai", "dsh-llm-deepseek", "lib", "index.js")), load(join(nm, "@deepseek-ai", "dsh-anonymous-user-id", "lib", "index.js"))]);
+		const kit = {
+			DeepSeekAdapter: deepseek["DeepSeekAdapter"],
+			resolveAdapterOptions: deepseek["resolveAdapterOptions"],
+			getOrCreateAnonymousUserId: anonId["getOrCreateAnonymousUserId"]
+		};
+		const problems = checkDeepseekShape(kit);
+		if (problems.length > 0) return { problem: `形状不兼容：${problems.join("；")}` };
+		return { kit };
+	} catch (error) {
+		return { problem: error instanceof Error ? error.message : String(error) };
+	}
+}
 function kitFromTree(mods) {
 	return {
 		source: "dsh-tree",
@@ -946,8 +1327,18 @@ function kitFromTree(mods) {
 		}
 	};
 }
+/** vendored 兜底副本的 deepseek 模块（形状自检不过时返回 undefined）。 */
+function loadVendoredDeepseek() {
+	const kit = {
+		DeepSeekAdapter: vendoredDeepseek.DeepSeekAdapter,
+		resolveAdapterOptions: vendoredDeepseek.resolveAdapterOptions,
+		getOrCreateAnonymousUserId: vendoredAnonId.getOrCreateAnonymousUserId
+	};
+	return checkDeepseekShape(kit).length === 0 ? kit : void 0;
+}
 /** vendored 兜底副本套件（导出供单测直接使用，免走 dsh 树解析）。 */
 function loadVendoredKit() {
+	const deepseek = loadVendoredDeepseek();
 	const kit = {
 		source: "vendored",
 		PiAiAdapter: vendoredPiAiAdapter.PiAiAdapter,
@@ -965,7 +1356,8 @@ function loadVendoredKit() {
 			"openai-completions": openAICompletionsApi,
 			"openai-responses": openAIResponsesApi,
 			"anthropic-messages": anthropicMessagesApi
-		}
+		},
+		...deepseek === void 0 ? {} : { deepseek }
 	};
 	assertKitShape(kit, "vendored");
 	return kit;
@@ -991,6 +1383,15 @@ async function resolveDshKit() {
 	if (anchor !== void 0) try {
 		const kit = kitFromTree(await importTreeModules(anchor));
 		assertKitShape(kit, "dsh-tree");
+		const tree = await importTreeDeepseek(anchor);
+		if (tree.kit !== void 0) return {
+			kit: {
+				...kit,
+				deepseek: tree.kit
+			},
+			diagnostics
+		};
+		diagnostics.push(`dsh 安装树的 dsh-llm-deepseek 不可用（${tree.problem ?? "未知原因"}）；adapter: deepseek 的 route 不可用，pi 路由不受影响`);
 		return {
 			kit,
 			diagnostics
@@ -999,12 +1400,13 @@ async function resolveDshKit() {
 		diagnostics.push(`dsh 安装树套件不可用（${anchor}）：${error instanceof Error ? error.message : String(error)}；回退 vendored 副本`);
 	}
 	else diagnostics.push("未能从 process.argv[1] 定位 dsh 安装树；回退 vendored 副本");
+	const kit = loadVendoredKit();
+	if (kit.deepseek === void 0) diagnostics.push("vendored 副本的 dsh-llm-deepseek 形状不兼容；adapter: deepseek 的 route 不可用");
 	return {
-		kit: loadVendoredKit(),
+		kit,
 		diagnostics
 	};
 }
-
 //#endregion
 //#region src/service.ts
 /** 注册时捕获的事实表；变化才重注册（按 provider 排序，免序误报）。 */
@@ -1038,6 +1440,7 @@ async function startRuntime(ctx, rawConfig) {
 	let current = () => config;
 	let lastRaw;
 	let memoized;
+	let memoizedDeepseek;
 	const deps = {
 		kit,
 		modelsDev
@@ -1052,10 +1455,20 @@ async function startRuntime(ctx, rawConfig) {
 			lenient: true,
 			warn: (message) => logger.warn(message)
 		}) : /* @__PURE__ */ new Map();
+		memoizedDeepseek = raw.enabled ? buildDeepseekRoutes(raw.providers, {
+			kit,
+			lenient: true,
+			warn: (message) => logger.warn(message)
+		}) : /* @__PURE__ */ new Map();
 		lastRaw = raw;
 		memoized = next;
 		return next;
 	};
+	/** deepseek 路由物化表（与 profiles 同一次备忘窗口）。 */
+	const deepseekRoutes = () => {
+		profiles();
+		return memoizedDeepseek ?? /* @__PURE__ */ new Map();
+	};
 	profiles();
 	const adapter = new kit.PiAiAdapter({
 		profiles,
@@ -1068,7 +1481,7 @@ async function startRuntime(ctx, rawConfig) {
 		if (profile === void 0) return void 0;
 		return makeResolveApiKey(ctx, kit)(provider, profile);
 	};
-	ctx.llm.registerModelDiscovery(SETTINGS_NS, (request$2) => discoverModels(request$2, {
+	ctx.llm.registerModelDiscovery(SETTINGS_NS, (request) => discoverModels(request, {
 		kit,
 		configProviders: () => current().providers ?? {},
 		storedApiKey
@@ -1129,13 +1542,21 @@ async function startRuntime(ctx, rawConfig) {
 	let directory;
 	let directoryFacts;
 	const ensureDirectory = () => {
-		const entries = [...profiles().entries()].map(([provider, profile]) => ({
+		const piEntries = [...profiles().entries()].map(([provider, profile]) => ({
 			provider,
 			displayName: profile.displayName,
 			settingsNs: SETTINGS_NS,
 			settingsPath: ["providers", provider],
 			declared: !hasBuiltinProvider(kit, provider)
 		}));
+		const deepseekEntries = [...deepseekRoutes().values()].map((built) => ({
+			provider: built.route,
+			displayName: built.displayName,
+			settingsNs: SETTINGS_NS,
+			settingsPath: ["providers", built.route],
+			declared: true
+		}));
+		const entries = [...piEntries, ...deepseekEntries];
 		if (deepEqualJson(entries, directoryFacts)) return;
 		if (entries.length === 0) {
 			directoryFacts = entries;
@@ -1145,7 +1566,18 @@ async function startRuntime(ctx, rawConfig) {
 		else directory.replace(entries);
 		directoryFacts = entries;
 	};
+	const deepseekRegistrar = new DeepseekRouteRegistrar({
+		ctx,
+		kit,
+		logger: {
+			warn: (m) => logger.warn(m),
+			error: (m) => logger.error(m)
+		},
+		routes: deepseekRoutes
+	});
+	const ensureDeepseek = () => deepseekRegistrar.sync(deepseekRoutes());
 	ensureRegistration();
+	ensureDeepseek();
 	ensureDirectory();
 	installSettingsSection(ctx, SETTINGS_NS, Config, config, {
 		validate: (cfg) => assertServiceable(cfg, deps),
@@ -1159,6 +1591,12 @@ async function startRuntime(ctx, rawConfig) {
 				logger.error("llm-pi: 更新被拒，保留此前注册的 route");
 				logger.error(error);
 			}
+			try {
+				ensureDeepseek();
+			} catch (error) {
+				logger.error("llm-pi: deepseek route 更新失败，保留此前注册");
+				logger.error(error);
+			}
 			try {
 				ensureDirectory();
 			} catch (error) {
@@ -1179,7 +1617,6 @@ async function startRuntime(ctx, rawConfig) {
 		kit
 	};
 }
-
 //#endregion
 //#region src/index.ts
 const name = "dsh-plus-llm-pi";
@@ -1190,6 +1627,5 @@ async function apply(ctx, config) {
 		registerCatalogApi(webCtx, runtime);
 	});
 }
-
 //#endregion
-export { Config, SETTINGS_NS, apply, inject, name };
+export { Config, SETTINGS_NS, apply, inject, name };