常见问题解答

支持 iOS 17 及以上与 Android 7.0 及以上。界面支持 English、简体中文、繁體中文，可在设置中切换或跟随系统语言。下载地址见下载页。

• 实时会话：流式查看 AI 回复，随时继续对话，可选择 agent 与模型；
• 权限审批：在手机上批准或拒绝 opencode 的命令执行、文件编辑等操作；
• 文件与变更：浏览项目文件、查看逐行 diff；
• 远程终端：随时打开电脑上的真实终端；
• 并行任务：通过 worktree 同时推进多个任务，互不干扰；
• 多项目管理：会话按项目分组，随时切换。

配合推送通知，任务完成或有权限请求时手机会第一时间收到提醒。

iOS 请通过 TestFlight 更新（打开 TestFlight App 检查新版本）；Android 请通过下载渠道获取新版本。App 设置中的「检查更新」也会提示最新版本与下载入口。

可以。用同一邮箱账号在多台手机上登录，即可看到全部已配对的电脑。同一账号最多保持 3 个登录会话，超出时最早的会话会自动退出。多台手机也可以同时对同一台电脑的会话进行操作。

采用邮箱验证码登录，无需设置密码：输入邮箱 → 收到 6 位验证码 → 输入即完成登录；未注册的邮箱在输入验证码后会自动创建账号。

验证码 5 分钟内有效，连续输错 5 次作废，重新发送需间隔 60 秒。首次登录前需同意服务条款与隐私政策。

• 检查邮箱的垃圾邮件 / 广告邮件分类；
• 等待 60 秒冷却后重新发送；
• 尝试更换其他邮箱。

若仍然收不到，请通过反馈页面联系我们，并注明所用邮箱的服务商。

换手机只需在新手机上用同一邮箱登录，配对记录和订阅信息随账号走，无需重新设置。如担心旧设备仍保持登录，可在 设置 → 安全 中使用「退出所有设备」，立即吊销全部登录会话（之后需重新登录）。

在 设置 → 安全 → 注销账号 中操作。系统会向登录邮箱发送注销确认验证码，输入确认后立即执行：吊销全部登录会话、解绑全部已配对电脑、匿名化账号数据，不可恢复。

注意：注销不会自动取消商店订阅。如订阅了付费档位，请先在 App Store / Google Play 的订阅设置中关闭自动续费，再注销账号。

局域网直连永远免费、不计流量。中继服务按月订阅，当前档位：

• 免费版：每月 512 MB 中继流量，可绑定 1 台电脑；
• 进阶版（Plus）：每月 20 GB，可绑定 3 台电脑，$2.99/月（划线价 $9.99）；
• 专业版（Pro）：每月 50 GB，可绑定 5 台电脑，$5.99/月（划线价 $19.99）。

档位、价格与额度以 App 内升级页和定价页实时展示为准。

只对经由中继节点转发的数据计费，按上行与下行字节合计。局域网直连的流量完全不计费、不占用额度。活动赠送的额外流量会叠加在套餐额度之上，按各自有效期使用。

免费版按自然月重置：每月 1 日 0 点（北京时间）。付费版按订阅周期重置：每次商店扣费日开始新的周期。App 账号页会显示具体的重置日期。

流量用尽后中继连接会被断开，App 会明确提示。你可以：

• 等待额度重置（账号页显示日期）；
• 或升级 / 购买订阅——额度立即生效，购买成功后 App 会自动恢复连接。

额度临近用尽时状态栏会提前预警，不会无提示地直接断开。

目前支持 Apple App Store 与 Google Play 应用内订阅，按月自动续订，随 Apple 账户 / Google 账户结算。其他支付方式暂不支持。

用原邮箱登录后，在账号页点击「恢复购买」，App 会自动同步 Apple / Google 账户的历史订阅并重新校验，无需再次付费。

订阅由商店管理，请在 App Store / Google Play 的订阅设置中取消。取消后当前周期内仍可正常使用，到期后回落为免费版。降级（如 Pro → Plus）在当前周期结束后生效；若降级后绑定电脑数超出新档位上限，连接时会提示先解绑多余电脑。

一行命令安装：

• macOS / Linux：curl -fsSL https://opencodemobile.com/install.sh | bash
• Windows（PowerShell）：irm https://opencodemobile.com/install.ps1 | iex

支持 macOS、Linux、Windows 的 amd64 与 arm64 架构。安装后运行 ocrelay --version 验证。

• ocrelay connect：连接中继并显示配对二维码（首次使用需先配对）；
• ocrelay stop：停止后台运行；
• ocrelay status：本地自检——opencode 是否在运行、配对与节点状态、后台实例情况；
• ocrelay upgrade：升级到最新版本。

常用参数：--re-pair 强制重新配对（换节点时使用）；--reconfigure 重新设置本地 opencode 地址与凭据；--node <id> 配对后首次连接时直接指定节点。

ocrelay connect 在线后按 b 即可转入后台继续运行，关闭终端不影响。如需开机自启，建议用系统自带的服务管理托管，例如 macOS 的 launchd、Linux 的 systemd 用户服务、Windows 的任务计划程序。

