agent_admin/docs/agent/references.md

能力边界与参考文档

返回文档中心 · 动作目录

1. 不迁移的浏览器专属动作

以下能力依赖浏览器 DOM、JavaScript 或 Chrome DevTools Protocol，不适合作为原生 Android Agent 的通用动作：

• CSS 选择器、浏览器 XPath、iframe 和 Shadow DOM 切换。
• JavaScript Evaluate、修改 DOM 属性、注入脚本。
• 等待网络空闲、拦截请求、Cookie、下载、上传文件控件。
• 生成 PDF、浏览器标签页和弹窗事件。
• Hover、鼠标右键和多次鼠标点击。

若目标 App 内嵌 WebView 且确实需要这些能力，应在独立 WebView 适配器中实现，不能让核心执行器依赖浏览器语义。

2. 参考文档

Android 侧（规范性）：

• Android AccessibilityService：https://developer.android.com/reference/android/accessibilityservice/AccessibilityService
• Android AccessibilityService.takeScreenshot：https://developer.android.com/reference/android/accessibilityservice/AccessibilityService#takeScreenshot(int,%20java.util.concurrent.Executor,%20android.accessibilityservice.AccessibilityService.TakeScreenshotCallback)
• Android AccessibilityServiceInfo 截图能力：https://developer.android.com/reference/android/accessibilityservice/AccessibilityServiceInfo#CAPABILITY_CAN_TAKE_SCREENSHOT
• Android canTakeScreenshot 属性：https://developer.android.com/reference/android/R.attr#canTakeScreenshot
• Android AccessibilityNodeInfo：https://developer.android.com/reference/android/view/accessibility/AccessibilityNodeInfo
• Android Intent 与 FLAG_ACTIVITY_NEW_TASK：https://developer.android.com/reference/android/content/Intent#FLAG_ACTIVITY_NEW_TASK
• Android PackageManager 启动入口：https://developer.android.com/reference/android/content/pm/PackageManager#getLaunchIntentForPackage(java.lang.String)
• Android 后台 Activity 启动限制：https://developer.android.com/guide/components/activities/secure-bal

浏览器自动化（仅作动作命名与参数形态的横向参考，语义不适用于本协议，见本文件的不迁移能力）：

• chromedp 包文档：https://pkg.go.dev/github.com/chromedp/chromedp
• chromedp 官方仓库：https://github.com/chromedp/chromedp
• chromedp 官方示例：https://github.com/chromedp/examples
• Rod 官方包文档：https://pkg.go.dev/github.com/go-rod/rod
• Rod 官方仓库：https://github.com/go-rod/rod
• Rod 输入动作说明：https://github.com/go-rod/go-rod.github.io/blob/main/input.md