AB
AiBoss
project

phonebox - 把旧安卓手机变成电脑桌面控制面板

phonebox 是一个开源项目,由一个全屏 Android 应用和一个桌面代理组成,通过 USB 或 Wi-Fi 把旧安卓手机变成电脑的副屏面板,用来查看 PC 状态、AI 编程会话配额、媒体播放与触摸控制。项目采用 MIT 许可,支持 Windows、Linux 与 macOS。

phonebox 是一个把旧 Android 手机改造成电脑桌面面板的开源项目。它由两部分组成:一个运行在手机上的全屏 Android 应用,以及一个安装在电脑上的小型桌面代理。两者通过 USB 数据线或 Wi-Fi 连接后,手机屏幕就能显示电脑的实时状态、AI 编程工具的配额与本地会话、媒体播放信息,并提供一组触摸控制入口。据项目说明,它面向希望给台式机或笔记本增加一块常亮副屏、又不想额外购置硬件的用户,也适合需要在写代码时随手查看 CPU、内存、进程和 AI 会话额度的开发者。项目自述不需要 root、不需要注册 PhoneBox 账号,也不依赖云端服务。

维护者与状态

仓库由 ersinkoc 维护,地址为 github.com/ersinkoc/phonebox。仓库创建于 2026-11-07,最后一次提交在 2026-11-19。最新正式版本为 v0.9.21,发布于 2026-11-18。截至 2026-11-19,仓库获得 3587 个星标。项目采用 MIT 许可证。

从版本号看,项目仍处于 0.9.x 阶段,尚未到 1.0。素材中提到 Windows 发布代理目前未签名,因为 SignPath Foundation 的申请仍在等待中,SmartScreen 或杀毒软件可能给出警告或拦截。这一点在部署前值得留意。

主要能力

以下能力均来自项目自述,具体表现取决于电脑硬件、已安装工具与系统权限。

  • PC 监控:显示 CPU、GPU、内存、磁盘、网络与 ping 数据,提供图表、GPU 详情和进程控制。不同平台的数据来源不同,例如 Windows 使用系统计数器,NVIDIA 显卡可通过 nvidia-smi 读取,额外传感器可借助 LibreHardwareMonitor。
  • AI 编程会话:据项目说明,可查看 Claude、Codex 与 Antigravity 的配额、重置时间和消耗速率预测,也能查看本地 Claude Code 与 Codex 会话,以及 GitHub 评审与 CI 状态。点击某个会话可查看模型、耗时与 token 明细;开启选项后,还能在手机上对 Claude Code 的权限提示选择 Allow 或 Deny。可选的 CodexBar 集成会补充配额提供方与成本概览。
  • 触摸控制:支持应用与网址快捷方式、组合键与宏;通过 Control Deck 控制应用音频、麦克风、媒体、OBS 与系统设置。
  • 日常用途:Now Playing、网络电台、时钟、天气、日历、便签、清单、番茄钟与计时器。
  • 自动化:Webhook 数值与通知、Home Assistant 控制,以及根据电脑上的活动触发的规则。
  • 可视化编辑器:在浏览器中拖拽、缩放组件来搭建面板,项目自述提供 124 个组件、30 个模板、多页面与实时预览。布局基于 12 × 6 网格,支持横屏与竖屏,Smart Stack 可在单个位置放置最多 12 个组件。
  • 多设备:可连接多台手机并各自使用不同布局,也可让一台手机在多台已配对电脑之间切换。

使用入口

项目仓库位于 ersinkoc/phonebox,项目主页为 phonebox 官网,官网提供在线演示与文档入口。

据项目说明,使用前需要一台 Android 5+ 手机(建议 Android 6 或更高)和一台受支持的电脑。发布版代理已内置 .NET 运行时,无需单独安装。Windows 10/11 x64 可在 PowerShell 中执行安装脚本,Linux 与 macOS 则以当前用户身份运行 shell 脚本;脚本会下载最新发布、校验 SHA-256、提示缺失依赖并可选开机自启。项目也提供手动下载压缩包、Scoop 与从源码构建等方式。

连接方式有两种。USB 方式需要开启开发者选项中的 USB 调试,用数据线连接并接受手机上的授权提示,可由安装程序顺带安装手机应用。Wi-Fi 方式无需 adb 与开发者选项:从发布页安装 APK,在电脑设置页开启 Wi-Fi 连接选项并重启代理,然后选择通过 Wi-Fi 配对手机、扫描二维码并确认校验码。手机应用不在任何应用商店上架,只能从仓库的发布页获取,且没有 iOS 版本。

面板搭建在浏览器设置页完成:选择模板、拖拽与缩放组件后保存,实时预览可用真实数据查看未保存的修改。手机端可通过滑动、点击页码圆点或音量键切换页面。

许可与限制

项目采用 MIT 许可证。使用边界方面,项目自述有以下已知限制:

  • 仅支持 Android,没有 iOS 版本;手机应用只能从仓库发布页安装。
  • Windows ARM 与 musl Linux(如 Alpine)没有发布构建。
  • 组件能否工作取决于宿主硬件、已安装工具与权限。例如 GPU 数据在 macOS 上仅在系统暴露时可用,音量控制在 macOS 上因设备而异;Control Deck 的高级功能另有平台依赖。
  • Windows 发布代理当前未签名,可能触发 SmartScreen 或杀毒软件警告。
  • Wi-Fi 默认关闭,需要在设置中手动开启并重启代理生效。

隐私方面,据项目说明,桌面设置服务监听在本机 127.0.0.1:8765,USB 通过 adb reverse 访问;可选 Wi-Fi 使用 8766 端口的 HTTPS,配合固定证书与配对密钥。设置与配对端点保持本地,手机按 ID 请求已配置的动作,命令与集成凭据留在电脑上。项目自述没有遥测、分析或自有账号;天气、配额、GitHub 等可选组件会访问外部服务,代理也会检查 GitHub 更新。