dsh-model-switch 0.4.21 → 0.4.22

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## v0.4.22
+
+One addition: per-provider capability groups — save the compaction, subagent, and review routes together for a provider, and apply that group automatically when the main model's provider changes.
+
+- **Provider groups.** New settings card (供应商配置组 / Provider groups) stores one route group per provider in the existing shared `model-switch` namespace (`providerGroups`, an entry array normalized to a provider map) covering exactly the three session-level capability routes — compaction, subagent, and auto review; search and image stay out of scope. Applying a group is a **full replacement** through one ordered write sequence: the pinned pairs are set, pairs the group does not pin are unset as a pair (never a half pair), and `subagentMode` is written last (`fixed` when the subagent pair is pinned — with its effort only when the effort is non-blank, blank meaning the provider default — else `follow-main`), so every unpinned capability reverts to its own default. Two plugin-owned switch surfaces trigger the apply: the composer picker's `directoryFace.select()` and the Main card's `saveMain()`, both gated on an actual provider change; a same-provider switch, a provider without a stored group, or any other switch surface (TUI) writes nothing. The apply rides the public ConfigForm `set`/`unset` onto the existing flat settings fields, so the consumers (`compaction.ts`, `subagent-runtime.ts`, `auto-review.ts`) are untouched, and the effect is profile-level like the fields it writes. Failures never fail the switch or the Main save: the picker logs a warning and still commits, while the Main card surfaces "Main model saved, but applying the provider group failed …". In the editor, a provider's draft seeds from the active routes the first time it is configured, each capability switch seeds from Main when turned on and stores the capability default when off, applying a group overwrites the three standalone cards (including manual edits, stated in the card copy), and **Delete group** removes the provider's entry (clearing the stored field when the last group goes, no-op when nothing is stored).
+- **Storage and typing.** `providerGroups` is a `z.array(entry).default([]).volatile()` field on the exported `Config` (annotated explicitly so declaration emit stays inside this package), coerced per entry with `''` defaults; `normalizeProviderGroups` never throws, accepts both the stored entry array and a hand-written provider→routes record, drops blank fields, unknown fields, and blank/duplicate entries, and treats a literal `__proto__` provider id as data. `readConfig` omits the field when no group exists, keeping the exact empty-config shape unchanged.
+- Verification: `pnpm run check` green (`tsc` + `tsdown`, 52 test files / 386 tests, pack gate); reverse verification — removing the picker's apply wiring turns exactly the adopt test red, green again after restore; lab 3082 smoke: two stored groups (one pinning compaction onto the keyless `deepseek-official` route, one onto a working route) apply on a picker provider switch (all three cards show the group values, switching back restores the previous routes), no-group providers leave the routes untouched, and `/compact` under the keyless pin fails with that route's `MISSING_CREDENTIAL` while the working group summarizes normally.
+
 ## v0.4.21
 
 Two product changes and one investigation: plan-exit auto-compaction is removed entirely; official compaction (`/compact` and official automatic compaction) gains one configurable summarization model; and the "endless automatic compaction" reports are investigated and attributed to the official engine.

package/PRODUCT.md

