官网与下载入口:https://lagoon.igng.net/
面向多种 coding agent harness 的原生 Android 移动控制端。Kotlin + Jetpack Compose 界面采用小米 HyperOS / MIUIX 设计规范,引入连续曲率 Squircle、科技蓝语义调色板。App 首发支持用户自己的 OpenCode 2.x Server,现已适配 DeepSeek Harness:可通过一个 DSH Remote Hub 账号,或任意数量的 SSH 主机接入;旧版直连 DSH 资料保留可编辑/删除,但不再作为新建连接方式。
Lagoon 目前只维护 Android 客户端。v3 曾提供自托管中枢与网页端,现已停止维护并从本仓库移除;相关说明见 docs/HUB_EOL.md。
- 首发支持 OpenCode 2.x 服务端(
/api/*接口,以/api/info识别版本;1.x 已不再支持);多服务器连接、Basic Auth/官方 pair 链接、Android Keystore 保护的密码与会话 Cookie、离线缓存、SSE 自动重连 - 支持 DeepSeek Harness:一个 DSH Remote Hub(浏览器/邮箱登录、主机目录、逐台指纹核对)或任意数量的 SSH 主机(密码/私钥、Host Key 固定、远端
dsh web启停/复用、稳定本地转发与断线重连);走 Typert RPC(一元调用 + mux 事件流),时间线、任务状态、审批与问答和其它 harness 共用同一套界面与通知;详见docs/SSH_HOSTS.md与下文「DeepSeek Harness 支持」 - 支持通过 SSH 或 DSH Remote 接入开发机上的 Codex:浏览和继续线程、发送任务、查看流式输出与工具过程,并处理连接所支持的审批;两种连接的能力和断线行为不同,配置及限制见
docs/CODEX.md - 支持通过 SSH 或 DSH Remote 接入已登录的 Antigravity(
agy acp):会话、流式回复、模型、审批和只读文件;Remote 终端按 Host 授权启用。安装条件、连接器与功能差异见docs/AGY.md - 项目与会话、异步任务(运行中可继续发送以引导当前轮次)、Agent/Model、新会话默认预设 / 模型 / 思考强度(按连接保存在本机)、斜杠命令(走服务端
/command)、文本/Reasoning/Tool 消息、停止与权限/表单处理;时间线按官方客户端规则投影,系统指令、合成输入、技能等给模型看的记录只显示一行通知;会话列表在标题下显示所属工作区(OpenCode 项目 / DSH Workspace,只做展示,不改变筛选与新建目标) - 子会话、改动、文件浏览与搜索、重命名、删除;随版本变化的接口(重命名、恢复撤销、改动、已读同步)按实例
/openapi.json选择 - 设备管理:首页左上角范围面板提供「全部设备」、显式设备组与单台连接,添加设备页用 OpenCode / DeepSeek Harness 分页;DSH 页支持一个 Remote Hub + 无限 SSH 主机,设备组可混合设备与 Harness;每个连接可单独启用/禁用,禁用后不再连接,其对话、归档、任务汇总和通知从本机隐藏,凭据、草稿和缓存保留;分组 v1 升级时只清空一次,旧服务器资料/凭据/缓存不受影响;详见
docs/DEVICE_MANAGEMENT.md - 全服务器任务总览:实时显示运行中、未读完成、待回复与失败计数,并可从首页直接打开最需关注的任务;Android 16+ 使用系统实时更新(Live Updates),Android 15 及以下使用普通任务通知与应用内首页概览,详见
docs/LIVE_UPDATES.md - 本地前台监控与运行中、待处理、完成通知;任务总览仅统计未读结果,用户打开会话后即视为已读;支持一键清空本机未读结果,并可独立把服务端
time.viewed同步到已结束的执行轮次 - 应用内检查更新:设置页按 SemVer 选择 GitHub 上的正式版或预发布版,下载后校验大小、SHA-256、包名、版本码与签名,再交给系统安装器覆盖安装;首次安装会引导开启“安装未知应用”
需要 JDK 17+、Android SDK Platform 36。执行:
ANDROID_HOME=/path/to/Android/Sdk ./gradlew :app:assembleDebug :app:testDebugUnitTest本仓库把 Gradle build 输出放在 BUILD_SCRATCH_ROOT(默认 ~/.build),每个 checkout 使用独立路径 <scratch>/Lagoon/<checkout-hash>/app/outputs/apk/debug/app-debug.apk。
在 App 中添加可访问的 OpenCode Server URL。服务端需启用 Basic Auth;也可以直接粘贴 opencode pair 输出的官方链接,App 会访问一次链接、保存返回的会话 Cookie,再用该 Cookie 连接 API。建议通过 HTTPS 或可信 VPN 访问。使用局域网 HTTP 时,必须在该服务器资料中明确开启明文连接,授权会随资料保存。
添加 DeepSeek Harness 走「添加设备 › DeepSeek Harness」,该页只有两种新连接方式:
- DSH Remote Hub:登录一个 Hub 账号,发现账号下的电脑,逐台核对 Host 指纹后接入。每台 Host 注册独立的 client 身份,因此可以并行监控;不会退化成一次只连一台。Hub 目录、浏览器登录和自建服务器邮箱登录沿用
docs/DSH_REMOTE_*的链路。 - SSH 主机:填写地址、端口、用户名、密码或私钥,首次连接核对
SHA256:主机指纹。App 通过 SSH 自动探测/启动dsh web(--host 127.0.0.1 --port 0 --no-open),把它转发到手机本地,再用Host: 127.0.0.1:<远端端口>登录 DSH。主机需要 POSIX shell(Linux/macOS/WSL),并已安装dsh;详细字段、状态目录、Host Key、重连与安全边界见docs/SSH_HOSTS.md。
旧版直连 DSH(地址 + 启动令牌/签名密钥)资料仍会出现在设备管理的 Harness 区域,可编辑或删除;新版本不再创建直连资料。
DSH 的 Client↔Host 协议与 OpenCode 完全不同,Lagoon 用 HarnessClient 接口屏蔽差异,由 DshApi 做协议翻译(完整契约见 docs/dsh-protocol.md):
- 连接:启动令牌先走浏览器式根路径交换(
GET /?token=…,长寿命 Cookie,跨进程重启有效),只有根路径不交付 Cookie 时才退回GET /connect?token=…&interactions=answer的 API Peer(其 Cookie 只放内存);换到的浏览器 Cookie 落盘复用、签发超过半天自动续期,被服务端拒绝时清掉并提示重新配对;签名密钥模式在本机签发 Cookie。一元调用POST /api/<namespace>/<method>(payload 只含一个args对象,字段是方法形参名),流式数据走/api/remote.muxWebSocket(open/item/end帧,20 秒心跳),全局事件与审批/问答瀑布走$events;事件流重连后按 Host 的重新投递对账待办,单条会话流断开会退避重连并补投断线期间的事件。 - 已支持:会话列表/创建/重命名/归档/分叉、发送(steer 打断当前轮次、queue 排队)、停止、模型目录与选择、Agent 预设(
agentPresets)、审批与问答(waterfall 折算成同一套提示,回应走$events/result;其他客户端结算后本机自动撤回)、子会话、时间线(用户消息、assistant 文本/Reasoning 的实时流式、工具调用与结果、压缩与命令记录)、文件浏览(workspaceFiles;没有会话的目录用directoryPicker浏览子目录)、文件搜索(fileReferences,与@提及同源)、图片与文本附件、改动列表与逐文件对比、后台任务状态、/compact等斜杠命令。 - 差异:DSH 没有删除会话与消息级回退,界面上不提供「删除」,改为「归档」,并在会话菜单提供「分叉」;审批只有「允许一次 / 拒绝」;改动摘要只在 dsh 进程内、会话存活期间提供(重启后旧轮次没有对比);引用的服务器文件以
@路径文本随消息发送。
本地前台服务只监控当前服务器。切换服务器会明确停止旧服务器的本地监控,远端任务继续。离线缓存与局部失败数据均标记为过期,不能用于发送操作。
消息按官方客户端方式发送:客户端生成消息 id,仅在连接中断时用同一 id 重试一次。待处理权限按会话读取(/api/session/{id}/permission),表单按会话所在目录读取,不会因服务器工作目录不同而漏掉。“始终允许”只在服务端给出保存范围时提供,设置页可查看和撤销已保存权限。
项目统一更名为 “Lagoon”(应用显示名为 Lagoon,定位从 OpenCode 专用客户端升级为面向多 Harness 的通用移动控制端)。
- 显示名与工程名:应用显示名为
Lagoon,rootProject.name = "Lagoon",发布工作流名为发布 Lagoon Release,安装包产物名为Lagoon-<version>.apk,Gradle 构建输出放在BUILD_SCRATCH_ROOT(默认~/.build)。 - 应用标识与升级:
applicationId保持为com.igng.opencode.lagoon并使用固定生产签名,与既有安装版本签名完全一致,支持直接平滑覆盖安装升级。 - 深链接:支持
lagoon://路由(同时兼容接听opencode-lagoon://历史深链接)。 - 安全存储:
KeystoreCipher别名升级为lagoon-*,并自动兼容读取旧有的opencode-lagoon-*凭据。 - CI / CD:发布工作流优先读取
LAGOON_*Secrets,并向下兼容读取OPENCODE_LAGOON_*Secrets。 docs/releases/下的历史发布说明保持原样,它们记录的是当时实际发布的名称。
Android 构建与单元测试只能证明代码可编译和有限的 API/状态逻辑。真实服务端版本、SSE 断线恢复、Android 16 Live Updates 提升都需要在目标服务器和设备上验收。Android 15+ 的 dataSync 前台服务有运行时长限制。