dsh-llm-fallbacks 0.2.0 → 0.2.2

package/dist/client/index.js

@@ -63,7 +63,8 @@ window.__ModuleLoader__.load({
 			revertPolicy: "cooldown-expiry",
 			maxSwitchesPerStep: 8,
 			alwaysModeRetryCap: 5,
-			presets: "bundled"
+			presets: "bundled",
+			roleAutoMatch: true
 		};
 		/**
 		* Reserved role id: legal as a rule target (`roles.rules[].role`) and as
@@ -192,6 +193,8 @@ window.__ModuleLoader__.load({
 			if (presets !== void 0 && presets !== "bundled" && presets !== "none") throw new TypeError("fallbacks descriptor presets must be bundled|none");
 			const enabled = value.enabled;
 			if (enabled !== void 0 && typeof enabled !== "boolean") throw new TypeError("fallbacks descriptor enabled must be a boolean");
+			const roleAutoMatch = value.roleAutoMatch;
+			if (roleAutoMatch !== void 0 && typeof roleAutoMatch !== "boolean") throw new TypeError("fallbacks descriptor roleAutoMatch must be a boolean");
 			return {
 				enabled: enabled ?? defaultFallbacksConfig.enabled,
 				triggerCodes: triggerCodes ?? [...defaultFallbacksConfig.triggerCodes],
@@ -204,7 +207,8 @@ window.__ModuleLoader__.load({
 				revertPolicy: revertPolicy ?? defaultFallbacksConfig.revertPolicy,
 				maxSwitchesPerStep: maxSwitchesPerStep ?? defaultFallbacksConfig.maxSwitchesPerStep,
 				alwaysModeRetryCap: alwaysModeRetryCap ?? defaultFallbacksConfig.alwaysModeRetryCap,
-				presets: presets ?? defaultFallbacksConfig.presets
+				presets: presets ?? defaultFallbacksConfig.presets,
+				roleAutoMatch: roleAutoMatch ?? defaultFallbacksConfig.roleAutoMatch
 			};
 		}
 		/** The raw selector string a selection serializes to ('' when empty). */
@@ -262,46 +266,6 @@ window.__ModuleLoader__.load({
 			switches.sort((a, b) => b.seq - a.seq);
 			return switches.slice(0, limit);
 		}
-		/** The config's primary target: the rootChain's first entry (D-6 ③). */
-		function configPrimaryTarget(config) {
-			const firstEntry = config.rootChain[0];
-			if (firstEntry === void 0) return null;
-			try {
-				const selector = parseSelector(firstEntry);
-				return {
-					provider: selector.provider,
-					model: selector.model ?? "*"
-				};
-			} catch {
-				return {
-					provider: firstEntry,
-					model: "*"
-				};
-			}
-		}
-		/**
-		* Derive the status block's "current effective model" (spec §2.5 D-6): ①
-		* disabled / empty rootChain → unavailable; ② a recent switch exists → the
-		* latest one's `to`; ③ otherwise → the config's primary target. A **display
-		* value** — never a live route probe (the section appends the non-probing
-		* note inline right after the derived value, available case only; the
-		* unavailable 空态 renders its own copy without the note).
-		*/
-		function deriveEffectiveModel(config, switches) {
-			if (!config.enabled || config.rootChain.length === 0) return { kind: "unavailable" };
-			const latest = switches[0];
-			if (latest !== void 0) return {
-				kind: "switched",
-				provider: latest.to.provider,
-				model: latest.to.model
-			};
-			const target = configPrimaryTarget(config);
-			if (target === null) return { kind: "unavailable" };
-			return {
-				kind: "config",
-				...target
-			};
-		}
 		/** Serialize one selector row to its wire string (`provider/model` | `provider/*`). */
 		function selectorRowToRaw(row) {
 			const provider = selectionToRaw(row.provider);
@@ -850,8 +814,12 @@ window.__ModuleLoader__.load({
 			"advanced.label": "高级选项",
 			"advanced.expand": "展开高级选项",
 			"advanced.collapse": "收起高级选项",
+			"roleAutoMatch.label": "启用角色自动匹配",
+			"roleAutoMatch.hint": "规则未命中时，由模型自选最贴近的已声明角色",
+			"roleAutoMatch.tooltip": "规则未命中时，模型会自动从已声明角色（id + persona）中选择最匹配者并注入该角色的链；关闭后未命中规则时按现状回落（inherit / rootChain）。",
 			"rootChain.label": "root 主代理降级链",
-			"rootChain.hint": "未配置 = root 不降级",
+			"rootChain.firstLine": "仅当当前会话所选模型失败后才启用降级——不抢占会话模型",
+			"rootChain.hint": "优先使用当前会话的模型；失败后才按此链降级",
 			"rootChain.tooltip": "root 主代理失败时按此有序选择器列表依次降级；未配置时行为与未安装插件一致。",
 			"rootChain.selector.add": "添加选择器",
 			"chains.selector.remove": "删除该选择器",
@@ -911,26 +879,27 @@ window.__ModuleLoader__.load({
 			"catalog.outside.short": " （目录外）",
 			"catalog.unconfigured.short": " （未配置）",
 			"status.title": "运行状态（只读）",
-			"status.effectiveModel.label": "当前生效模型：",
-			"status.effectiveModel.unavailable": "fallbacks 未启用（或 rootChain 未配置）",
-			"status.effectiveModel.note": "配置 + 最近切换推导，非实时路由探测",
 			"status.switches.label": "最近切换：",
 			"status.switches.empty": "本会话暂无 fallback 切换。",
 			"status.switches.error": "切换历史读取失败：{message}",
 			"status.switches.compact": "最近 {count} 次 · {from} → {to}（{role} · {reason}）",
+			"status.switches.compact.roleInject": "最近 {count} 次 · {role} → {to}（{reason}）",
 			"status.switches.reason.trigger-code": "触发失败码",
 			"status.switches.reason.always-cap": "always 模式上限",
-			"status.selectionNote": "说明：web 前端手动选择的模型可能在切换后重新套用（标记载体已随本地 patch 移除）。",
+			"status.switches.reason.role-inject": "角色注入",
 			"general.title": "模型故障降级",
 			"general.enabled": "已启用",
 			"general.disabled": "未启用",
 			"general.unknown": "未知",
 			"general.unavailable": "状态通道暂不可达",
 			"general.switch": "最近切换：{from} → {to}（{role} · {reason}）",
+			"general.switch.roleInject": "最近切换：{role} → {to}（{reason}）",
 			"general.switch.empty": "本会话暂无切换",
 			"general.error": "状态读取失败：{message}",
 			"chat.switch.title": "模型已降级",
-			"chat.switch.summary": "{from} → {to}（{role} · {reason}）",
+			"chat.switch.summary": "{from} → {to}（{reason}）",
+			"chat.switch.summary.roleInject": "（{reason}）",
+			"chat.switch.roleMap": "{role} → {model}",
 			"defaults.prefix": "默认值",
 			"save": "保存",
 			"save.saving": "保存中…",
@@ -984,8 +953,12 @@ window.__ModuleLoader__.load({
 			"advanced.label": "Advanced options",
 			"advanced.expand": "Show advanced options",
 			"advanced.collapse": "Hide advanced options",
+			"roleAutoMatch.label": "Enable role auto-match",
+			"roleAutoMatch.hint": "On rules-miss, the model picks the closest declared role",
+			"roleAutoMatch.tooltip": "When no rule matches, the model auto-selects the best-fit declared role (id + persona) and uses its chain; turn off to keep today's fallback (inherit / rootChain) on a rules-miss.",
 			"rootChain.label": "Root agent fallback chain",
-			"rootChain.hint": "Unset = root does not fall back",
+			"rootChain.firstLine": "Engages only after the current session's selected model fails — it never preempts the session model",
+			"rootChain.hint": "Prefer the current session's model; degrade down this chain only after it fails",
 			"rootChain.tooltip": "When the root agent fails it falls back down this ordered selector list; unset behaves like an uninstalled plugin.",
 			"rootChain.selector.add": "Add selector",
 			"chains.selector.remove": "Remove this selector",
@@ -1045,26 +1018,27 @@ window.__ModuleLoader__.load({
 			"catalog.outside.short": " (outside catalog)",
 			"catalog.unconfigured.short": " (not configured)",
 			"status.title": "Runtime status (read-only)",
-			"status.effectiveModel.label": "Current effective model: ",
-			"status.effectiveModel.unavailable": "Fallbacks disabled (or rootChain not configured)",
-			"status.effectiveModel.note": "Derived from configuration and recent switches; not real-time route probing",
 			"status.switches.label": "Recent switches: ",
 			"status.switches.empty": "No fallback switches in this session yet.",
 			"status.switches.error": "Switch history read failed: {message}",
 			"status.switches.compact": "last {count} · {from} → {to} ({role} · {reason})",
+			"status.switches.compact.roleInject": "last {count} · {role} → {to} ({reason})",
 			"status.switches.reason.trigger-code": "trigger code",
 			"status.switches.reason.always-cap": "always-mode cap",
-			"status.selectionNote": "Note: a model manually selected in the web front end may be re-applied after a switch (the marker coordination shipped with the local patch has been removed).",
+			"status.switches.reason.role-inject": "role inject",
 			"general.title": "Model failover",
 			"general.enabled": "Enabled",
 			"general.disabled": "Disabled",
 			"general.unknown": "Unknown",
 			"general.unavailable": "Status channel unavailable",
 			"general.switch": "Last switch: {from} → {to} ({role} · {reason})",
+			"general.switch.roleInject": "Last switch: {role} → {to} ({reason})",
 			"general.switch.empty": "No switches this session",
 			"general.error": "Status read failed: {message}",
 			"chat.switch.title": "Model downgraded",
-			"chat.switch.summary": "{from} → {to} ({role} · {reason})",
+			"chat.switch.summary": "{from} → {to} ({reason})",
+			"chat.switch.summary.roleInject": "({reason})",
+			"chat.switch.roleMap": "{role} → {model}",
 			"defaults.prefix": "Default",
 			"save": "Save",
 			"save.saving": "Saving…",
@@ -1084,13 +1058,17 @@ window.__ModuleLoader__.load({
 		const NS = "fallbacks";
 		/**
 		* Reason → locale key map for switch summaries (S-c; shared by the card's
-		* status block and the General page status row). The session log is durable
-		* and forward-compatible: a reason value outside the current union (a newer
-		* plugin wrote it) renders raw instead of falling into a binary else branch.
+		* status block, the General page status row, and the conversation node). All
+		* reasons resolve from ONE key family (`status.switches.reason.*`) — the
+		* shared reason vocabulary must not mix dictionary families (qc1 F-004). The
+		* session log is durable and forward-compatible: a reason value outside the
+		* current union (a newer plugin wrote it) renders raw instead of falling
+		* into a binary else branch.
 		*/
 		const SWITCH_REASON_KEYS = {
 			"trigger-code": "status.switches.reason.trigger-code",
-			"always-cap": "status.switches.reason.always-cap"
+			"always-cap": "status.switches.reason.always-cap",
+			"role-inject": "status.switches.reason.role-inject"
 		};
 		/** Human-readable trigger-code labels (spec §4 用户直观性). */
 		const TRIGGER_CODE_LABELS = {
@@ -1186,9 +1164,10 @@ window.__ModuleLoader__.load({
 		//#region src/client/FallbacksCard.tsx
 		/**
 		* Fallbacks settings card — the `fallbacks` plugin card on the web settings
-		* "插件配置" page (spec §4). Registered into the `settings.plugin.item` slot
-		* (id `fallbacks`, order 30, alongside the upstream bash/agent-loop/web-search
-		* cards and the advisor card); owner props are empty and all data flows
+		* "插件配置" page (spec §4). Registered into the `settings.plugin.item` keyed
+		* slot (key `fallbacks`, the settings namespace the card edits, alongside
+		* the upstream bash/agent-loop/web-search cards and the advisor card, in
+		* registration order); owner props are empty and all data flows
 		* through {@link FallbacksSettingsController}.
 		*
 		* The card chrome replicates the upstream `PluginCard` contract (self-drawn:
@@ -1257,7 +1236,8 @@ window.__ModuleLoader__.load({
 				cooldownMs: config.cooldownMs,
 				revertPolicy: config.revertPolicy,
 				maxSwitchesPerStep: config.maxSwitchesPerStep,
-				alwaysModeRetryCap: config.alwaysModeRetryCap
+				alwaysModeRetryCap: config.alwaysModeRetryCap,
+				roleAutoMatch: config.roleAutoMatch
 			};
 		}
 		/**
@@ -1269,8 +1249,14 @@ window.__ModuleLoader__.load({
 		* the top level: no presets UI this iteration (R-001 re-defer), so the
 		* draft carries the accepted value through untouched — a clean draft stays
 		* equal to the accepted config and a save never drops the key.
+		* `roleAutoMatch` follows the same rule (config-model mirror of `presets`):
+		* the draft carries the scalar's value through untouched. The scalar is
+		* ALWAYS defined — the gateway composition resolves the schema default
+		* `true` even for a legacy config that never declared the key — so the
+		* toggle always renders (default on) and a save persists the resolved value
+		* (AC-7 re-scope, PM decision 2026-08-17 Option A).
 		*/
-		function assembleConfig(scalars, rootChainRows, roleRows, ruleRows, originalRoles, presets) {
+		function assembleConfig(scalars, rootChainRows, roleRows, ruleRows, originalRoles, presets, roleAutoMatch) {
 			const list = mergeRoleExtras(roleRows, originalRoles);
 			return {
 				enabled: scalars.enabled,
@@ -1284,7 +1270,8 @@ window.__ModuleLoader__.load({
 				revertPolicy: scalars.revertPolicy,
 				maxSwitchesPerStep: scalars.maxSwitchesPerStep,
 				alwaysModeRetryCap: scalars.alwaysModeRetryCap,
-				...presets === void 0 ? {} : { presets }
+				...presets === void 0 ? {} : { presets },
+				roleAutoMatch
 			};
 		}
 		/**
@@ -1660,18 +1647,17 @@ window.__ModuleLoader__.load({
 					return next;
 				});
 			};
-			const draft = assembleConfig(scalars, rootChainRows, roleRows, ruleRows, state.config.roles.list, state.config.presets);
+			const draft = assembleConfig(scalars, rootChainRows, roleRows, ruleRows, state.config.roles.list, state.config.presets, scalars.roleAutoMatch);
 			const hasEmptyRuleRows = ruleRows.some((row) => row.role === "");
 			const dirty = JSON.stringify(draft) !== JSON.stringify(state.config) || hasEmptyRuleRows;
 			const saving = state.status === "saving";
 			const writable = state.writable;
 			const unknownCodes = scalars.triggerCodes.filter((code) => !KNOWN_TRIGGER_CODES.includes(code));
+			const rootChainConfigured = rowsToRootChain(rootChainRows).length > 0;
 			const roleOptions = ruleRoleOptions({ list: roleRows });
 			const invalidRoleIds = validationAttempted ? collectInvalidRoleIds(roleRows) : null;
 			const seededIds = /* @__PURE__ */ new Map();
 			for (const seed of state.seeds) seededIds.set(seed.id.trim(), seed.overridden);
-			const effectiveModel = deriveEffectiveModel(state.config, state.switches);
-			const effectiveModelLine = effectiveModel.kind === "unavailable" ? t("status.effectiveModel.unavailable") : `${effectiveModel.provider}/${effectiveModel.model} · ${t("status.effectiveModel.note")}`;
 			const latestSwitch = state.switches[0];
 			let switchesLine;
 			if (state.switchesStatus === "error") switchesLine = t("status.switches.error", { message: state.switchesError });
@@ -1679,13 +1665,14 @@ window.__ModuleLoader__.load({
 			else if (latestSwitch === void 0) switchesLine = t("status.switches.empty");
 			else {
 				const reasonKey = SWITCH_REASON_KEYS[latestSwitch.reason];
-				switchesLine = t("status.switches.compact", {
+				const params = {
 					count: String(state.switches.length),
 					from: `${latestSwitch.from.provider}/${latestSwitch.from.model}`,
 					to: `${latestSwitch.to.provider}/${latestSwitch.to.model}`,
 					role: latestSwitch.role,
 					reason: reasonKey === void 0 ? latestSwitch.reason : t(reasonKey)
-				});
+				};
+				switchesLine = latestSwitch.reason === "role-inject" ? t("status.switches.compact.roleInject", params) : t("status.switches.compact", params);
 			}
 			const catalogSeededEpoch = (0, react.useRef)(null);
 			(0, react.useEffect)(() => {
@@ -1878,6 +1865,10 @@ window.__ModuleLoader__.load({
 														})]
 													}),
 													/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+														className: FallbacksCard_module_css_default.hint,
+														children: t("rootChain.firstLine")
+													}),
+													scalars.enabled && rootChainConfigured && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 														className: FallbacksCard_module_css_default.hint,
 														children: t("rootChain.hint")
 													}),
@@ -2330,6 +2321,36 @@ window.__ModuleLoader__.load({
 												}), advancedVisible && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 													id: "fallbacks-advanced-body",
 													children: [
+														/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+															className: FallbacksCard_module_css_default.checkboxRow,
+															children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+																className: FallbacksCard_module_css_default.checkLabel,
+																children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+																	className: FallbacksCard_module_css_default.checkLabelTitle,
+																	children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
+																		htmlFor: "fallbacks-role-automatch",
+																		children: t("roleAutoMatch.label")
+																	}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(InfoHint, {
+																		label: t("roleAutoMatch.tooltip"),
+																		disabled: !writable
+																	})]
+																}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+																	className: FallbacksCard_module_css_default.checkLabelDesc,
+																	children: t("roleAutoMatch.hint")
+																})]
+															}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+																id: "fallbacks-role-automatch",
+																type: "checkbox",
+																className: FallbacksCard_module_css_default.checkbox,
+																checked: scalars.roleAutoMatch,
+																disabled: !writable,
+																onChange: (event) => {
+																	updateScalars((draft) => {
+																		draft.roleAutoMatch = event.target.checked;
+																	});
+																}
+															})]
+														}),
 														/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 															className: FallbacksCard_module_css_default.field,
 															role: "group",
@@ -2544,31 +2565,17 @@ window.__ModuleLoader__.load({
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 								className: FallbacksCard_module_css_default.statusBlock,
-								children: [
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-										className: FallbacksCard_module_css_default.statusTitle,
-										children: t("status.title")
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
-										className: FallbacksCard_module_css_default.statusLine,
-										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-											className: FallbacksCard_module_css_default.statusLineLabel,
-											children: t("status.effectiveModel.label")
-										}), effectiveModelLine]
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
-										className: FallbacksCard_module_css_default.statusLine,
-										role: state.switchesStatus === "error" ? "alert" : void 0,
-										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-											className: FallbacksCard_module_css_default.statusLineLabel,
-											children: t("status.switches.label")
-										}), switchesLine]
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-										className: FallbacksCard_module_css_default.statusLine,
-										children: t("status.selectionNote")
-									})
-								]
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: FallbacksCard_module_css_default.statusTitle,
+									children: t("status.title")
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
+									className: FallbacksCard_module_css_default.statusLine,
+									role: state.switchesStatus === "error" ? "alert" : void 0,
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: FallbacksCard_module_css_default.statusLineLabel,
+										children: t("status.switches.label")
+									}), switchesLine]
+								})]
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 								className: FallbacksCard_module_css_default.footer,
@@ -2700,12 +2707,13 @@ window.__ModuleLoader__.load({
 			else if (latestSwitch === void 0) summary = t("general.switch.empty");
 			else {
 				const reasonKey = SWITCH_REASON_KEYS[latestSwitch.reason];
-				summary = t("general.switch", {
+				const params = {
 					from: `${latestSwitch.from.provider}/${latestSwitch.from.model}`,
 					to: `${latestSwitch.to.provider}/${latestSwitch.to.model}`,
 					role: latestSwitch.role,
 					reason: reasonKey === void 0 ? latestSwitch.reason : t(reasonKey)
-				});
+				};
+				summary = latestSwitch.reason === "role-inject" ? t("general.switch.roleInject", params) : t("general.switch", params);
 			}
 			const alert = state.status === "error" || state.switchesStatus === "error";
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -2754,7 +2762,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-css:/home/runner/work/dsh-llm-fallbacks/dsh-llm-fallbacks/src/client/ConversationFallbackSwitch.module.css.mjs
-		const css = "\n\n._ea99bbef_switchRow {\n  display: flex;\n  align-items: center;\n  padding: 2px 0;\n  font-size: 14px;\n  line-height: 24px;\n}\n\n\n._02580bfd_switchTitle {\n  flex: none;\n  color: var(--dsw-alias-state-warn-primary);\n}\n\n._88b2d18b_switchSep {\n  flex: none;\n  width: 2px;\n  height: 2px;\n  margin: 0 8px;\n  border-radius: 1px;\n  background: var(--dsw-alias-label-caption);\n}\n\n\n._7c8c1b6f_switchSummary {\n  flex: 1 1 auto;\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  color: var(--dsw-alias-label-tertiary);\n}\n";
+		const css = "\n\n._ea99bbef_switchRow {\n  display: flex;\n  align-items: center;\n  padding: 2px 0;\n  font-size: 14px;\n  line-height: 24px;\n}\n\n\n._02580bfd_switchTitle {\n  flex: none;\n  color: var(--dsw-alias-state-warn-primary);\n}\n\n._88b2d18b_switchSep {\n  flex: none;\n  width: 2px;\n  height: 2px;\n  margin: 0 8px;\n  border-radius: 1px;\n  background: var(--dsw-alias-label-caption);\n}\n\n\n._7c8c1b6f_switchSummary {\n  flex: 1 1 auto;\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  color: var(--dsw-alias-label-tertiary);\n}\n\n\n._fdc977bc_roleBadge {\n  flex: none;\n  max-width: 96px;\n  padding: 0 8px;\n  border-radius: 999px;\n  font-size: 12px;\n  line-height: 20px;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  background: var(--dsw-alias-bg-module-platform);\n  color: var(--dsw-alias-label-primary);\n}\n\n\n._dce8ba28_roleModelMap {\n  flex: 0 1 auto;\n  min-width: 0;\n  margin-left: 8px;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  color: var(--dsw-alias-label-secondary);\n}\n";
 		const tagId = "dsh-llm-fallbacks/ConversationFallbackSwitch.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");
@@ -2767,7 +2775,9 @@ window.__ModuleLoader__.load({
 			"switchRow": "_ea99bbef_switchRow",
 			"switchTitle": "_02580bfd_switchTitle",
 			"switchSep": "_88b2d18b_switchSep",
-			"switchSummary": "_7c8c1b6f_switchSummary"
+			"switchSummary": "_7c8c1b6f_switchSummary",
+			"roleBadge": "_fdc977bc_roleBadge",
+			"roleModelMap": "_dce8ba28_roleModelMap"
 		};
 		//#endregion
 		//#region src/client/ConversationFallbackSwitch.tsx
@@ -2843,12 +2853,8 @@ window.__ModuleLoader__.load({
 				})
 			});
 			const reasonKey = SWITCH_REASON_KEYS[data.reason];
