Agent Browser 技能（核心）

目的

提供一套先进、可用于生产环境的运行手册，指导如何通过 CLI 和结构化命令使用 agent-browser 自动化网页任务。

适用场景

• 你需要为 AI agent 实现可确定性（deterministic）的自动化。
• 你希望获取包含引用（refs）和 JSON 输出的紧凑快照（snapshot）。
• 你倾向使用响应迅速的 CLI 工具，并以 Node.js 作为后备方案。

不适用场景

• 你需要完整的 SDK 或自定义 JavaScript 集成。
• 你必须流式上传大文件或处理复杂的媒体工作流。

快速入门指引

• 阅读 references/agent-browser-overview.md，了解安装方法、架构设计及核心概念。
• 阅读 references/agent-browser-command-map.md，了解命令分类与可用参数标志（flags）。
• 阅读 references/agent-browser-safety.md，了解高风险操作控制机制与安全模式（safe mode）规则。
• 阅读 references/agent-browser-workflows.md，了解推荐的 AI 工作流实践。
• 阅读 references/agent-browser-troubleshooting.md，了解常见问题及修复方法。

必需输入

• 已安装的 agent-browser CLI 及浏览器运行时（browser runtime）。
• 目标 URL 及待执行的工作流步骤。
• 如需身份验证，应制定会话（session）或用户配置文件（profile）策略。

预期输出

• 一套清晰的命令执行序列，以及保障自动化稳定运行的操作约束（operational guardrails）。

操作注意事项

• 在 DOM 变更前先拍摄快照；通过 refs 执行操作；DOM 更新后再拍摄一次快照。
• 使用 --json 参数以支持机器解析与脚本调用。
• 在执行操作前，应加入等待机制（waits）并检查页面加载状态（load-state）。
• 任务完成后及时关闭标签页或会话，以释放系统资源。

安全模式默认设置

• 未经明确授权，不得使用 eval、--allow-file-access、自定义 --executable-path 或任意 --args 参数。
• 除非任务明确要求，否则应避免使用 network route、set credentials，以及对 Cookie / 存储（storage）的修改操作。
• 应显式配置域名白名单，并禁止访问 localhost 或私有网络（private network）中的目标地址。

安全注意事项

• 将所有 token 与凭据（credentials）视为敏感信息（secrets）进行管理。
• 除非明确必需，否则应避免使用 --allow-file-access 参数。