Skip to content

v0.2.4

Choose a tag to compare

@github-actions github-actions released this 14 Nov 00:43
· 69 commits to main since this release
c0259b2

English

Upgrade notes

  • The control page and its /mcp need a login. Run iphone-control viewer token and open the link it prints. HTTP MCP clients send Authorization: Bearer <token>. The CLI and stdio MCP are unaffected (#79).
  • With --lan, the page is HTTPS on the local network. Check the certificate fingerprint from service status the first time (#76).
  • ICTL_AGENT_GATE and ICTL_AGENT_TOKEN are replaced by IPHONE_CONTROL_TASK_TOKEN (#64).

New

  • AI tasks for any agent: iphone-control task run -- <command>, steered with task list, events, pause, resume, takeover, handback, stop, approve and reject (#64).
  • Limit a task to some apps with task run --app or the App button on the control page. Anywhere else, each step waits for you (#69, #70).
  • An agent can't pause, approve or otherwise control its own task (#75).
  • The control page picks up running tasks after a reload, including ones started elsewhere (#64).
  • viewer --lan opens the control page to the local network over HTTPS (#72, #76).
  • MCP over HTTP at /mcp on the control page's port (#77).
  • Named and read-only login tokens: viewer token add <name> [--read-only] (#80).
  • Use another machine's phone: mcp --url bridges to its /mcp, and task … --url runs and controls tasks there (#80, #82).
  • service viewer install runs the control page as a background service (#74).
  • Arrow-key setup menus, and shell completions with iphone-control completions <shell> (#71).

Improvements

  • Tasks are kept by the daemon. While one runs, other clients can look but not act (#64).
  • The picture zooms only with its − / + buttons, not by pinching (#68).

Fixes

  • Locking takes about 2 s instead of 10 s on some iPhones, and now works on iPads below iOS 27 (#59, #63).
  • A WDA that still answers /status but nothing else is restarted within about 30 s (#60, #62).
  • A failed lock says what each way of locking did, instead of "WDA just dropped" (#61).
  • On iOS 27, system alerts missing from the phone's video are drawn on the picture and can be tapped (#67).
  • Task summaries on the control page are formatted instead of raw Markdown (#66).
  • Every connected device's screen size is remembered, not only the last one's (#86).
  • Notifications name the device instead of always saying "iPhone" (#85).
  • Updates no longer fail now and then with "Text file busy" (#81).
  • task run keeps the command's own exit code after task finish (#78).
  • Holding an arrow key in setup menus no longer prints escape codes (#73).

中文

升级注意事项

  • 控制台和它的 /mcp 要登录了。运行 iphone-control viewer token,打开它打印的链接;经 HTTP 接入的 MCP 客户端带 Authorization: Bearer <令牌>。命令行和 stdio 方式的 MCP 不受影响(#79)。
  • 开了 --lan 时,局域网里走 HTTPS,第一次打开时核对 service status 显示的证书指纹(#76)。
  • ICTL_AGENT_GATE、ICTL_AGENT_TOKEN 改成 IPHONE_CONTROL_TASK_TOKEN(#64)。

新功能

  • 任何 Agent 都能用 AI 任务:iphone-control task run -- <命令>,用 task list、events、pause、resume、takeover、handback、stop、approve、reject 控制(#64)。
  • 任务可以限定 App:task run --app,或控制台上的 App 按钮。到了别的 App,每一步都先等你确认(#69、#70)。
  • Agent 不能暂停、批准或以其他方式控制自己的任务(#75)。
  • 页面刷新后,控制台会接上正在进行的任务,包括在别处开的(#64)。
  • viewer --lan 把控制台经 HTTPS 开放到局域网(#72、#76)。
  • 控制台同一端口提供 MCP over HTTP(/mcp)(#77)。
  • 有名字的登录令牌,可以是只读的:viewer token add <名字> [--read-only](#80)。
  • 操作另一台机器上的手机:mcp --url 转到它的 /mcp,task … --url 在那里开任务、控制任务(#80、#82)。
  • service viewer install 把控制台装成后台服务(#74)。
  • 设置菜单可以用方向键选择;iphone-control completions <shell> 生成补全脚本(#71)。

改进

  • 任务由守护进程管理:任务进行中,其他客户端只能看、不能操作(#64)。
  • 画面只能用上方的 − / + 缩放,不再响应捏合(#68)。

修复

  • 部分 iPhone 锁屏从约 10 秒降到约 2 秒,iOS 27 以下的 iPad 也能锁屏了(#59、#63)。
  • WDA 还应答 /status、其他请求都不应答时,约 30 秒内会被重启(#60、#62)。
  • 锁屏失败时如实说明两种锁屏办法各自的结果,不再报「WDA 刚掉线」(#61)。
  • iOS 27 上,手机视频里看不到的系统弹窗会画在画面上,可以直接点(#67)。
  • 控制台上的任务总结按格式显示,不再是 Markdown 原文(#66)。
  • 接着多台设备时,每台的屏幕尺寸都记住,不再只记最后一台(#86)。
  • 通知标题写设备自己的名字,不再一律写「iPhone」(#85)。
  • 升级不再偶尔因「Text file busy」失败(#81)。
  • task finish 之后,task run 保留命令自己的退出码(#78)。
  • 在设置菜单里长按方向键不再回显按键序列(#73)。

Binaries / 二进制: macOS macos-arm64 (11+, Apple Silicon) · Linux linux-x86_64, linux-aarch64 (glibc 2.34+) · .deb amd64, arm64 (Debian 12+, Ubuntu 22.04+)

  • Script / 脚本: curl -fsSL https://github.com/Derrors/iphone-control/releases/download/v0.2.4/install.sh | sh
  • Homebrew: brew install Derrors/tap/iphone-control
  • Debian / Ubuntu: sudo apt install ./iphone-control_0.2.4_amd64.deb (or / 或 _arm64.deb)

Already installed? Run iphone-control update. / 已安装的运行 iphone-control update 升级。