同一时刻只允许一个 ocrelay 实例，重复启动会自动接管旧实例。

在电脑上运行 ocrelay connect，终端会显示二维码与配对码；在 App 的配对页扫码或手动输入配对码即可完成绑定。

配对码格式为 XXXX-XXX-XXX，5 分钟内有效且一次性使用，过期后保持 ocrelay connect 运行会自动换新码。配对后首次连接会让你选择中继节点（自动探测延迟），此后节点保持固定。

节点在配对后首次连接时确定并固定。需要更换时，在电脑上运行 ocrelay connect --re-pair 重新配对并重新选点；本地 opencode 的地址与凭据会保留，App 端无需重新操作。

在新电脑上重新安装 ocrelay 并运行 ocrelay connect，按流程重新配对即可。旧电脑可在 App 的设备列表中解除绑定（各档位绑定数上限：免费 1 台 / Plus 3 台 / Pro 5 台）。

注意：不要把旧电脑的配置文件复制到多台电脑使用——同一配对凭据只允许一处在线，复制只会互相顶替。

• 配置文件：macOS / Linux 为 ~/.config/ocrelay/config.json，Windows 为 %LocalAppData%\ocrelay\config.json；
• 日志：状态目录下的 client.log（后台模式另有 daemon.out.log）。

遇到问题先运行 ocrelay status 自检（opencode 是否在运行、配对与节点状态、后台实例）。需要反馈问题时，附上日志片段能显著加快定位。

ocrelay 与中继节点之间使用 443 端口的加密直连出站连接，不经过 HTTP 代理。一般家庭与移动网络均可正常使用；若所在网络强制所有流量走代理或限制出站，中继可能无法连接。与本地 opencode 的通信始终只在本机进行，不受代理影响。

这说明手机与中继已连通，但电脑端的 ocrelay 不在线：

• 确认电脑已唤醒、已联网；
• 在电脑上运行 ocrelay status 检查，必要时重新执行 ocrelay connect；
• 若电脑重启过，请确认 ocrelay 已重新启动（或已配置开机自启）。

中继协议会不定期升级，旧版本客户端可能无法建立连接，通常表现为连接失败、长时间无响应或明确的版本不兼容提示。请将两端都升级到最新版本：

• 电脑端：运行 ocrelay upgrade，或重新执行安装命令；
• 手机 App：通过 TestFlight / 下载渠道更新到最新版本。

升级后仍无法连接的，请通过反馈页面联系我们，并附上两端版本号。

配对码 5 分钟内有效且只能使用一次。让电脑端的 ocrelay connect 保持运行（会自动换新码），重新扫码或输入最新的配对码；手动输入时注意核对格式 XXXX-XXX-XXX 与容易混淆的字符。

每个账号可绑定的电脑数有上限：免费 1 台 / Plus 3 台 / Pro 5 台。达到上限时：

• 在 App 的设备列表中解除不再使用的电脑绑定；
• 或升级订阅提高上限。

降级订阅后若绑定数超出新档位，也会提示先解绑再连接。

中继具备自动重连能力，短暂网络波动会自动恢复。若频繁断开：

• 检查电脑与手机两侧网络的稳定性，尤其是代理、VPN 或公司防火墙环境；
• 在电脑上查看 client.log 日志定位原因；
• 将断开时间点与日志片段通过反馈页面提交给我们。

每个配对（绑定）同一时刻只允许一条连接，新连接会自动接管并替换旧连接。如果在两台电脑上使用同一份配置，两边会互相顶替、反复掉线。多台电脑请各自配对（在档位配额内），互不影响。

支持四类通知，可在 设置 → 通知 中分别开关：

• 任务完成：会话结束等待查看时；
• 权限请求：opencode 等待你批准操作时；
• 提问提醒：AI 向你提出问题时；
• 错误提醒：会话出错时。

通知在中继连接模式下可用（直连模式不支持）。

• 检查手机系统是否已授予 App 通知权限；
• 确认 App 通知设置中对应开关已打开；
• 部分 Android 系统会限制后台活动，请允许 App 后台运行与自启动；
• 正在查看对应会话页面时不会推送（内容已在页面内实时显示），这是正常行为。

如仍收不到，请通过反馈页面告知手机型号与系统版本。

开启后，opencode 的权限请求（执行命令、编辑文件等）不再等待你在手机上确认，自动放行执行。适合挂机跑长任务的场景，但意味着 AI 的操作不再经你逐次确认，请谨慎开启。

该功能默认关闭。开启后若自动执行失败，仍会推送提醒你手动处理。

电脑上的 opencode 地址与密码只保存在电脑本地的配置文件中，仅限当前用户读写；手机 App 只持有中继访问令牌，不保存 opencode 密码。中继链路全程使用 TLS 加密传输。

传输全程加密（HTTPS / TLS）。中继节点只负责转发数据并按字节数计量流量，用于计费与运维；我们不会存储、索引或分析你的会话内容。详见隐私政策。

App 会收集匿名的产品使用统计（不包含代码与会话内容），用于改进产品。该选项默认开启，可随时在设置中关闭。