PhoneBridge 0.6.1 — Mac client, LAN file sharing and activity timeline

PhoneBridge 0.6.1 — Mac client, file transfer and activity timeline

Changes

• A bundled Flutter desktop client for macOS 13+ (Apple Silicon and Intel), with pairing, network selection and MCP configuration. Windows uses the same desktop interface. The Mac login service keeps running when the window closes.
• Send a local file from the Mac window or the phone_send_file MCP tool. Receive it explicitly on Android, then open the system share sheet to choose a supported app such as WeChat or WhatsApp. One non-empty file at a time, up to 50 MiB; invitations expire after 10 minutes. Receipt checks file size and SHA-256. Opening the share sheet is not confirmation that a message was sent.
• Android's home screen now has a visible Scan / 扫一扫 entry. Saved computer cards show a switch hint, each computer has its own delete confirmation, and cancelling a rename keeps the computer list open.
• Settings → Operation log shows a chronological timeline of computer operations and local file events, newest first. Local file events remain visible offline. Mixed timestamp precision and time-zone offsets sort by actual time.
• Mac upgrades retain pairing identity, wait for the previous launchd job to exit, and detect changed runtime files at the same installation path. File endpoints now pass through the installed background supervisor.
• File sharing uses a separate Android Provider component from APK updates, preserving each component's directory restrictions.

中文

新增自带运行环境的 Mac 客户端；Mac 界面和 AI 都可发送局域网文件。手机确认接收并校验后，可从系统分享面板选择微信、WhatsApp 等应用。扫一扫移到首页，电脑切换、改名和删除更清楚；设置底部新增按时间排列的操作日志，断线仍可查看本机文件记录。修复 Mac 后台升级、文件路由、安卓分享组件冲突及日志排序问题。

Upgrade and validation

This remains a developer preview. Android releases must retain the existing preview certificate for an in-place update. Do not uninstall the old app to work around a signature mismatch. Mac packages are ad-hoc signed and not Developer ID notarized; Windows packages are unsigned.

Source tests cover bridge authentication, bounded transfer and disconnect handling, desktop lifecycle, Android metadata and hash validation, UI interactions and log ordering. An isolated Android API 36.1 emulator verifies both file-provider authorities through the real system ContentResolver and tests their directory isolation.

