Files
agent_admin/docs/agent/references.md
T

39 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 能力边界与参考文档
> [返回文档中心](README.md) · [动作目录](actions/README.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
浏览器自动化(仅作动作命名与参数形态的横向参考,语义不适用于本协议,见本文件的[不迁移能力](#1-不迁移的浏览器专属动作)):
- 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