SuperAPI AI 工具集

vmos-edge-control-api

通用与其它

查看项目

更新于 10-16 09:33

技能介绍

用途:在需要通过 VMOS Edge Android Control API 控制单台安卓云机时使用本技能。MCP 是可选通道,不是前置依赖。

连接入口:用户已给 host_ip 或 cloud_ip 时优先采用;未给 IP 时先检查本地是否存在 cbs_go(如 pgrep -x cbs_go >/dev/null 2>&1),存在则默认 host_ip=127.0.0.1,否则引导用户提供 host_ip、cloud_ip 或 db_id。若同时安装 vmos-edge-container-api,走宿主机路由 http://{host_ip}:18182/android_api/v2/{db_id},需先经 container API 的 POST /container_api/v1/get_db 或 GET /container_api/v1/get_android_detail/{db_id} 获取 db_id。仅安装本技能时默认云机直连 http://{cloud_ip}:18185/api,仅支持开启局域网模式的云机;直连 /base/version_info 超时或返回 5xx,说明未暴露 Control API 或未开局域网模式。仅本技能且需走 host_ip 时,有 db_id 用 http://{host_ip}:18182/android_api/v2/{db_id},无则说明缺少 db_id 或 container-api。

核心流程:遵循 Observe -> Plan -> Act -> Verify。首次连接先查 /base/version_info,成功即视为支持。用 /base/list_action 做能力发现,需要细节再按 paths 带 detail 查询。观察优先级为截图接口、/accessibility/dump_compact、/accessibility/node 无动作查询、/display/info、/activity/top_activity、/package/list。截图回显先用 curl -o 落盘到 workspace,再用 read 读取;不要写 MEDIA: 或贴 base64/data_url。交互上结构化定位优先 /accessibility/node,点击滑动优先 /input/click、/input/swipe、/input/scroll_bezier,输入优先 /input/text,启动应用优先 /activity/start,浏览器优先 /activity/start_activity(包名优先 mark.via,其次 com.android.chrome),安装优先 /package/install_sync 或 /package/install_uri_sync,设置读写优先 /system/settings_get、/system/settings_put,无专用接口才用 /system/shell,每步后重新观察。

参考与限制:先看 references/api-reference.md 索引,按需打开模块文件;安装第三方应用看 references/app-installation.md,浏览器搜索阅读看 references/browser-search-and-reading.md。删除应用、清数据、改系统设置/权限、shell 操作前需确认用户意图;无明确要求不改时区、语言、国家、Google 状态、设备信息、定位或传感器。