OpenCode Mobile 是一款开源 Android 客户端，用于连接你自己运行的 opencode AI 编程智能体服务器。它由社区独立构建，不隶属于 opencode / Anomaly 团队，而是通过 opencode 开放 HTTP API 与你自己搭建的服务器通信。应用采用 React Native / Expo 开发，以 MIT 许可证发布，免费且无功能门槛、无广告网络，也未内置分析 SDK。
用途与定位 该应用是一个轻量客户端（thin client），目标是让用户通过手机远程使用 opencode 的 AI 辅助编程能力，随时随地编写、审查和交付代码。它本身不处理 AI 模型调用，所有模型调用均由你的 opencode 服务器完成，你自带 OpenAI、Anthropic 等 API 密钥，应用从不会接触这些密钥，也不会经其服务器代理你的代码或对话。
主要能力
- 离线演示模式：点击“Try a Demo”，无需任何设置即可在应用真实的聊天、Diff 和权限审批界面中观看约 30 秒的脚本化 bug 修复流程（推理 → grep → diff → 权限提示）。
- 多连接管理：可管理多个 opencode 服务器，支持本地网络、Cloudflare Tunnel、ngrok 或 Tailscale 连接方式。
- 流式聊天：直接从你的 opencode 服务器获取逐 token 的流式响应。
- Diff 查看器：以内联并排方式展示智能体对每个文件的更改。
- 工具调用审批：在智能体执行工具调用前进行审查并批准或拒绝。
- 安全凭证存储：服务器凭证通过 expo-secure-store 存储在 Android Keystore 中。
- 生物识别解锁：可使用 Face ID、Touch ID 或 Android 指纹保护应用及单条消息发送。
- 会话管理：浏览、创建和恢复编程会话。
安装方式 当前有三个可用且受支持的安装渠道，均面向 Android：
- Google Play：https://play.google.com/store/apps/details?id=cc.agentlabs.opencode
- F-Droid（自托管仓库）：在任意 F-Droid 客户端中添加自托管仓库后安装/更新，仓库地址：https://dzianisv.github.io/opencode-mobile/fdroid/repo （在 F-Droid 应用中：Settings → Repositories → + 并粘贴上述 URL）。当前版本 v0.4.7。
- 直接下载签名 APK：https://github.com/dzianisv/opencode-mobile/releases/latest 应用包名为 cc.agentlabs.opencode，仅支持 Android。IzzyOnDroid 提交待处理，暂无 iOS 版本。
使用方式
- 在你的机器上启动 opencode（并设置密码）。
- 通过 Google Play、F-Droid 或直接 APK 安装 OpenCode Mobile（也可从源码构建，参见 CONTRIBUTING.md）。
- 在应用中点击 Add Connection，选择连接类型并填入对应地址：
- 本地网络：你机器的局域网 IP，例如 http://192.168.1.100:4096
- 隧道：Cloudflare Tunnel 或 ngrok URL，例如 https://my-opencode.trycloudflare.com
- Tailscale：你机器的 Tailscale IP，例如 http://100.x.x.x:4096
- opencode Cloud：计划中，尚未发布，将提供一键托管、无需自建服务器 然后输入第 1 步设置的密码，点击 Connect 即可。若尚未搭建服务器，可先安装应用并在会话界面点击 Try a Demo 体验，无需任何设置。
适用场景 适合希望在手机上随时接入自托管 opencode 服务器进行 AI 辅助编程的开发者，尤其适合需要远程审查代码更改、审批工具调用、安全保存服务器凭证的用户。
限制与说明
- 仅支持 Android，暂无 iOS 版本。
- 需要你自行运行 opencode 服务器，应用本身不提供模型服务。
- opencode Cloud 托管后端尚未发布（计划为每月 10 美元）。
- 隐私方面：应用不收集个人数据；可选的 Sentry 崩溃报告默认关闭，需主动开启，发送匿名崩溃追踪；凭证仅存储在设备 OS 密钥库中。完整隐私政策见 dzianisv.github.io/opencode-mobile/privacy。
- 项目由 VIBE TECHNOLOGIES, LLC 构建和维护，GitHub Sponsors 用于覆盖 Sentry、EAS Build 和 CI 成本（约每月 60 美元）。
近期路线图
- opencode Cloud 一键连接 + 托管
- F-Droid 主仓库收录（FCM 审计 + 可复现构建验证）
- 隧道设置向导（Cloudflare / ngrok / Tailscale）
- iPad / 平板布局
- 离线会话历史缓存 欢迎提交 bug 报告、功能请求和 PR，贡献流程见 CONTRIBUTING.md。
