@fonlan/dsh-model-router 0.3.5 → 0.3.7

package/lib/index.js

@@ -311,10 +311,36 @@ function setOrder(config, modelId, order, catalogProviderIds) {
 		changed: true
 	};
 }
+/**
+* Dereference one config field as the loader may hand it over.
+*
+* dsh >= 0.1.7 owns plugin configuration as entry config, and every field the
+* `Config` schema marks `.volatile()` arrives as a stable REFERENCE
+* (`{ get() }`, schemastery's `Volatile<T>`) instead of a plain value — a
+* reference serializes to `{}`. Reading such a field raw silently yields
+* `models: {}`, `modelSort: 'custom'`, an empty `modelOrder` and no
+* `recentlyUsed`: the stored document is dropped, and the next persist
+* overwrites it with catalog defaults. Plain values pass through unchanged, so
+* this is safe for the write paths and for callers that already hold a
+* resolved document.
+*/
+function derefField(value) {
+	if (value !== null && typeof value === "object" && typeof value.get === "function") return value.get();
+	return value;
+}
+/** Dereference every own field of a config object (per-field volatile refs). */
+function derefConfig(value) {
+	const root = derefField(value);
+	if (root === null || typeof root !== "object" || Array.isArray(root)) return root;
+	const out = {};
+	for (const [key, field] of Object.entries(root)) out[key] = derefField(field);
+	return out;
+}
 /** Shape-validate an unknown value as a RouterConfigShape (lenient). */
 function normalizeConfig(value) {
 	const models = {};
-	if (typeof value !== "object" || value === null) return {
+	const source = derefConfig(value);
+	if (typeof source !== "object" || source === null) return {
 		models,
 		showQuickSwitch: true,
 		ignoreModelIdPrefix: true,
@@ -322,7 +348,7 @@ function normalizeConfig(value) {
 		modelOrder: [],
 		recentlyUsed: {}
 	};
-	const root = value;
+	const root = source;
 	const showQuickSwitch = root.showQuickSwitch !== false;
 	const ignoreModelIdPrefix = root.ignoreModelIdPrefix !== false;
 	const modelSort = root.modelSort === "name" || root.modelSort === "recent" ? root.modelSort : "custom";
@@ -589,25 +615,17 @@ const RouterConfigSchema = z.object({
 	models: z.dict(z.object({
 		order: z.array(z.string()),
 		active: z.string()
-	})),
-	showQuickSwitch: z.boolean(),
-	ignoreModelIdPrefix: z.boolean(),
+	})).volatile(),
+	showQuickSwitch: z.boolean().volatile(),
+	ignoreModelIdPrefix: z.boolean().volatile(),
 	modelSort: z.union([
 		z.const("custom"),
 		z.const("name"),
 		z.const("recent")
-	]),
-	modelOrder: z.array(z.string()),
-	recentlyUsed: z.dict(z.number())
+	]).volatile(),
+	modelOrder: z.array(z.string()).volatile(),
+	recentlyUsed: z.dict(z.number()).volatile()
 });
