@mmmbuto/qwen-code-termux 0.16.1-termux → 0.18.0-termux

package/bundled/qc-helper/docs/features/channels/feishu.md

@@ -0,0 +1,170 @@
+# Feishu (Lark)
+
+This guide covers setting up a Qwen Code channel on Feishu (飞书) / Lark.
+
+## Prerequisites
+
+- A Feishu organization account
+- A Feishu application with App ID and App Secret (see below)
+
+## Creating an Application
+
+1. Go to the [Feishu Open Platform](https://open.feishu.cn)
+2. Create a new application (or use an existing one)
+3. Under the application, enable the **Bot** capability (添加应用能力 → 机器人)
+4. In **Event Subscriptions** (事件与回调), select **Long Connection** (使用长连接接收事件)
+5. Add the event `im.message.receive_v1` (接收消息)
+6. Note the **App ID** (Client ID) and **App Secret** (Client Secret) from the application credentials page
+
+### Required Permissions
+
+Enable the following permissions under **Permissions & Scopes** (权限管理):
+
+- `im:message` — Read and send messages
+- `im:message:send_as_bot` — Send messages as bot
+- `im:resource` — Access message resources (images, files)
+
+### Publish the Application
+
+After configuring permissions and events, create a version and publish it. The bot won't work until the application is published and approved.
+
+## Configuration
+
+Add the channel to `~/.qwen/settings.json`:
+
+```json
+{
+  "channels": {
+    "my-feishu": {
+      "type": "feishu",
+      "clientId": "<your-app-id>",
+      "clientSecret": "<your-app-secret>",
+      "senderPolicy": "open",
+      "sessionScope": "user",
+      "cwd": "/path/to/your/project",
+      "groupPolicy": "open",
+      "collapsible": true,
+      "groups": {
+        "*": { "requireMention": true }
+      }
+    }
+  }
+}
+```
+
+### Configuration Options
+
+| Option                 | Description                                                         |
+| ---------------------- | ------------------------------------------------------------------- |
+| `clientId`             | Feishu App ID                                                       |
+| `clientSecret`         | Feishu App Secret                                                   |
+| `collapsible`          | Collapse long responses into expandable sections (default: `false`) |
+| `collapsibleThreshold` | Character threshold for collapsing (default: `500`)                 |
+| `webhookPort`          | If set, use HTTP webhook mode instead of WebSocket                  |
+| `verificationToken`    | Verification token for webhook mode                                 |
+| `encryptKey`           | Encrypt key for webhook mode                                        |
+
+## Running
+
+```bash
+# Start only the Feishu channel
+qwen channel start my-feishu
+
+# Or start all configured channels together
+qwen channel start
+```
+
+Open Feishu and send a message to the bot. You should see a streaming interactive card with the response.
+
+## Connection Modes
+
+### WebSocket (Default)
+
+WebSocket mode uses an outbound long connection — no public URL or server is needed. This is the recommended mode for most deployments.
+
+### Webhook
+
+If you need webhook mode (e.g., for shared applications), set `webhookPort` in your config:
+
+```json
+{
+  "channels": {
+    "my-feishu": {
+      "type": "feishu",
+      "webhookPort": 9321,
+      "verificationToken": "<from-feishu-console>",
+      "encryptKey": "<from-feishu-console>"
+    }
+  }
+}
+```
+
+Then set the request URL in Feishu Open Platform to `http://<your-server>:9321`.
+
+## Group Chats
+
+Feishu bots work in both DM and group conversations. To enable group support:
+
+1. Set `groupPolicy` to `"allowlist"` or `"open"` in your channel config
+2. Add the bot to a Feishu group
+3. @mention the bot in the group to trigger a response
+
+By default, the bot requires an @mention in group chats (`requireMention: true`). Set `"requireMention": false` for a specific group to make it respond to all messages.
+
+## Features
+
+### Interactive Card Streaming
+
+Responses are rendered as Feishu interactive cards with real-time streaming updates. The card shows a "generating" indicator while the response is being produced, and a **Stop** button to cancel generation.
+
+### Quote/Reply Context
+
+When you reply to (quote) a message, the quoted content is automatically included as context for the agent. This works for:
+
+- Text and rich-text messages
+- Interactive cards (bot's previous responses)
+
+### Images and Files
+
+You can send photos and documents to the bot:
+
+- **Images:** Analyzed using multimodal vision capabilities
+- **Files:** Downloaded and saved locally for the agent to read
+
+### Concurrent Messages
+
+Multiple users can send messages simultaneously in the same group chat. Each message gets its own independent card and response — they don't interfere with each other.
+
+## Key Differences from DingTalk
+
+- **Response format:** Uses Feishu interactive cards (v2 schema) with native markdown rendering, including tables
+- **Streaming:** Card content is updated in-place with throttled PATCH requests (1.5s interval)
+- **Connection:** WebSocket via `@larksuiteoapi/node-sdk` — same outbound-only model, no public URL needed
+- **Working indicator:** An "OnIt" emoji reaction is added while processing
+- **Quote context:** Supports quoting both text messages and interactive cards
+
+## Troubleshooting
+
+### Bot doesn't connect
+
+- Verify your App ID and App Secret are correct
+- Make sure **Long Connection** is selected in Event Subscriptions
+- Check that the `im.message.receive_v1` event is subscribed
+- Check the terminal output for connection errors
+
+### Bot doesn't respond in groups
+
+- Check that `groupPolicy` is set to `"allowlist"` or `"open"` (default is `"disabled"`)
+- Make sure you @mention the bot in the group message
+- Verify the bot has been added to the group
+
+### Card stays in "generating" state
+
+- This usually indicates the response completed but the final card update failed
+- Check terminal logs for API errors (rate limiting, card size limits)
+- Very long responses with many tables may hit Feishu's card element limits
+
+### Quote doesn't include card content
+
+- The bot reads card content via the `card_msg_content_type=user_card_content` API parameter
+- Ensure the bot has `im:message` permission to read messages

package/bundled/qc-helper/docs/features/commands.md

@@ -18,28 +18,39 @@ Slash commands are used to manage Qwen Code sessions, interface, and basic behav
 
 These commands help you save, restore, and summarize work progress.
 
-| Command     | Description                                               | Usage Examples                       |
-| ----------- | --------------------------------------------------------- | ------------------------------------ |
-| `/init`     | Analyze current directory and create initial context file | `/init`                              |
-| `/summary`  | Generate project summary based on conversation history    | `/summary`                           |
-| `/compress` | Replace chat history with summary to save Tokens          | `/compress`                          |
-| `/resume`   | Resume a previous conversation session                    | `/resume`                            |
-| `/recap`    | Generate a one-line session recap now                     | `/recap`                             |
-| `/restore`  | Restore files to state before tool execution              | `/restore` (list) or `/restore <ID>` |
+| Command          | Description                                                              | Usage Examples                                                |
+| ---------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------- |
+| `/init`          | Analyze current directory and create initial context file                | `/init`                                                       |
+| `/summary`       | Generate project summary based on conversation history                   | `/summary`                                                    |
+| `/compress`      | Replace chat history with summary to save Tokens                         | `/compress`                                                   |
+| `/compress-fast` | Fast compression without AI — strips old tool outputs and thinking parts | `/compress-fast`                                              |
+| `/resume`        | Resume a previous conversation session                                   | `/resume`                                                     |
+| `/recap`         | Generate a one-line session recap now                                    | `/recap`                                                      |
+| `/restore`       | Revert project files to the checkpoint before a tool call ran            | `/restore` (list) or `/restore <ID>`                          |
+| `/delete`        | Delete a previous session                                                | `/delete`                                                     |
+| `/branch`        | Fork the current conversation into a new session                         | `/branch`                                                     |
+| `/fork`          | Spawn a background agent that inherits the full conversation             | `/fork <directive>`                                           |
+| `/rewind`        | Rewind conversation to a previous turn                                   | `/rewind` or `/rollback`                                      |
+| `/export`        | Export session history to file                                           | `/export html`, `/export md`, `/export json`, `/export jsonl` |
+| `/rename`        | Rename or tag the current session                                        | `/rename My Feature` or `/tag`                                |
 
 ### 1.2 Interface and Workspace Control
 
 Commands for adjusting interface appearance and work environment.
 
-| Command      | Description                              | Usage Examples                |
-| ------------ | ---------------------------------------- | ----------------------------- |
-| `/clear`     | Clear terminal screen content            | `/clear` (shortcut: `Ctrl+L`) |
-| `/context`   | Show context window usage breakdown      | `/context`                    |
-| → `detail`   | Show per-item context usage breakdown    | `/context detail`             |
-| `/theme`     | Change Qwen Code visual theme            | `/theme`                      |
-| `/vim`       | Turn input area Vim editing mode on/off  | `/vim`                        |
-| `/directory` | Manage multi-directory support workspace | `/dir add ./src,./tests`      |
-| `/editor`    | Open dialog to select supported editor   | `/editor`                     |
+| Command              | Description                                                                                                                                                                       | Usage Examples                          |
+| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
+| `/clear`             | Clear terminal screen content                                                                                                                                                     | `/clear` (shortcut: `Ctrl+L`)           |
+| `/context`           | Show context window usage breakdown                                                                                                                                               | `/context`                              |
+| → `detail`           | Show per-item context usage breakdown                                                                                                                                             | `/context detail`                       |
+| `/diff`              | Open an interactive diff viewer showing uncommitted changes and per-turn diffs. Use ←/→ to switch between current git diff and individual conversation turns, ↑/↓ to browse files | `/diff`                                 |
+| `/theme`             | Change Qwen Code visual theme                                                                                                                                                     | `/theme`                                |
+| `/vim`               | Turn input area Vim editing mode on/off                                                                                                                                           | `/vim`                                  |
+| `/directory`         | Manage multi-directory support workspace                                                                                                                                          | `/dir add ./src,./tests`                |
+| `/editor`            | Open dialog to select supported editor                                                                                                                                            | `/editor`                               |
+| `/statusline`        | Open interactive [status line](./status-line.md) preset dialog                                                                                                                    | `/statusline`                           |
+| `/statusline <text>` | Generate a command-mode [status line](./status-line.md) via agent                                                                                                                 | `/statusline show model and git branch` |
+| `/terminal-setup`    | Configure terminal keybindings for multiline input                                                                                                                                | `/terminal-setup`                       |
 
 ### 1.3 Language Settings
 
@@ -68,6 +79,7 @@ Commands for managing AI tools and models.
 | →`plan`          | Analysis only, no execution                   | Secure review                                 |
 | →`default`       | Require approval for edits                    | Daily use                                     |
 | →`auto-edit`     | Automatically approve edits                   | Trusted environment                           |
+| →`auto`          | Classifier-evaluated approval                 | Autonomous sessions with safety guardrails    |
 | →`yolo`          | Automatically approve all                     | Quick prototyping                             |
 | `/model`         | Switch model used in current session          | `/model`                                      |
 | `/model --fast`  | Set a lighter model for prompt suggestions    | `/model --fast qwen3-coder-flash`             |
@@ -76,6 +88,14 @@ Commands for managing AI tools and models.
 | `/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`                       |
+| `/permissions`   | Manage permission rules                       | `/permissions`                                |
+| `/agents`        | Manage subagents                              | `/agents manage`, `/agents create`            |
+| `/arena`         | Manage Arena sessions                         | `/arena start`, `/arena status`               |
+| `/goal`          | Set a goal — keep working until condition met | `/goal <condition>`, `/goal clear`            |
+| `/tasks`         | List background tasks                         | `/tasks`                                      |
+| `/lsp`           | Show LSP server status                        | `/lsp`                                        |
+| `/trust`         | Manage folder trust settings                  | `/trust`                                      |
 
 ### 1.5 Built-in Skills
 
@@ -85,6 +105,7 @@ These commands invoke bundled skills that provide specialized workflows.
 | ------------ | ------------------------------------------------------------------- | ------------------------------------------------- |
 | `/review`    | Review code changes with 5 parallel agents + deterministic analysis | `/review`, `/review 123`, `/review 123 --comment` |
 | `/loop`      | Run a prompt on a recurring schedule                                | `/loop 5m check the build`                        |
+| `/simplify`  | Review recent changes and apply safe cleanup edits directly         | `/simplify`, `/simplify focus on duplication`     |
 | `/qc-helper` | Answer questions about Qwen Code usage and configuration            | `/qc-helper how do I configure MCP?`              |
 
 See [Code Review](./code-review.md) for full `/review` documentation.
@@ -188,7 +209,7 @@ progress; otherwise it waits for the current turn to finish and then fires).
 Unlike the manual command, the auto-trigger is fully silent on failure: if
 generation errors or there is nothing to summarize, no message is added to
 the history. Controlled by the `general.showSessionRecap` setting
-(default: `true`); the manual `/recap` command always works regardless of
+(default: `false`); the manual `/recap` command always works regardless of
 this setting.
 
 **Example:**
@@ -205,26 +226,85 @@ this setting.
 >
 > Configure a fast model via `/model --fast <model>` (e.g.
 > `qwen3-coder-flash`) to make `/recap` fast and cheap. Set
-> `general.showSessionRecap` to `false` to opt out of the auto-trigger
-> while keeping the manual command available.
+> `general.showSessionRecap` to `true` to enable the auto-trigger; the
+> manual `/recap` command always works regardless of this setting.
 
-### 1.8 Information, Settings, and Help
+### 1.8 Diff Viewer (`/diff`)
 
-Commands for obtaining information and performing system settings.
+The `/diff` command opens an interactive diff viewer showing uncommitted changes and per-turn diffs. Use ←/→ to switch between the current git diff and individual conversation turns, ↑/↓ to browse files, and Enter to view inline diffs.
+
+**How it works:**
+
+In interactive mode, `/diff` opens a dialog with a **source picker** along the top:
+
+- **Current** — working tree vs HEAD (`git diff HEAD`). Shows all uncommitted changes including staged, unstaged, and untracked files.
+- **T1, T2, T3, …** — per-turn diffs, one tab per model turn that modified files. Most recent turns appear first. Each tab shows a preview of the original prompt for context.
+
+The file list displays per-file stats (lines added/removed) with tags for special states (`new`, `deleted`, `untracked`, `binary`, `truncated`, `oversized`). Press Enter on a file to view its inline diff with syntax-highlighted hunks.
+
+Per-turn diffs require file checkpointing to be enabled (on by default in interactive mode). When file checkpointing is off, only the "Current" source is available.
+
+**Keyboard shortcuts:**
+
+| Key       | Action                                      |
+| --------- | ------------------------------------------- |
+| `←` / `→` | Switch between sources (Current / T1 / T2…) |
+| `↑` / `↓` | Navigate file list                          |
+| `j` / `k` | Navigate file list (vim-style)              |
+| Enter     | View inline diff for selected file          |
+| `←` / Esc | Return to file list from inline diff view   |
+| Esc       | Close the dialog                            |
+
+**Example:**
 
-| Command         | Description                                     | Usage Examples                   |
-| --------------- | ----------------------------------------------- | -------------------------------- |
-| `/help`         | Display help information for available commands | `/help` or `/?`                  |
-| `/status`       | Display version information                     | `/status` or `/about`            |
-| `/status paths` | Display current session file and log paths      | `/status paths`                  |
-| `/stats`        | Display detailed statistics for current session | `/stats`                         |
-| `/settings`     | Open settings editor                            | `/settings`                      |
-| `/auth`         | Change authentication method                    | `/auth`                          |
-| `/bug`          | Submit issue about Qwen Code                    | `/bug Button click unresponsive` |
-| `/copy`         | Copy last output content to clipboard           | `/copy`                          |
-| `/quit`         | Exit Qwen Code immediately                      | `/quit` or `/exit`               |
+```
+┌ /diff · Turn 3 "refactor the auth middleware" ──── 3 files +45 -12 ┐
+│                                                                     │
+│ ◀ Current · T3 · T2 · T1 ▶                                         │
+│                                                                     │
+│ › src/utils/parser.ts                              +30 -8           │
+│   src/utils/parser.test.ts                         +12 -2           │
+│   README.md                                        +3 -2            │
+│                                                                     │
+│ ←/→ source · ↑/↓ file · Enter view · Esc close                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+**Non-interactive mode:**
+
+In headless (`--prompt`) or non-interactive contexts, `/diff` prints a plain-text summary of the working tree vs HEAD. Per-turn navigation is not available.
+
+```
+3 files changed, +45 / -12
+  +30  -8  src/utils/parser.ts
+  +12  -2  src/utils/parser.test.ts
+   +3  -2  README.md
+```
+
+### 1.9 Information, Settings, and Help
+
+Commands for obtaining information and performing system settings.
 
-### 1.9 Common Shortcuts
+| Command         | Description                                                                                                                                                                                                                                                                                     | Usage Examples                   |
+| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
+| `/help`         | Display help information for available commands                                                                                                                                                                                                                                                 | `/help` or `/?`                  |
+| `/status`       | Display version information                                                                                                                                                                                                                                                                     | `/status` or `/about`            |
+| `/status paths` | Display current session file and log paths                                                                                                                                                                                                                                                      | `/status paths`                  |
+| `/stats`        | Open interactive usage statistics dashboard with three tabs: Session (live metrics), Activity (heatmap, token trend, project ranking), and Efficiency (cache rate, tool leaderboard, model comparison). Use `tab` to switch tabs, `r` to cycle time ranges, `←→` to pan months, `esc` to close. | `/stats`                         |
+| `/stats model`  | Show per-model token breakdown and estimated cost                                                                                                                                                                                                                                               | `/stats model`                   |
+| `/stats tools`  | Show per-tool call counts                                                                                                                                                                                                                                                                       | `/stats tools`                   |
+| `/settings`     | Open settings editor                                                                                                                                                                                                                                                                            | `/settings`                      |
+| `/auth`         | Change authentication method                                                                                                                                                                                                                                                                    | `/auth`                          |
+| `/doctor`       | Run installation and environment diagnostics                                                                                                                                                                                                                                                    | `/doctor`, `/doctor memory`      |
+| `/docs`         | Open full Qwen Code documentation in browser                                                                                                                                                                                                                                                    | `/docs`                          |
+| `/ide`          | Manage IDE integration                                                                                                                                                                                                                                                                          | `/ide status`, `/ide install`    |
+| `/insight`      | Generate programming insights from chat history                                                                                                                                                                                                                                                 | `/insight`                       |
+| `/setup-github` | Set up GitHub Actions                                                                                                                                                                                                                                                                           | `/setup-github`                  |
+| `/bug`          | Submit issue about Qwen Code                                                                                                                                                                                                                                                                    | `/bug Button click unresponsive` |
+| `/copy`         | Copy AI output to clipboard (`/copy N` = Nth-last AI message)                                                                                                                                                                                                                                   | `/copy` or `/copy 2`             |
+| `/quit`         | Exit Qwen Code immediately                                                                                                                                                                                                                                                                      | `/quit` or `/exit`               |
+
+### 1.10 Common Shortcuts
 
 | Shortcut           | Function                | Note                   |
 | ------------------ | ----------------------- | ---------------------- |
@@ -234,7 +314,7 @@ Commands for obtaining information and performing system settings.
 | `Ctrl/cmd+Z`       | Undo input              | Text editing           |
 | `Ctrl/cmd+Shift+Z` | Redo input              | Text editing           |
 
-### 1.10 Authentication Commands
+### 1.11 Authentication Commands
 
 Use `/auth` inside a Qwen Code session to configure authentication. Use `/doctor` to inspect the current authentication and environment status.
 

package/bundled/qc-helper/docs/features/followup-suggestions.md

@@ -32,7 +32,7 @@ Suggestions are generated when all of the following conditions are met:
 - There are no errors in the most recent response
 - No confirmation dialogs are pending (e.g., shell confirmation, permissions)
 - The approval mode is not set to `plan`
-- The feature is enabled in settings (enabled by default)
+- The feature is enabled in settings (disabled by default — set `ui.enableFollowupSuggestions` to `true` to turn it on)
 
 Suggestions will not appear in non-interactive mode (e.g., headless/SDK mode).
 
@@ -72,7 +72,7 @@ These settings can be configured in `settings.json`:
 
 | Setting                        | Type    | Default | Description                                                        |
 | ------------------------------ | ------- | ------- | ------------------------------------------------------------------ |
-| `ui.enableFollowupSuggestions` | boolean | `true`  | Enable or disable followup suggestions                             |
+| `ui.enableFollowupSuggestions` | boolean | `false` | Enable or disable followup suggestions                             |
 | `ui.enableCacheSharing`        | boolean | `true`  | Use cache-aware forked queries to reduce cost (experimental)       |
 | `ui.enableSpeculation`         | boolean | `false` | Speculatively execute suggestions before submission (experimental) |
 | `fastModel`                    | string  | `""`    | Model for prompt suggestions and speculative execution             |

package/bundled/qc-helper/docs/features/headless.md

@@ -238,9 +238,41 @@ Key command-line options for headless usage:
 | `--approval-mode`            | Set approval mode                                                        | `qwen -p "query" --approval-mode auto_edit`                              |
 | `--continue`                 | Resume the most recent session for this project                          | `qwen --continue -p "Pick up where we left off"`                         |
 | `--resume [sessionId]`       | Resume a specific session (or choose interactively)                      | `qwen --resume 123e... -p "Finish the refactor"`                         |
+| `--max-session-turns`        | Cap the number of user/model/tool turns in the run                       | `qwen -p "..." --max-session-turns 30`                                   |
+| `--max-wall-time`            | Wall-clock budget; accepts `90` (s), `30s`, `5m`, `1h`, `1.5h`           | `qwen -p "..." --max-wall-time 10m`                                      |
+| `--max-tool-calls`           | Cumulative tool-call budget for the run                                  | `qwen -p "..." --max-tool-calls 50`                                      |
 
 For complete details on all available configuration options, settings files, and environment variables, see the [Configuration Guide](../configuration/settings).
 
+## Safety in unattended runs
+
+Headless / CI runs combined with `--yolo` (or `--approval-mode=yolo`) auto-approve every tool call, including `shell`, `write`, and `edit`. **`--yolo` does not enable a sandbox** — those tools run at the host process's privilege level. When Qwen Code detects this combination with no sandbox configured, it prints a one-line warning to stderr at startup. Suppress the warning with `QWEN_CODE_SUPPRESS_YOLO_WARNING=1` once you've reviewed the trade-off.
+
+### Run-level budgets
+
+Qwen Code can abort an unattended run when it crosses one of the following thresholds. Each is `-1` (unlimited) by default; setting any one is enough to bound runaway behavior. They are enforced cooperatively against the same `AbortController` that already carries SIGINT, so a budget abort emits a structured `FatalBudgetExceededError` (exit code **55**) — distinct from the turn-cap exit code 53 and SIGINT's 130 so CI scripts can branch on the reason.
+
+| Flag                  | Settings key               | What it bounds                                                                                                                                                                                                |
+| --------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--max-wall-time`     | `model.maxWallTimeSeconds` | Wall-clock duration of the whole run. Flag accepts `90` (s), `30s`, `5m`, `1h`, `1.5h` (fractional units supported). Minimum 1s — sub-second values are rejected as typos. Settings is seconds.               |
+| `--max-tool-calls`    | `model.maxToolCalls`       | Cumulative top-level tool calls dispatched by the main run loop (counts successes _and_ failures — the model still consumes tokens on errors). See "Scope" below for subagent / structured-output exemptions. |
+| `--max-session-turns` | `model.maxSessionTurns`    | Number of user/model/tool turns; pre-existing. Exits with code 53 on overrun (distinct from budget exit 55).                                                                                                  |
+
+#### Scope
+
+- **`--max-tool-calls` counts top-level dispatches only.** When the model calls the `agent` tool, the dispatch counts as **1**; inner tool calls performed by the spawned subagent are **not** counted. A model that funnels work through subagents can do unbounded inner work under a small top-level budget. Combine with `--exclude-tools agent` if you need a tighter cap.
+- **`structured_output` is exempt from `--max-tool-calls`.** Under `--json-schema`, the model's terminal `structured_output` call is the "I'm done" contract, not real work — it doesn't count against `--max-tool-calls` so a budget-edge completion isn't aborted as a false positive. The exemption is unconditional (including failed Ajv validations), so a model stuck in a malformed-output retry loop is NOT bounded by `--max-tool-calls`; combine with `--max-session-turns` or `--max-wall-time` to cap retries.
+- **`structured_output` is NOT exempt from `--max-session-turns`.** That counter is pre-existing and bumps for every turn including the terminal contract. Size `--max-session-turns` to `N+1` if you want to allow `N` real-work turns under `--json-schema`.
+- **Single-shot vs `--input-format stream-json`:** in stream-json input mode the daemon resets the budget counters at the start of every user message; the budget is per-message, not per-process.
+- **`qwen serve` / ACP sessions:** the daemon ACP session path does NOT currently consult `--max-wall-time` / `--max-tool-calls` from settings.json. These budgets only apply to single-shot `qwen -p` runs and to `--input-format stream-json` sessions. (`qwen serve` does emit the YOLO-no-sandbox warning at boot if `tools.approvalMode: 'yolo'` is set in settings.)
+
+### Recommended combinations
+
+- **Trusted, isolated environment (ephemeral CI runner, container):** `qwen -p "..." --yolo --max-session-turns N --max-wall-time 10m --output-format json`. Pin a turn budget and a wall-clock budget so a stuck agent can't burn through your CI minutes, and capture `--output-format json` for post-run usage / tool-call auditing.
+- **Local machine or shared infra:** also pass `--sandbox` (or set `QWEN_SANDBOX=1`) so shell / write / edit tools run inside the sandbox image.
+- **Long-running CI with retry-on-rate-limit:** combine `QWEN_CODE_UNATTENDED_RETRY=1` with `--max-wall-time`. The retry env keeps the run alive past transient 429 / 529 responses; the wall-clock budget ensures a persistently-failing provider can't extend the job indefinitely.
+- **Bounded auditing / exploration:** for read-only tasks, `--max-tool-calls 25` caps how aggressively the model can grep / read. Combine with `--exclude-tools shell,write,edit` to make the bound meaningful.
+
 ## Examples
 
 ### Code review

package/bundled/qc-helper/docs/features/markdown-rendering.md

@@ -150,6 +150,25 @@ response:
 | `/copy code typescript` | Copies the last `typescript` code block. |
 | `/copy code mermaid 1`  | Copies the first `mermaid` code block.   |
 
+## Selecting an Earlier AI Message
+
+By default `/copy` targets the most recent AI message. Prefix the command with
+a positive integer to copy from the Nth-last AI message instead — handy when
+the latest reply is something low-signal (e.g., a TODO update) and the
+substantive output is one or two turns back.
+
+| Command               | Behavior                                               |
+| --------------------- | ------------------------------------------------------ |
+| `/copy 2`             | Copies the second-to-last AI message in full.          |
+| `/copy 3`             | Copies the third-to-last AI message in full.           |
+| `/copy 2 code python` | Copies the last `python` code block from the 2nd-last. |
+| `/copy 3 latex`       | Copies the last LaTeX block from the 3rd-last message. |
+
+`/copy 1` is equivalent to `/copy`. If `N` exceeds the number of AI messages
+in the session, `/copy` reports the actual count instead of copying anything.
+Without a leading integer, sub-selectors such as `/copy code python 2` keep
+their existing meaning (the 2nd `python` block in the last message).
+
 ## Current Limits
 
 - Mermaid image rendering depends on Mermaid CLI plus terminal image support.
@@ -160,4 +179,5 @@ response:
   Mermaid layout engine.
 - Raw mode is global for rendered Markdown blocks; it is not a per-block toggle.
 - LaTeX rendering covers common symbols and expressions, not full TeX layout.
-- Source copy commands operate on the last AI response.
+- Source copy commands target the last AI response by default, or the Nth-last
+  when invoked as `/copy N ...`.

package/bundled/qc-helper/docs/features/memory.md

@@ -24,15 +24,32 @@ Don't include things Qwen can figure out by reading your code. QWEN.md works bes
 
 ### Where to create QWEN.md
 
-| File                          | Who it applies to                             |
-| ----------------------------- | --------------------------------------------- |
-| `~/.qwen/QWEN.md`             | You, across all your projects                 |
-| `QWEN.md` in the project root | Your whole team (commit it to source control) |
+| File                          | Who it applies to                                |
+| ----------------------------- | ------------------------------------------------ |
+| `~/.qwen/QWEN.md`             | You, across all your projects                    |
+| `QWEN.md` in the project root | Your whole team (commit it to source control)    |
+| `.qwen/QWEN.local.md`         | Only you, only in this project (keep out of git) |
 
-You can have both. Qwen loads all QWEN.md files it finds when you start a session — your personal one plus any in the project.
+You can have any combination of these. Qwen loads all of them when you start a session.
 
 If your repository already has an `AGENTS.md` file for other AI tools, Qwen reads that too. No need to duplicate instructions.
 
+#### When to use `.qwen/QWEN.local.md`
+
+Use it for **project-specific but personal** instructions — things that belong to this project but shouldn't be shared with the team:
+
+- Your own cluster ID, container registry namespace, or cloud account
+- A personal debug command that hardcodes your local environment
+- Notes you want Qwen to know about your work-in-progress, but not commit
+
+It loads **after** the shared project `QWEN.md`, so your local instructions can supplement or override the team's.
+
+**You must gitignore it yourself.** Although `.qwen/` is often treated as a local directory, qwen-code does not generate a `.gitignore` for you, and some projects commit `.qwen/settings.json`. Add this line to your `.gitignore` (or to your global git ignore):
+
+```
+.qwen/QWEN.local.md
+```
+
 ### Generate one automatically with `/init`
 
 Run `/init` and Qwen will analyze your codebase to create a starter QWEN.md with build commands, test instructions, and conventions it finds. If one already exists, it suggests additions instead of overwriting.

package/bundled/qc-helper/docs/features/scheduled-tasks.md

@@ -6,7 +6,7 @@ Scheduled tasks let Qwen Code re-run a prompt automatically on an interval. Use
 
 Tasks are session-scoped: they live in the current Qwen Code process and are gone when you exit. Nothing is written to disk.
 
-> **Note:** Scheduled tasks are an experimental feature. Enable them with `experimental.cron: true` in your [settings](../configuration/settings.md), or set `QWEN_CODE_ENABLE_CRON=1` in your environment.
+> **Tip:** Scheduled tasks are enabled by default. To disable them, set `experimental.cron: false` in your [settings](../configuration/settings.md), or set `QWEN_CODE_DISABLE_CRON=1` in your environment.
 
 ## Schedule a recurring prompt with /loop