@gguf/claw 2026.2.1 → 2026.2.3

package/docs/zh-CN/nodes/media-understanding.md

@@ -0,0 +1,381 @@
+---
+read_when:
+  - 设计或重构媒体理解功能
+  - 调优入站音频/视频/图片预处理
+summary: 入站图片/音频/视频理解（可选），支持提供商 + CLI 回退
+title: 媒体理解
+x-i18n:
+  generated_at: "2026-02-01T21:18:50Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: f6c575662b7fcbf0b62c46e3fdfa4cdb7cfd455513097e4a2cdec8a34cbdbd48
+  source_path: nodes/media-understanding.md
+  workflow: 15
+---
+
+# 媒体理解（入站） — 2026-01-17
+
+OpenClaw 可以在回复管道运行之前**总结入站媒体**（图片/音频/视频）。它会在本地工具或提供商密钥可用时自动检测，也可以禁用或自定义。如果理解功能关闭，模型仍会照常接收原始文件/URL。
+
+## 目标
+
+- 可选：将入站媒体预处理为简短文本，以加快路由 + 改善命令解析。
+- 始终保留原始媒体向模型的传递。
+- 支持**提供商 API** 和 **CLI 回退**。
+- 允许多个模型按顺序回退（错误/大小/超时）。
+
+## 高层行为
+
+1. 收集入站附件（`MediaPaths`、`MediaUrls`、`MediaTypes`）。
+2. 对每个已启用的能力（图片/音频/视频），按策略选择附件（默认：**第一个**）。
+3. 选择第一个符合条件的模型条目（大小 + 能力 + 认证）。
+4. 如果模型失败或媒体过大，**回退到下一个条目**。
+5. 成功时：
+   - `Body` 变为 `[Image]`、`[Audio]` 或 `[Video]` 块。
+   - 音频设置 `{{Transcript}}`；命令解析在有说明文字时使用说明文字，否则使用转录文本。
+   - 说明文字作为 `User text:` 保留在块内。
+
+如果理解失败或已禁用，**回复流程继续**使用原始正文 + 附件。
+
+## 配置概览
+
+`tools.media` 支持**共享模型**加每能力覆盖：
+
+- `tools.media.models`：共享模型列表（使用 `capabilities` 进行能力筛选）。
+- `tools.media.image` / `tools.media.audio` / `tools.media.video`：
+  - 默认值（`prompt`、`maxChars`、`maxBytes`、`timeoutSeconds`、`language`）
+  - 提供商覆盖（`baseUrl`、`headers`、`providerOptions`）
+  - Deepgram 音频选项通过 `tools.media.audio.providerOptions.deepgram` 设置
+  - 可选的**每能力 `models` 列表**（优先于共享模型）
+  - `attachments` 策略（`mode`、`maxAttachments`、`prefer`）
+  - `scope`（可选，按渠道/聊天类型/会话键筛选）
+- `tools.media.concurrency`：最大并发能力运行数（默认 **2**）。
+
+```json5
+{
+  tools: {
+    media: {
+      models: [
+        /* 共享列表 */
+      ],
+      image: {
+        /* 可选覆盖 */
+      },
+      audio: {
+        /* 可选覆盖 */
+      },
+      video: {
+        /* 可选覆盖 */
+      },
+    },
+  },
+}
+```
+
+### 模型条目
+
+每个 `models[]` 条目可以是**提供商**或 **CLI** 类型：
+
+```json5
+{
+  type: "provider", // 省略时默认
+  provider: "openai",
+  model: "gpt-5.2",
+  prompt: "Describe the image in <= 500 chars.",
+  maxChars: 500,
+  maxBytes: 10485760,
+  timeoutSeconds: 60,
+  capabilities: ["image"], // 可选，用于多模态条目
+  profile: "vision-profile",
+  preferredProfile: "vision-fallback",
+}
+```
+
+```json5
+{
+  type: "cli",
+  command: "gemini",
+  args: [
+    "-m",
+    "gemini-3-flash",
+    "--allowed-tools",
+    "read_file",
+    "Read the media at {{MediaPath}} and describe it in <= {{MaxChars}} characters.",
+  ],
+  maxChars: 500,
+  maxBytes: 52428800,
+  timeoutSeconds: 120,
+  capabilities: ["video", "image"],
+}
+```
+
+CLI 模板还可以使用：
+
+- `{{MediaDir}}`（包含媒体文件的目录）
+- `{{OutputDir}}`（为本次运行创建的临时目录）
+- `{{OutputBase}}`（临时文件基础路径，无扩展名）
+
+## 默认值和限制
+
+推荐默认值：
+
+- `maxChars`：图片/视频为 **500**（简短，适合命令解析）
+- `maxChars`：音频**未设置**（完整转录，除非你设置限制）
+- `maxBytes`：
+  - 图片：**10MB**
+  - 音频：**20MB**
+  - 视频：**50MB**
+
+规则：
+
+- 如果媒体超过 `maxBytes`，该模型被跳过，**尝试下一个模型**。
+- 如果模型返回超过 `maxChars`，输出会被裁剪。
+- `prompt` 默认为简单的"描述该 {媒体}。"加上 `maxChars` 指导（仅图片/视频）。
+- 如果 `<capability>.enabled: true` 但未配置模型，OpenClaw 会在其提供商支持该能力时尝试**当前回复模型**。
+
+### 自动检测媒体理解（默认）
+
+如果 `tools.media.<capability>.enabled` **未**设置为 `false` 且你未配置模型，OpenClaw 会按以下顺序自动检测，并在**找到第一个可用选项时停止**：
+
+1. **本地 CLI**（仅音频；如已安装）
+   - `sherpa-onnx-offline`（需要 `SHERPA_ONNX_MODEL_DIR` 包含 encoder/decoder/joiner/tokens）
+   - `whisper-cli`（`whisper-cpp`；使用 `WHISPER_CPP_MODEL` 或内置的 tiny 模型）
+   - `whisper`（Python CLI；自动下载模型）
+2. **Gemini CLI**（`gemini`）使用 `read_many_files`
+3. **提供商密钥**
+   - 音频：OpenAI → Groq → Deepgram → Google
+   - 图片：OpenAI → Anthropic → Google → MiniMax
+   - 视频：Google
+
+要禁用自动检测，请设置：
+
+```json5
+{
+  tools: {
+    media: {
+      audio: {
+        enabled: false,
+      },
+    },
+  },
+}
+```
+
+注意：二进制检测在 macOS/Linux/Windows 上采用尽力而为的方式；请确保 CLI 在 `PATH` 中（我们会展开 `~`），或通过完整命令路径设置显式 CLI 模型。
+
+## 能力（可选）
+
+如果你设置了 `capabilities`，该条目仅针对指定的媒体类型运行。对于共享列表，OpenClaw 可以推断默认值：
+
+- `openai`、`anthropic`、`minimax`：**图片**
+- `google`（Gemini API）：**图片 + 音频 + 视频**
+- `groq`：**音频**
+- `deepgram`：**音频**
+
+对于 CLI 条目，**请显式设置 `capabilities`** 以避免意外匹配。
+如果省略 `capabilities`，该条目对其所在列表中的所有类型均有效。
+
+## 提供商支持矩阵（OpenClaw 集成）
+
+| 能力 | 提供商集成                                     | 说明                                    |
+| ---- | ---------------------------------------------- | --------------------------------------- |
+| 图片 | OpenAI / Anthropic / Google / 其他通过 `pi-ai` | 注册表中任何支持图片的模型均可使用。    |
+| 音频 | OpenAI、Groq、Deepgram、Google                 | 提供商转录（Whisper/Deepgram/Gemini）。 |
+| 视频 | Google（Gemini API）                           | 提供商视频理解。                        |
+
+## 推荐提供商
+
+**图片**
+
+- 如果当前模型支持图片，优先使用当前模型。
+- 推荐默认值：`openai/gpt-5.2`、`anthropic/claude-opus-4-5`、`google/gemini-3-pro-preview`。
+
+**音频**
+
+- `openai/gpt-4o-mini-transcribe`、`groq/whisper-large-v3-turbo` 或 `deepgram/nova-3`。
+- CLI 回退：`whisper-cli`（whisper-cpp）或 `whisper`。
+- Deepgram 设置：[Deepgram（音频转录）](/providers/deepgram)。
+
+**视频**
+
+- `google/gemini-3-flash-preview`（快速）、`google/gemini-3-pro-preview`（更丰富）。
+- CLI 回退：`gemini` CLI（支持对视频/音频使用 `read_file`）。
+
+## 附件策略
+
+每能力的 `attachments` 控制处理哪些附件：
+
+- `mode`：`first`（默认）或 `all`
+- `maxAttachments`：处理数量上限（默认 **1**）
+- `prefer`：`first`、`last`、`path`、`url`
+
+当 `mode: "all"` 时，输出标记为 `[Image 1/2]`、`[Audio 2/2]` 等。
+
+## 配置示例
+
+### 1) 共享模型列表 + 覆盖
+
+```json5
+{
+  tools: {
+    media: {
+      models: [
+        { provider: "openai", model: "gpt-5.2", capabilities: ["image"] },
+        {
+          provider: "google",
+          model: "gemini-3-flash-preview",
+          capabilities: ["image", "audio", "video"],
+        },
+        {
+          type: "cli",
+          command: "gemini",
+          args: [
+            "-m",
+            "gemini-3-flash",
+            "--allowed-tools",
+            "read_file",
+            "Read the media at {{MediaPath}} and describe it in <= {{MaxChars}} characters.",
+          ],
+          capabilities: ["image", "video"],
+        },
+      ],
+      audio: {
+        attachments: { mode: "all", maxAttachments: 2 },
+      },
+      video: {
+        maxChars: 500,
+      },
+    },
+  },
+}
+```
+
+### 2) 仅音频 + 视频（图片关闭）
+
+```json5
+{
+  tools: {
+    media: {
+      audio: {
+        enabled: true,
+        models: [
+          { provider: "openai", model: "gpt-4o-mini-transcribe" },
+          {
+            type: "cli",
+            command: "whisper",
+            args: ["--model", "base", "{{MediaPath}}"],
+          },
+        ],
+      },
+      video: {
+        enabled: true,
+        maxChars: 500,
+        models: [
+          { provider: "google", model: "gemini-3-flash-preview" },
+          {
+            type: "cli",
+            command: "gemini",
+            args: [
+              "-m",
+              "gemini-3-flash",
+              "--allowed-tools",
+              "read_file",
+              "Read the media at {{MediaPath}} and describe it in <= {{MaxChars}} characters.",
+            ],
+          },
+        ],
+      },
+    },
+  },
+}
+```
+
+### 3) 可选图片理解
+
+```json5
+{
+  tools: {
+    media: {
+      image: {
+        enabled: true,
+        maxBytes: 10485760,
+        maxChars: 500,
+        models: [
+          { provider: "openai", model: "gpt-5.2" },
+          { provider: "anthropic", model: "claude-opus-4-5" },
+          {
+            type: "cli",
+            command: "gemini",
+            args: [
+              "-m",
+              "gemini-3-flash",
+              "--allowed-tools",
+              "read_file",
+              "Read the media at {{MediaPath}} and describe it in <= {{MaxChars}} characters.",
+            ],
+          },
+        ],
+      },
+    },
+  },
+}
+```
+
+### 4) 多模态单条目（显式能力）
+
+```json5
+{
+  tools: {
+    media: {
+      image: {
+        models: [
+          {
+            provider: "google",
+            model: "gemini-3-pro-preview",
+            capabilities: ["image", "video", "audio"],
+          },
+        ],
+      },
+      audio: {
+        models: [
+          {
+            provider: "google",
+            model: "gemini-3-pro-preview",
+            capabilities: ["image", "video", "audio"],
+          },
+        ],
+      },
+      video: {
+        models: [
+          {
+            provider: "google",
+            model: "gemini-3-pro-preview",
+            capabilities: ["image", "video", "audio"],
+          },
+        ],
+      },
+    },
+  },
+}
+```
+
+## 状态输出
+
+当媒体理解运行时，`/status` 包含一行简短摘要：
+
+```
+📎 Media: image ok (openai/gpt-5.2) · audio skipped (maxBytes)
+```
+
+这显示了每个能力的结果以及适用时选择的提供商/模型。
+
+## 注意事项
+
+- 理解是**尽力而为**的。错误不会阻塞回复。
+- 即使理解功能禁用，附件仍会传递给模型。
+- 使用 `scope` 限制理解功能的运行范围（例如仅私聊）。
+
+## 相关文档
+
+- [配置](/gateway/configuration)
+- [图片与媒体支持](/nodes/images)

