@fonlan/dsh-model-router 0.1.0 → 0.2.0

package/src/client/settings-section.tsx

@@ -58,6 +58,7 @@ export function makeSettingsSection(ctx: ClientContext): () => JSX.Element {
     const [loading, setLoading] = useState(true)
     const [busyModel, setBusyModel] = useState<string | null>(null)
     const [drag, setDrag] = useState<{ modelId: string; index: number } | null>(null)
+    const [quickSwitchBusy, setQuickSwitchBusy] = useState(false)
 
     const load = useCallback(async () => {
       setLoading(true)
@@ -110,11 +111,39 @@ export function makeSettingsSection(ctx: ClientContext): () => JSX.Element {
       }
     }, [t])
 
+    const toggleQuickSwitch = useCallback(async (value: boolean) => {
+      if (state === null) return
+      const previous = state.showQuickSwitch
+      setState(prev => prev === null ? prev : { ...prev, showQuickSwitch: value })
+      setQuickSwitchBusy(true)
+      try {
+        setState(await api.setShowQuickSwitch(value))
+        setError(null)
+      } catch (cause) {
+        setState(prev => prev === null ? prev : { ...prev, showQuickSwitch: previous })
+        setError(cause instanceof Error ? cause.message : String(cause))
+      } finally {
+        setQuickSwitchBusy(false)
+      }
+    }, [state])
+
     const models = useMemo(() => state?.models ?? [], [state])
 
     return (
       <div className="mr-root">
         <p className="mr-description">{t('settingsDescription')}</p>
+        <label className="mr-quick-switch">
+          <input
+            type="checkbox"
+            checked={state?.showQuickSwitch ?? true}
+            disabled={loading || quickSwitchBusy}
+            onChange={(event) => void toggleQuickSwitch(event.target.checked)}
+          />
+          <span className="mr-quick-switch-copy">
+            <span className="mr-quick-switch-label">{t('showQuickSwitchLabel')}</span>
+            <span className="mr-quick-switch-desc">{t('showQuickSwitchDescription')}</span>
+          </span>
+        </label>
         <div className="mr-toolbar">
           <span className="mr-count">{t('modelsCount', { count: models.length })}</span>
           <button type="button" className="mr-button" onClick={() => void load()} disabled={loading}>

package/src/server/rpc.ts

@@ -134,6 +134,14 @@ export function registerApiRoutes(ctx: Context, service: ModelRouterService): ()
     return service.state()
   })
 
+  route('set-show-quick-switch', async (p) => {
+    if (typeof p.value !== 'boolean') {
+      throw new Error('value 必须是布尔值')
+    }
+    await service.setShowQuickSwitch(p.value)
+    return service.state()
+  })
+
   return () => {
     for (const dispose of disposers) dispose()
   }

package/src/server/service.ts

@@ -29,12 +29,17 @@ export const RouterConfigSchema: z<RouterConfigShape> = z.object({
     order: z.array(z.string()),
     active: z.string(),
   })),
+  // Older documents predate the toggle; normalizeConfig defaults to true.
+  // Schemastery object keys are input-optional, so absent is valid here.
+  showQuickSwitch: z.boolean(),
 })
 
-const EMPTY_CONFIG: RouterConfigShape = { models: {} }
+const EMPTY_CONFIG: RouterConfigShape = { models: {}, showQuickSwitch: true }
 
 /** The settings-page state view served by the API. */
 export interface ModelRouterState {
+  /** Whether the composer quick route-switcher button is enabled. */
+  showQuickSwitch: boolean
   providers: Array<{ id: string; name: string; credentialConfigured: boolean }>
   models: Array<{
     id: string
@@ -159,7 +164,7 @@ export class ModelRouterService implements RouterFacts {
     }
     if (!changed) return
     try {
-      await this.scope.replace({ models: next })
+      await this.scope.replace({ models: next, showQuickSwitch: this.config().showQuickSwitch })
     } catch (error) {
       this.ctx.logger.warn(`model-router: reconcile persist failed: ${error instanceof Error ? error.message : String(error)}`)
     }
@@ -181,6 +186,7 @@ export class ModelRouterService implements RouterFacts {
     const names = catalog.providerNames
     const creds = catalog.credentialConfigured
     return {
+      showQuickSwitch: config.showQuickSwitch,
       providers: catalog.providers.map(provider => ({
         id: provider.id,
         name: names.get(provider.id) ?? provider.id,
@@ -230,10 +236,20 @@ export class ModelRouterService implements RouterFacts {
     await this.persist(models)
   }
 
+  /** Toggle the composer quick route-switcher button (global, persisted). */
+  async setShowQuickSwitch(value: boolean): Promise<void> {
+    if (this.scope === undefined) {
+      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({ models: current.models, showQuickSwitch: value })
+  }
+
   private async persist(models: Record<string, { order: string[]; active: string }>): Promise<void> {
     if (this.scope === undefined) {
       throw new Error('model-router: settings service is not available in this profile')
     }
-    await this.scope.replace({ models })
+    await this.scope.replace({ models, showQuickSwitch: this.config().showQuickSwitch })
   }
 }

package/src/shared/config.ts

@@ -56,6 +56,12 @@ export interface RouterModelConfig {
 /** The whole router config document. */
 export interface RouterConfigShape {
   models: Record<string, RouterModelConfig>
+  /**
+   * Whether the quick route-switcher button is shown beside the composer
+   * model selector (settings → 模型路由 → 显示快速路由切换按钮). Stored
+   * globally; absent/unknown documents normalize to `true`.
+   */
+  showQuickSwitch: boolean
 }
 
 export const ROUTER_PROVIDER_ID = 'model-router'
@@ -216,9 +222,11 @@ export function setOrder(
 /** Shape-validate an unknown value as a RouterConfigShape (lenient). */
 export function normalizeConfig(value: unknown): RouterConfigShape {
   const models: Record<string, RouterModelConfig> = {}
-  if (typeof value !== 'object' || value === null) return { models }
-  const raw = (value as { models?: unknown }).models
-  if (typeof raw !== 'object' || raw === null) return { models }
+  if (typeof value !== 'object' || value === null) return { models, showQuickSwitch: true }
+  const root = value as { models?: unknown; showQuickSwitch?: unknown }
+  const showQuickSwitch = root.showQuickSwitch !== false
+  const raw = root.models
+  if (typeof raw !== 'object' || raw === null) return { models, showQuickSwitch }
   for (const [id, entry] of Object.entries(raw as Record<string, unknown>)) {
     if (typeof entry !== 'object' || entry === null) continue
     const e = entry as { order?: unknown; active?: unknown }
@@ -227,5 +235,5 @@ export function normalizeConfig(value: unknown): RouterConfigShape {
     if (active === '') continue
     models[id] = { order, active }
   }
-  return { models }
+  return { models, showQuickSwitch }
 }