@symerian/symi 3.0.20 → 3.0.22

package/docs/zh-CN/start/wizard.md

@@ -1,326 +0,0 @@
----
-read_when:
-  - 运行或配置新手引导向导
-  - 设置新机器
-summary: CLI 新手引导向导：引导式配置 Gateway 网关、工作区、渠道和 Skills
-title: 新手引导向导
-x-i18n:
-  generated_at: "2026-02-03T09:20:27Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 45e10d31048d927ee6546e35b050914f0e6e21a4dee298b3b277eebe7c133732
-  source_path: start/wizard.md
-  workflow: 15
----
-
-# 新手引导向导（CLI）
-
-新手引导向导是在 macOS、Linux 或 Windows（通过 WSL2；强烈推荐）上设置 Symi 的**推荐**方式。
-它可以在一个引导式流程中配置本地 Gateway 网关或远程 Gateway 网关连接，以及渠道、Skills 和工作区默认值。
-
-主要入口：
-
-```bash
-symi onboard
-```
-
-最快开始聊天的方式：打开控制界面（无需设置渠道）。运行 `symi dashboard` 并在浏览器中聊天。文档：[控制面板](/web/dashboard)。
-
-后续重新配置：
-
-```bash
-symi configure
-```
-
-推荐：设置 Brave Search API 密钥，以便智能体可以使用 `web_search`（`web_fetch` 无需密钥即可使用）。最简单的方式：`symi configure --section web`，它会存储 `tools.web.search.apiKey`。文档：[Web 工具](/tools/web)。
-
-## 快速开始 vs 高级
-
-向导从**快速开始**（默认值）vs **高级**（完全控制）开始。
-
-**快速开始**保持默认值：
-
-- 本地 Gateway 网关（loopback）
-- 默认工作区（或现有工作区）
-- Gateway 网关端口 **18789**
-- Gateway 网关认证 **Token**（自动生成，即使在 loopback 上）
-- Tailscale 暴露 **关闭**
-- Telegram + WhatsApp 私信默认使用**允许列表**（系统会提示你输入电话号码）
-
-**高级**暴露每个步骤（模式、工作区、Gateway 网关、渠道、守护进程、Skills）。
-
-## 向导做了什么
-
-**本地模式（默认）**引导你完成：
-
-- 模型/认证（OpenAI Code (Codex) 订阅 OAuth、Anthropic API 密钥（推荐）或 setup-token（粘贴），以及 MiniMax/GLM/Moonshot/AI Gateway 选项）
-- 工作区位置 + 引导文件
-- Gateway 网关设置（端口/绑定/认证/tailscale）
-- 守护进程安装（LaunchAgent / systemd 用户单元）
-- 健康检查
-- Skills（推荐）
-
-**远程模式**仅配置本地客户端连接到其他位置的 Gateway 网关。
-它**不会**在远程主机上安装或更改任何内容。
-
-要添加更多隔离的智能体（独立的工作区 + 会话 + 认证），使用：
-
-```bash
-symi agents add <name>
-```
-
-提示：`--json` **不**意味着非交互模式。脚本中请使用 `--non-interactive`（和 `--workspace`）。
-
-## 流程详情（本地）
-
-1. **现有配置检测**
-   - 如果 `~/.symi/symi.json` 存在，选择**保留 / 修改 / 重置**。
-   - 重新运行向导**不会**清除任何内容，除非你明确选择**重置**（或传递 `--reset`）。
-   - 如果配置无效或包含遗留键名，向导会停止并要求你在继续之前运行 `symi doctor`。
-   - 重置使用 `trash`（永不使用 `rm`）并提供范围选项：
-     - 仅配置
-     - 配置 + 凭证 + 会话
-     - 完全重置（同时删除工作区）
-
-2. **模型/认证**
-   - **Anthropic API 密钥（推荐）**：如果存在则使用 `ANTHROPIC_API_KEY`，否则提示输入密钥，然后保存供守护进程使用。
-   - **Anthropic OAuth（Claude Code CLI）**：在 macOS 上，向导检查钥匙串项目"Claude Code-credentials"（选择"始终允许"以便 launchd 启动不会阻塞）；在 Linux/Windows 上，如果存在则复用 `~/.claude/.credentials.json`。
-   - **Anthropic 令牌（粘贴 setup-token）**：在任何机器上运行 `claude setup-token`，然后粘贴令牌（你可以命名它；空白 = 默认）。
-   - **OpenAI Code (Codex) 订阅（Codex CLI）**：如果 `~/.codex/auth.json` 存在，向导可以复用它。
-   - **OpenAI Code (Codex) 订阅（OAuth）**：浏览器流程；粘贴 `code#state`。
-     - 当模型未设置或为 `openai/*` 时，将 `agents.defaults.model` 设置为 `openai-codex/gpt-5.2`。
-   - **OpenAI API 密钥**：如果存在则使用 `OPENAI_API_KEY`，否则提示输入密钥，然后保存到 `~/.symi/.env` 以便 launchd 可以读取。
-   - **OpenCode Zen（多模型代理）**：提示输入 `OPENCODE_API_KEY`（或 `OPENCODE_ZEN_API_KEY`，在 https://opencode.ai/auth 获取）。
-   - **API 密钥**：为你存储密钥。
-   - **Vercel AI Gateway（多模型代理）**：提示输入 `AI_GATEWAY_API_KEY`。
-   - 更多详情：[Vercel AI Gateway](/providers/vercel-ai-gateway)
-   - **MiniMax M2.1**：自动写入配置。
-   - 更多详情：[MiniMax](/providers/minimax)
-   - **Synthetic（Anthropic 兼容）**：提示输入 `SYNTHETIC_API_KEY`。
-   - 更多详情：[Synthetic](/providers/synthetic)
-   - **Moonshot（Kimi K2）**：自动写入配置。
-   - **Kimi Coding**：自动写入配置。
-   - 更多详情：[Moonshot AI（Kimi + Kimi Coding）](/providers/moonshot)
-   - **跳过**：尚未配置认证。
-   - 从检测到的选项中选择默认模型（或手动输入提供商/模型）。
-   - 向导运行模型检查，如果配置的模型未知或缺少认证则发出警告。
-
-- OAuth 凭证存储在 `~/.symi/credentials/oauth.json`；认证配置文件存储在 `~/.symi/agents/<agentId>/agent/auth-profiles.json`（API 密钥 + OAuth）。
-- 更多详情：[/concepts/oauth](/concepts/oauth)
-
-3. **工作区**
-   - 默认 `~/.symi/workspace`（可配置）。
-   - 为智能体引导仪式播种所需的工作区文件。
-   - 完整的工作区布局 + 备份指南：[智能体工作区](/concepts/agent-workspace)
-
-4. **Gateway 网关**
-   - 端口、绑定、认证模式、tailscale 暴露。
-   - 认证建议：即使对于 loopback 也保持 **Token**，以便本地 WS 客户端必须进行认证。
-   - 仅当你完全信任每个本地进程时才禁用认证。
-   - 非 loopback 绑定仍需要认证。
-
-5. **渠道**
-   - [WhatsApp](/channels/whatsapp)：可选的二维码登录。
-   - [Telegram](/channels/telegram)：机器人令牌。
-   - [Google Chat](/channels/googlechat)：服务账户 JSON + webhook 受众。
-   - [Mattermost](/channels/mattermost)（插件）：机器人令牌 + 基础 URL。
-   - [Signal](/channels/signal)：可选的 `signal-cli` 安装 + 账户配置。
-   - [iMessage](/channels/imessage)：本地 `imsg` CLI 路径 + 数据库访问。
-   - 私信安全：默认为配对。第一条私信发送验证码；通过 `symi pairing approve <channel> <code>` 批准或使用允许列表。
-
-6. **守护进程安装**
-   - macOS：LaunchAgent
-     - 需要已登录的用户会话；对于无头环境，使用自定义 LaunchDaemon（未提供）。
-   - Linux（和通过 WSL2 的 Windows）：systemd 用户单元
-     - 向导尝试通过 `loginctl enable-linger <user>` 启用 lingering，以便 Gateway 网关在注销后保持运行。
-     - 可能提示 sudo（写入 `/var/lib/systemd/linger`）；它首先尝试不使用 sudo。
-   - **运行时选择：**Node（推荐；WhatsApp/Telegram 需要）。**不推荐** Bun。
-
-7. **健康检查**
-   - 启动 Gateway 网关（如果需要）并运行 `symi health`。
-   - 提示：`symi status --deep` 在状态输出中添加 Gateway 网关健康探测（需要可达的 Gateway 网关）。
-
-8. **Skills（推荐）**
-   - 读取可用的 Skills 并检查要求。
-   - 让你选择节点管理器：**npm / pnpm**（不推荐 bun）。
-   - 安装可选依赖项（某些在 macOS 上使用 Homebrew）。
-
-9. **完成**
-   - 总结 + 后续步骤，包括用于额外功能的 iOS/Android/macOS 应用。
-
-- 如果未检测到 GUI，向导会打印控制界面的 SSH 端口转发说明，而不是打开浏览器。
-- 如果控制界面资源缺失，向导会尝试构建它们；回退方案是 `pnpm ui:build`（自动安装 UI 依赖）。
-
-## 远程模式
-
-远程模式配置本地客户端连接到其他位置的 Gateway 网关。
-
-你将设置的内容：
-
-- 远程 Gateway 网关 URL（`ws://...`）
-- 如果远程 Gateway 网关需要认证则需要令牌（推荐）
-
-注意事项：
-
-- 不执行远程安装或守护进程更改。
-- 如果 Gateway 网关仅限 loopback，使用 SSH 隧道或 tailnet。
-- 发现提示：
-  - macOS：Bonjour（`dns-sd`）
-  - Linux：Avahi（`avahi-browse`）
-
-## 添加另一个智能体
-
-使用 `symi agents add <name>` 创建一个具有独立工作区、会话和认证配置文件的单独智能体。不带 `--workspace` 运行会启动向导。
-
-它设置的内容：
-
-- `agents.list[].name`
-- `agents.list[].workspace`
-- `agents.list[].agentDir`
-
-注意事项：
-
-- 默认工作区遵循 `~/.symi/workspace-<agentId>`。
-- 添加 `bindings` 以路由入站消息（向导可以执行此操作）。
-- 非交互标志：`--model`、`--agent-dir`、`--bind`、`--non-interactive`。
-
-## 非交互模式
-
-使用 `--non-interactive` 自动化或脚本化新手引导：
-
-```bash
-symi onboard --non-interactive \
-  --mode local \
-  --auth-choice apiKey \
-  --anthropic-api-key "$ANTHROPIC_API_KEY" \
-  --gateway-port 18789 \
-  --gateway-bind loopback \
-  --install-daemon \
-  --daemon-runtime node \
-  --skip-skills
-```
-
-添加 `--json` 以获取机器可读的摘要。
-
-Gemini 示例：
-
-```bash
-symi onboard --non-interactive \
-  --mode local \
-  --auth-choice gemini-api-key \
-  --gemini-api-key "$GEMINI_API_KEY" \
-  --gateway-port 18789 \
-  --gateway-bind loopback
-```
-
-Z.AI 示例：
-
-```bash
-symi onboard --non-interactive \
-  --mode local \
-  --auth-choice zai-api-key \
-  --zai-api-key "$ZAI_API_KEY" \
-  --gateway-port 18789 \
-  --gateway-bind loopback
-```
-
-Vercel AI Gateway 示例：
-
-```bash
-symi onboard --non-interactive \
-  --mode local \
-  --auth-choice ai-gateway-api-key \
-  --ai-gateway-api-key "$AI_GATEWAY_API_KEY" \
-  --gateway-port 18789 \
-  --gateway-bind loopback
-```
-
-Moonshot 示例：
-
-```bash
-symi onboard --non-interactive \
-  --mode local \
-  --auth-choice moonshot-api-key \
-  --moonshot-api-key "$MOONSHOT_API_KEY" \
-  --gateway-port 18789 \
-  --gateway-bind loopback
-```
-
-Synthetic 示例：
-
-```bash
-symi onboard --non-interactive \
-  --mode local \
-  --auth-choice synthetic-api-key \
-  --synthetic-api-key "$SYNTHETIC_API_KEY" \
-  --gateway-port 18789 \
-  --gateway-bind loopback
-```
-
-OpenCode Zen 示例：
-
-```bash
-symi onboard --non-interactive \
-  --mode local \
-  --auth-choice opencode-zen \
-  --opencode-zen-api-key "$OPENCODE_API_KEY" \
-  --gateway-port 18789 \
-  --gateway-bind loopback
-```
-
-添加智能体（非交互）示例：
-
-```bash
-symi agents add work \
-  --workspace ~/.symi/workspace-work \
-  --model openai/gpt-5.2 \
-  --bind whatsapp:biz \
-  --non-interactive \
-  --json
-```
-
-## Gateway 网关向导 RPC
-
-Gateway 网关通过 RPC 暴露向导流程（`wizard.start`、`wizard.next`、`wizard.cancel`、`wizard.status`）。
-客户端（macOS 应用、控制界面）可以渲染步骤而无需重新实现新手引导逻辑。
-
-## Signal 设置（signal-cli）
-
-向导可以从 GitHub releases 安装 `signal-cli`：
-
-- 下载适当的发布资源。
-- 存储在 `~/.symi/tools/signal-cli/<version>/` 下。
-- 将 `channels.signal.cliPath` 写入你的配置。
-
-注意事项：
-
-- JVM 构建需要 **Java 21**。
-- 可用时使用原生构建。
-- Windows 使用 WSL2；signal-cli 安装在 WSL 内遵循 Linux 流程。
-
-## 向导写入的内容
-
-`~/.symi/symi.json` 中的典型字段：
-
-- `agents.defaults.workspace`
-- `agents.defaults.model` / `models.providers`（如果选择了 Minimax）
-- `gateway.*`（模式、绑定、认证、tailscale）
-- `skills.install.nodeManager`
-- `wizard.lastRunAt`
-- `wizard.lastRunVersion`
-- `wizard.lastRunCommit`
-- `wizard.lastRunCommand`
-- `wizard.lastRunMode`
-
-`symi agents add` 写入 `agents.list[]` 和可选的 `bindings`。
-
-WhatsApp 凭证存储在 `~/.symi/credentials/whatsapp/<accountId>/` 下。
-会话存储在 `~/.symi/agents/<agentId>/sessions/` 下。
-
-某些渠道以插件形式提供。当你在新手引导期间选择一个时，向导会在配置之前提示安装它（npm 或本地路径）。
-
-## 相关文档
-
-- macOS 应用新手引导：[新手引导](/start/onboarding)
-- 配置参考：[Gateway 网关配置](/gateway/configuration)
-- Skills：[Skills](/tools/skills)、[Skills 配置](/tools/skills-config)