@@ -20,7 +20,7 @@ Official `agent-presets` stay in the process. A nested `ctx.plugin(AgentPresets)
 
 ## Settings and lifecycle
 
-The settings surface aggregates public Settings namespaces, reads and mutates with optimistic revisions, and saves rows independently. Changing a Main or fixed Subagent model applies only the target catalog row's default effort, so an effort never leaks across providers or models. The Subagent card is a RouteCard with an instant on/off for the Default Subagent route; turning it off keeps the last provider/model on disk. Switch compaction is a B-row in the Send protection group (发送保护), default on, written immediately. The Auto review card is a RouteCard with an instant switch defaulting **off = reviews follow the session model**; turning it on seeds the pinned reviewer route from Main and stays editable. The Compaction card mirrors it: default **off = official default = compaction follows the conversation target model**; turning it on seeds the summarization route from Main and stays editable, and the pinned pair drives `/compact` and official automatic compaction alike. Every registration, watcher, and dynamic tool generation has clean disposal. All visible copy lives in zh/en locale dictionaries.
+The settings surface aggregates public Settings namespaces, reads and mutates with optimistic revisions, and saves rows independently. Changing a Main or fixed Subagent model applies only the target catalog row's default effort, so an effort never leaks across providers or models. The Subagent card is a RouteCard with an instant on/off for the Default Subagent route; turning it off keeps the last provider/model on disk. Switch compaction is a B-row in the Send protection group (发送保护), default on, written immediately. The Auto review card is a RouteCard with an instant switch defaulting **off = reviews follow the session model**; turning it on seeds the pinned reviewer route from Main and stays editable. The Compaction card mirrors it: default **off = official default = compaction follows the conversation target model**; turning it on seeds the summarization route from Main and stays editable, and the pinned pair drives `/compact` and official automatic compaction alike. Provider groups store one compaction/subagent/review route group per provider in the shared `model-switch` namespace and apply it as a full replacement whenever the main model's provider changes through either plugin-owned switch surface (the composer picker or a Main card save); the apply rewrites only the existing flat fields (an unpinned capability reverts to its own default, `subagentMode` last), a same-provider switch or a provider without a stored group writes nothing, the effect is profile-wide rather than per session, and a failed apply never fails the switch or the Main save. Search and image routes are out of scope for groups. Every registration, watcher, and dynamic tool generation has clean disposal. All visible copy lives in zh/en locale dictionaries.
 
 ## Exclusions
 

package/README.md

@@ -101,6 +101,10 @@ How the route reaches the engine depends on where the deployment runs its agent
 
 Known issue (upstream; recorded in `docs/seam-gap.md`): while the working set stays above the official engine's pressure threshold, automatic compaction can fire on every step and keep re-attempting ranges whose summaries fail the engine's own "summary must be smaller" guard — a visible loop of automatic compactions that this plugin does not control (verified in a session A/B with the plugin enabled and disabled). Mitigations on the forwarded row config: `auto: false` (keeps `/compact`), a higher `thresholdRatio`, a smaller mounted tool schema, or a pinned compaction model whose summaries are leaner.
 
+## Provider groups
+
+The "Provider groups" card stores one route group per provider — the compaction, subagent, and review routes saved together — and applies it automatically whenever the main model's **provider** changes, whether through the composer picker or by saving a different provider on the Main card. Applying a group is one full replacement: all three routes are written into the cards above in a single decision, overwriting their current values **including manual edits**, while anything the group does not pin reverts to that capability's default (compaction and review follow the conversation model, subagent follows main). Switching to a provider without a stored group leaves the current routes untouched, and a switch within one provider never rewrites them. The stored effect is profile-wide (the shared settings namespace), not per session, and only these two switch surfaces trigger it — a TUI or other switch leaves the routes alone. In the editor, a provider's draft seeds from the active routes the first time you configure it, each capability row's off state means "use the capability default" and is stored as such, and **Delete group** removes the provider's group entirely (clearing the stored field when the last group goes). Search and image routes are out of scope. A failed apply never fails the switch or the Main save: the picker logs a warning and commits anyway, and the Main card reports "Main model saved, but applying the provider group failed …" while the routes stay as they were.
+
 ## What Model Switch does not change
 
 - `web_fetch` and its configured provider

package/README.zh.md

@@ -99,6 +99,10 @@ Plan Review 拥有独立于 Main 的执行模型草稿。**确认执行**会先
 
 已知问题（上游侧，见 `docs/seam-gap.md`）：当工作集持续超过官方引擎的压力阈值时，自动压缩可能每步触发，并反复重试摘要过不了官方「摘要必须更小」守卫的小片段——表现为"不停自动压缩"，本插件不控制该行为（已在同一会话做过插件开/关 A/B 对照）。可用的缓解（都在转发行配置上）：`auto: false`（保留 `/compact`）、调高 `thresholdRatio`、减少挂载的工具 schema，或固定一个摘要更精炼的压缩模型。
 
+## 供应商配置组（Provider groups）
+
+「供应商配置组」卡片为每个供应商保存一组路由——压缩、子代理、审查三条路由一起存；当**主模型的供应商**发生变化时自动应用，无论变化来自输入框选择器选模型、还是在 Main 卡片上保存成别的供应商。应用是一次完整替换：三条路由一次性写入上方对应卡片，覆盖卡片当前值**（包括手动修改）**；组里没有固定的项回到该能力的默认值（压缩/审查跟随会话模型、子代理跟随主模型）。切换到没有配置组的供应商时现有路由保持不变，同一供应商内部切换不会重写路由。存储是 profile 级的（共享设置命名空间），不按会话生效，且只由这两个切换面触发——TUI 等其他切换不会动路由。编辑器里首次配置某供应商时从当前生效路由种子化；每行能力开关的关闭态表示"用该能力的默认值"并按默认存储；「删除该组」彻底移除该组（删掉最后一组时同时清掉存储字段）。搜索与图片路由不在本功能范围内。应用失败不会让切换或主模型保存失败：选择器侧记录警告并照常完成切换，Main 卡片侧提示"主模型已保存，但供应商组应用失败 …"，路由保持原样。
+
 ## Model Switch 不会改变什么
 
 - `web_fetch` 及其配置的 provider

package/lib/client.js

@@ -80,6 +80,174 @@ window.__ModuleLoader__.load({
 			return route !== void 0 && (route.provider ?? "").trim() !== "" && (route.model ?? "").trim() !== "";
 		}
 		//#endregion
+		//#region src/provider-group.ts
+		const ROUTE_FIELDS = Object.freeze([
+			"compactProvider",
+			"compactModel",
+			"autoReviewProvider",
+			"autoReviewModel",
+			"subagentProvider",
+			"subagentModel",
+			"subagentReasoningEffort"
+		]);
+		/** Own data property, so a literal '__proto__' provider id can never touch a prototype. */
+		function setKey(target, key, value) {
+			Object.defineProperty(target, key, {
+				value,
+				enumerable: true,
+				writable: true,
+				configurable: true
+			});
+		}
+		/** A non-blank string. Blank values behave exactly like an absent field. */
+		function present(value) {
+			return typeof value === "string" && value.trim() !== "";
+		}
+		/** Normalize one raw entry to its owning provider and route view; undefined for non-object junk. */
+		function normalizeEntry(value) {
+			if (value === null || typeof value !== "object" || Array.isArray(value)) return void 0;
+			const source = value;
+			const group = {};
+			for (const field of ROUTE_FIELDS) {
+				const item = source[field];
+				if (present(item)) group[field] = item;
+			}
+			return {
+				provider: present(source.provider) ? source.provider : "",
+				group
+			};
+		}
+		/**
+		* Strip a raw stored value to well-formed groups; never throws. Both storage
+		* shapes are accepted: the stored entry array (keys live in each entry's
+		* `provider` field) and a hand-written provider → routes map (keys are the
+		* providers). All-empty entries stay: they pin a provider to every default.
+		*/
+		function normalizeProviderGroups(raw) {
+			const groups = {};
+			if (Array.isArray(raw)) {
+				for (const entry of raw) {
+					const view = normalizeEntry(entry);
+					if (view === void 0 || view.provider === "") continue;
+					setKey(groups, view.provider, view.group);
+				}
+				return groups;
+			}
+			if (raw !== null && typeof raw === "object") for (const [key, value] of Object.entries(raw)) {
+				if (key.trim() === "") continue;
+				const view = normalizeEntry(value);
+				if (view === void 0) continue;
+				setKey(groups, key, view.group);
+			}
+			return groups;
+		}
+		/**
+		* The saved group for a provider.
+		* @returns the normalized group, or undefined when the provider has no group —
+		* which is what leaves the live routes untouched during a switch.
+		*/
+		function groupOf(groups, provider) {
+			if (groups === void 0 || provider.trim() === "") return void 0;
+			if (!Object.prototype.hasOwnProperty.call(groups, provider)) return void 0;
+			return groups[provider];
+		}
+		/** A complete pinned pair; either half missing leaves the capability at its default. */
+		function pair(group, providerField, modelField) {
+			const provider = group[providerField];
+			const model = group[modelField];
+			return present(provider) && present(model) ? {
+				provider,
+				model
+			} : void 0;
+		}
+		/**
+		* Ordered writes applying one group with full-replacement semantics: pinned
+		* capabilities land as pairs, everything else reverts to its default state
+		* (compaction/review follow the session model; Subagent follows official
+		* inherit). The mode write comes last so a fixed route never publishes with
+		* the previous provider's fields still half-written.
+		*/
+		function providerGroupWrites(group) {
+			const compact = pair(group, "compactProvider", "compactModel");
+			const review = pair(group, "autoReviewProvider", "autoReviewModel");
+			const subagent = pair(group, "subagentProvider", "subagentModel");
+			const effort = subagent !== void 0 && present(group.subagentReasoningEffort) ? group.subagentReasoningEffort : void 0;
+			return [
+				{
+					field: "compactProvider",
+					value: compact?.provider
+				},
+				{
+					field: "compactModel",
+					value: compact?.model
+				},
+				{
+					field: "autoReviewProvider",
+					value: review?.provider
+				},
+				{
+					field: "autoReviewModel",
+					value: review?.model
+				},
+				{
+					field: "subagentProvider",
+					value: subagent?.provider
+				},
+				{
+					field: "subagentModel",
+					value: subagent?.model
+				},
+				{
+					field: "subagentReasoningEffort",
+					value: effort
+				},
+				{
+					field: "subagentMode",
+					mode: subagent !== void 0 ? "fixed" : "follow-main"
+				}
+			];
+		}
+		/** Storage entry for one provider's group; absent or blank route fields become ''. */
+		function entryOf(provider, group) {
+			return {
+				provider,
+				compactProvider: group.compactProvider ?? "",
+				compactModel: group.compactModel ?? "",
+				autoReviewProvider: group.autoReviewProvider ?? "",
+				autoReviewModel: group.autoReviewModel ?? "",
+				subagentProvider: group.subagentProvider ?? "",
+				subagentModel: group.subagentModel ?? "",
+				subagentReasoningEffort: group.subagentReasoningEffort ?? ""
+			};
+		}
+		/**
+		* The stored entry list with one provider's group replaced (an entry) or
+		* removed (undefined). Every entry is re-normalized and de-duplicated so a
+		* save can never write junk back; the input is never mutated. A blank
+		* provider only normalizes.
+		*/
+		function withProviderGroup(storage, provider, group) {
+			const groups = { ...normalizeProviderGroups(storage) };
+			if (provider.trim() !== "") {
+				if (group === void 0) delete groups[provider];
+				else setKey(groups, provider, group);
+			}
+			return Object.entries(groups).map(([key, value]) => entryOf(key, value));
+		}
+		/**
+		* Apply a saved group's routes to the live flat settings.
+		* @returns true when a group existed and every write settled; false when the
+		* provider has no group (nothing was written). A rejected write propagates.
+		*/
+		async function applyProviderGroupTo(sink, groups, provider) {
+			const group = groupOf(groups, provider);
+			if (group === void 0) return false;
+			for (const write of providerGroupWrites(group)) if (write.field === "subagentMode") await sink.set("subagentMode", write.mode);
+			else if (write.value === void 0) await sink.unset(write.field);
+			else await sink.set(write.field, write.value);
+			return true;
+		}
+		//#endregion
 		//#region src/client/derived-config-form.ts
 		function deriveConfigForm(source, project, fields) {
 			let sourceSnapshot;
@@ -628,7 +796,40 @@ window.__ModuleLoader__.load({
 		function compact(...values) {
 			return values.filter((value) => value !== void 0 && value !== "").join(" · ");
 		}
+		/** A complete pinned pair; either half blank leaves the capability at its default. */
+		function draftPair(provider, model) {
+			return provider !== void 0 && provider.trim() !== "" && model !== void 0 && model.trim() !== "" ? {
+				provider,
+				model
+			} : void 0;
+		}
 		function RouteIcon({ kind }) {
+			if (kind === "providerGroups") return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", {
+				width: "18",
+				height: "18",
+				viewBox: "0 0 18 18",
+				fill: "none",
+				"aria-hidden": "true",
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
+						d: "M3 5.5h12M3 12.5h12",
+						stroke: "currentColor",
+						strokeLinecap: "round"
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("circle", {
+						cx: "6.5",
+						cy: "5.5",
+						r: "2",
+						stroke: "currentColor"
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("circle", {
+						cx: "11.5",
+						cy: "12.5",
+						r: "2",
+						stroke: "currentColor"
+					})
+				]
+			});
 			if (kind === "compaction") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
 				width: "18",
 				height: "18",
@@ -840,7 +1041,7 @@ window.__ModuleLoader__.load({
 				})]
 			});
 		}
-		function Actions({ t, busy, disabled, message, onCancel, onSave }) {
+		function Actions({ t, busy, disabled, message, extra, onCancel, onSave }) {
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: ModelSwitchSettings_module_css_default.cardFooter,
 				children: [
@@ -848,6 +1049,7 @@ window.__ModuleLoader__.load({
 						className: cx(ModelSwitchSettings_module_css_default.hint, ModelSwitchSettings_module_css_default.message),
 						children: message
 					}),
+					extra,
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 						type: "button",
 						className: cx(ModelSwitchSettings_module_css_default.button, ModelSwitchSettings_module_css_default.secondaryButton),
@@ -926,6 +1128,8 @@ window.__ModuleLoader__.load({
 			const [message, setMessage] = (0, react.useState)();
 			const [compactBusy, setCompactBusy] = (0, react.useState)(false);
 			const [compactError, setCompactError] = (0, react.useState)();
+			const [groupProvider, setGroupProvider] = (0, react.useState)("");
+			const [groupDraft, setGroupDraft] = (0, react.useState)(void 0);
 			const loadSearchCapabilities = props.loadCapabilities;
 			const [searchSnapshot, setSearchSnapshot] = (0, react.useState)(void 0);
 			const [searchError, setSearchError] = (0, react.useState)(void 0);
@@ -964,6 +1168,60 @@ window.__ModuleLoader__.load({
 					if (timer !== void 0) clearTimeout(timer);
 				};
 			}, [loadSearchCapabilities]);
+			const providerGroups = normalizeProviderGroups(switchSettings.value?.providerGroups);
+			/** Seed an unsaved group from the live routes, mirroring how the switches seed from Main. */
+			const seedGroupFromActive = () => {
+				const compact = compaction.value !== void 0 && routePairConfigured(compaction.value) ? {
+					provider: compaction.value.provider ?? "",
+					model: compaction.value.model ?? ""
+				} : void 0;
+				const review = autoReview.value !== void 0 && routePairConfigured(autoReview.value) ? {
+					provider: autoReview.value.provider ?? "",
+					model: autoReview.value.model ?? ""
+				} : void 0;
+				const fixedSubagent = subagent.value !== void 0 && subagent.value.mode === "fixed" && routePairConfigured(subagent.value) ? {
+					provider: subagent.value.provider ?? "",
+					model: subagent.value.model ?? "",
+					reasoningEffort: subagent.value.reasoningEffort
+				} : void 0;
+				return {
+					...compact === void 0 ? {} : {
+						compactProvider: compact.provider,
+						compactModel: compact.model
+					},
+					...review === void 0 ? {} : {
+						autoReviewProvider: review.provider,
+						autoReviewModel: review.model
+					},
+					...fixedSubagent === void 0 ? {} : {
+						subagentProvider: fixedSubagent.provider,
+						subagentModel: fixedSubagent.model,
+						...fixedSubagent.reasoningEffort === void 0 ? {} : { subagentReasoningEffort: fixedSubagent.reasoningEffort }
+					}
+				};
+			};
+			/** Reload the editor draft: the saved group when one exists, else a seed from the live routes. */
+			const resyncGroupDraft = () => {
+				if (groupProvider === "") {
+					setGroupDraft(void 0);
+					return;
+				}
+				setGroupDraft(groupOf(providerGroups, groupProvider) ?? seedGroupFromActive());
+			};
+			(0, react.useEffect)(() => {
+				if (groupProvider !== "") return;
+				const initial = controller.draft?.provider;
+				if (initial !== void 0 && initial.trim() !== "") setGroupProvider(initial);
+			}, [groupProvider, controller.draft]);
+			(0, react.useEffect)(() => {
+				resyncGroupDraft();
+			}, [
+				groupProvider,
+				switchSettings.value,
+				subagent.value,
+				autoReview.value,
+				compaction.value
+			]);
 			if ([
 				controller.main,
 				controller.subagent,
@@ -1182,6 +1440,83 @@ window.__ModuleLoader__.load({
 			const capabilityDisabled = (route, snapshot, next) => snapshot.status !== "ready" || !snapshot.writable || next === void 0 || busy === route || (next.provider ?? "").trim() === "" || (next.model ?? "").trim() === "";
 			const autoReviewDisabled = autoReview.status !== "ready" || !autoReview.writable || autoReviewDraft === void 0 || busy === "autoReview" || !autoReviewOn || (autoReviewDraft.provider ?? "").trim() === "" || (autoReviewDraft.model ?? "").trim() === "";
 			const compactionDisabled = compaction.status !== "ready" || !compaction.writable || compactionDraft === void 0 || busy === "compaction" || !compactionOn || (compactionDraft.provider ?? "").trim() === "" || (compactionDraft.model ?? "").trim() === "";
+			const configuredGroupCount = Object.keys(providerGroups).length;
+			const groupControlsDisabled = busy === "providerGroups" || switchSettings.status !== "ready" || !switchSettings.writable;
+			const groupProviderChoices = deriveRouteChoices(groups, groupProvider === "" ? void 0 : { provider: groupProvider }).providers.map((choice) => groupOf(providerGroups, choice.id) === void 0 ? choice : {
+				...choice,
+				name: choice.name + " ✓"
+			});
+			const groupCompaction = groupDraft === void 0 ? void 0 : draftPair(groupDraft.compactProvider, groupDraft.compactModel);
+			const groupReview = groupDraft === void 0 ? void 0 : draftPair(groupDraft.autoReviewProvider, groupDraft.autoReviewModel);
+			const groupSubagent = groupDraft === void 0 ? void 0 : draftPair(groupDraft.subagentProvider, groupDraft.subagentModel);
+			const groupCompactionChoices = deriveRouteChoices(groups, groupCompaction);
+			const groupReviewChoices = deriveRouteChoices(groups, groupReview);
+			const groupSubagentChoices = deriveRouteChoices(groups, groupSubagent);
+			const groupSubMatched = matchCatalogModel(groups.find((group) => group.id === (groupDraft?.subagentProvider ?? ""))?.models ?? [], groupDraft?.subagentModel ?? "");
+			const groupSubEfforts = (() => {
+				const efforts = (groupSubMatched?.model.reasoning?.efforts ?? []).map((effort) => ({
+					id: effort.id,
+					name: effort.name
+				}));
+				const current = groupDraft?.subagentReasoningEffort;
+				if (current !== void 0 && current !== "" && !efforts.some((option) => option.id === current)) efforts.push({
+					id: current,
+					name: current
+				});
+				return efforts;
+			})();
+			/** Enable a capability row by pinning it to the Main route, like the switches above seed from Main. */
+			const enableGroupCapability = (kind) => {
+				setGroupDraft((draft) => {
+					const main = controller.draft;
+					if (draft === void 0 || main === void 0) return draft;
+					if (kind === "compaction") return {
+						...draft,
+						compactProvider: main.provider,
+						compactModel: main.model
+					};
+					if (kind === "autoReview") return {
+						...draft,
+						autoReviewProvider: main.provider,
+						autoReviewModel: main.model
+					};
+					return {
+						...draft,
+						subagentProvider: main.provider,
+						subagentModel: main.model,
+						...main.reasoningEffort === void 0 ? {} : { subagentReasoningEffort: main.reasoningEffort }
+					};
+				});
+			};
+			const disableGroupCapability = (kind) => {
+				setGroupDraft((draft) => {
+					if (draft === void 0) return draft;
+					if (kind === "compaction") return {
+						...draft,
+						compactProvider: "",
+						compactModel: ""
+					};
+					if (kind === "autoReview") return {
+						...draft,
+						autoReviewProvider: "",
+						autoReviewModel: ""
+					};
+					return {
+						...draft,
+						subagentProvider: "",
+						subagentModel: "",
+						subagentReasoningEffort: ""
+					};
+				});
+			};
+			const saveProviderGroupCard = () => {
+				if (groupProvider === "" || groupDraft === void 0) return;
+				run("providerGroups", () => props.saveProviderGroup(groupProvider, groupDraft));
+			};
+			const deleteProviderGroupCard = () => {
+				if (groupProvider === "") return;
+				run("providerGroups", () => props.saveProviderGroup(groupProvider, void 0));
+			};
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("main", {
 				className: ModelSwitchSettings_module_css_default.section,
 				children: [
@@ -1681,6 +2016,229 @@ window.__ModuleLoader__.load({
 								] })
 							})
 						]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+						className: ModelSwitchSettings_module_css_default.group,
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h2", {
+							className: ModelSwitchSettings_module_css_default.groupLabel,
+							children: props.t("providerGroups")
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(RouteCard, {
+							title: props.t("providerGroupsCard"),
+							summary: props.t("providerGroupsSummary"),
+							hint: props.t("providerGroupsHelp"),
+							icon: "providerGroups",
+							open: open === "providerGroups",
+							onToggle: () => {
+								toggle("providerGroups");
+							},
+							...configuredGroupCount > 0 ? { badge: String(configuredGroupCount) } : {},
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+									className: ModelSwitchSettings_module_css_default.hint,
+									children: props.t("providerGroupsBodyHelp")
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: ModelSwitchSettings_module_css_default.formGrid,
+									children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+										label: props.t("provider"),
+										value: groupProvider,
+										disabled: groupControlsDisabled,
+										choices: groupProviderChoices,
+										onChange: setGroupProvider
+									})
+								}),
+								groupProvider === "" || groupDraft === void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+									className: ModelSwitchSettings_module_css_default.hint,
+									children: props.t("providerGroupPick")
+								}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+									/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+										className: ModelSwitchSettings_module_css_default.rowCard,
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+											className: ModelSwitchSettings_module_css_default.rowCopy,
+											children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												className: ModelSwitchSettings_module_css_default.rowTitle,
+												children: props.t("compaction")
+											}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+												className: ModelSwitchSettings_module_css_default.hint,
+												children: groupCompaction === void 0 ? props.t("compactionFollow") : routeName(groups, groupCompaction)
+											})]
+										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(InstantSwitch, {
+											checked: groupCompaction !== void 0,
+											disabled: groupControlsDisabled,
+											label: props.t("compaction"),
+											onChange: (value) => {
+												if (value) enableGroupCapability("compaction");
+												else disableGroupCapability("compaction");
+											}
+										})]
+									}),
+									groupCompaction === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+										className: ModelSwitchSettings_module_css_default.formGrid,
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+											label: props.t("provider"),
+											value: groupCompaction.provider,
+											disabled: groupControlsDisabled,
+											choices: groupCompactionChoices.providers,
+											onChange: (provider) => {
+												const first = groups.find((item) => item.id === provider)?.models[0];
+												setGroupDraft((draft) => draft === void 0 ? draft : {
+													...draft,
+													compactProvider: provider,
+													compactModel: first?.id ?? ""
+												});
+											}
+										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+											label: props.t("model"),
+											value: groupCompaction.model,
+											disabled: groupControlsDisabled,
+											choices: groupCompactionChoices.models,
+											onChange: (model) => {
+												setGroupDraft((draft) => draft === void 0 ? draft : {
+													...draft,
+													compactModel: model
+												});
+											}
+										})]
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+										className: ModelSwitchSettings_module_css_default.rowCard,
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+											className: ModelSwitchSettings_module_css_default.rowCopy,
+											children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												className: ModelSwitchSettings_module_css_default.rowTitle,
+												children: props.t("autoReview")
+											}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+												className: ModelSwitchSettings_module_css_default.hint,
+												children: groupReview === void 0 ? props.t("autoReviewFollow") : routeName(groups, groupReview)
+											})]
+										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(InstantSwitch, {
+											checked: groupReview !== void 0,
+											disabled: groupControlsDisabled,
+											label: props.t("autoReview"),
+											onChange: (value) => {
+												if (value) enableGroupCapability("autoReview");
+												else disableGroupCapability("autoReview");
+											}
+										})]
+									}),
+									groupReview === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+										className: ModelSwitchSettings_module_css_default.formGrid,
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+											label: props.t("provider"),
+											value: groupReview.provider,
+											disabled: groupControlsDisabled,
+											choices: groupReviewChoices.providers,
+											onChange: (provider) => {
+												const first = groups.find((item) => item.id === provider)?.models[0];
+												setGroupDraft((draft) => draft === void 0 ? draft : {
+													...draft,
+													autoReviewProvider: provider,
+													autoReviewModel: first?.id ?? ""
+												});
+											}
+										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+											label: props.t("model"),
+											value: groupReview.model,
+											disabled: groupControlsDisabled,
+											choices: groupReviewChoices.models,
+											onChange: (model) => {
+												setGroupDraft((draft) => draft === void 0 ? draft : {
+													...draft,
+													autoReviewModel: model
+												});
+											}
+										})]
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+										className: ModelSwitchSettings_module_css_default.rowCard,
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+											className: ModelSwitchSettings_module_css_default.rowCopy,
+											children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												className: ModelSwitchSettings_module_css_default.rowTitle,
+												children: props.t("subagent")
+											}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+												className: ModelSwitchSettings_module_css_default.hint,
+												children: groupSubagent === void 0 ? props.t("subagentOff") : routeName(groups, groupSubagent)
+											})]
+										}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(InstantSwitch, {
+											checked: groupSubagent !== void 0,
+											disabled: groupControlsDisabled,
+											label: props.t("subagent"),
+											onChange: (value) => {
+												if (value) enableGroupCapability("subagent");
+												else disableGroupCapability("subagent");
+											}
+										})]
+									}),
+									groupSubagent === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+										className: ModelSwitchSettings_module_css_default.formGrid,
+										children: [
+											/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+												label: props.t("provider"),
+												value: groupSubagent.provider,
+												disabled: groupControlsDisabled,
+												choices: groupSubagentChoices.providers,
+												onChange: (provider) => {
+													const first = groups.find((item) => item.id === provider)?.models[0];
+													const routed = selectRouteModel(groups, provider, first?.id ?? groupSubagent.model);
+													setGroupDraft((draft) => draft === void 0 ? draft : {
+														...draft,
+														subagentProvider: routed.provider,
+														subagentModel: routed.model,
+														subagentReasoningEffort: routed.reasoningEffort ?? ""
+													});
+												}
+											}),
+											/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+												label: props.t("model"),
+												value: groupSubagent.model,
+												disabled: groupControlsDisabled,
+												choices: groupSubagentChoices.models,
+												onChange: (model) => {
+													const routed = selectRouteModel(groups, groupSubagent.provider, model);
+													setGroupDraft((draft) => draft === void 0 ? draft : {
+														...draft,
+														subagentProvider: routed.provider,
+														subagentModel: routed.model,
+														subagentReasoningEffort: routed.reasoningEffort ?? ""
+													});
+												}
+											}),
+											/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+												label: props.t("effort"),
+												value: groupDraft.subagentReasoningEffort ?? "",
+												disabled: groupControlsDisabled,
+												choices: groupSubEfforts,
+												onChange: (effort) => {
+													setGroupDraft((draft) => draft === void 0 ? draft : {
+														...draft,
+														subagentReasoningEffort: effort
+													});
+												}
+											})
+										]
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Actions, {
+										t: props.t,
+										busy: busy === "providerGroups",
+										disabled: groupControlsDisabled || groupProvider === "",
+										...message?.route === "providerGroups" ? { message: message.text } : {},
+										extra: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+											type: "button",
+											className: cx(ModelSwitchSettings_module_css_default.button, ModelSwitchSettings_module_css_default.secondaryButton),
+											disabled: groupControlsDisabled || groupOf(providerGroups, groupProvider) === void 0,
+											onClick: deleteProviderGroupCard,
+											children: props.t("providerGroupDelete")
+										}),
+										onCancel: () => {
+											resyncGroupDraft();
+											setMessage(void 0);
+										},
+										onSave: saveProviderGroupCard
+									})
+								] })
+							]
+						})]
 					})
 				]
 			});
@@ -1731,6 +2289,14 @@ window.__ModuleLoader__.load({
 			compactionFollow: "跟随会话模型",
 			compactionHelp: "为官方压缩（/compact 与官方自动压缩）指定摘要模型；关闭（两个字段都留空）时使用官方默认，即当前会话的目标模型。",
 			compactionRouteHelp: "摘要请求固定使用这里的 Provider/模型，与会话目标模型无关；保存后对下一次压缩立即生效。保存时若恰有压缩进行中，可能被打断并在下次重试。",
+			providerGroups: "供应商配置组",
+			providerGroupsCard: "按供应商预设路由",
+			providerGroupsSummary: "切换主模型供应商时自动应用对应组",
+			providerGroupsHelp: "为压缩、子代理、审查按供应商分别保存路由。",
+			providerGroupsBodyHelp: "每个供应商保存一组压缩、子代理、审查路由；主模型切换到该供应商时，这三条路由自动写入上方对应卡片。切换到未配置的供应商时现有路由保持不变；应用会覆盖三张卡片的当前值（含手动修改）。",
+			providerGroupPick: "选择供应商以编辑其配置组。",
+			providerGroupDelete: "删除该组",
+			providerGroupApplyFailed: "主模型已保存，但供应商组应用失败：",
 			"reason.central-subagent-routing": "Alpha.4 没有全局子代理启动路由接口。",
 			"reason.packaged-preset-roots": "Alpha.4 不支持插件提供额外 preset root。",
 			"reason.tool-owner-suppression": "Alpha.4 没有工具所有者或来源抑制接口。",
@@ -1782,6 +2348,14 @@ window.__ModuleLoader__.load({
 			compactionFollow: "Follows the conversation model",
 			compactionHelp: "Pick the summarization model for official compaction (/compact and official automatic compaction). When off (both fields empty), the official default applies: the conversation target model.",
 			compactionRouteHelp: "Summarization requests use exactly this provider/model regardless of the conversation target; saved changes apply to the very next compaction. Saving while a compaction is running may interrupt it; it retries next time.",
+			providerGroups: "Provider groups",
+			providerGroupsCard: "Per-provider route presets",
+			providerGroupsSummary: "Applied automatically when the main model provider switches",
+			providerGroupsHelp: "Save compaction, subagent, and review routes per provider.",
+			providerGroupsBodyHelp: "Each provider stores one compaction, subagent, and review route group. Switching the main model to that provider writes these three routes into the cards above; switching to a provider without a group leaves the current routes untouched. Applying a group overwrites those three cards, including manual edits.",
+			providerGroupPick: "Pick a provider to edit its group.",
+			providerGroupDelete: "Delete group",
+			providerGroupApplyFailed: "Main model saved, but applying the provider group failed: ",
 			"reason.central-subagent-routing": "Alpha.4 exposes no global Subagent start-routing seam.",
 			"reason.packaged-preset-roots": "Alpha.4 exposes no plugin-owned preset root.",
 			"reason.tool-owner-suppression": "Alpha.4 exposes no tool owner or provenance suppression seam.",
@@ -4230,6 +4804,7 @@ window.__ModuleLoader__.load({
 				const models = scope.modelDirectories;
 				const sessions = scope.sessions;
 				const mainDefaults = scope.configForms.get(MAIN_DEFAULT_CONFIG_ID);
+				const ownedForm = scope.configForms.get(MODEL_SWITCH_CONFIG_ID);
 				let directoryService;
 				const orderStore = providerOrderStore(scope.configForms.get(PROVIDERS_CONFIG_ID));
 				scope.inject(["providerDirectory"], (directoryScope) => {
@@ -4303,6 +4878,11 @@ window.__ModuleLoader__.load({
 								return uncommitted;
 							}
 							if (!result.ok) return uncommitted;
+							if (selection.provider !== currentProvider) try {
+								await applyProviderGroupTo(ownedForm, normalizeProviderGroups(ownedForm.getSnapshot().value?.providerGroups), selection.provider);
+							} catch (error) {
+								console.warn("dsh-model-switch: provider group apply failed", error);
+							}
 							return {
 								committed: true,
 								mainDefaultRestored: (await restoreMainDefault(mainDefaults, defaultBeforeSwitch)).restored
@@ -4415,7 +4995,12 @@ window.__ModuleLoader__.load({
 			const image = deriveConfigForm(owned, deriveImageSettings, IMAGE_SETTINGS_FIELDS);
 			const autoReview = deriveConfigForm(owned, deriveAutoReviewSettings, AUTO_REVIEW_SETTINGS_FIELDS);
 			const compaction = deriveConfigForm(owned, deriveCompactionSettings, COMPACTION_SETTINGS_FIELDS);
+			/** Adopt the target provider's saved group; a provider without a group leaves the routes untouched. */
+			const applyProviderGroupFor = async (provider) => {
+				await applyProviderGroupTo(owned, normalizeProviderGroups(owned.getSnapshot().value?.providerGroups), provider);
+			};
 			const saveMain = async (next, expectedRevision) => {
+				const previousProvider = mainForm.getSnapshot().value?.provider;
 				if (!await mainForm.mutate([
 					{
 						op: "set",
@@ -4441,6 +5026,11 @@ window.__ModuleLoader__.load({
 				}
 				const revision = mainForm.getSnapshot().revision;
 				if (revision === void 0) throw new Error("settings unavailable after save");
+				if (next.provider.trim() !== "" && next.provider !== previousProvider) try {
+					await applyProviderGroupFor(next.provider);
+				} catch (error) {
+					throw new Error(t("providerGroupApplyFailed") + (error instanceof Error ? error.message : t("requestFailed")));
+				}
 				return revision;
 			};
 			const connectionRpc = (() => {
@@ -4493,6 +5083,16 @@ window.__ModuleLoader__.load({
 					setCompactOnSwitch: async (value) => {
 						if (!await owned.set("compactOnSwitch", value)) throw new Error("settings-rejected");
 					},
+					saveProviderGroup: async (provider, group) => {
+						const current = owned.getSnapshot().value?.providerGroups;
+						const next = withProviderGroup(current, provider, group);
+						if (next.length === 0) {
+							if (current === void 0) return;
+							if (!await owned.unset("providerGroups")) throw new Error("settings-rejected");
+							return;
+						}
+						if (!await owned.set("providerGroups", next)) throw new Error("settings-rejected");
+					},
 					providerRoleOf,
 					loadCatalog: async () => {
 						const response = await remote.session.modelCatalog();

package/lib/index.js

@@ -12,7 +12,83 @@ import { dirname, join } from "node:path";
 import { renderPrompt } from "@deepseek-ai/dsh-system-prompt";
 import { boundContextSummary, createMessage, createUserMessage } from "@deepseek-ai/dsh-llm";
 import { canonicalHeader } from "@deepseek-ai/dsh-session";
+//#region lib/types/provider-group.js
+/**
+* Provider configuration groups: per-provider presets for the compaction,
+* subagent, and auto-review routes.
+*
+* A group stores the exact flat settings fields it will write, so applying a
+* group is a plain settings-layer write: every capability consumer keeps
+* reading the live values unchanged. All functions here are pure and never
+* throw on malformed storage.
+*/
+const ROUTE_FIELDS = Object.freeze([
+	"compactProvider",
+	"compactModel",
+	"autoReviewProvider",
+	"autoReviewModel",
+	"subagentProvider",
+	"subagentModel",
+	"subagentReasoningEffort"
+]);
+/** Own data property, so a literal '__proto__' provider id can never touch a prototype. */
+function setKey(target, key, value) {
+	Object.defineProperty(target, key, {
+		value,
+		enumerable: true,
+		writable: true,
+		configurable: true
+	});
+}
+/** A non-blank string. Blank values behave exactly like an absent field. */
+function present(value) {
+	return typeof value === "string" && value.trim() !== "";
+}
+/** Normalize one raw entry to its owning provider and route view; undefined for non-object junk. */
+function normalizeEntry(value) {
+	if (value === null || typeof value !== "object" || Array.isArray(value)) return void 0;
+	const source = value;
+	const group = {};
+	for (const field of ROUTE_FIELDS) {
+		const item = source[field];
+		if (present(item)) group[field] = item;
+	}
+	return {
+		provider: present(source.provider) ? source.provider : "",
+		group
+	};
+}
+/**
+* Strip a raw stored value to well-formed groups; never throws. Both storage
+* shapes are accepted: the stored entry array (keys live in each entry's
+* `provider` field) and a hand-written provider → routes map (keys are the
+* providers). All-empty entries stay: they pin a provider to every default.
+*/
+function normalizeProviderGroups(raw) {
+	const groups = {};
+	if (Array.isArray(raw)) {
+		for (const entry of raw) {
+			const view = normalizeEntry(entry);
+			if (view === void 0 || view.provider === "") continue;
+			setKey(groups, view.provider, view.group);
+		}
+		return groups;
+	}
+	if (raw !== null && typeof raw === "object") for (const [key, value] of Object.entries(raw)) {
+		if (key.trim() === "") continue;
+		const view = normalizeEntry(value);
+		if (view === void 0) continue;
+		setKey(groups, key, view.group);
+	}
+	return groups;
+}
+//#endregion
 //#region lib/types/host-settings.js
+/**
+* Annotated rather than inferred: the nested entry schema's inferred type
+* expands to cosmokit internals (`Dict`) that cannot be named in the emitted
+* declaration, and the annotation pins the output shape to this interface.
+*/
 const Config = z.object({
 	subagentMode: z.union(["follow-main", "fixed"]).default("follow-main").volatile(),
 	subagentProvider: z.string().volatile(),
@@ -26,7 +102,17 @@ const Config = z.object({
 	autoReviewProvider: z.string().volatile(),
 	autoReviewModel: z.string().volatile(),
 	compactProvider: z.string().volatile(),
-	compactModel: z.string().volatile()
+	compactModel: z.string().volatile(),
+	providerGroups: z.array(z.object({
+		provider: z.string().default(""),
+		compactProvider: z.string().default(""),
+		compactModel: z.string().default(""),
+		autoReviewProvider: z.string().default(""),
+		autoReviewModel: z.string().default(""),
+		subagentProvider: z.string().default(""),
+		subagentModel: z.string().default(""),
+		subagentReasoningEffort: z.string().default("")
+	})).default([]).volatile()
 });
 function readConfig(config) {
 	const subagentProvider = config.subagentProvider.get();
@@ -40,6 +126,7 @@ function readConfig(config) {
 	const autoReviewModel = config.autoReviewModel.get();
 	const compactProvider = config.compactProvider.get();
 	const compactModel = config.compactModel.get();
+	const providerGroups = normalizeProviderGroups(config.providerGroups.get());
 	return {
 		subagentMode: config.subagentMode.get(),
 		...subagentProvider === void 0 ? {} : { subagentProvider },
@@ -53,7 +140,8 @@ function readConfig(config) {
 		...autoReviewProvider === void 0 || autoReviewProvider === "" ? {} : { autoReviewProvider },
 		...autoReviewModel === void 0 || autoReviewModel === "" ? {} : { autoReviewModel },
 		...compactProvider === void 0 || compactProvider === "" ? {} : { compactProvider },
-		...compactModel === void 0 || compactModel === "" ? {} : { compactModel }
+		...compactModel === void 0 || compactModel === "" ? {} : { compactModel },
+		...Object.keys(providerGroups).length === 0 ? {} : { providerGroups }
 	};
 }
 //#endregion

package/lib/types/client/ModelSwitchSettings.d.ts

@@ -3,6 +3,7 @@ import type { ModelProviderGroup } from '@deepseek-ai/dsh-api-session-controller
 import type { ConfigForm } from '@deepseek-ai/dsh-client-ui-settings/client';
 import type { InjectFace, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import { type CapabilityRouteView, type MainSettingsView, type ModelSwitchSettingsView, type SubagentSettingsView } from '../client-contract.js';
+import { type ProviderGroupConfig } from '../provider-group.js';
 import type { RuntimeCapabilities } from '../runtime-capabilities.js';
 import { type CapabilitiesSnapshot } from './search-capabilities.js';
 import type { ModelSwitchLocaleKey } from './locales.js';
@@ -23,6 +24,8 @@ export interface ModelSwitchSettingsFace {
     setSubagent: (field: 'mode' | 'provider' | 'model' | 'reasoningEffort', value: string | undefined) => Promise<void>;
     setCapability: (route: 'search' | 'image' | 'autoReview' | 'compaction', field: 'provider' | 'model', value: string | undefined) => Promise<void>;
     setCompactOnSwitch: (value: boolean) => Promise<void>;
+    /** Replace or remove (undefined) one provider's saved capability group. */
+    saveProviderGroup: (provider: string, group: ProviderGroupConfig | undefined) => Promise<void>;
     loadCatalog: () => Promise<readonly ModelProviderGroup[]>;
     /** Host capabilities long-poll; absent in legacy faces, which keep the static-capabilities path. */
     loadCapabilities?: (revision?: number, signal?: AbortSignal) => Promise<CapabilitiesSnapshot>;

package/lib/types/client/locales.d.ts

@@ -42,6 +42,14 @@ export declare const zh: {
     readonly compactionFollow: "跟随会话模型";
     readonly compactionHelp: "为官方压缩（/compact 与官方自动压缩）指定摘要模型；关闭（两个字段都留空）时使用官方默认，即当前会话的目标模型。";
     readonly compactionRouteHelp: "摘要请求固定使用这里的 Provider/模型，与会话目标模型无关；保存后对下一次压缩立即生效。保存时若恰有压缩进行中，可能被打断并在下次重试。";
+    readonly providerGroups: "供应商配置组";
+    readonly providerGroupsCard: "按供应商预设路由";
+    readonly providerGroupsSummary: "切换主模型供应商时自动应用对应组";
+    readonly providerGroupsHelp: "为压缩、子代理、审查按供应商分别保存路由。";
+    readonly providerGroupsBodyHelp: "每个供应商保存一组压缩、子代理、审查路由；主模型切换到该供应商时，这三条路由自动写入上方对应卡片。切换到未配置的供应商时现有路由保持不变；应用会覆盖三张卡片的当前值（含手动修改）。";
+    readonly providerGroupPick: "选择供应商以编辑其配置组。";
+    readonly providerGroupDelete: "删除该组";
+    readonly providerGroupApplyFailed: "主模型已保存，但供应商组应用失败：";
     readonly 'reason.central-subagent-routing': "Alpha.4 没有全局子代理启动路由接口。";
     readonly 'reason.packaged-preset-roots': "Alpha.4 不支持插件提供额外 preset root。";
     readonly 'reason.tool-owner-suppression': "Alpha.4 没有工具所有者或来源抑制接口。";

package/lib/types/client-contract.d.ts

@@ -1,3 +1,4 @@
+import type { ProviderGroupsStorage } from './provider-group.js';
 export declare const MODEL_SWITCH_CONFIG_ID = "model-switch";
 export declare const MAIN_DEFAULT_CONFIG_ID = "agent-default-model";
 export declare const PROVIDERS_CONFIG_ID = "llm-providers-ui";
@@ -23,6 +24,8 @@ export interface ModelSwitchSettingsView {
     autoReviewModel?: string;
     compactProvider?: string;
     compactModel?: string;
+    /** Raw saved per-provider groups; edited whole through the provider-groups card. */
+    providerGroups?: ProviderGroupsStorage;
 }
 export interface SubagentSettingsView {
     mode: 'follow-main' | 'fixed';

package/lib/types/host-runtime.d.ts

@@ -1,7 +1,7 @@
 import { Context, Service } from '@deepseek-ai/cordis';
 import type { ModelSelection } from '@deepseek-ai/dsh-agent';
 import type { AgentDefaultModelConfig } from '@deepseek-ai/dsh-agent-default-model';
-import { type Config as ModelSwitchSettingsConfig, type ModelSwitchSettings } from './host-settings.js';
+import { Config, type Config as ModelSwitchSettingsConfig, type ModelSwitchSettings } from './host-settings.js';
 import { ModelSwitchAdapterRegistry } from './adapter-registry.js';
 declare module '@deepseek-ai/cordis' {
     interface Context {
@@ -15,35 +15,7 @@ declare module '@deepseek-ai/cordis' {
 /** Host owner for Model Switch settings and the released Main-default adapter. */
 export declare class ModelSwitchRuntime extends Service {
     static inject: string[];
-    static Config: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
-        subagentMode: import("@deepseek-ai/schemastery").default<"follow-main" | "fixed", "follow-main" | "fixed", "volatile-defined">;
-        subagentProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        subagentModel: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        subagentReasoningEffort: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        searchProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        searchModel: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        imageProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        imageModel: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        compactOnSwitch: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
-        autoReviewProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        autoReviewModel: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        compactProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        compactModel: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-    }>>, Schemastery.ObjectT<NoInfer<{
-        subagentMode: import("@deepseek-ai/schemastery").default<"follow-main" | "fixed", "follow-main" | "fixed", "volatile-defined">;
-        subagentProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        subagentModel: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        subagentReasoningEffort: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        searchProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        searchModel: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        imageProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        imageModel: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        compactOnSwitch: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
-        autoReviewProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        autoReviewModel: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        compactProvider: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        compactModel: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-    }>>, "plain">;
+    static Config: import("@deepseek-ai/schemastery").default<any, Config, "plain">;
     get capabilities(): {
         searchProviderAdapters: {
             available: boolean;

package/lib/types/host-settings.d.ts

@@ -1,5 +1,6 @@
 import type { Volatile } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
+import { type ProviderGroupEntry, type ProviderGroups } from './provider-group.js';
 export type SubagentMode = 'follow-main' | 'fixed';
 /** Resolved live values consumed by Model Switch. */
 export interface ModelSwitchSettings {
@@ -20,6 +21,8 @@ export interface ModelSwitchSettings {
     compactProvider?: string;
     /** Summarization model for `/compact` and automatic compaction; set together with `compactProvider`. */
     compactModel?: string;
+    /** Per-provider compaction/subagent/review presets, keyed by provider id; absent when no group is saved. */
+    providerGroups?: ProviderGroups;
 }
 /** Loader-owned references; every field is directly editable in the profile form. */
 export interface Config {
@@ -36,34 +39,13 @@ export interface Config {
     autoReviewModel: Volatile<string | undefined>;
     compactProvider: Volatile<string | undefined>;
     compactModel: Volatile<string | undefined>;
+    /** Saved per-provider capability groups as one entry per provider; entry route fields are '' when the capability stays at its default. */
+    providerGroups: Volatile<readonly ProviderGroupEntry[]>;
 }
-export declare const Config: z<Schemastery.ObjectS<NoInfer<{
-    subagentMode: z<"follow-main" | "fixed", "follow-main" | "fixed", "volatile-defined">;
-    subagentProvider: z<string, string, "volatile">;
-    subagentModel: z<string, string, "volatile">;
-    subagentReasoningEffort: z<string, string, "volatile">;
-    searchProvider: z<string, string, "volatile">;
-    searchModel: z<string, string, "volatile">;
-    imageProvider: z<string, string, "volatile">;
-    imageModel: z<string, string, "volatile">;
-    compactOnSwitch: z<boolean, boolean, "volatile-defined">;
-    autoReviewProvider: z<string, string, "volatile">;
-    autoReviewModel: z<string, string, "volatile">;
-    compactProvider: z<string, string, "volatile">;
-    compactModel: z<string, string, "volatile">;
-}>>, Schemastery.ObjectT<NoInfer<{
-    subagentMode: z<"follow-main" | "fixed", "follow-main" | "fixed", "volatile-defined">;
-    subagentProvider: z<string, string, "volatile">;
-    subagentModel: z<string, string, "volatile">;
-    subagentReasoningEffort: z<string, string, "volatile">;
-    searchProvider: z<string, string, "volatile">;
-    searchModel: z<string, string, "volatile">;
-    imageProvider: z<string, string, "volatile">;
-    imageModel: z<string, string, "volatile">;
-    compactOnSwitch: z<boolean, boolean, "volatile-defined">;
-    autoReviewProvider: z<string, string, "volatile">;
-    autoReviewModel: z<string, string, "volatile">;
-    compactProvider: z<string, string, "volatile">;
-    compactModel: z<string, string, "volatile">;
-}>>, "plain">;
+/**
+ * Annotated rather than inferred: the nested entry schema's inferred type
+ * expands to cosmokit internals (`Dict`) that cannot be named in the emitted
+ * declaration, and the annotation pins the output shape to this interface.
+ */
+export declare const Config: z<any, Config, 'plain'>;
 export declare function readConfig(config: Config): ModelSwitchSettings;

package/lib/types/provider-group.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Provider configuration groups: per-provider presets for the compaction,
+ * subagent, and auto-review routes.
+ *
+ * A group stores the exact flat settings fields it will write, so applying a
+ * group is a plain settings-layer write: every capability consumer keeps
+ * reading the live values unchanged. All functions here are pure and never
+ * throw on malformed storage.
+ */
+import type { SubagentMode } from './host-settings.js';
+/** Flat settings fields a provider group can pin — exactly what an application writes. */
+export type ProviderGroupRouteField = 'compactProvider' | 'compactModel' | 'autoReviewProvider' | 'autoReviewModel' | 'subagentProvider' | 'subagentModel' | 'subagentReasoningEffort';
+/** Stored entry: the owning provider plus every route field; '' means the capability stays at its default. */
+export interface ProviderGroupEntry {
+    provider: string;
+    compactProvider: string;
+    compactModel: string;
+    autoReviewProvider: string;
+    autoReviewModel: string;
+    subagentProvider: string;
+    subagentModel: string;
+    subagentReasoningEffort: string;
+}
+/** Normalized view of one provider's group; absent fields follow their default state. */
+export type ProviderGroupConfig = Partial<Record<ProviderGroupRouteField, string>>;
+/** Normalized provider → group map. */
+export type ProviderGroups = Readonly<Record<string, ProviderGroupConfig>>;
+/** Storage shape of the volatile `providerGroups` config field: one entry per provider. */
+export type ProviderGroupsStorage = readonly ProviderGroupEntry[];
+/**
+ * Strip a raw stored value to well-formed groups; never throws. Both storage
+ * shapes are accepted: the stored entry array (keys live in each entry's
+ * `provider` field) and a hand-written provider → routes map (keys are the
+ * providers). All-empty entries stay: they pin a provider to every default.
+ */
+export declare function normalizeProviderGroups(raw: unknown): ProviderGroups;
+/**
+ * The saved group for a provider.
+ * @returns the normalized group, or undefined when the provider has no group —
+ * which is what leaves the live routes untouched during a switch.
+ */
+export declare function groupOf(groups: ProviderGroups | undefined, provider: string): ProviderGroupConfig | undefined;
+/** One application write; `value` undefined means "unset this field". */
+export type ProviderGroupWrite = {
+    readonly field: 'subagentMode';
+    readonly mode: SubagentMode;
+} | {
+    readonly field: ProviderGroupRouteField;
+    readonly value: string | undefined;
+};
+/**
+ * Ordered writes applying one group with full-replacement semantics: pinned
+ * capabilities land as pairs, everything else reverts to its default state
+ * (compaction/review follow the session model; Subagent follows official
+ * inherit). The mode write comes last so a fixed route never publishes with
+ * the previous provider's fields still half-written.
+ */
+export declare function providerGroupWrites(group: ProviderGroupConfig): ProviderGroupWrite[];
+/** Storage entry for one provider's group; absent or blank route fields become ''. */
+export declare function entryOf(provider: string, group: ProviderGroupConfig): ProviderGroupEntry;
+/**
+ * The stored entry list with one provider's group replaced (an entry) or
+ * removed (undefined). Every entry is re-normalized and de-duplicated so a
+ * save can never write junk back; the input is never mutated. A blank
+ * provider only normalizes.
+ */
+export declare function withProviderGroup(storage: unknown, provider: string, group: ProviderGroupConfig | undefined): ProviderGroupsStorage;
+/** Minimal writable settings surface an application needs; satisfied by the owned ConfigForm. */
+export interface ProviderGroupSink {
+    set(field: 'subagentMode' | ProviderGroupRouteField, value: string): Promise<unknown>;
+    unset(field: ProviderGroupRouteField): Promise<unknown>;
+}
+/**
+ * Apply a saved group's routes to the live flat settings.
+ * @returns true when a group existed and every write settled; false when the
+ * provider has no group (nothing was written). A rejected write propagates.
+ */
+export declare function applyProviderGroupTo(sink: ProviderGroupSink, groups: ProviderGroups | undefined, provider: string): Promise<boolean>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-model-switch",
-  "version": "0.4.21",
+  "version": "0.4.22",
   "description": "Explicit model routing plus composer/Plan picker for DeepSeek Harness",
   "repository": {
     "type": "git",