常见问题。

KKCode 是 OpenCode 官方产品吗？

不是。KKCode 是独立客户端，只调用 OpenCode 的官方 API。OpenCode 及其商标归各自所有者所有。

什么是 OpenCode Mobile？

OpenCode Mobile 是这一类手机 App 的统称 —— 它们连接你自己机器上跑的 OpenCode 服务。KKCode 就是其中之一，目前可用于 iPhone 和 iPad；Android 客户端正持续测试，等待公开分发。

KKCode 能装在哪些设备上？

KKCode 目前可用于 iOS 与 iPadOS 16.4 及以上的 iPhone 和 iPad。Android 客户端正持续测试，公开分发将单独发布。

它是通用 AI 聊天机器人还是移动 IDE？

都不是。KKCode 是 OpenCode 服务的工作区感知控制面板。它不是桌面 IDE 或终端模拟器的替代品。

我该用哪个 OpenCode 版本？

用当前版本。KKCode 针对当前 OpenCode API 合约设计，不为已被移除的旧端点形态做兼容。

应该用 opencode web 还是 opencode serve？

KKCode 作为主要消费者时用 opencode serve。如果浏览器 UI 占用了根 URL，API 可能挂在 /api 这类路径下 —— 把完整的 API 基址填进 KKCode。

哪些连接方式可用？

支持的传输包括可信局域网、Tailscale、Cloudflare Tunnel、HTTPS 反代（含路径前缀 API）、@kkcode-app/agent 内置扫码隧道、以及通过独立 SSH 转发客户端创建的 loopback 端口。命令和安全取舍见 远程接入 指南。

我应该把 OpenCode 绑到 0.0.0.0 吗？

仅在可信局域网直连时这样做。开启鉴权，把端口限制在私网防火墙配置里，绝不要走路由器端口转发。远程接入请用 loopback + Tailscale、Cloudflare Tunnel、反向代理或内置扫码隧道。

用 Tailscale 或 Cloudflare Tunnel 时还需要鉴权吗？

保持 OpenCode 鉴权开启。tailnet 或 HTTPS 隧道管的是传输和可达性，但只要服务端启用了鉴权，KKCode 仍然需要服务端凭证。

服务器 URL 能不能包含 /api 或其他路径？

可以。KKCode 会把请求和 SSE 流都保留在配置的路径前缀下。只有当代理或 Web 部署真的把 OpenCode API 挂在那里时才用前缀。

连接凭证存哪？

服务器 URL、用户名和密码加密存在 iOS Keychain（或 Android Keystore 背书的 SecureStore），方便重连。它不等同于操作系统级密钥库，但设备仍然要当作"持有开发机访问权"对待。

realtime 事件断开后会怎样？

KKCode 用退避重连全局事件流，断流期间降级到轮询。核心会话可见性应当能继续，无需手动重连。

KKCode 改 OpenCode 吗？会把数据发给第三方吗？

KKCode 只用 OpenCode 的官方 API，不会运行 OpenCode，也不会保存你的工作区副本。局域网、Tailscale 或反代直连时，流量在手机和你的服务端之间传输；内置二维码隧道为了抵达本地配套 Agent，会通过 KKCode 中继转发流量。如果安全策略要求流量完全留在自有基础设施，请选直连方案。构建开启遥测时，匿名崩溃和使用分析由 Firebase 处理。

KKCode 支持自托管语言模型吗？

支持。任何 OpenCode 支持的模型 —— 包括 Ollama、LM Studio 或自定义 API 端点的自托管模型 —— 都自动可用。模型选择和推理由开发机上的 OpenCode 服务处理，KKCode 只把结果流到手机。