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.3
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.3.tar.gz | 3.3 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sma_autoui-0.5.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 6.6 MB
Release files / sma_autoui-0.5.3.tar.gz
| Download URL | sma_autoui-0.5.3.tar.gz |
|---|---|
| Size | 3.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8079e0005a5ee4970fb67045e9297d4cb9fba8b5caf357073f5306f87263d202
|
|
BLAKE2b-256 checksum How to use checksums |
38648475d853f923d704b5c2597d6bc59c198091b763343ede5463cc61583045
|
| 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.3-py3-none-any.whl
| Download URL | sma_autoui-0.5.3-py3-none-any.whl |
|---|---|
| Size | 3.3 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1e1008ebc41451f9ed6225f08500f467c303eb4d09b12e05be56325dea6c500d
|
|
BLAKE2b-256 checksum How to use checksums |
a4af08f13aacd198e91e1084ee25ac66d8a6fcdf02af144a9ee87197ad0006da
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.9
|
