Initial commit with translated description

This commit is contained in:
2026-03-29 09:37:27 +08:00
commit f8151bb976
7 changed files with 183 additions and 0 deletions

View File

@@ -0,0 +1,33 @@
# Agent Browser Overview
## 1) What it is
- A fast Rust-based headless browser automation CLI with a Node.js fallback.
- Designed for AI agents to navigate, click, type, and snapshot pages via structured commands.
- Uses a background daemon and Playwright for browser control.
## 2) Install and setup (hardened)
- Pin the version you trust:
- `npm install -g agent-browser@<version>`
- Prefer a dedicated environment or container for installs.
- Avoid running with elevated OS privileges.
- Install browser runtime:
- `agent-browser install`
- Linux dependencies (if needed):
- `agent-browser install --with-deps`
- or `npx playwright install-deps chromium`
## 3) Browser engines
- Chromium is the default browser engine.
- Firefox and WebKit are supported through Playwright.
## 4) Snapshot concept
- `snapshot` returns a structured view with stable element refs.
- Refs are designed for compact, deterministic automation.
## 5) Sessions
- The CLI supports multiple sessions so agents can isolate work.
## 6) Security posture
- Treat the CLI as high privilege; run with strict allowlists.
- Avoid file access and arbitrary script execution unless required.
- Keep profiles and state files ephemeral by default.