SMA AutoUI
智能移动自动化 UI 框架 —— 面向社交媒体平台的 Android 设备自动化，融合 ADB 直达、视觉识别与 LLM 认知自愈能力。
📦 PyPI：https://pypi.org/project/sma-autoui/
🚀 快速开始
# 从 PyPI 安装
pip install sma-autoui
# 或从源码安装
pip install .
🌟 核心特性
| 特性 | 说明 |
|---|---|
| ✅ 多平台适配 | 多个社交平台业务抽象（TikTok / 小红书 / 微博 等） |
| ✅ Session 复用 | 跨任务会话持久化与保活架构 |
| ✅ 视觉匹配 | SIFT 特征 + 模板匹配 + OCR 多模式识别 |
| ✅ ADB 直达 | 困难页面（直播间 / SurfaceView）直接注入事件，绕开 W3C 限制 |
| ✅ AI 驱动 | LLM 接口封装 + 认知工作流（Flow）编排 |
| ✅ 自愈能力 | UI 异常自动诊断与恢复，规则评分反馈闭环 |
完整项目结构与各层模块职责，详见 🏗️ 系统架构。
📖 文档
全部文档位于 docs/ 目录。
| 文档 | 描述 | 目标读者 |
|---|---|---|
| 🛠️ appium-setup-guide.md | Appium + ADB 完整环境搭建与验证 | 新成员、运维 |
| 🏗️ architecture.md | 系统架构、模块职责与依赖关系 | 开发者、架构师 |
| 💡 click-mechanisms.md | ADB / Appium / W3C Actions 三种点击机制差异与选型 | 开发者 |
| 📋 scrcpy-server-guide.md | scrcpy-server 服务启动 / 剪贴板获取 / 控制协议中文指南 | 开发者 |
| ⚠️ pitfalls.md | 项目开发中的常见问题与解决方案 | 开发者 |
| 🛣️ roadmap.md | 六层架构实现路径与未来规划 | 管理者、开发者 |
快速导航
- 新入门 → 先 🛠️ 环境搭建，再 🏗️ 架构概览
- 点击机制选型 → 💡 点击机制详解
- scrcpy 剪贴板 / 控制 → 📋 scrcpy-server 指南
- 遇到问题 → ⚠️ 常见坑点
- 未来规划 → 🛣️ 开发路线图
💻 使用示例
from sma_autoui.driver import Driver, Device
# 1. 初始化设备
device = Device(device_name="172.25.2.20:5555", adb_port=5002)
# 2. 创建驱动实例
driver = Driver(
device=device,
appium_url="http://localhost:4723/wd/hub",
task_name="example_task"
)
# 3. 使用高级 API
driver.smart_find(locators=[...], timeout=10)
driver.tap_by_adb(x=500, y=800)
# 4. 任务自动重试与保活由 TaskRunner 处理
🔧 从源码安装
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
1 maintainer
Metadata
1 maintainer
Release files for sma-autoui 0.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sma_autoui-0.5.0.tar.gz | 3.3 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sma_autoui-0.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 6.6 MB
Release files / sma_autoui-0.5.0.tar.gz
| Download URL | sma_autoui-0.5.0.tar.gz |
|---|---|
| Size | 3.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
738bb2864ce0db8ac5cfe7df7df1c0fcb8b9896946373a6c96b6da50bd6c5b1e
|
|
BLAKE2b-256 checksum How to use checksums |
1e222e2612fa74fbb819218ffa6ce013fef175cc824d073dea8ab68f4ffaab34
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.9
|
Release files / sma_autoui-0.5.0-py3-none-any.whl
| Download URL | sma_autoui-0.5.0-py3-none-any.whl |
|---|---|
| Size | 3.3 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c9c59c537e56da01a3c6c1ba3d173221666f74fd2d11aea6188153b4cbac6ccd
|
|
BLAKE2b-256 checksum How to use checksums |
87566be1a98e0c876606d4e7a05657a8cd2c80105e4853dc610ac6e52a9e57b9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.9
|