-			const summary = t("chat.switch.summary", {
-				from: `${data.from.provider}/${data.from.model}`,
-				to: `${data.to.provider}/${data.to.model}`,
-				role: data.role,
-				reason: reasonKey === void 0 ? data.reason : t(reasonKey)
-			});
+			const reason = reasonKey === void 0 ? data.reason : t(reasonKey);
+			const isRoleMapped = data.role !== "inherit";
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: ConversationFallbackSwitch_module_css_default.switchRow,
 				role: "status",
@@ -2861,9 +2867,34 @@ window.__ModuleLoader__.load({
 						className: ConversationFallbackSwitch_module_css_default.switchSep,
 						"aria-hidden": "true"
 					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					isRoleMapped ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: ConversationFallbackSwitch_module_css_default.roleBadge,
+							title: data.role,
+							children: data.role
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: ConversationFallbackSwitch_module_css_default.roleModelMap,
+							children: t("chat.switch.roleMap", {
+								role: data.role,
+								model: `${data.to.provider}/${data.to.model}`
+							})
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: ConversationFallbackSwitch_module_css_default.switchSep,
+							"aria-hidden": "true"
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: ConversationFallbackSwitch_module_css_default.switchSummary,
+							children: t("chat.switch.summary.roleInject", { reason })
+						})
+					] }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 						className: ConversationFallbackSwitch_module_css_default.switchSummary,
-						children: summary
+						children: t("chat.switch.summary", {
+							from: `${data.from.provider}/${data.from.model}`,
+							to: `${data.to.provider}/${data.to.model}`,
+							reason
+						})
 					})
 				]
 			});
