From 8b134a13d26d9568093f3321b67343508770ee0f Mon Sep 17 00:00:00 2001 From: chengyongru <2755839590@qq.com> Date: Sat, 1 Aug 2026 11:55:50 +0800 Subject: [PATCH] docs: explain session model preset switching --- docs/chat-commands.md | 7 +++++++ docs/webui.md | 14 ++++++++++++++ 2 files changed, 21 insertions(+) diff --git a/docs/chat-commands.md b/docs/chat-commands.md index 2e006243e..5003a7feb 100644 --- a/docs/chat-commands.md +++ b/docs/chat-commands.md @@ -49,6 +49,13 @@ Use `/model` to inspect the current runtime model: The response shows the current session's model and preset, plus the available preset names. Named presets come from the top-level `modelPresets` config and are the recommended way to configure model choices. `default` is always available and represents the model settings from direct `agents.defaults.*` fields. +`/model ` expects one of those preset names, not a provider model ID or +the preset's display label. For example, if `modelPresets.local` uses the Ollama +model `llama3.2`, run `/model local`, not `/model llama3.2`. If a model is currently +configured only as an inline fallback, save it as a named preset before selecting +it manually. Fallback order controls automatic failover; it is not a list of raw +model IDs accepted by `/model`. + To switch presets for future turns: ```text diff --git a/docs/webui.md b/docs/webui.md index 02310804f..7d533e26b 100644 --- a/docs/webui.md +++ b/docs/webui.md @@ -147,6 +147,20 @@ transcription is configured, slash commands, and `@` mentions for installed Apps or MCP presets. The model badge shows the current model or preset and links back to model settings when setup is incomplete. +When two or more named model presets are configured, the badge also acts as a +vertical preset selector. Press and hold the badge for about 0.4 seconds, drag up +or down, and release on the preset you want. A plain click does not open a menu. +For keyboard access, focus the badge and use Up / Down to +move between presets or Home / End to jump to the first or +last preset. + +The selection applies to future turns in the current session and persists with +that session; it does not change the default for other sessions. Only named +presets from **Settings → Models** are selectable. An inline fallback model that +has not been saved as a named preset is not a separate manual choice. Save it as +a named preset to make it selectable. The same switch is available in chat with +`/model `; see [Chat Commands: Model Presets](./chat-commands.md#model-presets). + For image generation, configure an image provider first and then use the WebUI image mode from the composer. See [`image-generation.md`](./image-generation.md) for provider setup and output behavior.