diff --git a/.prettierignore b/.prettierignore
index 9b944a2f..53870e99 100644
--- a/.prettierignore
+++ b/.prettierignore
@@ -52,6 +52,8 @@ temp/
 .worktrees/
 .e2e-runtime/
 .e2e-tools/
+.vite-cache/
+**/.vite-cache/
 .cargo-temp/
 rust-target/
 rust-temp/
diff --git a/apps/desktop/src/components/AlertMessage.vue b/apps/desktop/src/components/AlertMessage.vue
index 92aa081d..5aa0d2ec 100644
--- a/apps/desktop/src/components/AlertMessage.vue
+++ b/apps/desktop/src/components/AlertMessage.vue
@@ -1,7 +1,26 @@
 <!-- Copyright (c) 2025-2026. Qian Cheng. Licensed under GPL v3 -->
 
 <script lang="ts">
+    type AlertSonnerOwnerListener = () => void;
+
     let sonnerOwnerUid: number | null = null;
+    const alertSonnerOwnerListeners = new Set<AlertSonnerOwnerListener>();
+
+    /**
+     * Coordinates the single Sonner host shared by all alert components.
+     *
+     * Vue runs this ownership protocol on the browser's single JavaScript thread,
+     * so checking and assigning the owner is atomic enough without locks. When the
+     * owning component unmounts it clears the owner and notifies the remaining
+     * subscribers; the first still-mounted instance that refreshes claims the host.
+     * If no instances remain, the owner stays empty until another AlertMessage
+     * mounts and claims it.
+     */
+    const notifyAlertSonnerOwnerChanged = (): void => {
+        for (const listener of [...alertSonnerOwnerListeners]) {
+            listener();
+        }
+    };
 
     const claimAlertSonnerOwner = (uid: number): boolean => {
         if (sonnerOwnerUid === null) {
@@ -15,8 +34,16 @@
     const releaseAlertSonnerOwner = (uid: number): void => {
         if (sonnerOwnerUid === uid) {
             sonnerOwnerUid = null;
+            notifyAlertSonnerOwnerChanged();
         }
     };
+
+    const subscribeAlertSonnerOwner = (listener: AlertSonnerOwnerListener): (() => void) => {
+        alertSonnerOwnerListeners.add(listener);
+        return () => {
+            alertSonnerOwnerListeners.delete(listener);
+        };
+    };
 </script>
 
 <script setup lang="ts">
@@ -35,12 +62,20 @@
 
     const isSonnerOwner = ref(false);
     const instanceUid = getCurrentInstance()?.uid;
+    let unsubscribeAlertSonnerOwner: (() => void) | undefined;
 
-    if (instanceUid !== undefined) {
+    const refreshSonnerOwner = () => {
+        if (instanceUid === undefined) return;
         isSonnerOwner.value = claimAlertSonnerOwner(instanceUid);
+    };
+
+    if (instanceUid !== undefined) {
+        refreshSonnerOwner();
+        unsubscribeAlertSonnerOwner = subscribeAlertSonnerOwner(refreshSonnerOwner);
     }
 
     onUnmounted(() => {
+        unsubscribeAlertSonnerOwner?.();
         if (instanceUid !== undefined && isSonnerOwner.value) {
             releaseAlertSonnerOwner(instanceUid);
         }
diff --git a/apps/desktop/src/components/DialogShell.vue b/apps/desktop/src/components/DialogShell.vue
index 49bfc4c8..ca6c6bf2 100644
--- a/apps/desktop/src/components/DialogShell.vue
+++ b/apps/desktop/src/components/DialogShell.vue
@@ -37,7 +37,7 @@
 <template>
     <Dialog :open="true" @update:open="onOpenChange">
         <DialogContent
-            :class="`w-full ${maxWidthClass} rounded-xl border border-gray-200 bg-white p-6 shadow-xl ${contentClass}`"
+            :class="`w-full ${maxWidthClass} rounded-xl border border-gray-200 bg-white p-6 font-serif text-[13px] shadow-xl ${contentClass}`"
             :overlay-class="'fixed inset-0 z-50 bg-black/40 backdrop-blur-sm'"
             @escape-key-down="preventWhenLocked"
             @pointer-down-outside="preventWhenLocked"
diff --git a/apps/desktop/src/components/appIconMap.ts b/apps/desktop/src/components/appIconMap.ts
index 73103f8e..525ce7a2 100644
--- a/apps/desktop/src/components/appIconMap.ts
+++ b/apps/desktop/src/components/appIconMap.ts
@@ -4,7 +4,7 @@ import IconArrowDown from '~icons/lucide/arrow-down';
 import IconArrowLeft from '~icons/lucide/arrow-left';
 import IconArrowRight from '~icons/lucide/arrow-right';
 import IconBlocks from '~icons/lucide/blocks';
-import IconBoxes from '~icons/lucide/boxes';
+import IconBrain from '~icons/lucide/brain-circuit';
 import IconBriefcase from '~icons/lucide/briefcase';
 import IconBug from '~icons/lucide/bug';
 import IconChevronDown from '~icons/lucide/chevron-down';
@@ -12,6 +12,7 @@ import IconChevronRight from '~icons/lucide/chevron-right';
 import IconChevronUp from '~icons/lucide/chevron-up';
 import IconCheckCircle from '~icons/lucide/circle-check';
 import IconXCircle from '~icons/lucide/circle-x';
+import IconCloud from '~icons/lucide/cloud';
 import IconCopy from '~icons/lucide/copy';
 import IconData from '~icons/lucide/database';
 import IconLinkExternal from '~icons/lucide/external-link';
@@ -36,6 +37,7 @@ import IconPin from '~icons/lucide/pin';
 import IconPlay from '~icons/lucide/play';
 import IconPlus from '~icons/lucide/plus';
 import IconRefresh from '~icons/lucide/refresh-cw';
+import IconRoute from '~icons/lucide/route';
 import IconSearch from '~icons/lucide/search';
 import IconCog from '~icons/lucide/settings';
 import IconStop from '~icons/lucide/square';
@@ -53,6 +55,7 @@ export const appIconMap = {
     'chevron-right': IconChevronRight,
     'chevron-up': IconChevronUp,
     close: IconX,
+    cloud: IconCloud,
     copy: IconCopy,
     database: IconData,
     delete: IconTrash,
@@ -74,7 +77,7 @@ export const appIconMap = {
     maximize: IconMaximize,
     restore: IconWindowRestore,
     'information-circle': IconInfoCircle,
-    llm: IconBoxes,
+    llm: IconBrain,
     leaf: IconLeaf,
     'external-link': IconLinkExternal,
     mcp: IconBlocks,
@@ -83,6 +86,7 @@ export const appIconMap = {
     play: IconPlay,
     plus: IconPlus,
     refresh: IconRefresh,
+    route: IconRoute,
     search: IconSearch,
     settings: IconCog,
     stop: IconStop,
diff --git a/apps/desktop/src/database/drizzle/0004_model_preferences.sql b/apps/desktop/src/database/drizzle/0004_model_preferences.sql
new file mode 100644
index 00000000..0a34d80c
--- /dev/null
+++ b/apps/desktop/src/database/drizzle/0004_model_preferences.sql
@@ -0,0 +1,20 @@
+CREATE TABLE IF NOT EXISTS `model_preferences` (
+    `id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+    `name` text NOT NULL,
+    `description` text NOT NULL,
+    `provider_id` integer,
+    `model_id` integer,
+    `priority` integer DEFAULT 0 NOT NULL,
+    `created_at` text DEFAULT (datetime('now')) NOT NULL,
+    `updated_at` text DEFAULT (datetime('now')) NOT NULL,
+    FOREIGN KEY (`provider_id`) REFERENCES `providers`(`id`) ON UPDATE no action ON DELETE set null,
+    FOREIGN KEY (`model_id`) REFERENCES `models`(`id`) ON UPDATE no action ON DELETE set null
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `model_preferences_priority_idx` ON `model_preferences` (`priority`);
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `model_preferences_name_unique` ON `model_preferences` (`name`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `model_preferences_model_id_idx` ON `model_preferences` (`model_id`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `model_preferences_provider_id_idx` ON `model_preferences` (`provider_id`);
diff --git a/apps/desktop/src/database/drizzle/meta/_journal.json b/apps/desktop/src/database/drizzle/meta/_journal.json
index 39fea45f..ec8b0d9d 100644
--- a/apps/desktop/src/database/drizzle/meta/_journal.json
+++ b/apps/desktop/src/database/drizzle/meta/_journal.json
@@ -29,6 +29,13 @@
       "when": 1781021002699,
       "tag": "0003_tough_amazoness",
       "breakpoints": true
+    },
+    {
+      "idx": 4,
+      "version": "7",
+      "when": 1780051200000,
+      "tag": "0004_model_preferences",
+      "breakpoints": true
     }
   ]
-}
\ No newline at end of file
+}
diff --git a/apps/desktop/src/database/queries/models.ts b/apps/desktop/src/database/queries/models.ts
index 0b2975cf..c26dfafa 100644
--- a/apps/desktop/src/database/queries/models.ts
+++ b/apps/desktop/src/database/queries/models.ts
@@ -1,22 +1,34 @@
 // Copyright (c) 2026. 千诚. Licensed under GPL v3
 
-import { and, desc, eq, sql } from 'drizzle-orm';
+import { and, asc, desc, eq, sql } from 'drizzle-orm';
 
 import { tt } from '@/i18n';
 
 import { type DatabaseExecutor, db } from '../index';
-import { models, providers } from '../schema';
+import { modelPreferences, models, providers } from '../schema';
 import type {
     FindModelsWithProviderPayload,
     ModelCreateData,
     ModelEntity,
+    ModelPreferenceCreateData,
+    ModelPreferenceEntity,
+    ModelPreferenceUpdateData,
+    ModelPreferenceWithModel,
     ModelUpdateData,
     ModelWithProvider,
     ProviderModelLookupPayload,
 } from '../types';
+import { getSettingValue, setSetting } from './settings';
 
 export type { ModelWithProvider } from '../types';
 
+export type ModelRole = 'entry' | 'fast' | 'general';
+
+const MODEL_ROLE_SETTING_KEYS: Record<Exclude<ModelRole, 'entry'>, string> = {
+    fast: 'model_role_fast_model_id',
+    general: 'model_role_general_model_id',
+};
+
 export const modelWithProviderSelection = {
     id: models.id,
     created_at: models.created_at,
@@ -48,6 +60,22 @@ export const modelWithProviderSelection = {
     provider_logo: sql<string>`${providers.logo}`.as('provider_logo'),
 };
 
+export const modelPreferenceWithModelSelection = {
+    id: modelPreferences.id,
+    name: modelPreferences.name,
+    description: modelPreferences.description,
+    provider_id: modelPreferences.provider_id,
+    model_id: modelPreferences.model_id,
+    priority: modelPreferences.priority,
+    created_at: modelPreferences.created_at,
+    updated_at: modelPreferences.updated_at,
+    model_name: sql<string | null>`${models.name}`.as('model_name'),
+    model_api_id: sql<string | null>`${models.model_id}`.as('model_api_id'),
+    model_provider_id: sql<number | null>`${models.provider_id}`.as('model_provider_id'),
+    provider_name: sql<string | null>`${providers.name}`.as('provider_name'),
+    provider_enabled: sql<number | null>`${providers.enabled}`.as('provider_enabled'),
+};
+
 /**
  * 查找全局默认模型。
  */
@@ -96,6 +124,108 @@ export const findModelsWithProvider = async (
     return (await query.orderBy(desc(models.is_default), models.id).all()) as ModelWithProvider[];
 };
 
+function normalizeModelPreferenceDraft<
+    T extends ModelPreferenceCreateData | ModelPreferenceUpdateData,
+>(draft: T): T {
+    return {
+        ...draft,
+        ...(draft.name !== undefined ? { name: draft.name.trim() } : {}),
+        ...(draft.description !== undefined ? { description: draft.description.trim() } : {}),
+        ...(draft.updated_at === undefined ? { updated_at: new Date().toISOString() } : {}),
+    };
+}
+
+export const listModelPreferences = async (): Promise<ModelPreferenceWithModel[]> =>
+    (await db
+        .select(modelPreferenceWithModelSelection)
+        .from(modelPreferences)
+        .leftJoin(models, eq(models.id, modelPreferences.model_id))
+        .leftJoin(providers, eq(providers.id, models.provider_id))
+        .orderBy(asc(modelPreferences.priority), asc(modelPreferences.id))
+        .all()) as ModelPreferenceWithModel[];
+
+export const findModelPreferenceByName = async (
+    name: string
+): Promise<ModelPreferenceWithModel | undefined> =>
+    (await db
+        .select(modelPreferenceWithModelSelection)
+        .from(modelPreferences)
+        .leftJoin(models, eq(models.id, modelPreferences.model_id))
+        .leftJoin(providers, eq(providers.id, models.provider_id))
+        .where(eq(modelPreferences.name, name.trim()))
+        .orderBy(asc(modelPreferences.priority), asc(modelPreferences.id))
+        .limit(1)
+        .get()) as ModelPreferenceWithModel | undefined;
+
+export const createModelPreference = async (
+    preferenceDraft: ModelPreferenceCreateData
+): Promise<ModelPreferenceEntity> => {
+    const normalizedDraft = normalizeModelPreferenceDraft(preferenceDraft);
+    if (!normalizedDraft.name?.trim()) {
+        throw new Error('Model preference name is required');
+    }
+    if (!normalizedDraft.description?.trim()) {
+        throw new Error('Model preference description is required');
+    }
+
+    const createdPreference = await db
+        .insert(modelPreferences)
+        .values(normalizedDraft)
+        .returning()
+        .get();
+
+    if (!createdPreference || createdPreference.id === undefined) {
+        throw new Error('Failed to create model preference');
+    }
+
+    return createdPreference;
+};
+
+export const updateModelPreference = async (
+    id: number,
+    preferencePatch: ModelPreferenceUpdateData
+): Promise<void> => {
+    const normalizedPatch = normalizeModelPreferenceDraft(preferencePatch);
+    if (normalizedPatch.name !== undefined && !normalizedPatch.name.trim()) {
+        throw new Error('Model preference name is required');
+    }
+    if (normalizedPatch.description !== undefined && !normalizedPatch.description.trim()) {
+        throw new Error('Model preference description is required');
+    }
+
+    await db.update(modelPreferences).set(normalizedPatch).where(eq(modelPreferences.id, id)).run();
+};
+
+export const deleteModelPreference = async (id: number): Promise<boolean> => {
+    await db.delete(modelPreferences).where(eq(modelPreferences.id, id)).run();
+    return true;
+};
+
+export const findModelByIdWithProvider = async (
+    id: number
+): Promise<ModelWithProvider | undefined> =>
+    (await db
+        .select(modelWithProviderSelection)
+        .from(models)
+        .innerJoin(providers, eq(providers.id, models.provider_id))
+        .where(eq(models.id, id))
+        .get()) as ModelWithProvider | undefined;
+
+async function requireEnabledModelById(id: number): Promise<ModelWithProvider> {
+    const model = await findModelByIdWithProvider(id);
+    if (!model) {
+        throw new Error('Model not found');
+    }
+    if (model.provider_enabled === 0) {
+        throw new Error(
+            tt('无法选择模型：服务商 "{provider}" 未启用', {
+                provider: model.provider_name,
+            })
+        );
+    }
+    return model;
+}
+
 /**
  * 创建模型。
  */
@@ -179,6 +309,62 @@ export const setDefaultModel = async ({ modelId }: { modelId: number }): Promise
     });
 };
 
+export const findModelRoleWithProvider = async (
+    role: ModelRole
+): Promise<ModelWithProvider | null> => {
+    if (role === 'entry') {
+        return findDefaultModelWithProvider();
+    }
+
+    const rawModelId = await getSettingValue({ key: MODEL_ROLE_SETTING_KEYS[role] });
+    const modelId = rawModelId ? Number(rawModelId) : NaN;
+    if (!Number.isFinite(modelId)) {
+        return null;
+    }
+
+    const model = await findModelByIdWithProvider(modelId);
+    if (!model || model.provider_enabled === 0) {
+        return null;
+    }
+
+    return model;
+};
+
+export const findEffectiveModelRoleWithProvider = async (
+    role: ModelRole
+): Promise<ModelWithProvider | null> => {
+    const roleModel = await findModelRoleWithProvider(role);
+    if (roleModel) {
+        return roleModel;
+    }
+    return findDefaultModelWithProvider();
+};
+
+export const setModelRole = async ({
+    role,
+    modelId,
+}: {
+    role: ModelRole;
+    modelId: number | null;
+}): Promise<void> => {
+    if (role === 'entry') {
+        if (modelId === null) {
+            throw new Error('Default model is required');
+        }
+        await setDefaultModel({ modelId });
+        return;
+    }
+
+    if (modelId !== null) {
+        await requireEnabledModelById(modelId);
+    }
+
+    await setSetting({
+        key: MODEL_ROLE_SETTING_KEYS[role],
+        value: modelId === null ? '' : String(modelId),
+    });
+};
+
 /**
  * 删除模型。
  */
diff --git a/apps/desktop/src/database/schema.ts b/apps/desktop/src/database/schema.ts
index be0a4250..c9eea817 100644
--- a/apps/desktop/src/database/schema.ts
+++ b/apps/desktop/src/database/schema.ts
@@ -279,6 +279,34 @@ export const models = sqliteTable('models', {
 /**
  * 会话轮次表
  */
+export const modelPreferences = sqliteTable(
+    'model_preferences',
+    {
+        id: integer('id').primaryKey({ autoIncrement: true }),
+        name: text('name').notNull(),
+        description: text('description').notNull(),
+        provider_id: integer('provider_id').references(() => providers.id, {
+            onDelete: 'set null',
+        }),
+        model_id: integer('model_id').references(() => models.id, {
+            onDelete: 'set null',
+        }),
+        priority: integer('priority').notNull().default(0),
+        created_at: text('created_at')
+            .notNull()
+            .default(sql`(datetime('now'))`),
+        updated_at: text('updated_at')
+            .notNull()
+            .default(sql`(datetime('now'))`),
+    },
+    (table) => [
+        index('model_preferences_priority_idx').on(table.priority),
+        uniqueIndex('model_preferences_name_unique').on(table.name),
+        index('model_preferences_model_id_idx').on(table.model_id),
+        index('model_preferences_provider_id_idx').on(table.provider_id),
+    ]
+);
+
 export const sessionTurns = sqliteTable(
     'session_turns',
     {
@@ -583,6 +611,10 @@ export type Model = typeof models.$inferSelect;
 export type NewModel = typeof models.$inferInsert;
 export type ModelUpdate = Partial<NewModel>;
 
+export type ModelPreference = typeof modelPreferences.$inferSelect;
+export type NewModelPreference = typeof modelPreferences.$inferInsert;
+export type ModelPreferenceUpdate = Partial<NewModelPreference>;
+
 export type SessionTurn = typeof sessionTurns.$inferSelect;
 export type NewSessionTurn = typeof sessionTurns.$inferInsert;
 export type SessionTurnUpdate = Partial<NewSessionTurn>;
diff --git a/apps/desktop/src/database/types/index.ts b/apps/desktop/src/database/types/index.ts
index 2018f501..5829b9ce 100644
--- a/apps/desktop/src/database/types/index.ts
+++ b/apps/desktop/src/database/types/index.ts
@@ -252,6 +252,37 @@ export interface ModelCreateData {
 
 export type ModelUpdateData = Partial<ModelCreateData>;
 
+export interface ModelPreferenceEntity {
+    id: number;
+    name: string;
+    description: string;
+    provider_id: number | null;
+    model_id: number | null;
+    priority: number;
+    created_at: string;
+    updated_at: string;
+}
+
+export interface ModelPreferenceCreateData {
+    name: string;
+    description: string;
+    provider_id?: number | null;
+    model_id?: number | null;
+    priority?: number;
+    created_at?: string;
+    updated_at?: string;
+}
+
+export type ModelPreferenceUpdateData = Partial<ModelPreferenceCreateData>;
+
+export interface ModelPreferenceWithModel extends ModelPreferenceEntity {
+    model_name: string | null;
+    model_api_id: string | null;
+    model_provider_id: number | null;
+    provider_name: string | null;
+    provider_enabled: number | null;
+}
+
 export interface ProviderModelLookupPayload extends ProviderIdPayload {
     modelId: string;
 }
diff --git a/apps/desktop/src/i18n/messages.ts b/apps/desktop/src/i18n/messages.ts
index 7d37e632..dda45158 100644
--- a/apps/desktop/src/i18n/messages.ts
+++ b/apps/desktop/src/i18n/messages.ts
@@ -8,6 +8,7 @@ const zhCNMessages = {
     'common.default': '默认',
     'common.all': '全部',
     'common.builtIn': '内置',
+    'common.recommended': '推荐',
     'common.selectPlaceholder': '请选择',
     'common.searchPlaceholder': '搜索',
     'common.emptyOptions': '暂无可选项',
@@ -119,6 +120,9 @@ const zhCNMessages = {
     'settings.general.interfaceLanguage': '界面语言',
     'settings.general.conversationExperience': '对话体验',
     'settings.general.conversationExperienceDescription': '调整长输出场景下的阅读位置',
+    'settings.general.allowModelAutoSwitch': '启用模型路由',
+    'settings.general.allowModelAutoSwitchDescription':
+        '开启后，默认模型可按任务切换到快速、通用或场景模型。',
     'settings.general.update.channelTitle': '版本更新',
     'settings.general.update.channelDescription': '选择您适合的版本更新频率',
     'settings.general.update.channelRowLabel': '版本更新通道',
@@ -150,6 +154,7 @@ const zhCNMessages = {
     'settings.general.update.dialog.action.installing': '正在安装',
     'settings.language.changed': '语言已切换为{language}',
     'settings.loading.general': '正在加载常规设置...',
+    'settings.loading.modelPreferences': '正在加载模型路由...',
     'settings.loading.aiServices': '正在加载大模型服务设置...',
     'settings.loading.builtInTools': '正在加载内置工具...',
     'settings.loading.search': '正在加载搜索设置...',
@@ -159,8 +164,10 @@ const zhCNMessages = {
     'settings.loading.about': '正在加载关于页面...',
     'settings.nav.general.label': '通用',
     'settings.nav.general.description': '快捷键、启动、对话和窗口偏好',
+    'settings.nav.modelPreferences.label': '模型路由',
+    'settings.nav.modelPreferences.description': '配置默认、快速、通用和场景模型路由',
     'settings.nav.aiServices.label': '服务商与模型',
-    'settings.nav.aiServices.description': 'Provider、模型、默认模型和密钥',
+    'settings.nav.aiServices.description': 'Provider、模型和密钥',
     'settings.nav.builtInTools.label': '内置工具',
     'settings.nav.builtInTools.description': '应用自带工具的启用、配置和日志',
     'settings.nav.search.label': '搜索',
@@ -362,6 +369,10 @@ const zhCNMessages = {
     'settings.ai.title': '大模型服务',
     'settings.ai.providerConfigTitle': '服务商配置',
     'settings.ai.resizeProviderList': '调整服务商列表宽度',
+    'settings.ai.mode.managed': '限免活动',
+    'settings.ai.mode.custom': '自定义',
+    'settings.ai.expandOthers': '点此展开其它服务商',
+    'settings.ai.collapseOthers': '收起其它服务商',
     'settings.ai.addCustomProvider': '+ 添加自定义服务商',
     'settings.ai.addProvider.title': '添加自定义服务商',
     'settings.ai.editProvider.title': '编辑服务商',
@@ -393,6 +404,10 @@ const zhCNMessages = {
     'settings.ai.cannotDeleteBuiltInProvider': '无法删除内置服务商',
     'settings.ai.cannotDeleteProviderWithDefaultModel':
         '无法删除包含默认模型的服务商，请先设置其他模型为默认',
+    'settings.ai.cannotDeleteProviderWithModelRouting':
+        '无法删除包含模型路由配置的服务商，请先在模型路由中移除相关模型',
+    'settings.ai.providerNeedsApiKeyForModels': '该服务商需要配置 API Key 才能获取模型列表',
+    'settings.ai.providerInvalidApiKeyForModels': 'API Key 无效，请检查该服务商的密钥后重试',
     'settings.ai.noModelsFetched': '未获取到模型列表',
     'settings.ai.refreshModelsSucceeded': '刷新成功，新增 {count} 个模型',
     'settings.ai.refreshModelsFailed': '获取模型列表失败：{error}',
@@ -409,6 +424,8 @@ const zhCNMessages = {
     'settings.ai.modelCapabilities': '模型能力',
     'settings.ai.enterModelNameAndId': '请填写模型名称和模型 ID',
     'settings.ai.cannotDeleteDefaultModel': '无法删除默认模型，请先设置其他模型为默认',
+    'settings.ai.cannotDeleteModelWithModelRouting':
+        '无法删除已用于模型路由的模型，请先在模型路由中移除相关配置',
     'settings.ai.confirmDeleteTitle': '确认删除',
     'settings.ai.confirmDeleteModel': '确定要删除模型 "{modelName}" 吗？',
     'settings.ai.enableProviderFirst': '请先启用本服务商',
@@ -428,6 +445,49 @@ const zhCNMessages = {
     'settings.ai.fetchingModels': '获取中...',
     'settings.ai.fetchModels': '获取模型列表',
     'settings.ai.addManually': '手动添加',
+    'settings.general.modelPreferences.title': '模型路由',
+    'settings.general.modelPreferences.description':
+        '配置默认、快速和通用模型。默认模型会根据任务调用模型切换工具。',
+    'settings.general.modelPreferences.enableRouting': '启用模型路由',
+    'settings.general.modelPreferences.rolesTitle': '基础',
+    'settings.general.modelPreferences.noModelsTitle': '暂无模型',
+    'settings.general.modelPreferences.noModelsDescription':
+        '请先前往服务商与模型配置服务商并添加模型，然后再设置模型路由。',
+    'settings.general.modelPreferences.scenarioPreferencesTitle': '场景偏好',
+    'settings.general.modelPreferences.scenarioPreferencesDescription':
+        '配置指定场景使用的模型，默认模型会在任务匹配时切换。',
+    'settings.general.modelPreferences.entryModel': '默认模型',
+    'settings.general.modelPreferences.entryModelDescription': '默认接收请求并按任务切换模型。',
+    'settings.general.modelPreferences.fastModel': '快速模型',
+    'settings.general.modelPreferences.fastModelDescription': '用于会话命名和简单问答。',
+    'settings.general.modelPreferences.generalModel': '通用模型',
+    'settings.general.modelPreferences.generalModelDescription': '用于未命中特定场景的任务。',
+    'settings.general.modelPreferences.selectEntryModel': '选择默认模型',
+    'settings.general.modelPreferences.useEntryModel': '不设置',
+    'settings.general.modelPreferences.entryModelRequired': '请选择默认模型',
+    'settings.general.modelPreferences.cannotDeleteEntryModel':
+        '无法删除默认模型，请先选择其他默认模型',
+    'settings.general.modelPreferences.groupContainsEntryModel': '该分组包含默认模型，无法批量删除',
+    'settings.general.modelPreferences.cannotDisableProviderWithEntryModel':
+        '无法禁用包含默认模型的服务商，请先选择其他默认模型',
+    'settings.general.modelPreferences.cannotDeleteProviderWithEntryModel':
+        '无法删除包含默认模型的服务商，请先选择其他默认模型',
+    'settings.general.modelPreferences.add': '添加偏好',
+    'settings.general.modelPreferences.addPreferenceTitle': '添加场景偏好',
+    'settings.general.modelPreferences.editPreferenceTitle': '编辑场景偏好',
+    'settings.general.modelPreferences.scenario': '场景',
+    'settings.general.modelPreferences.scenarioPlaceholder': '例如：前端开发',
+    'settings.general.modelPreferences.model': '模型',
+    'settings.general.modelPreferences.selectModel': '选择模型',
+    'settings.general.modelPreferences.descriptionPlaceholder':
+        '描述适用任务，例如：React、Vue、CSS、Tailwind、组件开发',
+    'settings.general.modelPreferences.empty': '暂无场景模型偏好',
+    'settings.general.modelPreferences.unavailableModel': '目标模型不可用',
+    'settings.general.modelPreferences.nameRequired': '请填写场景名称',
+    'settings.general.modelPreferences.descriptionRequired': '请填写场景描述',
+    'settings.general.modelPreferences.modelRequired': '请选择模型',
+    'settings.general.modelPreferences.loadFailed': '加载模型路由失败',
+    'settings.general.modelPreferences.saveFailed': '保存模型路由失败',
     'settings.dataManagement.title': '数据管理',
     'settings.dataManagement.description': '管理应用数据和设置备份',
     'settings.dataManagement.stats': '数据统计',
@@ -751,6 +811,20 @@ const zhCNMessages = {
     'conversation.approval.userRejectedCommand': '用户已拒绝执行此命令',
     'conversation.approval.commandCancelled': '本次命令已取消',
     'conversation.approval.commandNotExecuted': '本次命令未被执行',
+    'builtInTools.upgradeModel.alreadyTargetModel': '模型已是目标模型',
+    'builtInTools.upgradeModel.scenarioNotFound': '未找到模型场景偏好：{scenario}',
+    'builtInTools.upgradeModel.scenarioModelMissing': '模型场景偏好未配置模型：{scenario}',
+    'builtInTools.upgradeModel.scenarioModelUnavailable': '模型场景偏好目标不可用：{scenario}',
+    'builtInTools.upgradeModel.defaultModelUnavailable': '默认模型不可用',
+    'builtInTools.upgradeModel.roleUnavailable': '模型角色不可用：{role}',
+    'builtInTools.upgradeModel.conflictingSelectors': '一次只能指定一个模型切换目标',
+    'builtInTools.upgradeModel.modelRoutingDisabled': '模型路由未启用，继续使用默认模型',
+    'builtInTools.upgradeModel.restoredEntry': '已恢复默认模型',
+    'builtInTools.upgradeModel.switchedRole': '已切换模型角色：{role}',
+    'builtInTools.upgradeModel.switchedScenario': '已切换场景模型：{scenario}',
+    'builtInTools.upgradeModel.currentModel': '当前模型',
+    'builtInTools.upgradeModel.targetModel': '目标模型',
+    'builtInTools.upgradeModel.continueWithSelected': '系统将使用所选模型继续当前对话。',
     'conversation.approval.bashApprovalRequired': '当前配置要求所有 Bash 命令都必须先批准。',
     'conversation.approval.mayDeleteFiles': '命令可能删除文件或目录。',
     'conversation.approval.mayResetGitWorktree': '命令可能重置或清理 Git 工作区。',
@@ -908,6 +982,7 @@ const enUSMessages: Record<keyof typeof zhCNMessages, string> = {
     'common.default': 'Default',
     'common.all': 'All',
     'common.builtIn': 'Built-in',
+    'common.recommended': 'Recommended',
     'common.selectPlaceholder': 'Select',
     'common.searchPlaceholder': 'Search',
     'common.emptyOptions': 'No options',
@@ -1030,6 +1105,9 @@ const enUSMessages: Record<keyof typeof zhCNMessages, string> = {
     'settings.general.conversationExperience': 'Conversation experience',
     'settings.general.conversationExperienceDescription':
         'Adjust the reading position for long streaming output',
+    'settings.general.allowModelAutoSwitch': 'Enable model routing',
+    'settings.general.allowModelAutoSwitchDescription':
+        'When enabled, the default model can route tasks to fast, general, or scenario models.',
     'settings.general.update.channelTitle': 'Version updates',
     'settings.general.update.channelDescription': 'Choose the update frequency that fits you',
     'settings.general.update.channelRowLabel': 'Version update channel',
@@ -1065,6 +1143,7 @@ const enUSMessages: Record<keyof typeof zhCNMessages, string> = {
     'settings.general.update.dialog.action.installing': 'Installing',
     'settings.language.changed': 'Language changed to {language}',
     'settings.loading.general': 'Loading general settings...',
+    'settings.loading.modelPreferences': 'Loading model routing...',
     'settings.loading.aiServices': 'Loading model service settings...',
     'settings.loading.builtInTools': 'Loading built-in tools...',
     'settings.loading.search': 'Loading search settings...',
@@ -1074,8 +1153,11 @@ const enUSMessages: Record<keyof typeof zhCNMessages, string> = {
     'settings.loading.about': 'Loading about page...',
     'settings.nav.general.label': 'General',
     'settings.nav.general.description': 'Shortcuts, startup, conversation, and window preferences',
+    'settings.nav.modelPreferences.label': 'Model routing',
+    'settings.nav.modelPreferences.description':
+        'Configure default, fast, general, and scenario model routing',
     'settings.nav.aiServices.label': 'Providers and models',
-    'settings.nav.aiServices.description': 'Providers, models, default model, and keys',
+    'settings.nav.aiServices.description': 'Providers, models, and keys',
     'settings.nav.builtInTools.label': 'Built-in tools',
     'settings.nav.builtInTools.description': 'Built-in tools, configuration, and logs',
     'settings.nav.search.label': 'Search',
@@ -1306,6 +1388,10 @@ const enUSMessages: Record<keyof typeof zhCNMessages, string> = {
     'settings.ai.title': 'Model services',
     'settings.ai.providerConfigTitle': 'Provider configuration',
     'settings.ai.resizeProviderList': 'Resize provider list',
+    'settings.ai.mode.managed': 'Managed activity',
+    'settings.ai.mode.custom': 'Custom',
+    'settings.ai.expandOthers': 'Show other providers',
+    'settings.ai.collapseOthers': 'Hide other providers',
     'settings.ai.addCustomProvider': '+ Add custom provider',
     'settings.ai.addProvider.title': 'Add custom provider',
     'settings.ai.editProvider.title': 'Edit provider',
@@ -1337,6 +1423,12 @@ const enUSMessages: Record<keyof typeof zhCNMessages, string> = {
     'settings.ai.cannotDeleteBuiltInProvider': 'Cannot delete a built-in provider',
     'settings.ai.cannotDeleteProviderWithDefaultModel':
         'Cannot delete a provider that contains the default model. Set another model as default first.',
+    'settings.ai.cannotDeleteProviderWithModelRouting':
+        'Cannot delete a provider used by model routing. Remove the related model routing settings first.',
+    'settings.ai.providerNeedsApiKeyForModels':
+        'This provider requires an API Key before models can be fetched',
+    'settings.ai.providerInvalidApiKeyForModels':
+        "Invalid API key. Check this provider's key and try again.",
     'settings.ai.noModelsFetched': 'No models were fetched',
     'settings.ai.refreshModelsSucceeded': 'Refresh complete, added {count} models',
     'settings.ai.refreshModelsFailed': 'Failed to fetch model list: {error}',
@@ -1355,6 +1447,8 @@ const enUSMessages: Record<keyof typeof zhCNMessages, string> = {
     'settings.ai.enterModelNameAndId': 'Enter model name and model ID',
     'settings.ai.cannotDeleteDefaultModel':
         'Cannot delete the default model. Set another model as default first.',
+    'settings.ai.cannotDeleteModelWithModelRouting':
+        'Cannot delete a model used by model routing. Remove the related model routing settings first.',
     'settings.ai.confirmDeleteTitle': 'Confirm deletion',
     'settings.ai.confirmDeleteModel': 'Delete model "{modelName}"?',
     'settings.ai.enableProviderFirst': 'Enable this provider first',
@@ -1377,6 +1471,52 @@ const enUSMessages: Record<keyof typeof zhCNMessages, string> = {
     'settings.ai.fetchingModels': 'Fetching...',
     'settings.ai.fetchModels': 'Fetch model list',
     'settings.ai.addManually': 'Add manually',
+    'settings.general.modelPreferences.title': 'Model routing',
+    'settings.general.modelPreferences.description':
+        'Configure default, fast, and general models. The default model can call the model switch tool based on the task.',
+    'settings.general.modelPreferences.enableRouting': 'Enable model routing',
+    'settings.general.modelPreferences.rolesTitle': 'Basics',
+    'settings.general.modelPreferences.noModelsTitle': 'No models yet',
+    'settings.general.modelPreferences.noModelsDescription':
+        'Configure a provider and add models in Providers and models before setting up model routing.',
+    'settings.general.modelPreferences.scenarioPreferencesTitle': 'Scenario preferences',
+    'settings.general.modelPreferences.scenarioPreferencesDescription':
+        'Configure models for specific scenarios. The default model switches when a task matches.',
+    'settings.general.modelPreferences.entryModel': 'Default model',
+    'settings.general.modelPreferences.entryModelDescription':
+        'Receives requests by default and switches models by task.',
+    'settings.general.modelPreferences.fastModel': 'Fast model',
+    'settings.general.modelPreferences.fastModelDescription': 'For session naming and simple Q&A.',
+    'settings.general.modelPreferences.generalModel': 'General model',
+    'settings.general.modelPreferences.generalModelDescription':
+        'For tasks without a scenario match.',
+    'settings.general.modelPreferences.selectEntryModel': 'Select default model',
+    'settings.general.modelPreferences.useEntryModel': 'Not set',
+    'settings.general.modelPreferences.entryModelRequired': 'Select a default model',
+    'settings.general.modelPreferences.cannotDeleteEntryModel':
+        'Cannot delete the default model. Select another default model first.',
+    'settings.general.modelPreferences.groupContainsEntryModel':
+        'This group contains the default model and cannot be deleted in bulk.',
+    'settings.general.modelPreferences.cannotDisableProviderWithEntryModel':
+        'Cannot disable a provider that contains the default model. Select another default model first.',
+    'settings.general.modelPreferences.cannotDeleteProviderWithEntryModel':
+        'Cannot delete a provider that contains the default model. Select another default model first.',
+    'settings.general.modelPreferences.add': 'Add preference',
+    'settings.general.modelPreferences.addPreferenceTitle': 'Add scenario preference',
+    'settings.general.modelPreferences.editPreferenceTitle': 'Edit scenario preference',
+    'settings.general.modelPreferences.scenario': 'Scenario',
+    'settings.general.modelPreferences.scenarioPlaceholder': 'Example: Frontend development',
+    'settings.general.modelPreferences.model': 'Model',
+    'settings.general.modelPreferences.selectModel': 'Select model',
+    'settings.general.modelPreferences.descriptionPlaceholder':
+        'Describe matching tasks, such as React, Vue, CSS, Tailwind, component work',
+    'settings.general.modelPreferences.empty': 'No model preferences yet',
+    'settings.general.modelPreferences.unavailableModel': 'Target model unavailable',
+    'settings.general.modelPreferences.nameRequired': 'Enter a scenario name',
+    'settings.general.modelPreferences.descriptionRequired': 'Enter a scenario description',
+    'settings.general.modelPreferences.modelRequired': 'Select a model',
+    'settings.general.modelPreferences.loadFailed': 'Failed to load model routing',
+    'settings.general.modelPreferences.saveFailed': 'Failed to save model routing',
     'settings.dataManagement.title': 'Data management',
     'settings.dataManagement.description': 'Manage application data and settings backups',
     'settings.dataManagement.stats': 'Data statistics',
@@ -1718,6 +1858,25 @@ const enUSMessages: Record<keyof typeof zhCNMessages, string> = {
     'conversation.approval.userRejectedCommand': 'The user rejected this command',
     'conversation.approval.commandCancelled': 'This command was cancelled',
     'conversation.approval.commandNotExecuted': 'This command was not executed',
+    'builtInTools.upgradeModel.alreadyTargetModel': 'Model is already the target model',
+    'builtInTools.upgradeModel.scenarioNotFound': 'Model scenario preference not found: {scenario}',
+    'builtInTools.upgradeModel.scenarioModelMissing':
+        'Model scenario preference has no model configured: {scenario}',
+    'builtInTools.upgradeModel.scenarioModelUnavailable':
+        'Model scenario preference target is unavailable: {scenario}',
+    'builtInTools.upgradeModel.defaultModelUnavailable': 'Default model is unavailable',
+    'builtInTools.upgradeModel.roleUnavailable': 'Model role is unavailable: {role}',
+    'builtInTools.upgradeModel.conflictingSelectors':
+        'Specify only one model switch target at a time',
+    'builtInTools.upgradeModel.modelRoutingDisabled':
+        'Model routing is disabled. Continuing with the default model.',
+    'builtInTools.upgradeModel.restoredEntry': 'Restored default model',
+    'builtInTools.upgradeModel.switchedRole': 'Switched model role: {role}',
+    'builtInTools.upgradeModel.switchedScenario': 'Switched model for scenario: {scenario}',
+    'builtInTools.upgradeModel.currentModel': 'Current model',
+    'builtInTools.upgradeModel.targetModel': 'Target model',
+    'builtInTools.upgradeModel.continueWithSelected':
+        'The system will continue the conversation with the selected model.',
     'conversation.approval.bashApprovalRequired':
         'Current configuration requires approval before every Bash command.',
     'conversation.approval.mayDeleteFiles': 'The command may delete files or directories.',
diff --git a/apps/desktop/src/services/AgentService/prompt/composer.ts b/apps/desktop/src/services/AgentService/prompt/composer.ts
index a1f90014..8bf67bae 100644
--- a/apps/desktop/src/services/AgentService/prompt/composer.ts
+++ b/apps/desktop/src/services/AgentService/prompt/composer.ts
@@ -12,6 +12,7 @@ import {
 } from '../languageContext';
 import type { TaskExecutionMode } from '../task/types';
 import { TOUCHAI_BUILTIN_SYSTEM_PROMPT } from './builtin';
+import { buildModelPreferencesPrompt } from './modelPreferences';
 import type { PromptAssembly, PromptFragment, PromptFragmentSource, PromptSnapshot } from './types';
 
 const TOOL_DISCIPLINE_SYSTEM_PROMPT = [
@@ -91,6 +92,7 @@ async function buildPromptAssembly(options: ComposePromptSnapshotOptions): Promi
         ...(options.platform ?? [TOUCHAI_BUILTIN_SYSTEM_PROMPT]),
         buildCurrentLanguageSystemPrompt(modelLanguageContext),
     ];
+    const modelPreferenceFragments = await buildModelPreferencesPrompt();
     const fragmentsBySource: Record<PromptFragmentSource, PromptFragment[]> = {
         override: buildFragments('override', options.override ?? []),
         platform: buildFragments('platform', platformFragments),
@@ -101,7 +103,10 @@ async function buildPromptAssembly(options: ComposePromptSnapshotOptions): Promi
             'mode',
             options.mode ?? (executionMode === 'background' ? [BACKGROUND_MODE_PROMPT] : [])
         ),
-        feature: buildFragments('feature', options.feature ?? []),
+        feature: buildFragments('feature', [
+            ...modelPreferenceFragments,
+            ...(options.feature ?? []),
+        ]),
         user_append: buildFragments('user_append', options.userAppend ?? []),
     };
 
diff --git a/apps/desktop/src/services/AgentService/prompt/modelPreferences.ts b/apps/desktop/src/services/AgentService/prompt/modelPreferences.ts
new file mode 100644
index 00000000..92a26685
--- /dev/null
+++ b/apps/desktop/src/services/AgentService/prompt/modelPreferences.ts
@@ -0,0 +1,117 @@
+// Copyright (c) 2026. Qian Cheng. Licensed under GPL v3
+
+import {
+    findModelRoleWithProvider,
+    getSettingValue,
+    listModelPreferences,
+} from '@database/queries';
+import type { ModelRole, ModelWithProvider } from '@database/queries/models';
+import type { ModelPreferenceWithModel } from '@database/types';
+
+function escapeMarkdownCell(value: string): string {
+    return value.replace(/\\/g, '\\\\').replace(/\|/g, '\\|').replace(/\r?\n/g, ' ').trim();
+}
+
+function formatModelLabel(preference: ModelPreferenceWithModel): string {
+    const providerName = preference.provider_name?.trim();
+    const modelName = preference.model_name?.trim();
+    return [providerName, modelName].filter(Boolean).join(' / ') || 'Unavailable';
+}
+
+function formatRoleModelLabel(model: ModelWithProvider | null): string {
+    if (!model) {
+        return 'Not configured';
+    }
+    return [model.provider_name, model.name].filter(Boolean).join(' / ');
+}
+
+function isUsablePreference(preference: ModelPreferenceWithModel): boolean {
+    return Boolean(
+        preference.name.trim() &&
+        preference.description.trim() &&
+        preference.model_id !== null &&
+        preference.provider_enabled === 1
+    );
+}
+
+function formatPreferenceRow(preference: ModelPreferenceWithModel): string {
+    return `| ${escapeMarkdownCell(preference.name)} | ${escapeMarkdownCell(preference.description)} | ${escapeMarkdownCell(formatModelLabel(preference))} |`;
+}
+
+async function isModelRoutingEnabled(): Promise<boolean> {
+    try {
+        return (await getSettingValue({ key: 'allow_model_auto_switch' })) === 'true';
+    } catch (error) {
+        console.warn('[ModelPreferencesPrompt] Failed to load model routing setting:', error);
+        return false;
+    }
+}
+
+export async function buildModelPreferencesPrompt(): Promise<string[]> {
+    if (!(await isModelRoutingEnabled())) {
+        return [];
+    }
+
+    const [preferences, defaultModel, fastModel, generalModel] = await Promise.all([
+        listModelPreferences(),
+        findModelRoleWithProvider('entry'),
+        findModelRoleWithProvider('fast'),
+        findModelRoleWithProvider('general'),
+    ]).catch((error) => {
+        console.warn('[ModelPreferencesPrompt] Failed to load model routing preferences:', error);
+        return [[], null, null, null] as const;
+    });
+    const usablePreferences = preferences.filter(isUsablePreference);
+
+    const roleRows: Array<[ModelRole, string, string, string]> = [
+        [
+            'entry',
+            'Default model',
+            'Every user request starts here by default. It decides whether to answer directly or switch models.',
+            formatRoleModelLabel(defaultModel),
+        ],
+        [
+            'fast',
+            'Fast model',
+            'Simple questions and lightweight utility work such as brief answers or session naming. Falls back to the default model when not configured.',
+            formatRoleModelLabel(fastModel ?? defaultModel),
+        ],
+        [
+            'general',
+            'General model',
+            'Complex tasks that do not clearly match a custom scenario preference. Falls back to the default model when not configured.',
+            formatRoleModelLabel(generalModel ?? defaultModel),
+        ],
+    ];
+
+    return [
+        [
+            '## Model routing preferences',
+            '',
+            'The current model is the default model. Every user request starts here by default, and you act as the router by calling `builtin__upgrade_model` when another configured model is a better fit.',
+            '',
+            '| Role | When to use | Model |',
+            '|------|-------------|-------|',
+            ...roleRows.map(
+                ([role, label, description, model]) =>
+                    `| ${escapeMarkdownCell(label)} (${role}) | ${escapeMarkdownCell(description)} | ${escapeMarkdownCell(model)} |`
+            ),
+            '',
+            'Use `builtin__upgrade_model` with `{ "role": "fast" }` for simple questions or lightweight utility tasks.',
+            'Use `builtin__upgrade_model` with `{ "role": "general" }` for complex tasks when no custom scenario below clearly matches.',
+            'Use `builtin__upgrade_model` with `{ "restore": true }` or `{ "role": "entry" }` to return to the default model.',
+            '',
+            'You can switch to a specialized model when the task clearly matches one of these user-configured scenarios.',
+            'Call `builtin__upgrade_model` with `{ "scenario": "<Scenario>" }` to switch to that scenario model.',
+            '',
+            '| Scenario | Description | Model |',
+            '|----------|-------------|-------|',
+            ...(usablePreferences.length > 0
+                ? usablePreferences.map(formatPreferenceRow)
+                : ['| None configured | No custom scenario preferences are available. | - |']),
+            '',
+            'Routing rules: use a custom scenario model when the task clearly matches that scenario. Otherwise use the fast model for simple work, the general model for complex work, and the default model for routing or unclear/general setup.',
+            'Do not switch models repeatedly for the same task unless the conversation meaningfully changes.',
+        ].join('\n'),
+    ];
+}
diff --git a/apps/desktop/src/services/BuiltInToolService/tools/upgradeModel/constants.ts b/apps/desktop/src/services/BuiltInToolService/tools/upgradeModel/constants.ts
index e1750725..9772272c 100644
--- a/apps/desktop/src/services/BuiltInToolService/tools/upgradeModel/constants.ts
+++ b/apps/desktop/src/services/BuiltInToolService/tools/upgradeModel/constants.ts
@@ -5,20 +5,44 @@ import type { AiToolDefinition } from '@/services/AgentService/contracts/tooling
 import { z } from '../../utils/toolSchema';
 
 export const UPGRADE_MODEL_TOOL_NAME = 'UpgradeModel';
-export const upgradeModelArgsSchema = z.object({}).strict();
+export const upgradeModelArgsSchema = z
+    .object({
+        role: z.enum(['entry', 'fast', 'general']).optional(),
+        scenario: z.string().trim().min(1).nullable().optional(),
+        restore: z.boolean().optional(),
+    })
+    .strict();
 
 /**
  * 暴露给模型的 UpgradeModel 工具说明。
  */
 export const UPGRADE_MODEL_TOOL_DESCRIPTION =
-    'Call immediately when the user asks to upgrade the current model, switch to a stronger model, or move to the next higher-level model. No arguments are required.';
+    'Call immediately when the current request should be handled by a different configured model role or scenario. Pass { "role": "fast" } for simple tasks, { "role": "general" } for complex tasks without a matching scenario, { "scenario": "<Scenario>" } for a configured preference, or { "restore": true } / { "role": "entry" } to switch back to the default model.';
 
 /**
  * 暴露给模型的 UpgradeModel 工具输入 schema。
  */
 export const UPGRADE_MODEL_TOOL_INPUT_SCHEMA: AiToolDefinition['input_schema'] = {
     type: 'object',
-    properties: {},
+    properties: {
+        role: {
+            type: 'string',
+            enum: ['entry', 'fast', 'general'],
+            description:
+                'Optional configured model role. Use "fast" for simple tasks, "general" for complex tasks without a matching scenario, or "entry" to return to the default model.',
+        },
+        scenario: {
+            type: ['string', 'null'],
+            minLength: 1,
+            pattern: '\\S',
+            description:
+                'Optional scenario name from the configured model preferences. Use null to restore the default model.',
+        },
+        restore: {
+            type: 'boolean',
+            description: 'Set true to switch back to the default model.',
+        },
+    },
     required: [],
     additionalProperties: false,
 };
diff --git a/apps/desktop/src/services/BuiltInToolService/tools/upgradeModel/helper.ts b/apps/desktop/src/services/BuiltInToolService/tools/upgradeModel/helper.ts
index 0a508167..48bd7c40 100644
--- a/apps/desktop/src/services/BuiltInToolService/tools/upgradeModel/helper.ts
+++ b/apps/desktop/src/services/BuiltInToolService/tools/upgradeModel/helper.ts
@@ -8,6 +8,12 @@ import { parseToolArguments } from '../../utils/toolSchema';
 import { formatUpgradeModelChain, type UpgradeModelChainEntry } from './chain';
 import { UPGRADE_MODEL_TOOL_NAME, upgradeModelArgsSchema } from './constants';
 
+export type UpgradeModelArgs = {
+    role?: 'entry' | 'fast' | 'general';
+    scenario?: string | null;
+    restore?: boolean;
+};
+
 function formatModelLabel(model: {
     name: string;
     model_id: string;
@@ -40,6 +46,6 @@ export function parseUpgradeTargetLabel(result?: string): string | null {
     return matched?.[1]?.trim() || null;
 }
 
-export function parseUpgradeModelArgs(args: Record<string, unknown>): void {
-    parseToolArguments(UPGRADE_MODEL_TOOL_NAME, upgradeModelArgsSchema, args);
+export function parseUpgradeModelArgs(args: Record<string, unknown>): UpgradeModelArgs {
+    return parseToolArguments(UPGRADE_MODEL_TOOL_NAME, upgradeModelArgsSchema, args);
 }
diff --git a/apps/desktop/src/services/BuiltInToolService/tools/upgradeModel/index.ts b/apps/desktop/src/services/BuiltInToolService/tools/upgradeModel/index.ts
index 0b1f9ed8..5b3ac6ae 100644
--- a/apps/desktop/src/services/BuiltInToolService/tools/upgradeModel/index.ts
+++ b/apps/desktop/src/services/BuiltInToolService/tools/upgradeModel/index.ts
@@ -1,9 +1,16 @@
 // Copyright (c) 2026. 千诚. Licensed under GPL v3
 
-import { findModelByProviderAndModelId } from '@database/queries';
-import type { ModelWithProvider } from '@database/queries/models';
+import {
+    findDefaultModelWithProvider,
+    findEffectiveModelRoleWithProvider,
+    findModelByIdWithProvider,
+    findModelByProviderAndModelId,
+    findModelPreferenceByName,
+    getSettingValue,
+} from '@database/queries';
+import type { ModelRole, ModelWithProvider } from '@database/queries/models';
 
-import { tt } from '@/i18n';
+import { t, tt } from '@/i18n';
 import type { ToolApprovalRequest } from '@/services/AgentService/contracts/tooling';
 
 import {
@@ -31,6 +38,32 @@ interface ResolvedUpgradeTarget {
     model: ModelWithProvider;
 }
 
+interface ResolvedModelSwitchTarget {
+    chainEntries: UpgradeModelChainEntry[];
+    target: ResolvedUpgradeTarget;
+    source: 'chain' | 'scenario' | 'restore' | 'role';
+    role?: ModelRole;
+    scenarioName?: string;
+}
+
+function isSameModel(
+    left: ModelWithProvider | undefined,
+    right: ModelWithProvider | undefined
+): boolean {
+    return Boolean(
+        left && right && left.provider_id === right.provider_id && left.model_id === right.model_id
+    );
+}
+
+async function isModelRoutingEnabled(): Promise<boolean> {
+    try {
+        return (await getSettingValue({ key: 'allow_model_auto_switch' })) === 'true';
+    } catch (error) {
+        console.warn('[UpgradeModel] Failed to read model routing setting:', error);
+        return false;
+    }
+}
+
 async function resolveChainTargets(
     chainEntries: UpgradeModelChainEntry[]
 ): Promise<ResolvedUpgradeTarget[]> {
@@ -123,6 +156,114 @@ async function resolveUpgradeTarget(
     };
 }
 
+async function resolveScenarioTarget(scenarioName: string): Promise<ResolvedModelSwitchTarget> {
+    const preference = await findModelPreferenceByName(scenarioName);
+    if (!preference) {
+        throw new Error(
+            t('builtInTools.upgradeModel.scenarioNotFound', { scenario: scenarioName })
+        );
+    }
+    if (preference.model_id === null) {
+        throw new Error(
+            t('builtInTools.upgradeModel.scenarioModelMissing', { scenario: scenarioName })
+        );
+    }
+
+    const model = await findModelByIdWithProvider(preference.model_id);
+    if (!model || model.provider_enabled === 0) {
+        throw new Error(
+            t('builtInTools.upgradeModel.scenarioModelUnavailable', { scenario: scenarioName })
+        );
+    }
+
+    return {
+        chainEntries: [],
+        target: {
+            chainEntry: {
+                providerId: model.provider_id,
+                modelId: model.model_id,
+            },
+            model,
+        },
+        source: 'scenario',
+        scenarioName: preference.name,
+    };
+}
+
+async function resolveRestoreTarget(): Promise<ResolvedModelSwitchTarget> {
+    const model = await findDefaultModelWithProvider();
+    if (!model) {
+        throw new Error(t('builtInTools.upgradeModel.defaultModelUnavailable'));
+    }
+
+    return {
+        chainEntries: [],
+        target: {
+            chainEntry: {
+                providerId: model.provider_id,
+                modelId: model.model_id,
+            },
+            model,
+        },
+        source: 'restore',
+    };
+}
+
+async function resolveRoleTarget(role: ModelRole): Promise<ResolvedModelSwitchTarget> {
+    const model = await findEffectiveModelRoleWithProvider(role);
+    if (!model) {
+        throw new Error(t('builtInTools.upgradeModel.roleUnavailable', { role }));
+    }
+
+    return {
+        chainEntries: [],
+        target: {
+            chainEntry: {
+                providerId: model.provider_id,
+                modelId: model.model_id,
+            },
+            model,
+        },
+        source: 'role',
+        role,
+    };
+}
+
+async function resolveModelSwitchTarget(
+    args: Record<string, unknown>,
+    currentModel: ModelWithProvider | undefined,
+    config: UpgradeModelToolConfig
+): Promise<ResolvedModelSwitchTarget> {
+    const parsedArgs = parseUpgradeModelArgs(args);
+    const targetSelectorCount = [
+        parsedArgs.restore === true,
+        parsedArgs.role !== undefined,
+        parsedArgs.scenario !== undefined,
+    ].filter(Boolean).length;
+
+    if (targetSelectorCount > 1) {
+        throw new Error(t('builtInTools.upgradeModel.conflictingSelectors'));
+    }
+
+    if (parsedArgs.restore === true || parsedArgs.scenario === null) {
+        return resolveRestoreTarget();
+    }
+
+    if (parsedArgs.role) {
+        return resolveRoleTarget(parsedArgs.role);
+    }
+
+    if (typeof parsedArgs.scenario === 'string' && parsedArgs.scenario.trim()) {
+        return resolveScenarioTarget(parsedArgs.scenario);
+    }
+
+    const chainTarget = await resolveUpgradeTarget(currentModel, config);
+    return {
+        ...chainTarget,
+        source: 'chain',
+    };
+}
+
 function buildUpgradeConversationSemantic(targetLabel: string): BuiltInToolConversationSemantic {
     return {
         action: 'switch',
@@ -130,6 +271,39 @@ function buildUpgradeConversationSemantic(targetLabel: string): BuiltInToolConve
     };
 }
 
+function buildSwitchSummary(options: {
+    currentModel?: ModelWithProvider;
+    targetModel: ModelWithProvider;
+    source: ResolvedModelSwitchTarget['source'];
+    role?: ModelRole;
+    scenarioName?: string;
+    chainEntries: UpgradeModelChainEntry[];
+}): string {
+    if (options.source === 'chain') {
+        return buildUpgradeSummary({
+            currentModel: options.currentModel,
+            targetModel: options.targetModel,
+            chainEntries: options.chainEntries,
+        });
+    }
+
+    const action =
+        options.source === 'restore'
+            ? t('builtInTools.upgradeModel.restoredEntry')
+            : options.source === 'role'
+              ? t('builtInTools.upgradeModel.switchedRole', { role: options.role ?? '' })
+              : t('builtInTools.upgradeModel.switchedScenario', {
+                    scenario: options.scenarioName ?? '',
+                });
+
+    return [
+        action,
+        `${t('builtInTools.upgradeModel.currentModel')}: ${formatCurrentModelLabel(options.currentModel)}`,
+        `${t('builtInTools.upgradeModel.targetModel')}: ${formatCurrentModelLabel(options.targetModel)}`,
+        t('builtInTools.upgradeModel.continueWithSelected'),
+    ].join('\n');
+}
+
 /**
  * 构建模型切换审批卡片。
  * @param args 工具参数。
@@ -144,33 +318,11 @@ export async function buildUpgradeModelApprovalRequest(
     namespacedName: string,
     context: BaseBuiltInToolExecutionContext
 ): Promise<ToolApprovalRequest | null> {
+    void args;
+    void config;
     void namespacedName;
-
-    try {
-        parseUpgradeModelArgs(args);
-        const { target } = await resolveUpgradeTarget(context.currentModel, config);
-
-        // 审批阶段只负责把即将发生的模型切换说清楚。
-        // 真正的切换由 execute 返回 controlSignal 后再由上层统一落地，避免审批阶段产生副作用。
-        return {
-            title: tt('模型切换确认'),
-            description: tt('允许从 {currentModel} 切换到 {targetModel}', {
-                currentModel: formatCurrentModelLabel(context.currentModel),
-                targetModel: formatCurrentModelLabel(target.model),
-            }),
-            command: `${formatCurrentModelLabel(context.currentModel)} -> ${formatCurrentModelLabel(target.model)}`,
-            riskLabel: '',
-            reason: tt('这会修改当前问答后续使用的模型，并同步影响后续默认模型。'),
-            commandLabel: '',
-            approveLabel: tt('批准'),
-            rejectLabel: tt('拒绝'),
-            enterHint: 'Enter',
-            escHint: 'Esc',
-            keyboardApproveDelayMs: 450,
-        };
-    } catch {
-        return null;
-    }
+    void context;
+    return null;
 }
 
 /**
@@ -189,14 +341,42 @@ export async function executeUpgradeModelTool(
     void context.signal;
 
     try {
-        const { chainEntries, target } = await resolveUpgradeTarget(context.currentModel, config);
+        if (!(await isModelRoutingEnabled())) {
+            const errorMessage = t('builtInTools.upgradeModel.modelRoutingDisabled');
+            return {
+                result: errorMessage,
+                isError: true,
+                status: 'error',
+                errorMessage,
+            };
+        }
+
+        const { chainEntries, target, source, role, scenarioName } = await resolveModelSwitchTarget(
+            args,
+            context.currentModel,
+            config
+        );
 
         // 工具本身不直接修改前端状态，而是返回统一的控制信号。
         // 这样模型切换、日志记录和请求重启都能继续走网关已有的单一路径。
+        if (isSameModel(context.currentModel, target.model)) {
+            return {
+                result: [
+                    t('builtInTools.upgradeModel.alreadyTargetModel'),
+                    `${tt('当前模型')}: ${formatCurrentModelLabel(context.currentModel)}`,
+                ].join('\n'),
+                isError: false,
+                status: 'success',
+            };
+        }
+
         return {
-            result: buildUpgradeSummary({
+            result: buildSwitchSummary({
                 currentModel: context.currentModel,
                 targetModel: target.model,
+                source,
+                role,
+                scenarioName,
                 chainEntries,
             }),
             isError: false,
@@ -248,7 +428,7 @@ class UpgradeModelTool extends BuiltInTool<UpgradeModelToolConfig> {
         context: BaseBuiltInToolExecutionContext
     ) {
         parseUpgradeModelArgs(args);
-        const { target } = await resolveUpgradeTarget(context.currentModel, config);
+        const { target } = await resolveModelSwitchTarget(args, context.currentModel, config);
         return buildUpgradeConversationSemantic(formatCurrentModelLabel(target.model));
     }
 
diff --git a/apps/desktop/src/stores/setting/general.ts b/apps/desktop/src/stores/setting/general.ts
index 29e8a95d..91381621 100644
--- a/apps/desktop/src/stores/setting/general.ts
+++ b/apps/desktop/src/stores/setting/general.ts
@@ -102,6 +102,18 @@ export const GENERAL_SCALAR_SETTING_SPECS = [
             normalizeUpdate: Boolean,
         },
     },
+    {
+        key: 'allow_model_auto_switch',
+        stateKey: 'allowModelAutoSwitch',
+        defaultValue: false,
+        parsePersisted: (raw) => booleanFromString(raw, false),
+        parseUpdate: (value) => booleanFromString(value, false),
+        eventValue: (value) => value as boolean,
+        store: {
+            updaterName: 'updateAllowModelAutoSwitch',
+            normalizeUpdate: Boolean,
+        },
+    },
     {
         key: 'output_scroll_behavior',
         stateKey: 'outputScrollBehavior',
diff --git a/apps/desktop/src/stores/setting/index.ts b/apps/desktop/src/stores/setting/index.ts
index 4eb1a9ef..36a32ee3 100644
--- a/apps/desktop/src/stores/setting/index.ts
+++ b/apps/desktop/src/stores/setting/index.ts
@@ -30,6 +30,7 @@ export interface GeneralSettingsData {
     globalShortcut: string;
     startOnBoot: boolean;
     startMinimized: boolean;
+    allowModelAutoSwitch: boolean;
     outputScrollBehavior: OutputScrollBehavior;
     searchWindowSizePreset: SearchWindowSizePreset;
     searchWindowDefaultSize: SearchWindowDefaultSize;
@@ -99,6 +100,7 @@ export interface GeneralSettingUpdaters {
     updateGlobalShortcut(shortcut: string): Promise<void>;
     updateStartOnBoot(enabled: boolean): Promise<void>;
     updateStartMinimized(enabled: boolean): Promise<void>;
+    updateAllowModelAutoSwitch(enabled: boolean): Promise<void>;
     updateOutputScrollBehavior(mode: OutputScrollBehavior): Promise<void>;
     updateSearchWindowSizePreset(preset: SearchWindowSizePreset): Promise<void>;
     updateLanguage(language: AppLocale): Promise<void>;
diff --git a/apps/desktop/src/views/SettingsView/components/AiServices/index.vue b/apps/desktop/src/views/SettingsView/components/AiServices/index.vue
index e44b256d..82351f01 100644
--- a/apps/desktop/src/views/SettingsView/components/AiServices/index.vue
+++ b/apps/desktop/src/views/SettingsView/components/AiServices/index.vue
@@ -19,6 +19,8 @@
         findDefaultModel,
         findModelsWithProvider,
         findProviderById,
+        getSettingValue,
+        listModelPreferences,
         setDefaultModel,
         syncAllModelsMetadata,
         updateModel,
@@ -77,6 +79,8 @@
     const selectedProviderId = ref<number | null>(null);
     const defaultModelId = ref<number | null>(null);
     const defaultModelProviderId = ref<number | null>(null);
+    const modelRoutingModelIds = ref<Set<number>>(new Set());
+    const modelRoutingProviderIds = ref<Set<number>>(new Set());
     const loading = ref(true);
     const loadingModels = ref(false);
     const error = ref<string | null>(null);
@@ -156,6 +160,49 @@
         return undefined;
     }
 
+    async function loadModelRoutingReferences() {
+        const [fastModelId, generalModelId, preferences, allModels] = await Promise.all([
+            getSettingValue({ key: 'model_role_fast_model_id' }),
+            getSettingValue({ key: 'model_role_general_model_id' }),
+            listModelPreferences(),
+            findModelsWithProvider(),
+        ]);
+        const modelProviderMap = new Map(allModels.map((model) => [model.id, model.provider_id]));
+        const nextModelIds = new Set<number>();
+        const nextProviderIds = new Set<number>();
+
+        for (const rawModelId of [fastModelId, generalModelId]) {
+            const modelId = rawModelId ? Number(rawModelId) : NaN;
+            if (!Number.isFinite(modelId)) {
+                continue;
+            }
+
+            nextModelIds.add(modelId);
+            const providerId = modelProviderMap.get(modelId);
+            if (providerId !== undefined) {
+                nextProviderIds.add(providerId);
+            }
+        }
+
+        for (const preference of preferences) {
+            if (preference.model_id !== null) {
+                nextModelIds.add(preference.model_id);
+                const providerId =
+                    preference.model_provider_id ??
+                    preference.provider_id ??
+                    modelProviderMap.get(preference.model_id);
+                if (providerId !== null && providerId !== undefined) {
+                    nextProviderIds.add(providerId);
+                }
+            } else if (preference.provider_id !== null) {
+                nextProviderIds.add(preference.provider_id);
+            }
+        }
+
+        modelRoutingModelIds.value = nextModelIds;
+        modelRoutingProviderIds.value = nextProviderIds;
+    }
+
     function patchProvider(providerId: number, patch: Partial<Provider>) {
         providers.value = providers.value.map((provider) =>
             provider.id === providerId ? { ...provider, ...patch } : provider
@@ -198,7 +245,6 @@
         const ids = new Set<number>();
         if (defaultModelProviderId.value !== null) {
             ids.add(defaultModelProviderId.value);
-            return ids;
         }
         return ids;
     });
@@ -235,6 +281,7 @@
             const defaultModel = await findDefaultModel();
             defaultModelId.value = defaultModel?.id || null;
             defaultModelProviderId.value = defaultModel?.provider_id || null;
+            await loadModelRoutingReferences();
 
             await ensureProviderSelected();
         } catch (err) {
@@ -353,6 +400,20 @@
         if (defaultModelProviderId.value === provider.id) {
             throw new Error(t('settings.ai.cannotDeleteProviderWithDefaultModel'));
         }
+
+        if (modelRoutingProviderIds.value.has(provider.id)) {
+            throw new Error(t('settings.ai.cannotDeleteProviderWithModelRouting'));
+        }
+    }
+
+    function assertModelCanBeDeleted(modelId: number) {
+        if (defaultModelId.value === modelId) {
+            throw new Error(t('settings.ai.cannotDeleteDefaultModel'));
+        }
+
+        if (modelRoutingModelIds.value.has(modelId)) {
+            throw new Error(t('settings.ai.cannotDeleteModelWithModelRouting'));
+        }
     }
 
     const handleProviderContextMenu = (providerId: number, event: MouseEvent) => {
@@ -426,6 +487,7 @@
                 throw new Error(t('settings.ai.providerNotFound'));
             }
 
+            await loadModelRoutingReferences();
             assertProviderCanBeDeleted(provider);
             await deleteProvider({ id: providerId });
             providers.value = providers.value.filter((item) => item.id !== providerId);
@@ -472,6 +534,8 @@
 
     const handleDeleteModel = async (id: number, silent = false) => {
         try {
+            await loadModelRoutingReferences();
+            assertModelCanBeDeleted(id);
             await deleteModel({ id });
             removeCachedModel(id);
             await broadcastModelsUpdated();
@@ -572,6 +636,28 @@
                     return;
                 }
 
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                const isAuthError =
+                    errorMessage.includes('401') ||
+                    errorMessage.includes('403') ||
+                    errorMessage.includes('Unauthorized') ||
+                    errorMessage.includes('authentication') ||
+                    errorMessage.includes('API key');
+
+                // 认证失败需要直接提示用户，避免只在控制台看到 401。
+                if (isAuthError) {
+                    if (notifications.failure) {
+                        alert.warning(
+                            t(
+                                provider.api_key
+                                    ? 'settings.ai.providerInvalidApiKeyForModels'
+                                    : 'settings.ai.providerNeedsApiKeyForModels'
+                            )
+                        );
+                    }
+                    return;
+                }
+
                 throw error;
             }
 
diff --git a/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferenceDialog.vue b/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferenceDialog.vue
new file mode 100644
index 00000000..9f94ddf6
--- /dev/null
+++ b/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferenceDialog.vue
@@ -0,0 +1,425 @@
+<script setup lang="ts">
+    import DialogShell from '@components/DialogShell.vue';
+    import ModelCapabilityTags from '@components/ModelCapabilityTags.vue';
+    import ModelLogo from '@components/ModelLogo.vue';
+    import SearchableSelect from '@components/SearchableSelect.vue';
+    import { Button } from '@components/ui/button';
+    import { Input } from '@components/ui/input';
+    import { useAlert } from '@composables/useAlert';
+    import type { ModelWithProvider } from '@database/queries/models';
+    import { computed, ref, watch } from 'vue';
+
+    import { t } from '@/i18n';
+
+    interface PreferenceForm {
+        id: number | null;
+        name: string;
+        description: string;
+        modelId: string;
+    }
+
+    interface ModelPreferenceSelectOption {
+        value: string | number;
+        label: string;
+        description?: string;
+        searchText?: string;
+        providerLogo?: string;
+        providerName?: string;
+        modelIdForLogo?: string;
+        modelName?: string;
+        attachment?: number | null;
+        modalities?: string | null;
+        open_weights?: number | null;
+        reasoning?: number | null;
+        tool_call?: number | null;
+    }
+
+    interface Props {
+        preference: PreferenceForm;
+        models: ModelWithProvider[];
+        saving?: boolean;
+    }
+
+    interface Emits {
+        (e: 'save', data: PreferenceForm): void;
+        (e: 'cancel'): void;
+    }
+
+    const props = withDefaults(defineProps<Props>(), {
+        saving: false,
+    });
+    const emit = defineEmits<Emits>();
+    const alert = useAlert();
+
+    const rawProviderLogos = import.meta.glob<{ default: string }>('@assets/logos/providers/*', {
+        eager: true,
+    });
+    const providerLogos: Record<string, string> = {};
+    for (const [path, mod] of Object.entries(rawProviderLogos)) {
+        const fileName = path.split('/').pop();
+        if (fileName && mod.default) {
+            providerLogos[fileName] = mod.default;
+        }
+    }
+
+    const form = ref<PreferenceForm>({ ...props.preference });
+    const selectedProviderId = ref<number | null>(null);
+
+    const enabledModels = computed(() =>
+        [...props.models]
+            .filter((model) => model.provider_enabled === 1)
+            .sort(
+                (left, right) =>
+                    left.provider_name.localeCompare(right.provider_name) ||
+                    left.name.localeCompare(right.name) ||
+                    left.model_id.localeCompare(right.model_id)
+            )
+    );
+
+    const selectedModel = computed(() => {
+        const modelId = Number(form.value.modelId);
+        return Number.isFinite(modelId)
+            ? enabledModels.value.find((model) => model.id === modelId)
+            : undefined;
+    });
+
+    const providerOptions = computed<ModelPreferenceSelectOption[]>(() => {
+        const providerMap = new Map<number, ModelPreferenceSelectOption>();
+
+        for (const model of enabledModels.value) {
+            if (providerMap.has(model.provider_id)) {
+                continue;
+            }
+
+            const providerModelCount = enabledModels.value.filter(
+                (item) => item.provider_id === model.provider_id
+            ).length;
+            providerMap.set(model.provider_id, {
+                value: model.provider_id,
+                label: model.provider_name,
+                description: t('settings.builtInTools.upgradeModel.availableModelCount', {
+                    count: providerModelCount,
+                }),
+                searchText: `${model.provider_name} ${model.provider_driver}`,
+                providerLogo: model.provider_logo,
+                providerName: model.provider_name,
+            });
+        }
+
+        return [...providerMap.values()];
+    });
+
+    const modelOptions = computed<ModelPreferenceSelectOption[]>(() => {
+        if (selectedProviderId.value === null) {
+            return [];
+        }
+
+        return enabledModels.value
+            .filter((model) => model.provider_id === selectedProviderId.value)
+            .map((model) => ({
+                value: String(model.id),
+                label: model.name,
+                description: model.model_id,
+                searchText: `${model.provider_name} ${model.name} ${model.model_id}`,
+                modelIdForLogo: model.model_id,
+                modelName: model.name,
+                providerName: model.provider_name,
+                attachment: model.attachment,
+                modalities: model.modalities,
+                open_weights: model.open_weights,
+                reasoning: model.reasoning,
+                tool_call: model.tool_call,
+            }));
+    });
+
+    function resolveProviderLogoPath(logo?: string): string {
+        return (logo && providerLogos[logo]) || '';
+    }
+
+    function getProviderFallbackText(option: ModelPreferenceSelectOption | null): string {
+        return option?.label?.charAt(0) || '?';
+    }
+
+    function initializeProvider() {
+        const providerId = selectedModel.value?.provider_id ?? null;
+        const firstProviderId = Number(providerOptions.value[0]?.value);
+        selectedProviderId.value =
+            providerId ?? (Number.isInteger(firstProviderId) ? firstProviderId : null);
+    }
+
+    watch(
+        () => props.preference,
+        (preference) => {
+            form.value = { ...preference };
+            initializeProvider();
+        }
+    );
+
+    watch(
+        () => props.models,
+        () => {
+            initializeProvider();
+        },
+        { immediate: true }
+    );
+
+    function updateProvider(value: string | number) {
+        const providerId = Number(value);
+        if (!Number.isInteger(providerId)) {
+            return;
+        }
+
+        selectedProviderId.value = providerId;
+        const firstModel = enabledModels.value.find((model) => model.provider_id === providerId);
+        form.value.modelId = firstModel ? String(firstModel.id) : '';
+    }
+
+    function updateModel(value: string | number) {
+        form.value.modelId = String(value);
+    }
+
+    function handleSave() {
+        const nextForm = {
+            ...form.value,
+            name: form.value.name.trim(),
+            description: form.value.description.trim(),
+        };
+
+        if (!nextForm.name) {
+            alert.error(t('settings.general.modelPreferences.nameRequired'));
+            return;
+        }
+        if (!nextForm.description) {
+            alert.error(t('settings.general.modelPreferences.descriptionRequired'));
+            return;
+        }
+        if (!nextForm.modelId) {
+            alert.error(t('settings.general.modelPreferences.modelRequired'));
+            return;
+        }
+
+        emit('save', nextForm);
+    }
+</script>
+
+<template>
+    <DialogShell>
+        <h2 class="mb-5 text-base font-bold text-neutral-950">
+            {{
+                preference.id === null
+                    ? t('settings.general.modelPreferences.addPreferenceTitle')
+                    : t('settings.general.modelPreferences.editPreferenceTitle')
+            }}
+        </h2>
+
+        <div class="space-y-4">
+            <div>
+                <label class="block text-sm font-medium text-neutral-700">
+                    {{ t('settings.general.modelPreferences.scenario') }}
+                </label>
+                <Input
+                    v-model="form.name"
+                    class="mt-1.5"
+                    :placeholder="t('settings.general.modelPreferences.scenarioPlaceholder')"
+                />
+            </div>
+
+            <div class="grid min-w-0 gap-3 sm:grid-cols-[minmax(0,0.9fr)_minmax(0,1.2fr)]">
+                <div class="min-w-0">
+                    <label class="block text-sm font-medium text-neutral-700">
+                        {{ t('settings.builtInTools.upgradeModel.provider') }}
+                    </label>
+                    <SearchableSelect
+                        :model-value="selectedProviderId"
+                        :options="providerOptions"
+                        class="mt-1.5"
+                        placeholder-key="settings.builtInTools.upgradeModel.provider"
+                        search-placeholder-key="settings.builtInTools.upgradeModel.searchProvider"
+                        empty-text-key="settings.builtInTools.upgradeModel.emptyProviders"
+                        protect-option-text
+                        @update:model-value="updateProvider"
+                    >
+                        <template #selected="{ option }">
+                            <div class="flex min-w-0 items-center gap-2">
+                                <img
+                                    v-if="resolveProviderLogoPath(option?.providerLogo)"
+                                    :src="resolveProviderLogoPath(option?.providerLogo)"
+                                    :alt="option?.providerName || option?.label || 'provider'"
+                                    class="h-5 w-5 flex-shrink-0 rounded object-contain"
+                                    data-no-i18n="true"
+                                    translate="no"
+                                />
+                                <div
+                                    v-else
+                                    class="flex h-5 w-5 flex-shrink-0 items-center justify-center rounded bg-neutral-100 text-[10px] font-semibold text-neutral-500"
+                                    data-no-i18n="true"
+                                    translate="no"
+                                >
+                                    {{ getProviderFallbackText(option) }}
+                                </div>
+                                <span
+                                    v-if="option"
+                                    class="truncate"
+                                    data-no-i18n="true"
+                                    translate="no"
+                                >
+                                    {{ option.label }}
+                                </span>
+                                <span v-else class="truncate">
+                                    {{ t('settings.builtInTools.upgradeModel.provider') }}
+                                </span>
+                            </div>
+                        </template>
+
+                        <template #option="{ option }">
+                            <div class="flex min-w-0 items-center gap-2">
+                                <img
+                                    v-if="resolveProviderLogoPath(option.providerLogo)"
+                                    :src="resolveProviderLogoPath(option.providerLogo)"
+                                    :alt="option.providerName || option.label"
+                                    class="h-5 w-5 flex-shrink-0 rounded object-contain"
+                                    data-no-i18n="true"
+                                    translate="no"
+                                />
+                                <div
+                                    v-else
+                                    class="flex h-5 w-5 flex-shrink-0 items-center justify-center rounded bg-neutral-100 text-[10px] font-semibold text-neutral-500"
+                                    data-no-i18n="true"
+                                    translate="no"
+                                >
+                                    {{ getProviderFallbackText(option) }}
+                                </div>
+                                <div class="min-w-0 flex-1">
+                                    <div
+                                        class="truncate text-sm font-medium"
+                                        data-no-i18n="true"
+                                        translate="no"
+                                    >
+                                        {{ option.label }}
+                                    </div>
+                                    <div
+                                        v-if="option.description"
+                                        class="mt-0.5 truncate text-xs text-neutral-500"
+                                        data-no-i18n="true"
+                                        translate="no"
+                                    >
+                                        {{ option.description }}
+                                    </div>
+                                </div>
+                            </div>
+                        </template>
+                    </SearchableSelect>
+                </div>
+
+                <div class="min-w-0">
+                    <label class="block text-sm font-medium text-neutral-700">
+                        {{ t('settings.general.modelPreferences.model') }}
+                    </label>
+                    <SearchableSelect
+                        :model-value="form.modelId"
+                        :options="modelOptions"
+                        class="mt-1.5"
+                        placeholder-key="settings.builtInTools.upgradeModel.model"
+                        search-placeholder-key="settings.builtInTools.upgradeModel.searchModel"
+                        empty-text-key="settings.builtInTools.upgradeModel.emptyModels"
+                        protect-option-text
+                        @update:model-value="updateModel"
+                    >
+                        <template #selected="{ option }">
+                            <div class="flex min-w-0 items-center gap-2">
+                                <ModelLogo
+                                    v-if="option?.modelIdForLogo"
+                                    :model-id="option.modelIdForLogo"
+                                    :name="option.modelName || option.label"
+                                    size="sm"
+                                />
+                                <span
+                                    v-if="option"
+                                    class="truncate"
+                                    data-no-i18n="true"
+                                    translate="no"
+                                >
+                                    {{ option.label }}
+                                </span>
+                                <span v-else class="truncate">
+                                    {{ t('settings.builtInTools.upgradeModel.model') }}
+                                </span>
+                            </div>
+                        </template>
+
+                        <template #option="{ option }">
+                            <div class="flex min-w-0 items-center gap-2">
+                                <ModelLogo
+                                    v-if="option.modelIdForLogo"
+                                    :model-id="option.modelIdForLogo"
+                                    :name="option.modelName || option.label"
+                                    size="sm"
+                                />
+                                <div class="min-w-0 flex-1">
+                                    <div
+                                        class="truncate text-sm font-medium"
+                                        data-no-i18n="true"
+                                        translate="no"
+                                    >
+                                        {{ option.label }}
+                                    </div>
+                                    <div class="mt-1">
+                                        <ModelCapabilityTags
+                                            v-if="
+                                                option.reasoning !== undefined ||
+                                                option.tool_call !== undefined ||
+                                                option.modalities !== undefined ||
+                                                option.attachment !== undefined ||
+                                                option.open_weights !== undefined
+                                            "
+                                            :model="option"
+                                            size="sm"
+                                        />
+                                        <div
+                                            v-else-if="option.description"
+                                            class="truncate text-xs text-neutral-500"
+                                            data-no-i18n="true"
+                                            translate="no"
+                                        >
+                                            {{ option.description }}
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+                        </template>
+                    </SearchableSelect>
+                </div>
+            </div>
+
+            <div>
+                <label class="block text-sm font-medium text-neutral-700">
+                    {{ t('common.description') }}
+                </label>
+                <textarea
+                    v-model="form.description"
+                    rows="3"
+                    class="focus:border-primary-400 mt-1.5 min-h-24 w-full resize-y rounded-lg border border-gray-200 bg-white px-3 py-2 font-serif text-[13px] text-gray-900 shadow-none transition-colors focus:outline-none"
+                    :placeholder="t('settings.general.modelPreferences.descriptionPlaceholder')"
+                />
+            </div>
+        </div>
+
+        <div class="mt-6 flex gap-3">
+            <Button
+                class="bg-primary-700 hover:bg-primary-600 flex-1 rounded-lg px-4 py-2 text-sm font-medium text-white transition-colors"
+                :disabled="saving"
+                @click="handleSave"
+            >
+                {{ preference.id === null ? t('common.create') : t('common.save') }}
+            </Button>
+            <Button
+                variant="outline"
+                class="flex-1 rounded-lg border border-neutral-200 px-4 py-2 text-sm font-medium text-neutral-600 transition-colors hover:border-neutral-300"
+                :disabled="saving"
+                @click="emit('cancel')"
+            >
+                {{ t('common.cancel') }}
+            </Button>
+        </div>
+    </DialogShell>
+</template>
diff --git a/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue b/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue
new file mode 100644
index 00000000..70b0977f
--- /dev/null
+++ b/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue
@@ -0,0 +1,928 @@
+<!-- Copyright (c) 2026. Qian Cheng. Licensed under GPL v3 -->
+
+<script setup lang="ts">
+    import AppIcon from '@components/AppIcon.vue';
+    import ModelCapabilityTags from '@components/ModelCapabilityTags.vue';
+    import ModelLogo from '@components/ModelLogo.vue';
+    import SearchableSelect from '@components/SearchableSelect.vue';
+    import { useAlert } from '@composables/useAlert';
+    import {
+        createModelPreference,
+        deleteModelPreference,
+        findModelRoleWithProvider,
+        findModelsWithProvider,
+        listModelPreferences,
+        setModelRole,
+        updateModelPreference,
+    } from '@database/queries';
+    import type { ModelRole, ModelWithProvider } from '@database/queries/models';
+    import type { ModelPreferenceWithModel } from '@database/types';
+    import { computed, onMounted, ref } from 'vue';
+
+    import { t } from '@/i18n';
+
+    import ModelPreferenceDialog from './ModelPreferenceDialog.vue';
+
+    defineOptions({
+        name: 'ModelPreferences',
+    });
+
+    interface Props {
+        routingEnabled?: boolean;
+    }
+
+    withDefaults(defineProps<Props>(), {
+        routingEnabled: true,
+    });
+
+    interface PreferenceForm {
+        id: number | null;
+        name: string;
+        description: string;
+        modelId: string;
+    }
+
+    interface ModelPreferenceSelectOption {
+        value: string | number;
+        label: string;
+        description?: string;
+        searchText?: string;
+        providerLogo?: string;
+        providerName?: string;
+        modelIdForLogo?: string;
+        modelName?: string;
+        attachment?: number | null;
+        modalities?: string | null;
+        open_weights?: number | null;
+        reasoning?: number | null;
+        tool_call?: number | null;
+    }
+
+    const alert = useAlert();
+    const loading = ref(true);
+    const saving = ref(false);
+    const preferences = ref<ModelPreferenceWithModel[]>([]);
+    const models = ref<ModelWithProvider[]>([]);
+    const savingPreferenceIds = ref<Set<number>>(new Set());
+    const roleModelIds = ref<Record<ModelRole, string>>({
+        entry: '',
+        fast: '',
+        general: '',
+    });
+    const roleProviderIds = ref<Record<ModelRole, number | null>>({
+        entry: null,
+        fast: null,
+        general: null,
+    });
+    const form = ref<PreferenceForm | null>(null);
+    const UNSET_MODEL_VALUE = '__touchai_unset_model__';
+    const rawProviderLogos = import.meta.glob<{ default: string }>('@assets/logos/providers/*', {
+        eager: true,
+    });
+    const providerLogos: Record<string, string> = {};
+    for (const [path, mod] of Object.entries(rawProviderLogos)) {
+        const fileName = path.split('/').pop();
+        if (fileName && mod.default) {
+            providerLogos[fileName] = mod.default;
+        }
+    }
+
+    const modelRoles: Array<{
+        role: ModelRole;
+        required: boolean;
+        titleKey: Parameters<typeof t>[0];
+        descriptionKey: Parameters<typeof t>[0];
+        placeholderKey: Parameters<typeof t>[0];
+    }> = [
+        {
+            role: 'entry',
+            required: true,
+            titleKey: 'settings.general.modelPreferences.entryModel',
+            descriptionKey: 'settings.general.modelPreferences.entryModelDescription',
+            placeholderKey: 'settings.general.modelPreferences.selectEntryModel',
+        },
+        {
+            role: 'fast',
+            required: false,
+            titleKey: 'settings.general.modelPreferences.fastModel',
+            descriptionKey: 'settings.general.modelPreferences.fastModelDescription',
+            placeholderKey: 'settings.general.modelPreferences.useEntryModel',
+        },
+        {
+            role: 'general',
+            required: false,
+            titleKey: 'settings.general.modelPreferences.generalModel',
+            descriptionKey: 'settings.general.modelPreferences.generalModelDescription',
+            placeholderKey: 'settings.general.modelPreferences.useEntryModel',
+        },
+    ];
+
+    const enabledModels = computed(() =>
+        [...models.value]
+            .sort(
+                (left, right) =>
+                    left.provider_name.localeCompare(right.provider_name) ||
+                    left.name.localeCompare(right.name) ||
+                    left.model_id.localeCompare(right.model_id)
+            )
+            .filter((model) => model.provider_enabled === 1)
+    );
+
+    const providerOptions = computed<ModelPreferenceSelectOption[]>(() => {
+        const providerMap = new Map<number, ModelPreferenceSelectOption>();
+
+        for (const model of enabledModels.value) {
+            if (providerMap.has(model.provider_id)) {
+                continue;
+            }
+
+            const providerModelCount = enabledModels.value.filter(
+                (item) => item.provider_id === model.provider_id
+            ).length;
+            providerMap.set(model.provider_id, {
+                value: model.provider_id,
+                label: model.provider_name,
+                description: t('settings.builtInTools.upgradeModel.availableModelCount', {
+                    count: providerModelCount,
+                }),
+                searchText: `${model.provider_name} ${model.provider_driver}`,
+                providerLogo: model.provider_logo,
+                providerName: model.provider_name,
+            });
+        }
+
+        return [...providerMap.values()];
+    });
+
+    function getRoleProviderOptions(
+        modelRole: (typeof modelRoles)[number]
+    ): ModelPreferenceSelectOption[] {
+        if (modelRole.required) {
+            return providerOptions.value;
+        }
+
+        return [
+            {
+                value: UNSET_MODEL_VALUE,
+                label: t(modelRole.placeholderKey),
+            },
+            ...providerOptions.value,
+        ];
+    }
+
+    function getRoleProviderValue(modelRole: (typeof modelRoles)[number]): string | number | null {
+        const providerId = roleProviderIds.value[modelRole.role];
+        if (!modelRole.required && !roleModelIds.value[modelRole.role]) {
+            return UNSET_MODEL_VALUE;
+        }
+
+        return providerId;
+    }
+
+    function getRoleModelOptions(role: ModelRole): ModelPreferenceSelectOption[] {
+        const providerId = roleProviderIds.value[role];
+        if (providerId === null) {
+            return [];
+        }
+
+        return getModelOptionsForProvider(providerId);
+    }
+
+    function getModelOptionsForProvider(providerId: number): ModelPreferenceSelectOption[] {
+        return enabledModels.value
+            .filter((model) => model.provider_id === providerId)
+            .map((model) => ({
+                value: String(model.id),
+                label: model.name,
+                description: model.model_id,
+                searchText: `${model.provider_name} ${model.name} ${model.model_id}`,
+                modelIdForLogo: model.model_id,
+                modelName: model.name,
+                providerName: model.provider_name,
+                attachment: model.attachment,
+                modalities: model.modalities,
+                open_weights: model.open_weights,
+                reasoning: model.reasoning,
+                tool_call: model.tool_call,
+            }));
+    }
+
+    function getRoleModelValue(role: ModelRole): string | null {
+        return roleModelIds.value[role] || null;
+    }
+
+    function resolveProviderLogoPath(logo?: string): string {
+        return (logo && providerLogos[logo]) || '';
+    }
+
+    function getProviderFallbackText(option: ModelPreferenceSelectOption | null): string {
+        return option?.label?.charAt(0) || '?';
+    }
+
+    function updateRoleProvider(modelRole: (typeof modelRoles)[number], value: string | number) {
+        if (!modelRole.required && value === UNSET_MODEL_VALUE) {
+            roleProviderIds.value[modelRole.role] = null;
+            roleModelIds.value[modelRole.role] = '';
+            void saveModelRole(modelRole.role);
+            return;
+        }
+
+        const providerId = Number(value);
+        if (!Number.isInteger(providerId)) {
+            return;
+        }
+
+        roleProviderIds.value[modelRole.role] = providerId;
+
+        const currentModel = enabledModels.value.find(
+            (model) =>
+                String(model.id) === roleModelIds.value[modelRole.role] &&
+                model.provider_id === providerId
+        );
+        const nextModel =
+            currentModel ?? enabledModels.value.find((model) => model.provider_id === providerId);
+
+        roleModelIds.value[modelRole.role] = nextModel ? String(nextModel.id) : '';
+        void saveModelRole(modelRole.role);
+    }
+
+    function updateRoleModel(role: ModelRole, value: string | number) {
+        roleModelIds.value[role] = String(value);
+        const selectedModel = enabledModels.value.find(
+            (model) => String(model.id) === String(value)
+        );
+        roleProviderIds.value[role] = selectedModel?.provider_id ?? roleProviderIds.value[role];
+        void saveModelRole(role);
+    }
+
+    function getPreferenceProviderValue(preference: ModelPreferenceWithModel): number | null {
+        return preference.model_provider_id ?? preference.provider_id ?? null;
+    }
+
+    function getPreferenceModelValue(preference: ModelPreferenceWithModel): string | null {
+        return preference.model_id === null ? null : String(preference.model_id);
+    }
+
+    function getPreferenceModelOptions(preference: ModelPreferenceWithModel) {
+        const providerId = getPreferenceProviderValue(preference);
+        return providerId === null ? [] : getModelOptionsForProvider(providerId);
+    }
+
+    function isPreferenceSaving(preferenceId: number): boolean {
+        return savingPreferenceIds.value.has(preferenceId);
+    }
+
+    function setPreferenceSaving(preferenceId: number, nextSaving: boolean) {
+        const nextIds = new Set(savingPreferenceIds.value);
+        if (nextSaving) {
+            nextIds.add(preferenceId);
+        } else {
+            nextIds.delete(preferenceId);
+        }
+        savingPreferenceIds.value = nextIds;
+    }
+
+    async function updatePreferenceModel(preference: ModelPreferenceWithModel, modelId: string) {
+        if (isPreferenceSaving(preference.id)) {
+            return;
+        }
+
+        const selectedModel = enabledModels.value.find((model) => String(model.id) === modelId);
+        if (!selectedModel) {
+            alert.error(t('settings.general.modelPreferences.modelRequired'));
+            await loadData();
+            return;
+        }
+
+        setPreferenceSaving(preference.id, true);
+        try {
+            await updateModelPreference(preference.id, {
+                provider_id: selectedModel.provider_id,
+                model_id: selectedModel.id,
+            });
+            await loadData();
+            alert.success(t('common.saved'));
+        } catch (error) {
+            console.error('[ModelPreferences] Failed to update preference model:', error);
+            alert.error(t('settings.general.modelPreferences.saveFailed'));
+            await loadData();
+        } finally {
+            setPreferenceSaving(preference.id, false);
+        }
+    }
+
+    function updatePreferenceProvider(
+        preference: ModelPreferenceWithModel,
+        value: string | number
+    ) {
+        const providerId = Number(value);
+        if (!Number.isInteger(providerId)) {
+            return;
+        }
+
+        const currentModel = enabledModels.value.find(
+            (model) =>
+                preference.model_id !== null &&
+                model.id === preference.model_id &&
+                model.provider_id === providerId
+        );
+        const nextModel =
+            currentModel ?? enabledModels.value.find((model) => model.provider_id === providerId);
+
+        if (!nextModel) {
+            alert.error(t('settings.general.modelPreferences.modelRequired'));
+            return;
+        }
+
+        void updatePreferenceModel(preference, String(nextModel.id));
+    }
+
+    function createEmptyForm(): PreferenceForm {
+        return {
+            id: null,
+            name: '',
+            description: '',
+            modelId: '',
+        };
+    }
+
+    async function loadData() {
+        loading.value = true;
+        try {
+            const [nextPreferences, nextModels, defaultRoleModel, fastModel, generalModel] =
+                await Promise.all([
+                    listModelPreferences(),
+                    findModelsWithProvider(),
+                    findModelRoleWithProvider('entry'),
+                    findModelRoleWithProvider('fast'),
+                    findModelRoleWithProvider('general'),
+                ]);
+            preferences.value = nextPreferences;
+            models.value = nextModels;
+            roleModelIds.value = {
+                entry: defaultRoleModel ? String(defaultRoleModel.id) : '',
+                fast: fastModel ? String(fastModel.id) : '',
+                general: generalModel ? String(generalModel.id) : '',
+            };
+            roleProviderIds.value = {
+                entry: defaultRoleModel?.provider_id ?? null,
+                fast: fastModel?.provider_id ?? null,
+                general: generalModel?.provider_id ?? null,
+            };
+        } catch (error) {
+            console.error('[ModelPreferences] Failed to load data:', error);
+            alert.error(t('settings.general.modelPreferences.loadFailed'));
+        } finally {
+            loading.value = false;
+        }
+    }
+
+    function startCreate() {
+        form.value = createEmptyForm();
+    }
+
+    function startEdit(preference: ModelPreferenceWithModel) {
+        form.value = {
+            id: preference.id,
+            name: preference.name,
+            description: preference.description,
+            modelId: preference.model_id === null ? '' : String(preference.model_id),
+        };
+    }
+
+    function cancelEdit() {
+        form.value = null;
+    }
+
+    async function saveModelRole(role: ModelRole) {
+        const rawModelId = roleModelIds.value[role];
+        const modelId = rawModelId ? Number(rawModelId) : null;
+        if (role === 'entry' && modelId === null) {
+            alert.error(t('settings.general.modelPreferences.entryModelRequired'));
+            await loadData();
+            return;
+        }
+
+        try {
+            await setModelRole({ role, modelId });
+            await loadData();
+            alert.success(t('common.saved'));
+        } catch (error) {
+            console.error('[ModelPreferences] Failed to save model role:', error);
+            alert.error(t('settings.general.modelPreferences.saveFailed'));
+            await loadData();
+        }
+    }
+
+    async function savePreference(nextForm: PreferenceForm) {
+        if (saving.value) {
+            return;
+        }
+
+        const modelId = Number(nextForm.modelId);
+        const selectedModel = Number.isFinite(modelId)
+            ? models.value.find((model) => model.id === modelId && model.provider_enabled === 1)
+            : null;
+        if (!selectedModel) {
+            alert.error(t('settings.general.modelPreferences.modelRequired'));
+            return;
+        }
+
+        saving.value = true;
+        try {
+            const payload = {
+                name: nextForm.name,
+                description: nextForm.description,
+                provider_id: selectedModel.provider_id,
+                model_id: selectedModel.id,
+            };
+
+            if (nextForm.id === null) {
+                await createModelPreference(payload);
+            } else {
+                await updateModelPreference(nextForm.id, payload);
+            }
+
+            form.value = null;
+            await loadData();
+            alert.success(t('common.saved'));
+        } catch (error) {
+            console.error('[ModelPreferences] Failed to save preference:', error);
+            alert.error(t('settings.general.modelPreferences.saveFailed'));
+        } finally {
+            saving.value = false;
+        }
+    }
+
+    async function removePreference(preference: ModelPreferenceWithModel) {
+        try {
+            await deleteModelPreference(preference.id);
+            await loadData();
+            alert.success(t('settings.ai.deleteSucceeded'));
+        } catch (error) {
+            console.error('[ModelPreferences] Failed to delete preference:', error);
+            alert.error(t('settings.ai.deleteFailed'));
+        }
+    }
+
+    onMounted(() => {
+        void loadData();
+    });
+</script>
+
+<template>
+    <div v-if="loading" class="settings-row-group px-4 py-3 text-sm text-neutral-500">
+        {{ t('common.loading') }}
+    </div>
+
+    <div
+        v-else-if="models.length === 0"
+        class="rounded-[11px] border border-dashed border-neutral-200/80 bg-white px-6 py-12 text-center"
+    >
+        <AppIcon name="cloud" class="mx-auto h-10 w-10 text-neutral-300" />
+        <h2 class="mt-4 text-[15px] font-medium text-neutral-950">
+            {{ t('settings.general.modelPreferences.noModelsTitle') }}
+        </h2>
+        <p class="mx-auto mt-2 max-w-md text-sm leading-6 text-neutral-500">
+            {{ t('settings.general.modelPreferences.noModelsDescription') }}
+        </p>
+    </div>
+
+    <fieldset v-else :disabled="!routingEnabled" class="contents">
+        <section class="space-y-4">
+            <h2 class="settings-section-title">
+                {{ t('settings.general.modelPreferences.rolesTitle') }}
+            </h2>
+
+            <div
+                class="settings-row-group relative z-10 divide-y divide-neutral-200/70 overflow-visible"
+            >
+                <div
+                    v-for="modelRole in modelRoles"
+                    :key="modelRole.role"
+                    class="grid min-w-0 gap-4 px-5 py-4 md:grid-cols-[minmax(0,1fr)_minmax(0,520px)] md:items-center"
+                >
+                    <div class="min-w-0">
+                        <div class="text-[13px] leading-6 font-normal text-neutral-900">
+                            {{ t(modelRole.titleKey) }}
+                        </div>
+                        <p class="text-xs leading-5 text-neutral-500">
+                            {{ t(modelRole.descriptionKey) }}
+                        </p>
+                    </div>
+
+                    <div
+                        class="ml-auto grid w-full min-w-0 gap-3 sm:grid-cols-[minmax(0,0.9fr)_minmax(0,1.15fr)]"
+                    >
+                        <SearchableSelect
+                            :model-value="getRoleProviderValue(modelRole)"
+                            :options="getRoleProviderOptions(modelRole)"
+                            placeholder-key="settings.builtInTools.upgradeModel.provider"
+                            search-placeholder-key="settings.builtInTools.upgradeModel.searchProvider"
+                            empty-text-key="settings.builtInTools.upgradeModel.emptyProviders"
+                            protect-option-text
+                            @update:model-value="updateRoleProvider(modelRole, $event)"
+                        >
+                            <template #selected="{ option }">
+                                <div class="flex min-w-0 items-center gap-2">
+                                    <img
+                                        v-if="resolveProviderLogoPath(option?.providerLogo)"
+                                        :src="resolveProviderLogoPath(option?.providerLogo)"
+                                        :alt="option?.providerName || option?.label || 'provider'"
+                                        class="h-5 w-5 flex-shrink-0 rounded object-contain"
+                                        data-no-i18n="true"
+                                        translate="no"
+                                    />
+                                    <div
+                                        v-else-if="option?.value !== UNSET_MODEL_VALUE"
+                                        class="flex h-5 w-5 flex-shrink-0 items-center justify-center rounded bg-neutral-100 text-[10px] font-semibold text-neutral-500"
+                                        data-no-i18n="true"
+                                        translate="no"
+                                    >
+                                        {{ getProviderFallbackText(option) }}
+                                    </div>
+                                    <span
+                                        v-if="option"
+                                        class="truncate"
+                                        :data-no-i18n="
+                                            option.value === UNSET_MODEL_VALUE ? undefined : 'true'
+                                        "
+                                        :translate="
+                                            option.value === UNSET_MODEL_VALUE ? undefined : 'no'
+                                        "
+                                    >
+                                        {{ option.label }}
+                                    </span>
+                                    <span v-else class="truncate">
+                                        {{ t('settings.builtInTools.upgradeModel.provider') }}
+                                    </span>
+                                </div>
+                            </template>
+
+                            <template #option="{ option }">
+                                <div class="flex min-w-0 items-center gap-2">
+                                    <img
+                                        v-if="resolveProviderLogoPath(option.providerLogo)"
+                                        :src="resolveProviderLogoPath(option.providerLogo)"
+                                        :alt="option.providerName || option.label"
+                                        class="h-5 w-5 flex-shrink-0 rounded object-contain"
+                                        data-no-i18n="true"
+                                        translate="no"
+                                    />
+                                    <div
+                                        v-else-if="option.value !== UNSET_MODEL_VALUE"
+                                        class="flex h-5 w-5 flex-shrink-0 items-center justify-center rounded bg-neutral-100 text-[10px] font-semibold text-neutral-500"
+                                        data-no-i18n="true"
+                                        translate="no"
+                                    >
+                                        {{ getProviderFallbackText(option) }}
+                                    </div>
+                                    <div class="min-w-0 flex-1">
+                                        <div
+                                            class="truncate text-sm font-medium"
+                                            :data-no-i18n="
+                                                option.value === UNSET_MODEL_VALUE
+                                                    ? undefined
+                                                    : 'true'
+                                            "
+                                            :translate="
+                                                option.value === UNSET_MODEL_VALUE
+                                                    ? undefined
+                                                    : 'no'
+                                            "
+                                        >
+                                            {{ option.label }}
+                                        </div>
+                                        <div
+                                            v-if="option.description"
+                                            class="mt-0.5 truncate text-xs text-neutral-500"
+                                            data-no-i18n="true"
+                                            translate="no"
+                                        >
+                                            {{ option.description }}
+                                        </div>
+                                    </div>
+                                </div>
+                            </template>
+                        </SearchableSelect>
+
+                        <SearchableSelect
+                            :model-value="getRoleModelValue(modelRole.role)"
+                            :options="getRoleModelOptions(modelRole.role)"
+                            :disabled="!roleProviderIds[modelRole.role]"
+                            placeholder-key="settings.builtInTools.upgradeModel.model"
+                            search-placeholder-key="settings.builtInTools.upgradeModel.searchModel"
+                            empty-text-key="settings.builtInTools.upgradeModel.emptyModels"
+                            protect-option-text
+                            @update:model-value="updateRoleModel(modelRole.role, $event)"
+                        >
+                            <template #selected="{ option }">
+                                <div class="flex min-w-0 items-center gap-2">
+                                    <ModelLogo
+                                        v-if="option?.modelIdForLogo"
+                                        :model-id="option.modelIdForLogo"
+                                        :name="option.modelName || option.label"
+                                        size="sm"
+                                    />
+                                    <span
+                                        v-if="option"
+                                        class="truncate"
+                                        data-no-i18n="true"
+                                        translate="no"
+                                    >
+                                        {{ option.label }}
+                                    </span>
+                                    <span v-else class="truncate">
+                                        {{ t('settings.builtInTools.upgradeModel.model') }}
+                                    </span>
+                                </div>
+                            </template>
+
+                            <template #option="{ option }">
+                                <div class="flex min-w-0 items-center gap-2">
+                                    <ModelLogo
+                                        v-if="option.modelIdForLogo"
+                                        :model-id="option.modelIdForLogo"
+                                        :name="option.modelName || option.label"
+                                        size="sm"
+                                    />
+                                    <div class="min-w-0 flex-1">
+                                        <div
+                                            class="truncate text-sm font-medium"
+                                            data-no-i18n="true"
+                                            translate="no"
+                                        >
+                                            {{ option.label }}
+                                        </div>
+                                        <div class="mt-1">
+                                            <ModelCapabilityTags
+                                                v-if="
+                                                    option.reasoning !== undefined ||
+                                                    option.tool_call !== undefined ||
+                                                    option.modalities !== undefined ||
+                                                    option.attachment !== undefined ||
+                                                    option.open_weights !== undefined
+                                                "
+                                                :model="option"
+                                                size="sm"
+                                            />
+                                            <div
+                                                v-else-if="option.description"
+                                                class="truncate text-xs text-neutral-500"
+                                                data-no-i18n="true"
+                                                translate="no"
+                                            >
+                                                {{ option.description }}
+                                            </div>
+                                        </div>
+                                    </div>
+                                </div>
+                            </template>
+                        </SearchableSelect>
+                    </div>
+                </div>
+            </div>
+        </section>
+
+        <section class="space-y-4 pt-5">
+            <div class="flex items-start justify-between gap-4">
+                <div>
+                    <h2 class="text-[15px] font-medium text-neutral-950">
+                        {{ t('settings.general.modelPreferences.scenarioPreferencesTitle') }}
+                    </h2>
+                    <p class="mt-1 max-w-2xl text-sm leading-6 text-neutral-500">
+                        {{ t('settings.general.modelPreferences.scenarioPreferencesDescription') }}
+                    </p>
+                </div>
+
+                <button
+                    class="settings-button-primary flex items-center gap-1.5"
+                    @click="startCreate"
+                >
+                    <AppIcon name="plus" class="h-4 w-4" />
+                    {{ t('settings.general.modelPreferences.add') }}
+                </button>
+            </div>
+
+            <div
+                v-if="preferences.length === 0"
+                class="rounded-[11px] border border-dashed border-neutral-200/80 bg-white px-4 py-5 text-center text-sm text-neutral-500"
+            >
+                {{ t('settings.general.modelPreferences.empty') }}
+            </div>
+
+            <div
+                v-else
+                class="settings-row-group relative z-0 divide-y divide-neutral-200/70 overflow-visible"
+            >
+                <div
+                    v-for="preference in preferences"
+                    :key="preference.id"
+                    class="grid min-w-0 gap-4 px-4 py-3 transition-colors hover:bg-neutral-50/70 md:grid-cols-[minmax(0,1fr)_minmax(0,520px)] md:items-center"
+                >
+                    <div class="min-w-0">
+                        <div class="flex min-w-0 items-center gap-1.5">
+                            <h3 class="truncate text-[13px] leading-5 font-medium text-neutral-950">
+                                {{ preference.name }}
+                            </h3>
+                            <button
+                                class="settings-icon-button h-6 w-6 rounded-md"
+                                :title="t('common.edit')"
+                                @click="startEdit(preference)"
+                            >
+                                <AppIcon name="edit" class="h-3.5 w-3.5" />
+                            </button>
+                            <button
+                                class="settings-icon-button h-6 w-6 rounded-md"
+                                :title="t('common.delete')"
+                                @click="removePreference(preference)"
+                            >
+                                <AppIcon name="delete" class="h-3.5 w-3.5" />
+                            </button>
+                        </div>
+                        <p class="mt-0.5 text-xs leading-5 text-neutral-600">
+                            {{ preference.description }}
+                        </p>
+                        <p
+                            v-if="preference.provider_enabled !== 1 || preference.model_id === null"
+                            class="mt-1 text-[11px] leading-4 text-red-500"
+                        >
+                            {{ t('settings.general.modelPreferences.unavailableModel') }}
+                        </p>
+                    </div>
+
+                    <div
+                        class="ml-auto grid w-full min-w-0 gap-3 sm:grid-cols-[minmax(0,0.9fr)_minmax(0,1.15fr)]"
+                    >
+                        <SearchableSelect
+                            :model-value="getPreferenceProviderValue(preference)"
+                            :options="providerOptions"
+                            :disabled="isPreferenceSaving(preference.id)"
+                            placeholder-key="settings.builtInTools.upgradeModel.provider"
+                            search-placeholder-key="settings.builtInTools.upgradeModel.searchProvider"
+                            empty-text-key="settings.builtInTools.upgradeModel.emptyProviders"
+                            protect-option-text
+                            @update:model-value="updatePreferenceProvider(preference, $event)"
+                        >
+                            <template #selected="{ option }">
+                                <div class="flex min-w-0 items-center gap-2">
+                                    <img
+                                        v-if="resolveProviderLogoPath(option?.providerLogo)"
+                                        :src="resolveProviderLogoPath(option?.providerLogo)"
+                                        :alt="option?.providerName || option?.label || 'provider'"
+                                        class="h-5 w-5 flex-shrink-0 rounded object-contain"
+                                        data-no-i18n="true"
+                                        translate="no"
+                                    />
+                                    <div
+                                        v-else
+                                        class="flex h-5 w-5 flex-shrink-0 items-center justify-center rounded bg-neutral-100 text-[10px] font-semibold text-neutral-500"
+                                        data-no-i18n="true"
+                                        translate="no"
+                                    >
+                                        {{ getProviderFallbackText(option) }}
+                                    </div>
+                                    <span
+                                        v-if="option"
+                                        class="truncate"
+                                        data-no-i18n="true"
+                                        translate="no"
+                                    >
+                                        {{ option.label }}
+                                    </span>
+                                    <span v-else class="truncate">
+                                        {{ t('settings.builtInTools.upgradeModel.provider') }}
+                                    </span>
+                                </div>
+                            </template>
+
+                            <template #option="{ option }">
+                                <div class="flex min-w-0 items-center gap-2">
+                                    <img
+                                        v-if="resolveProviderLogoPath(option.providerLogo)"
+                                        :src="resolveProviderLogoPath(option.providerLogo)"
+                                        :alt="option.providerName || option.label"
+                                        class="h-5 w-5 flex-shrink-0 rounded object-contain"
+                                        data-no-i18n="true"
+                                        translate="no"
+                                    />
+                                    <div
+                                        v-else
+                                        class="flex h-5 w-5 flex-shrink-0 items-center justify-center rounded bg-neutral-100 text-[10px] font-semibold text-neutral-500"
+                                        data-no-i18n="true"
+                                        translate="no"
+                                    >
+                                        {{ getProviderFallbackText(option) }}
+                                    </div>
+                                    <div class="min-w-0 flex-1">
+                                        <div
+                                            class="truncate text-sm font-medium"
+                                            data-no-i18n="true"
+                                            translate="no"
+                                        >
+                                            {{ option.label }}
+                                        </div>
+                                        <div
+                                            v-if="option.description"
+                                            class="mt-0.5 truncate text-xs text-neutral-500"
+                                            data-no-i18n="true"
+                                            translate="no"
+                                        >
+                                            {{ option.description }}
+                                        </div>
+                                    </div>
+                                </div>
+                            </template>
+                        </SearchableSelect>
+
+                        <SearchableSelect
+                            :model-value="getPreferenceModelValue(preference)"
+                            :options="getPreferenceModelOptions(preference)"
+                            :disabled="
+                                isPreferenceSaving(preference.id) ||
+                                getPreferenceProviderValue(preference) === null
+                            "
+                            placeholder-key="settings.builtInTools.upgradeModel.model"
+                            search-placeholder-key="settings.builtInTools.upgradeModel.searchModel"
+                            empty-text-key="settings.builtInTools.upgradeModel.emptyModels"
+                            protect-option-text
+                            @update:model-value="updatePreferenceModel(preference, String($event))"
+                        >
+                            <template #selected="{ option }">
+                                <div class="flex min-w-0 items-center gap-2">
+                                    <ModelLogo
+                                        v-if="option?.modelIdForLogo"
+                                        :model-id="option.modelIdForLogo"
+                                        :name="option.modelName || option.label"
+                                        size="sm"
+                                    />
+                                    <span
+                                        v-if="option"
+                                        class="truncate"
+                                        data-no-i18n="true"
+                                        translate="no"
+                                    >
+                                        {{ option.label }}
+                                    </span>
+                                    <span v-else class="truncate">
+                                        {{ t('settings.builtInTools.upgradeModel.model') }}
+                                    </span>
+                                </div>
+                            </template>
+
+                            <template #option="{ option }">
+                                <div class="flex min-w-0 items-center gap-2">
+                                    <ModelLogo
+                                        v-if="option.modelIdForLogo"
+                                        :model-id="option.modelIdForLogo"
+                                        :name="option.modelName || option.label"
+                                        size="sm"
+                                    />
+                                    <div class="min-w-0 flex-1">
+                                        <div
+                                            class="truncate text-sm font-medium"
+                                            data-no-i18n="true"
+                                            translate="no"
+                                        >
+                                            {{ option.label }}
+                                        </div>
+                                        <div class="mt-1">
+                                            <ModelCapabilityTags
+                                                v-if="
+                                                    option.reasoning !== undefined ||
+                                                    option.tool_call !== undefined ||
+                                                    option.modalities !== undefined ||
+                                                    option.attachment !== undefined ||
+                                                    option.open_weights !== undefined
+                                                "
+                                                :model="option"
+                                                size="sm"
+                                            />
+                                            <div
+                                                v-else-if="option.description"
+                                                class="truncate text-xs text-neutral-500"
+                                                data-no-i18n="true"
+                                                translate="no"
+                                            >
+                                                {{ option.description }}
+                                            </div>
+                                        </div>
+                                    </div>
+                                </div>
+                            </template>
+                        </SearchableSelect>
+                    </div>
+                </div>
+            </div>
+
+            <ModelPreferenceDialog
+                v-if="form"
+                :preference="form"
+                :models="models"
+                :saving="saving"
+                @save="savePreference"
+                @cancel="cancelEdit"
+            />
+        </section>
+    </fieldset>
+</template>
diff --git a/apps/desktop/src/views/SettingsView/components/General/index.vue b/apps/desktop/src/views/SettingsView/components/General/index.vue
index fe8aaed8..7cf4dd58 100644
--- a/apps/desktop/src/views/SettingsView/components/General/index.vue
+++ b/apps/desktop/src/views/SettingsView/components/General/index.vue
@@ -632,7 +632,10 @@
                     </p>
                 </div>
 
-                <div data-testid="settings-general-card-conversation" class="settings-row-group">
+                <div
+                    data-testid="settings-general-card-conversation"
+                    class="settings-row-group divide-y divide-neutral-200/70"
+                >
                     <div
                         class="grid min-w-0 gap-4 px-5 py-4 sm:grid-cols-[minmax(0,1fr)_180px] sm:items-center"
                     >
diff --git a/apps/desktop/src/views/SettingsView/components/ModelPreferences/index.vue b/apps/desktop/src/views/SettingsView/components/ModelPreferences/index.vue
new file mode 100644
index 00000000..c4a2bc36
--- /dev/null
+++ b/apps/desktop/src/views/SettingsView/components/ModelPreferences/index.vue
@@ -0,0 +1,91 @@
+<script setup lang="ts">
+    import { useAlert } from '@composables/useAlert';
+    import { storeToRefs } from 'pinia';
+    import { onMounted, ref } from 'vue';
+
+    import { t } from '@/i18n';
+    import { useSettingsStore } from '@/stores/settings';
+
+    import ModelPreferences from '../General/components/ModelPreferences.vue';
+
+    defineOptions({
+        name: 'SettingsModelPreferencesSection',
+    });
+
+    const settingsStore = useSettingsStore();
+    const { settings } = storeToRefs(settingsStore);
+    const alert = useAlert();
+    const savingModelRoutingEnabled = ref(false);
+
+    async function saveModelRoutingEnabled(previousValue: boolean) {
+        if (savingModelRoutingEnabled.value) {
+            return;
+        }
+
+        savingModelRoutingEnabled.value = true;
+        try {
+            await settingsStore.updateAllowModelAutoSwitch(settings.value.allowModelAutoSwitch);
+            alert.success(t('common.saved'), 2000);
+        } catch (error) {
+            settings.value.allowModelAutoSwitch = previousValue;
+            console.error('Failed to save allow_model_auto_switch setting:', error);
+            alert.error(t('settings.general.modelPreferences.saveFailed'), 3000);
+        } finally {
+            savingModelRoutingEnabled.value = false;
+        }
+    }
+
+    function toggleModelRoutingEnabled() {
+        if (savingModelRoutingEnabled.value) {
+            return;
+        }
+
+        const previousValue = settings.value.allowModelAutoSwitch;
+        settings.value.allowModelAutoSwitch = !previousValue;
+        void saveModelRoutingEnabled(previousValue);
+    }
+
+    onMounted(() => {
+        void settingsStore.initialize();
+    });
+</script>
+
+<template>
+    <div class="settings-page" data-testid="settings-model-preferences-section">
+        <div class="settings-section-stack">
+            <header class="settings-page-header flex items-start gap-4">
+                <div class="max-w-2xl min-w-0">
+                    <h1 class="settings-page-title">
+                        {{ t('settings.nav.modelPreferences.label') }}
+                    </h1>
+                    <p class="settings-section-description">
+                        {{ t('settings.nav.modelPreferences.description') }}
+                    </p>
+                </div>
+                <button
+                    type="button"
+                    data-testid="settings-model-routing-enabled-toggle"
+                    :aria-label="t('settings.general.modelPreferences.enableRouting')"
+                    :aria-pressed="settings.allowModelAutoSwitch"
+                    :disabled="savingModelRoutingEnabled"
+                    :class="[
+                        'relative ml-auto inline-flex h-5 w-9 shrink-0 items-center rounded-full transition-colors',
+                        settings.allowModelAutoSwitch
+                            ? 'settings-toggle-enabled'
+                            : 'bg-neutral-200',
+                    ]"
+                    @click="toggleModelRoutingEnabled"
+                >
+                    <span
+                        :class="[
+                            'inline-block h-3.5 w-3.5 transform rounded-full bg-white transition-transform',
+                            settings.allowModelAutoSwitch ? 'translate-x-[18px]' : 'translate-x-1',
+                        ]"
+                    />
+                </button>
+            </header>
+
+            <ModelPreferences :routing-enabled="settings.allowModelAutoSwitch" />
+        </div>
+    </div>
+</template>
diff --git a/apps/desktop/src/views/SettingsView/index.vue b/apps/desktop/src/views/SettingsView/index.vue
index 39a329fd..ce46215f 100644
--- a/apps/desktop/src/views/SettingsView/index.vue
+++ b/apps/desktop/src/views/SettingsView/index.vue
@@ -26,6 +26,9 @@
     });
 
     const GeneralView = defineAsyncComponent(() => import('./components/General/index.vue'));
+    const ModelPreferencesView = defineAsyncComponent(
+        () => import('./components/ModelPreferences/index.vue')
+    );
     const AiServicesView = defineAsyncComponent(() => import('./components/AiServices/index.vue'));
     const BuiltInToolsView = defineAsyncComponent(
         () => import('./components/BuiltInTools/index.vue')
@@ -58,6 +61,11 @@
             component: AiServicesView,
             loadingKey: 'settings.loading.aiServices',
         },
+        'model-preferences': {
+            component: ModelPreferencesView,
+            loadingKey: 'settings.loading.modelPreferences',
+            scrollable: true,
+        },
         'built-in-tools': {
             component: BuiltInToolsView,
             loadingKey: 'settings.loading.builtInTools',
diff --git a/apps/desktop/src/views/SettingsView/settingsNavigation.ts b/apps/desktop/src/views/SettingsView/settingsNavigation.ts
index 013bb9bc..f8b4f8eb 100644
--- a/apps/desktop/src/views/SettingsView/settingsNavigation.ts
+++ b/apps/desktop/src/views/SettingsView/settingsNavigation.ts
@@ -5,6 +5,7 @@ import { JSON_SETTINGS_SECTIONS } from '@/stores/setting/sections/registry';
 
 export type NavigationSection =
     | 'general'
+    | 'model-preferences'
     | 'ai-services'
     | 'built-in-tools'
     | 'search'
@@ -64,10 +65,16 @@ const settingsNavigationDefinitions: SettingsNavigationGroupDefinition[] = [
         items: [
             {
                 id: 'ai-services',
-                icon: 'llm',
+                icon: 'cloud',
                 labelKey: 'settings.nav.aiServices.label',
                 descriptionKey: 'settings.nav.aiServices.description',
             },
+            {
+                id: 'model-preferences',
+                icon: 'route',
+                labelKey: 'settings.nav.modelPreferences.label',
+                descriptionKey: 'settings.nav.modelPreferences.description',
+            },
             {
                 id: 'built-in-tools',
                 icon: 'wrench',
diff --git a/apps/desktop/tests/SettingsView/ai-services-i18n.test.ts b/apps/desktop/tests/SettingsView/ai-services-i18n.test.ts
index 18fcdae7..a279d3df 100644
--- a/apps/desktop/tests/SettingsView/ai-services-i18n.test.ts
+++ b/apps/desktop/tests/SettingsView/ai-services-i18n.test.ts
@@ -188,19 +188,19 @@ describe('AiServices i18n and layout', () => {
         setLocale('zh-CN');
     });
 
-    it('renders provider list chrome and default badge in English with wrapping-safe classes', () => {
+    it('renders provider list chrome in English with wrapping-safe classes', () => {
         setLocale('en-US');
 
         const wrapper = mount(ProviderList, {
             props: {
                 providers: [createProvider({ is_builtin: 1 })],
                 selectedProviderId: 1,
-                defaultModelProviderIds: new Set([1]),
+                defaultModelProviderIds: new Set<number>(),
             },
         });
 
         expect(wrapper.text()).toContain('Add custom provider');
-        expect(wrapper.text()).toContain('Default');
+        expect(wrapper.text()).toContain('Built-in');
         expect(wrapper.text()).not.toContain('大模型服务');
 
         const addButton = wrapper.get('button');
@@ -314,7 +314,7 @@ describe('AiServices i18n and layout', () => {
             props: {
                 providers: [createProvider({ name: '服务商', is_builtin: 1 })],
                 selectedProviderId: 1,
-                defaultModelProviderIds: new Set([1]),
+                defaultModelProviderIds: new Set<number>(),
             },
             attachTo: document.body,
         });
@@ -322,7 +322,7 @@ describe('AiServices i18n and layout', () => {
         const localizer = createDomLocalizer(document.body);
         localizer.translateNow();
 
-        expect(wrapper.text()).toContain('Default');
+        expect(wrapper.text()).toContain('Built-in');
         expect(wrapper.get('.provider-card h3').text()).toBe('服务商');
         expect(wrapper.get('.provider-card h3').attributes('data-no-i18n')).toBe('true');
 
diff --git a/apps/desktop/tests/SettingsView/ai-services-section-i18n.test.ts b/apps/desktop/tests/SettingsView/ai-services-section-i18n.test.ts
index 44abbb77..b8069207 100644
--- a/apps/desktop/tests/SettingsView/ai-services-section-i18n.test.ts
+++ b/apps/desktop/tests/SettingsView/ai-services-section-i18n.test.ts
@@ -52,6 +52,9 @@ vi.mock('@database/queries', () => ({
     findAllProvidersSorted: vi.fn(async () => []),
     findDefaultModel: vi.fn(async () => null),
     findModelsWithProvider: vi.fn(async () => []),
+    findProviderById: vi.fn(async () => null),
+    getSettingValue: vi.fn(async () => null),
+    listModelPreferences: vi.fn(async () => []),
     setDefaultModel: vi.fn(),
     syncAllModelsMetadata: vi.fn(),
     updateModel: vi.fn(),
diff --git a/apps/desktop/tests/SettingsView/model-card-i18n.test.ts b/apps/desktop/tests/SettingsView/model-card-i18n.test.ts
index 306f3173..5909a63f 100644
--- a/apps/desktop/tests/SettingsView/model-card-i18n.test.ts
+++ b/apps/desktop/tests/SettingsView/model-card-i18n.test.ts
@@ -103,10 +103,8 @@ describe('ModelCard i18n', () => {
             },
         });
 
-        const defaultRadio = wrapper.get('input[type="radio"]');
         const buttons = wrapper.findAll('button');
 
-        expect(defaultRadio.attributes('title')).toBe('Enable this provider first');
         expect(buttons[0]?.attributes('title')).toBe('Edit');
         expect(buttons[1]?.attributes('title')).toBe('Delete');
 
diff --git a/apps/desktop/tests/SettingsView/navigation-sidebar-i18n.test.ts b/apps/desktop/tests/SettingsView/navigation-sidebar-i18n.test.ts
index b432e49c..656d2647 100644
--- a/apps/desktop/tests/SettingsView/navigation-sidebar-i18n.test.ts
+++ b/apps/desktop/tests/SettingsView/navigation-sidebar-i18n.test.ts
@@ -62,6 +62,7 @@ describe('Settings navigation sidebar i18n', () => {
         expect(flattenSettingsNavigation().map((item) => item.label)).toEqual([
             'General',
             'Providers and models',
+            'Model routing',
             'Built-in tools',
             'Search',
             'Browser Control',
diff --git a/apps/desktop/tests/services/AgentService/prompt/model-preferences.test.ts b/apps/desktop/tests/services/AgentService/prompt/model-preferences.test.ts
new file mode 100644
index 00000000..bbe0595b
--- /dev/null
+++ b/apps/desktop/tests/services/AgentService/prompt/model-preferences.test.ts
@@ -0,0 +1,130 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { buildModelPreferencesPrompt } from '@/services/AgentService/prompt/modelPreferences';
+
+const queries = vi.hoisted(() => ({
+    findModelRoleWithProvider: vi.fn(),
+    getSettingValue: vi.fn(),
+    listModelPreferences: vi.fn(),
+}));
+
+vi.mock('@database/queries', () => queries);
+
+function createModel(overrides = {}) {
+    return {
+        id: 1,
+        provider_id: 1,
+        model_id: 'model-a',
+        name: 'Model A',
+        provider_name: 'Provider A',
+        provider_enabled: 1,
+        ...overrides,
+    };
+}
+
+function createPreference(overrides = {}) {
+    return {
+        id: 1,
+        name: '前端开发',
+        description: 'React、Vue、CSS、Tailwind',
+        provider_id: 1,
+        model_id: 10,
+        priority: 0,
+        created_at: '',
+        updated_at: '',
+        model_name: 'Claude Sonnet',
+        model_api_id: 'claude-sonnet',
+        model_provider_id: 1,
+        provider_name: 'Anthropic',
+        provider_enabled: 1,
+        ...overrides,
+    };
+}
+
+describe('model preferences prompt', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        queries.getSettingValue.mockResolvedValue('true');
+        queries.findModelRoleWithProvider.mockImplementation((role: string) => {
+            if (role === 'entry') {
+                return Promise.resolve(createModel({ name: 'Default Model' }));
+            }
+            if (role === 'fast') {
+                return Promise.resolve(createModel({ name: 'Fast Model' }));
+            }
+            if (role === 'general') {
+                return Promise.resolve(createModel({ name: 'General Model' }));
+            }
+            return Promise.resolve(null);
+        });
+        queries.listModelPreferences.mockResolvedValue([createPreference()]);
+    });
+
+    it('injects model roles and usable scenario preferences', async () => {
+        const [prompt] = await buildModelPreferencesPrompt();
+
+        expect(prompt).toContain('## Model routing preferences');
+        expect(prompt).toContain('Default model');
+        expect(prompt).toContain('Fast model');
+        expect(prompt).toContain('General model');
+        expect(prompt).toContain('Provider A / Default Model');
+        expect(prompt).toContain('Provider A / Fast Model');
+        expect(prompt).toContain('Provider A / General Model');
+        expect(prompt).toContain(
+            '| 前端开发 | React、Vue、CSS、Tailwind | Anthropic / Claude Sonnet |'
+        );
+        expect(prompt).toContain('{ "scenario": "<Scenario>" }');
+        expect(prompt).not.toContain('{ "scenario": null }');
+    });
+
+    it('omits routing preferences when model routing is disabled', async () => {
+        queries.getSettingValue.mockResolvedValue('false');
+
+        const prompt = await buildModelPreferencesPrompt();
+
+        expect(prompt).toEqual([]);
+        expect(queries.listModelPreferences).not.toHaveBeenCalled();
+    });
+
+    it('omits unusable scenario preferences without failing prompt construction', async () => {
+        queries.listModelPreferences.mockResolvedValue([
+            createPreference({ model_id: null }),
+            createPreference({ name: '翻译', provider_enabled: 0 }),
+        ]);
+
+        const [prompt] = await buildModelPreferencesPrompt();
+
+        expect(prompt).toContain(
+            '| None configured | No custom scenario preferences are available. | - |'
+        );
+        expect(prompt).not.toContain('| 翻译 |');
+    });
+
+    it('escapes markdown table control characters in user-configured text', async () => {
+        queries.listModelPreferences.mockResolvedValue([
+            createPreference({
+                name: 'Frontend | UI',
+                description: 'React\\Vue\nCSS | Tailwind',
+                provider_name: 'Provider\\A',
+                model_name: 'Model | A',
+            }),
+        ]);
+
+        const [prompt] = await buildModelPreferencesPrompt();
+
+        expect(prompt).toContain(
+            '| Frontend \\| UI | React\\\\Vue CSS \\| Tailwind | Provider\\\\A / Model \\| A |'
+        );
+    });
+
+    it('falls back to an empty preference prompt when preference queries fail', async () => {
+        queries.listModelPreferences.mockRejectedValue(new Error('database unavailable'));
+
+        const [prompt] = await buildModelPreferencesPrompt();
+
+        expect(prompt).toContain('## Model routing preferences');
+        expect(prompt).toContain(
+            '| None configured | No custom scenario preferences are available. | - |'
+        );
+    });
+});
diff --git a/apps/desktop/tests/services/BuiltInToolService/tools/upgradeModel/i18n.test.ts b/apps/desktop/tests/services/BuiltInToolService/tools/upgradeModel/i18n.test.ts
index 7c675875..a7ab8634 100644
--- a/apps/desktop/tests/services/BuiltInToolService/tools/upgradeModel/i18n.test.ts
+++ b/apps/desktop/tests/services/BuiltInToolService/tools/upgradeModel/i18n.test.ts
@@ -12,12 +12,29 @@ import {
 } from '@/services/BuiltInToolService/tools/upgradeModel/chain';
 import type { BaseBuiltInToolExecutionContext } from '@/services/BuiltInToolService/types';
 
-const { findModelByProviderAndModelIdMock } = vi.hoisted(() => ({
+const {
+    findDefaultModelWithProviderMock,
+    findEffectiveModelRoleWithProviderMock,
+    findModelByIdWithProviderMock,
+    findModelByProviderAndModelIdMock,
+    findModelPreferenceByNameMock,
+    getSettingValueMock,
+} = vi.hoisted(() => ({
+    findDefaultModelWithProviderMock: vi.fn(),
+    findEffectiveModelRoleWithProviderMock: vi.fn(),
+    findModelByIdWithProviderMock: vi.fn(),
     findModelByProviderAndModelIdMock: vi.fn(),
+    findModelPreferenceByNameMock: vi.fn(),
+    getSettingValueMock: vi.fn(),
 }));
 
 vi.mock('@database/queries', () => ({
+    findDefaultModelWithProvider: findDefaultModelWithProviderMock,
+    findEffectiveModelRoleWithProvider: findEffectiveModelRoleWithProviderMock,
+    findModelByIdWithProvider: findModelByIdWithProviderMock,
     findModelByProviderAndModelId: findModelByProviderAndModelIdMock,
+    findModelPreferenceByName: findModelPreferenceByNameMock,
+    getSettingValue: getSettingValueMock,
 }));
 
 function createModel(overrides: Partial<ModelWithProvider>): ModelWithProvider {
@@ -65,9 +82,10 @@ describe('UpgradeModel i18n', () => {
     beforeEach(() => {
         setLocale('zh-CN');
         vi.clearAllMocks();
+        getSettingValueMock.mockResolvedValue('true');
     });
 
-    it('creates an English approval request for the resolved target model', async () => {
+    it('does not create an approval request for model routing switches', async () => {
         setLocale('en-US');
         const currentModel = createModel({
             id: 10,
@@ -76,17 +94,6 @@ describe('UpgradeModel i18n', () => {
             name: 'Model A',
             provider_name: 'Provider A',
         });
-        const targetModel = createModel({
-            id: 20,
-            provider_id: 2,
-            model_id: 'model-b',
-            name: 'Model B',
-            provider_name: 'Provider B',
-        });
-        findModelByProviderAndModelIdMock
-            .mockResolvedValueOnce(currentModel)
-            .mockResolvedValueOnce(targetModel);
-
         const approval = await buildUpgradeModelApprovalRequest(
             {},
             {
@@ -99,14 +106,21 @@ describe('UpgradeModel i18n', () => {
             createContext(currentModel)
         );
 
-        expect(approval).toMatchObject({
-            title: 'Confirm model switch',
-            description: 'Allow switching from Provider A / Model A to Provider B / Model B',
-            command: 'Provider A / Model A -> Provider B / Model B',
-            reason: 'This changes the model used by the current conversation and also affects the subsequent default model.',
-            approveLabel: 'Approve',
-            rejectLabel: 'Reject',
+        expect(approval).toBeNull();
+    });
+
+    it('does not emit a switch signal when model routing is disabled', async () => {
+        setLocale('en-US');
+        getSettingValueMock.mockResolvedValue('false');
+
+        const result = await executeUpgradeModelTool({}, { chain: [] }, createContext());
+
+        expect(result).toMatchObject({
+            isError: true,
+            status: 'error',
+            errorMessage: 'Model routing is disabled. Continuing with the default model.',
         });
+        expect(result.controlSignal).toBeUndefined();
     });
 
     it('formats reachable execute result strings in English while returning the model switch signal', async () => {
@@ -184,4 +198,133 @@ describe('UpgradeModel i18n', () => {
             'Each model upgrade chain item must include providerId and a non-empty modelId.'
         );
     });
+
+    it('switches to a configured scenario model without exposing provider details to the model', async () => {
+        setLocale('en-US');
+        const targetModel = createModel({
+            id: 20,
+            provider_id: 2,
+            model_id: 'claude-sonnet',
+            name: 'Claude Sonnet',
+            provider_name: 'Anthropic',
+        });
+        findModelPreferenceByNameMock.mockResolvedValue({
+            id: 1,
+            name: 'Frontend',
+            description: 'React and CSS work',
+            model_id: 20,
+        });
+        findModelByIdWithProviderMock.mockResolvedValue(targetModel);
+
+        const result = await executeUpgradeModelTool(
+            { scenario: 'Frontend' },
+            { chain: [] },
+            createContext(createModel({ id: 10 }))
+        );
+
+        expect(findModelPreferenceByNameMock).toHaveBeenCalledWith('Frontend');
+        expect(result).toMatchObject({
+            isError: false,
+            status: 'success',
+            controlSignal: {
+                type: 'upgrade_model',
+                targetModel,
+                restartCurrentRequest: false,
+            },
+        });
+        expect(result.result).toContain('Switched model for scenario: Frontend');
+        expect(result.result).toContain('Target model: Anthropic / Claude Sonnet');
+    });
+
+    it('does not request approval or emit a switch signal when the target is the current model', async () => {
+        setLocale('en-US');
+        const currentModel = createModel({
+            id: 20,
+            provider_id: 2,
+            model_id: 'claude-sonnet',
+            name: 'Claude Sonnet',
+            provider_name: 'Anthropic',
+        });
+        findModelPreferenceByNameMock.mockResolvedValue({
+            id: 1,
+            name: 'Frontend',
+            description: 'React and CSS work',
+            model_id: 20,
+        });
+        findModelByIdWithProviderMock.mockResolvedValue(currentModel);
+
+        const approval = await buildUpgradeModelApprovalRequest(
+            { scenario: 'Frontend' },
+            { chain: [] },
+            'builtin:upgrade_model',
+            createContext(currentModel)
+        );
+        const result = await executeUpgradeModelTool(
+            { scenario: 'Frontend' },
+            { chain: [] },
+            createContext(currentModel)
+        );
+
+        expect(approval).toBeNull();
+        expect(result).toMatchObject({
+            isError: false,
+            status: 'success',
+        });
+        expect(result.controlSignal).toBeUndefined();
+        expect(result.result).toContain('Model is already the target model');
+    });
+
+    it('skips approval when model routing is enabled', async () => {
+        setLocale('en-US');
+        getSettingValueMock.mockResolvedValueOnce('true');
+        const currentModel = createModel({
+            id: 10,
+            provider_id: 1,
+            model_id: 'model-a',
+            name: 'Model A',
+            provider_name: 'Provider A',
+        });
+        const targetModel = createModel({
+            id: 20,
+            provider_id: 2,
+            model_id: 'model-b',
+            name: 'Model B',
+            provider_name: 'Provider B',
+        });
+        findModelByProviderAndModelIdMock
+            .mockResolvedValueOnce(currentModel)
+            .mockResolvedValueOnce(targetModel);
+
+        const approval = await buildUpgradeModelApprovalRequest(
+            {},
+            {
+                chain: [
+                    { providerId: 1, modelId: 'model-a' },
+                    { providerId: 2, modelId: 'model-b' },
+                ],
+            },
+            'builtin:upgrade_model',
+            createContext(currentModel)
+        );
+
+        expect(approval).toBeNull();
+    });
+
+    it('rejects conflicting model switch target selectors', async () => {
+        setLocale('en-US');
+
+        const result = await executeUpgradeModelTool(
+            { role: 'fast', scenario: 'Frontend' },
+            { chain: [] },
+            createContext()
+        );
+
+        expect(result).toMatchObject({
+            isError: true,
+            status: 'error',
+            errorMessage: 'Specify only one model switch target at a time',
+        });
+        expect(findEffectiveModelRoleWithProviderMock).not.toHaveBeenCalled();
+        expect(findModelPreferenceByNameMock).not.toHaveBeenCalled();
+    });
 });
diff --git a/apps/desktop/tests/stores/setting.test.ts b/apps/desktop/tests/stores/setting.test.ts
index dfc96da4..c8b57b45 100644
--- a/apps/desktop/tests/stores/setting.test.ts
+++ b/apps/desktop/tests/stores/setting.test.ts
@@ -26,6 +26,7 @@ const EXPECTED_GENERAL_SETTING_KEYS: GeneralSettingKey[] = [
     'global_shortcut',
     'start_on_boot',
     'start_minimized',
+    'allow_model_auto_switch',
     'output_scroll_behavior',
     'search_window_size_preset',
     'language',
@@ -130,6 +131,7 @@ describe('setting registry', () => {
             'updateGlobalShortcut',
             'updateStartOnBoot',
             'updateStartMinimized',
+            'updateAllowModelAutoSwitch',
             'updateOutputScrollBehavior',
             'updateSearchWindowSizePreset',
             'updateLanguage',
diff --git a/apps/desktop/tests/views/SettingsView/settingsAiServicesLayout.test.ts b/apps/desktop/tests/views/SettingsView/settingsAiServicesLayout.test.ts
index 266bb26f..cebfa8ab 100644
--- a/apps/desktop/tests/views/SettingsView/settingsAiServicesLayout.test.ts
+++ b/apps/desktop/tests/views/SettingsView/settingsAiServicesLayout.test.ts
@@ -13,6 +13,8 @@ const queries = vi.hoisted(() => ({
     findDefaultModel: vi.fn(),
     findModelsWithProvider: vi.fn(),
     findProviderById: vi.fn(),
+    getSettingValue: vi.fn(),
+    listModelPreferences: vi.fn(),
     setDefaultModel: vi.fn(),
     syncAllModelsMetadata: vi.fn(),
     updateModel: vi.fn(),
@@ -106,6 +108,8 @@ describe('SettingsAiServicesSection', () => {
         });
         queries.findDefaultModel.mockResolvedValue(null);
         queries.findModelsWithProvider.mockResolvedValue([]);
+        queries.getSettingValue.mockResolvedValue(null);
+        queries.listModelPreferences.mockResolvedValue([]);
         modelMetadataMock.updateModelMetadata.mockResolvedValue(undefined);
     });
 
@@ -350,7 +354,7 @@ describe('SettingsAiServicesSection', () => {
         expect(alertMock.success).not.toHaveBeenCalled();
     });
 
-    it('patches the default model locally without provider list reload', async () => {
+    it('patches model edits locally without provider list reload', async () => {
         const provider = {
             id: 2,
             name: 'Custom Gateway',
@@ -403,11 +407,11 @@ describe('SettingsAiServicesSection', () => {
                     ProviderConfig: true,
                     ModelList: {
                         props: ['defaultModelId'],
-                        emits: ['set-default'],
+                        emits: ['update'],
                         template: `
                             <button
-                                data-testid="set-default-model"
-                                @click="$emit('set-default', 20)"
+                                data-testid="update-model"
+                                @click="$emit('update', 20, { name: 'Renamed Model' })"
                             >
                                 default: {{ defaultModelId }}
                             </button>
@@ -425,14 +429,95 @@ describe('SettingsAiServicesSection', () => {
 
         await flushPromises();
 
-        expect(wrapper.get('[data-testid="set-default-model"]').text()).toContain('default: 10');
+        expect(wrapper.get('[data-testid="update-model"]').text()).toContain('default: 10');
 
-        await wrapper.get('[data-testid="set-default-model"]').trigger('click');
+        await wrapper.get('[data-testid="update-model"]').trigger('click');
         await flushPromises();
 
-        expect(queries.setDefaultModel).toHaveBeenCalledWith({ modelId: 20 });
+        expect(queries.updateModel).toHaveBeenCalledWith({
+            id: 20,
+            modelPatch: { name: 'Renamed Model' },
+        });
         expect(queries.findAllProvidersSorted).toHaveBeenCalledTimes(1);
-        expect(alertMock.success).toHaveBeenCalledWith('设置成功');
-        expect(wrapper.get('[data-testid="set-default-model"]').text()).toContain('default: 20');
+        expect(alertMock.success).toHaveBeenCalledWith('保存成功');
+    });
+    it('blocks deleting models referenced by model routing', async () => {
+        const provider = {
+            id: 2,
+            name: 'Custom Gateway',
+            driver: 'openai',
+            api_endpoint: 'https://custom.example.com',
+            api_key: 'sk-demo',
+            config_json: null,
+            logo: 'openai.png',
+            enabled: 1,
+            is_builtin: 0,
+            created_at: '',
+            updated_at: '',
+        };
+        const defaultModel = {
+            id: 10,
+            provider_id: 2,
+            name: 'GPT 5 Mini',
+            model_id: 'gpt-5-mini',
+            is_default: 1,
+            last_used_at: null,
+            attachment: 0,
+            modalities: null,
+            open_weights: 0,
+            reasoning: 0,
+            release_date: null,
+            temperature: 1,
+            tool_call: 1,
+            knowledge: null,
+            context_limit: null,
+            output_limit: null,
+            is_custom_metadata: 0,
+            created_at: '',
+            updated_at: '',
+        };
+        const routedModel = {
+            ...defaultModel,
+            id: 20,
+            name: 'GPT 5',
+            model_id: 'gpt-5',
+            is_default: 0,
+        };
+        queries.findAllProvidersSorted.mockResolvedValue([provider]);
+        queries.findDefaultModel.mockResolvedValue(defaultModel);
+        queries.findModelsWithProvider.mockResolvedValue([defaultModel, routedModel]);
+        queries.getSettingValue.mockImplementation(({ key }: { key: string }) =>
+            Promise.resolve(key === 'model_role_fast_model_id' ? '20' : null)
+        );
+
+        const wrapper = mount(AiServicesSection, {
+            global: {
+                stubs: {
+                    ProviderList: true,
+                    ProviderConfig: true,
+                    ModelList: {
+                        emits: ['delete'],
+                        template: `
+                            <button data-testid="delete-routed-model" @click="$emit('delete', 20)">
+                                delete
+                            </button>
+                        `,
+                    },
+                    AddProviderDialog: true,
+                    EditProviderDialog: true,
+                    BadgedLogo: {
+                        props: ['logo', 'name'],
+                        template: '<div data-testid="badged-logo-stub" />',
+                    },
+                },
+            },
+        });
+
+        await flushPromises();
+        await wrapper.get('[data-testid="delete-routed-model"]').trigger('click');
+        await flushPromises();
+
+        expect(queries.deleteModel).not.toHaveBeenCalled();
+        expect(alertMock.error).toHaveBeenCalled();
     });
 });
diff --git a/apps/desktop/tests/views/SettingsView/settingsGeneralComponent.test.ts b/apps/desktop/tests/views/SettingsView/settingsGeneralComponent.test.ts
index 05b0bd40..1af1e576 100644
--- a/apps/desktop/tests/views/SettingsView/settingsGeneralComponent.test.ts
+++ b/apps/desktop/tests/views/SettingsView/settingsGeneralComponent.test.ts
@@ -14,6 +14,7 @@ const settingsStoreMock = vi.hoisted(() => ({
             outputScrollBehavior: 'follow_output',
             searchWindowSizePreset: 'normal',
             searchWindowDefaultSize: { width: 720, height: 520 },
+            allowModelAutoSwitch: false,
             appUpdateChannel: 'stable',
             appUpdateAutoCheck: true,
             appUpdateLastCheckedAt: null,
@@ -25,6 +26,7 @@ const settingsStoreMock = vi.hoisted(() => ({
     updateStartMinimized: vi.fn().mockResolvedValue(undefined),
     updateOutputScrollBehavior: vi.fn().mockResolvedValue(undefined),
     updateSearchWindowSizePreset: vi.fn().mockResolvedValue(undefined),
+    updateAllowModelAutoSwitch: vi.fn().mockResolvedValue(undefined),
     updateLanguage: vi.fn().mockResolvedValue(undefined),
     updateAppUpdateChannel: vi.fn().mockResolvedValue(undefined),
     updateAppUpdateAutoCheck: vi.fn().mockResolvedValue(undefined),
@@ -152,6 +154,8 @@ describe('SettingsGeneralSection', () => {
         appUpdateServiceMock.state = appUpdateServiceMock.createState();
         nativeMock.shortcut.getShortcutStatus.mockResolvedValue([false, null]);
         nativeMock.autostart.isAutostartEnabled.mockResolvedValue(false);
+        settingsStoreMock.settings.value.allowModelAutoSwitch = false;
+        settingsStoreMock.updateAllowModelAutoSwitch.mockResolvedValue(undefined);
     });
 
     it('renders the general settings groups and row controls', () => {
diff --git a/eslint.config.js b/eslint.config.js
index 4c733c6c..26dd29c0 100644
--- a/eslint.config.js
+++ b/eslint.config.js
@@ -66,6 +66,10 @@ export default defineConfig([
         '.coverage/**',
         '**/.coverage',
         '**/.coverage/**',
+        '.vite-cache',
+        '.vite-cache/**',
+        '**/.vite-cache',
+        '**/.vite-cache/**',
         'src-tauri',
         'src-tauri/**',
         '**/src-tauri',