SMA AutoUI

智能移动自动化 UI 框架 —— 面向社交媒体平台的 Android 设备自动化，融合 ADB 直达、视觉识别与 LLM 认知自愈能力。

📦 PyPI：https://pypi.org/project/sma-autoui/

🚀 快速开始

# 从 PyPI 安装
pip install sma-autoui

# 或从源码安装
pip install .

🌟 核心特性

完整项目结构与各层模块职责，详见 🏗️ 系统架构。

📖 文档

全部文档位于 docs/ 目录。

快速导航

• 新入门 → 先 🛠️ 环境搭建，再 🏗️ 架构概览
• 点击机制选型 → 💡 点击机制详解
• 拟人化 / 反检测 → 🤖 拟人化行为设计
• scrcpy 剪贴板 / 控制 → 📋 scrcpy-server 指南
• 遇到问题 → ⚠️ 常见坑点
• 未来规划 → 🛣️ 开发路线图
• 看版本改了什么 → 📝 变更日志

💻 使用示例

from appium.webdriver.common.appiumby import AppiumBy
from sma_autoui.driver import Device, Driver
from sma_autoui.engine import TaskRunner

# 1. 初始化设备（ADB 连接 + 环境准备）
device = Device(device_name="172.25.2.20:5555", adb_port=5002)
device.initialize_env()

# 2. 创建驱动实例（门面，聚合 actions / locator / inspector / vision / browser）
driver = Driver(
    device=device,
    appium_url="http://localhost:4723",
    job_id="example_job",
    desired_caps={...},
    app_name="xhs",
    app_version="1.0.0",
    task_name="example_task",
)

# 3. 使用高级 API
element = driver.smart_find(
    locators=[(AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().text("Follow")')],
    timeout=10,
    ai_recovery=True,          # 定位失败时触发 AI 诊断自愈
)
driver.tap_by_adb(x=500, y=800, jitter=8)   # ADB 直达 + 坐标抖动
driver.smart_swipe(direction="UP", degree="MIDDLE")

# 4. 任务重试、异常自愈与保活由 TaskRunner 统一处理
TaskRunner(driver=driver).run(task_func=my_flow, task_name="example_task")

🔧 从源码安装

git clone https://github.com/Fun-Fox/sma_autoui.git
cd sma_autoui
pip install -r requirements.txt
pip install -e .

📄 开源协议

MIT License

Built with ❤️ by FunFox