vrr/qwen-code
2
0
Fork 0
mirror of https://github.com/QwenLM/qwen-code.git synced 2026-08-12 02:05:15 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 21

docs: document compaction and image model selection (#8348)

Browse source 
* docs: document auxiliary model selection

* docs: align model option labels

* docs: clarify image model HTTPS requirement
This commit is contained in:
Dragon 2026-08-02 14:44:54 +08:00 • committed by GitHub
parent f693a9806e
commit e967cc9037
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 53 additions and 39 deletions
Download patch file Download diff file Expand all files Collapse all files

12
docs/users/configuration/settings.md
View file

@ -264,6 +264,18 @@ The `extra_body` field allows you to add custom parameters to the request body s
| ------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `visionModel` | string | Image-capable model used as the vision bridge: when a text-only main model receives an image, or `read_file` needs the bounded PDF visual fallback, it is transcribed by this model first. Setting this explicitly authorizes bridge calls to that model even when it uses another provider; the tool display discloses the endpoint. Leave empty to auto-pick a same-provider vision model. Can also be set via `/model --vision`. | `""` |
#### compactionModel
| Setting | Type | Description | Default |
| ----------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `compactionModel` | string | Model used for chat compression (auto-compaction). Leave empty to fall back to the main model. A smaller or faster model can reduce compression latency and cost. Can also be set or cleared via `/model --compaction`. | `""` |
#### imageModel
| Setting | Type | Description | Default |
| ------------ | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `imageModel` | string | Model used by the built-in `image_gen` tool. The selected model must have `imageOnly: true`, an HTTPS `baseUrl`, and `envKey` in `modelProviders`. Leave empty to keep the tool unavailable. Can also be set via `/model --image`. | `""` |
#### visionBridgeTimeoutMs
| Setting | Type | Description | Default |

80
docs/users/features/commands.md
View file

@ -81,45 +81,47 @@ Commands specifically for controlling interface and output language.
Commands for managing AI tools and models.
| Command | Description | Usage Examples |
| ----------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| `/mcp` | List configured MCP servers and tools | `/mcp`, `/mcp desc`, `/mcp nodesc`, `/mcp schema` |
| `/import-config` | Import MCP servers from Claude configs | `/import-config all`, `/import-config claude-code`, `/import-config claude-desktop --scope user\|project` |
| `/tools` | Display currently available tool list | `/tools`, `/tools desc` |
| `/skills` | Open the Skills panel to browse, search, toggle, and launch skills | `/skills`, `/<skill-name>` |
| `/learn` | Create a reusable project skill from a file, directory, URL, video, or text | `/learn https://docs.example.com/api`, `/learn ./tutorial.mp4 focus on deployment` |
| `/curator` | Inspect, pin, archive, or restore inactive project auto-skills | `/curator`, `/curator run --dry-run`, `/curator pin <directory>`, `/curator restore <directory>` |
| `/plan` | Switch to plan mode or exit plan mode | `/plan`, `/plan <task>`, `/plan exit` |
| `/approval-mode` | Change the tool-approval mode (current session only) | `/approval-mode`, `/approval-mode auto-edit` |
| → `plan` | Analysis only, no execution (secure review) | `/approval-mode plan` |
| → `default` | Require approval for edits (daily use) | `/approval-mode default` |
| → `auto-edit` | Auto-approve edits (trusted environment) | `/approval-mode auto-edit` |
| → `auto` | Classifier-evaluated approval (autonomous) | `/approval-mode auto` |
| → `yolo` | Auto-approve everything (quick prototyping) | `/approval-mode yolo` |
| `/model` | Switch model used in current session | `/model`, `/model <model-id>` (switch immediately) |
| `/model --fast` | Set a lighter model for prompt suggestions | `/model --fast qwen3-coder-flash` |
| `/model --voice` | Set the model used for voice transcription | `/model --voice <model-id>` |
| `/model --vision` | Set the vision-bridge model used to transcribe images for a text-only main model | `/model --vision <model-id>` |
| `/effort` | Set reasoning effort for thinking-capable models | `/effort` (opens picker), `/effort high` (low/medium/high/xhigh/max; mapped & clamped per provider) |
| `/extensions` | Manage extensions | `/extensions list`, `/extensions manage` |
| → `list` | List installed extensions | `/extensions list` |
| → `manage` | Manage installed extensions (interactive) | `/extensions manage` |
| → `explore` | Open extensions page in browser | `/extensions explore <Gemini\|ClaudeCode>` |
| → `install` | Install an extension from a git repo or path | `/extensions install <repo-or-path>` |
| `/memory` | Open the Memory Manager dialog | `/memory` |
| `/remember` | Save a durable memory | `/remember Prefer terse responses` |
| `/forget` | Remove matching entries from auto-memory | `/forget <query>` |
| `/dream` | Manually run auto-memory consolidation | `/dream` |
| `/hooks` | Manage Qwen Code hooks | `/hooks`, `/hooks list` |
| `/reload-plugins` | Reload extension changes (commands, skills, agents, hooks, MCP/LSP servers) from disk | `/reload-plugins` |
| `/permissions` | Manage permission rules | `/permissions` |
| `/agents` | Manage subagents | `/agents manage`, `/agents create` |
| `/arena` | Manage Arena sessions | `/arena start`, `/arena stop`, `/arena status`, `/arena select` (alias `choose`) |
| `/goal` | Set a goal — keep working until condition met | `/goal <condition>`, `/goal clear` |
| `/tasks` | List background tasks | `/tasks` |
| `/workflows` | Inspect workflow runs | `/workflows`, `/workflows <runId>` |
| `/lsp` | Show LSP server status | `/lsp` |
| `/trust` | Manage folder trust settings | `/trust` |
| Command | Description | Usage Examples |
| --------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| `/mcp` | List configured MCP servers and tools | `/mcp`, `/mcp desc`, `/mcp nodesc`, `/mcp schema` |
| `/import-config` | Import MCP servers from Claude configs | `/import-config all`, `/import-config claude-code`, `/import-config claude-desktop --scope user\|project` |
| `/tools` | Display currently available tool list | `/tools`, `/tools desc` |
| `/skills` | Open the Skills panel to browse, search, toggle, and launch skills | `/skills`, `/<skill-name>` |
| `/learn` | Create a reusable project skill from a file, directory, URL, video, or text | `/learn https://docs.example.com/api`, `/learn ./tutorial.mp4 focus on deployment` |
| `/curator` | Inspect, pin, archive, or restore inactive project auto-skills | `/curator`, `/curator run --dry-run`, `/curator pin <directory>`, `/curator restore <directory>` |
| `/plan` | Switch to plan mode or exit plan mode | `/plan`, `/plan <task>`, `/plan exit` |
| `/approval-mode` | Change the tool-approval mode (current session only) | `/approval-mode`, `/approval-mode auto-edit` |
| → `plan` | Analysis only, no execution (secure review) | `/approval-mode plan` |
| → `default` | Require approval for edits (daily use) | `/approval-mode default` |
| → `auto-edit` | Auto-approve edits (trusted environment) | `/approval-mode auto-edit` |
| → `auto` | Classifier-evaluated approval (autonomous) | `/approval-mode auto` |
| → `yolo` | Auto-approve everything (quick prototyping) | `/approval-mode yolo` |
| `/model` | Switch model used in current session | `/model`, `/model <model-id>` (switch immediately) |
| `/model --fast` | Set a lighter model for prompt suggestions | `/model --fast qwen3-coder-flash` |
| `/model --voice` | Set the model used for voice transcription | `/model --voice <model-id>` |
| `/model --vision` | Set the vision-bridge model used to transcribe images for a text-only main model | `/model --vision <model-id>` |
| `/model --compaction` | Set the model used for chat compression | `/model --compaction <model-id>`, `/model --compaction clear` |
| `/model --image` | Set an image-only model for the built-in image generation tool | `/model --image <model-id>` |
| `/effort` | Set reasoning effort for thinking-capable models | `/effort` (opens picker), `/effort high` (low/medium/high/xhigh/max; mapped & clamped per provider) |
| `/extensions` | Manage extensions | `/extensions list`, `/extensions manage` |
| → `list` | List installed extensions | `/extensions list` |
| → `manage` | Manage installed extensions (interactive) | `/extensions manage` |
| → `explore` | Open extensions page in browser | `/extensions explore <Gemini\|ClaudeCode>` |
| → `install` | Install an extension from a git repo or path | `/extensions install <repo-or-path>` |
| `/memory` | Open the Memory Manager dialog | `/memory` |
| `/remember` | Save a durable memory | `/remember Prefer terse responses` |
| `/forget` | Remove matching entries from auto-memory | `/forget <query>` |
| `/dream` | Manually run auto-memory consolidation | `/dream` |
| `/hooks` | Manage Qwen Code hooks | `/hooks`, `/hooks list` |
| `/reload-plugins` | Reload extension changes (commands, skills, agents, hooks, MCP/LSP servers) from disk | `/reload-plugins` |
| `/permissions` | Manage permission rules | `/permissions` |
| `/agents` | Manage subagents | `/agents manage`, `/agents create` |
| `/arena` | Manage Arena sessions | `/arena start`, `/arena stop`, `/arena status`, `/arena select` (alias `choose`) |
| `/goal` | Set a goal — keep working until condition met | `/goal <condition>`, `/goal clear` |
| `/tasks` | List background tasks | `/tasks` |
| `/workflows` | Inspect workflow runs | `/workflows`, `/workflows <runId>` |
| `/lsp` | Show LSP server status | `/lsp` |
| `/trust` | Manage folder trust settings | `/trust` |
> [!warning]
>