dsh-router-core 0.4.2 → 0.4.4

package/lib/index.js

@@ -2687,11 +2687,10 @@ function projectImageDimensions(width, height, maxPixels) {
 * base64）。图片字节经 `resolveAttachments` 读取；读不到时回退为稳定的占位文本，
 * **绝不静默丢图**（丢图 = 模型看到一条没有图的消息却毫无提示）。
 *
-* 工具结果双模型兼容：0.1.5/0.1.6 里 tool result 是 user 消息里的 'tool-result' 块
-* （旧路径）；0.1.7+ 改成了独立 role:'tool' 消息、toolCallId 挂消息级（新分支）。
-* 两者在 wire 上统一序列化为 role:'tool'，产物一致。见主循环里的 role==='tool' 分支。
+* 工具结果只有一种形态：独立 `role:'tool'` 消息、toolCallId 挂消息级，wire 上原样
+* 发 `role:'tool'`。见主循环里的 `role === 'tool'` 分支。
 */
-/** tool-result 里图片挂到 user 消息时用的说明文字（与官方适配器一致）。 */
+/** tool 消息里的图片挂到 user 消息时用的说明文字（与官方适配器一致）。 */
 const TOOL_RESULT_IMAGE_TEXT = "Tool result images";
 /**
 * 流空闲超时：上游连上后这么久没吐**任何**字节就判失败（抛 TIMEOUT，可重试）。
@@ -2706,7 +2705,7 @@ const STREAM_IDLE_TIMEOUT_MS = 3e5;
 async function wireMessages(options, system, attachments, log) {
 	const out = [];
 	/**
-	* 攒着「tool-result 里带出来的图片」，等这一串 tool 消息**发完**再合并成一条
+	* 攒着「tool 消息里带出来的图片」，等这一串 tool 消息**发完**再合并成一条
 	* user 消息补在后面。
 	*
 	* 为什么必须跨消息攒、而不是各消息各发一条：harness 把**每个 tool 结果放
@@ -2774,26 +2773,12 @@ async function wireMessages(options, system, attachments, log) {
 			pendingToolImages.push(...imageParts);
 			continue;
 		}
-		const toolResults = message.content.filter((b) => b.type === "tool-result");
-		const ownParts = await contentParts(message.content.filter((b) => b.type !== "tool-result"), attachments, options.signal, log);
-		if (ownParts.length > 0 || toolResults.length === 0) {
-			flushToolImages();
-			out.push({
-				role: "user",
-				content: compactUserContent(ownParts)
-			});
-		}
-		for (const result of toolResults) {
-			const parts = await contentParts(result.content, attachments, options.signal, log);
-			const imageParts = parts.filter((p) => p.type !== "text");
-			const text = parts.filter((p) => p.type === "text").map((p) => p.text ?? "").join("");
-			out.push({
-				role: "tool",
-				tool_call_id: result.toolCallId,
-				content: text
-			});
-			pendingToolImages.push(...imageParts);
-		}
+		const userParts = await contentParts(message.content, attachments, options.signal, log);
+		flushToolImages();
+		out.push({
+			role: "user",
+			content: compactUserContent(userParts)
+		});
 	}
 	flushToolImages();
 	return out;
@@ -2811,7 +2796,7 @@ function compactUserContent(parts) {
 	return texts.join("");
 }
 /**
-* 一块 DSH user/tool-result 内容序列化成 OpenAI content parts（text + image_url）。
+* 一条 DSH 消息的内容块序列化成 OpenAI content parts（text + image_url）。
 * 纯文本时返回空数组（上层走紧凑字符串路径）。图片转 base64 data URI；
 * attachments 缺失或读取失败时回退稳定占位文本（绝不静默丢图）。
 */
@@ -2831,7 +2816,6 @@ async function contentParts(blocks, attachments, signal, log) {
 			parts.push(...await imageParts(ref, attachments, signal, log));
 			continue;
 		}
-		if (block.type === "tool-result") parts.push(...await contentParts(block.content, attachments, signal, log));
 	}
 	return parts;
 }
@@ -4025,6 +4009,33 @@ function writeJson$1(res, status, body) {
 	});
 	res.end(payload);
 }
