Fresco的缓存命中和使用策略

如何做一台专属的“豆包”手机

一、核心前提

• 手机要求：Android 7.0+ 真机 / 模拟器，需开启开发者模式和 USB 调试
• Mac 要求：已安装 Python 3.8+（推荐 3.10）、Homebrew（包管理器）
• 网络：确保 Mac 和手机（有线 / 无线）网络互通（无线调试可选）

二、步骤 1：Mac 端安装 ADB 工具（关键）

ADB 是控制安卓手机的核心工具，Mac 下通过 Homebrew 快速安装：

# 1. 安装 Homebrew（未安装的话执行，已装跳过）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. 安装 ADB（Android Platform Tools）
brew install android-platform-tools

# 3. 验证安装成功
adb version
# 预期输出：Android Debug Bridge version x.x.x（如 1.0.41）

三、步骤 2：手机端配置（必做）

1. 开启开发者模式

• 打开手机「设置」→「关于手机」→ 连续点击「版本号」7 次，直到提示「开发者模式已开启」
• 返回设置主界面，找到「开发者选项」（通常在「系统和更新」/「更多设置」里）

2. 开启调试相关权限

• 开启「USB 调试」
• 部分机型（如小米 / 华为）需额外开启「USB 调试 (安全设置)」（否则能打开应用但无法点击）
• 开启「无线调试」（可选，后续可无线连接手机）

3. 安装并启用 ADB Keyboard

• 下载 ADB Keyboard：https://github.com/senzhk/ADBKeyBoard/raw/master/ADBKeyboard.apk
• 手机安装该 APK 后，进入「设置 → 语言和输入法」，将默认输入法切换为「ADB Keyboard」（解决中文输入失败问题）

4. 验证手机与 Mac 连接

• 用 数据传输线（别用纯充电线）连接手机和 Mac

• 手机弹出「允许 USB 调试？」弹窗，勾选「始终允许」并确认

• Mac 终端执行：

  adb devices

  ✅ 预期输出（有设备编号 + device）：

  List of devices attached
  1234567890    device  # 1234567890 是你的设备ID

  ❌ 若显示 unauthorized，则需要重新拔插数据线，确保手机授权；若为空：换数据线 / USB 口，重启 ADB（adb kill-server && adb start-server）

四、步骤 3：克隆代码仓库并安装 Python 依赖

# 1. 克隆仓库（需安装 git，未装则执行 brew install git）
git clone https://github.com/zai-org/Open-AutoGLM.git
cd Open-AutoGLM

# 2. （可选）创建虚拟环境（推荐，避免依赖冲突）
python3 -m venv autoglm-venv
source autoglm-venv/bin/activate  # 激活虚拟环境

# 3. 安装项目依赖
pip install -r requirements.txt && pip install -e .

五、步骤 4：部署模型服务（二选一，推荐选「第三方服务」）

Open-AutoGLM 本身不包含模型，需对接模型服务，两种方案：

方案 A：使用第三方模型服务（无 GPU 要求，新手推荐）

无需本地部署模型，直接调用智谱 / 魔搭的公开服务：

1. 申请 API Key

• 智谱 BigModel：https://docs.bigmodel.cn/cn/api/introduction（注册后获取 API Key）
• ModelScope 魔搭：https://modelscope.cn/models/ZhipuAI/AutoGLM-Phone-9B（注册后获取 API Key）

2. 测试调用（以智谱为例）

# 替换 <你的API Key> 为实际值，执行测试命令
python main.py --base-url https://open.bigmodel.cn/api/paas/v4 \
  --model "autoglm-phone" \
  --apikey "<你的API Key>" \
  "打开微信，给文件传输助手发送消息：部署成功"

方案 B：本地部署模型（需 NVIDIA GPU，24GB+ 显存）

Mac 若为 Intel 芯片 + 外接 GPU/Apple Silicon（需适配），步骤如下：

# 1. 安装 vLLM（模型推理框架）
pip install vllm

# 2. 启动本地模型服务（自动下载 ~20GB 模型，需耐心等待）
python3 -m vllm.entrypoints.openai.api_server \
  --served-model-name autoglm-phone-9b \
  --allowed-local-media-path / \
  --mm-encoder-tp-mode data \
  --mm_processor_cache_type shm \
  --mm_processor_kwargs '{"max_pixels":5000000}' \
  --max-model-len 25480 \
  --chat-template-content-format string \
  --limit-mm-per-prompt '{"image":10}' \
  --model zai-org/AutoGLM-Phone-9B \
  --port 8000

# 3. 本地测试调用（模型服务启动后，新开终端执行）
python main.py --base-url http://localhost:8000/v1 \
  --model "autoglm-phone-9b" \
  "打开微信，给文件传输助手发送消息：部署成功"

六、步骤 5：验证部署结果

执行上述测试命令后，观察手机行为：

✅ 成功标志：

1. 手机自动解锁（若未锁屏）→ 打开微信
2. 自动搜索「文件传输助手」→ 进入聊天框
3. 自动输入「部署成功」并发送

七、进阶：无线调试（摆脱数据线）

若想无线控制手机，Mac 和手机需在同一 WiFi 下：

# 1. 先通过数据线连接手机，执行（手机端需开启「无线调试」）
adb tcpip 5555

# 2. 拔下数据线，获取手机 IP（手机设置→WLAN→已连接WiFi→详情）
adb connect <手机IP>:5555  # 例：adb connect 192.168.1.100:5555

# 3. 验证无线连接
adb devices  # 应显示 <手机IP>:5555    device

# 4. 无线模式下运行 Agent
python main.py --device-id <手机IP>:5555 \
  --base-url <模型服务URL> \
  --model <模型名> \
  "打开抖音刷视频"

八、常见问题排查（Mac 端高频问题）

问题现象	解决方案
adb devices 无输出	1. 换原装数据线；2. 重启 ADB（adb kill-server && adb start-server）；3. 手机重新授权
中文输入乱码 / 无输入	确认手机默认输入法是 ADB Keyboard，重启 Agent 重试
ModuleNotFoundError	确保激活虚拟环境，重新执行 pip install -r requirements.txt
模型服务连接失败	1. 检查模型 URL 是否正确；2. 第三方服务需确认 API Key 有效；3. 本地模型需确认 8000 端口未被占用
能打开应用但无法点击	手机开启「USB 调试 (安全设置)」，重启 ADB 和 Agent

九、常用命令速查

# 查看支持的应用列表
python main.py --list-apps

# 交互模式运行（可连续输入指令）
python main.py --base-url <模型URL> --model <模型名>

# 重启 ADB 服务（排错用）
adb kill-server && adb start-server

注意事项

1. 本项目仅用于学习研究，请勿用于非法用途
2. 敏感页面（如支付 / 银行）截图会黑屏，属于正常系统保护
3. Apple Silicon 芯片的 Mac 部署本地模型时，需确保 vLLM 适配 ARM 架构（建议优先用第三方服务）

如果部署中遇到具体报错，可提供报错信息和操作步骤，进一步定位问题。

参考

开源项目：Open-AutoGLM