ClavueClavue
macOS AI 工作台

imux-mobile 手机遥控

imux-mobile 是 imux macOS 工作台的专用手机控制面。核心编码路径是 CLI/TUI：多项目工作区、同一项目/会话下的多个终端 surface、键入注入与屏幕快照。Agent Chat 仍用于多步工具与审批。连接方式为云中继（同一 Clavue 账号 + 一次性配对码）— 无需 VPN、无需开放端口。

两款手机应用

  • Clavue Mobile（com.clavue.xw）— 手机端聊天、画图、会员
  • imux-mobile（com.imux.mobile）— 遥控桌面 imux 的编码控制端
  • 共用 Clavue 会员会话；包名与下载通道独立

下载

  • 落地页：www.clavue.com/mobile#imux（www.iccjk.com/mobile#imux 镜像）
  • Android APK 通道：/downloads/mobile/latest-imux-mobile.json
  • 包名：com.imux.mobile · Android 7.0+
  • iOS：App Store / TestFlight 筹备中 — 当前公开渠道为 Android
curl -sS https://www.clavue.com/downloads/mobile/latest-imux-mobile.json | head
# downloads.android.apk → versioned APK URL
# Mirror host also serves the same files under www.iccjk.com

三步配对（Codex 式）

  • Mac：打开 imux → 设置 →「imux 移动版」→ Clavue 登录 → 开启手机链路 → 显示配对码（QR + 8 位码 + imux://pair?code=…）
  • 手机：安装 imux-mobile → 同一 Clavue 账号登录 → Pair host → 输入码或打开深链
  • 保持 Mac 唤醒在线；约 10 秒投影心跳后即可看到项目、终端与 Agent 会话
配对码约 10 分钟过期且一次性使用。不要把有效配对码发给他人。

日常使用

  • 首页：已关联 Mac +「需要你」审批卡片
  • 打开主机 → 多项目列表（每个项目显示终端数 / Agent 数）
  • 打开项目 → Terminals 页（主路径）：选择该项目下任意 pane/tab
  • 终端会话：发送 CLI 命令、快捷芯片、刷新快照、可选 Raw TUI — 同一 surfaceId = 同一会话
  • Agents 页：续写 Agent Chat / plan / chat；审批 允许一次 / 本会话 / 拒绝
  • 执行始终在 Mac（注入与工具）

多项目 · 多终端

  • 每个 imux 工作区投影为一个项目；一台 Mac 可挂多个项目
  • 同一项目下的 split / tab 各自投影为独立终端 surface
  • 手机持续使用同一 surface UUID，后续命令进入同一 shell/TUI 会话
  • Agent Chat 为次要路径，用于同项目下多步工具编排

安全模型

  • 仅通过 clavue.com 会员 API 云中继 — Mac 无需入站端口
  • 设备密钥注册后不再返回；配对码一次性 + 短 TTL
  • 桌面工具审批默认策略仍然生效；手机不能绕过 Mac 策略
  • 手机丢失时可在账户 / 桌面设置撤销设备或重新配对

环境要求

  • macOS imux 已用同一 Clavue 账号登录
  • 设置 → imux 移动版 已开启手机链路
  • 远程会话期间 Mac 保持唤醒
  • 手机可访问 www.clavue.com

通知（v0.1.1+）

  • Mac 任务需要审批或结束（完成/失败）时弹出本地通知
  • 对照 latest-imux-mobile.json 做应用内升级检测
  • 云端 FCM/APNs 推送扇出计划中（客户端渠道已就绪）

当前边界（诚实说明）

  • 实时转写为进度预览轮询（约 2–3 秒）— 尚未全量 token SSE
  • 云端远程推送扇出未上线；应用进程活跃时本地通知覆盖审批
  • 不强制相机扫码；可输入码或打开深链
  • 手机不是完整 IDE / 仓库同步 — 仅控制面

发版操作（维护者）

清单为 latest-imux-mobile.json（与 Clavue Mobile 的 latest-mobile.json 分离）。
cd imux-mobile
./scripts/publish-android-release.sh --bump patch --deploy \
  --notes "修复说明；第二条 changelog"

下一步