From 5cc3a9236f09aad076ecae37cde90493363ee0db Mon Sep 17 00:00:00 2001
From: KagurazakaSakuya <2471012170@qq.com>
Date: Sat, 30 May 2026 19:59:39 +0900
Subject: [PATCH 1/6] feat: add model preferences

---
 .prettierignore                               |   2 +
 .../src-tauri/resources/rtk/manifest.json     |   1 +
 apps/desktop/src/components/AlertMessage.vue  |  37 +-
 apps/desktop/src/components/appIconMap.ts     |   4 +
 .../drizzle/0002_model_preferences.sql        |  20 +
 .../src/database/drizzle/meta/_journal.json   |   7 +
 apps/desktop/src/database/queries/models.ts   | 190 +++++++-
 apps/desktop/src/database/schema.ts           |  32 ++
 apps/desktop/src/database/types/index.ts      |  31 ++
 apps/desktop/src/i18n/messages.ts             | 127 +++++-
 .../services/AgentService/prompt/composer.ts  |   7 +-
 .../AgentService/prompt/modelPreferences.ts   | 100 +++++
 .../tools/upgradeModel/constants.ts           |  30 +-
 .../tools/upgradeModel/helper.ts              |  10 +-
 .../tools/upgradeModel/index.ts               | 215 ++++++++-
 .../src/services/EventService/types.ts        |   1 +
 apps/desktop/src/stores/settings.ts           |  22 +
 .../AiServices/components/ModelCard.vue       |  26 +-
 .../AiServices/components/ModelGroup.vue      |  13 +-
 .../AiServices/components/ModelList.vue       |  32 +-
 .../AiServices/components/ProviderCard.vue    |  10 +-
 .../AiServices/components/ProviderList.vue    |   4 -
 .../components/AiServices/index.vue           |  90 ++--
 .../components/ModelPreferenceDialog.vue      | 425 ++++++++++++++++++
 .../General/components/ModelPreferences.vue   | 386 ++++++++++++++++
 .../SettingsView/components/General/index.vue |  58 ++-
 .../components/ModelPreferences/index.vue     |  15 +
 apps/desktop/src/views/SettingsView/index.vue |  22 +
 .../views/SettingsView/settingsNavigation.ts  |   9 +-
 .../SettingsView/ai-services-i18n.test.ts     |  12 +-
 .../SettingsView/model-card-i18n.test.ts      |  14 +-
 .../navigation-sidebar-i18n.test.ts           |   1 +
 .../prompt/model-preferences.test.ts          | 118 +++++
 .../tools/upgradeModel/i18n.test.ts           | 149 +++++-
 .../SettingsView/modelGroupBehavior.test.ts   |  15 +-
 .../SettingsView/modelListEmptyState.test.ts  |   2 +-
 .../settingsAiServicesLayout.test.ts          |  24 +-
 .../settingsGeneralComponent.test.ts          |  22 +-
 .../SettingsView/settingsNavigation.test.ts   |   5 +
 eslint.config.js                              |   4 +
 40 files changed, 2107 insertions(+), 185 deletions(-)
 create mode 100644 apps/desktop/src/database/drizzle/0002_model_preferences.sql
 create mode 100644 apps/desktop/src/services/AgentService/prompt/modelPreferences.ts
 create mode 100644 apps/desktop/src/views/SettingsView/components/General/components/ModelPreferenceDialog.vue
 create mode 100644 apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue
 create mode 100644 apps/desktop/src/views/SettingsView/components/ModelPreferences/index.vue
 create mode 100644 apps/desktop/tests/services/AgentService/prompt/model-preferences.test.ts

diff --git a/.prettierignore b/.prettierignore
index 5b8b2f5b..432a4ef0 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-tauri/resources/rtk/manifest.json b/apps/desktop/src-tauri/resources/rtk/manifest.json
index 4b3a12ff..390c2781 100644
--- a/apps/desktop/src-tauri/resources/rtk/manifest.json
+++ b/apps/desktop/src-tauri/resources/rtk/manifest.json
@@ -5,6 +5,7 @@
         "x86_64-pc-windows-msvc": {
             "size": 3884282,
             "digest": "7fc90190f76f55dc170898d0ac755e89f405fc2d1d89f717ad8600640ab0f1ed",
+            "binary_digest": "3f8786f4bc120a10dd83728d4e481e74460fede13e811c9d8849098a48d0b33e",
             "format": "zip",
             "archivePath": "rtk.exe",
             "url": "https://github.com/rtk-ai/rtk/releases/download/v0.40.0/rtk-x86_64-pc-windows-msvc.zip"
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/appIconMap.ts b/apps/desktop/src/components/appIconMap.ts
index e4a988ec..b73ce039 100644
--- a/apps/desktop/src/components/appIconMap.ts
+++ b/apps/desktop/src/components/appIconMap.ts
@@ -8,6 +8,7 @@ import IconCheckCircle from '~icons/bx/check-circle';
 import IconChevronDown from '~icons/bx/chevron-down';
 import IconChevronRight from '~icons/bx/chevron-right';
 import IconChevronUp from '~icons/bx/chevron-up';
+import IconCloud from '~icons/bx/cloud';
 import IconCog from '~icons/bx/cog';
 import IconCopy from '~icons/bx/copy';
 import IconData from '~icons/bx/data';
@@ -37,6 +38,7 @@ import IconShow from '~icons/bx/show';
 import IconStop from '~icons/bx/stop';
 import IconTrash from '~icons/bx/trash';
 import IconTrashAlt from '~icons/bx/trash-alt';
+import IconRoute from '~icons/bx/trip';
 import IconWrench from '~icons/bx/wrench';
 import IconX from '~icons/bx/x';
 import IconXCircle from '~icons/bx/x-circle';
@@ -48,6 +50,7 @@ export const appIconMap = {
     'chevron-right': IconChevronRight,
     'chevron-up': IconChevronUp,
     close: IconX,
+    cloud: IconCloud,
     copy: IconCopy,
     database: IconData,
     delete: IconTrashAlt,
@@ -73,6 +76,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/0002_model_preferences.sql b/apps/desktop/src/database/drizzle/0002_model_preferences.sql
new file mode 100644
index 00000000..6a2cc531
--- /dev/null
+++ b/apps/desktop/src/database/drizzle/0002_model_preferences.sql
@@ -0,0 +1,20 @@
+CREATE TABLE `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 `model_preferences_priority_idx` ON `model_preferences` (`priority`);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `model_preferences_name_unique` ON `model_preferences` (`name`);
+--> statement-breakpoint
+CREATE INDEX `model_preferences_model_id_idx` ON `model_preferences` (`model_id`);
+--> statement-breakpoint
+CREATE INDEX `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 d115892e..01a7ae2c 100644
--- a/apps/desktop/src/database/drizzle/meta/_journal.json
+++ b/apps/desktop/src/database/drizzle/meta/_journal.json
@@ -15,6 +15,13 @@
       "when": 1778889600000,
       "tag": "0001_silent_reasoning",
       "breakpoints": true
+    },
+    {
+      "idx": 2,
+      "version": "7",
+      "when": 1780051200000,
+      "tag": "0002_model_preferences",
+      "breakpoints": true
     }
   ]
 }