package/docs/zh-CN/tools/agent-send.md

@@ -1,58 +0,0 @@
----
-read_when:
-  - 添加或修改智能体 CLI 入口点
-summary: 直接 `symi agent` CLI 运行（带可选投递）
-title: Agent Send
-x-i18n:
-  generated_at: "2026-02-03T07:54:52Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: a84d6a304333eebe155da2bf24cf5fc0482022a0a48ab34aa1465cd6e667022d
-  source_path: tools/agent-send.md
-  workflow: 15
----
-
-# `symi agent`（直接智能体运行）
-
-`symi agent` 运行单个智能体回合，无需入站聊天消息。
-默认情况下它**通过 Gateway 网关**运行；添加 `--local` 以强制在当前机器上使用嵌入式运行时。
-
-## 行为
-
-- 必需：`--message <text>`
-- 会话选择：
-  - `--to <dest>` 派生会话键（群组/频道目标保持隔离；直接聊天折叠到 `main`），**或**
-  - `--session-id <id>` 通过 ID 重用现有会话，**或**
-  - `--agent <id>` 直接定位已配置的智能体（使用该智能体的 `main` 会话键）
-- 运行与正常入站回复相同的嵌入式智能体运行时。
-- 思考/详细标志持久化到会话存储中。
-- 输出：
-  - 默认：打印回复文本（加上 `MEDIA:<url>` 行）
-  - `--json`：打印结构化负载 + 元数据
-- 可选使用 `--deliver` + `--channel` 将回复投递回渠道（目标格式与 `symi message --target` 匹配）。
-- 使用 `--reply-channel`/`--reply-to`/`--reply-account` 覆盖投递而不更改会话。
-
-如果 Gateway 网关不可达，CLI 会**回退**到嵌入式本地运行。
-
-## 示例
-
-```bash
-symi agent --to +15555550123 --message "status update"
-symi agent --agent ops --message "Summarize logs"
-symi agent --session-id 1234 --message "Summarize inbox" --thinking medium
-symi agent --to +15555550123 --message "Trace logs" --verbose on --json
-symi agent --to +15555550123 --message "Summon reply" --deliver
-symi agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"
-```
-
-## 标志
-
-- `--local`：本地运行（需要你的 shell 中有模型提供商 API 密钥）
-- `--deliver`：将回复发送到所选渠道
-- `--reply-to`：投递目标覆盖
-- `--reply-channel`：投递渠道覆盖
-- `--reply-account`：投递账户 ID 覆盖
-- `--thinking <off|minimal|low|medium|high|xhigh>`：持久化思考级别（仅限 GPT-5.2 + Codex 模型）
-- `--verbose <on|full|off>`：持久化详细级别
-- `--timeout <seconds>`：覆盖智能体超时
-- `--json`：输出结构化 JSON