The final ARM64 APK uses the existing preview certificate and Android versionCode 4019 (source build number 2019 plus Flutter's ARM64 split offset). Original-signed 2016 → 4019 upgrades passed both on an isolated API 36.1 emulator and on the existing Xiaomi phone, preserving application preferences and first-install time. The emulator also reproduced the old provider failure and verified both repaired authorities. On the physical phone, the repaired build received a fresh file with matching bytes/SHA-256 and displayed the correct image in the system share sheet, including WeChat as an available target. The previously authorized accessibility service was restored during upgrade testing, after which the saved pairing reconnected. The isolated emulator additionally covered Mac-window sending and online/offline logs. No messages to real contacts were sent in these tests.

GitHub Actions builds and checks macOS arm64/x64 and Windows packages. CI packages do not establish physical-device compatibility, macOS reboot/login behavior, or app-store approval. See file transfer, Mac testing and release distribution.

Packages and checksums

Android ARM64 (versionCode 4019), macOS Apple Silicon / Intel (DMG and ZIP), and Windows (installer and portable ZIP) are attached below with SHA-256 sidecars. GitHub asset digests match all 14 uploaded files. Desktop packages were built from runtime commit 537f5a5; the final source adds only release documentation at e585681. Android and desktop application/runtime sources are unchanged between these commits.

Local source checks passed 317 tests, with 8 platform/opt-in skips. The final original-signed Android APK additionally passed an isolated upgrade/Provider regression and the physical Xiaomi upgrade, file-integrity, system-share and timeline checks.

The final documentation commit also passed all five source checks and desktop checks.

安卓扫码下载 / Android download

用手机浏览器扫码下载 PhoneBridge 0.6.1（Android 11+ · ARM64）。
Scan with your phone to download the Android APK.

直接下载 APK / Download APK

PhoneBridge 0.6.0 — Easy setup and visible actions

PhoneBridge 0.6.0 makes setup easier and adds visible actions and saved history.

• Windows installer includes its runtime, finds the local network, starts the service and displays pairing. Copy the ready-to-use MCP configuration from the computer panel. An optional LAN button requests Windows approval once for the private local network.
• Remember several computers on the phone and switch by name. Each computer keeps its own action permissions; one connection is active at a time.
• See AI taps, holds and swipes as brief blue trails. Enabled by default, with a saved Settings switch; excluded from screenshots.
• Operation history is saved locally and readable by AI with phone_operation_history. It records timing, actions and reported outcomes, excluding typed text, screen contents, images and credentials.
• Chinese/English App and website, direct APK/Windows downloads, Obtainium import, and verified release distribution workflow.

Windows 双击安装即可使用，不用装 Node.js 或找 IP；电脑面板可直接复制 AI 的 MCP 配置。手机可记住多台电脑并按名称切换。操作轨迹默认开启，设置可关闭；电脑保存操作日志，AI 可读取，升级保留原配对与授权。

Verified on the existing Android 16 phone and Windows computer. Two local desktop endpoints were tested; two physical computers and cross-network access were not tested. APK uses the existing preview debug signer; Windows executables are unsigned. Uptodown approval is separate from this release. See verification and installation.

PhoneBridge 0.2.5 — Chinese & English

PhoneBridge 0.2.5 adds Chinese and English throughout the Android app and website.

• App follows the system language; Settings lets you choose 中文 or English and remembers your choice without reconnecting.
• Website detects the browser language on first entry, offers a manual language switch, and updates its phone illustration and App update card.
• Adds practical scenarios for food delivery comparisons, flight options and multi-screen phone tasks. These are suggested uses, not claims of completed food or flight tests.
• The existing phone was upgraded and Chinese / English / Follow system were verified through PhoneBridge. Pairing and action permission remained intact.

Validation: Flutter analysis passed; 56 Flutter, 61 native JVM and 9 website language tests passed. Browser layouts checked at 1440 / 390 / 320 px. The installed Android 16 APK was read back and matched the release SHA256.

Download the APK below directly. ARM64 Android 11+ developer preview, retaining the existing debug signing identity. Same-network wireless use is verified; cross-network use and physical OS language changes are not yet tested.
Device note: On the tested Xiaomi ROM, explicitly force-stopping the package removes its enabled accessibility service. A normal foreground launch does not use force-stop; APK upgrade retained the service. The forced-stop test retained language and pairing, and connection recovered after restoring the previously authorized service.

PhoneBridge v0.2.4 — App 内升级

打开「设置 → 关于」即可自动检查版本。点击「下载更新」，APK 在 App 内下载并打开安卓系统安装界面；首次按系统提示允许安装来源，之后覆盖升级保留已有配对与授权。

直接下载 phonebridge-0.2.4-arm64.apk 安装，无需解压 ZIP。

• 支持手动检查、下载进度、网络失败重试，以及取消安装后的重试。
• 下载和安装流程独立于手机连接；返回页面能继续观察已开始的操作。
• 自动核对 APK 文件大小、SHA-256、包名、版本与签名。
• Android 11+、ARM64；仍为 debug 签名的开发者预览版。

验证：Flutter 静态检查通过，48 项 Flutter 测试、61 项原生 JVM 测试通过。

真机验证：Android 16 上通过 App 完成下载、校验和系统覆盖安装；安装包回读哈希与发布 APK 一致，旧配对与操作授权保留，自动重连成功。完整下载使用临时局域网测试源，发布 APK 使用官网 HTTPS 更新源。

发布核对：GitHub APK 链接返回 200，大小与 SHA-256 正确；GitHub Pages 更新清单已上线，升级后的手机通过官方更新源显示‘已是最新版本’。

PhoneBridge 0.2.3 · 自动恢复与一键启动

PhoneBridge 0.2.3 adds desktop recovery while keeping the phone's existing pairing and consent.

• Windows current-user login task starts PhoneBridge and restores crashed desktop processes.
• Phone home offers “启动电脑服务” when disconnected. Tap once to start the Hub and reconnect to the remembered computer.
• No repeated QR scan after updates, service restarts or normal network recovery.
• App's website link points directly to GitHub Pages.

Verified on the owner's Android 16 phone: this exact ARM64 APK installed as an update, retained pairing/actions, reconnected automatically, and started a stopped Hub from the new button. Actual Hub and Supervisor crash recovery passed on Windows. Desktop build and tests, Flutter analysis/tests and 39 native JVM tests passed. A full PC reboot and indefinite background operation have not been tested.

Download the ARM64 APK directly and install over the previous preview. ZIP remains an optional download. This is a debug-signed developer preview, versionCode 2007. Windows setup commands are in README. Computer must be powered on, logged in and reachable for the phone button to work.

APK SHA256: C46292BDE7FE6979570DEED0961C1570E7AEC4785986AB94F5C4A4E793BBD4CF

PhoneBridge 0.2.2 · UI 修复与官网

PhoneBridge 0.2.2 开发者预览版

• 删除正式 App 的“试一试”与练习场。
• 修复圆角卡片按下时出现直角反馈的问题。
• 设置的关于区域新增 GitHub 和官网入口。
• 官网公开上线：https://phonebridge.jevons-code.chatgpt.site

验证：Flutter 静态分析通过，21 项测试通过（包括按压像素回归）；Android 16 真机安装、首页/设置页面检查，更新后保留配对与操作授权。

下载 ZIP，解压后安装其中的 ARM64 APK。适用于 Android 11+，使用 debug 签名，属于开发者预览。源码与安装/MCP 配置见 README。网站不内置 AI 服务。

PhoneBridge v0.2.0 — Persistent Pairing & Verified WeChat Control

PhoneBridge v0.2.0 自用预览版：记住配对与授权，完成 Android 16 微信真机发送验证。

• 手机加密保存可信电脑与操作授权，电脑保存稳定配对身份；App 更新、Hub 重启和普通网络中断可自动重连，无需重复扫码。
• 配对页面取消五分钟自动失效。停止会暂停连接，忘记电脑会删除保存的授权。
• 修复微信空根节点和系统栏尺寸兼容问题，依据实际窗口裁掉状态栏、导航栏和停靠键盘。
• 新增 Android 13+ commit_text，通过无障碍输入接口向已聚焦的非密码输入框写入中文；控件节点不可用时可结合截图操作。
• 读取/截图超时自动重连；不重放任何命令。修改操作结果不确定时仍需重新观察。

验证：Android 16 实机经 App 打开指定微信联系人、输入中文、点击发送，并通过出站消息气泡和清空输入框核实；同时验证更新/Hub 重启后保留配对与授权。手机操作未使用 ADB 模拟点击或输入。发送验证不代表对方已读，其他机型兼容性未作保证。

本地检查：桌面 21 项通过、1 项 POSIX 权限测试在 Windows 跳过；Flutter 17 项通过且分析无问题；原生 JVM 34 项通过。完整记录见仓库 docs/verification.md。

下载 ZIP 后解压安装 ARM64 APK，内附 SHA256SUMS。此 APK 使用 debug 签名，属于开发者预览；源码为 MIT 许可。真实聊天截图、设备标识和配对密钥均不包含在发布文件中。