diff --git a/apps/desktop/src/database/queries/models.ts b/apps/desktop/src/database/queries/models.ts
index 67f34e1a..b411ae47 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('Entry 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 0c298c3e..18c1eb26 100644
--- a/apps/desktop/src/database/schema.ts
+++ b/apps/desktop/src/database/schema.ts
@@ -290,6 +290,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',
     {
@@ -584,6 +612,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 a8299e8f..1f1780d5 100644
--- a/apps/desktop/src/database/types/index.ts
+++ b/apps/desktop/src/database/types/index.ts
@@ -253,6 +253,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 8e0a2ce7..69857845 100644
--- a/apps/desktop/src/i18n/messages.ts
+++ b/apps/desktop/src/i18n/messages.ts
@@ -120,6 +120,8 @@ 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': '版本更新通道',
@@ -151,6 +153,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.mcpTools': '正在加载 MCP 工具...',
@@ -158,8 +161,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.mcpTools.label': 'MCP 工具',
@@ -238,6 +243,7 @@ const zhCNMessages = {
     'settings.ai.cannotDeleteProviderWithDefaultModel':
         '无法删除包含默认模型的服务商，请先设置其他模型为默认',
     'settings.ai.providerNeedsApiKeyForModels': '该服务商需要配置 API Key 才能获取模型列表',
+    'settings.ai.providerInvalidApiKeyForModels': 'API Key 无效，请检查该服务商的密钥后重试',
     'settings.ai.noModelsFetched': '未获取到模型列表',
     'settings.ai.refreshModelsSucceeded': '刷新成功，新增 {count} 个模型',
     'settings.ai.refreshModelsFailed': '获取模型列表失败：{error}',
@@ -273,6 +279,44 @@ const zhCNMessages = {
     'settings.ai.fetchingModels': '获取中...',
     'settings.ai.fetchModels': '获取模型列表',
     'settings.ai.addManually': '手动添加',
+    'settings.general.modelPreferences.title': '模型设置',
+    'settings.general.modelPreferences.description':
+        '配置入口、快速和通用模型。入口模型会根据任务调用模型切换工具。',
+    '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': '数据统计',
@@ -558,6 +602,19 @@ 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.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 工作区。',
@@ -836,6 +893,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': 'Allow automatic model switching',
+    'settings.general.allowModelAutoSwitchDescription':
+        'When enabled, the model switch tool will not ask for confirmation.',
     'settings.general.update.channelTitle': 'Version updates',
     'settings.general.update.channelDescription': 'Choose the update frequency that fits you',
     'settings.general.update.channelRowLabel': 'Version update channel',
@@ -871,6 +931,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 settings...',
     'settings.loading.aiServices': 'Loading model service settings...',
     'settings.loading.builtInTools': 'Loading built-in tools...',
     'settings.loading.mcpTools': 'Loading MCP tools...',
@@ -878,8 +939,10 @@ 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 settings',
+    'settings.nav.modelPreferences.description': 'Entry, fast, general, and scenario models',
     '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.mcpTools.label': 'MCP tools',
@@ -961,6 +1024,8 @@ const enUSMessages: Record<keyof typeof zhCNMessages, string> = {
         'Cannot delete a provider that contains the default model. Set another model as default 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}',
@@ -1001,6 +1066,47 @@ 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 settings',
+    'settings.general.modelPreferences.description':
+        'Configure entry, fast, and general models. The entry model can call the model switch tool based on the task.',
+    'settings.general.modelPreferences.scenarioPreferencesTitle': 'Scenario preferences',
+    'settings.general.modelPreferences.scenarioPreferencesDescription':
+        'Configure models for specific scenarios. The entry model switches when a task matches.',
+    'settings.general.modelPreferences.entryModel': 'Entry model',
+    'settings.general.modelPreferences.entryModelDescription':
+        'Receives requests 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 complex tasks without a scenario match.',
+    'settings.general.modelPreferences.selectEntryModel': 'Select entry model',
+    'settings.general.modelPreferences.useEntryModel': 'Not set',
+    'settings.general.modelPreferences.entryModelRequired': 'Select an entry model',
+    'settings.general.modelPreferences.cannotDeleteEntryModel':
+        'Cannot delete the entry model. Select another entry model in General settings first.',
+    'settings.general.modelPreferences.groupContainsEntryModel':
+        'This group contains the entry model and cannot be deleted in bulk.',
+    'settings.general.modelPreferences.cannotDisableProviderWithEntryModel':
+        'Cannot disable a provider that contains the entry model. Select another entry model in General settings first.',
+    'settings.general.modelPreferences.cannotDeleteProviderWithEntryModel':
+        'Cannot delete a provider that contains the entry model. Select another entry model in General settings 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 settings',
+    'settings.general.modelPreferences.saveFailed': 'Failed to save model settings',
     'settings.dataManagement.title': 'Data management',
     'settings.dataManagement.description': 'Manage application data and settings backups',
     'settings.dataManagement.stats': 'Data statistics',
@@ -1303,6 +1409,23 @@ 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': 'Entry 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.restoredEntry': 'Restored entry 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..1ca740b3
--- /dev/null
+++ b/apps/desktop/src/services/AgentService/prompt/modelPreferences.ts
@@ -0,0 +1,100 @@
+// Copyright (c) 2026. Qian Cheng. Licensed under GPL v3
+
+import { findModelRoleWithProvider, 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))} |`;
+}
+
+export async function buildModelPreferencesPrompt(): Promise<string[]> {
+    const [preferences, entryModel, 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',
+            'Entry model',
+            'Every user request starts here. It decides whether to answer directly or switch models.',
+            formatRoleModelLabel(entryModel),
+        ],
+        [
+            'fast',
+            'Fast model',
+            'Simple questions and lightweight utility work such as brief answers or session naming. Falls back to the entry model when not configured.',
+            formatRoleModelLabel(fastModel ?? entryModel),
+        ],
+        [
+            'general',
+            'General model',
+            'Complex tasks that do not clearly match a custom scenario preference. Falls back to the entry model when not configured.',
+            formatRoleModelLabel(generalModel ?? entryModel),
+        ],
+    ];
+
+    return [
+        [
+            '## Model routing preferences',
+            '',
+            'The current model is the entry model. Every user request starts here, 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 }`, `{ "role": "entry" }`, or `{ "scenario": null }` to return to the entry 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 entry 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..9903070e 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 entry 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 entry model.',
+        },
+        scenario: {
+            type: ['string', 'null'],
+            minLength: 1,
+            pattern: '\\S',
+            description:
+                'Optional scenario name from the configured model preferences. Use null to restore the entry model.',
+        },
+        restore: {
+            type: 'boolean',
+            description: 'Set true to switch back to the entry 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 3c38ec80..4b823f5d 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 {
@@ -36,6 +43,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 allowsAutomaticModelSwitch(): Promise<boolean> {
+    try {
+        return (await getSettingValue({ key: 'allow_model_auto_switch' })) === 'true';
+    } catch (error) {
+        console.warn('[UpgradeModel] Failed to read allow_model_auto_switch setting:', error);
+        return false;
+    }
+}
+
 async function resolveChainTargets(
     chainEntries: UpgradeModelChainEntry[]
 ): Promise<ResolvedUpgradeTarget[]> {
@@ -128,6 +161,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',
@@ -135,6 +276,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 工具参数。
@@ -152,8 +326,15 @@ export async function buildUpgradeModelApprovalRequest(
     void namespacedName;
 
     try {
-        parseUpgradeModelArgs(args);
-        const { target } = await resolveUpgradeTarget(context.currentModel, config);
+        const { target } = await resolveModelSwitchTarget(args, context.currentModel, config);
+
+        if (isSameModel(context.currentModel, target.model)) {
+            return null;
+        }
+
+        if (await allowsAutomaticModelSwitch()) {
+            return null;
+        }
 
         // 审批阶段只负责把即将发生的模型切换说清楚。
         // 真正的切换由 execute 返回 controlSignal 后再由上层统一落地，避免审批阶段产生副作用。
@@ -194,14 +375,32 @@ export async function executeUpgradeModelTool(
     void context.signal;
 
     try {
-        const { chainEntries, target } = await resolveUpgradeTarget(context.currentModel, config);
+        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,
@@ -253,7 +452,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/services/EventService/types.ts b/apps/desktop/src/services/EventService/types.ts
index 36558d81..da88af16 100644
--- a/apps/desktop/src/services/EventService/types.ts
+++ b/apps/desktop/src/services/EventService/types.ts
@@ -74,6 +74,7 @@ export type GeneralSettingKey =
     | 'global_shortcut'
     | 'start_on_boot'
     | 'start_minimized'
+    | 'allow_model_auto_switch'
     | 'output_scroll_behavior'
     | 'search_window_size_preset'
     | 'language'
diff --git a/apps/desktop/src/stores/settings.ts b/apps/desktop/src/stores/settings.ts
index 27240ead..99b3a4ca 100644
--- a/apps/desktop/src/stores/settings.ts
+++ b/apps/desktop/src/stores/settings.ts
@@ -28,6 +28,7 @@ export interface GeneralSettingsData {
     globalShortcut: string;
     startOnBoot: boolean;
     startMinimized: boolean;
+    allowModelAutoSwitch: boolean;
     outputScrollBehavior: OutputScrollBehavior;
     searchWindowSizePreset: SearchWindowSizePreset;
     searchWindowDefaultSize: SearchWindowDefaultSize;
@@ -41,6 +42,7 @@ const DEFAULT_GENERAL_SETTINGS: GeneralSettingsData = {
     globalShortcut: 'Alt+Space',
     startOnBoot: false,
     startMinimized: true,
+    allowModelAutoSwitch: false,
     outputScrollBehavior: 'follow_output',
     searchWindowSizePreset: DEFAULT_SEARCH_WINDOW_SIZE_PRESET,
     searchWindowDefaultSize: resolveSearchWindowDefaultSize(DEFAULT_SEARCH_WINDOW_SIZE_PRESET),
@@ -127,6 +129,10 @@ export const useSettingsStore = defineStore('settings', () => {
                 settings.value.startMinimized =
                     typeof value === 'boolean' ? value : String(value) === 'true';
                 break;
+            case 'allow_model_auto_switch':
+                settings.value.allowModelAutoSwitch =
+                    typeof value === 'boolean' ? value : String(value) === 'true';
+                break;
             case 'output_scroll_behavior':
                 settings.value.outputScrollBehavior = normalizeOutputScrollBehavior(String(value));
                 break;
@@ -159,6 +165,8 @@ export const useSettingsStore = defineStore('settings', () => {
                 return String(settings.value.startOnBoot);
             case 'start_minimized':
                 return String(settings.value.startMinimized);
+            case 'allow_model_auto_switch':
+                return String(settings.value.allowModelAutoSwitch);
             case 'output_scroll_behavior':
                 return settings.value.outputScrollBehavior;
             case 'search_window_size_preset':
@@ -184,6 +192,8 @@ export const useSettingsStore = defineStore('settings', () => {
                 return settings.value.startOnBoot;
             case 'start_minimized':
                 return settings.value.startMinimized;
+            case 'allow_model_auto_switch':
+                return settings.value.allowModelAutoSwitch;
             case 'output_scroll_behavior':
                 return settings.value.outputScrollBehavior;
             case 'search_window_size_preset':
@@ -215,6 +225,7 @@ export const useSettingsStore = defineStore('settings', () => {
                 globalShortcut,
                 startOnBoot,
                 startMinimized,
+                allowModelAutoSwitch,
                 outputScroll,
                 searchWindowSizePreset,
                 language,
@@ -225,6 +236,7 @@ export const useSettingsStore = defineStore('settings', () => {
                 getSettingValue({ key: 'global_shortcut' }),
                 getSettingValue({ key: 'start_on_boot' }),
                 getSettingValue({ key: 'start_minimized' }),
+                getSettingValue({ key: 'allow_model_auto_switch' }),
                 getSettingValue({ key: 'output_scroll_behavior' }),
                 getSettingValue({ key: 'search_window_size_preset' }),
                 getSettingValue({ key: 'language' }),
@@ -243,6 +255,10 @@ export const useSettingsStore = defineStore('settings', () => {
                 startMinimized === null
                     ? DEFAULT_GENERAL_SETTINGS.startMinimized
                     : startMinimized === 'true';
+            settings.value.allowModelAutoSwitch =
+                allowModelAutoSwitch === null
+                    ? DEFAULT_GENERAL_SETTINGS.allowModelAutoSwitch
+                    : allowModelAutoSwitch === 'true';
             settings.value.outputScrollBehavior = normalizeOutputScrollBehavior(outputScroll);
             applySearchWindowSizePreset(normalizeSearchWindowSizePreset(searchWindowSizePreset));
             applyLanguage(resolvePersistedLanguage(language));
@@ -257,6 +273,7 @@ export const useSettingsStore = defineStore('settings', () => {
                 persistDefaultIfMissing('global_shortcut', globalShortcut),
                 persistDefaultIfMissing('start_on_boot', startOnBoot),
                 persistDefaultIfMissing('start_minimized', startMinimized),
+                persistDefaultIfMissing('allow_model_auto_switch', allowModelAutoSwitch),
                 persistDefaultIfMissing('output_scroll_behavior', outputScroll),
                 persistDefaultIfMissing('search_window_size_preset', searchWindowSizePreset),
                 persistDefaultIfMissing('language', language),
@@ -365,6 +382,10 @@ export const useSettingsStore = defineStore('settings', () => {
         await updateSetting('start_minimized', enabled);
     }
 
+    async function updateAllowModelAutoSwitch(enabled: boolean) {
+        await updateSetting('allow_model_auto_switch', enabled);
+    }
+
     async function updateOutputScrollBehavior(mode: OutputScrollBehavior) {
         await updateSetting('output_scroll_behavior', mode);
     }
@@ -416,6 +437,7 @@ export const useSettingsStore = defineStore('settings', () => {
         updateGlobalShortcut,
         updateStartOnBoot,
         updateStartMinimized,
+        updateAllowModelAutoSwitch,
         updateOutputScrollBehavior,
         updateSearchWindowSizePreset,
         updateLanguage,
diff --git a/apps/desktop/src/views/SettingsView/components/AiServices/components/ModelCard.vue b/apps/desktop/src/views/SettingsView/components/AiServices/components/ModelCard.vue
index 66fd0ce5..d94c872f 100644
--- a/apps/desktop/src/views/SettingsView/components/AiServices/components/ModelCard.vue
+++ b/apps/desktop/src/views/SettingsView/components/AiServices/components/ModelCard.vue
@@ -12,14 +12,13 @@
     import { formatDateTime } from '@/i18n/format';
     interface Props {
         model: Model;
-        isDefault: boolean;
+        isEntryModel: boolean;
         providerEnabled: boolean;
     }
 
     interface Emits {
         (e: 'update', data: Partial<Model>): void;
         (e: 'delete'): void;
-        (e: 'set-default'): void;
         (e: 'edit'): void;
     }
 
@@ -30,8 +29,8 @@
     const { confirm } = useConfirm();
 
     const handleDelete = async () => {
-        if (props.isDefault) {
-            alert.error(t('settings.ai.cannotDeleteDefaultModel'));
+        if (props.isEntryModel) {
+            alert.error(t('settings.general.modelPreferences.cannotDeleteEntryModel'));
             return;
         }
 
@@ -53,25 +52,6 @@
     <div class="rounded-lg border border-neutral-200 bg-white p-4">
         <div class="flex items-center gap-3">
             <div class="relative">
-                <input
-                    type="radio"
-                    name="default-model"
-                    :checked="isDefault"
-                    :disabled="!providerEnabled"
-                    :class="[
-                        'mt-1 h-4 w-4 text-neutral-950',
-                        !providerEnabled ? 'cursor-not-allowed opacity-50' : 'cursor-pointer',
-                    ]"
-                    :title="
-                        !providerEnabled
-                            ? t('settings.ai.enableProviderFirst')
-                            : t('settings.ai.setDefaultModel')
-                    "
-                    @change="emit('set-default')"
-                />
-            </div>
-
-            <div :class="['relative', isDefault ? 'rounded-full border-2 border-neutral-950' : '']">
                 <ModelLogo :model-id="model.model_id" :name="model.name" />
             </div>
 
diff --git a/apps/desktop/src/views/SettingsView/components/AiServices/components/ModelGroup.vue b/apps/desktop/src/views/SettingsView/components/AiServices/components/ModelGroup.vue
index 9c1fb814..aa557bd1 100644
--- a/apps/desktop/src/views/SettingsView/components/AiServices/components/ModelGroup.vue
+++ b/apps/desktop/src/views/SettingsView/components/AiServices/components/ModelGroup.vue
@@ -17,7 +17,7 @@
 
     interface Props {
         group: ModelGroup;
-        defaultModelId: number | null;
+        entryModelId: number | null;
         providerEnabled: boolean;
     }
 
@@ -25,7 +25,6 @@
         (e: 'update', id: number, data: Partial<Model>): void;
         (e: 'delete', id: number): void;
         (e: 'delete-group', groupKey: string): void;
-        (e: 'set-default', id: number): void;
         (e: 'edit', model: Model): void;
     }
 
@@ -42,13 +41,12 @@
 
     const handleDeleteGroup = async (groupKey: string, models: Model[]) => {
         // 检查分组内是否有默认模型
-        const hasDefaultModel = models.some((model) => model.id === props.defaultModelId);
+        const hasEntryModel = models.some((model) => model.id === props.entryModelId);
 
-        if (hasDefaultModel) {
-            // 如果分组内有默认模型，不允许删除
+        if (hasEntryModel) {
             const { useAlert } = await import('@composables/useAlert');
             const { warning } = useAlert();
-            warning(t('settings.ai.groupContainsDefaultModel'));
+            warning(t('settings.general.modelPreferences.groupContainsEntryModel'));
             return;
         }
 
@@ -107,11 +105,10 @@
                 v-for="model in group.models"
                 :key="model.id"
                 :model="model"
-                :is-default="model.id === defaultModelId"
+                :is-entry-model="model.id === entryModelId"
                 :provider-enabled="providerEnabled"
                 @update="(data) => emit('update', model.id, data)"
                 @delete="emit('delete', model.id)"
-                @set-default="emit('set-default', model.id)"
                 @edit="emit('edit', model)"
             />
         </div>
diff --git a/apps/desktop/src/views/SettingsView/components/AiServices/components/ModelList.vue b/apps/desktop/src/views/SettingsView/components/AiServices/components/ModelList.vue
index 3e37eef5..dcdb7ce6 100644
--- a/apps/desktop/src/views/SettingsView/components/AiServices/components/ModelList.vue
+++ b/apps/desktop/src/views/SettingsView/components/AiServices/components/ModelList.vue
@@ -14,7 +14,7 @@
     interface Props {
         providerId: number;
         models: Model[];
-        defaultModelId: number | null;
+        entryModelId: number | null;
         provider: Provider | undefined;
         providerEnabled: boolean;
         refreshing?: boolean;
@@ -24,7 +24,6 @@
         (e: 'create', data: NewModel): void;
         (e: 'update', id: number, data: Partial<Model>): void;
         (e: 'delete', id: number, silent?: boolean): void;
-        (e: 'set-default', id: number): void;
         (e: 'refresh'): void;
         (e: 'refreshing', value: boolean): void;
     }
@@ -57,9 +56,9 @@
         return groupKey;
     }
 
-    function groupModels(models: Model[], defaultModelId?: number | null): ModelGroupData[] {
+    function groupModels(models: Model[], entryModelId?: number | null): ModelGroupData[] {
         const groupMap = new Map<string, Model[]>();
-        let defaultModelGroupKey: string | null = null;
+        let entryModelGroupKey: string | null = null;
 
         for (const model of models) {
             const groupKey = extractGroupKey(model.model_id);
@@ -70,8 +69,8 @@
 
             groupMap.get(groupKey)!.push(model);
 
-            if (defaultModelId && model.id === defaultModelId) {
-                defaultModelGroupKey = groupKey;
+            if (entryModelId && model.id === entryModelId) {
+                entryModelGroupKey = groupKey;
             }
         }
 
@@ -79,8 +78,8 @@
 
         for (const [groupKey, groupModels] of groupMap.entries()) {
             const sortedModels = [...groupModels].sort((a, b) => {
-                if (defaultModelId && a.id === defaultModelId) return -1;
-                if (defaultModelId && b.id === defaultModelId) return 1;
+                if (entryModelId && a.id === entryModelId) return -1;
+                if (entryModelId && b.id === entryModelId) return 1;
                 return a.model_id.localeCompare(b.model_id);
             });
 
@@ -109,8 +108,8 @@
                 const allModels = groupsWithSameBase.flatMap((g) => g.models);
 
                 const sortedModels = allModels.sort((a, b) => {
-                    if (defaultModelId && a.id === defaultModelId) return -1;
-                    if (defaultModelId && b.id === defaultModelId) return 1;
+                    if (entryModelId && a.id === entryModelId) return -1;
+                    if (entryModelId && b.id === entryModelId) return 1;
                     return a.model_id.localeCompare(b.model_id);
                 });
 
@@ -120,8 +119,8 @@
                     models: sortedModels,
                 });
 
-                if (allModels.some((m) => m.id === defaultModelId)) {
-                    defaultModelGroupKey = baseKey;
+                if (allModels.some((m) => m.id === entryModelId)) {
+                    entryModelGroupKey = baseKey;
                 }
             } else {
                 const singleGroup = groupsWithSameBase[0];
@@ -134,8 +133,8 @@
         const finalGroups = [...multiModelGroups, ...mergedGroups];
 
         finalGroups.sort((a, b) => {
-            if (a.groupKey === defaultModelGroupKey) return -1;
-            if (b.groupKey === defaultModelGroupKey) return 1;
+            if (a.groupKey === entryModelGroupKey) return -1;
+            if (b.groupKey === entryModelGroupKey) return 1;
             return a.groupName.localeCompare(b.groupName);
         });
 
@@ -174,7 +173,7 @@
             );
         }
 
-        return groupModels(filteredModels, props.defaultModelId);
+        return groupModels(filteredModels, props.entryModelId);
     });
 
     const startCreate = () => {
@@ -317,12 +316,11 @@
                 v-for="(group, index) in modelGroups"
                 :key="provider?.id + group.groupKey + index"
                 :group="group"
-                :default-model-id="defaultModelId"
+                :entry-model-id="entryModelId"
                 :provider-enabled="providerEnabled"
                 @update="(id, data) => emit('update', id, data)"
                 @delete="(id) => emit('delete', id)"
                 @delete-group="handleDeleteGroup"
-                @set-default="(id: number) => emit('set-default', id)"
                 @edit="handleEdit"
             />
         </div>
diff --git a/apps/desktop/src/views/SettingsView/components/AiServices/components/ProviderCard.vue b/apps/desktop/src/views/SettingsView/components/AiServices/components/ProviderCard.vue
index 0c2cb0be..0f2fb86a 100644
--- a/apps/desktop/src/views/SettingsView/components/AiServices/components/ProviderCard.vue
+++ b/apps/desktop/src/views/SettingsView/components/AiServices/components/ProviderCard.vue
@@ -10,7 +10,6 @@
     interface Props {
         provider: Provider;
         isSelected: boolean;
-        hasDefaultModel: boolean;
         promoted?: boolean;
     }
 
@@ -27,8 +26,7 @@
     const emit = defineEmits<Emits>();
 
     const isToggleDisabled = computed(() => {
-        // 如果服务商已启用且有默认模型，则不能禁用
-        return props.provider.enabled === 1 && props.hasDefaultModel;
+        return false;
     });
 
     const handleToggle = () => {
@@ -78,12 +76,6 @@
                 >
                     {{ provider.name }}
                 </h3>
-                <span
-                    v-if="hasDefaultModel"
-                    class="shrink-0 rounded-full bg-neutral-100 px-2 py-0.5 text-xs whitespace-nowrap text-neutral-600 ring-1 ring-neutral-200"
-                >
-                    {{ t('common.default') }}
-                </span>
             </div>
         </div>
 
diff --git a/apps/desktop/src/views/SettingsView/components/AiServices/components/ProviderList.vue b/apps/desktop/src/views/SettingsView/components/AiServices/components/ProviderList.vue
index d933a733..35f26ee4 100644
--- a/apps/desktop/src/views/SettingsView/components/AiServices/components/ProviderList.vue
+++ b/apps/desktop/src/views/SettingsView/components/AiServices/components/ProviderList.vue
@@ -16,7 +16,6 @@
     interface Props {
         providers: Provider[];
         selectedProviderId: number | null;
-        defaultModelProviderIds: Set<number>;
     }
 
     interface Emits {
@@ -89,7 +88,6 @@
                 :key="provider.id"
                 :provider="provider"
                 :is-selected="provider.id === selectedProviderId"
-                :has-default-model="defaultModelProviderIds.has(provider.id)"
                 :promoted="true"
                 @select="emit('select', provider.id)"
                 @toggle-enabled="emit('toggle-enabled', provider.id)"
@@ -102,7 +100,6 @@
                 :key="provider.id"
                 :provider="provider"
                 :is-selected="provider.id === selectedProviderId"
-                :has-default-model="defaultModelProviderIds.has(provider.id)"
                 @select="emit('select', provider.id)"
                 @toggle-enabled="emit('toggle-enabled', provider.id)"
                 @validation-error="emit('validation-error', $event)"
@@ -134,7 +131,6 @@
                     :key="provider.id"
                     :provider="provider"
                     :is-selected="provider.id === selectedProviderId"
-                    :has-default-model="defaultModelProviderIds.has(provider.id)"
                     @select="emit('select', provider.id)"
                     @toggle-enabled="emit('toggle-enabled', provider.id)"
                     @validation-error="emit('validation-error', $event)"
diff --git a/apps/desktop/src/views/SettingsView/components/AiServices/index.vue b/apps/desktop/src/views/SettingsView/components/AiServices/index.vue
index 039f5d0f..bf6cc0f0 100644
--- a/apps/desktop/src/views/SettingsView/components/AiServices/index.vue
+++ b/apps/desktop/src/views/SettingsView/components/AiServices/index.vue
@@ -19,7 +19,6 @@
         findDefaultModel,
         findModelsWithProvider,
         findProviderById,
-        setDefaultModel,
         syncAllModelsMetadata,
         updateModel,
         updateProvider,
@@ -75,8 +74,8 @@
     const providers = ref<Provider[]>([]);
     const modelsCache = ref<Map<number, ModelWithProvider[]>>(new Map()); // 缓存每个服务商的模型
     const selectedProviderId = ref<number | null>(null);
-    const defaultModelId = ref<number | null>(null);
-    const defaultModelProviderId = ref<number | null>(null);
+    const entryModelId = ref<number | null>(null);
+    const entryModelProviderId = ref<number | null>(null);
     const loading = ref(true);
     const loadingModels = ref(false);
     const error = ref<string | null>(null);
@@ -127,17 +126,6 @@
         modelsCache.value = nextCache;
     }
 
-    function findCachedModel(modelId: number): ModelWithProvider | undefined {
-        for (const providerModels of modelsCache.value.values()) {
-            const model = providerModels.find((item) => item.id === modelId);
-            if (model) {
-                return model;
-            }
-        }
-
-        return undefined;
-    }
-
     function patchProvider(providerId: number, patch: Partial<Provider>) {
         providers.value = providers.value.map((provider) =>
             provider.id === providerId ? { ...provider, ...patch } : provider
@@ -173,15 +161,6 @@
         return modelsCache.value.get(selectedProviderId.value) || [];
     });
 
-    const defaultModelProviderIds = computed(() => {
-        const ids = new Set<number>();
-        if (defaultModelProviderId.value !== null) {
-            ids.add(defaultModelProviderId.value);
-            return ids;
-        }
-        return ids;
-    });
-
     // 加载服务商列表
     const loadProviders = async () => {
         try {
@@ -191,8 +170,8 @@
             providers.value = await findAllProvidersSorted();
 
             const defaultModel = await findDefaultModel();
-            defaultModelId.value = defaultModel?.id || null;
-            defaultModelProviderId.value = defaultModel?.provider_id || null;
+            entryModelId.value = defaultModel?.id || null;
+            entryModelProviderId.value = defaultModel?.provider_id || null;
 
             // 自动选择第一个服务商
             if (providers.value.length > 0 && !selectedProviderId.value) {
@@ -304,8 +283,10 @@
     }
 
     function assertProviderCanBeDisabled(provider: Provider) {
-        if (defaultModelProviderId.value === provider.id) {
-            throw new Error(t('settings.ai.cannotDisableProviderWithDefaultModel'));
+        if (entryModelProviderId.value === provider.id) {
+            throw new Error(
+                t('settings.general.modelPreferences.cannotDisableProviderWithEntryModel')
+            );
         }
     }
 
@@ -314,8 +295,10 @@
             throw new Error(t('settings.ai.cannotDeleteBuiltInProvider'));
         }
 
-        if (defaultModelProviderId.value === provider.id) {
-            throw new Error(t('settings.ai.cannotDeleteProviderWithDefaultModel'));
+        if (entryModelProviderId.value === provider.id) {
+            throw new Error(
+                t('settings.general.modelPreferences.cannotDeleteProviderWithEntryModel')
+            );
         }
     }
 
@@ -446,9 +429,9 @@
             await deleteModel({ id });
             removeCachedModel(id);
             await broadcastModelsUpdated();
-            if (defaultModelId.value === id) {
-                defaultModelId.value = null;
-                defaultModelProviderId.value = null;
+            if (entryModelId.value === id) {
+                entryModelId.value = null;
+                entryModelProviderId.value = null;
             }
             if (!silent) {
                 alert.success(t('settings.ai.deleteSucceeded'));
@@ -458,33 +441,6 @@
         }
     };
 
-    const handleSetDefaultModel = async (id: number) => {
-        try {
-            const nextDefaultModel = findCachedModel(id);
-            await setDefaultModel({ modelId: id });
-            defaultModelId.value = id;
-            defaultModelProviderId.value =
-                nextDefaultModel?.provider_id ?? selectedProviderId.value ?? null;
-
-            const nextCache = new Map(modelsCache.value);
-            for (const [providerId, providerModels] of nextCache.entries()) {
-                nextCache.set(
-                    providerId,
-                    providerModels.map((model) => ({
-                        ...model,
-                        is_default: model.id === id ? 1 : 0,
-                    }))
-                );
-            }
-            modelsCache.value = nextCache;
-
-            await broadcastModelsUpdated();
-            alert.success(t('settings.ai.setSucceeded'));
-        } catch (err) {
-            alert.error(err instanceof Error ? err.message : t('settings.ai.setFailed'));
-        }
-    };
-
     // 刷新模型列表
     const handleRefreshModels = async (silent = false) => {
         if (!selectedProviderId.value) return;
@@ -529,10 +485,16 @@
                     errorMessage.includes('authentication') ||
                     errorMessage.includes('API key');
 
-                // 如果是认证错误且没有配置 key，提示用户
-                if (isAuthError && !provider.api_key) {
+                // 认证失败需要直接提示用户，避免只在控制台看到 401。
+                if (isAuthError) {
                     if (!silent) {
-                        alert.warning(t('settings.ai.providerNeedsApiKeyForModels'));
+                        alert.warning(
+                            t(
+                                provider.api_key
+                                    ? 'settings.ai.providerInvalidApiKeyForModels'
+                                    : 'settings.ai.providerNeedsApiKeyForModels'
+                            )
+                        );
                     }
                     return;
                 }
@@ -627,7 +589,6 @@
         <ProviderList
             :providers="providers"
             :selected-provider-id="selectedProviderId"
-            :default-model-provider-ids="defaultModelProviderIds"
             @select="selectProvider"
             @toggle-enabled="toggleProviderEnabled"
             @add-custom="handleAddCustomProvider"
@@ -701,14 +662,13 @@
                     <ModelList
                         :provider-id="selectedProvider.id"
                         :models="selectedProviderModels"
-                        :default-model-id="defaultModelId"
+                        :entry-model-id="entryModelId"
                         :provider="selectedProvider"
                         :provider-enabled="selectedProvider.enabled === 1"
                         :refreshing="refreshing"
                         @create="handleCreateModel"
                         @update="handleUpdateModel"
                         @delete="handleDeleteModel"
-                        @set-default="handleSetDefaultModel"
                         @refresh="handleRefreshModels"
                     />
                 </div>
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..6f27c37e
--- /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 text-sm 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..b9f5fa07
--- /dev/null
+++ b/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue
@@ -0,0 +1,386 @@
+<!-- Copyright (c) 2026. Qian Cheng. Licensed under GPL v3 -->
+
+<script setup lang="ts">
+    import AppIcon from '@components/AppIcon.vue';
+    import CustomSelect from '@components/CustomSelect.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 PreferenceForm {
+        id: number | null;
+        name: string;
+        description: string;
+        modelId: string;
+    }
+
+    interface ModelSelectOption {
+        label: string;
+        value: string;
+        description?: string;
+    }
+
+    const alert = useAlert();
+    const loading = ref(true);
+    const saving = ref(false);
+    const preferences = ref<ModelPreferenceWithModel[]>([]);
+    const models = ref<ModelWithProvider[]>([]);
+    const roleModelIds = ref<Record<ModelRole, string>>({
+        entry: '',
+        fast: '',
+        general: '',
+    });
+    const form = ref<PreferenceForm | null>(null);
+    const UNSET_MODEL_VALUE = '__touchai_unset_model__';
+
+    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 sortedModels = 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)
+        )
+    );
+
+    const modelSelectOptions = computed<ModelSelectOption[]>(() =>
+        sortedModels.value
+            .filter((model) => model.provider_enabled === 1)
+            .map((model) => ({
+                label: formatModelOption(model),
+                value: String(model.id),
+                description: model.model_id,
+            }))
+    );
+
+    function formatPreferenceModel(preference: ModelPreferenceWithModel): string {
+        return [preference.provider_name, preference.model_name].filter(Boolean).join(' / ');
+    }
+
+    function formatModelOption(model: ModelWithProvider): string {
+        return `${model.provider_name} / ${model.name}`;
+    }
+
+    function getRoleModelOptions(modelRole: (typeof modelRoles)[number]): ModelSelectOption[] {
+        if (modelRole.required) {
+            return modelSelectOptions.value;
+        }
+
+        return [
+            {
+                label: t(modelRole.placeholderKey),
+                value: UNSET_MODEL_VALUE,
+            },
+            ...modelSelectOptions.value,
+        ];
+    }
+
+    function getRoleModelValue(modelRole: (typeof modelRoles)[number]): string {
+        const value = roleModelIds.value[modelRole.role];
+        return modelRole.required || value ? value : UNSET_MODEL_VALUE;
+    }
+
+    function updateRoleModel(role: ModelRole, value: string) {
+        roleModelIds.value[role] = value === UNSET_MODEL_VALUE ? '' : value;
+        void saveModelRole(role);
+    }
+
+    function createEmptyForm(): PreferenceForm {
+        return {
+            id: null,
+            name: '',
+            description: '',
+            modelId: '',
+        };
+    }
+
+    async function loadData() {
+        loading.value = true;
+        try {
+            const [nextPreferences, nextModels, entryModel, fastModel, generalModel] =
+                await Promise.all([
+                    listModelPreferences(),
+                    findModelsWithProvider(),
+                    findModelRoleWithProvider('entry'),
+                    findModelRoleWithProvider('fast'),
+                    findModelRoleWithProvider('general'),
+                ]);
+            preferences.value = nextPreferences;
+            models.value = nextModels;
+            roleModelIds.value = {
+                entry: entryModel ? String(entryModel.id) : '',
+                fast: fastModel ? String(fastModel.id) : '',
+                general: generalModel ? String(generalModel.id) : '',
+            };
+        } 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)
+            : 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>
+    <section class="space-y-4">
+        <div>
+            <h2 class="text-[15px] font-medium text-neutral-950">
+                {{ t('settings.general.modelPreferences.title') }}
+            </h2>
+            <p class="mt-1 max-w-2xl text-sm leading-6 text-neutral-500">
+                {{ t('settings.general.modelPreferences.description') }}
+            </p>
+        </div>
+
+        <div class="settings-row-group divide-y divide-neutral-200/70">
+            <div
+                v-for="modelRole in modelRoles"
+                :key="modelRole.role"
+                class="grid min-w-0 gap-4 px-5 py-4 sm:grid-cols-[minmax(0,1fr)_320px] sm: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 w-full">
+                    <CustomSelect
+                        :model-value="getRoleModelValue(modelRole)"
+                        :options="getRoleModelOptions(modelRole)"
+                        :placeholder="t(modelRole.placeholderKey)"
+                        protect-option-text
+                        @update:model-value="updateRoleModel(modelRole.role, $event)"
+                    />
+                </div>
+            </div>
+        </div>
+    </section>
+
+    <section class="space-y-4 border-t border-neutral-200 pt-8">
+        <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="loading" class="settings-row-group px-4 py-3 text-sm text-neutral-500">
+            {{ t('common.loading') }}
+        </div>
+
+        <div
+            v-else-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 divide-y divide-neutral-200/70">
+            <div
+                v-for="preference in preferences"
+                :key="preference.id"
+                class="flex items-start justify-between gap-4 px-4 py-3 transition-colors hover:bg-neutral-50/70"
+            >
+                <div class="min-w-0">
+                    <h3 class="text-[13px] leading-5 font-medium text-neutral-950">
+                        {{ preference.name }}
+                    </h3>
+                    <p class="mt-0.5 text-xs leading-5 text-neutral-600">
+                        {{ preference.description }}
+                    </p>
+                    <p
+                        :class="[
+                            'mt-1 text-[11px] leading-4',
+                            preference.provider_enabled === 1 && preference.model_id !== null
+                                ? 'text-neutral-500'
+                                : 'text-red-500',
+                        ]"
+                    >
+                        {{
+                            formatPreferenceModel(preference) ||
+                            t('settings.general.modelPreferences.unavailableModel')
+                        }}
+                    </p>
+                </div>
+
+                <div class="flex shrink-0 gap-1 pt-0.5">
+                    <button
+                        class="settings-icon-button h-7 w-7 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-7 w-7 rounded-md"
+                        :title="t('common.delete')"
+                        @click="removePreference(preference)"
+                    >
+                        <AppIcon name="delete" class="h-3.5 w-3.5" />
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <ModelPreferenceDialog
+            v-if="form"
+            :preference="form"
+            :models="models"
+            :saving="saving"
+            @save="savePreference"
+            @cancel="cancelEdit"
+        />
+    </section>
+</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..b39c109f 100644
--- a/apps/desktop/src/views/SettingsView/components/General/index.vue
+++ b/apps/desktop/src/views/SettingsView/components/General/index.vue
@@ -361,6 +361,23 @@
         }
     };
 
+    const saveAllowModelAutoSwitch = async (previousValue: boolean) => {
+        try {
+            await settingsStore.updateAllowModelAutoSwitch(settings.value.allowModelAutoSwitch);
+            alertMessage.value?.success(t('common.saved'), 2000);
+        } catch (error) {
+            settings.value.allowModelAutoSwitch = previousValue;
+            console.error('Failed to save allow_model_auto_switch setting:', error);
+            alertMessage.value?.error(t('settings.general.saveSettingsFailed'), 3000);
+        }
+    };
+
+    const toggleAllowModelAutoSwitch = () => {
+        const previousValue = settings.value.allowModelAutoSwitch;
+        settings.value.allowModelAutoSwitch = !previousValue;
+        void saveAllowModelAutoSwitch(previousValue);
+    };
+
     const saveOutputScrollBehavior = async () => {
         try {
             await settingsStore.updateOutputScrollBehavior(settings.value.outputScrollBehavior);
@@ -632,7 +649,46 @@
                     </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)_auto] sm:items-center"
+                    >
+                        <div class="min-w-0">
+                            <div
+                                data-testid="settings-general-row-label"
+                                class="text-[13px] leading-6 font-normal text-neutral-900"
+                            >
+                                {{ t('settings.general.allowModelAutoSwitch') }}
+                            </div>
+                            <p class="text-xs leading-5 text-neutral-500">
+                                {{ t('settings.general.allowModelAutoSwitchDescription') }}
+                            </p>
+                        </div>
+                        <button
+                            :class="[
+                                'relative inline-flex h-5 w-9 items-center rounded-full transition-colors',
+                                settings.allowModelAutoSwitch
+                                    ? 'settings-toggle-enabled'
+                                    : 'bg-neutral-200',
+                            ]"
+                            data-testid="settings-allow-model-auto-switch-toggle"
+                            :aria-pressed="settings.allowModelAutoSwitch"
+                            @click="toggleAllowModelAutoSwitch"
+                        >
+                            <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>
+                    </div>
+
                     <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..e0e07b75
--- /dev/null
+++ b/apps/desktop/src/views/SettingsView/components/ModelPreferences/index.vue
@@ -0,0 +1,15 @@
+<script setup lang="ts">
+    import ModelPreferences from '../General/components/ModelPreferences.vue';
+
+    defineOptions({
+        name: 'SettingsModelPreferencesSection',
+    });
+</script>
+
+<template>
+    <div class="settings-page" data-testid="settings-model-preferences-section">
+        <div class="settings-section-stack">
+            <ModelPreferences />
+        </div>
+    </div>
+</template>
diff --git a/apps/desktop/src/views/SettingsView/index.vue b/apps/desktop/src/views/SettingsView/index.vue
index 8b89123a..c5786c17 100644
--- a/apps/desktop/src/views/SettingsView/index.vue
+++ b/apps/desktop/src/views/SettingsView/index.vue
@@ -24,6 +24,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')
@@ -40,9 +43,11 @@
     const SETTINGS_ENTRY_LOADING_DELAY_MS = 180;
     let loadingDelayTimer: ReturnType<typeof setTimeout> | null = null;
     const generalScrollRef = ref<HTMLElement | null>(null);
+    const modelPreferencesScrollRef = ref<HTMLElement | null>(null);
     const dataScrollRef = ref<HTMLElement | null>(null);
     const isWindowMaximized = ref(false);
     useScrollbarStabilizer(generalScrollRef);
+    useScrollbarStabilizer(modelPreferencesScrollRef);
     useScrollbarStabilizer(dataScrollRef);
     const shellVisibilityClass = computed(() =>
         initialLoadingVisible.value ? 'opacity-0' : 'opacity-100'
@@ -254,6 +259,23 @@
                             </Suspense>
                         </div>
 
+                        <div
+                            v-else-if="activeSection === 'model-preferences'"
+                            ref="modelPreferencesScrollRef"
+                            :class="['settings-scrollbar', 'h-full w-full overflow-y-auto']"
+                        >
+                            <Suspense>
+                                <ModelPreferencesView />
+                                <template #fallback>
+                                    <LoadingState
+                                        :message="t('settings.loading.modelPreferences')"
+                                        variant="brand"
+                                        fill="min"
+                                    />
+                                </template>
+                            </Suspense>
+                        </div>
+
                         <div v-else-if="activeSection === 'ai-services'" class="h-full w-full">
                             <Suspense>
                                 <AiServicesView />
diff --git a/apps/desktop/src/views/SettingsView/settingsNavigation.ts b/apps/desktop/src/views/SettingsView/settingsNavigation.ts
index 1dad7331..8764c267 100644
--- a/apps/desktop/src/views/SettingsView/settingsNavigation.ts
+++ b/apps/desktop/src/views/SettingsView/settingsNavigation.ts
@@ -4,6 +4,7 @@ import { type MessageKey, t } from '@/i18n';
 
 export type NavigationSection =
     | 'general'
+    | 'model-preferences'
     | 'ai-services'
     | 'built-in-tools'
     | 'mcp-tools'
@@ -50,10 +51,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: 'llm',
+                labelKey: 'settings.nav.modelPreferences.label',
+                descriptionKey: 'settings.nav.modelPreferences.description',
+            },
             {
                 id: 'built-in-tools',
                 icon: 'tool',
diff --git a/apps/desktop/tests/SettingsView/ai-services-i18n.test.ts b/apps/desktop/tests/SettingsView/ai-services-i18n.test.ts
index 54041888..dece213d 100644
--- a/apps/desktop/tests/SettingsView/ai-services-i18n.test.ts
+++ b/apps/desktop/tests/SettingsView/ai-services-i18n.test.ts
@@ -182,19 +182,18 @@ 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]),
             },
         });
 
         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');
@@ -209,7 +208,7 @@ describe('AiServices i18n and layout', () => {
             props: {
                 providerId: 1,
                 models: [createModel()],
-                defaultModelId: null,
+                entryModelId: null,
                 provider: createProvider(),
                 providerEnabled: true,
                 refreshing: false,
@@ -234,7 +233,7 @@ describe('AiServices i18n and layout', () => {
             props: {
                 providerId: 1,
                 models: [],
-                defaultModelId: null,
+                entryModelId: null,
                 provider: createProvider({ api_endpoint: '' }),
                 providerEnabled: true,
                 refreshing: false,
@@ -308,7 +307,6 @@ describe('AiServices i18n and layout', () => {
             props: {
                 providers: [createProvider({ name: '服务商', is_builtin: 1 })],
                 selectedProviderId: 1,
-                defaultModelProviderIds: new Set([1]),
             },
             attachTo: document.body,
         });
@@ -316,7 +314,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/model-card-i18n.test.ts b/apps/desktop/tests/SettingsView/model-card-i18n.test.ts
index 306f3173..4fe8c1f1 100644
--- a/apps/desktop/tests/SettingsView/model-card-i18n.test.ts
+++ b/apps/desktop/tests/SettingsView/model-card-i18n.test.ts
@@ -82,7 +82,7 @@ describe('ModelCard i18n', () => {
         const wrapper = mount(ModelCard, {
             props: {
                 model: createModel(),
-                isDefault: false,
+                isEntryModel: false,
                 providerEnabled: true,
             },
         });
@@ -98,15 +98,13 @@ describe('ModelCard i18n', () => {
         const wrapper = mount(ModelCard, {
             props: {
                 model: createModel(),
-                isDefault: false,
+                isEntryModel: false,
                 providerEnabled: false,
             },
         });
 
-        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');
 
@@ -121,13 +119,13 @@ describe('ModelCard i18n', () => {
         });
     });
 
-    it('localizes default-model delete validation in English', async () => {
+    it('localizes entry-model delete validation in English', async () => {
         setLocale('en-US');
 
         const wrapper = mount(ModelCard, {
             props: {
                 model: createModel(),
-                isDefault: true,
+                isEntryModel: true,
                 providerEnabled: true,
             },
         });
@@ -135,7 +133,7 @@ describe('ModelCard i18n', () => {
         await wrapper.findAll('button')[1]?.trigger('click');
 
         expect(alertErrorMock).toHaveBeenCalledWith(
-            'Cannot delete the default model. Set another model as default first.'
+            'Cannot delete the entry model. Select another entry model in General settings first.'
         );
     });
 
@@ -145,7 +143,7 @@ describe('ModelCard i18n', () => {
         const wrapper = mount(ModelCard, {
             props: {
                 model: createModel({ name: '设置' }),
-                isDefault: false,
+                isEntryModel: false,
                 providerEnabled: true,
             },
             attachTo: document.body,
diff --git a/apps/desktop/tests/SettingsView/navigation-sidebar-i18n.test.ts b/apps/desktop/tests/SettingsView/navigation-sidebar-i18n.test.ts
index 1b61b7c4..d98ec556 100644
--- a/apps/desktop/tests/SettingsView/navigation-sidebar-i18n.test.ts
+++ b/apps/desktop/tests/SettingsView/navigation-sidebar-i18n.test.ts
@@ -56,6 +56,7 @@ describe('Settings navigation sidebar i18n', () => {
         expect(flattenSettingsNavigation().map((item) => item.label)).toEqual([
             'General',
             'Providers and models',
+            'Model settings',
             'Built-in tools',
             'MCP tools',
             'Data management',
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..c6c26d65
--- /dev/null
+++ b/apps/desktop/tests/services/AgentService/prompt/model-preferences.test.ts
@@ -0,0 +1,118 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { buildModelPreferencesPrompt } from '@/services/AgentService/prompt/modelPreferences';
+
+const queries = vi.hoisted(() => ({
+    findModelRoleWithProvider: 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.findModelRoleWithProvider.mockImplementation((role: string) => {
+            if (role === 'entry') {
+                return Promise.resolve(createModel({ name: 'Entry 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('Entry model');
+        expect(prompt).toContain('Fast model');
+        expect(prompt).toContain('General model');
+        expect(prompt).toContain('Provider A / Entry 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>" }');
+    });
+
+    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..6d0672ce 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,6 +82,7 @@ describe('UpgradeModel i18n', () => {
     beforeEach(() => {
         setLocale('zh-CN');
         vi.clearAllMocks();
+        getSettingValueMock.mockResolvedValue('false');
     });
 
     it('creates an English approval request for the resolved target model', async () => {
@@ -184,4 +202,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 automatic model switching 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/views/SettingsView/modelGroupBehavior.test.ts b/apps/desktop/tests/views/SettingsView/modelGroupBehavior.test.ts
index 5e0437e2..81f4cfae 100644
--- a/apps/desktop/tests/views/SettingsView/modelGroupBehavior.test.ts
+++ b/apps/desktop/tests/views/SettingsView/modelGroupBehavior.test.ts
@@ -64,19 +64,18 @@ describe('ModelGroup behavior', () => {
                     groupName: 'gpt',
                     models: [model],
                 },
-                defaultModelId: null,
+                entryModelId: null,
                 providerEnabled: true,
             },
             global: {
                 stubs: {
                     ModelCard: {
                         props: ['model'],
-                        emits: ['update', 'delete', 'set-default', 'edit'],
+                        emits: ['update', 'delete', 'edit'],
                         template: `
                             <div>
                                 <button data-testid="model-update" @click="$emit('update', { name: 'next' })">update</button>
                                 <button data-testid="model-delete" @click="$emit('delete')">delete</button>
-                                <button data-testid="model-default" @click="$emit('set-default')">default</button>
                                 <button data-testid="model-edit" @click="$emit('edit')">edit</button>
                             </div>
                         `,
@@ -95,16 +94,14 @@ describe('ModelGroup behavior', () => {
 
         await wrapper.get('[data-testid="model-update"]').trigger('click');
         await wrapper.get('[data-testid="model-delete"]').trigger('click');
-        await wrapper.get('[data-testid="model-default"]').trigger('click');
         await wrapper.get('[data-testid="model-edit"]').trigger('click');
 
         expect(wrapper.emitted('update')?.[0]).toEqual([7, { name: 'next' }]);
         expect(wrapper.emitted('delete')?.[0]).toEqual([7]);
-        expect(wrapper.emitted('set-default')?.[0]).toEqual([7]);
         expect(wrapper.emitted('edit')?.[0]).toEqual([model]);
     });
 
-    it('blocks deleting a group that contains the default model', async () => {
+    it('blocks deleting a group that contains the entry model', async () => {
         const wrapper = mount(ModelGroup, {
             props: {
                 group: {
@@ -112,7 +109,7 @@ describe('ModelGroup behavior', () => {
                     groupName: 'gpt',
                     models: [createModel(1, 'gpt-5')],
                 },
-                defaultModelId: 1,
+                entryModelId: 1,
                 providerEnabled: true,
             },
             global: {
@@ -125,7 +122,7 @@ describe('ModelGroup behavior', () => {
         await wrapper.find('button[title="删除分组"]').trigger('click');
         await flushPromises();
 
-        expect(warningMock).toHaveBeenCalledWith('该分组包含默认模型，无法批量删除');
+        expect(warningMock).toHaveBeenCalledWith('该分组包含入口模型，无法批量删除');
         expect(confirmMock).not.toHaveBeenCalled();
         expect(wrapper.emitted('delete-group')).toBeUndefined();
     });
@@ -139,7 +136,7 @@ describe('ModelGroup behavior', () => {
                     groupName: 'gpt',
                     models: [createModel(1, 'gpt-5')],
                 },
-                defaultModelId: null,
+                entryModelId: null,
                 providerEnabled: true,
             },
             global: {
diff --git a/apps/desktop/tests/views/SettingsView/modelListEmptyState.test.ts b/apps/desktop/tests/views/SettingsView/modelListEmptyState.test.ts
index 7e52da4c..40f0c2d2 100644
--- a/apps/desktop/tests/views/SettingsView/modelListEmptyState.test.ts
+++ b/apps/desktop/tests/views/SettingsView/modelListEmptyState.test.ts
@@ -26,7 +26,7 @@ describe('ModelList empty state', () => {
             props: {
                 providerId: 1,
                 models: [],
-                defaultModelId: null,
+                entryModelId: null,
                 providerEnabled: true,
                 refreshing: false,
                 provider: {
diff --git a/apps/desktop/tests/views/SettingsView/settingsAiServicesLayout.test.ts b/apps/desktop/tests/views/SettingsView/settingsAiServicesLayout.test.ts
index d76496f5..d038f474 100644
--- a/apps/desktop/tests/views/SettingsView/settingsAiServicesLayout.test.ts
+++ b/apps/desktop/tests/views/SettingsView/settingsAiServicesLayout.test.ts
@@ -236,7 +236,7 @@ describe('SettingsAiServicesSection', () => {
         expect(wrapper.text()).toContain('Renamed Gateway');
     });
 
-    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',
@@ -288,14 +288,14 @@ describe('SettingsAiServicesSection', () => {
                     ProviderList: true,
                     ProviderConfig: true,
                     ModelList: {
-                        props: ['defaultModelId'],
-                        emits: ['set-default'],
+                        props: ['entryModelId'],
+                        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 }}
+                                entry: {{ entryModelId }}
                             </button>
                         `,
                     },
@@ -311,14 +311,16 @@ 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('entry: 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('保存成功');
     });
 });
diff --git a/apps/desktop/tests/views/SettingsView/settingsGeneralComponent.test.ts b/apps/desktop/tests/views/SettingsView/settingsGeneralComponent.test.ts
index 05b0bd40..cf316d3f 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', () => {
@@ -187,7 +191,7 @@ describe('SettingsGeneralSection', () => {
         expect(controls.length).toBeGreaterThanOrEqual(3);
 
         const rowLabels = wrapper.findAll('[data-testid="settings-general-row-label"]');
-        expect(rowLabels).toHaveLength(8);
+        expect(rowLabels).toHaveLength(9);
     });
 
     it('shows the current version in the latest update details', async () => {
@@ -229,6 +233,22 @@ describe('SettingsGeneralSection', () => {
         expect(appUpdateServiceMock.setAutoCheckEnabled).toHaveBeenCalledWith(false);
     });
 
+    it('reverts the automatic model switch toggle when saving fails', async () => {
+        settingsStoreMock.updateAllowModelAutoSwitch.mockRejectedValueOnce(
+            new Error('write failed')
+        );
+        const wrapper = mount(GeneralSection);
+
+        await flushPromises();
+        await wrapper
+            .get('[data-testid="settings-allow-model-auto-switch-toggle"]')
+            .trigger('click');
+        await flushPromises();
+
+        expect(settingsStoreMock.updateAllowModelAutoSwitch).toHaveBeenCalledWith(true);
+        expect(settingsStoreMock.settings.value.allowModelAutoSwitch).toBe(false);
+    });
+
     it('shows update details and delegates update actions', async () => {
         appUpdateServiceMock.state = {
             ...appUpdateServiceMock.state,
diff --git a/apps/desktop/tests/views/SettingsView/settingsNavigation.test.ts b/apps/desktop/tests/views/SettingsView/settingsNavigation.test.ts
index e70d7ff5..29a02df2 100644
--- a/apps/desktop/tests/views/SettingsView/settingsNavigation.test.ts
+++ b/apps/desktop/tests/views/SettingsView/settingsNavigation.test.ts
@@ -15,6 +15,7 @@ describe('settingsNavigation', () => {
         expect(items.map((item) => item.label)).toEqual([
             '通用',
             '服务商与模型',
+            '模型设置',
             '内置工具',
             'MCP 工具',
             '数据管理',
@@ -30,6 +31,10 @@ describe('settingsNavigation', () => {
 
         expect(getSettingsNavigationItem('ai-services')).toMatchObject({
             label: '服务商与模型',
+            icon: 'cloud',
+        });
+        expect(getSettingsNavigationItem('model-preferences')).toMatchObject({
+            label: '模型设置',
             icon: 'llm',
         });
         expect(getSettingsNavigationItem('general')?.description).toContain('快捷键');
diff --git a/eslint.config.js b/eslint.config.js
index 44e101b6..9f02deb7 100644
--- a/eslint.config.js
+++ b/eslint.config.js
@@ -60,6 +60,10 @@ export default defineConfig([
         '.coverage/**',
         '**/.coverage',
         '**/.coverage/**',
+        '.vite-cache',
+        '.vite-cache/**',
+        '**/.vite-cache',
+        '**/.vite-cache/**',
         'src-tauri',
         'src-tauri/**',
         '**/src-tauri',

From 77ec7786e6ec113ef7e649f92054639f3d5b8e94 Mon Sep 17 00:00:00 2001
From: KagurazakaSakuya <2471012170@qq.com>
Date: Sat, 30 May 2026 23:16:39 +0900
Subject: [PATCH 2/6] fix: address model preference review feedback

---
 .../AgentService/prompt/modelPreferences.ts   |  2 +-
 .../General/components/ModelPreferences.vue   |  2 +-
 .../SettingsView/components/General/index.vue | 15 +++++++++++
 .../prompt/model-preferences.test.ts          |  1 +
 .../settingsGeneralComponent.test.ts          | 26 +++++++++++++++++++
 5 files changed, 44 insertions(+), 2 deletions(-)

diff --git a/apps/desktop/src/services/AgentService/prompt/modelPreferences.ts b/apps/desktop/src/services/AgentService/prompt/modelPreferences.ts
index 1ca740b3..81c8e83a 100644
--- a/apps/desktop/src/services/AgentService/prompt/modelPreferences.ts
+++ b/apps/desktop/src/services/AgentService/prompt/modelPreferences.ts
@@ -82,7 +82,7 @@ export async function buildModelPreferencesPrompt(): Promise<string[]> {
             '',
             '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 }`, `{ "role": "entry" }`, or `{ "scenario": null }` to return to the entry model.',
+            'Use `builtin__upgrade_model` with `{ "restore": true }` or `{ "role": "entry" }` to return to the entry 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.',
diff --git a/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue b/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue
index b9f5fa07..0c688ee7 100644
--- a/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue
+++ b/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue
@@ -211,7 +211,7 @@
 
         const modelId = Number(nextForm.modelId);
         const selectedModel = Number.isFinite(modelId)
-            ? models.value.find((model) => model.id === modelId)
+            ? models.value.find((model) => model.id === modelId && model.provider_enabled === 1)
             : null;
         if (!selectedModel) {
             alert.error(t('settings.general.modelPreferences.modelRequired'));
diff --git a/apps/desktop/src/views/SettingsView/components/General/index.vue b/apps/desktop/src/views/SettingsView/components/General/index.vue
index b39c109f..839e4616 100644
--- a/apps/desktop/src/views/SettingsView/components/General/index.vue
+++ b/apps/desktop/src/views/SettingsView/components/General/index.vue
@@ -76,6 +76,7 @@
 
     const shortcutInput = ref<HTMLInputElement | null>(null);
     const isSaving = ref(false);
+    const savingAllowModelAutoSwitch = ref(false);
     const isCapturing = ref(false);
     const hasCapturedShortcut = ref(false);
     const displayShortcut = ref('');
@@ -362,6 +363,11 @@
     };
 
     const saveAllowModelAutoSwitch = async (previousValue: boolean) => {
+        if (savingAllowModelAutoSwitch.value) {
+            return;
+        }
+
+        savingAllowModelAutoSwitch.value = true;
         try {
             await settingsStore.updateAllowModelAutoSwitch(settings.value.allowModelAutoSwitch);
             alertMessage.value?.success(t('common.saved'), 2000);
@@ -369,10 +375,16 @@
             settings.value.allowModelAutoSwitch = previousValue;
             console.error('Failed to save allow_model_auto_switch setting:', error);
             alertMessage.value?.error(t('settings.general.saveSettingsFailed'), 3000);
+        } finally {
+            savingAllowModelAutoSwitch.value = false;
         }
     };
 
     const toggleAllowModelAutoSwitch = () => {
+        if (savingAllowModelAutoSwitch.value) {
+            return;
+        }
+
         const previousValue = settings.value.allowModelAutoSwitch;
         settings.value.allowModelAutoSwitch = !previousValue;
         void saveAllowModelAutoSwitch(previousValue);
@@ -668,6 +680,7 @@
                             </p>
                         </div>
                         <button
+                            type="button"
                             :class="[
                                 'relative inline-flex h-5 w-9 items-center rounded-full transition-colors',
                                 settings.allowModelAutoSwitch
@@ -675,7 +688,9 @@
                                     : 'bg-neutral-200',
                             ]"
                             data-testid="settings-allow-model-auto-switch-toggle"
+                            :aria-label="t('settings.general.allowModelAutoSwitch')"
                             :aria-pressed="settings.allowModelAutoSwitch"
+                            :disabled="savingAllowModelAutoSwitch"
                             @click="toggleAllowModelAutoSwitch"
                         >
                             <span
diff --git a/apps/desktop/tests/services/AgentService/prompt/model-preferences.test.ts b/apps/desktop/tests/services/AgentService/prompt/model-preferences.test.ts
index c6c26d65..58a38544 100644
--- a/apps/desktop/tests/services/AgentService/prompt/model-preferences.test.ts
+++ b/apps/desktop/tests/services/AgentService/prompt/model-preferences.test.ts
@@ -72,6 +72,7 @@ describe('model preferences prompt', () => {
             '| 前端开发 | React、Vue、CSS、Tailwind | Anthropic / Claude Sonnet |'
         );
         expect(prompt).toContain('{ "scenario": "<Scenario>" }');
+        expect(prompt).not.toContain('{ "scenario": null }');
     });
 
     it('omits unusable scenario preferences without failing prompt construction', async () => {
diff --git a/apps/desktop/tests/views/SettingsView/settingsGeneralComponent.test.ts b/apps/desktop/tests/views/SettingsView/settingsGeneralComponent.test.ts
index cf316d3f..71bf39d8 100644
--- a/apps/desktop/tests/views/SettingsView/settingsGeneralComponent.test.ts
+++ b/apps/desktop/tests/views/SettingsView/settingsGeneralComponent.test.ts
@@ -249,6 +249,32 @@ describe('SettingsGeneralSection', () => {
         expect(settingsStoreMock.settings.value.allowModelAutoSwitch).toBe(false);
     });
 
+    it('disables the automatic model switch toggle while saving', async () => {
+        let resolveSave!: () => void;
+        settingsStoreMock.updateAllowModelAutoSwitch.mockReturnValueOnce(
+            new Promise<void>((resolve) => {
+                resolveSave = resolve;
+            })
+        );
+        const wrapper = mount(GeneralSection);
+
+        await flushPromises();
+        const toggle = wrapper.get('[data-testid="settings-allow-model-auto-switch-toggle"]');
+        expect(toggle.attributes('type')).toBe('button');
+        expect(toggle.attributes('aria-label')).toBeTruthy();
+
+        await toggle.trigger('click');
+
+        expect(toggle.attributes('disabled')).toBeDefined();
+        await toggle.trigger('click');
+        expect(settingsStoreMock.updateAllowModelAutoSwitch).toHaveBeenCalledTimes(1);
+
+        resolveSave();
+        await flushPromises();
+
+        expect(toggle.attributes('disabled')).toBeUndefined();
+    });
+
     it('shows update details and delegates update actions', async () => {
         appUpdateServiceMock.state = {
             ...appUpdateServiceMock.state,

From f7956bde6e27133ab38999adec2965faf14c4e45 Mon Sep 17 00:00:00 2001
From: KagurazakaSakuya <2471012170@qq.com>
Date: Sun, 31 May 2026 21:11:11 +0900
Subject: [PATCH 3/6] fix: polish model settings selectors

---
 apps/desktop/src/i18n/messages.ts             |   4 +-
 .../General/components/ModelPreferences.vue   | 354 ++++++++++++++++--
 2 files changed, 316 insertions(+), 42 deletions(-)

diff --git a/apps/desktop/src/i18n/messages.ts b/apps/desktop/src/i18n/messages.ts
index 61341e3e..be65fe89 100644
--- a/apps/desktop/src/i18n/messages.ts
+++ b/apps/desktop/src/i18n/messages.ts
@@ -290,7 +290,7 @@ const zhCNMessages = {
     'settings.general.modelPreferences.fastModel': '快速模型',
     'settings.general.modelPreferences.fastModelDescription': '用于会话命名和简单问答。',
     'settings.general.modelPreferences.generalModel': '通用模型',
-    'settings.general.modelPreferences.generalModelDescription': '用于未命中特定场景的复杂任务。',
+    'settings.general.modelPreferences.generalModelDescription': '用于未命中特定场景的任务。',
     'settings.general.modelPreferences.selectEntryModel': '选择入口模型',
     'settings.general.modelPreferences.useEntryModel': '不设置',
     'settings.general.modelPreferences.entryModelRequired': '请选择入口模型',
@@ -1097,7 +1097,7 @@ const enUSMessages: Record<keyof typeof zhCNMessages, string> = {
     'settings.general.modelPreferences.fastModelDescription': 'For session naming and simple Q&A.',
     'settings.general.modelPreferences.generalModel': 'General model',
     'settings.general.modelPreferences.generalModelDescription':
-        'For complex tasks without a scenario match.',
+        'For tasks without a scenario match.',
     'settings.general.modelPreferences.selectEntryModel': 'Select entry model',
     'settings.general.modelPreferences.useEntryModel': 'Not set',
     'settings.general.modelPreferences.entryModelRequired': 'Select an entry model',
diff --git a/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue b/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue
index 0c688ee7..aba6c20e 100644
--- a/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue
+++ b/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue
@@ -2,7 +2,9 @@
 
 <script setup lang="ts">
     import AppIcon from '@components/AppIcon.vue';
-    import CustomSelect from '@components/CustomSelect.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,
@@ -32,10 +34,20 @@
         modelId: string;
     }
 
-    interface ModelSelectOption {
+    interface ModelPreferenceSelectOption {
+        value: string | number;
         label: string;
-        value: 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();
@@ -48,8 +60,23 @@
         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;
@@ -81,54 +108,138 @@
         },
     ];
 
-    const sortedModels = 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)
-        )
-    );
-
-    const modelSelectOptions = computed<ModelSelectOption[]>(() =>
-        sortedModels.value
+    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)
-            .map((model) => ({
-                label: formatModelOption(model),
-                value: String(model.id),
-                description: model.model_id,
-            }))
     );
 
     function formatPreferenceModel(preference: ModelPreferenceWithModel): string {
         return [preference.provider_name, preference.model_name].filter(Boolean).join(' / ');
     }
 
-    function formatModelOption(model: ModelWithProvider): string {
-        return `${model.provider_name} / ${model.name}`;
-    }
+    function getProviderOptions(
+        modelRole: (typeof modelRoles)[number]
+    ): ModelPreferenceSelectOption[] {
+        const providerMap = new Map<number, ModelPreferenceSelectOption>();
+
+        for (const model of enabledModels.value) {
+            if (providerMap.has(model.provider_id)) {
+                continue;
+            }
 
-    function getRoleModelOptions(modelRole: (typeof modelRoles)[number]): ModelSelectOption[] {
+            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,
+            });
+        }
+
+        const options = [...providerMap.values()];
         if (modelRole.required) {
-            return modelSelectOptions.value;
+            return options;
         }
 
         return [
             {
-                label: t(modelRole.placeholderKey),
                 value: UNSET_MODEL_VALUE,
+                label: t(modelRole.placeholderKey),
             },
-            ...modelSelectOptions.value,
+            ...options,
         ];
     }
 
-    function getRoleModelValue(modelRole: (typeof modelRoles)[number]): string {
-        const value = roleModelIds.value[modelRole.role];
-        return modelRole.required || value ? value : UNSET_MODEL_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 updateRoleModel(role: ModelRole, value: string) {
-        roleModelIds.value[role] = value === UNSET_MODEL_VALUE ? '' : value;
+    function getRoleModelOptions(role: ModelRole): ModelPreferenceSelectOption[] {
+        const providerId = roleProviderIds.value[role];
+        if (providerId === null) {
+            return [];
+        }
+
+        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);
     }
 
@@ -159,6 +270,11 @@
                 fast: fastModel ? String(fastModel.id) : '',
                 general: generalModel ? String(generalModel.id) : '',
             };
+            roleProviderIds.value = {
+                entry: entryModel?.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'));
@@ -271,11 +387,13 @@
             </p>
         </div>
 
-        <div class="settings-row-group divide-y divide-neutral-200/70">
+        <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 sm:grid-cols-[minmax(0,1fr)_320px] sm:items-center"
+                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">
@@ -286,20 +404,176 @@
                     </p>
                 </div>
 
-                <div class="ml-auto w-full">
-                    <CustomSelect
-                        :model-value="getRoleModelValue(modelRole)"
-                        :options="getRoleModelOptions(modelRole)"
-                        :placeholder="t(modelRole.placeholderKey)"
+                <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="getProviderOptions(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 border-t border-neutral-200 pt-8">
+    <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">

From 83e41841640f6100b5f3f3c6f3475d3fed4551c9 Mon Sep 17 00:00:00 2001
From: KagurazakaSakuya <2471012170@qq.com>
Date: Mon, 1 Jun 2026 00:46:50 +0900
Subject: [PATCH 4/6] fix: streamline scenario model preferences

---
 .../drizzle/0003_model_preferences.sql        |  10 +-
 .../General/components/ModelPreferences.vue   | 315 +++++++++++++++---
 2 files changed, 281 insertions(+), 44 deletions(-)

diff --git a/apps/desktop/src/database/drizzle/0003_model_preferences.sql b/apps/desktop/src/database/drizzle/0003_model_preferences.sql
index 6a2cc531..0a34d80c 100644
--- a/apps/desktop/src/database/drizzle/0003_model_preferences.sql
+++ b/apps/desktop/src/database/drizzle/0003_model_preferences.sql
@@ -1,4 +1,4 @@
-CREATE TABLE `model_preferences` (
+CREATE TABLE IF NOT EXISTS `model_preferences` (
     `id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
     `name` text NOT NULL,
     `description` text NOT NULL,
@@ -11,10 +11,10 @@ CREATE TABLE `model_preferences` (
     FOREIGN KEY (`model_id`) REFERENCES `models`(`id`) ON UPDATE no action ON DELETE set null
 );
 --> statement-breakpoint
-CREATE INDEX `model_preferences_priority_idx` ON `model_preferences` (`priority`);
+CREATE INDEX IF NOT EXISTS `model_preferences_priority_idx` ON `model_preferences` (`priority`);
 --> statement-breakpoint
-CREATE UNIQUE INDEX `model_preferences_name_unique` ON `model_preferences` (`name`);
+CREATE UNIQUE INDEX IF NOT EXISTS `model_preferences_name_unique` ON `model_preferences` (`name`);
 --> statement-breakpoint
-CREATE INDEX `model_preferences_model_id_idx` ON `model_preferences` (`model_id`);
+CREATE INDEX IF NOT EXISTS `model_preferences_model_id_idx` ON `model_preferences` (`model_id`);
 --> statement-breakpoint
-CREATE INDEX `model_preferences_provider_id_idx` ON `model_preferences` (`provider_id`);
+CREATE INDEX IF NOT EXISTS `model_preferences_provider_id_idx` ON `model_preferences` (`provider_id`);
diff --git a/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue b/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue
index aba6c20e..ab83854d 100644
--- a/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue
+++ b/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue
@@ -55,6 +55,7 @@
     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: '',
@@ -119,13 +120,7 @@
             .filter((model) => model.provider_enabled === 1)
     );
 
-    function formatPreferenceModel(preference: ModelPreferenceWithModel): string {
-        return [preference.provider_name, preference.model_name].filter(Boolean).join(' / ');
-    }
-
-    function getProviderOptions(
-        modelRole: (typeof modelRoles)[number]
-    ): ModelPreferenceSelectOption[] {
+    const providerOptions = computed<ModelPreferenceSelectOption[]>(() => {
         const providerMap = new Map<number, ModelPreferenceSelectOption>();
 
         for (const model of enabledModels.value) {
@@ -148,9 +143,14 @@
             });
         }
 
-        const options = [...providerMap.values()];
+        return [...providerMap.values()];
+    });
+
+    function getRoleProviderOptions(
+        modelRole: (typeof modelRoles)[number]
+    ): ModelPreferenceSelectOption[] {
         if (modelRole.required) {
-            return options;
+            return providerOptions.value;
         }
 
         return [
@@ -158,7 +158,7 @@
                 value: UNSET_MODEL_VALUE,
                 label: t(modelRole.placeholderKey),
             },
-            ...options,
+            ...providerOptions.value,
         ];
     }
 
@@ -177,6 +177,10 @@
             return [];
         }
 
+        return getModelOptionsForProvider(providerId);
+    }
+
+    function getModelOptionsForProvider(providerId: number): ModelPreferenceSelectOption[] {
         return enabledModels.value
             .filter((model) => model.provider_id === providerId)
             .map((model) => ({
@@ -243,6 +247,85 @@
         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,
@@ -409,7 +492,7 @@
                 >
                     <SearchableSelect
                         :model-value="getRoleProviderValue(modelRole)"
-                        :options="getProviderOptions(modelRole)"
+                        :options="getRoleProviderOptions(modelRole)"
                         placeholder-key="settings.builtInTools.upgradeModel.provider"
                         search-placeholder-key="settings.builtInTools.upgradeModel.searchProvider"
                         empty-text-key="settings.builtInTools.upgradeModel.emptyProviders"
@@ -601,49 +684,203 @@
             {{ t('settings.general.modelPreferences.empty') }}
         </div>
 
-        <div v-else class="settings-row-group divide-y divide-neutral-200/70">
+        <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="flex items-start justify-between gap-4 px-4 py-3 transition-colors hover:bg-neutral-50/70"
+                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">
-                    <h3 class="text-[13px] leading-5 font-medium text-neutral-950">
-                        {{ preference.name }}
-                    </h3>
+                    <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
-                        :class="[
-                            'mt-1 text-[11px] leading-4',
-                            preference.provider_enabled === 1 && preference.model_id !== null
-                                ? 'text-neutral-500'
-                                : 'text-red-500',
-                        ]"
+                        v-if="preference.provider_enabled !== 1 || preference.model_id === null"
+                        class="mt-1 text-[11px] leading-4 text-red-500"
                     >
-                        {{
-                            formatPreferenceModel(preference) ||
-                            t('settings.general.modelPreferences.unavailableModel')
-                        }}
+                        {{ t('settings.general.modelPreferences.unavailableModel') }}
                     </p>
                 </div>
 
-                <div class="flex shrink-0 gap-1 pt-0.5">
-                    <button
-                        class="settings-icon-button h-7 w-7 rounded-md"
-                        :title="t('common.edit')"
-                        @click="startEdit(preference)"
+                <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)"
                     >
-                        <AppIcon name="edit" class="h-3.5 w-3.5" />
-                    </button>
-                    <button
-                        class="settings-icon-button h-7 w-7 rounded-md"
-                        :title="t('common.delete')"
-                        @click="removePreference(preference)"
+                        <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))"
                     >
-                        <AppIcon name="delete" class="h-3.5 w-3.5" />
-                    </button>
+                        <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>

From c8ddc81147b377707d885d853f65a1ba8a9d05e0 Mon Sep 17 00:00:00 2001
From: KagurazakaSakuya <2471012170@qq.com>
Date: Mon, 1 Jun 2026 00:53:31 +0900
Subject: [PATCH 5/6] fix: format model preference settings

---
 .../components/General/components/ModelPreferences.vue | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue b/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue
index ab83854d..8375c6e5 100644
--- a/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue
+++ b/apps/desktop/src/views/SettingsView/components/General/components/ModelPreferences.vue
@@ -303,7 +303,10 @@
         }
     }
 
-    function updatePreferenceProvider(preference: ModelPreferenceWithModel, value: string | number) {
+    function updatePreferenceProvider(
+        preference: ModelPreferenceWithModel,
+        value: string | number
+    ) {
         const providerId = Number(value);
         if (!Number.isInteger(providerId)) {
             return;
@@ -684,7 +687,10 @@
             {{ 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-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"

From 4d00fafca2131c5c31c362b6302a33db26cf42df Mon Sep 17 00:00:00 2001
From: KagurazakaSakuya <2471012170@qq.com>
Date: Thu, 16 Jul 2026 20:06:38 +0900
Subject: [PATCH 6/6] chore: rerun ci