package/docs/zh-CN/tools/apply-patch.md

@@ -1,57 +0,0 @@
----
-read_when:
-  - 你需要跨多个文件进行结构化编辑
-  - 你想要记录或调试基于补丁的编辑
-summary: 使用 apply_patch 工具应用多文件补丁
-title: apply_patch 工具
-x-i18n:
-  generated_at: "2026-02-01T21:39:24Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 8cec2b4ee3afa9105fc3dd1bc28a338917df129afc634ac83620a3347c46bcec
-  source_path: tools/apply-patch.md
-  workflow: 15
----
-
-# apply_patch 工具
-
-使用结构化补丁格式应用文件更改。这非常适合多文件
-或多段编辑，在这些场景下单次 `edit` 调用会很脆弱。
-
-该工具接受一个 `input` 字符串，其中包含一个或多个文件操作：
-
-```
-*** Begin Patch
-*** Add File: path/to/file.txt
-+line 1
-+line 2
-*** Update File: src/app.ts
-@@
--old line
-+new line
-*** Delete File: obsolete.txt
-*** End Patch
-```
-
-## 参数
-
-- `input`（必需）：完整的补丁内容，包括 `*** Begin Patch` 和 `*** End Patch`。
-
-## 说明
-
-- 路径相对于工作区根目录解析。
-- 在 `*** Update File:` 段中使用 `*** Move to:` 可重命名文件。
-- 需要时使用 `*** End of File` 标记仅在文件末尾的插入。
-- 实验性功能，默认禁用。通过 `tools.exec.applyPatch.enabled` 启用。
-- 仅限 OpenAI（包括 OpenAI Codex）。可选通过
-  `tools.exec.applyPatch.allowModels` 按模型进行限制。
-- 配置仅在 `tools.exec` 下。
-
-## 示例
-
-```json
-{
-  "tool": "apply_patch",
-  "input": "*** Begin Patch\n*** Update File: src/index.ts\n@@\n-const foo = 1\n+const foo = 2\n*** End Patch"
-}
-```

