steel-browser

Steel Browser

立即使用 Steel CLI 浏览器工具完成实时网页任务。

设置

如果 Steel 缺失或未通过身份验证：

steel --version
steel login
steel doctor --preflight

如果 CLI 或已安装的技能看起来有问题，请运行：

steel skills doctor

以下冒烟测试成功后即表示完成：

steel scrape https://example.com

选择合适的路径

• 静态页面内容：steel scrape <url>
• 截图：steel screenshot <url>
• PDF：steel pdf <url>
• 多步交互、登录、表单或大量使用 JS 的页面：steel browser ...
• 机器人检测、CAPTCHA、代理或登录可靠性问题：使用 steel-session-debugging 收集证据，然后使用 steel-reliability
• 可复用的应用代码：使用 steel-developer

从能够完成任务的最小工具开始。只有在需要交互或状态时，才从 scrape／screenshot／PDF 升级到交互式浏览器会话。

交互式会话工作流

steel browser start --session my-task --session-timeout 3600000
steel browser navigate https://example.com --session my-task
steel browser snapshot -i --session my-task
steel browser click @e1 --session my-task
steel browser wait --load networkidle --session my-task
steel browser snapshot -i --session my-task
steel browser stop --session my-task

规则：

• 每条命令始终使用相同的 --session <name>。
• 导航或 DOM 发生变化后，重新执行 snapshot -i，因为元素引用会过期。
• 优先使用快照中的 @eN 引用，而不是脆弱的 CSS 选择器。
• 如果一个序列需要执行操作并立即重新获取快照，请使用 steel browser batch。
• 除非用户明确要求保持会话打开，否则应释放／停止会话。

故障排除

1. 对于安装或 CLI 与技能不匹配的问题，运行 steel skills doctor。
2. 对于身份验证／API 问题，运行 steel doctor --preflight。
3. 使用 steel browser sessions 和 steel browser live --session <name> 查看活动会话。
4. 对于已完成但失败的会话，加载 steel-session-debugging。
5. 对于机器人／代理／CAPTCHA／身份问题的修复，加载 steel-reliability。

参考资料

• references/steel-browser-commands.md：命令参考。
• references/steel-browser-lifecycle.md：会话生命周期规范。
• references/troubleshooting.md：故障恢复手册。
• references/migration-agent-browser.md：从上游 agent-browser 迁移。