dsh-model-reasoning-defaults 0.0.1

package/lib/index.mjs

@@ -0,0 +1,566 @@
+import { ReasoningEffortId, isAgentLoopRequest } from "@deepseek-ai/dsh-llm";
+import z from "@deepseek-ai/schemastery";
+//#region src/index.ts
+/** 插件名（同时作为 Cordis 插件 id）。 */
+const name = "dsh-model-reasoning-defaults";
+/** 声明依赖的服务：LLM 服务就绪后装配；注册/读取设置命名空间需要设置服务。 */
+const inject = ["llm", "settings"];
+const nonBlankPattern = /^\S+$/;
+const KNOWN_REASONING_EFFORTS = /* @__PURE__ */ new Set([
+	"off",
+	"minimal",
+	"low",
+	"medium",
+	"high",
+	"xhigh",
+	"max"
+]);
+const DEEPSEEK_OFFICIAL_PROVIDER_ID = "deepseek-official";
+const modelConfigSchema = z.object({
+	id: z.string().pattern(nonBlankPattern),
+	reasoningEffort: z.string().pattern(nonBlankPattern)
+});
+const modelEntrySchema = z.union([z.string().pattern(nonBlankPattern), modelConfigSchema]);
+const modelsFieldSchema = z.union([z.dict(modelEntrySchema, z.string().pattern(nonBlankPattern)), z.array(modelEntrySchema)]);
+const providerConfigSchema = z.object({
+	reasoningEffort: z.string().pattern(nonBlankPattern),
+	models: modelsFieldSchema
+});
+const providerEntrySchema = z.union([z.string().pattern(nonBlankPattern), providerConfigSchema]);
+/** Cordis 配置模式（显式注解接口类型，满足声明产物的可命名要求）。 */
+const Config = z.object({
+	defaults: z.dict(z.string().pattern(nonBlankPattern), z.string().pattern(nonBlankPattern)).default({}),
+	providers: z.dict(providerEntrySchema, z.string().pattern(nonBlankPattern)).default({}),
+	models: modelsFieldSchema,
+	reasoningEffort: z.string().pattern(nonBlankPattern)
+});
+/**
+* 从字符串简写或配置对象中提取非空推理等级。
+*
+* 只认单一规范字段 reasoningEffort，不做多字段兜底链：同义多源读取会在字段
+* 冲突时按书写顺序静默裁决（例如 reasoningEffort 与 effort 同时配置时无声地
+* 二选一），掩盖配置错误；确需别名应由用户层显式映射后再传入。
+*
+* @param val - 等级字符串，或 ModelConfig/ProviderConfig 形状的对象。
+* @returns trim 后非空的等级字符串；无法提取时返回 undefined。
+*/
+function extractEffort(val) {
+	const candidate = typeof val === "string" ? val : typeof val === "object" && val !== null ? val.reasoningEffort : void 0;
+	if (typeof candidate !== "string") return void 0;
+	const trimmed = candidate.trim();
+	return trimmed.length > 0 ? trimmed : void 0;
+}
+/**
+* 将结构化 Config 归一化为统一的扁平路由字典。
+*
+* @param config - 插件配置对象。
+* @returns 归一化后的键值映射；键与值均已去除首尾空白。
+*/
+function normalizeConfig(config) {
+	const result = {};
+	const globalEffort = extractEffort(config.reasoningEffort);
+	if (globalEffort) result["*"] = globalEffort;
+	if (config.models) {
+		if (Array.isArray(config.models)) for (const item of config.models) {
+			const id = typeof item === "object" && item !== null && typeof item.id === "string" ? item.id.trim() : "";
+			if (id.length === 0) continue;
+			const effort = extractEffort(item);
+			if (effort) result["*:" + id] = effort;
+		}
+		else if (typeof config.models === "object") for (const [rawModelId, modelVal] of Object.entries(config.models)) {
+			const modelId = rawModelId.trim();
+			if (modelId.length === 0) continue;
+			const effort = extractEffort(modelVal);
+			if (effort) result["*:" + modelId] = effort;
+		}
+	}
+	if (config.providers && typeof config.providers === "object") for (const [rawProviderId, providerVal] of Object.entries(config.providers)) {
+		const providerId = rawProviderId.trim();
+		if (providerId.length === 0) continue;
+		const providerEffort = extractEffort(providerVal);
+		if (providerEffort) result[providerId + ":*"] = providerEffort;
+		if (typeof providerVal === "object" && providerVal !== null && providerVal.models) {
+			const models = providerVal.models;
+			if (Array.isArray(models)) for (const item of models) {
+				const id = typeof item === "object" && item !== null && typeof item.id === "string" ? item.id.trim() : "";
+				if (id.length === 0) continue;
+				const effort = extractEffort(item);
+				if (effort) result[providerId + ":" + id] = effort;
+			}
+			else if (typeof models === "object") for (const [rawModelId, modelVal] of Object.entries(models)) {
+				const modelId = rawModelId.trim();
+				if (modelId.length === 0) continue;
+				const effort = extractEffort(modelVal);
+				if (effort) result[providerId + ":" + modelId] = effort;
+			}
+		}
+	}
+	if (config.defaults && typeof config.defaults === "object") for (const [rawKey, value] of Object.entries(config.defaults)) {
+		const key = rawKey.trim();
+		const trimmedValue = value.trim();
+		if (key.length === 0 || trimmedValue.length === 0) continue;
+		result[key] = trimmedValue;
+	}
+	return result;
+}
+/**
+* 静态体检插件配置，返回人类可读的问题清单（纯函数，不修改任何数据）。
+*
+* schemastery 的对象属性全部可选且对未知键透传，"拼错字段""模型项缺 id"
+* 这类错误能通过校验却在 normalizeConfig 中被静默忽略；此清单在插件激活时
+* 一次性告警，把这类静默降级变成可见信息。等级值不在已知集合也在此提示，
+* 但仍会注入——最终是否可用交给适配器逐字匹配裁决。
+*
+* @param config - 用户原始配置（未经归一化）。
+* @returns 问题描述列表；无问题时为空数组。
+*/
+function collectConfigIssues(config) {
+	const issues = [];
+	const knownLevels = [...KNOWN_REASONING_EFFORTS].join("/");
+	const checkLevel = (route, level) => {
+		if (level !== void 0 && !KNOWN_REASONING_EFFORTS.has(level)) issues.push("路由 " + route + " 的推理等级 \"" + level + "\" 不在已知集合 (" + knownLevels + ") 内，请确认目标模型支持");
+	};
+	/**
+	* 检查单个模型条目：字符串简写直接校验等级；
+	* 对象形式要求携带有效等级，数组元素还要求有效 id。
+	*/
+	const checkModelEntry = (route, entry, requireId) => {
+		if (typeof entry === "string") {
+			if (requireId) {
+				issues.push("数组形式模型条目缺少有效 id（字符串简写无键名可用），已被忽略：" + JSON.stringify(entry));
+				return;
+			}
+			checkLevel(route, extractEffort(entry));
+			return;
+		}
+		const id = typeof entry.id === "string" ? entry.id.trim() : "";
+		if (requireId && id.length === 0) {
+			issues.push("模型条目缺少有效 id，已被忽略：" + JSON.stringify(entry));
+			return;
+		}
+		const effort = extractEffort(entry);
+		if (effort === void 0) {
+			issues.push("模型条目未包含 reasoningEffort，已被忽略：" + JSON.stringify(entry));
+			return;
+		}
+		checkLevel(route, effort);
+	};
+	checkLevel("*", extractEffort(config.reasoningEffort));
+	if (config.models) {
+		if (Array.isArray(config.models)) config.models.forEach((entry, index) => {
+			checkModelEntry("*:<models[" + index + "]>", entry, true);
+		});
+		else if (typeof config.models === "object") for (const [modelId, entry] of Object.entries(config.models)) checkModelEntry("*:" + modelId, entry, false);
+	}
+	if (config.providers && typeof config.providers === "object") for (const [providerId, providerVal] of Object.entries(config.providers)) {
+		if (typeof providerVal === "string") {
+			checkLevel(providerId + ":*", extractEffort(providerVal));
+			continue;
+		}
+		const hasModels = providerVal.models !== void 0;
+		const providerEffort = extractEffort(providerVal);
+		if (!hasModels && providerEffort === void 0) {
+			issues.push("provider " + providerId + " 未包含 reasoningEffort 或 models，整条配置已被忽略");
+			continue;
+		}
+		checkLevel(providerId + ":*", providerEffort);
+		if (hasModels) {
+			const models = providerVal.models;
+			if (Array.isArray(models)) models.forEach((entry, index) => {
+				checkModelEntry(providerId + ":<models[" + index + "]>", entry, true);
+			});
+			else if (typeof models === "object") for (const [modelId, entry] of Object.entries(models)) checkModelEntry(providerId + ":" + modelId, entry, false);
+		}
+	}
+	if (config.defaults && typeof config.defaults === "object") for (const [rawKey, value] of Object.entries(config.defaults)) {
+		const key = rawKey.trim();
+		if (key.length === 0) {
+			issues.push("扁平路由键为空白，已被忽略：" + JSON.stringify(rawKey));
+			continue;
+		}
+		checkLevel(key, extractEffort(value));
+	}
+	return issues;
+}
+/**
+* 注册全局 agent/request waterfall。
+*
+* cordis 的 ctx.on 内部会把监听器注册为当前 fiber 上的 effect（见 events
+* 服务的 register()），无论 global 标志如何都会在 fiber 卸载时自动清理；
+* global 只影响事件派发时的上下文过滤。因此无需再包一层 ctx.effect。
+*
+* 该事件的运行时接收者是 Scoped<Agent>，Cordis 根 Context 的事件泛型表不会
+* 暴露它，因此在最小边界内窄化签名（仅约束本插件用到的事件名与参数）。
+*
+* @param ctx - 当前插件上下文。
+* @param listener - agent/request waterfall 监听器。
+*/
+function registerAgentRequestListener(ctx, listener) {
+	ctx.on.bind(ctx)("agent/request", listener, { global: true });
+}
+/**
+* 生成一个路由的候选配置键。
+*
+* 兼容键保留在明确的优先级表中，避免不同调用入口各自实现一套匹配规则。
+*
+* @param provider - 请求使用的 provider。
+* @param model - 请求使用的 model。
+* @returns 按匹配优先级排列的候选键。
+*/
+function candidateKeys(provider, model) {
+	return [
+		provider + ":" + model,
+		provider + ":*",
+		provider + "/*",
+		provider,
+		"*:" + model,
+		"*"
+	];
+}
+/**
+* 查找一个路由对应的默认推理等级。
+*
+* @param defaults - 归一化后的扁平路由映射。
+* @param provider - 请求使用的 provider。
+* @param model - 请求使用的 model。
+* @returns 找到的非空推理等级，未找到时返回 undefined。
+*/
+function lookupEffort(defaults, provider, model) {
+	for (const key of candidateKeys(provider, model)) {
+		const effort = defaults[key];
+		if (typeof effort === "string" && effort.length > 0) return effort;
+	}
+}
+/**
+* 在不修改原对象的前提下应用默认推理等级。
+*
+* 该函数同时用于 GenerateOptions 和 LlmCallConfig，因此调用方可以保留
+* 原请求对象中的 messages、signal 等其它字段，并安全处理深冻结输入。
+*
+* 第二参数只接受归一化后的扁平路由表；结构化 Config 必须先经 normalizeConfig。
+* 曾尝试用对象形状嗅探让本函数同时接纳两种入参，但路由表允许任意非空白键，
+* 含 "models"/"providers" 等键的路由表会被误判成结构化配置（整表归一化为空、
+* 注入全部失效），反之仅含顶层 reasoningEffort 的最小结构化配置又会漏判——
+* 两类误判都是静默失效，因此彻底拆掉形状嗅探。
+*
+* @param config - 待补齐的 LLM 请求或调用配置。
+* @param defaults - normalizeConfig 产出的扁平路由表。
+* @returns 原配置或带有 reasoningEffort 的浅复制对象。
+*/
+function applyDefaultReasoningEffort(config, defaults) {
+	if (config.reasoningEffort !== void 0 || !config.provider || !config.model) return config;
+	const effort = lookupEffort(defaults, config.provider, config.model);
+	if (effort === void 0) return config;
+	return {
+		...config,
+		reasoningEffort: ReasoningEffortId(effort)
+	};
+}
+/**
+* 设置页 UI 专用命名空间。该命名空间由本插件注册为可写设置项，浏览器设置
+* 面板通过宿主统一的 settings API 编辑它；生效优先级位于自动提取之上、
+* cordis 插件配置之下（见 resolveEffectiveDefaults）。
+*/
+const UI_DEFAULTS_NAMESPACE = "model-reasoning-defaults";
+const uiDefaultsSectionSchema = z.object({ defaults: z.dict(z.string().pattern(nonBlankPattern), z.string().pattern(nonBlankPattern)).default({}) });
+/**
+* 取当前上下文上的设置服务；不存在或 get 不可调用时返回 undefined。
+*
+* apply() 的注入门槛判定与本提取路径共用这一个函数，避免两处标准不一致
+* 造成"装了包装层却永远提取不到数据"的错位。
+*/
+function settingsService(ctx) {
+	const settings = ctx.settings;
+	if (!settings || typeof settings.get !== "function") return void 0;
+	return settings;
+}
+const warnedMessages = /* @__PURE__ */ new Set();
+/** 经当前上下文的 logger 发出一次性告警。 */
+function warnOnce(ctx, message) {
+	if (warnedMessages.has(message)) return;
+	warnedMessages.add(message);
+	ctx.logger?.warn?.("[" + name + "] " + message);
+}
+/**
+* 创建一条提取结果的记录器：等级 trim 后写入映射；不在已知集合时一次性告警
+* 但仍注入，让适配器的逐字匹配给出最终裁决（避免本地白名单过期后挡住上游
+* 新增的等级）。设置提取位于每次请求的热路径上，告警按消息去重防止刷屏。
+*
+* @param ctx - Cordis 上下文。
+* @param extracted - 提取结果的目标映射。
+* @returns 记录函数。
+*/
+function createEffortRecorder(ctx, extracted) {
+	return (routeKey, level) => {
+		if (typeof level !== "string") return;
+		const trimmedLevel = level.trim();
+		if (trimmedLevel.length === 0) return;
+		if (!KNOWN_REASONING_EFFORTS.has(trimmedLevel)) warnOnce(ctx, "设置中路由 " + routeKey + " 的推理等级 \"" + trimmedLevel + "\" 不在已知集合内，请确认目标模型支持");
+		extracted[routeKey] = trimmedLevel;
+	};
+}
+/**
+* 从当前 Cordis 上下文的设置服务中读取各 Provider 与模型的默认推理等级。
+*
+* 字段约定（每个来源只读单一规范字段，不做别名兜底）：
+* - llm-pi-ai：provider 级 `reasoning` 是宿主原生声明字段；模型级
+*   `models[].reasoning` 与 `modelOverrides.<model>.reasoning` 是本插件约定
+*   读取的扩展字段，依赖其设置解析对未声明键的透传行为。宿主在模型层另有
+*   原生字段 `reasoningEfforts`，但那是"可选等级集合 + 线格式映射"的能力
+*   声明而非默认值选择，语义不同，本插件不读取；若上游收紧对未声明键的
+*   解析策略，`reasoning` 这部分提取会静默失效。
+* - llm-deepseek：顶层 `reasoningEffort` 为宿主原生字段，映射到其注册的
+*   provider 路由 deepseek-official（见 DEEPSEEK_OFFICIAL_PROVIDER_ID）。
+*
+* 整个函数不包 try/catch：宿主的 settings.get 对未注册命名空间返回 undefined
+* 且不会抛错，函数体已对全部外部数据做了形状防御，剩余可能抛错的只有代码
+* 缺陷，应当让它暴露，而不是吞掉后以空映射继续主流程。
+*
+* @param ctx - Cordis 上下文。
+* @returns 提取出的路由默认映射字典。
+*/
+function extractSettingsDefaults(ctx) {
+	const extracted = {};
+	const settings = settingsService(ctx);
+	if (!settings) return extracted;
+	const record = createEffortRecorder(ctx, extracted);
+	const piAi = settings.get("llm-pi-ai");
+	if (piAi?.providers && typeof piAi.providers === "object") for (const [providerId, providerProfile] of Object.entries(piAi.providers)) {
+		if (!providerId || !providerProfile || typeof providerProfile !== "object") continue;
+		if (providerId === DEEPSEEK_OFFICIAL_PROVIDER_ID) {
+			warnOnce(ctx, "llm-pi-ai 中名为 deepseek-official 的 provider 无法注册该路由，已跳过其推理等级提取");
+			continue;
+		}
+		record(providerId + ":*", providerProfile.reasoning);
+		if (Array.isArray(providerProfile.models)) for (const m of providerProfile.models) {
+			const id = m && typeof m === "object" && typeof m.id === "string" ? m.id.trim() : "";
+			if (id.length === 0) continue;
+			record(providerId + ":" + id, m.reasoning);
+		}
+		if (providerProfile.modelOverrides && typeof providerProfile.modelOverrides === "object") for (const [modelId, override] of Object.entries(providerProfile.modelOverrides)) {
+			const id = modelId.trim();
+			if (id.length === 0 || !override || typeof override !== "object") continue;
+			record(providerId + ":" + id, override.reasoning);
+		}
+	}
+	const deepseek = settings.get("llm-deepseek");
+	if (deepseek && typeof deepseek === "object") record("deepseek-official:*", deepseek.reasoningEffort);
+	return extracted;
+}
+/**
+* 从本插件专用的设置命名空间读取设置页 UI 写入的路由表。
+*
+* 该命名空间由 apply() 注册、浏览器设置面板写入，是"设置里改默认推理强度"
+* 的存储层；每次请求实时读取，改动即时生效。形状非法（非对象/缺字段）时
+* 返回空映射——schema 校验已保证写入合法，这里的防御只覆盖外部手工编辑
+* settings 文档的场景。
+*
+* @param ctx - Cordis 上下文。
+* @returns 路由映射字典。
+*/
+function extractUiNamespaceDefaults(ctx) {
+	const extracted = {};
+	const settings = settingsService(ctx);
+	if (!settings) return extracted;
+	const section = settings.get(UI_DEFAULTS_NAMESPACE);
+	if (!section || typeof section !== "object") return extracted;
+	const record = createEffortRecorder(ctx, extracted);
+	const defaults = section.defaults;
+	if (defaults && typeof defaults === "object") for (const [rawKey, level] of Object.entries(defaults)) {
+		const key = rawKey.trim();
+		if (key.length === 0) continue;
+		record(key, level);
+	}
+	return extracted;
+}
+const UI_NS_RETRY_INTERVAL_MS = 250;
+const UI_NS_RETRY_MAX_ATTEMPTS = 240;
+/**
+* 在设置服务上注册本插件的可编辑命名空间（跨热重载安全）。
+*
+* 每次激活都先直接尝试注册——不缓存"已注册"标记，因为旧代的卸载会把命名空间
+* 一并注销，缓存的真值会在"停用后再启用"的场景下变成谎言。撞上
+* "already registered" 说明旧代尚未释放，进入短周期轮询直到键位空出；
+* 其它错误告警后放弃，不阻断主流程（patch 层配置仍然生效）。
+*
+* @param ctx - 当前插件上下文。
+* @param settings - 当前上下文的设置服务。
+*/
+function registerUiDefaultsNamespace(ctx, settings) {
+	if (settings.register === void 0) {
+		warnOnce(ctx, "当前设置服务不支持命名空间注册，设置页将无法编辑推理等级默认值");
+		return;
+	}
+	const attempt = () => {
+		try {
+			settings.register(UI_DEFAULTS_NAMESPACE, uiDefaultsSectionSchema, { applies: "live" });
+			return "ok";
+		} catch (error) {
+			if (!String(error).includes("already registered")) {
+				ctx.logger?.warn?.("[" + name + "] 注册设置命名空间失败，设置页将无法编辑推理等级默认值：" + String(error));
+				return "ok";
+			}
+			return "busy";
+		}
+	};
+	if (attempt() !== "busy") return;
+	let attempts = 0;
+	const timer = setInterval(() => {
+		attempts += 1;
+		if (attempts > UI_NS_RETRY_MAX_ATTEMPTS) {
+			clearInterval(timer);
+			warnOnce(ctx, "等待旧代释放设置命名空间超时，本次运行设置页不可用；请重启宿主或再次重载本插件");
+			return;
+		}
+		if (attempt() === "ok") clearInterval(timer);
+	}, UI_NS_RETRY_INTERVAL_MS);
+	ctx.effect(() => () => {
+		clearInterval(timer);
+	}, name + ": stop UI namespace registration retry");
+}
+const runtimePatchStateKey = Symbol.for("dsh-model-reasoning-defaults.runtime-patch-state");
+/**
+* 取最后激活的配置层。热重载期间新 fiber 覆盖旧 fiber，旧 fiber 卸载后
+* 新配置仍保持生效；最后一个 fiber 卸载时才还原原始服务方法。
+*
+* @param state - 同一 LLM 服务上的包装状态。
+* @returns 当前生效的 defaults；没有活跃层时返回 undefined。
+*/
+function currentDefaults(state) {
+	let current;
+	for (const defaults of state.defaults.values()) current = defaults;
+	return current;
+}
+/**
+* 解析当前生效的完整 defaults 映射。三个配置层按优先级从低到高合并：
+* 设置服务自动提取项（llm-pi-ai / llm-deepseek 原生字段）→ 本插件设置
+* 命名空间（设置页 UI 写入）→ 插件自身 cordis 配置（patch 层）。
+* 同一路由键上高优先级层覆盖低优先级层。
+*
+* @param ctx - 当前共享包装层绑定的上下文（热重载后为新 fiber 的 ctx）。
+* @param state - 同一 LLM 服务上的包装状态。
+* @returns 合并后的路由映射；三层均为空时为空对象。
+*/
+function resolveEffectiveDefaults(ctx, state) {
+	const pluginDefaults = currentDefaults(state) ?? {};
+	const uiStoreDefaults = extractUiNamespaceDefaults(ctx);
+	return {
+		...extractSettingsDefaults(ctx),
+		...uiStoreDefaults,
+		...pluginDefaults
+	};
+}
+/**
+* 将当前活跃层应用到配置。保留原对象是卸载后仍被外部持有的旧包装的必要语义，
+* 也避免把一个空对象伪装成真实配置来源。
+*
+* @param state - 同一 LLM 服务上的包装状态（ctx 从 state 读取，保证热重载后
+*   提取路径跟随最新 fiber）。
+* @param config - 待处理的调用配置。
+* @returns 原配置或带默认推理等级的浅复制对象。
+*/
+function applyCurrentDefault(state, config) {
+	const defaults = resolveEffectiveDefaults(state.ctx, state);
+	return Object.keys(defaults).length === 0 ? config : applyDefaultReasoningEffort(config, defaults);
+}
+/**
+* 从当前 stream 包装上恢复跨热重载共享的状态。
+*
+* @param llm - LLM 服务实例。
+* @returns 现有包装状态；服务尚未被本插件包装时返回 undefined。
+*/
+function existingRuntimePatchState(llm) {
+	return llm.stream[runtimePatchStateKey];
+}
+/**
+* 创建覆盖三个公开入口的 LLM 服务包装。
+*
+* 手写请求在 stream 入口浅复制补齐后再进 waterfall，保证每个监听器只处理
+* 一次；loop 构建的请求由宿主打 markAgentLoopRequest 进程标识并深冻结，
+* 经 isAgentLoopRequest 判定后按原引用透传——浅复制会丢失该进程标识。
+*
+* @param ctx - 当前插件上下文。
+* @param llm - LLM 服务实例。
+* @returns 可复用的包装状态。
+*/
+function createRuntimePatchState(ctx, llm) {
+	const originalStream = llm.stream;
+	const originalPrepareCall = llm.prepareCall;
+	const originalResolveCallConfig = llm.resolveCallConfig;
+	let state;
+	const stream = (options) => {
+		const patched = isAgentLoopRequest(options) ? options : applyCurrentDefault(state, options);
+		return originalStream.call(llm, patched);
+	};
+	const prepareCall = async (config, signal) => {
+		return originalPrepareCall.call(llm, applyCurrentDefault(state, config), signal);
+	};
+	const resolveCallConfig = async (config, signal) => {
+		return originalResolveCallConfig.call(llm, applyCurrentDefault(state, config), signal);
+	};
+	state = {
+		ctx,
+		defaults: /* @__PURE__ */ new Map(),
+		originalStream,
+		originalPrepareCall,
+		originalResolveCallConfig,
+		stream,
+		prepareCall,
+		resolveCallConfig
+	};
+	Object.defineProperty(stream, runtimePatchStateKey, { value: state });
+	return state;
+}
+/**
+* 安装一层可卸载的 LLM 服务包装。
+*
+* 每个插件 fiber 只持有自己的配置层。这样新 fiber 先装配、旧 fiber 后卸载时，
+* 不会把服务方法恢复为已经失效的旧包装。
+*
+* @param ctx - 当前插件上下文。
+* @param llm - LLM 服务实例。
+* @param defaults - 默认推理等级映射。
+*/
+function installRuntimePatches(ctx, llm, defaults) {
+	const state = existingRuntimePatchState(llm) ?? createRuntimePatchState(ctx, llm);
+	state.ctx = ctx;
+	if (llm.stream !== state.stream) llm.stream = state.stream;
+	if (llm.prepareCall !== state.prepareCall) llm.prepareCall = state.prepareCall;
+	if (llm.resolveCallConfig !== state.resolveCallConfig) llm.resolveCallConfig = state.resolveCallConfig;
+	const token = Symbol(name);
+	state.defaults.set(token, defaults);
+	ctx.effect(() => () => {
+		state.defaults.delete(token);
+		if (state.defaults.size !== 0) return;
+		if (llm.stream === state.stream) llm.stream = state.originalStream;
+		if (llm.prepareCall === state.prepareCall) llm.prepareCall = state.originalPrepareCall;
+		if (llm.resolveCallConfig === state.resolveCallConfig) llm.resolveCallConfig = state.originalResolveCallConfig;
+	}, name + ": restore LLM method wrappers");
+	return state;
+}
+/**
+* 安装默认推理等级注入逻辑。
+*
+* @param ctx - 当前插件上下文。
+* @param config - 插件配置。
+*/
+function apply(ctx, config = {}) {
+	const defaults = normalizeConfig(config);
+	for (const issue of collectConfigIssues(config)) ctx.logger?.warn?.("[" + name + "] " + issue);
+	const settings = settingsService(ctx);
+	if (settings) registerUiDefaultsNamespace(ctx, settings);
+	if (Object.keys(defaults).length === 0 && !settings) {
+		ctx.logger?.info?.("[" + name + "] 未配置推理等级默认值且无设置服务，跳过注入");
+		return;
+	}
+	const llm = ctx.llm;
+	const state = installRuntimePatches(ctx, llm, defaults);
+	registerAgentRequestListener(ctx, async function(_payload, next) {
+		return applyCurrentDefault(state, await next());
+	});
+	ctx.logger?.info?.("[" + name + "] 已激活：routes=" + Object.keys(defaults).join(", "));
+}
+//#endregion
+export { Config, UI_DEFAULTS_NAMESPACE, apply, applyDefaultReasoningEffort, extractSettingsDefaults, extractUiNamespaceDefaults, inject, name, normalizeConfig };
+
+//# sourceMappingURL=index.mjs.map