+/**
+* 包住会调插件的 handler：插件抛错时回 **JSON 500**，别让异常裸奔到 webServer。
+*
+* 为什么必须有这一层：webServer 的兜底是 `res.writeHead(400); res.end()`——**空
+* body**。面板拿到空 body，`response.json()` 抛 "Unexpected end of JSON input"，
+* 真实原因（上游 500 / token 失效…）全丢，用户只看到一句解析错误。
+*
+* 这条路径是插件契约「出错就抛」(docs/suppliers.md「模型统一策略」) 的下游：插件
+* 老实抛了，核心就得老实接住并说清楚。以前 `listModels` 静默吞错，所以从没暴露过
+* 这个缺口（traework 2026-10-10 「获取模型只有几个」修完才浮现）。
+*/
+function guard(handler) {
+	return async (req, res) => {
+		try {
+			await handler(req, res);
+		} catch (err) {
+			if (res.headersSent) {
+				res.end();
+				return;
+			}
+			writeJson$1(res, err instanceof SyntaxError ? 400 : 500, {
+				ok: false,
+				error: err.message
+			});
+		}
+	};
+}
 async function readBody$1(req, limit = 65536) {
 	const chunks = [];
 	let size = 0;
@@ -4083,14 +4094,14 @@ function supplierRoutes(base, loaded, store, router) {
 	routes.push({
 		kind: "exact",
 		path: `${p}/models`,
-		handler: async (_req, res) => {
+		handler: guard(async (_req, res) => {
 			const models = await router.modelsOf(s.id);
 			writeJson$1(res, 200, {
 				ok: true,
 				alias: s.getAlias(),
 				models
 			});
-		}
+		})
 	});
 	routes.push({
 		kind: "exact",
@@ -4218,7 +4229,7 @@ function supplierRoutes(base, loaded, store, router) {
 	routes.push({
 		kind: "exact",
 		path: `${p}/models/toggle`,
-		handler: async (req, res) => {
+		handler: guard(async (req, res) => {
 			const body = JSON.parse(await readBody$1(req));
 			store.get(s.id);
 			const models = await router.modelsOf(s.id);
@@ -4232,12 +4243,12 @@ function supplierRoutes(base, loaded, store, router) {
 			store.setModelEnabled(s.id, body.id, !!body.enabled);
 			router.invalidateModels(s.id);
 			writeJson$1(res, 200, { ok: true });
-		}
+		})
 	});
 	routes.push({
 		kind: "exact",
 		path: `${p}/models/add`,
-		handler: async (req, res) => {
+		handler: guard(async (req, res) => {
 			const id = (JSON.parse(await readBody$1(req)).id ?? "").trim();
 			if (id === "") {
 				writeJson$1(res, 400, {
@@ -4256,7 +4267,7 @@ function supplierRoutes(base, loaded, store, router) {
 			store.addCustomModel(s.id, id);
 			router.invalidateModels(s.id);
 			writeJson$1(res, 200, { ok: true });
-		}
+		})
 	});
 	routes.push({
 		kind: "exact",
@@ -4279,13 +4290,13 @@ function supplierRoutes(base, loaded, store, router) {
 	routes.push({
 		kind: "exact",
 		path: `${p}/models/bulk`,
-		handler: async (req, res) => {
+		handler: guard(async (req, res) => {
 			const body = JSON.parse(await readBody$1(req));
 			const models = await router.modelsOf(s.id);
 			store.setAllModelsEnabled(s.id, !!body.enabled, models.map((mm) => mm.id));
 			router.invalidateModels(s.id);
 			writeJson$1(res, 200, { ok: true });
-		}
+		})
 	});
 	routes.push({
 		kind: "exact",
@@ -4313,12 +4324,12 @@ function supplierRoutes(base, loaded, store, router) {
 	routes.push({
 		kind: "exact",
 		path: `${p}/models/fetch`,
-		handler: async (_req, res) => {
+		handler: guard(async (_req, res) => {
 			writeJson$1(res, 200, {
 				ok: true,
 				models: await router.modelsOf(s.id, true)
 			});
-		}
+		})
 	});
 	routes.push({
 		kind: "exact",
@@ -4614,37 +4625,46 @@ function loopbackBaseURL(readPort, path = "/v1") {
 //#endregion
 //#region src/host-version.ts
 /**
-* 宿主 DSH 版本探测 —— **0.1.5 / 0.1.7 兼容分叉的唯一判据来源**。
+* 宿主 DSH 版本探测 —— 现在只剩两件事：**报版本**（日志 + `/router/api/health`）与
+* **守版本地板**。
 *
-* 原先三处兼容都靠「能力检测」（看方法/属性在不在），语义上是同一个问题
-* ——「这是 0.1.7 还是更老」——却各检各的、还容易误判（插件自己 node_modules
-* 里的依赖版本与宿主实际加载的版本并不一致：实测插件解析到 schemastery 3.18.4，
-* profile 里却是 3.18.3、全局是 3.18.2）。所以统一改成**读宿主版本号**判定：
+* ## 为什么不再有兼容分叉
 *
-*   1. 「最近命中」徽章：composer.dock 在 0.1.5 渲染位置不对 → >= 0.1.7 才挂。
-*   2. 设置命名空间：0.1.5 用 `settings.installSection` 注册；0.1.7 改由导出的
-*      Config 驱动（无此方法）→ 按版本走对应注册路径。
-*   3. adapter 的 tool-result 消息形态：0.1.5/0.1.6 = user 里的 'tool-result'
-*      块；0.1.7+ = 独立 role:'tool' 消息。
+* 原来这里有三处 `>= 0.1.7` 的分叉（设置卡片注册路径、「最近命中」徽章座位、adapter
+* 的工具结果消息形态），彼此独立判断、还容易误判。本插件现已按 **0.2.0 单面**编写，
+* 三处的旧分支全部删除：
+*
+*   1. 设置卡片：0.1.5 走 `settings.installSection`，0.1.7+ 走导出的 volatile Config。
+*      0.2.0 只有后者 → installSection 分支删除。
+*   2. 「最近命中」徽章：0.1.5 渲染在 InputBar 之后的独立块（位置不对），0.1.7+ 才在
+*      composer 底部操作行。0.2.0 起无条件挂载，不再问支持位。
+*   3. adapter 工具结果形态：旧的「user 内嵌 tool-result 块」0.1.7 起退役；0.2.0 的
+*      v3→v4 会话迁移还主动拒绝该包装，所以它到不了 adapter → 分支删除。
+*
+* ## 为什么仍要读版本
+*
+* 因为**跑在老宿主上必须出声**。删掉分叉不等于「老宿主也能跑」：0.1.x 上本插件会
+* 静默走错路径（卡片不出、徽章错位、工具结果丢失），而用户看到的现象与「插件坏了」
+* 无法区分。所以这里只保留一个判据 `isHostSupported`（>= 0.2.0），仅用于 apply 时
+* 打一条醒目的警告 —— 不是兼容，是可诊断。
 *
 * 读法：宿主把 profile 目录挂在 `ctx.baseUrl`（见 data-dir.ts）。本插件跑在宿主
 * 进程内，`require.resolve('@deepseek-ai/dsh/package.json', { paths: [profile] })`
-* 会沿 profile 的 node_modules 向上解析到全局安装根（实测命中 bun 全局目录）。
-* 拿不到就回落直接拼路径，再不行就返回 undefined（按「不支持/老版本」处理，不抛）。
+* 会沿 profile 的 node_modules 向上解析到全局安装根。拿不到就回落直接拼路径，再不行
+* 返回 undefined（按「无法确认」处理，不抛）。
 *
-* 注意：**只能在 `apply(ctx)` 里用**（那时才有 baseUrl）。模块顶层（如 Config 导出）
-* 解析到的是插件自己的依赖，不能代表宿主——那处保留能力检测，见 index.ts 注释。
+* 注意：**只能在 `apply(ctx)` 里用**（那时才有 baseUrl）。模块顶层解析到的是插件自己
+* 的依赖，不能代表宿主。
 */
-/** 各兼容分叉的版本门槛。 */
-/** composer.dock 徽章 / 独立 role:'tool' 消息形态：0.1.7 起。 */
-const V0_1_7 = [
+/** 版本地板：低于此版本的宿主本插件不再兼容（0.1.5/0.1.6/0.1.7 全部落此下）。 */
+const V0_2_0 = [
 	0,
-	1,
-	7
+	2,
+	0
 ];
 /**
 * 解析并比较 semver（只取前导数字段，预发布标识忽略）。
-* `0.1.7-alpha.2` → [0,1,7]，`0.1.5-rc.3` → [0,1,5]。
+* `0.2.0-rc.1` → [0,2,0]，`0.1.7-alpha.2` → [0,1,7]。
 * 返回负数/0/正数，语义同 `<`/`==`/`>`。
 */
 function compareVersion(a, b) {
@@ -4655,7 +4675,7 @@ function compareVersion(a, b) {
 	}
 	return 0;
 }
-/** `0.1.7-alpha.2` → [0,1,7]；解析失败返回 null。 */
+/** `0.2.0-rc.1` → [0,2,0]；解析失败返回 null。 */
 function parseVersion(raw) {
 	const m = /^(\d+)(?:\.(\d+))?(?:\.(\d+))?/.exec(raw.trim());
 	if (m === null) return null;
@@ -4668,7 +4688,7 @@ function parseVersion(raw) {
 /**
 * 探测 profile 里安装的 DSH 宿主版本。
 * @param baseUrl 宿主注入的 profile 锚点（`ctx.baseUrl`）
-* @returns 形如 `0.1.7-alpha.2`；读不到返回 undefined（调用方按「不支持」处理）
+* @returns 形如 `0.2.0-rc.1`；读不到返回 undefined
 */
 function detectHostVersion(baseUrl) {
 	const profile = profileDirOf(baseUrl);
@@ -4682,26 +4702,19 @@ function detectHostVersion(baseUrl) {
 		if (typeof parsed.version === "string" && parsed.version !== "") return parsed.version;
 	} catch {}
 }
-/** 宿主版本是否 >= 门槛。读不到版本 → false（按老版本处理）。 */
-function atLeast(baseUrl, min) {
+/**
+* 宿主是否在本插件支持的地板之上（>= 0.2.0）。
+*
+* **只用于报警，不用于分流** —— 低于地板时插件照常加载，但要在日志里说清「这台宿主
+* 不再兼容、会出现什么症状」，把静默的错变成可查的错。读不到版本 → false（当作
+* 「无法确认」，同样值得说一句）。
+*/
+function isHostSupported(baseUrl) {
 	const v = detectHostVersion(baseUrl);
 	if (v === void 0) return false;
 	const parsed = parseVersion(v);
 	if (parsed === null) return false;
-	return compareVersion(parsed, min) >= 0;
-}
-/**
-* 宿主是否 >= 0.1.7。三处兼容分叉共用这一个判据：
-*   - 「最近命中」徽章（composer.dock 位置正确）
-*   - 设置命名空间（Config 驱动而非 installSection）
-*   - adapter 的独立 role:'tool' 消息形态
-*/
-function isHost017Plus(baseUrl) {
-	return atLeast(baseUrl, V0_1_7);
-}
-/** 「最近命中」徽章是否可用（= 宿主 >= 0.1.7）。 */
-function supportsLastHitDock(baseUrl) {
-	return isHost017Plus(baseUrl);
+	return compareVersion(parsed, V0_2_0) >= 0;
 }
 //#endregion
 //#region src/ext/store.ts
@@ -4823,26 +4836,23 @@ const name = "dsh-router-core";
 /** Services required before mounting: the webserver (routes) + llm (设置-模型). */
 const inject = ["webServer", "llm"];
 /**
-* `Config` 导出：让 Router 卡片进 0.1.7 的设置镜像。
+* `Config` 导出：让 Router 卡片进设置-模型的镜像（0.2.0 的收录链是「插件导出的
+* Config + 配置树行 id」）。
 *
-* **这处刻意保留能力检测，不用宿主版本号** —— 与另两处兼容点（installSection /
-* adapter 消息形态）不同。原因（已实测）：这是**模块顶层导出**，loader 一 import
-* 就求值；而 schemastery 是本插件的**普通依赖**（`^3.18.4`，见 package.json），
-* 解析到的是**插件自己 node_modules 里那一份**，跟宿主实际加载的版本无关
-* （实测：插件解析到 3.18.4，而 profile 里是 3.18.3、全局是 3.18.2）。既然这里
-* 拿不到宿主版本，就只剩「这份 Schema 实例到底有没有 `.volatile`」这个真问题 ——
-* 能力检测恰好就是**对**的判据。
+* **这处保留能力检测，不看宿主版本号** —— 因为它是**模块顶层导出**，loader 一 import
+* 就求值，那时还没有 `ctx.baseUrl`；而 schemastery 是本插件的**普通依赖**，解析到的
+* 是插件自己 node_modules 里那一份，跟宿主实际加载的版本无关。既然这里拿不到宿主
+* 版本，就只剩「这份 Schema 实例到底有没有 `.volatile`」这个真问题 —— 能力检测
+* 恰好就是**对**的判据。
 *
-* 定位说明（非兼容分叉）：`.volatile()` 是 schemastery 3.18.4 才有的原型方法；
-* 老版本上直写 `Schema.object({}).volatile()` 会 `.volatile` 为 undefined →
-* 抛 TypeError → **整个插件加载失败**（不只是卡片，是 dsh-router 完全挂掉）。
-*   - 有 volatile：走 volatile，空 object 不被 volatileForm 过滤 → 卡片进镜像；
-*   - 无 volatile：回落普通空 schema，不抛；此时宿主必是 0.1.5，本就靠
-*     installSection 出卡片（见下方按版本分流的注册），这个 Config 无副作用。
+* 为什么要 `.volatile()`：空 object 会被 volatileForm 过滤掉，顶层标 volatile 才能让
+* 卡片进镜像。`.volatile()` 是 schemastery 3.18.4 才有的原型方法，直写
+* `Schema.object({}).volatile()` 在没有它的版本上会抛 TypeError → **整个插件加载
+* 失败**。所以：无 volatile 就回落普通空 schema（不抛，代价是卡片不出现，并有日志）。
 */
 const emptySchema = Schema.object({});
 /**
-* 0.1.7 的设置镜像只认「插件导出的 Config + 配置树行 id」这条收录链，且空 object
+* 设置镜像只认「插件导出的 Config + 配置树行 id」这条收录链，且空 object
 * 会被 volatileForm 过滤掉 —— 顶层 `.volatile()` 才能让 Router 卡片出现在设置-模型。
 * Router 的真配置在自己的 state.json（路由系统面板），这里故意不暴露任何字段。
 */
@@ -4880,9 +4890,9 @@ function apply(rawContext) {
 	const stateFile = join(dataDir, "state.json");
 	log(`data dir: ${dataDir}`);
 	const hostVersion = detectHostVersion(ctx.baseUrl);
-	const host017Plus = isHost017Plus(ctx.baseUrl);
-	const lastHitDock = supportsLastHitDock(ctx.baseUrl);
-	log(`host version: ${hostVersion ?? "未知"} (>=0.1.7: ${host017Plus ? "yes" : "no"}, last-hit dock: ${lastHitDock ? "on" : "off"})`);
+	const hostSupported = isHostSupported(ctx.baseUrl);
+	log(`host version: ${hostVersion ?? "未知"} (>=0.2.0: ${hostSupported ? "yes" : "no"})`);
+	if (!hostSupported) ctx.logger.warn(`[dsh-router] 宿主版本 ${hostVersion ?? "未知"} 低于本插件支持的 0.2.0 —— 插件仍会加载，但设置卡片、「最近命中」徽章与工具结果转发会走错路径。请把宿主升到 0.2.0 及以上。`);
 	const store = new SupplierConfigStore(stateFile);
 	const credentials = new CredentialStore(join(dataDir, "auths"));
 	const router = new Router(stateFile, store, log);
@@ -5050,7 +5060,7 @@ function apply(rawContext) {
 		writeJson(res, 200, {
 			ok: true,
 			hostVersion: hostVersion ?? "",
-			lastHitDock,
+			lastHitDock: true,
 			suppliers: suppliers.map((s) => {
 				const loaded = loadedSuppliers.find((l) => l.supplier.id === s.id);
 				return {
@@ -5264,6 +5274,39 @@ function apply(rawContext) {
 			requireApiKey: keys.requireApiKey
 		});
 	});
+	/**
+	* 把 `router.ext` 表映射成面板要的 `ExtInfo[]`。**GET 与 PATCH 共用**。
+	*
+	* ⚠️ 2026-09-30：op 成功时我复制了一份这段映射来就地回表 —— 两份必然漂移
+	*   （改一处只生效一半，本仓反复栽的坑）⇒ 抽成函数，一处定义两处调用。
+	*/
+	function extInfos(table, isEnabled) {
+		return Object.values(table).map((raw) => {
+			const e = raw;
+			if (!e || typeof e.id !== "string" || e.id === "") return void 0;
+			const st = typeof e.getState === "function" ? e.getState() : { ready: false };
+			return {
+				id: e.id,
+				name: e.name ?? e.id,
+				...e.description !== void 0 ? { description: e.description } : {},
+				...e.icon !== void 0 ? { icon: e.icon } : {},
+				enabled: isEnabled(e.id),
+				ready: st?.ready === true,
+				...raw.source === "builtin" ? { source: "builtin" } : {},
+				...Array.isArray(e.controls) && e.controls.length > 0 ? { controls: e.controls.filter((c) => !!c && typeof c.id === "string" && c.id !== "" && typeof c.title === "string").map((c) => ({
+					id: c.id,
+					title: c.title,
+					on: c.on === true,
+					...c.detail !== void 0 ? { detail: c.detail } : {},
+					...typeof c.body === "string" ? { body: c.body } : {},
+					...c.editable === true ? { editable: true } : {},
+					custom: c.custom === true,
+					overridden: c.overridden === true
+				})) } : {},
+				...st?.detail !== void 0 ? { detail: st.detail } : {}
+			};
+		}).filter((e) => e !== void 0);
+	}
 	route(`${ROUTER_API_BASE}/ext`, async (req, res) => {
 		if (req.method === "PATCH") {
 			let body;
@@ -5276,6 +5319,7 @@ function apply(rawContext) {
 				});
 				return;
 			}
+			let addedId = null;
 			const ext = typeof body.id === "string" ? exts[body.id] : void 0;
 			if (!ext) {
 				writeJson(res, 404, {
@@ -5284,6 +5328,152 @@ function apply(rawContext) {
 				});
 				return;
 			}
+			if (body.op !== void 0) {
+				const op = body.op;
+				if (op === "reorder") {
+					if (!Array.isArray(body.ids)) {
+						writeJson(res, 400, {
+							ok: false,
+							error: "ids must be an array"
+						});
+						return;
+					}
+					if (typeof ext.setControlOrder !== "function" || !ext.setControlOrder(body.ids)) {
+						writeJson(res, 400, {
+							ok: false,
+							error: "排序保存失败"
+						});
+						return;
+					}
+				} else if (op === "remove" || op === "reset") {
+					if (typeof body.controlId !== "string" || body.controlId === "") {
+						writeJson(res, 400, {
+							ok: false,
+							error: "controlId must be a non-empty string"
+						});
+						return;
+					}
+					const fn = op === "remove" ? ext.removeCustomControl : ext.resetControlText;
+					if (typeof fn !== "function" || !fn.call(ext, body.controlId)) {
+						writeJson(res, 400, {
+							ok: false,
+							error: op === "remove" ? "只能删除自定义准则（内置条目请用开关关掉）" : "只能还原内置准则，且它得先被改过"
+						});
+						return;
+					}
+				} else if (op === "add") {
+					if (typeof ext.addCustomControl !== "function") {
+						writeJson(res, 400, {
+							ok: false,
+							error: "extension does not support custom controls"
+						});
+						return;
+					}
+					addedId = ext.addCustomControl(typeof body.title === "string" ? body.title : "", typeof body.body === "string" ? body.body : "");
+					if (addedId === null) {
+						writeJson(res, 400, {
+							ok: false,
+							error: "标题与内容都不能为空"
+						});
+						return;
+					}
+				} else {
+					writeJson(res, 400, {
+						ok: false,
+						error: `unknown op: ${String(op)}`
+					});
+					return;
+				}
+				writeJson(res, 200, addedId === null ? {
+					ok: true,
+					enhancers: extInfos(exts, (id) => extStore.isEnabled(id))
+				} : {
+					ok: true,
+					id: addedId,
+					enhancers: extInfos(exts, (id) => extStore.isEnabled(id))
+				});
+				return;
+			}
+			if (body.title !== void 0 || body.body !== void 0) {
+				if (typeof body.controlId !== "string" || body.controlId === "") {
+					writeJson(res, 400, {
+						ok: false,
+						error: "controlId must be a non-empty string"
+					});
+					return;
+				}
+				if (typeof body.title !== "undefined" && typeof body.title !== "string") {
+					writeJson(res, 400, {
+						ok: false,
+						error: "title must be a string"
+					});
+					return;
+				}
+				if (typeof body.body !== "undefined" && typeof body.body !== "string") {
+					writeJson(res, 400, {
+						ok: false,
+						error: "body must be a string"
+					});
+					return;
+				}
+				if (typeof ext.setControlText !== "function") {
+					writeJson(res, 400, {
+						ok: false,
+						error: "extension controls are not editable"
+					});
+					return;
+				}
+				const patch = {};
+				if (typeof body.title === "string") patch.title = body.title;
+				if (typeof body.body === "string") patch.body = body.body;
+				if (!ext.setControlText(body.controlId, patch)) {
+					writeJson(res, 400, {
+						ok: false,
+						error: "unknown controlId"
+					});
+					return;
+				}
+				writeJson(res, 200, {
+					ok: true,
+					enhancers: extInfos(exts, (id) => extStore.isEnabled(id))
+				});
+				return;
+			}
+			if (body.controlId !== void 0) {
+				if (typeof body.controlId !== "string" || body.controlId === "") {
+					writeJson(res, 400, {
+						ok: false,
+						error: "controlId must be a non-empty string"
+					});
+					return;
+				}
+				if (typeof body.on !== "boolean") {
+					writeJson(res, 400, {
+						ok: false,
+						error: "on must be a boolean"
+					});
+					return;
+				}
+				if (typeof ext.setControl !== "function") {
+					writeJson(res, 400, {
+						ok: false,
+						error: "extension has no controls"
+					});
+					return;
+				}
+				if (!ext.setControl(body.controlId, body.on)) {
+					writeJson(res, 400, {
+						ok: false,
+						error: "unknown controlId"
+					});
+					return;
+				}
+				writeJson(res, 200, {
+					ok: true,
+					enhancers: extInfos(exts, (id) => extStore.isEnabled(id))
+				});
+				return;
+			}
 			if (typeof body.enabled !== "boolean") {
 				writeJson(res, 400, {
 					ok: false,
@@ -5305,21 +5495,7 @@ function apply(rawContext) {
 		}
 		writeJson(res, 200, {
 			ok: true,
-			enhancers: Object.values(exts).map((raw) => {
-				const e = raw;
-				if (!e || typeof e.id !== "string" || e.id === "") return void 0;
-				const st = typeof e.getState === "function" ? e.getState() : { ready: false };
-				return {
-					id: e.id,
-					name: e.name ?? e.id,
-					...e.description !== void 0 ? { description: e.description } : {},
-					...e.icon !== void 0 ? { icon: e.icon } : {},
-					enabled: extStore.isEnabled(e.id),
-					ready: st?.ready === true,
-					...raw.source === "builtin" ? { source: "builtin" } : {},
-					...st?.detail !== void 0 ? { detail: st.detail } : {}
-				};
-			}).filter((e) => e !== void 0)
+			enhancers: extInfos(exts, (id) => extStore.isEnabled(id))
 		});
 	});
 	/** 解析并校验周期参数（不接受任意字符串）。 */
@@ -5382,24 +5558,7 @@ function apply(rawContext) {
 		disposers.push(ctx.llm.registerModelDiscovery(settingsNs, async () => {
 			return (await router.combos()).map((c) => ({ id: c.name }));
 		}));
-		const routerSettingsSchema = Schema.object({});
-		if (isHost017Plus(ctx.baseUrl)) log(`settings section driven by exported Config (${settingsNs})`);
-		else ctx.inject(["settings"], (sctx) => {
-			const settings = sctx.settings;
-			if (settings === void 0) {
-				log("settings service absent — skip Router settings-section registration");
-				return;
-			}
-			if (settings.installSection === void 0) {
-				log(`settings.installSection absent despite 0.1.5 host (${settingsNs})`);
-				return;
-			}
-			settings.installSection(rawContext, settingsNs, routerSettingsSchema, {}, {
-				setSource: () => {},
-				onChange: () => {}
-			});
-			log(`Router settings section registered (${settingsNs})`);
-		});
+		log(`settings section driven by exported Config (${settingsNs})`);
 		disposers.push(ctx.llm.registerAdapter(["router"], new RouterAdapter(loopbackBaseURL(() => ctx.webServer?.port), { comboModels: async () => (await router.combos()).map((c) => {
 			const w = router.comboContextWindow(c);
 			return {