package/docs/zh-CN/tools/browser-linux-troubleshooting.md

@@ -1,144 +0,0 @@
----
-read_when: Browser control fails on Linux, especially with snap Chromium
-summary: 修复 Linux 上 Symi 浏览器控制的 Chrome/Brave/Edge/Chromium CDP 启动问题
-title: 浏览器故障排除
-x-i18n:
-  generated_at: "2026-02-03T07:55:07Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: bac2301022511a0bf8ebe1309606cc03e8a979ff74866c894f89d280ca3e514e
-  source_path: tools/browser-linux-troubleshooting.md
-  workflow: 15
----
-
-# 浏览器故障排除（Linux）
-
-## 问题："Failed to start Chrome CDP on port 18800"
-
-Symi 的浏览器控制服务器无法启动 Chrome/Brave/Edge/Chromium，出现以下错误：
-
-```
-{"error":"Error: Failed to start Chrome CDP on port 18800 for profile \"symi\"."}
-```
-
-### 根本原因
-
-在 Ubuntu（和许多 Linux 发行版）上，默认的 Chromium 安装是 **snap 包**。Snap 的 AppArmor 限制会干扰 Symi 启动和监控浏览器进程的方式。
-
-`apt install chromium` 命令安装的是一个重定向到 snap 的存根包：
-
-```
-Note, selecting 'chromium-browser' instead of 'chromium'
-chromium-browser is already the newest version (2:1snap1-0ubuntu2).
-```
-
-这不是真正的浏览器——它只是一个包装器。
-
-### 解决方案 1：安装 Google Chrome（推荐）
-
-安装官方 Google Chrome `.deb` 包，它不受 snap 沙箱限制：
-
-```bash
-wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
-sudo dpkg -i google-chrome-stable_current_amd64.deb
-sudo apt --fix-broken install -y  # if there are dependency errors
-```
-
-然后更新你的 Symi 配置（`~/.symi/symi.json`）：
-
-```json
-{
-  "browser": {
-    "enabled": true,
-    "executablePath": "/usr/bin/google-chrome-stable",
-    "headless": true,
-    "noSandbox": true
-  }
-}
-```
-
-### 解决方案 2：使用 Snap Chromium 的仅附加模式
-
-如果你必须使用 snap Chromium，配置 Symi 附加到手动启动的浏览器：
-
-1. 更新配置：
-
-```json
-{
-  "browser": {
-    "enabled": true,
-    "attachOnly": true,
-    "headless": true,
-    "noSandbox": true
-  }
-}
-```
-
-2. 手动启动 Chromium：
-
-```bash
-chromium-browser --headless --no-sandbox --disable-gpu \
-  --remote-debugging-port=18800 \
-  --user-data-dir=$HOME/.symi/browser/symi/user-data \
-  about:blank &
-```
-
-3. 可选创建 systemd 用户服务以自动启动 Chrome：
-
-```ini
-# ~/.config/systemd/user/symi-browser.service
-[Unit]
-Description=Symi Browser (Chrome CDP)
-After=network.target
-
-[Service]
-ExecStart=/snap/bin/chromium --headless --no-sandbox --disable-gpu --remote-debugging-port=18800 --user-data-dir=%h/.symi/browser/symi/user-data about:blank
-Restart=on-failure
-RestartSec=5
-
-[Install]
-WantedBy=default.target
-```
-
-启用：`systemctl --user enable --now symi-browser.service`
-
-### 验证浏览器是否工作
-
-检查状态：
-
-```bash
-curl -s http://127.0.0.1:18791/ | jq '{running, pid, chosenBrowser}'
-```
-
-测试浏览：
-
-```bash
-curl -s -X POST http://127.0.0.1:18791/start
-curl -s http://127.0.0.1:18791/tabs
-```
-
-### 配置参考
-
-| 选项                     | 描述                                                          | 默认值                                           |
-| ------------------------ | ------------------------------------------------------------- | ------------------------------------------------ |
-| `browser.enabled`        | 启用浏览器控制                                                | `true`                                           |
-| `browser.executablePath` | Chromium 系浏览器二进制文件路径（Chrome/Brave/Edge/Chromium） | 自动检测（当默认浏览器是 Chromium 系时优先使用） |
-| `browser.headless`       | 无 GUI 运行                                                   | `false`                                          |
-| `browser.noSandbox`      | 添加 `--no-sandbox` 标志（某些 Linux 设置需要）               | `false`                                          |
-| `browser.attachOnly`     | 不启动浏览器，仅附加到现有浏览器                              | `false`                                          |
-| `browser.cdpPort`        | Chrome DevTools Protocol 端口                                 | `18800`                                          |
-
-### 问题："Chrome extension relay is running, but no tab is connected"
-
-你正在使用 `chrome` 配置文件（扩展中继）。它期望 Symi 浏览器扩展附加到一个活动标签页。
-
-修复选项：
-
-1. **使用托管浏览器：** `symi browser start --browser-profile symi`
-   （或设置 `browser.defaultProfile: "symi"`）。
-2. **使用扩展中继：** 安装扩展，打开一个标签页，然后点击 Symi 扩展图标来附加它。
-
-注意事项：
-
-- `chrome` 配置文件在可能时使用你的**系统默认 Chromium 浏览器**。
-- 本地 `symi` 配置文件自动分配 `cdpPort`/`cdpUrl`；仅为远程 CDP 设置这些。

