@symerian/symi 3.0.21 → 3.0.22

package/docs/zh-CN/tools/web.md

@@ -1,257 +0,0 @@
----
-read_when:
-  - 你想启用 web_search 或 web_fetch
-  - 你需要设置 Brave Search API 密钥
-  - 你想使用 Perplexity Sonar 进行网络搜索
-summary: Web 搜索 + 获取工具（Brave Search API、Perplexity 直连/OpenRouter）
-title: Web 工具
-x-i18n:
-  generated_at: "2026-02-03T10:12:43Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 760b706cc966cb421e370f10f8e76047f8ca9fe0a106d90c05d979976789465a
-  source_path: tools/web.md
-  workflow: 15
----
-
-# Web 工具
-
-Symi 提供两个轻量级 Web 工具：
-
-- `web_search` — 通过 Brave Search API（默认）或 Perplexity Sonar（直连或通过 OpenRouter）搜索网络。
-- `web_fetch` — HTTP 获取 + 可读性提取（HTML → markdown/文本）。
-
-这些**不是**浏览器自动化。对于 JS 密集型网站或需要登录的情况，请使用[浏览器工具](/tools/browser)。
-
-## 工作原理
-
-- `web_search` 调用你配置的提供商并返回结果。
-  - **Brave**（默认）：返回结构化结果（标题、URL、摘要）。
-  - **Perplexity**：返回带有实时网络搜索引用的 AI 综合答案。
-- 结果按查询缓存 15 分钟（可配置）。
-- `web_fetch` 执行普通 HTTP GET 并提取可读内容（HTML → markdown/文本）。它**不**执行 JavaScript。
-- `web_fetch` 默认启用（除非显式禁用）。
-
-## 选择搜索提供商
-
-| 提供商            | 优点                     | 缺点                               | API 密钥                                     |
-| ----------------- | ------------------------ | ---------------------------------- | -------------------------------------------- |
-| **Brave**（默认） | 快速、结构化结果、免费层 | 传统搜索结果                       | `BRAVE_API_KEY`                              |
-| **Perplexity**    | AI 综合答案、引用、实时  | 需要 Perplexity 或 OpenRouter 访问 | `OPENROUTER_API_KEY` 或 `PERPLEXITY_API_KEY` |
-
-参见 [Brave Search 设置](/brave-search) 和 [Perplexity Sonar](/perplexity) 了解提供商特定详情。
-
-在配置中设置提供商：
-
-```json5
-{
-  tools: {
-    web: {
-      search: {
-        provider: "brave", // 或 "perplexity"
-      },
-    },
-  },
-}
-```
-
-示例：切换到 Perplexity Sonar（直连 API）：
-
-```json5
-{
-  tools: {
-    web: {
-      search: {
-        provider: "perplexity",
-        perplexity: {
-          apiKey: "pplx-...",
-          baseUrl: "https://api.perplexity.ai",
-          model: "perplexity/sonar-pro",
-        },
-      },
-    },
-  },
-}
-```
-
-## 获取 Brave API 密钥
-
-1. 在 https://brave.com/search/api/ 创建 Brave Search API 账户
-2. 在控制面板中，选择 **Data for Search** 计划（不是"Data for AI"）并生成 API 密钥。
-3. 运行 `symi configure --section web` 将密钥存储在配置中（推荐），或在环境中设置 `BRAVE_API_KEY`。
-
-Brave 提供免费层和付费计划；查看 Brave API 门户了解当前限制和定价。
-
-### 在哪里设置密钥（推荐）
-
-**推荐：** 运行 `symi configure --section web`。它将密钥存储在 `~/.symi/symi.json` 的 `tools.web.search.apiKey` 下。
-
-**环境变量替代方案：** 在 Gateway 网关进程环境中设置 `BRAVE_API_KEY`。对于 Gateway 网关安装，将其放在 `~/.symi/.env`（或你的服务环境）中。参见[环境变量](/help/faq#how-does-symi-load-environment-variables)。
-
-## 使用 Perplexity（直连或通过 OpenRouter）
-
-Perplexity Sonar 模型具有内置的网络搜索功能，并返回带有引用的 AI 综合答案。你可以通过 OpenRouter 使用它们（无需信用卡 - 支持加密货币/预付费）。
-
-### 获取 OpenRouter API 密钥
-
-1. 在 https://openrouter.ai/ 创建账户
-2. 添加额度（支持加密货币、预付费或信用卡）
-3. 在账户设置中生成 API 密钥
-
-### 设置 Perplexity 搜索
-
-```json5
-{
-  tools: {
-    web: {
-      search: {
-        enabled: true,
-        provider: "perplexity",
-        perplexity: {
-          // API 密钥（如果设置了 OPENROUTER_API_KEY 或 PERPLEXITY_API_KEY 则可选）
-          apiKey: "sk-or-v1-...",
-          // 基础 URL（如果省略则根据密钥感知默认值）
-          baseUrl: "https://openrouter.ai/api/v1",
-          // 模型（默认为 perplexity/sonar-pro）
-          model: "perplexity/sonar-pro",
-        },
-      },
-    },
-  },
-}
-```
-
-**环境变量替代方案：** 在 Gateway 网关环境中设置 `OPENROUTER_API_KEY` 或 `PERPLEXITY_API_KEY`。对于 Gateway 网关安装，将其放在 `~/.symi/.env` 中。
-
-如果未设置基础 URL，Symi 会根据 API 密钥来源选择默认值：
-
-- `PERPLEXITY_API_KEY` 或 `pplx-...` → `https://api.perplexity.ai`
-- `OPENROUTER_API_KEY` 或 `sk-or-...` → `https://openrouter.ai/api/v1`
-- 未知密钥格式 → OpenRouter（安全回退）
-
-### 可用的 Perplexity 模型
-
-| 模型                             | 描述                 | 最适合   |
-| -------------------------------- | -------------------- | -------- |
-| `perplexity/sonar`               | 带网络搜索的快速问答 | 快速查询 |
-| `perplexity/sonar-pro`（默认）   | 带网络搜索的多步推理 | 复杂问题 |
-| `perplexity/sonar-reasoning-pro` | 思维链分析           | 深度研究 |
-
-## web_search
-
-使用配置的提供商搜索网络。
-
-### 要求
-
-- `tools.web.search.enabled` 不能为 `false`（默认：启用）
-- 所选提供商的 API 密钥：
-  - **Brave**：`BRAVE_API_KEY` 或 `tools.web.search.apiKey`
-  - **Perplexity**：`OPENROUTER_API_KEY`、`PERPLEXITY_API_KEY` 或 `tools.web.search.perplexity.apiKey`
-
-### 配置
-
-```json5
-{
-  tools: {
-    web: {
-      search: {
-        enabled: true,
-        apiKey: "BRAVE_API_KEY_HERE", // 如果设置了 BRAVE_API_KEY 则可选
-        maxResults: 5,
-        timeoutSeconds: 30,
-        cacheTtlMinutes: 15,
-      },
-    },
-  },
-}
-```
-
-### 工具参数
-
-- `query`（必需）
-- `count`（1–10；默认来自配置）
-- `country`（可选）：用于特定地区结果的 2 字母国家代码（例如"DE"、"US"、"ALL"）。如果省略，Brave 选择其默认地区。
-- `search_lang`（可选）：搜索结果的 ISO 语言代码（例如"de"、"en"、"fr"）
-- `ui_lang`（可选）：UI 元素的 ISO 语言代码
-- `freshness`（可选，仅限 Brave）：按发现时间过滤（`pd`、`pw`、`pm`、`py` 或 `YYYY-MM-DDtoYYYY-MM-DD`）
-
-**示例：**
-
-```javascript
-// 德国特定搜索
-await web_search({
-  query: "TV online schauen",
-  count: 10,
-  country: "DE",
-  search_lang: "de",
-});
-
-// 带法语 UI 的法语搜索
-await web_search({
-  query: "actualités",
-  country: "FR",
-  search_lang: "fr",
-  ui_lang: "fr",
-});
-
-// 最近结果（过去一周）
-await web_search({
-  query: "TMBG interview",
-  freshness: "pw",
-});
-```
-
-## web_fetch
-
-获取 URL 并提取可读内容。
-
-### 要求
-
-- `tools.web.fetch.enabled` 不能为 `false`（默认：启用）
-- 可选的 Firecrawl 回退：设置 `tools.web.fetch.firecrawl.apiKey` 或 `FIRECRAWL_API_KEY`。
-
-### 配置
-
-```json5
-{
-  tools: {
-    web: {
-      fetch: {
-        enabled: true,
-        maxChars: 50000,
-        timeoutSeconds: 30,
-        cacheTtlMinutes: 15,
-        maxRedirects: 3,
-        userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_7_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36",
-        readability: true,
-        firecrawl: {
-          enabled: true,
-          apiKey: "FIRECRAWL_API_KEY_HERE", // 如果设置了 FIRECRAWL_API_KEY 则可选
-          baseUrl: "https://api.firecrawl.dev",
-          onlyMainContent: true,
-          maxAgeMs: 86400000, // 毫秒（1 天）
-          timeoutSeconds: 60,
-        },
-      },
-    },
-  },
-}
-```
-
-### 工具参数
-
-- `url`（必需，仅限 http/https）
-- `extractMode`（`markdown` | `text`）
-- `maxChars`（截断长页面）
-
-注意：
-
-- `web_fetch` 首先使用 Readability（主要内容提取），然后使用 Firecrawl（如果已配置）。如果两者都失败，工具返回错误。
-- Firecrawl 请求使用机器人规避模式并默认缓存结果。
-- `web_fetch` 默认发送类 Chrome 的 User-Agent 和 `Accept-Language`；如需要可覆盖 `userAgent`。
-- `web_fetch` 阻止私有/内部主机名并重新检查重定向（用 `maxRedirects` 限制）。
-- `web_fetch` 是尽力提取；某些网站需要浏览器工具。
-- 参见 [Firecrawl](/tools/firecrawl) 了解密钥设置和服务详情。
-- 响应会被缓存（默认 15 分钟）以减少重复获取。
-- 如果你使用工具配置文件/允许列表，添加 `web_search`/`web_fetch` 或 `group:web`。
-- 如果缺少 Brave 密钥，`web_search` 返回一个简短的设置提示和文档链接。

package/docs/zh-CN/tts.md

@@ -1,373 +0,0 @@
----
-read_when:
-  - 为回复启用文本转语音
-  - 配置 TTS 提供商或限制
-  - 使用 /tts 命令
-summary: 出站回复的文本转语音（TTS）
-title: 文本转语音
-x-i18n:
-  generated_at: "2026-02-03T10:13:55Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 070ff0cc8592f64c6c9e4ddaddc7e8fba82f0692ceded6fe833ec9ba5b61e6fb
-  source_path: tts.md
-  workflow: 15
----
-
-# 文本转语音（TTS）
-
-Symi 可以使用 ElevenLabs、OpenAI 或 Edge TTS 将出站回复转换为音频。它可以在任何 Symi 能发送音频的地方工作；Telegram 会显示圆形语音消息气泡。
-
-## 支持的服务
-
-- **ElevenLabs**（主要或备用提供商）
-- **OpenAI**（主要或备用提供商；也用于摘要）
-- **Edge TTS**（主要或备用提供商；使用 `node-edge-tts`，无 API 密钥时为默认）
-
-### Edge TTS 注意事项
-
-Edge TTS 通过 `node-edge-tts` 库使用 Microsoft Edge 的在线神经网络 TTS 服务。它是托管服务（非本地），使用 Microsoft 的端点，不需要 API 密钥。`node-edge-tts` 公开了语音配置选项和输出格式，但并非所有选项都被 Edge 服务支持。citeturn2search0
-
-由于 Edge TTS 是一个没有公布 SLA 或配额的公共 Web 服务，请将其视为尽力而为。如果你需要有保证的限制和支持，请使用 OpenAI 或 ElevenLabs。Microsoft 的语音 REST API 记录了每个请求 10 分钟的音频限制；Edge TTS 没有公布限制，所以假设类似或更低的限制。citeturn0search3
-
-## 可选密钥
-
-如果你想使用 OpenAI 或 ElevenLabs：
-
-- `ELEVENLABS_API_KEY`（或 `XI_API_KEY`）
-- `OPENAI_API_KEY`
-
-Edge TTS **不**需要 API 密钥。如果没有找到 API 密钥，Symi 默认使用 Edge TTS（除非通过 `messages.tts.edge.enabled=false` 禁用）。
-
-如果配置了多个提供商，首先使用选定的提供商，其他作为备用选项。自动摘要使用配置的 `summaryModel`（或 `agents.defaults.model.primary`），所以如果你启用摘要，该提供商也必须经过认证。
-
-## 服务链接
-
-- [OpenAI 文本转语音指南](https://platform.openai.com/docs/guides/text-to-speech)
-- [OpenAI 音频 API 参考](https://platform.openai.com/docs/api-reference/audio)
-- [ElevenLabs 文本转语音](https://elevenlabs.io/docs/api-reference/text-to-speech)
-- [ElevenLabs 认证](https://elevenlabs.io/docs/api-reference/authentication)
-- [node-edge-tts](https://github.com/SchneeHertz/node-edge-tts)
-- [Microsoft 语音输出格式](https://learn.microsoft.com/azure/ai-services/speech-service/rest-text-to-speech#audio-outputs)
-
-## 默认启用吗？
-
-不是。自动 TTS 默认**关闭**。在配置中使用 `messages.tts.auto` 或在每个会话中使用 `/tts always`（别名：`/tts on`）启用它。
-
-一旦 TTS 开启，Edge TTS **是**默认启用的，并在没有 OpenAI 或 ElevenLabs API 密钥时自动使用。
-
-## 配置
-
-TTS 配置位于 `symi.json` 中的 `messages.tts` 下。完整 schema 在 [Gateway 网关配置](/gateway/configuration)中。
-
-### 最小配置（启用 + 提供商）
-
-```json5
-{
-  messages: {
-    tts: {
-      auto: "always",
-      provider: "elevenlabs",
-    },
-  },
-}
-```
-
-### OpenAI 主要，ElevenLabs 备用
-
-```json5
-{
-  messages: {
-    tts: {
-      auto: "always",
-      provider: "openai",
-      summaryModel: "openai/gpt-4.1-mini",
-      modelOverrides: {
-        enabled: true,
-      },
-      openai: {
-        apiKey: "openai_api_key",
-        model: "gpt-4o-mini-tts",
-        voice: "alloy",
-      },
-      elevenlabs: {
-        apiKey: "elevenlabs_api_key",
-        baseUrl: "https://api.elevenlabs.io",
-        voiceId: "voice_id",
-        modelId: "eleven_multilingual_v2",
-        seed: 42,
-        applyTextNormalization: "auto",
-        languageCode: "en",
-        voiceSettings: {
-          stability: 0.5,
-          similarityBoost: 0.75,
-          style: 0.0,
-          useSpeakerBoost: true,
-          speed: 1.0,
-        },
-      },
-    },
-  },
-}
-```
-
-### Edge TTS 主要（无 API 密钥）
-
-```json5
-{
-  messages: {
-    tts: {
-      auto: "always",
-      provider: "edge",
-      edge: {
-        enabled: true,
-        voice: "en-US-MichelleNeural",
-        lang: "en-US",
-        outputFormat: "audio-24khz-48kbitrate-mono-mp3",
-        rate: "+10%",
-        pitch: "-5%",
-      },
-    },
-  },
-}
-```
-
-### 禁用 Edge TTS
-
-```json5
-{
-  messages: {
-    tts: {
-      edge: {
-        enabled: false,
-      },
-    },
-  },
-}
-```
-
-### 自定义限制 + 偏好路径
-
-```json5
-{
-  messages: {
-    tts: {
-      auto: "always",
-      maxTextLength: 4000,
-      timeoutMs: 30000,
-      prefsPath: "~/.symi/settings/tts.json",
-    },
-  },
-}
-```
-
-### 仅在收到语音消息后用音频回复
-
-```json5
-{
-  messages: {
-    tts: {
-      auto: "inbound",
-    },
-  },
-}
-```
-
-### 禁用长回复的自动摘要
-
-```json5
-{
-  messages: {
-    tts: {
-      auto: "always",
-    },
-  },
-}
-```
-
-然后运行：
-
-```
-/tts summary off
-```
-
-### 字段说明
-
-- `auto`：自动 TTS 模式（`off`、`always`、`inbound`、`tagged`）。
-  - `inbound` 仅在收到语音消息后发送音频。
-  - `tagged` 仅在回复包含 `[[tts]]` 标签时发送音频。
-- `enabled`：旧版开关（doctor 将其迁移到 `auto`）。
-- `mode`：`"final"`（默认）或 `"all"`（包括工具/分块回复）。
-- `provider`：`"elevenlabs"`、`"openai"` 或 `"edge"`（自动备用）。
-- 如果 `provider` **未设置**，Symi 优先选择 `openai`（如果有密钥），然后是 `elevenlabs`（如果有密钥），否则是 `edge`。
-- `summaryModel`：用于自动摘要的可选廉价模型；默认为 `agents.defaults.model.primary`。
-  - 接受 `provider/model` 或配置的模型别名。
-- `modelOverrides`：允许模型发出 TTS 指令（默认开启）。
-- `maxTextLength`：TTS 输入的硬性上限（字符）。超出时 `/tts audio` 会失败。
-- `timeoutMs`：请求超时（毫秒）。
-- `prefsPath`：覆盖本地偏好 JSON 路径（提供商/限制/摘要）。
-- `apiKey` 值回退到环境变量（`ELEVENLABS_API_KEY`/`XI_API_KEY`、`OPENAI_API_KEY`）。
-- `elevenlabs.baseUrl`：覆盖 ElevenLabs API 基础 URL。
-- `elevenlabs.voiceSettings`：
-  - `stability`、`similarityBoost`、`style`：`0..1`
-  - `useSpeakerBoost`：`true|false`
-  - `speed`：`0.5..2.0`（1.0 = 正常）
-- `elevenlabs.applyTextNormalization`：`auto|on|off`
-- `elevenlabs.languageCode`：2 字母 ISO 639-1（例如 `en`、`de`）
-- `elevenlabs.seed`：整数 `0..4294967295`（尽力确定性）
-- `edge.enabled`：允许 Edge TTS 使用（默认 `true`；无 API 密钥）。
-- `edge.voice`：Edge 神经网络语音名称（例如 `en-US-MichelleNeural`）。
-- `edge.lang`：语言代码（例如 `en-US`）。
-- `edge.outputFormat`：Edge 输出格式（例如 `audio-24khz-48kbitrate-mono-mp3`）。
-  - 有效值参见 Microsoft 语音输出格式；并非所有格式都被 Edge 支持。
-- `edge.rate` / `edge.pitch` / `edge.volume`：百分比字符串（例如 `+10%`、`-5%`）。
-- `edge.saveSubtitles`：在音频文件旁边写入 JSON 字幕。
-- `edge.proxy`：Edge TTS 请求的代理 URL。
-- `edge.timeoutMs`：请求超时覆盖（毫秒）。
-
-## 模型驱动覆盖（默认开启）
-
-默认情况下，模型**可以**为单个回复发出 TTS 指令。当 `messages.tts.auto` 为 `tagged` 时，需要这些指令来触发音频。
-
-启用后，模型可以发出 `[[tts:...]]` 指令来覆盖单个回复的语音，加上可选的 `[[tts:text]]...[[/tts:text]]` 块来提供表达性标签（笑声、唱歌提示等），这些仅应出现在音频中。
-
-示例回复负载：
-
-```
-Here you go.
-
-[[tts:provider=elevenlabs voiceId=pMsXgVXv3BLzUgSXRplE model=eleven_v3 speed=1.1]]
-[[tts:text]](laughs) Read the song once more.[[/tts:text]]
-```
-
-可用指令键（启用时）：
-
-- `provider`（`openai` | `elevenlabs` | `edge`）
-- `voice`（OpenAI 语音）或 `voiceId`（ElevenLabs）
-- `model`（OpenAI TTS 模型或 ElevenLabs 模型 ID）
-- `stability`、`similarityBoost`、`style`、`speed`、`useSpeakerBoost`
-- `applyTextNormalization`（`auto|on|off`）
-- `languageCode`（ISO 639-1）
-- `seed`
-
-禁用所有模型覆盖：
-
-```json5
-{
-  messages: {
-    tts: {
-      modelOverrides: {
-        enabled: false,
-      },
-    },
-  },
-}
-```
-
-可选白名单（禁用特定覆盖同时保持标签启用）：
-
-```json5
-{
-  messages: {
-    tts: {
-      modelOverrides: {
-        enabled: true,
-        allowProvider: false,
-        allowSeed: false,
-      },
-    },
-  },
-}
-```
-
-## 单用户偏好
-
-斜杠命令将本地覆盖写入 `prefsPath`（默认：`~/.symi/settings/tts.json`，可通过 `SYMI_TTS_PREFS` 或 `messages.tts.prefsPath` 覆盖）。
-
-存储的字段：
-
-- `enabled`
-- `provider`
-- `maxLength`（摘要阈值；默认 1500 字符）
-- `summarize`（默认 `true`）
-
-这些为该主机覆盖 `messages.tts.*`。
-
-## 输出格式（固定）
-
-- **Telegram**：Opus 语音消息（ElevenLabs 的 `opus_48000_64`，OpenAI 的 `opus`）。
-  - 48kHz / 64kbps 是语音消息的良好权衡，圆形气泡所必需。
-- **其他渠道**：MP3（ElevenLabs 的 `mp3_44100_128`，OpenAI 的 `mp3`）。
-  - 44.1kHz / 128kbps 是语音清晰度的默认平衡。
-- **Edge TTS**：使用 `edge.outputFormat`（默认 `audio-24khz-48kbitrate-mono-mp3`）。
-  - `node-edge-tts` 接受 `outputFormat`，但并非所有格式都可从 Edge 服务获得。citeturn2search0
-  - 输出格式值遵循 Microsoft 语音输出格式（包括 Ogg/WebM Opus）。citeturn1search0
-  - Telegram `sendVoice` 接受 OGG/MP3/M4A；如果你需要有保证的 Opus 语音消息，请使用 OpenAI/ElevenLabs。citeturn1search1
-  - 如果配置的 Edge 输出格式失败，Symi 会使用 MP3 重试。
-
-OpenAI/ElevenLabs 格式是固定的；Telegram 期望 Opus 以获得语音消息用户体验。
-
-## 自动 TTS 行为
-
-启用后，Symi：
-
-- 如果回复已包含媒体或 `MEDIA:` 指令，则跳过 TTS。
-- 跳过非常短的回复（< 10 字符）。
-- 启用时使用 `agents.defaults.model.primary`（或 `summaryModel`）对长回复进行摘要。
-- 将生成的音频附加到回复中。
-
-如果回复超过 `maxLength` 且摘要关闭（或没有摘要模型的 API 密钥），则跳过音频并发送正常的文本回复。
-
-## 流程图
-
-```
-回复 -> TTS 启用？
-  否  -> 发送文本
-  是  -> 有媒体 / MEDIA: / 太短？
-          是 -> 发送文本
-          否 -> 长度 > 限制？
-                   否  -> TTS -> 附加音频
-                   是  -> 摘要启用？
-                            否  -> 发送文本
-                            是  -> 摘要（summaryModel 或 agents.defaults.model.primary）
-                                      -> TTS -> 附加音频
-```
-
-## 斜杠命令用法
-
-只有一个命令：`/tts`。参见[斜杠命令](/tools/slash-commands)了解启用详情。
-
-```
-/tts off
-/tts always
-/tts inbound
-/tts tagged
-/tts status
-/tts provider openai
-/tts limit 2000
-/tts summary off
-/tts audio Hello from Symi
-```
-
-注意事项：
-
-- 命令需要授权发送者（白名单/所有者规则仍然适用）。
-- 必须启用 `commands.text` 或原生命令注册。
-- `off|always|inbound|tagged` 是单会话开关（`/tts on` 是 `/tts always` 的别名）。
-- `limit` 和 `summary` 存储在本地偏好中，不在主配置中。
-- `/tts audio` 生成一次性音频回复（不会开启 TTS）。
-
-## 智能体工具
-
-`tts` 工具将文本转换为语音并返回 `MEDIA:` 路径。当结果与 Telegram 兼容时，工具包含 `[[audio_as_voice]]`，以便 Telegram 发送语音气泡。
-
-## Gateway 网关 RPC
-
-Gateway 网关方法：
-
-- `tts.status`
-- `tts.enable`
-- `tts.disable`
-- `tts.convert`
-- `tts.setProvider`
-- `tts.providers`

package/docs/zh-CN/vps.md

@@ -1,47 +0,0 @@
----
-read_when:
-  - 你想在云端运行 Gateway 网关
-  - 你需要 VPS/托管指南的快速索引
-summary: Symi 的 VPS 托管中心（Oracle/Fly/Hetzner/GCP/exe.dev）
-title: VPS 托管
-x-i18n:
-  generated_at: "2026-02-03T10:12:57Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 7749b479b333aa5541e7ad8b0ff84e9f8f6bd10d7188285121975cb893acc037
-  source_path: vps.md
-  workflow: 15
----
-
-# VPS 托管
-
-本中心链接到支持的 VPS/托管指南，并在高层次上解释云部署的工作原理。
-
-## 选择提供商
-
-- **Railway**（一键 + 浏览器设置）：[Railway](/install/railway)
-- **Northflank**（一键 + 浏览器设置）：[Northflank](/install/northflank)
-- **Oracle Cloud（永久免费）**：[Oracle](/platforms/oracle) — $0/月（永久免费，ARM；容量/注册可能不太稳定）
-- **Fly.io**：[Fly.io](/install/fly)
-- **Hetzner（Docker）**：[Hetzner](/install/hetzner)
-- **GCP（Compute Engine）**：[GCP](/install/gcp)
-- **exe.dev**（VM + HTTPS 代理）：[exe.dev](/install/exe-dev)
-- **AWS（EC2/Lightsail/免费套餐）**：也运行良好。视频指南：
-  https://x.com/techfrenAJ/status/2014934471095812547
-
-## 云设置的工作原理
-
-- **Gateway 网关运行在 VPS 上**并拥有状态 + 工作区。
-- 你通过**控制 UI** 或 **Tailscale/SSH** 从笔记本电脑/手机连接。
-- 将 VPS 视为数据源并**备份**状态 + 工作区。
-- 安全默认：将 Gateway 网关保持在 loopback 上，通过 SSH 隧道或 Tailscale Serve 访问。
-  如果你绑定到 `lan`/`tailnet`，需要 `gateway.auth.token` 或 `gateway.auth.password`。
-
-远程访问：[Gateway 网关远程访问](/gateway/remote)
-平台中心：[平台](/platforms)
-
-## 在 VPS 上使用节点
-
-你可以将 Gateway 网关保持在云端，并在本地设备（Mac/iOS/Android/无头）上配对**节点**。节点提供本地屏幕/摄像头/canvas 和 `system.run` 功能，而 Gateway 网关保持在云端。
-
-文档：[节点](/nodes)，[节点 CLI](/cli/nodes)