wechat-android-shortcutslisted

# 微信 Android 桌面快捷方式 ## 定位 本 Skill 只负责 Android 真机上的微信桌面快捷方式自动化： ```text 公众号 / 小程序名称 → ADB 控制 Android 真机 → 微信搜索 → OCR 识别候选与按钮 → 进入公众号 / 小程序 → 微信官方“添加到桌面” → 可选验证桌面图标与 Chat_User ``` 浏览器 Edge / Chrome 书签不属于本 Skill；需要 `bookmarks.html` 时使用 `wechat-account-bookmarks`。 ## 核心原则 - 只走微信官方“添加到桌面”入口，不直接写 Launcher 或微信数据库。 - 不伪造 `ShortcutInfo`、`shortcut_id`、`Chat_User` 映射。 - 模糊匹配只用于找候选；进入资料页后必须二次核对身份。 - 公众号优先于视频号，小程序优先级最低但可尝试专用添加流程。 - 微信内部 `uiautomator dump` 可能为空，因此主要用截图 + OCR，而不是依赖 UI XML。 - 找不到入口、身份无法确认或机型不兼容时跳过并记录，不盲点固定坐标。 ## 环境 ```text macOS Python 3 Swift（系统自带，用于 Vision OCR） Android Platform Tools / adb Android 真机 + USB 调试 微信 App ADBKeyBoard（需要稳定中文输入时） ``` 运行前确认设备： ```bash adb devices -l ``` 如果只连接一台授权设备，入口脚本会自动选择；多台设备时必须显式设置： ```bash ANDROID_SERIAL=<serial> python3 scripts/batch_add_wechat.py 公众号1 公众号2 ``` 也可覆盖 ADB 或 OCR 路径： ```bash ADB_PATH=/path/to/adb \ ANDROID_SERIAL=<serial> \ OCR_SCRIPT=/path/to/ocr_wechat.swift \ python3 scripts/batch_add_wechat.py 公众号1 公众号2 ``` ## 批量添加 ```bash python3 scripts/batch_add_wechat.py 公众号1 公众号2 公众号3 ``` 入口脚本负责提供可移植的 ADB / OCR 默认值，再调用现有批量实现。 批量流程大致为： ```text 进入微信搜索 → 输入名称 → 进入“账号”结果 → 按公众号 / 服务号 / 媒体 / 视频号 / 小程序优先级找候选 → 资料页二次核验 → 如未关注则关注 → 公众号：••• → 设置 → 添加到桌面 → 小程序：••• → 转发给朋友所在横向菜单 → 添加到桌面 → 继续下一个 ``` ## OCR ```bash adb exec-out screencap -p > /tmp/screen.png swift scripts/ocr_wechat.swift /tmp/screen.png ``` OCR 输出为： ```text x,y widthxheight<TAB>识别文本 ``` 按钮坐标必须以实时 OCR 为主。脚本中的少量固定坐标只是 OCR 找不到时的兼容兜底，不应视为跨设备稳定契约。 ## 检查快捷方式 点击桌