Everything Mobile — AI skill for Claude Code

everything-mobile

用 AI 驱动安卓手机的命令行工具 —— 库内无 AI。

`mobilecli` 是一个 Python 命令行工具，让外部 AI 智能体（Claude Code、Codex CLI、openclaw 等）驱动一台真实的安卓手机。每条命令都是 JSON 进 / JSON 出且无状态；AI 读取 CLI 写到磁盘的截图 / XML dump，再决定下一步做什么。

**这个库里没有 AI。** 智能存在于调用 `mobilecli` 的那个工具里。

---

⚠️ 免责声明

**本项目仅用于学习与安全研究。** 这是一个通用的 Android 自动化库，演示 AI 代理如何驱动移动 App。维护者不鼓励、不推荐、不为任何违反第三方平台（包括但不限于抖音、快手、小红书、微信、TikTok）服务条款的使用行为负责。使用者须独立承担行为、账号安全与法律合规责任。使用本项目用于刷量、骚扰、群发、伪造互动、规避平台反作弊机制等行为，**明确不在本项目支持范围内**。使用本软件即代表接受所有风险，包括但不限于账号封禁、限流、限评、设备级封锁。

**关于状态变更操作。** 部分动作（`like` 点赞 / `comment` 评论 / `reply` 回复 / 批量 `engage` / `publish` 发布）在加 `--commit` 且设置 `EM_ALLOW_COMMIT=1` 环境变量时，会真正改动平台状态。这道双闸是*技术防呆*，不是授权——它强制操作者做出明确、不可逆的选择。每日上限（governor）与文案检查会被执行，但它们只是为了让你慢下来，并不能让自动化互动变得安全或合规。**设置 `EM_ALLOW_COMMIT=1` 的一切法律与道德责任由你独自承担。**

---

快速开始

pipx install -e .
mobilecli devices
mobilecli doctor
mobilecli screenshot -o /tmp/x.png

**第一次用红米 / MIUI 的话**，先看下面的 ADB 调试设置，否则什么都跑不起来。

---

准备工作：开启 ADB 调试（以红米 / Redmi 为例）

Redmi / Xiaomi（MIUI / HyperOS）需要做三件事：**开发者选项 + USB 调试 + USB 调试（安全设置）**。少了「安全设置」那个，本项目的 `tap` / `swipe` / `input` 都会被拒。

1. 解锁开发者选项

• 设置 → 我的设备 → 全部参数与信息 → 连续点击 "OS 版本"（HyperOS）或 "MIUI 版本"（旧版 MIUI）7 次
• 出现「您已处于开发者模式」提示即解锁

2. 打开 USB 调试

• 设置 → 更多设置 → 开发者选项
• 打开 「USB 调试」
• 打开 「USB 调试（安全设置）」 ← 这一项很多教程不提，但这是 Redmi/MIUI 特有的开关，不开就不能执行 input tap 等模拟操作。打开时手机会弹窗要求登录小米账号
• 推荐打开 「停用 adb 授权超时」，否则隔几天要重新授权一次

3. 连接电脑、授权 RSA 指纹

adb devices
# 第一次会列出设备但 state 是 unauthorized

手机上会弹窗「允许调试」提示，勾选「始终允许」，确定。

adb devices
# 现在:     device

4. 验证

mobilecli devices
mobilecli doctor
mobilecli screenshot -o /tmp/test.png
ls -la /tmp/test.png

5. （可选但推荐）安装 ADBKeyboard 以支持中文输入

ADB 自带的 `input text` 不支持中文。装一个开源 IME 让 `mobilecli type "学到了"` 能用：

# 从