package/docs/zh-CN/nodes/talk.md

@@ -0,0 +1,97 @@
+---
+read_when:
+  - 在 macOS/iOS/Android 上实现对话模式
+  - 更改语音/TTS/打断行为
+summary: 对话模式：使用 ElevenLabs TTS 进行连续语音对话
+title: 对话模式
+x-i18n:
+  generated_at: "2026-02-01T21:18:51Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: ecbc3701c9e9502970cf13227fedbc9714d13668d8f4f3988fef2a4d68116a42
+  source_path: nodes/talk.md
+  workflow: 15
+---
+
+# 对话模式
+
+对话模式是一个连续的语音对话循环：
+
+1. 监听语音
+2. 将转录文本发送给模型（主会话，chat.send）
+3. 等待响应
+4. 通过 ElevenLabs 朗读（流式播放）
+
+## 行为（macOS）
+
+- 启用对话模式时显示**常驻悬浮窗**。
+- **监听 → 思考 → 朗读**阶段切换。
+- **短暂停顿**（静音窗口）后，当前转录文本会被发送。
+- 回复会**写入 WebChat**（与打字相同）。
+- **语音打断**（默认开启）：如果用户在助手朗读时开始说话，会停止播放并记录打断时间戳用于下一次提示。
+
+## 回复中的语音指令
+
+助手可以在回复前添加**单行 JSON** 来控制语音：
+
+```json
+{ "voice": "<voice-id>", "once": true }
+```
+
+规则：
+
+- 仅限第一个非空行。
+- 未知键会被忽略。
+- `once: true` 仅应用于当前回复。
+- 不带 `once` 时，该语音将成为对话模式的新默认语音。
+- JSON 行在 TTS 播放前会被移除。
+
+支持的键：
+
+- `voice` / `voice_id` / `voiceId`
+- `model` / `model_id` / `modelId`
+- `speed`、`rate`（WPM）、`stability`、`similarity`、`style`、`speakerBoost`
+- `seed`、`normalize`、`lang`、`output_format`、`latency_tier`
+- `once`
+
+## 配置（`~/.openclaw/openclaw.json`）
+
+```json5
+{
+  talk: {
+    voiceId: "elevenlabs_voice_id",
+    modelId: "eleven_v3",
+    outputFormat: "mp3_44100_128",
+    apiKey: "elevenlabs_api_key",
+    interruptOnSpeech: true,
+  },
+}
+```
+
+默认值：
+
+- `interruptOnSpeech`：true
+- `voiceId`：回退到 `ELEVENLABS_VOICE_ID` / `SAG_VOICE_ID`（或在 API 密钥可用时使用第一个 ElevenLabs 语音）
+- `modelId`：未设置时默认为 `eleven_v3`
+- `apiKey`：回退到 `ELEVENLABS_API_KEY`（或 Gateway网关 shell 配置文件，如可用）
+- `outputFormat`：macOS/iOS 默认为 `pcm_44100`，Android 默认为 `pcm_24000`（设置 `mp3_*` 以强制 MP3 流式传输）
+
+## macOS UI
+
+- 菜单栏切换：**Talk**
+- 配置标签页：**Talk Mode** 组（语音 ID + 打断开关）
+- 悬浮窗：
+  - **监听中**：云朵随麦克风音量脉动
+  - **思考中**：下沉动画
+  - **朗读中**：辐射圆环
+  - 点击云朵：停止朗读
+  - 点击 X：退出对话模式
+
+## 注意事项
+
+- 需要语音识别 + 麦克风权限。
+- 使用 `chat.send` 对会话键 `main` 发送。
+- TTS 使用 ElevenLabs 流式 API，配合 `ELEVENLABS_API_KEY`，在 macOS/iOS/Android 上进行增量播放以降低延迟。
+- `eleven_v3` 的 `stability` 验证值为 `0.0`、`0.5` 或 `1.0`；其他模型接受 `0..1`。
+- `latency_tier` 设置时验证值为 `0..4`。
+- Android 支持 `pcm_16000`、`pcm_22050`、`pcm_24000` 和 `pcm_44100` 输出格式，用于低延迟 AudioTrack 流式传输。

