Agent Browser 技能（核心）

目的

提供一套先进、可投入生产的操作手册，用于通过 CLI 和结构化命令，借助 agent-browser 自动化 Web 任务。

适用场景

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

不适用场景

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

快速入门指引

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

必需输入

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

预期输出

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

运行注意事项

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

安全模式默认行为

• 未经明确授权，禁止使用 eval、--allow-file-access、自定义 --executable-path 或任意 --args 参数。
• 除非任务明确要求，否则避免使用 network route、set credentials，以及对 Cookie / 存储的修改操作。
• 仅允许访问白名单内的域名；默认屏蔽 localhost 及私有网络（private network）目标地址。

安全注意事项

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