介绍
# Agent Browser Skill (Core)
## 目的 提供一份高级的、可用于生产的操作手册，用于通过 CLI 和结构化命令使用 agent-browser 自动化 Web 任务。
## 最佳适用场景 - 您需要针对 AI 代理的确定性自动化。 - 您需要包含引用和 JSON 输出的紧凑快照。 - 您更喜欢带有 Node.js 回退机制的快速 CLI。
## 不适用场景 - 您需要完整的 SDK 或自定义 JS 集成。 - 您必须传输大文件上传或复杂的媒体工作流。
## 快速入门指南 - 阅读 `references/agent-browser-overview.md` 了解安装、架构和核心概念。 - 阅读 `references/agent-browser-command-map.md` 了解命令类别和标志。 - 阅读 `references/agent-browser-safety.md` 了解高风险控制和安全模式规则。 - 阅读 `references/agent-browser-workflows.md` 了解推荐的 AI 工作流。 - 阅读 `references/agent-browser-troubleshooting.md` 了解常见问题和修复方法。
## 必需输入 - 已安装的 agent-browser CLI 和浏览器运行时。 - 目标 URL 和工作流步骤。 - 如果需要身份验证，则需会话或配置文件策略。
## 预期输出 - 清晰的命令序列和自动化的操作护栏。
## 操作说明 - 尽早创建快照，通过引用执行操作，然后在 DOM 更改后再次创建快照。 - 使用 `--json` 进行机器解析和脚本编写。 - 在操作前使用等待和加载状态检查。 - 完成后关闭选项卡或会话以释放资源。
## 安全模式默认设置 - 未经明确批准，请勿使用 `eval`、`--allow-file-access`、自定义 `--executable-path` 或任意的 `--args`。 - 除非任务需要，否则避免使用 `network route`、`set credentials` 以及 Cookie/存储变更。 - 将域名列入白名单，并阻止 localhost 或私有网络目标。
## 安全注意事项 - 将令牌和凭据视为机密信息。 - 除非明确要求，否则避免使用 `--allow-file-access`。