-const EMPTY_CONFIG = {
-	models: {},
-	showQuickSwitch: true,
-	ignoreModelIdPrefix: true,
-	modelSort: "custom",
-	modelOrder: [],
-	recentlyUsed: {}
-};
 var ModelRouterService = class {
 	ctx;
 	cached = {
@@ -619,22 +637,30 @@ var ModelRouterService = class {
 	};
 	inflight = null;
 	cachedAt = 0;
-	scope;
+	/** Optional host settings service; absent in profiles without one (no persistence). */
+	settings;
+	/** Live config document (seeded from the entry config, updated on write). */
+	configDoc;
 	registration;
 	/** How long a built catalog is considered fresh before being rebuilt. */
 	catalogTtlMs = 3e4;
-	/** Debounced recent-use persistence (see noteModelUsed / flushUsage). */
-	usageFlushMs = 1500;
+	/**
+	* Debounced recent-use persistence (see noteModelUsed / flushUsage). Kept
+	* long on purpose: every persist writes the entry config, which restarts
+	* this plugin's entry, so usage bookkeeping must not stream live traffic.
+	*/
+	usageFlushMs = 6e4;
 	usageDebounce = null;
 	pendingUsage = {};
 	usageFlushRunning = false;
-	constructor(ctx) {
+	constructor(ctx, config) {
 		this.ctx = ctx;
+		this.configDoc = normalizeConfig(config);
 	}
-	/** Register settings + adapter and wire topology listeners. */
+	/** Register the settings seam + adapter and wire topology listeners. */
 	start() {
 		this.ctx.inject(["settings"], (sctx) => {
-			this.scope = sctx.settings.register(NS, RouterConfigSchema);
+			this.settings = sctx.settings;
 		});
 		const adapter = new ModelRouterAdapter(this);
 		this.registration = this.ctx.llm.registerAdapter([ROUTER_PROVIDER_ID], adapter);
@@ -648,7 +674,7 @@ var ModelRouterService = class {
 			clearTimeout(this.usageDebounce);
 			this.usageDebounce = null;
 		}
-		if (Object.keys(this.pendingUsage).length > 0) this.flushUsage();
+		this.pendingUsage = {};
 		this.registration?.();
 		this.registration = void 0;
 	}
@@ -659,12 +685,7 @@ var ModelRouterService = class {
 		};
 	}
 	config() {
-		if (this.scope === void 0) return EMPTY_CONFIG;
-		try {
-			return normalizeConfig(this.scope.get());
-		} catch {
-			return EMPTY_CONFIG;
-		}
+		return this.configDoc;
 	}
 	providerNames() {
 		return this.cached.providerNames;
@@ -679,7 +700,7 @@ var ModelRouterService = class {
 	* write.
 	*/
 	noteModelUsed(modelId) {
-		if (this.scope === void 0) return;
+		if (this.settings === void 0) return;
 		this.pendingUsage[modelId] = Date.now();
 		if (this.usageDebounce !== null) return;
 		this.usageDebounce = setTimeout(() => {
@@ -694,9 +715,9 @@ var ModelRouterService = class {
 		const pending = this.pendingUsage;
 		this.pendingUsage = {};
 		try {
-			if (this.scope === void 0 || Object.keys(pending).length === 0) return;
+			if (this.settings === void 0 || Object.keys(pending).length === 0) return;
 			const current = this.config();
-			await this.scope.replace({
+			await this.writeConfig({
 				...current,
 				recentlyUsed: {
 					...current.recentlyUsed,
@@ -743,12 +764,12 @@ var ModelRouterService = class {
 	/** Refresh (forced), then persist any config drift (migration, new/vanished models). */
 	async refreshAndReconcile() {
 		const catalog = await this.refreshCatalog(true);
-		if (this.scope === void 0) return;
+		if (this.settings === void 0) return;
 		const current = this.config();
 		const { models, modelOrder, changed } = reconcileConfig(current, catalog.models);
 		if (!changed) return;
 		try {
-			await this.scope.replace({
+			await this.writeConfig({
 				...current,
 				models,
 				...modelOrder === void 0 ? {} : { modelOrder }
@@ -770,6 +791,7 @@ var ModelRouterService = class {
 		const names = catalog.providerNames;
 		const creds = catalog.credentialConfigured;
 		return {
+			writable: this.settings !== void 0,
 			showQuickSwitch: config.showQuickSwitch,
 			ignoreModelIdPrefix: config.ignoreModelIdPrefix,
 			modelSort: config.modelSort,
@@ -818,10 +840,9 @@ var ModelRouterService = class {
 	}
 	/** Toggle the composer quick route-switcher button (global, persisted). */
 	async setShowQuickSwitch(value) {
-		if (this.scope === void 0) throw new Error("model-router: settings service is not available in this profile");
 		const current = this.config();
 		if (current.showQuickSwitch === value) return;
-		await this.scope.replace({
+		await this.writeConfig({
 			...current,
 			showQuickSwitch: value
 		});
@@ -833,10 +854,9 @@ var ModelRouterService = class {
 	* turning on; split models re-initialize when turning off).
 	*/
 	async setIgnoreModelIdPrefix(value) {
-		if (this.scope === void 0) throw new Error("model-router: settings service is not available in this profile");
 		const current = this.config();
 		if (current.ignoreModelIdPrefix === value) return;
-		await this.scope.replace({
+		await this.writeConfig({
 			...current,
 			ignoreModelIdPrefix: value
 		});
@@ -844,10 +864,9 @@ var ModelRouterService = class {
 	}
 	/** Switch the model-list display order mode (global, persisted). */
 	async setModelSort(mode) {
-		if (this.scope === void 0) throw new Error("model-router: settings service is not available in this profile");
 		const current = this.config();
 		if (current.modelSort === mode) return;
-		await this.scope.replace({
+		await this.writeConfig({
 			...current,
 			modelSort: mode
 		});
@@ -858,22 +877,26 @@ var ModelRouterService = class {
 	* always covers the live catalog.
 	*/
 	async setModelOrder(order) {
-		if (this.scope === void 0) throw new Error("model-router: settings service is not available in this profile");
 		await this.refreshCatalog();
 		const ids = new Set(this.cached.models.map((model) => model.id));
 		const clean = order.filter((id) => ids.has(id));
 		for (const model of this.cached.models) if (!clean.includes(model.id)) clean.push(model.id);
 		const current = this.config();
 		if (clean.length === current.modelOrder.length && clean.every((id, at) => id === current.modelOrder[at])) return;
-		await this.scope.replace({
+		await this.writeConfig({
 			...current,
 			modelOrder: clean
 		});
 	}
+	/** Write the document through the host settings service (entry config). */
+	async writeConfig(next) {
+		if (this.settings === void 0) throw new Error("model-router: settings service is not available in this profile");
+		await this.settings.replace(NS, next, void 0);
+		this.configDoc = normalizeConfig(next);
+	}
 	async persist(models) {
-		if (this.scope === void 0) throw new Error("model-router: settings service is not available in this profile");
 		const current = this.config();
-		await this.scope.replace({
+		await this.writeConfig({
 			...current,
 			models
 		});
@@ -1023,9 +1046,9 @@ function requireString(value, name) {
 //#region src/index.ts
 const name = "@fonlan/dsh-model-router";
 const inject = ["llm"];
-const Config = z.object({});
-function apply(ctx) {
-	const service = new ModelRouterService(ctx);
+const Config = RouterConfigSchema;
+function apply(ctx, config) {
+	const service = new ModelRouterService(ctx, config);
 	ctx.effect(() => {
 		service.start();
 		return () => service.stop();

package/lib/types/index.d.ts

@@ -3,13 +3,14 @@
  *
  * Registers one `model-router` LLM adapter that aggregates every configured
  * provider and model (strict model-id merge), routes each request to the
- * model's currently active provider by in-process delegation, persists the
- * per-model provider order/active config in the `model-router` settings
- * namespace, and serves the fenced JSON API the web settings page calls.
+ * model's currently active provider by in-process delegation, keeps the
+ * per-model provider order/active config in the entry config of this bundle
+ * (dsh >= 0.1.7: the `Config` schema below is the settings document), and
+ * serves the fenced JSON API the web settings page calls.
  */
 import type { Context } from '@deepseek-ai/cordis';
-import z from '@deepseek-ai/schemastery';
+import type { RouterConfigShape } from './shared/config.js';
 export declare const name = "@fonlan/dsh-model-router";
 export declare const inject: string[];
-export declare const Config: z<Schemastery.ObjectS<{}>, Schemastery.ObjectT<{}>>;
-export declare function apply(ctx: Context): void;
+export declare const Config: import("@deepseek-ai/schemastery").default<RouterConfigShape>;
+export declare function apply(ctx: Context, config: RouterConfigShape): void;

package/lib/types/server/service.d.ts

@@ -9,10 +9,24 @@ import { type ModelSortMode, type RouterConfigShape } from '../shared/config.js'
 import { type RouterCatalog } from './catalog.js';
 import { type RouterFacts } from './adapter.js';
 export declare const NS = "model-router";
+/**
+ * The slice of the host settings service this plugin writes through. dsh >=
+ * 0.1.7 owns plugin configuration as entry config (the plugin's `Config`
+ * schema), so the router reads the document it was applied with and persists
+ * updates via `settings.replace`, which writes the profile patch.
+ */
+export interface SettingsReplaceFace {
+    replace(ns: string, section: object, expectedRevision?: number): Promise<void>;
+}
 /** Settings document schema: one entry per model id. */
 export declare const RouterConfigSchema: z<RouterConfigShape>;
 /** The settings-page state view served by the API. */
 export interface ModelRouterState {
+    /**
+     * Whether this deployment can persist configuration. False (a profile
+     * without the host settings service) makes the page render read-only.
+     */
+    writable: boolean;
     /** Whether provider switching is shown inside the composer model picker menu. */
     showQuickSwitch: boolean;
     /** Whether model ids are matched with their leading vendor/ prefix ignored. */
@@ -46,17 +60,24 @@ export declare class ModelRouterService implements RouterFacts {
     private cached;
     private inflight;
     private cachedAt;
-    private scope;
+    /** Optional host settings service; absent in profiles without one (no persistence). */
+    private settings;
+    /** Live config document (seeded from the entry config, updated on write). */
+    private configDoc;
     private registration;
     /** How long a built catalog is considered fresh before being rebuilt. */
     private readonly catalogTtlMs;
-    /** Debounced recent-use persistence (see noteModelUsed / flushUsage). */
+    /**
+     * Debounced recent-use persistence (see noteModelUsed / flushUsage). Kept
+     * long on purpose: every persist writes the entry config, which restarts
+     * this plugin's entry, so usage bookkeeping must not stream live traffic.
+     */
     private readonly usageFlushMs;
     private usageDebounce;
     private pendingUsage;
     private usageFlushRunning;
-    constructor(ctx: Context);
-    /** Register settings + adapter and wire topology listeners. */
+    constructor(ctx: Context, config: RouterConfigShape);
+    /** Register the settings seam + adapter and wire topology listeners. */
     start(): void;
     stop(): void;
     catalog(): {
@@ -115,5 +136,7 @@ export declare class ModelRouterService implements RouterFacts {
      * always covers the live catalog.
      */
     setModelOrder(order: string[]): Promise<void>;
+    /** Write the document through the host settings service (entry config). */
+    private writeConfig;
     private persist;
 }

package/lib/types/shared/config.d.ts

@@ -198,5 +198,7 @@ export declare function setOrder(config: RouterConfigShape, modelId: string, ord
     models: Record<string, RouterModelConfig>;
     changed: boolean;
 };
+/** Dereference every own field of a config object (per-field volatile refs). */
+export declare function derefConfig(value: unknown): unknown;
 /** Shape-validate an unknown value as a RouterConfigShape (lenient). */
 export declare function normalizeConfig(value: unknown): RouterConfigShape;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fonlan/dsh-model-router",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "DSH plugin: a virtual model-router provider that aggregates every configured provider and model, routes each request to the model's currently active provider, and ships a settings page for per-model provider ordering and switching.",
   "license": "MIT",
   "repository": {
@@ -63,15 +63,15 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/schemastery": "^3.18.2",
-    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-credentials": "^0.1.2-alpha.2",
     "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-alpha.2",
     "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-alpha.2",
     "@deepseek-ai/dsh-client-ui-model-selection": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-credentials": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2",
+    "@deepseek-ai/schemastery": "^3.18.2",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
@@ -92,7 +92,7 @@
     "@deepseek-ai/dsh-session": "^0.1.2-alpha.2",
     "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2",
     "@deepseek-ai/dsh-timeout": "0.1.2-alpha.2",
-    "@deepseek-ai/schemastery": "^3.18.2",
+    "@deepseek-ai/schemastery": "^3.18.3",
     "@types/node": "^22.0.0",
     "@types/react": "~18.3.1",
     "@types/react-dom": "~18.3.0",

package/src/client/api.ts

@@ -16,6 +16,11 @@ export interface RouterModelView {
 }
 
 export interface ModelRouterState {
+  /**
+   * Whether this deployment can persist router configuration (the host half
+   * found the settings service). False renders the page read-only.
+   */
+  writable: boolean
   /** Whether provider switching is shown inside the composer model picker menu. */
   showQuickSwitch: boolean
   /** Whether model ids are matched with their leading vendor/ prefix ignored. */

package/src/client/icons.tsx

@@ -0,0 +1,97 @@
+import * as primitives from '@deepseek-ai/dsh-client-ui-primitives'
+
+/** Props every shell icon accepts: square edge in px, color rides currentColor. */
+export interface IconProps {
+  size?: number
+  className?: string
+}
+
+/** One shell icon component. */
+export type IconComponent = (props: IconProps) => JSX.Element
+
+/** The runtime export table, read by capability instead of by one hard-coded name. */
+const table = primitives as unknown as Record<string, IconComponent | undefined>
+
+/** First name the runtime actually provides (a missing export is `undefined`). */
+function firstDefined(...names: string[]): IconComponent | undefined {
+  for (const name of names) {
+    let candidate: IconComponent | undefined
+    try {
+      candidate = table[name]
+    } catch {
+      // Some module namespaces reject unknown names instead of yielding
+      // `undefined`; a rename must never throw on its way to the fallback.
+      continue
+    }
+    if (typeof candidate === 'function') return candidate
+  }
+  return undefined
+}
+
+/** One-path stroked glyph fallback (16×16 viewBox — the 0.1.7 artwork). */
+function glyph(path: string, defaultSize: number): IconComponent {
+  return function Glyph({ size = defaultSize, className }: IconProps): JSX.Element {
+    return (
+      <svg
+        width={size}
+        height={size}
+        className={className}
+        viewBox="0 0 16 16"
+        fill="none"
+        xmlns="http://www.w3.org/2000/svg"
+        aria-hidden="true"
+        strokeWidth={1}
+      >
+        <path d={path} stroke="currentColor" />
+      </svg>
+    )
+  }
+}
+
+/** Warning circle fallback (the 0.1.7 artwork: ring, stem, dot). */
+function WarningFallback({ size = 16, className }: IconProps): JSX.Element {
+  return (
+    <svg
+      width={size}
+      height={size}
+      className={className}
+      viewBox="0 0 16 16"
+      fill="none"
+      xmlns="http://www.w3.org/2000/svg"
+      aria-hidden="true"
+      strokeWidth={1}
+    >
+      <path d="M8 14.5C11.5899 14.5 14.5 11.5899 14.5 8C14.5 4.41015 11.5899 1.5 8 1.5C4.41015 1.5 1.5 4.41015 1.5 8C1.5 11.5899 4.41015 14.5 8 14.5Z" stroke="currentColor" />
+      <path d="M8 4.29199V9.79199" stroke="currentColor" />
+      <path d="M8 10.708V11.708" stroke="currentColor" />
+    </svg>
+  )
+}
+
+/**
+ * Shell icons used by the model seat.
+ *
+ * DSH 0.1.7 renamed every size-suffixed icon export (`IconCheckOutline16`,
+ * `IconChevronDownOutline14`, …) into stroke-weight variants (`…OutlineRegular`
+ * 1px / `…OutlineMedium` 1.3px). A stale named import resolves to `undefined`
+ * and React then throws "Element type is invalid" while rendering the slot
+ * entry — the whole seat is dropped from the conversation input instead of
+ * degrading (this is exactly what the 0.1.7 upgrade did to this plugin).
+ * Resolve the names at runtime, newest first, so the next rename lands on
+ * another shipped variant or on the inlined artwork below.
+ */
+export const CheckIcon: IconComponent =
+  firstDefined('IconCheckOutlineRegular', 'IconCheckOutlineMedium', 'IconCheckOutline16')
+  ?? glyph('M2.25 8.5L5.49732 11.7473C5.90519 12.1552 6.57263 12.1344 6.95426 11.7018L13.75 4', 16)
+
+export const ChevronDownIcon: IconComponent =
+  firstDefined('IconChevronDownOutlineRegular', 'IconChevronDownOutlineMedium', 'IconChevronDownOutline14')
+  ?? glyph('M4 6L7.29289 9.29289C7.68342 9.68342 8.31658 9.68342 8.70711 9.29289L12 6', 14)
+
+export const ChevronRightIcon: IconComponent =
+  firstDefined('IconChevronRightOutlineRegular', 'IconChevronRightOutlineMedium', 'IconChevronRightOutline14')
+  ?? glyph('M6 12L9.29289 8.70711C9.68342 8.31658 9.68342 7.68342 9.29289 7.29289L6 4', 14)
+
+export const WarningIcon: IconComponent =
+  firstDefined('IconWarningOutlineRegular', 'IconWarningOutlineMedium', 'IconWarningOutline16')
+  ?? WarningFallback

package/src/client/index.tsx

@@ -1,7 +1,11 @@
 /**
- * @fonlan/dsh-model-router client half: the plugin's own Settings Card
- * (设置 → 插件 → 插件配置 → 模型路由) plus the model seat that merges the
- * provider switcher into DSH's composer model picker menu.
+ * @fonlan/dsh-model-router client half: the plugin's own Settings page
+ * (设置 → 侧栏「模型路由」) plus the model seat that merges the provider
+ * switcher into DSH's composer model picker menu.
+ *
+ * The page registers into the settings.section slot, so it owns one entry in
+ * the settings sidebar and renders in the panel content column; the page
+ * component itself lives in ./settings-section.
  */
 import type { Context } from '@deepseek-ai/cordis'
 type ClientContext = Context
@@ -11,25 +15,34 @@ import type {} from '@deepseek-ai/dsh-client-ui-settings/client'
 import type {} from '@deepseek-ai/dsh-client-ui-conversation/client'
 import type {} from '@deepseek-ai/dsh-client-ui-model-selection/client'
 import { LOCALE_NS, zh, en } from './locales'
-import { makeSettingsCard, type SettingsScopeFace } from './settings-card'
+import { makeSettingsSection } from './settings-section'
 import { registerModelRouterSeat } from './model-seat'
 
-/** The settings namespace this card edits (must match the host half). */
-const ROUTER_NS = 'model-router'
+/** The settings sidebar entry this page owns (must stay stable). */
+const SECTION_ID = 'model-router'
+
+/** Slots face: the settings.section list slot is declared at runtime by the
+ *  settings shell (ui-settings-general), which external plugins do not depend
+ *  on; the register call below is typed through this local face (erased at
+ *  build time). */
+interface SectionEntry {
+  name: string
+  id?: string
+  order?: number
+  label?: () => string
+  locale?: string
+}
 
-/** Slots face: the keyed `settings.plugin.item` declaration ships with the web
- *  app's ui-settings-plugins package, which external plugins do not depend on;
- *  the register call below is typed through this local face (erased at build). */
 interface Slots {
   inject(name: string, callback: () => unknown): unknown
-  register(def: { name: string; key: string; inject?: () => unknown }, component: unknown): unknown
+  register(def: SectionEntry, component: unknown): unknown
 }
 
 /** Services required before mounting (provided by the client runtime).
  *  `remote.session` is included like the host ui-model-selection declares it:
  *  the seat's `directoryFor` depends on the namespace, which mounts
  *  asynchronously at startup. */
-export const inject = ['slots', 'locale', 'modelDirectories', 'sessions', 'settingsScope', 'connection', 'remote', 'remote.session']
+export const inject = ['slots', 'locale', 'modelDirectories', 'sessions', 'connection', 'remote', 'remote.session']
 
 /** Client plugin body. */
 export function apply(ctx: ClientContext): void {
@@ -38,26 +51,30 @@ export function apply(ctx: ClientContext): void {
     return () => off()
   }, 'model-router: dictionaries')
 
-  const SettingsCard = makeSettingsCard(ctx)
-
-  // The card registers on the `settings.plugin.item` slot keyed by the
-  // `model-router` settings namespace (the same string the host half
-  // registers), so it appears inside 设置 → 插件 → 插件配置, paired with the
-  // namespace by the tab.
-  const services = ctx as unknown as {
-    slots: Slots
-    settingsScope: { bind(spec: { namespace: string }): SettingsScopeFace }
-  }
-  const scope = services.settingsScope.bind({ namespace: ROUTER_NS })
+  const t = ctx.locale.bind(LOCALE_NS) as unknown as (key: string) => string
+  const SettingsSection = makeSettingsSection(ctx)
 
-  services.slots.inject('settings.plugin.item', () =>
-    services.slots.register(
+  // The page registers on the settings.section list slot under a stable id, so
+  // it appears in the settings sidebar's left navigation.
+  //
+  // dsh >= 0.1.7 dropped the client-side `settingsScope` service (plugin
+  // configuration became loader-entry config, projected by the host), and the
+  // old conditional registration therefore never fired: the section silently
+  // disappeared from Settings. Register unconditionally — the page reads and
+  // writes through this plugin's own fenced API (see ./settings-section), so
+  // it needs no settings service at all. Never gate a slot registration on a
+  // service that may not exist: the failure mode is an invisible page.
+  const slots = (ctx as unknown as { slots: Slots }).slots
+  slots.inject('settings.section', () =>
+    slots.register(
       {
-        name: 'settings.plugin.item',
-        key: ROUTER_NS,
-        inject: () => ({ scope }),
+        name: 'settings.section',
+        id: SECTION_ID,
+        order: 300,
+        label: () => t('settingsTitle'),
+        locale: LOCALE_NS,
       },
-      SettingsCard,
+      SettingsSection,
     ),
   )
 

package/src/client/locales.ts

@@ -6,9 +6,7 @@ export const LOCALE_NS = 'model-router'
 
 export const zh = {
   settingsTitle: '模型路由',
-  settingsCardDescription: '模型聚合、提供商切换与优先级顺序',
-  expand: '展开',
-  collapse: '收起',
+  sectionSub: '模型聚合、提供商切换与优先级顺序',
   readOnly: '本部署的设置为只读。',
   loading: '加载中…',
   loadFailed: '加载失败：{message}',
@@ -58,11 +56,9 @@ export const zh = {
   sortFailed: '排序设置失败：{message}',
 }
 
-export const en = {
+export const en: Record<keyof typeof zh, string> = {
   settingsTitle: 'Model Router',
-  settingsCardDescription: 'Model aggregation, provider switching and preference order',
-  expand: 'Expand',
-  collapse: 'Collapse',
+  sectionSub: 'Model aggregation, provider switching and preference order',
   readOnly: 'This deployment stores settings read-only.',
   loading: 'Loading…',
   loadFailed: 'Load failed: {message}',