package/docs/zh-CN/tools/browser-login.md

@@ -1,75 +0,0 @@
----
-read_when:
-  - 你需要为浏览器自动化登录网站
-  - 你想在 X/Twitter 上发布更新
-summary: 用于浏览器自动化 + X/Twitter 发帖的手动登录
-title: 浏览器登录
-x-i18n:
-  generated_at: "2026-02-03T07:55:03Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: 8ceea2d5258836e3db10f858ee122b5832a40f83a72ba18de140671091eef5a8
-  source_path: tools/browser-login.md
-  workflow: 15
----
-
-# 浏览器登录 + X/Twitter 发帖
-
-## 手动登录（推荐）
-
-当网站需要登录时，请在**主机**浏览器配置文件（symi 浏览器）中**手动登录**。
-
-**不要**将你的凭证提供给模型。自动登录通常会触发反机器人防御并可能锁定账户。
-
-返回主浏览器文档：[浏览器](/tools/browser)。
-
-## 使用哪个 Chrome 配置文件？
-
-Symi 控制一个**专用的 Chrome 配置文件**（名为 `symi`，橙色调 UI）。这与你的日常浏览器配置文件是分开的。
-
-两种简单的访问方式：
-
-1. **让智能体打开浏览器**，然后你自己登录。
-2. **通过 CLI 打开**：
-
-```bash
-symi browser start
-symi browser open https://x.com
-```
-
-如果你有多个配置文件，传入 `--browser-profile <name>`（默认是 `symi`）。
-
-## X/Twitter：推荐流程
-
-- **阅读/搜索/话题：** 使用 **bird** CLI Skills（无浏览器，稳定）。
-  - 仓库：https://github.com/steipete/bird
-- **发布更新：** 使用**主机**浏览器（手动登录）。
-
-## 沙箱隔离 + 主机浏览器访问
-
-沙箱隔离的浏览器会话**更容易**触发机器人检测。对于 X/Twitter（和其他严格的网站），优先使用**主机**浏览器。
-
-如果智能体在沙箱中，浏览器工具默认使用沙箱。要允许主机控制：
-
-```json5
-{
-  agents: {
-    defaults: {
-      sandbox: {
-        mode: "non-main",
-        browser: {
-          allowHostControl: true,
-        },
-      },
-    },
-  },
-}
-```
-
-然后定位主机浏览器：
-
-```bash
-symi browser open https://x.com --browser-profile symi --target host
-```
-
-或者为发布更新的智能体禁用沙箱隔离。