package/docs/zh-CN/nodes/voicewake.md

@@ -0,0 +1,72 @@
+---
+read_when:
+  - 更改语音唤醒词行为或默认值
+  - 添加需要唤醒词同步的新节点平台
+summary: 全局语音唤醒词（Gateway网关拥有）及其在节点间的同步方式
+title: 语音唤醒
+x-i18n:
+  generated_at: "2026-02-01T21:19:01Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: eb34f52dfcdc3fc1ae088ae1f621f245546d3cf388299fbeea62face61788c37
+  source_path: nodes/voicewake.md
+  workflow: 15
+---
+
+# 语音唤醒（全局唤醒词）
+
+OpenClaw 将**唤醒词视为由 Gateway网关拥有的单一全局列表**。
+
+- **没有按节点自定义的唤醒词**。
+- **任何节点/应用界面均可编辑**该列表；更改由 Gateway网关持久化并广播给所有人。
+- 每个设备仍保留自己的**语音唤醒 启用/禁用**开关（本地用户体验和权限各异）。
+
+## 存储（Gateway网关主机）
+
+唤醒词存储在 Gateway网关机器上：
+
+- `~/.openclaw/settings/voicewake.json`
+
+结构：
+
+```json
+{ "triggers": ["openclaw", "claude", "computer"], "updatedAtMs": 1730000000000 }
+```
+
+## 协议
+
+### 方法
+
+- `voicewake.get` → `{ triggers: string[] }`
+- `voicewake.set`，参数 `{ triggers: string[] }` → `{ triggers: string[] }`
+
+说明：
+
+- 触发词会被规范化（去除空白、丢弃空值）。空列表会回退到默认值。
+- 出于安全考虑，会强制执行限制（数量/长度上限）。
+
+### 事件
+
+- `voicewake.changed` 载荷 `{ triggers: string[] }`
+
+接收方：
+
+- 所有 WebSocket 客户端（macOS 应用、WebChat 等）
+- 所有已连接的节点（iOS/Android），节点连接时也会作为初始"当前状态"推送。
+
+## 客户端行为
+
+### macOS 应用
+
+- 使用全局列表来控制 `VoiceWakeRuntime` 触发词。
+- 在语音唤醒设置中编辑"触发词"会调用 `voicewake.set`，然后依赖广播保持其他客户端同步。
+
+### iOS 节点
+
+- 使用全局列表进行 `VoiceWakeManager` 触发词检测。
+- 在设置中编辑唤醒词会调用 `voicewake.set`（通过 Gateway网关 WS），同时保持本地唤醒词检测的即时响应。
+
+### Android 节点
+
+- 在设置中提供唤醒词编辑器。
+- 通过 Gateway网关 WS 调用 `voicewake.set`，使编辑在所有设备间同步。

