dsh-router-core 0.4.7 → 0.4.9

package/lib/ext-prompt/index.js

@@ -1,4 +1,15 @@
-import { n as currentExts, t as currentExtStore } from "../contract-D4BWZ7Xe.js";
+//#region src/ext/contract.ts
+/** 读取当前 router.ext 表（同一 live 对象，可追加）——扩展插件用它注册自己。 */
+function currentExts(ctx) {
+	const c = ctx;
+	return c.get?.("router.ext") ?? c.router?.ext;
+}
+/** 读取扩展存储服务——扩展插件用它读开关、读写自己存的数据。 */
+function currentExtStore(ctx) {
+	const c = ctx;
+	return c.get?.("router.extStore") ?? c.router?.extStore;
+}
+//#endregion
 //#region src/ext-prompt/content.ts
 const PROMPT_CATEGORIES = [
 	{
@@ -32,10 +43,10 @@ const PROMPT_CATEGORIES = [
 		body: "收口(只在任务完成时做，与跑测试同级)：①反查过期：改动让哪些注释/文档/结论/代码引用点(凡以名字对齐的调用方、开关名、注册键)不符事实？当场改或删；②反查重复：新旧成两份就并成一处；③反查形状：该合的合、该归档的归位。做完那块区域该比动手前更整或更少。"
 	},
 	{
-		id: "verdifiable",
-		title: "可判定",
+		id: "doc",
+		title: "文档",
 		defaultOn: true,
-		body: "可判定：只有清单和会变红的闸门生效，形容词不生效。新约束一律写成\"动作+闸门\"。"
+		body: "文档：docs/ 里的调研/设计/任务文档，只写权威内容——结论、约束、怎么用；不写流水账(过程、试错、时间线)，历史归 git。"
 	},
 	{
 		id: "root-cause",
@@ -61,12 +72,6 @@ const PROMPT_CATEGORIES = [
 		defaultOn: true,
 		body: "结构：先让结构对再让代码短；命名/边界/单一职责优先于行数；依赖单向无环、公共逻辑收敛一处；单文件单功能，软顶函数 ~40 行/文件 ~300 行。"
 	},
-	{
-		id: "no-cheap",
-		title: "绝不偷懒",
-		defaultOn: true,
-		body: "绝不偷懒：边界输入校验、防数据丢失、安全、可访问性、真实硬件校准；非平凡逻辑留个能跑的检查。"
-	},
 	{
 		id: "delivery",
 		title: "交付",
@@ -77,7 +82,7 @@ const PROMPT_CATEGORIES = [
 		id: "execution",
 		title: "执行顺序",
 		defaultOn: true,
-		body: "执行：拉记忆→看全貌→建领地→定位任务→查结构行号→声明「任务/文件/验证/提交」→读码取切片→循既有骨架→验证以闸门为准(混合状态下的绿灯不作数)→收口复查全貌→提交。"
+		body: "执行：拉记忆→读文档→看全貌→定位任务→建领地→循既有架构/提出更优架构→验证以测试/e2e 验收→收口复查全貌→更新文档→提交。"
 	}
 ];
 /**
@@ -541,9 +546,9 @@ function createPromptExt(deps) {
 * 挂载层 —— 把准则注册成 `ctx.systemPrompt` 的**一个**段落。
 *
 * ════════════════════════════════════════════════════════════════════
-* 为什么只注册一段，而不是 14 段
+* 为什么只注册一段，而不是一段一个分类
 * ════════════════════════════════════════════════════════════════════
-* 面板开关的粒度是「分类」，但 prompt 读起来应该是一段连续的准则。分成 14 段
+* 面板开关的粒度是「分类」，但 prompt 读起来应该是一段连续的准则。分成多段
 * 会让 KV cache 每个分类各占一段，且**增删任意一个分类都让它之后的全部分位**。
 * 一段 + 拼装 ⇒ 分类增删只改这一段内部，段的位置与前缀稳定。
 *
@@ -612,8 +617,8 @@ function systemPromptOf(sctx) {
 *
 * ⚠️⚠️ **必须导出这个数组，且 `apply` 里直接用 `ctx.systemPrompt`**（2026-09-29 修）
 * ——我原先写成「在 apply 里 `ctx.inject(['systemPrompt'], cb)`」，**准则一直不进
-* prompt**：面板上卡片、开关、原文全都正常（`GET /router/api/ext` 实测有 14 条
-* controls），但模型看到的 system prompt 里没有它。
+* prompt**：面板上卡片、开关、原文全都正常（`GET /router/api/ext` 里 controls 一条
+* 不少），但模型看到的 system prompt 里没有它。
 *
 * 根因（本机 cordis 4.0.4 实测）：`ctx.inject(deps, cb)` 的回调**不是同步触发** ——
 * provide 之后立刻 `inject`，回调要等到下一个异步点才跑。插件的 `apply` 是**同步

package/lib/index.js

@@ -6005,355 +6005,6 @@ async function loadSuppliers(opts) {
 	};
 }
 //#endregion
-//#region src/suppliers/probe.ts
-/**
-* 契约成员清单（体检的唯一事实来源）。
-*
-* `required: false` = 差异化能力，按存在性暴露端点/UI；`probe: 'skip'` 的理由都写在这里，
-* 面板会把 `skipReason` 原样显示 —— 用户能知道「有这个能力，只是体检不替你调」。
-*/
-const SUPPLIER_CONTRACT_MEMBERS = [
-	{
-		key: "id",
-		label: "供应商 id",
-		required: true,
-		probe: "safe"
-	},
-	{
-		key: "name",
-		label: "显示名",
-		required: true,
-		probe: "safe"
-	},
-	{
-		key: "priority",
-		label: "优先级",
-		required: false,
-		probe: "safe"
-	},
-	{
-		key: "icon",
-		label: "图标",
-		required: false,
-		probe: "safe"
-	},
-	{
-		key: "apiKeyHint",
-		label: "API key 提示文案",
-		required: false,
-		probe: "safe"
-	},
-	{
-		key: "status",
-		label: "账号状态",
-		required: true,
-		probe: "safe"
-	},
-	{
-		key: "listModels",
-		label: "模型列表",
-		required: true,
-		probe: "safe"
-	},
-	{
-		key: "chatOnce",
-		label: "调用上游",
-		required: true,
-		probe: "skip",
-		skipReason: "会真的发一次请求（消耗额度）。用上面的「跑一次访问测试」单独测，或在供应商详情里测模型。"
-	},
-	{
-		key: "checkinNow",
-		label: "签到",
-		required: false,
-		probe: "skip",
-		skipReason: "会替这个连接真的去签到。"
-	}
-];
-/** 读原始模块实例（`wrapModule` 挂在 wrapper 上）。 */
-function rawModule(loaded) {
-	return loaded.supplier.__module ?? {};
-}
-/** 读出账号状态列表（只读，不改任何东西）。 */
-function accountStates(status) {
-	if (typeof status !== "object" || status === null) return [];
-	const accounts = status.accounts;
-	if (!Array.isArray(accounts)) return [];
-	return accounts.flatMap((a) => {
-		const uid = a?.uid;
-		if (typeof uid !== "string") return [];
-		return [{
-			uid,
-			state: typeof a.state === "string" ? a.state : "ok",
-			cooling: a.cooling === true
-		}];
-	});
-}
-/** 第一个连接 uid（`checkinNow` 之类要真实连接时用）。 */
-function firstAccountUid(m) {
-	return accountStates(m.status())[0]?.uid;
-}
-/** 账号状态分布：`正常 2、冷却 1`、`session_dead 1` 这样。 */
-function accountTally(accounts) {
-	const counts = /* @__PURE__ */ new Map();
-	for (const a of accounts) {
-		const key = a.cooling ? "冷却" : a.state === "ok" ? "正常" : a.state;
-		counts.set(key, (counts.get(key) ?? 0) + 1);
-	}
-	return [...counts].map(([k, n]) => `${k} ${n}`).join("、");
-}
-/**
-* 摘要：把返回值压成一行**对排查有用**的文本。
-*
-* 原先只说「返回 number」「返回 data:image/svg+xml,%3Csvg…」——等于没说话：
-* 体检的意义就是让人一眼看出「priority 是几」「图标给了没有」。
-*/
-function describe(value) {
-	if (value === void 0) return "未提供（可选）";
-	if (value === null) return "返回 null";
-	if (Array.isArray(value)) return `${value.length} 项`;
-	if (typeof value === "string") {
-		if (value.startsWith("data:")) return `已提供（内联 ${value.slice(5, value.indexOf("/") || 12)}）`;
-		if (value === "") return "返回空串";
-		return value.length > 48 ? `返回 ${value.slice(0, 48)}…` : `返回 ${value}`;
-	}
-	if (typeof value === "number" || typeof value === "boolean") return `返回 ${value}`;
-	if (typeof value === "object") {
-		const o = value;
-		if (typeof o.ok === "boolean") return o.ok === false ? `ok:false ${String(o.error ?? o.message ?? "")}`.trim() : "ok:true";
-		return Object.keys(o).slice(0, 4).join(", ") || "空对象";
-	}
-	return `返回 ${typeof value}`;
-}
-/** 异步取一个值并压成摘要（同步抛错也要接住）。 */
-async function probeValue(call) {
-	try {
-		return {
-			ok: true,
-			detail: describe(await call())
-		};
-	} catch (err) {
-		return {
-			ok: false,
-			detail: err.message
-		};
-	}
-}
-/**
-*（这里原本有一份「永不实跑」名单：`dispose` / `addApiKey`。
-*   两者都已移出体检清单，名单随之作废 —— 留着空机制比删掉更糟：
-*   它看起来像个可配置的开关，其实没有任何成员会命中。
-*   「为什么要移」见 PROBE_EXCLUDED_MEMBERS。）
-*/
-/** 深度档用来「不碰真实状态就跑通代码路径」的探针输入。 */
-const PROBE_UID = "__probe_no_such_uid__";
-const PROBE_CALLBACK = "https://invalid.example/__probe__";
-/**
-* 体检一个已装载的供应商。
-*
-* 只跑 `probe: 'safe'` 的成员；`skip` 的只报存在性。绝不代替用户调有副作用的成员。
-*
-* @param models - 该供应商当前的模型启用状态（由调用方用 `router.modelsOf` 取，
-*   走核心缓存不额外打上游）。取不到就传 undefined —— 报告里会如实写「拿不到」，
-*   不能拿 0 冒充「一个模型都没有」。
-*/
-async function probeSupplier(loaded, input = {}) {
-	const m = rawModule(loaded);
-	const members = [];
-	for (const member of SUPPLIER_CONTRACT_MEMBERS) {
-		const present = member.key in m ? m[member.key] !== void 0 : false;
-		const base = {
-			key: member.key,
-			label: member.label,
-			required: member.required,
-			present,
-			executed: present ? "ran" : "no"
-		};
-		if (!present) {
-			members.push({
-				...base,
-				state: member.required ? "fail" : "absent",
-				...member.required ? { detail: "必填成员缺失，插件不完整" } : {}
-			});
-			continue;
-		}
-		const outcome = member.probe === "safe" ? await runSafeProbe(member.key, m, input) : await runProbedMember(member.key, m, input);
-		members.push({
-			...base,
-			state: outcome.ok ? "ok" : outcome.detail.startsWith("无法验证") ? "unverified" : "fail",
-			detail: outcome.detail
-		});
-	}
-	const bulkResult = await runBulkRoundTrip(input);
-	input.models;
-	const summary = {
-		total: members.length,
-		implemented: members.filter((x) => x.present).length,
-		ok: members.filter((x) => x.state === "ok").length,
-		fail: members.filter((x) => x.state === "fail").length,
-		absent: members.filter((x) => x.state === "absent").length,
-		unverified: members.filter((x) => x.state === "unverified").length
-	};
-	const listModels = members.find((x) => x.key === "listModels");
-	return {
-		supplier: loaded.supplier.id,
-		name: loaded.supplier.name,
-		members,
-		core: await coreReport(input, listModels?.state === "ok", bulkResult),
-		summary: {
-			...summary,
-			ran: members.filter((x) => x.executed === "ran" && x.present).length,
-			bulk: bulkResult.ran ? bulkResult.ok === true ? "ok" : "fail" : "unverified"
-		}
-	};
-}
-/**
-* 实跑「有副作用但可以安全试」的成员：要么用**无害探针输入**跑通代码路径，要么用
-* **连接池里的真实连接**真跑一次（前提由使用者保证：池里已放好可用 token）。
-*/
-async function runProbedMember(key, m, input) {
-	try {
-		switch (key) {
-			case "chatOnce": {
-				if (input.runChatOnce === void 0) return {
-					ok: false,
-					detail: "无法验证：没有发起真实调用的入口"
-				};
-				const model = input.models?.find((x) => x.enabled)?.id ?? input.models?.[0]?.id;
-				if (model === void 0) return {
-					ok: false,
-					detail: "无法验证：没有已启用的模型（先启用至少一个）"
-				};
-				const r = await input.runChatOnce(model);
-				return {
-					ok: r.ok,
-					detail: `真实调用 ${model}：${r.ok ? "通了" : `失败（${r.detail}）`}`
-				};
-			}
-			case "checkinNow": {
-				const uid = firstAccountUid(m);
-				if (uid === void 0) return {
-					ok: false,
-					detail: "无法验证：连接池里没有可用连接（先加一个 token）"
-				};
-				const v = await m.checkinNow?.(uid);
-				return {
-					ok: v?.ok !== false,
-					detail: `对连接 ${uid} 真实签到：${describe(v)}`
-				};
-			}
-			case "generateLoginUrl": return {
-				ok: true,
-				detail: describe(await m.generateLoginUrl?.())
-			};
-			case "completeLogin": return {
-				ok: true,
-				detail: `无效回调实跑：${describe(await m.completeLogin?.(PROBE_CALLBACK))}（没抛错即通过）`
-			};
-			case "removeLink": {
-				const v = await m.removeLink?.(PROBE_UID);
-				return {
-					ok: v !== false,
-					detail: `不存在的连接实跑：${describe(v)}`
-				};
-			}
-			default: return {
-				ok: true,
-				detail: "未纳入自动实跑"
-			};
-		}
-	} catch (err) {
-		return {
-			ok: false,
-			detail: `实跑抛错（这本身就是一条问题）：${err.message}`
-		};
-	}
-}
-/** 核心代劳的能力区：模型启用/禁用状态 + 那几个改配置的操作（只报可用性）。 */
-/** 核心区：模型启用状态 + 「全部启用/禁用」实跑结果。 */
-async function coreReport(input, modelsProbed, bulk) {
-	const models = input.models;
-	const enabled = models?.filter((m) => m.enabled).length;
-	const disabled = models === void 0 ? void 0 : models.length - (enabled ?? 0);
-	return {
-		models: {
-			total: models?.length ?? null,
-			enabled: enabled ?? 0,
-			disabled: disabled ?? 0,
-			...models === void 0 ? { note: modelsProbed ? "拿不到模型列表" : "listModels 不可用，无法读启用状态" } : {}
-		},
-		operations: [{
-			key: "models.bulk",
-			label: "模型全部启用 / 全部禁用",
-			ran: bulk.ran,
-			...bulk.ok === void 0 ? {} : { ok: bulk.ok },
-			detail: bulk.detail
-		}]
-	};
-}
-/**
-* 实跑「全部禁用 → 看列表 → 全部启用」。
-*
-* 违规的插件会在这里露馅：它把已禁用的模型从 `listModels` 里过滤掉了，于是全部禁用
-* 之后核心**看不到任何一个模型** —— 用户点「全部启用」也就再也点不回来了
-* （路由里没有可用的模型 id 可传）。
-*/
-async function runBulkRoundTrip(input) {
-	if (input.runBulkToggleRoundTrip === void 0) return {
-		ran: false,
-		detail: "没有模型可禁用"
-	};
-	try {
-		const r = await input.runBulkToggleRoundTrip();
-		return {
-			ran: true,
-			ok: r.ok,
-			detail: r.detail
-		};
-	} catch (err) {
-		return {
-			ran: true,
-			ok: false,
-			detail: `实跑抛错：${err.message}`
-		};
-	}
-}
-/** 无副作用成员的实跑。**每个 case 都必须没有副作用** —— 新增成员时照此办理。 */
-async function runSafeProbe(key, m, input) {
-	switch (key) {
-		case "id":
-		case "name":
-		case "priority":
-		case "icon":
-		case "apiKeyHint": {
-			const value = m[key];
-			if (value === void 0) return {
-				ok: true,
-				detail: "未提供（可选）"
-			};
-			return {
-				ok: true,
-				detail: describe(value)
-			};
-		}
-		case "status": {
-			const r = await probeValue(() => m.status());
-			if (!r.ok) return r;
-			const accounts = accountStates(m.status());
-			return {
-				ok: true,
-				detail: accounts.length === 0 ? "无账号（无账号直连型供应商）" : `${accounts.length} 个账号：${accountTally(accounts)}`
-			};
-		}
-		case "listModels": return await probeValue(() => m.listModels());
-		case "pollLogin": return await probeValue(() => m.pollLogin?.());
-		default: return {
-			ok: true,
-			detail: "未纳入自动探测"
-		};
-	}
-}
-//#endregion
 //#region src/suppliers/registry.ts
 function writeJson$1(res, status, body) {
 	const payload = JSON.stringify(body);
@@ -6487,76 +6138,6 @@ function supplierRoutes(base, loaded, store, router) {
 			});
 		}
 	});
