Agent 无法连接
- 检查你的网络连接
- 验证 relay 可达：
curl https://coding.btelo.com/ping - 检查防火墙是否阻止出站 WebSocket 连接（443 端口）
iOS App 找不到 Agent
- 确保 agent 正在运行 — 桌面应用已打开，或 CLI agent 显示 Cloud: running。
- 二维码 / 连接链接可能已过期 — 刷新后重新扫描（在桌面应用中重新打开 Connect 面板，或在 CLI TUI 中按 r）。
- 如果你重新配置了连接器，请扫描新的二维码重新配对。
未找到 AI 提供商
至少安装一个提供商：
npm install -g @anthropic-ai/claude-code
确保 CLI 已加入 PATH — 运行 claude --version 验证。在桌面应用中，使用**设置（Settings）→ 设置向导（Setup guide）→ 重新检测（Recheck）**重新检测提供商。或者选择内置的 Btelo Agent，配合你自己的 DeepSeek / MiniMax 密钥。
端口冲突
Agent 默认使用 24385 端口。若被占用，会自动选择一个随机端口。为 CLI agent 设置自定义端口：
PORT=8080 vibe-remote
强制更新到最新版本
桌面应用： 打开设置（Settings）→ 检查更新（Check for updates），然后点击重启并更新（Restart & update）。如果仍然卡住，从下载页面下载最新版本并覆盖安装。
CLI agent： 如果卡在旧版本或自动更新未生效，重新运行安装命令即可拉取最新版本：
Linux / macOS
curl -fsSL https://coding.btelo.com/install.sh | sh
Windows（PowerShell）
irm https://coding.btelo.com/install.ps1 | iex
完成后，重启 agent 以加载新的二进制文件。
日志
在桌面应用中，日志可从应用窗口查看。对于 CLI agent，日志显示在 TUI 的视图区（headless 模式下输出到 stdout）。日志文件存储在 ~/.vibe-remote/logs/。
获取帮助
在 github.com/btelolabs/btelo-coding-release/issues 提交 issue。