package/docs/zh-CN/northflank.mdx

@@ -0,0 +1,60 @@
+---
+title: 在 Northflank 上部署
+x-i18n:
+  generated_at: "2026-02-01T21:19:03Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: ad0be8dda41c51d0b6424259316db1b22be5216434f5879f21a5e8c60e0a2ee0
+  source_path: northflank.mdx
+  workflow: 15
+---
+
+通过一键模板在 Northflank 上部署 OpenClaw，然后在浏览器中完成设置。
+这是最简单的"无需在服务器上使用终端"的方式：Northflank 为你运行 Gateway网关，
+你通过 `/setup` 网页向导配置一切。
+
+## 如何开始
+
+1. 点击 [Deploy OpenClaw](https://northflank.com/stacks/deploy-openclaw) 打开模板。
+2. 如果你还没有账户，请创建一个 [Northflank 账户](https://app.northflank.com/signup)。
+3. 点击 **Deploy OpenClaw now**。
+4. 设置必需的环境变量：`SETUP_PASSWORD`。
+5. 点击 **Deploy stack** 构建并运行 OpenClaw 模板。
+6. 等待部署完成，然后点击 **View resources**。
+7. 打开 OpenClaw 服务。
+8. 打开公开的 OpenClaw URL，在 `/setup` 完成设置。
+9. 在 `/openclaw` 打开控制面板 UI。
+
+## 你将获得
+
+- 托管的 OpenClaw Gateway网关 + 控制面板 UI
+- `/setup` 处的网页设置向导（无需终端命令）
+- 通过 Northflank Volume（`/data`）实现持久化存储，配置/凭据/工作区在重新部署后不会丢失
+
+## 设置流程
+
+1. 访问 `https://<your-northflank-domain>/setup` 并输入你的 `SETUP_PASSWORD`。
+2. 选择模型/认证提供商并粘贴你的密钥。
+3. （可选）添加 Telegram/Discord/Slack 令牌。
+4. 点击 **Run setup**。
+5. 在 `https://<your-northflank-domain>/openclaw` 打开控制面板 UI。
+
+如果 Telegram 私信设置为配对模式，设置向导可以审批配对码。
+
+## 获取聊天令牌
+
+### Telegram 机器人令牌
+
+1. 在 Telegram 中给 `@BotFather` 发消息
+2. 运行 `/newbot`
+3. 复制令牌（格式如 `123456789:AA...`）
+4. 将其粘贴到 `/setup` 中
+
+### Discord 机器人令牌
+
+1. 前往 https://discord.com/developers/applications
+2. **New Application** → 选择一个名称
+3. **Bot** → **Add Bot**
+4. 在 Bot → Privileged Gateway Intents 下**启用 MESSAGE CONTENT INTENT**（必需，否则机器人启动时会崩溃）
+5. 复制 **Bot Token** 并粘贴到 `/setup` 中
+6. 邀请机器人加入你的服务器（OAuth2 URL Generator；权限范围：`bot`、`applications.commands`）

package/docs/zh-CN/perplexity.md

@@ -0,0 +1,84 @@
+---
+read_when:
+  - 你想使用 Perplexity Sonar 进行网络搜索
+  - 你需要设置 PERPLEXITY_API_KEY 或 OpenRouter
+summary: Perplexity Sonar 的 web_search 设置
+title: Perplexity Sonar
+x-i18n:
+  generated_at: "2026-02-01T21:19:10Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 264d08e62e3bec854e378dad345ca209d139cd19b0469f3b25f88bb63b73ba00
+  source_path: perplexity.md
+  workflow: 15
+---
+
+# Perplexity Sonar
+
+OpenClaw 可以使用 Perplexity Sonar 作为 `web_search` 工具。你可以通过 Perplexity 的直连 API 或通过 OpenRouter 连接。
+
+## API 选项
+
+### Perplexity（直连）
+
+- Base URL：https://api.perplexity.ai
+- 环境变量：`PERPLEXITY_API_KEY`
+
+### OpenRouter（替代方案）
+
+- Base URL：https://openrouter.ai/api/v1
+- 环境变量：`OPENROUTER_API_KEY`
+- 支持预付费/加密货币积分。
+
+## 配置示例
+
+```json5
+{
+  tools: {
+    web: {
+      search: {
+        provider: "perplexity",
+        perplexity: {
+          apiKey: "pplx-...",
+          baseUrl: "https://api.perplexity.ai",
+          model: "perplexity/sonar-pro",
+        },
+      },
+    },
+  },
+}
+```
+
+## 从 Brave 切换
+
+```json5
+{
+  tools: {
+    web: {
+      search: {
+        provider: "perplexity",
+        perplexity: {
+          apiKey: "pplx-...",
+          baseUrl: "https://api.perplexity.ai",
+        },
+      },
+    },
+  },
+}
+```
+
+如果同时设置了 `PERPLEXITY_API_KEY` 和 `OPENROUTER_API_KEY`，请设置 `tools.web.search.perplexity.baseUrl`（或 `tools.web.search.perplexity.apiKey`）以消除歧义。
+
+如果未设置 base URL，OpenClaw 会根据 API 密钥来源选择默认值：
+
+- `PERPLEXITY_API_KEY` 或 `pplx-...` → 直连 Perplexity（`https://api.perplexity.ai`）
+- `OPENROUTER_API_KEY` 或 `sk-or-...` → OpenRouter（`https://openrouter.ai/api/v1`）
+- 未知密钥格式 → OpenRouter（安全回退）
+
+## 模型
+
+- `perplexity/sonar` — 带网络搜索的快速问答
+- `perplexity/sonar-pro`（默认） — 多步推理 + 网络搜索
+- `perplexity/sonar-reasoning-pro` — 深度研究
+
+请参阅 [Web 工具](/tools/web) 了解全部 web_search 配置。