-	routes.push({
-		kind: "exact",
-		path: `${p}/probe`,
-		handler: async (req, res) => {
-			if (req.method !== "POST") {
-				writeJson$1(res, 405, {
-					ok: false,
-					error: "probe requires POST"
-				});
-				return;
-			}
-			try {
-				let pick = {};
-				const raw = (await readBody$2(req)).trim();
-				if (raw !== "") {
-					const body = JSON.parse(raw);
-					pick = {
-						...typeof body.model === "string" ? { model: body.model } : {},
-						...typeof body.uid === "string" ? { uid: body.uid } : {}
-					};
-				}
-				writeJson$1(res, 200, {
-					ok: true,
-					report: await probeSupplier(loaded, {
-						models: await router.modelsOf(s.id).catch(() => void 0),
-						runBulkToggleRoundTrip: async () => {
-							const original = [...store.get(s.id).disabled];
-							const ids = (await router.modelsOf(s.id)).map((mm) => mm.id);
-							if (ids.length === 0) return {
-								ok: true,
-								detail: "该供应商没有模型，跳过"
-							};
-							try {
-								store.setAllModelsEnabled(s.id, false, ids);
-								router.invalidateModels(s.id);
-								const after = await router.modelsOf(s.id, true);
-								const hidden = after.filter((mm) => !mm.enabled).length;
-								const missing = ids.length - after.length;
-								if (hidden !== ids.length || missing !== 0) return {
-									ok: false,
-									detail: `全部禁用后只剩 ${after.length}/${ids.length} 个 —— 插件在 listModels 里藏了已禁用的模型（启用状态由核心合并）`
-								};
-								return {
-									ok: true,
-									detail: `全部禁用后 ${after.length} 个都在，再启用可恢复`
-								};
-							} finally {
-								store.setAllModelsEnabled(s.id, true, ids);
-								for (const id of original) store.setAllModelsEnabled(s.id, false, [id]);
-								router.invalidateModels(s.id);
-								await router.modelsOf(s.id, true);
-							}
-						},
-						runChatOnce: async (model) => {
-							const r = await router.testModel(s.id, model, pick.uid);
-							return {
-								ok: r.ok,
-								detail: r.ok ? "通了" : r.error ?? "上游没给原因"
-							};
-						}
-					})
-				});
-			} catch (err) {
-				writeJson$1(res, 500, {
-					ok: false,
-					error: err.message
-				});
-			}
-		}
-	});
 	routes.push({
 		kind: "exact",
 		path: `${p}/alias`,

package/lib/types/ext/contract.d.ts

@@ -181,7 +181,7 @@ export interface ExtControl {
     /**
      * 分组名（可选；缺省 = 无组）—— 面板按它把控制条**分节**渲染，组间插一条
      * 组标题行，组内顺序照旧。**无组的条目照旧平铺** ⇒ 没用这个字段的扩展
-     * （ext-test 等）面板行为一个像素都不变。
+     * 面板行为一个像素都不变。
      *
      * 为什么要有：一条扩展同时管两类东西时（分层提示词 = 准则分类 + 宿主段落），
      * 平铺成一长列会让"哪条是准则、哪条是宿主的段"无从分辨 —— 分组是**归属

package/lib/types/ext-prompt/content.d.ts

@@ -26,6 +26,17 @@
  *      `categories`/`text`/`order` 里残留的 `hardening` 键无须迁移 ——
  *      `resolveCategories` 规则 2 会忽略不认识的 id。
  *   ② 身份气质：「默认中文」→「回复、思考过程必须使用中文」。
+ *
+ * ⚠️ 2026-10-27 用户点名的四处改动：
+ *   ① **删掉「可判定」分类**（整条移除，id `verdifiable`）；已存配置里的残留键
+ *      由 `resolveCategories` 忽略，无须迁移。
+ *   ② **删掉「绝不偷懒」分类**（整条移除，id `no-cheap`）——用户判定它与别处重复。
+ *   ③ 执行顺序重写：去掉「查结构行号 / 声明任务四件套 / 读码取切片 / 循既有骨架 /
+ *      以闸门为准」几段，改为「循既有架构/提出更优架构 → 验证以测试/e2e 验收」；
+ *      并在首尾补上「读文档」与「更新文档」—— 任务不是从零开始，也不以提交收尾。
+ *   ④ **新增「文档」分类**（id `doc`）：用户口述「文档不写流水账、只写权威内容」
+ *      + 点名范围「docs/ 下的调研、设计、任务」，本文件只做润色。
+ *      排在「全局收口」之后 —— 收口查"文档过期没有"，这条管"文档该写什么"。
  */
 /** 一个可独立开关的提示词分类。 */
 export interface PromptCategory {

package/lib/types/ext-prompt/index.d.ts

@@ -2,14 +2,12 @@
  * 分层提示词扩展的 **cordis 行** —— 官方插件页（设置 → 插件 → dsh-router-core）详情页
  * 原生「包含的组件」里的那一行。
  *
- * 壳的形状与 `ext-test` 同款（cordis 身份 + 登记，实现 = `plugin.ts`），
- * 但**多一件执行面的事**：挂 system prompt 段落。ext-test 不做拦截、只登记；
- * 本扩展要把准则真注入，所以额外等 `systemPrompt` service 就绪后挂 section。
+ * 壳的形状 = cordis 身份 + 登记，实现 = `plugin.ts`；**执行面的事**是挂
+ * system prompt 段落 —— 所以额外等 `systemPrompt` service 就绪后挂 section。
  *
- * **默认开启**（patch 里不带 `disabled`，与三行内置供应商一致）：
- * 协作准则是每次协作都要的基础设施，不是可选增强。与 `ext-test` 的
- * `disabled: true` **刻意不同** —— 自检是「想跑才跑」的工具，准则不是；
- * 让准则默认缺席，会变成「用户不知道它存在 ⇒ 协作按另一套规则执行」。
+ * **默认关闭**（patch 里 `disabled: true`）：开不开由用户决定。行关闭时 loader
+ * 根本不 import 本模块，扩展就不在 `router.ext` 表里 ——「打开才出现这张卡片」
+ * 是天然的，不需要额外状态位。
  *
  * 登记时把扩展开关置为开：本扩展**没有独立的运行期开关**，它的开关就是这一行
  * （宿主管的那个）。不置上的话，用户开了行还要再点一次，两级开关说同一件事。
@@ -22,8 +20,8 @@ export declare const name = "dsh-router-ext-prompt";
  *
  * ⚠️⚠️ **必须导出这个数组，且 `apply` 里直接用 `ctx.systemPrompt`**（2026-09-29 修）
  * ——我原先写成「在 apply 里 `ctx.inject(['systemPrompt'], cb)`」，**准则一直不进
- * prompt**：面板上卡片、开关、原文全都正常（`GET /router/api/ext` 实测有 14 条
- * controls），但模型看到的 system prompt 里没有它。
+ * prompt**：面板上卡片、开关、原文全都正常（`GET /router/api/ext` 里 controls 一条
+ * 不少），但模型看到的 system prompt 里没有它。
  *
  * 根因（本机 cordis 4.0.4 实测）：`ctx.inject(deps, cb)` 的回调**不是同步触发** ——
  * provide 之后立刻 `inject`，回调要等到下一个异步点才跑。插件的 `apply` 是**同步

package/lib/types/ext-prompt/mount.d.ts

@@ -2,9 +2,9 @@
  * 挂载层 —— 把准则注册成 `ctx.systemPrompt` 的**一个**段落。
  *
  * ════════════════════════════════════════════════════════════════════
- * 为什么只注册一段，而不是 14 段
+ * 为什么只注册一段，而不是一段一个分类
  * ════════════════════════════════════════════════════════════════════
- * 面板开关的粒度是「分类」，但 prompt 读起来应该是一段连续的准则。分成 14 段
+ * 面板开关的粒度是「分类」，但 prompt 读起来应该是一段连续的准则。分成多段
  * 会让 KV cache 每个分类各占一段，且**增删任意一个分类都让它之后的全部分位**。
  * 一段 + 拼装 ⇒ 分类增删只改这一段内部，段的位置与前缀稳定。
  *

package/lib/types/ext-prompt/plugin.d.ts

@@ -1,16 +1,14 @@
 /**
  * 分层提示词扩展（`router.ext` 侧的实现）—— 声明与状态都在这里。
  *
- * 与 `ext-test`（插件自检）同款：**不挂任何监听、不改写任何东西**，
- * 唯一作用是让用户在官方插件页里看到一张卡片、能开关它，并把协作准则
- * 注册成一段 system prompt。
+ * **不挂任何监听、不改写任何东西**，唯一作用是让用户在官方插件页里看到一张
+ * 卡片、能开关它，并把协作准则注册成一段 system prompt。
  *
  * 与 `rtk` / `jev` 那类扩展的区别要写清楚：那两家挂 `tools/execute`
  * 改写**工具调用**；本扩展只往 **system prompt** 加一段。名字同族是因为
  * 都在 `router.ext` 这张表里，拦截面不重叠。
  *
- * 复用 `router.ext` 通道只为拿到**发现 + 开关**两件事（见 ext-test 的同款说明），
- * 真正的注入在 `mount.ts`。
+ * 复用 `router.ext` 通道只为拿到**发现 + 开关**两件事，真正的注入在 `mount.ts`。
  */
 import type { ExtStoreService, RouterExt } from '../ext/contract.ts';
 import { type SectionEntry } from './sections.ts';

package/lib/types/router/types.d.ts

@@ -32,7 +32,18 @@ export interface SupplierStatus {
 }
 /** OpenAI 模型条目。 */
 export interface ModelInfo {
+    /** 上游的模型 key（**唯一标识**：组合存它、路由认它、上游收它）。 */
     id: string;
+    /**
+     * 可读名（上游自己写的，如 `Qwen3.8-Max`）。**只用于显示**，缺省 = `id`。
+     *
+     * 为什么需要它：有些上游的 key 是内部标识（Qoder 的 `qmodel_38max`、
+     * `kmodel_latest`），面板上只剩一串猜不出含义的字母。既然上游在目录里
+     * 同时下发了 `display_name`，丢掉它就是把可读信息换成噪声。
+     * 反过来，**凡是"发给上游/存下来"的地方都得继续用 `id`**——用名字去请求
+     * 上游只会拿到 404。
+     */
+    name?: string;
     context_length?: number;
 }
 /** 面板展示的模型（含启用状态）。 */

package/lib/types/shared.d.ts

@@ -218,6 +218,8 @@ export interface RouterExtResponse {
 /** 供应商模型（含启用状态）。 */
 export interface RouterSupplierModel {
     id: string;
+    /** 可读名（上游写的，只用于显示；缺省 = id）。见 `ModelInfo.name`。 */
+    name?: string;
     context_length?: number;
     enabled: boolean;
     /** 是否为自定义（手动添加 / 拉取）模型，可删除。 */

package/lib/types/suppliers/registry.d.ts

@@ -3,7 +3,6 @@
  *
  * 通用能力（dsh-router 核心，所有供应商自动可用，js 无需实现）：
  *   GET    /suppliers/:id/models                  models + alias（listModels 合并启用状态）
- *   POST   /suppliers/:id/probe                  契约体检：逐成员报「实现/可用/不执行」
  *   PATCH  /suppliers/:id/enabled                 {enabled} —— 供应商开关（关掉不参与路由）
  *   POST   /suppliers/:id/models/toggle           {id, enabled}
  *   POST   /suppliers/:id/models/add              {id}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-router-core",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "description": "DSH plugin: a simplified 9router (AI routing gateway). Adds a 路由系统 (Routing System) sidebar entry beside 记忆系统; the panel shows suppliers, account pool, combos, and endpoint/API keys.",
   "type": "module",
   "repository": {
@@ -36,12 +36,6 @@
     },
     "./suppliers/nvidia/package.json": "./lib/suppliers/nvidia/package.json",
     "./suppliers/nvidia/locale/*.json": "./lib/suppliers/nvidia/locale/*.json",
-    "./ext-test": {
-      "types": "./lib/types/ext-test/index.d.ts",
-      "default": "./lib/ext-test/index.js"
-    },
-    "./ext-test/package.json": "./lib/ext-test/package.json",
-    "./ext-test/locale/*.json": "./lib/ext-test/locale/*.json",
     "./ext-prompt": {
       "types": "./lib/types/ext-prompt/index.d.ts",
       "default": "./lib/ext-prompt/index.js"
@@ -79,9 +73,6 @@
     "lib/suppliers/*/index.js",
     "lib/suppliers/*/package.json",
     "lib/suppliers/*/locale/*.json",
-    "lib/ext-test/index.js",
-    "lib/ext-test/package.json",
-    "lib/ext-test/locale/*.json",
     "lib/ext-prompt/index.js",
     "lib/ext-prompt/package.json",
     "lib/ext-prompt/locale/*.json",