@@ -2945,8 +2976,7 @@ window.__ModuleLoader__.load({
 			ctx.slots.inject("settings.plugin.item", function* () {
 				yield ctx.slots.register({
 					name: "settings.plugin.item",
-					id: "fallbacks",
-					order: 30,
+					key: "fallbacks",
 					locale: NS,
 					inject: () => ({
 						controller,

package/dist/client/locales.d.ts

@@ -37,7 +37,11 @@ export declare const zh: {
     'advanced.label': string;
     'advanced.expand': string;
     'advanced.collapse': string;
+    'roleAutoMatch.label': string;
+    'roleAutoMatch.hint': string;
+    'roleAutoMatch.tooltip': string;
     'rootChain.label': string;
+    'rootChain.firstLine': string;
     'rootChain.hint': string;
     'rootChain.tooltip': string;
     'rootChain.selector.add': string;
@@ -98,26 +102,27 @@ export declare const zh: {
     'catalog.outside.short': string;
     'catalog.unconfigured.short': string;
     'status.title': string;
-    'status.effectiveModel.label': string;
-    'status.effectiveModel.unavailable': string;
-    'status.effectiveModel.note': string;
     'status.switches.label': string;
     'status.switches.empty': string;
     'status.switches.error': string;
     'status.switches.compact': string;
+    'status.switches.compact.roleInject': string;
     'status.switches.reason.trigger-code': string;
     'status.switches.reason.always-cap': string;
-    'status.selectionNote': string;
+    'status.switches.reason.role-inject': string;
     'general.title': string;
     'general.enabled': string;
     'general.disabled': string;
     'general.unknown': string;
     'general.unavailable': string;
     'general.switch': string;
+    'general.switch.roleInject': string;
     'general.switch.empty': string;
     'general.error': string;
     'chat.switch.title': string;
     'chat.switch.summary': string;
+    'chat.switch.summary.roleInject': string;
+    'chat.switch.roleMap': string;
     'defaults.prefix': string;
     save: string;
     'save.saving': string;
@@ -173,7 +178,11 @@ export declare const en: {
     'advanced.label': string;
     'advanced.expand': string;
     'advanced.collapse': string;
+    'roleAutoMatch.label': string;
+    'roleAutoMatch.hint': string;
+    'roleAutoMatch.tooltip': string;
     'rootChain.label': string;
+    'rootChain.firstLine': string;
     'rootChain.hint': string;
     'rootChain.tooltip': string;
     'rootChain.selector.add': string;
@@ -234,26 +243,27 @@ export declare const en: {
     'catalog.outside.short': string;
     'catalog.unconfigured.short': string;
     'status.title': string;
-    'status.effectiveModel.label': string;
-    'status.effectiveModel.unavailable': string;
-    'status.effectiveModel.note': string;
     'status.switches.label': string;
     'status.switches.empty': string;
     'status.switches.error': string;
     'status.switches.compact': string;
+    'status.switches.compact.roleInject': string;
     'status.switches.reason.trigger-code': string;
     'status.switches.reason.always-cap': string;
-    'status.selectionNote': string;
+    'status.switches.reason.role-inject': string;
     'general.title': string;
     'general.enabled': string;
     'general.disabled': string;
     'general.unknown': string;
     'general.unavailable': string;
     'general.switch': string;
+    'general.switch.roleInject': string;
     'general.switch.empty': string;
     'general.error': string;
     'chat.switch.title': string;
     'chat.switch.summary': string;
+    'chat.switch.summary.roleInject': string;
+    'chat.switch.roleMap': string;
     'defaults.prefix': string;
     save: string;
     'save.saving': string;
@@ -279,9 +289,12 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
 }
 /**
  * Reason → locale key map for switch summaries (S-c; shared by the card's
- * status block and the General page status row). The session log is durable
- * and forward-compatible: a reason value outside the current union (a newer
- * plugin wrote it) renders raw instead of falling into a binary else branch.
+ * status block, the General page status row, and the conversation node). All
+ * reasons resolve from ONE key family (`status.switches.reason.*`) — the
+ * shared reason vocabulary must not mix dictionary families (qc1 F-004). The
+ * session log is durable and forward-compatible: a reason value outside the
+ * current union (a newer plugin wrote it) renders raw instead of falling
+ * into a binary else branch.
  */
 export declare const SWITCH_REASON_KEYS: Readonly<Partial<Record<FallbackSwitchReason, FallbacksKey>>>;
 /** Human-readable trigger-code labels (spec §4 用户直观性). */

package/dist/commands.d.ts

@@ -95,6 +95,8 @@ export interface FallbacksConfigSummary {
     readonly maxSwitchesPerStep: number;
     readonly alwaysModeRetryCap: number;
     readonly presets: 'bundled' | 'none';
+    /** Dispatch-time LLM role auto-match switch (default true). */
+    readonly roleAutoMatch: boolean;
 }
 /**
  * The session-scoped read-only operations the `/fallbacks` handler drives.
@@ -148,6 +150,7 @@ export declare const FALLBACKS_COMMAND_LOCALES: {
         readonly configMaxSwitches: "单步最大切换";
         readonly configAlwaysCap: "always 上限";
         readonly configPresets: "预置";
+        readonly configRoleAutoMatch: "角色自动匹配";
         readonly configEdit: "编辑：~/.dsh/profiles/<profile>/cordis.patch.yml（插件行）或 $DSH_HOME/settings.yaml（fallbacks: 分节）";
         readonly configEditHint: "TUI 无法修改配置——只能编辑文件";
     };
@@ -185,6 +188,7 @@ export declare const FALLBACKS_COMMAND_LOCALES: {
         readonly configMaxSwitches: "Max switches/step";
         readonly configAlwaysCap: "Always-mode cap";
         readonly configPresets: "Presets";
+        readonly configRoleAutoMatch: "Auto-match";
         readonly configEdit: "Edit: ~/.dsh/profiles/<profile>/cordis.patch.yml (plugin row) or $DSH_HOME/settings.yaml (fallbacks: section)";
         readonly configEditHint: "TUI cannot change config — edit files only";
     };

package/dist/config.d.ts

@@ -91,6 +91,19 @@ export interface FallbacksConfig {
      * every resolved config carries a value via the schema default.
      */
     presets?: 'bundled' | 'none';
+    /**
+     * Dispatch-time LLM role auto-match switch (plan fallbacks-role-automatch
+     * Task 1): when `true` (default), a subagent-origin request with no
+     * explicit/rules-resolved role may have the best-fit declared role picked
+     * by the LLM; `false` reproduces today's behavior exactly. Optional on
+     * purpose, mirroring `presets` — a required field would break library
+     * consumers that construct `FallbacksConfig` literals with the existing
+     * keys (additive, non-breaking). The value domain is guarded by the
+     * schema (`z.boolean().default(true)` in `src/schema.ts`), and the
+     * runtime reads it defensively as `config.roleAutoMatch ?? true` (safe
+     * for direct constructors that omit it).
+     */
+    roleAutoMatch?: boolean;
 }
 /**
  * Spec §4 defaults — `Config({})` must equal this (no-op install).