前言¶
要在雲手機或遠程 Android 上跑自動化，常見做法是本地寫 Appium、Maestro 腳本，或自己拼 adb shell input 與截圖拉取。設備在機房、界面在雲端時，Agent 往往缺少一套「可複述、可校驗」的操作約定。
下面介紹的 duoplus-agent 是 SkillHub 上的社區 Skill（座標 @user_1df07c13/duoplus-agent，分類 ai-agent）。它把點擊、滑動、輸入、截圖與 UI 層級分析整理成固定工作流，底層通過 ADB 廣播把 JSON 指令交給設備上的 DuoPlus CloudPhone 服務執行。頁面標註 requires_api_key=false，不依賴額外 API Key。
這是什麼¶
duoplus-agent（展示名 DuoPlus CloudPhone Agent）由社區用戶 user_1df07c13 發佈，當前 SkillHub 頁面版本爲 v1.0.0，來源爲 community。
一句話定位：在已安裝 adb、且目標設備運行 DuoPlus CloudPhone 相關係統服務 的前提下，讓編碼 Agent 按 Skill 文檔連接設備、下發操作、用截圖或 uiautomator 做校驗。
官方 Skill 頁與 API 入口：
- 展示頁：https://www.skillhub.cn/skills/user_1df07c13/duoplus-agent
- API：https://api.skillhub.cn/user_1df07c13/duoplus-agent
核心功能¶
以下能力均來自 Skill 包內 SKILL.md 與輔助腳本 scripts/send_command.sh 的說明。
設備連接¶
無線連接後，後續命令用 -s <DEVICE_ID> 指定設備：
adb connect <IP>:<PORT>
adb devices -l
通過 JSON 動作控制界面¶
Skill 提供 scripts/send_command.sh，將 action_name 與 params 封裝爲完整 payload，Base64 編碼後發送廣播：
adb -s <DEVICE_ID> shell am broadcast -a com.duoplus.service.PROCESS_DATA --es message "<BASE64>"
文檔中列出的動作包括但不限於：
| 類型 | action_name 示例 |
說明 |
|---|---|---|
| 啓動應用 | OPEN_APP |
需 package_name |
| 點擊 | CLICK_COORDINATE、CLICK_ELEMENT |
座標或按文本等元素屬性匹配 |
| 手勢 | LONG_COORDINATE、DOUBLE_TAP_COORDINATE、SLIDE_PAGE |
含方向與起止座標 |
| 輸入 | INPUT_CONTENT、KEYBOARD_OPERATION |
輸入前需先聚焦輸入框；支持 enter/delete 等鍵 |
| 導航 | GO_TO_HOME、PAGE_BACK |
系統級返回與桌面 |
| 等待 | WAIT_TIME、WAIT_FOR_SELECTOR |
固定延時或等待元素出現 |
| 結束 | END_TASK |
文檔建議在卡住時使用 |
文檔強調：動作類命令爲 fire-and-forget，不返回執行結果，應在每步操作後用截圖或 UI dump 驗證。
UI 分析與截圖¶
- 層級：
uiautomator dump拉取view.xml，按文本或resource-id查bounds定位元素。 - 視覺：
screencap拉取 PNG，可選cwebp壓縮爲 WebP 再交給視覺模型分析。
Skill 元數據要求本機具備 adb 與 cwebp（無 cwebp 時可直接使用 PNG）。
推薦循環¶
文檔給出的典型循環爲：分析 UI → send_command.sh 執行 → 本地 sleep 1–3 秒 → 截圖或再次 dump → 重複直至完成。
座標系爲 0–1000 相對座標（非像素）；滑動時建議使用非整數的起止座標。
安裝與啓用¶
1. 安裝 SkillHub CLI（若尚未安裝）¶
按 https://skillhub.cn/install/skillhub.md 檢查並安裝：
command -v skillhub && skillhub --version
未安裝時可執行：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安裝 duoplus-agent¶
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別：
skillhub install @user_1df07c13/duoplus-agent --dir <你的 skills 目錄>
常見路徑（同官方安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
也可按 SkillHub 頁面提示，讓 Agent 閱讀 https://skillhub.cn/install/skillhub.md 後安裝 @user_1df07c13/duoplus-agent。
Skill 包內 README 另寫了 ClawHub 座標 duoplus/duoplus-agent 與本地複製到 OpenClaw skills 目錄的方式；若你使用 OpenClaw 系客戶端，可按 README 選用。
安裝後需重啓或刷新 Agent，使其加載新 Skill。
典型用法¶
下列示例路徑相對於 Skill 安裝目錄，與官方 SKILL.md 一致。
啓動微信（示例包名）：
scripts/send_command.sh <DEVICE_ID> '{"action_name":"OPEN_APP","params":{"package_name":"com.tencent.mm"}}'
按文本點擊「Login」：
scripts/send_command.sh <DEVICE_ID> '{"action_name":"CLICK_ELEMENT","params":{"text":"Login"}}'
輸入前先聚焦，再清空並輸入：
scripts/send_command.sh <DEVICE_ID> '{"action_name":"CLICK_ELEMENT","params":{"text":"用戶名"}}'
scripts/send_command.sh <DEVICE_ID> '{"action_name":"INPUT_CONTENT","params":{"content":"Hello","clear_first":true}}'
scripts/send_command.sh <DEVICE_ID> '{"action_name":"KEYBOARD_OPERATION","params":{"key":"enter"}}'
拉取 UI 層級定位元素：
adb -s <DEVICE_ID> shell uiautomator dump /sdcard/view.xml && adb -s <DEVICE_ID> pull /sdcard/view.xml ./view.xml
截圖並可選壓縮：
adb -s <DEVICE_ID> shell screencap -p /sdcard/screen.png
adb -s <DEVICE_ID> pull /sdcard/screen.png ./screen.png
cwebp -q 60 -resize 540 0 ./screen.png -o ./screen.webp
對 Agent 的自然語言任務（Skill README 中的示例）可以是：「連接 192.168.1.100:5555 並打開微信」「在設備上截取當前屏幕」「點擊 Login 按鈕」。Agent 應按 Skill 約束選擇上述腳本與 ADB 命令，而不是臆造未文檔化的接口。
適用場景與注意¶
適合誰
- 已使用或計劃使用 DuoPlus 雲手機，希望把「點按、滑動、填表、截圖驗收」交給 Cursor / Claude Code / Codex 等 Agent 編排的場景。
- 能接受 逐步截圖或 dump 驗證 的自動化（因廣播命令不返回執行結果）。
限制與前提
- 設備端須運行 DuoPlus 相關服務；廣播 Action 爲
com.duoplus.service.PROCESS_DATA。 - 依賴本機 adb 可達目標
DEVICE_ID；無線場景需先adb connect。 - Skill 面向 Agent 的操作說明，不是獨立 SaaS；雲手機賬號、實例與網絡由 DuoPlus 側自行開通與維護。
- 社區來源 Skill，接入生產前建議在隔離實例上試跑完整流程。
SkillHub 當前統計（以抓取資料爲準）：評分 100000，下載 2711，安裝 33。
結尾¶
duoplus-agent 把 DuoPlus 雲手機的操控收斂爲「ADB 連接 + send_command.sh JSON 動作 + 截圖/UI dump 校驗」的固定套路，便於 Agent 在對話中復現步驟。若你要在 Agent 裏控制 DuoPlus 雲手機，可從官方 Skill 頁安裝並閱讀包內 SKILL.md：
https://www.skillhub.cn/skills/user_1df07c13/duoplus-agent
