diff --git a/README.md b/README.md index 38a0e53..3e402e7 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,9 @@ + +> [!NOTE] +> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。 +> [English](./README.en.md) · [原始项目](https://github.com/browser-act/skills) · [上游 README](https://github.com/browser-act/skills/blob/HEAD/README.md) +> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。 +
BrowserAct Logo @@ -18,61 +24,61 @@ --- -Browser automation CLI built for AI agents. Get past anti-bot walls, hand off to humans across platforms when stuck, run parallel tasks without cross-contamination, and isolate multiple accounts in independent browsers. +面向 AI 智能体（agent）构建的浏览器自动化 CLI。突破反机器人（anti-bot）拦截，卡住时可跨平台交接给人类操作，并行执行任务且互不污染，并在独立浏览器中隔离多个账号。 -## Why BrowserAct +## 为何选择 BrowserAct -The browser an AI agent needs has to reach places standard tools can't, let a human seamlessly take over when the agent is stuck, keep parallel tasks from cross-contaminating, and be designed for LLM reasoning — not human-written scripts. **A browser for agents must get four things right.** +AI 智能体所需的浏览器必须能到达标准工具无法触及的页面，在智能体卡住时让人类无缝接管，避免并行任务相互污染，并且为 LLM 推理而设计——而非为人类编写的脚本。**面向智能体的浏览器必须在四件事上做到位。** -**1. Break through blocks — three progressive layers** +**1. 突破拦截——三层递进方案** -1. **Environment layer** — stealth fingerprint spoofing, TLS rotation, proxy switching. The vast majority of blocks never trigger. -2. **Execution layer** — `solve-captcha` auto-solves CAPTCHAs; `stealth-extract` pulls protected pages in one command. -3. **Human layer** — `remote-assist` generates a live URL; the user takes over from any device, and the agent continues seamlessly when done. +1. **环境层** — 隐身指纹伪装、TLS 轮换、代理切换。绝大多数拦截根本不会触发。 +2. **执行层** — `solve-captcha` 自动解决 CAPTCHA；`stealth-extract` 一条命令拉取受保护页面。 +3. **人工层** — `remote-assist` 生成实时 URL；用户可在任意设备接管，完成后智能体无缝继续。 -**2. Three browser modes — by real-world scenario** +**2. 三种浏览器模式——按真实场景划分** | Mode | Scenario | Key trait | |------|----------|-----------| -| `chrome` | Reuse local Chrome login state | Profile import or CDP attach | -| `stealth` privacy mode | Frictionless batch scraping without login | Fresh fingerprint per session + proxy rotation, zero residue | -| `stealth` fixed identity | Logged-in accounts · multi-browser parallel | Stable fingerprint + stable IP, stable account identity, not flagged as bots | +| `chrome` | 复用本地 Chrome 登录状态 | Profile 导入或 CDP attach | +| `stealth` privacy mode | 无需登录的流畅批量抓取 | 每会话全新指纹 + 代理轮换，零残留 | +| `stealth` fixed identity | 已登录账号 · 多浏览器并行 | 稳定指纹 + 稳定 IP，账号身份稳定，不会被标记为机器人 | -**3. Zero-interference concurrency — every agent in its own lane** +**3. 零干扰并发——每个智能体各走各的道** -- Cross-browser parallel — independent cookies, fingerprints, proxies. Sites cannot correlate them. -- Same-browser multi-session — shared login state, independent execution, tasks don't block each other. -- Privacy mode — fresh fingerprint and empty profile per session, zero residue when done. +- 跨浏览器并行 — 独立 cookie、指纹、代理。网站无法关联它们。 +- 同浏览器多会话 — 共享登录状态，独立执行，任务互不阻塞。 +- Privacy mode — 每会话全新指纹与空白 Profile，结束后零残留。 -**4. Designed for agent reasoning — not human scripts** +**4. 为智能体推理而设计——而非人类脚本** -- **Compact text output** — indexed text format, several times more token-efficient than JSON or HTML. -- **Indexed interaction** — `state` returns an indexed list; `click 3` / `input 2 "..."`. No DOM parsing required. -- **Semantic memory** — every browser carries a `desc`, matched to tasks by meaning. -- **Concurrency-safe** — session ownership + explicit naming. Multi-agent operation never conflicts. +- **紧凑文本输出** — 索引化文本格式，比 JSON 或 HTML 节省数倍 token。 +- **索引化交互** — `state` 返回索引列表；`click 3` / `input 2 "..."`。无需解析 DOM。 +- **语义记忆（semantic memory）** — 每个浏览器携带 `desc`，按语义与任务匹配。 +- **并发安全** — 会话所有权 + 显式命名。多智能体运行永不冲突。 -**Security: confirmation gating** — sensitive operations (browser create / delete, Profile import, proxy changes, security and privacy toggles) require explicit user approval. Prior approvals do not carry over. Enforced at the Skill layer, not a configuration toggle. +**安全：确认门控（confirmation gating）** — 敏感操作（创建/删除浏览器、Profile 导入、代理变更、安全与隐私开关）需要用户明确批准。先前批准不会延续。在 Skill 层强制执行，而非配置开关。 --- -## And More +## 更多能力 -- **Better headless** — Default headless without disrupting users; stealth headless that isn't detected. -- **Cross-platform remote handoff** — Any device opens the link to take over, and the agent continues seamlessly. +- **更好的无头模式（headless）** — 默认无头且不打扰用户；隐身无头模式不会被检测。 +- **跨平台远程交接** — 任意设备打开链接即可接管，智能体无缝继续。 --- -## Install +## 安装 -Tell your AI agent: +告诉你的 AI 智能体： > Install browser-act. Skill source: https://github.com/browser-act/skills/tree/main/browser-act . Verify it works after installation. -[Installation details →](docs/installation.md) +[安装详情 →](docs/installation.md) --- -## Quick Start +## 快速开始 ```bash # Extract protected page content (zero config) @@ -85,29 +91,29 @@ browser-act --session my-task click 3 # Click by index browser-act --session my-task input 2 "hi" # Type into a field ``` -[More examples and workflows →](docs/quick-start.md) +[更多示例与工作流 →](docs/quick-start.md) -The agent runs `get-skills` at the start of each session — gets environment state, browser list, and commands in one call: +智能体在每个会话开始时运行 `get-skills` — 一次调用即可获取环境状态、浏览器列表和命令： ```bash browser-act get-skills core --skill-version 2.0.2 ``` -[How agents discover and use BrowserAct →](docs/skills.md) +[智能体如何发现并使用 BrowserAct →](docs/skills.md) --- -## Compatibility +## 兼容性 -**OS:** Windows, macOS, Linux +**OS：** Windows、macOS、Linux -**Agents:** Claude Code · Cursor · VS Code · OpenCode · OpenClaw · Codex · Gemini CLI — works with any agent that can execute shell commands and load Skills. +**Agents：** Claude Code · Cursor · VS Code · OpenCode · OpenClaw · Codex · Gemini CLI — 适用于任何能执行 shell 命令并加载 Skills 的智能体。 --- -## What's Free +## 免费范围 -Almost everything is free. Only two features require payment: managed proxies (Dynamic / Static), and stealth browsers beyond the first 5. +几乎一切都免费。仅两项功能需要付费：托管代理（Dynamic / Static），以及超出前 5 个的隐身浏览器。 | Feature | Free
(No Signup) | Free
(Login Only) | Paid | |---------|:----------------:|:-----------------:|:----:| @@ -117,66 +123,66 @@ Almost everything is free. Only two features require payment: managed proxies (D --- -## Documentation +## 文档 -Full documentation covers anti-blocking, browser modes, sessions and concurrency, headless and remote handoff, agent design, the Skills system, and the complete command reference. +完整文档涵盖反拦截、浏览器模式、会话与并发、无头模式与远程交接、智能体设计、Skills 系统，以及完整命令参考。 -[Read the full documentation →](docs/README.md) +[阅读完整文档 →](docs/README.md) --- -## Also From BrowserAct +## BrowserAct 更多产品 -### Skill Forge — Your Personal Scraping Engineer +### Skill Forge — 你的专属抓取工程师 -Need to extract data from the same website repeatedly at scale? Don't write scrapers by hand. **Skill Forge** explores a site once, discovers its APIs and data patterns, generates a deploy-ready Skill package, then runs reliably without re-exploration — 500 or 5,000 records through the same stable path. +需要大规模、反复从同一网站提取数据？不必手写爬虫。**Skill Forge** 探索站点一次，发现其 API 与数据模式，生成可部署的 Skill 包，之后无需重新探索即可稳定运行——无论 500 条还是 5,000 条记录，都走同一条稳定路径。 -**Any website. Any data. One command to start:** +**任意网站。任意数据。一条命令即可开始：** > Install browser-act-skill-forge. Skill source: https://github.com/browser-act/skills/tree/main/browser-act-skill-forge . Verify it works after installation. -Then tell your agent what you need: +然后告诉你的智能体你需要什么： > *"Forge a Skill that extracts job listings from LinkedIn — title, company, salary, URL. I'll run 300 keywords later."* -[Skill Forge documentation →](docs/skill-forge.md) +[Skill Forge 文档 →](docs/skill-forge.md) ### Solutions Catalog -30+ pre-built Skills already generated by Skill Forge, ready to install and run. Covers Amazon, Google Maps, YouTube, Reddit, WeChat, Zhihu, and more. +30+ 个由 Skill Forge 预先生成、可直接安装运行的 Skills。覆盖 Amazon、Google Maps、YouTube、Reddit、WeChat、Zhihu 等。 -[Browse the full Solutions Catalog →](solutions/README.md) +[浏览完整 Solutions Catalog →](solutions/README.md) -### Build Your Own +### 自行构建 -Can't find what you need above? Generate a custom Skill for **any website** in minutes — no coding required. Just describe what data you want or what action to perform, and Skill Forge handles the rest. +上面找不到你需要的？几分钟内为**任意网站**生成自定义 Skill——无需编码。只需描述你想要的数据或要执行的操作，Skill Forge 会处理其余一切。 --- -## 💖 Support the Project +## 💖 支持本项目 -BrowserAct Skills is **free and open source**. If it saves you time, please give us a ⭐ **Star** — it keeps the project alive and helps us ship more skills. +BrowserAct Skills 是**免费开源**的。如果它为你节省了时间，请给我们一个 ⭐ **Star** — 这能让项目持续运转，并帮助我们发布更多 skills。 GitHub Stars -🎁 **Bonus:** Once you star the repository, you can join our [Discord](https://discord.com/invite/UpnCKd7GaU) and post in the `#claim-500-credits` channel to receive **500 free credits**! +🎁 **福利：** 为仓库点 Star 后，可加入我们的 [Discord](https://discord.com/invite/UpnCKd7GaU) and post in the `#claim-500-credits` channel to receive **500 free credits**! -### 🤝 Community & Support +### 🤝 社区与支持 - 💬 [Join our Discord](https://discord.com/invite/UpnCKd7GaU) - 📖 [Read the Docs](https://docs.browseract.com) - 🐛 [Report an Issue](https://github.com/browser-act/skills/issues) - 🌐 [BrowserAct Website](https://www.browseract.com/?co-from=github) -

Built with ❤️ by the BrowserAct Team

+

由 BrowserAct 团队用 ❤️ 构建

-## Star History +## Star 历史 - Star History Chart + Star 历史图表