mumdad 0.1.5__tar.gz

mumdad-0.1.5/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: mumdad
+Version: 0.1.5
+Summary: Multi-platform disguise automation — ADB gesture disguise & WeChat scroll navigation
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: numpy>=1.24
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+
+# mumdad — Multi-platform disguise automation
+
+Android / iOS / HarmonyOS / Web disguise automation toolkit. Built for mobile APP data collection with anti-detection gestures and device-adaptive scroll navigation.
+
+[![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+
+---
+
+## 一、项目介绍
+
+mumdad 是一个多平台自动化伪装工具包，核心解决移动端 APP 自动化采集中的防风控和手势兼容性问题。
+
+### 核心模块
+
+| 模块 | 说明 |
+|------|------|
+| `adb` | ADB 伪装客户端 + scroll_down/up 手势翻页（Android 版本自适应） |
+| `wechat` | 微信主界面会话列表归位（from×L 随机采样 + dHash 重试 + 冷启动兜底） |
+
+---
+
+## 二、安装
+
+```bash
+pip install mumdad
+```
+
+或从 GitHub：
+
+```bash
+pip install git+https://github.com/yuyidream/mumdad.git
+```
+
+---
+
+## 三、核心特性
+
+### 3.1 DisguiseAdbClient — ADB 伪装客户端
+
+自动注入人类操作模拟，防止 APP 风控检测：
+
+- **随机延迟**：每次操作前注入 80~350ms 随机 sleep
+- **坐标微偏移**：tap 坐标 ±5px 随机 jitter
+- **duration 随机化**：swipe 时长 + 0~80ms 随机
+- **key_event 专门延迟**：BACK/HOME 键注入 80~200ms 专用延迟
+
+```python
+from mum.android.base.adb import DisguiseAdbClient
+
+adb = DisguiseAdbClient("device_serial")
+adb.click(540, 1200)  # 自动注入延迟 + jitter
+adb.swipe(540, 2000, 540, 500, duration_ms=400)  # duration 自动加 0~80ms
+```
+
+### 3.2 session_list_content_scroll_down/up — 会话列表手势翻页
+
+基于 from×L 模型，Android 版本自适应：
+
+| Android 版本 | L 参数 | 适用设备 |
+|---|---|---|
+| < 13 | [66%, 68%] | D1 (MI 8 UD, Android 10) |
+| ≥ 13 | [51%, 53%] | D2 (HyperOS 16) / D3 (Harmony 13) |
+
+关键约束：velocity ≤ 1.0 px/ms（防 Android fling 惯性）。
+
+```python
+from mum.android.base.adb import session_list_content_scroll_down, session_list_content_scroll_up
+
+adb = DisguiseAdbClient("device_serial")
+w, h = adb.wm_size()
+
+# 翻下一页
+session_list_content_scroll_down(adb, screen_w=w, screen_h=h)
+
+# 回翻上一页
+session_list_content_scroll_up(adb, screen_w=w, screen_h=h)
+```
+
+### 3.3 reposition_wechat_to_list_top — 微信会话列表归位
+
+从任意 WeChat 状态归位到主界面会话列表最顶端。
+
+**两阶段流程**：
+1. **导航**：截图 → 层级检测 → 导航到 L1 chat_list (A/B/C)
+2. **无限下拉锚点**：from×L 随机采样，不限次数一直下拉直到出现「最近」页面或 deadline_s 到期。期间连续 2 帧 dHash Hamming ≤ 3 且不在「最近」页面时，触发 `back_recover()` 冷启动恢复后继续。
+
+```python
+from mum.android.wechat.reposition import reposition_wechat_to_list_top
+
+result = reposition_wechat_to_list_top(
+    adb, scale_w=1.0, screen_w=1080, screen_h=2248,
+    deadline_s=60.0,
+)
+print(f"归位: {'OK' if result.ok else 'FAIL'} ({result.reason})")
+```
+
+---
+
+## 四、目录结构
+
+```
+mumdad/
+├── android/
+│   ├── adb/                      ← ADB 伪装 + scroll_down/up
+│   │   ├── coordinate.py         ← 坐标 jitter (±5px)
+│   │   ├── random_delay.py       ← 随机延迟 (80~350ms)
+│   │   ├── disguise_client.py    ← DisguiseAdbClient + Debug
+│   │   ├── scroll.py             ← session_list_content_scroll_down/up
+│   │   └── _raw_adb.py           ← 原生 ADB 包装器
+│   └── wechat/
+│       └── reposition.py         ← 微信会话列表归位
+├── docs/
+│   └── adr/
+│       └── disguise_android_feasibility.md  ← 技术可行性评估
+├── harmonyos/                    ← 占位
+├── ios/                          ← 占位
+├── web/                          ← 占位
+├── pyproject.toml
+├── README.md
+└── LICENSE
+```
+
+---
+
+## 五、设备验证
+
+| 设备 | Android | 分辨率 | 微信版本 | 验证结果 |
+|------|---------|--------|----------|----------|
+| D1 (MI 8 UD) | 10 | 1080×2248 | 8.0.71 | ✅ 10 轮 100% |
+| D2 (25113PN0EC) | 16 | 1220×2656 | 8.0.71 | ✅ 10 轮 100% |
+| D3 (WDY-AN00) | 13 | 720×1612 | 8.0.72 | ✅ 10 轮 100% |
+
+---
+
+## 六、相关文档
+
+- [技术可行性评估报告](docs/adr/disguise_android_feasibility.md) — 贝塞尔曲线拒绝、DisguiseAdbClient、手势参数标定
+- [layernav_android](https://github.com/yuyidream/layernav_android) — 页面层级导航框架（本项目的冷启动依赖）

mumdad-0.1.5/README.md

@@ -0,0 +1,138 @@
+# mumdad — Multi-platform disguise automation
+
+Android / iOS / HarmonyOS / Web disguise automation toolkit. Built for mobile APP data collection with anti-detection gestures and device-adaptive scroll navigation.
+
+[![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+
+---
+
+## 一、项目介绍
+
+mumdad 是一个多平台自动化伪装工具包，核心解决移动端 APP 自动化采集中的防风控和手势兼容性问题。
+
+### 核心模块
+
+| 模块 | 说明 |
+|------|------|
+| `adb` | ADB 伪装客户端 + scroll_down/up 手势翻页（Android 版本自适应） |
+| `wechat` | 微信主界面会话列表归位（from×L 随机采样 + dHash 重试 + 冷启动兜底） |
+
+---
+
+## 二、安装
+
+```bash
+pip install mumdad
+```
+
+或从 GitHub：
+
+```bash
+pip install git+https://github.com/yuyidream/mumdad.git
+```
+
+---
+
+## 三、核心特性
+
+### 3.1 DisguiseAdbClient — ADB 伪装客户端
+
+自动注入人类操作模拟，防止 APP 风控检测：
+
+- **随机延迟**：每次操作前注入 80~350ms 随机 sleep
+- **坐标微偏移**：tap 坐标 ±5px 随机 jitter
+- **duration 随机化**：swipe 时长 + 0~80ms 随机
+- **key_event 专门延迟**：BACK/HOME 键注入 80~200ms 专用延迟
+
+```python
+from mum.android.base.adb import DisguiseAdbClient
+
+adb = DisguiseAdbClient("device_serial")
+adb.click(540, 1200)  # 自动注入延迟 + jitter
+adb.swipe(540, 2000, 540, 500, duration_ms=400)  # duration 自动加 0~80ms
+```
+
+### 3.2 session_list_content_scroll_down/up — 会话列表手势翻页
+
+基于 from×L 模型，Android 版本自适应：
+
+| Android 版本 | L 参数 | 适用设备 |
+|---|---|---|
+| < 13 | [66%, 68%] | D1 (MI 8 UD, Android 10) |
+| ≥ 13 | [51%, 53%] | D2 (HyperOS 16) / D3 (Harmony 13) |
+
+关键约束：velocity ≤ 1.0 px/ms（防 Android fling 惯性）。
+
+```python
+from mum.android.base.adb import session_list_content_scroll_down, session_list_content_scroll_up
+
+adb = DisguiseAdbClient("device_serial")
+w, h = adb.wm_size()
+
+# 翻下一页
+session_list_content_scroll_down(adb, screen_w=w, screen_h=h)
+
+# 回翻上一页
+session_list_content_scroll_up(adb, screen_w=w, screen_h=h)
+```
+
+### 3.3 reposition_wechat_to_list_top — 微信会话列表归位
+
+从任意 WeChat 状态归位到主界面会话列表最顶端。
+
+**两阶段流程**：
+1. **导航**：截图 → 层级检测 → 导航到 L1 chat_list (A/B/C)
+2. **无限下拉锚点**：from×L 随机采样，不限次数一直下拉直到出现「最近」页面或 deadline_s 到期。期间连续 2 帧 dHash Hamming ≤ 3 且不在「最近」页面时，触发 `back_recover()` 冷启动恢复后继续。
+
+```python
+from mum.android.wechat.reposition import reposition_wechat_to_list_top
+
+result = reposition_wechat_to_list_top(
+    adb, scale_w=1.0, screen_w=1080, screen_h=2248,
+    deadline_s=60.0,
+)
+print(f"归位: {'OK' if result.ok else 'FAIL'} ({result.reason})")
+```
+
+---
+
+## 四、目录结构
+
+```
+mumdad/
+├── android/
+│   ├── adb/                      ← ADB 伪装 + scroll_down/up
+│   │   ├── coordinate.py         ← 坐标 jitter (±5px)
+│   │   ├── random_delay.py       ← 随机延迟 (80~350ms)
+│   │   ├── disguise_client.py    ← DisguiseAdbClient + Debug
+│   │   ├── scroll.py             ← session_list_content_scroll_down/up
+│   │   └── _raw_adb.py           ← 原生 ADB 包装器
+│   └── wechat/
+│       └── reposition.py         ← 微信会话列表归位
+├── docs/
+│   └── adr/
+│       └── disguise_android_feasibility.md  ← 技术可行性评估
+├── harmonyos/                    ← 占位
+├── ios/                          ← 占位
+├── web/                          ← 占位
+├── pyproject.toml
+├── README.md
+└── LICENSE
+```
+
+---
+
+## 五、设备验证
+
+| 设备 | Android | 分辨率 | 微信版本 | 验证结果 |
+|------|---------|--------|----------|----------|
+| D1 (MI 8 UD) | 10 | 1080×2248 | 8.0.71 | ✅ 10 轮 100% |
+| D2 (25113PN0EC) | 16 | 1220×2656 | 8.0.71 | ✅ 10 轮 100% |
+| D3 (WDY-AN00) | 13 | 720×1612 | 8.0.72 | ✅ 10 轮 100% |
+
+---
+
+## 六、相关文档
+
+- [技术可行性评估报告](docs/adr/disguise_android_feasibility.md) — 贝塞尔曲线拒绝、DisguiseAdbClient、手势参数标定
+- [layernav_android](https://github.com/yuyidream/layernav_android) — 页面层级导航框架（本项目的冷启动依赖）

mumdad-0.1.5/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mumdad"
+version = "0.1.5"
+description = "Multi-platform disguise automation — ADB gesture disguise & WeChat scroll navigation"
+requires-python = ">=3.10"
+readme = "README.md"
+
+dependencies = [
+    "numpy>=1.24",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]

mumdad-0.1.5/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

mumdad-0.1.5/src/mum/__init__.py

@@ -0,0 +1,8 @@
+"""mum — Multi-platform disguise automation toolkit.
+
+- ADB gesture disguise (``DisguiseAdbClient``, ``DisguiseAdbClientDebug``)
+- WeChat session list scroll navigation (from×L model, device-adaptive)
+- Duration randomization (0~80ms) for anti-detection
+"""
+
+__version__ = "0.1.0"

mumdad-0.1.5/src/mum/android/base/adb/__init__.py

@@ -0,0 +1,53 @@
+"""mum ADB 伪装模块 — 统一对外导出。
+
+- ``DisguiseAdbClient``（生产）：自动注入随机延迟 + 坐标偏移 + duration 随机化
+- ``DisguiseAdbClientDebug``（调试）：跳过所有伪装，直接走原生 ADB
+- ``scroll_down_base`` / ``scroll_up_base``：会话列表手势翻页
+- ``scroll_up_reposition``：归位专用下拉
+- ``scroll_down_note``：笔记详情页上滑
+"""
+
+from __future__ import annotations
+
+from mum.android.base.adb.disguise_client import (
+    DisguiseAdbClient,
+    DisguiseAdbClientDebug,
+)
+from mum.android.base.adb._raw_adb import (
+    LOCKED_ADB_VERSION,
+    AdbClient,
+    AdbError,
+    AdbResult,
+    KEYCODE_BACK,
+    KEYCODE_HOME,
+)
+from mum.android.base.adb.scroll import (
+    scroll_down_base,
+    scroll_down_note,
+    scroll_up_base,
+    scroll_up_reposition,
+)
+
+# 向后兼容别名
+session_list_content_scroll_down = scroll_down_base
+session_list_content_scroll_up   = scroll_up_base
+
+RiskAdbClient = DisguiseAdbClient
+
+__all__ = [
+    "LOCKED_ADB_VERSION",
+    "AdbClient",
+    "AdbError",
+    "AdbResult",
+    "KEYCODE_BACK",
+    "KEYCODE_HOME",
+    "DisguiseAdbClient",
+    "DisguiseAdbClientDebug",
+    "RiskAdbClient",
+    "scroll_down_base",
+    "scroll_down_note",
+    "scroll_up_base",
+    "scroll_up_reposition",
+    "session_list_content_scroll_down",
+    "session_list_content_scroll_up",
+]

mumdad-0.1.5/src/mum/android/base/adb/_protocol.py

@@ -0,0 +1,20 @@
+"""Minimal ADB interface for duck-typing compatibility.
+
+``DisguiseAdbClient`` satisfies this protocol, as does any object with
+``swipe()`` and ``_run()`` methods.
+"""
+
+from __future__ import annotations
+
+from typing import Protocol
+
+
+class AdbProtocol(Protocol):
+    """Minimal ADB interface for scroll gesture functions.
+
+    Compatible with ``layernav_android._protocol.AdbProtocol``.
+    """
+    def swipe(
+        self, x1: int, y1: int, x2: int, y2: int, duration_ms: int = 300,
+    ) -> None: ...
+    def _run(self, args: list[str]) -> str: ...