Skip to content

Releases

Phone Use v1.3.0

Choose a tag to compare

@github-actions github-actions released this 04 Oct 17:50

Phone Use 1.3.0

复制 App 中的提示词给 AI,即可安装 Skill 并开始配对。本版还改进了后台保活、权限引导和连接地址设置。

下载与升级

  • 下载 PhoneUse-1.3.0.apk,安装到 Android 11 或更新版本的手机。
  • 从 1.2.0 升级保留已有配对和 HTTPS 公钥绑定。旧的公网地址设置会迁移为访问地址白名单;需要继续使用的手机 IP 也应加入列表。
  • phone-use-1.3.0.zip 和 phoneuse-mcp-1.3.0.zip 提供离线 Skill 与 MCP 接入包,SHA256SUMS.txt 提供校验值。

主要变化

  • 从手机连接 AI:在「连接 AI」卡片选择地址、复制完整提示词。AI 从手机下载并校验随 App 分发的 Skill,安装后发起配对;核对八位码、在手机授权并向 AI 确认后即可操作。
  • 自动启动与后台保活:打开 App 自动启动服务;新增后台保活开关,以及电池优化、自启动和通知设置引导,首页展示保活状态。
  • 更清晰的权限提示:突出无障碍权限状态和开启步骤;启动应用后检查目标是否进入前台,未确认时提供后台启动权限提示与通知。
  • 连接地址管理:新增地址选择器,优先展示 IPv4;访问地址白名单替代公网地址设置,同时明确本机 HTTP 与可选远程 HTTP 的范围。
  • 文档与案例:更新中英文 README,加入手机操作案例与简明上手流程。

后台保活仍受 Android 和厂商策略限制。强行停止后需重新打开 App;无障碍授权被关闭后需手动开启。操作期间保持手机亮屏、解锁。

详见使用说明和AI 接入指南。

English

Copy the setup prompt from the app to your AI to install the Skill and start pairing. This release also improves background operation, permission guidance, and connection settings.

Download PhoneUse-1.3.0.apk for Android 11+. Upgrading from 1.2.0 preserves saved pairings and HTTPS key bindings. An existing public-address setting migrates to the access address allowlist; add any phone IPs you still need to use.

  • Connect from the phone: choose an address in Connect your AI and copy the complete prompt. The agent downloads and verifies the bundled Skill, installs it, and starts pairing. Compare the eight-digit code, approve on the phone, and confirm the match to the agent.
  • Automatic startup and background keep-alive: opening the app starts its service. A keep-alive setting includes battery, autostart, and notification guidance, with status shown on the dashboard.
  • Permission and app-launch guidance: the dashboard highlights Accessibility setup. App launches check for the target in the foreground; unconfirmed launches show permission guidance and a notification.
  • Connection settings: an address selector prioritizes IPv4. An explicit access address allowlist replaces the public-address setting, with clearer rules for local and optional remote HTTP.
  • Documentation: refreshed English and Chinese READMEs include phone-use examples and a shorter setup flow.

Android and vendor policies can still stop background operation. Reopen the app after a force-stop and manually re-enable Accessibility if it was revoked. Keep the phone awake and unlocked during use.

Offline Skill and MCP packages are available as phone-use-1.3.0.zip and phoneuse-mcp-1.3.0.zip, with checksums in SHA256SUMS.txt. See the usage guide and AI integration guide.

Phone Use v1.2.0

Choose a tag to compare

@github-actions github-actions released this 04 Oct 17:49

Phone Use 1.2.0

本版在同一个 8443 端口兼容 HTTP 与 HTTPS,新增本机 HTTP 控制台和可选的远程 HTTP 连接。

下载与升级

  • 下载 PhoneUse-1.2.0.apk,在 Android 11 或更新版本上安装。
  • 从 1.1.0 升级保留 HTTPS 公钥绑定和已有配对;MCP/Python 客户端继续使用 HTTPS,不自动降级。
  • “打开 Web 控制台”始终打开 http://127.0.0.1:8443/。HTTP 与 HTTPS 使用独立的浏览器 Cookie,切换协议可能需要重新配对。
  • phone-use-1.2.0.zip 和 phoneuse-mcp-1.2.0.zip 分别提供离线 Skill 与 MCP 接入包;SHA256SUMS.txt 提供文件校验值。

主要变化

  • 本机回环 HTTP 始终可用;非回环 HTTP 默认拒绝。
  • 新增“允许不安全的 HTTP 连接”设置,默认关闭、持久化保存、切换立即生效。关闭时断开已有远程 HTTP 连接,并使其排队任务与等待中的观察失效。
  • HTTP 仍需正常配对和鉴权,保留同源限制及 DNS 重绑定防护。HTTP 不加密屏幕内容、操作或凭据。
  • App 展示非回环网络地址及显式配置的公网地址,默认展示 HTTPS,开启设置后额外展示 HTTP。公网可达性和端口映射仍由部署环境负责。
  • 新增浅色、深色和跟随系统的主题设置,修复浏览器会话检查与配对批准之间的 Cookie 竞争。

详情见使用说明和传输安全说明。

English

This release supports HTTP and HTTPS on the same port, 8443. Download PhoneUse-1.2.0.apk for Android 11+. Upgrades from 1.1.0 preserve HTTPS public-key bindings and existing pairings. MCP/Python clients continue to require HTTPS without automatic downgrade.

