steel-browser

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Steel Browser

Steel 浏览器

Use Steel CLI browser tools to complete live web work now.

使用Steel CLI浏览器工具即时完成实时Web工作。

Setup

设置

If Steel is missing or unauthenticated:

bash

steel --version
steel login
steel doctor --preflight

If the CLI or installed skills look broken, run:

bash

steel skills doctor

Done when this smoke test succeeds:

bash

steel scrape https://example.com

如果未安装Steel或未完成身份验证：

bash

steel --version
steel login
steel doctor --preflight

如果CLI或已安装的skill出现异常，请运行：

bash

steel skills doctor

当以下冒烟测试成功时，即完成设置：

bash

steel scrape https://example.com

Choose The Right Path

选择合适的方案

Static page content:
```
steel scrape <url>
```
Screenshot:
```
steel screenshot <url>
```
PDF:
```
steel pdf <url>
```
Multi-step interaction, login, forms, or JS-heavy pages:
```
steel browser ...
```
Bot detection, CAPTCHA, proxy, or login reliability failure: collect evidence with
```
steel-session-debugging
```
, then use
```
steel-reliability
```
Reusable application code: use
```
steel-developer
```

Start with the smallest tool that can finish the task. Escalate from scrape/screenshot/PDF to an interactive browser session only when interaction or state is required.

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

从能完成任务的最小工具开始。仅当需要交互或状态保持时，才从抓取/截图/PDF升级到交互式浏览器会话。

Interactive Session Workflow

交互式会话工作流

bash

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

Rules:

Always use the same
```
--session <name>
```
on every command.
Take a fresh
```
snapshot -i
```
after navigation or DOM changes because element refs expire.
Prefer
```
@eN
```
refs from snapshots over brittle CSS selectors.
Use
```
steel browser batch
```
when a sequence needs an action and immediate re-snapshot.
Release/stop sessions unless the user explicitly asks to keep them open.

bash

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
```
。
除非用户明确要求保持会话开启，否则请释放/停止会话。

Troubleshooting

故障排查

Run
```
steel skills doctor
```
for install or CLI-skill mismatch issues.
Run
```
steel doctor --preflight
```
for auth/API issues.

Use

steel browser sessions

and

steel browser live --session <name>

for active sessions.

For failed completed sessions, load
```
steel-session-debugging
```
.
For bot/proxy/CAPTCHA/identity fixes, load
```
steel-reliability
```
.

若出现安装或CLI-skill不匹配问题，请运行
```
steel skills doctor
```
。
若出现身份验证/API问题，请运行
```
steel doctor --preflight
```
。

若要查看活跃会话，请使用

steel browser sessions

和

steel browser live --session <name>

。

对于已失败的完成会话，请加载
```
steel-session-debugging
```
。
对于机器人/代理/验证码/身份验证修复，请加载
```
steel-reliability
```
。

References

参考资料

```
references/steel-browser-commands.md
```
: command reference.
```
references/steel-browser-lifecycle.md
```
: session lifecycle discipline.
```
references/troubleshooting.md
```
: recovery playbooks.

references/migration-agent-browser.md

: migration from upstream

agent-browser

```
references/steel-browser-commands.md
```
：命令参考文档。
```
references/steel-browser-lifecycle.md
```
：会话生命周期规范。
```
references/troubleshooting.md
```
：恢复方案手册。

references/migration-agent-browser.md

：从上游

agent-browser

迁移指南。