№ 1066GitHub
Muse remote-control bridge for Intel Macs
Since Muse for Mac ships only for Apple silicon, this small service lets Muse's cloud VM screenshot, click and type on an Intel Mac, compressing each 5K frame to about 150 KB and handling Retina coordinate scaling.
muse-intel-mac-bridge
让 Meta Muse（以及任何运行在 Linux VM 里的 AI agent）远程操作你的 Intel Mac。
官方 Muse for Mac 只提供 Apple 芯片（arm64）版本。在 Intel Mac 上打开会提示“此版本不能与此版本的 macOS 配合使用”，即使系统版本已经满足要求（macOS 14+）。本项目提供一个轻量替代方案：在 Mac 上运行一个小服务，Muse 通过它的云端 VM 截图、点击、打字，从而操作你的 Mac。
English summary at the bottom.
为什么不用 VNC？
直接用 VNC 截图，5K 屏幕的一帧就有几十 MB，传输很慢，容易超时。本项目在 Mac 本地完成截图、缩放和 JPEG 压缩，每帧约 100–200 KB，并自动处理坐标换算。
| VNC 截图 | muse-intel-mac-bridge | |
|---|---|---|
| 单帧大小（5K 屏） | 几十 MB | ~150 KB |
| Retina 坐标换算 | agent 自己算，容易点偏 | 服务自动完成 |
| 输入中文 | 麻烦 | 支持（自动走剪贴板） |
| 需要开放的端口 | 5900 | 无（通过 Tailscale Funnel） |
工作原理
手机上的 Muse ──► Muse 云端 Linux VM ──HTTPS──► Tailscale Funnel ──► 你的 Mac
(运行 mab.py 客户端) (mac_agent_server.py)
- agent 看到的永远是 1280 宽的截图，坐标也用这张图的像素坐标。
- 服务把坐标换算成 macOS 逻辑坐标（Retina 下截图像素是逻辑点的 2 倍）。
- 服务默认只监听
127.0.0.1，由 Tailscale Funnel 提供 HTTPS 访问，所有请求都需要 token。
系统要求
- macOS 12 或更高版本，Intel 或 Apple 芯片均可
- Python 3.9+（
xcode-select --install会附带） - Tailscale（用于把服务暴露给云端的 agent）
快速开始
1. 下载并启动
git clone https://github.com/<你的GitHub用户名>/muse-intel-mac-bridge.git
cd muse-intel-mac-bridge
chmod +x start.sh
./start.sh
首次运行会自动创建虚拟环境、安装依赖，并生成 token（保存在 .env）。
2. 授予权限
打开「系统设置 → 隐私与安全性」，给你使用的终端（Terminal / iTerm）开启：
- 屏幕录制：用于截图。没开的话截图会是黑屏或只有桌面壁纸。
- 辅助功能：用于控制鼠标和键盘。
开启后需要完全退出并重新打开终端，再运行 ./start.sh。
3. 本地测试
另开一个终端：
source .env
curl -H "Authorization: Bearer $AGENT_TOKEN" http://127.0.0.1:8765/screenshot -o s.jpg && open s.jpg
curl -H "Authorization: Bearer $AGENT_TOKEN" http://127.0.0.1:8765/info
图片大约 100–200 KB、画面正常，就说明服务工作正常。
4. 通过 Tailscale Funnel 暴露
- 安装并登录 Tailscale：
brew install --cask tailscale - 在 Tailscale 管理后台 开启 HTTPS，并在 Access Controls 中允许 Funnel
- 按 Ctrl+C 停掉服务，改用
./start.sh --funnel启动
终端会显示形如 https://你的mac名.xxx.ts.net 的公网地址。
5. 连接 Muse
打开 docs/muse-prompt.md，把里面的说明发给 Muse，替换好地址和 token。先让它运行：
python3 mab.py info
返回 JSON 就说明连通了。
客户端 mab.py
在 agent 的 VM 里运行，只依赖 Python 标准库：
export MAB_URL=https://你的mac名.xxx.ts.net
export MAB_TOKEN=你的token
python3 mab.py screenshot -o screen.jpg # 截图
python3 mab.py click 640 400 # 单击（--double 双击，--right 右键）
python3 mab.py type "你好 hello"