The app's web console button always opens http://127.0.0.1:8443/. Loopback HTTP is always available. Remote HTTP requires the new Allow insecure HTTP connections setting, which is off by default, persists across restarts, and takes effect immediately. Disabling it disconnects active remote HTTP requests and invalidates their queued work and ongoing observations.

Both transports require pairing and authorization, with same-origin restrictions and DNS rebinding protection. HTTP does not encrypt screen content, actions, or credentials. HTTP and HTTPS use separate browser cookies, so switching schemes may require pairing again.

The app displays non-loopback network addresses and an explicitly configured public address, adding HTTP URLs only when enabled. Routing and port forwarding remain the deployment's responsibility. This release also adds light, dark and system themes and fixes the browser session-check race with pairing approval.

Versioned Skill and MCP ZIPs are available for offline installation, with checksums in SHA256SUMS.txt. See the usage guide and transport security guide.

Phone Use v1.1.0

Choose a tag to compare

@github-actions github-actions released this 28 Sep 14:55

Phone Use 1.1.0

本版新增 HTTPS 连接、公钥绑定和八位配对码核对,并将 Skill 拆分为独立仓库。

下载与升级

  • 下载 PhoneUse-1.1.0.apk,在 Android 11 或更新版本上安装。
  • 手机 App 和电脑端 Skill/MCP 客户端都需要更新,并重新配对一次。 旧 HTTP 凭证不再用于 HTTPS 连接,不支持降级到 HTTP。
  • 连接 App 显示的 HTTPS 地址,逐位核对手机与客户端显示的全部八位码,在手机批准后,再在客户端确认一致。
  • Skill 安装命令:npx skills add nidhoggfgg/phone-use-skills --skill phone-use。
  • phone-use-1.1.0.zip 和 phoneuse-mcp-1.1.0.zip 分别提供离线 Skill 与 MCP 接入包;SHA256SUMS.txt 提供文件校验值。

主要变化

  • 手机服务使用 HTTPS(TLS 1.2/1.3),每次安装生成独立的 Android Keystore 密钥;原生客户端保存并验证公钥绑定。
  • 首次配对增加双端八位码核对和客户端显式确认;公钥变化时拒绝连接,避免自动信任替换后的身份。
  • 将静态界面标签归入可操作目标,改善 AI 对界面操作对象的理解。
  • Skill 通过独立仓库分发,主仓库通过 Git 子模块维护同步副本。

手机与客户端仍需网络互通。浏览器直连需要独立建立证书信任;网页授权码不能替代原生客户端的八位码核对。详情见接入指南和传输安全说明。

English

This release adds HTTPS connections, pinned server public keys, and eight-digit pairing verification. It also distributes the Skill from a standalone repository.

Download PhoneUse-1.1.0.apk for Android 11+. Update both the Android app and the Skill/MCP client, then pair again. Old HTTP credentials are not reused, and HTTP fallback is not supported. Connect to the HTTPS address shown in the app, compare all eight digits on both devices, approve on the phone, and explicitly confirm the match in the client.

The phone uses TLS 1.2/1.3 with an installation-specific Android Keystore key. Native clients pin the public key and reject unexpected key changes. Static UI labels are now grouped under actionable targets. Install the standalone Skill with npx skills add nidhoggfgg/phone-use-skills --skill phone-use; versioned Skill and MCP ZIPs are available for offline installation, with checksums in SHA256SUMS.txt.

The phone must remain reachable from the client. Browser access requires independently established certificate trust; browser authorization codes do not replace native eight-digit verification. See the integration guide and transport security guide.

Phone Use v1.0.0

Choose a tag to compare

@github-actions github-actions released this 17 Sep 10:49

Phone Use 1.0.0

让 AI 看见并操作你的 Android 手机,由你在手机上批准访问。

下载与安装

  • 手机用户:下载 PhoneUse-1.0.0.apk,在 Android 11 或更新版本上安装。
  • 开启无障碍服务,启动 Phone Use,在电脑端连接 App 显示的地址,核对配对码并在手机批准。
  • AI 接入步骤见中文指南。
  • phone-use-1.0.0.zip 是离线 Skill;phoneuse-mcp-1.0.0.zip 是离线 MCP 接入包,按需下载。
  • SHA256SUMS.txt 用于校验下载文件;源码和分发包采用 MIT 许可证。

本版功能

界面树与截图观察、点击与滑动、文字输入、应用切换、Web 控制台、MCP 与 Skill 接入、多设备管理、手机端配对授权及暂停/停止。

使用条件

手机和 AI 客户端需要网络互通;当前使用未加密的 HTTP,请在可信局域网使用。AI 客户端在手机外运行,屏幕内容会提供给连接的客户端,具体模型的数据处理取决于你选择的客户端及服务。部分系统需要为侧载应用允许“受限设置”;后台策略、受保护窗口及自定义控件可能影响操作。测试覆盖见验证指南。


English

Download PhoneUse-1.0.0.apk for Android 11+. Enable accessibility, start the service, connect your AI client and approve pairing on the phone. See the integration guide.

This release provides screen observation, touch and text input, app navigation, a web console, MCP and Skill integrations, multiple-device management, and local pause/stop controls. The ZIPs are optional offline integrations. Checksums and the MIT license are included.

Use a trusted local network: transport is currently unencrypted HTTP. Screen data goes to the connected client; model-side data handling depends on your chosen client and provider. Restricted settings, vendor background policies and protected/custom UI can affect functionality. See the validation guide for coverage.