docs: make Chinese README the default

This commit is contained in:
wehub-resource-sync
2026-07-13 10:20:21 +00:00
parent a3886def0f
commit d6bcc7201d
+62 -56
View File
@@ -1,3 +1,9 @@
<!-- WEHUB_ZH_README -->
> [!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 文件为准。
<div align="center">
<a href="https://www.browseract.com/?co-from=github" style="text-decoration: none;">
<img src="https://browseract-prod.browseract.com/prod/tools/20260205-154549.png" alt="BrowserAct Logo" width="150">
@@ -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** WindowsmacOSLinux
**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<br>(No&nbsp;Signup) | Free<br>(Login&nbsp;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。覆盖 AmazonGoogle MapsYouTubeRedditWeChatZhihu 等。
[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
<a href="https://github.com/browser-act/skills/stargazers">
<img src="https://img.shields.io/github/stars/browser-act/skills?style=social" alt="GitHub Stars">
</a>
🎁 **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)
<p align="center"><em>Built with ❤️ by the BrowserAct Team</em></p>
<p align="center"><em> BrowserAct 团队用 ❤️ 构建</em></p>
## Star History
## Star 历史
<a href="https://www.star-history.com/?repos=browser-act%2Fskills&type=date&logscale=&legend=top-left">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=browser-act/skills&type=date&theme=dark&legend=top-left" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=browser-act/skills&type=date&legend=top-left" />
<img alt="Star History Chart" src="https://api.star-history.com/chart?repos=browser-act/skills&type=date&legend=top-left" />
<img alt="Star 历史图表" src="https://api.star-history.com/chart?repos=browser-act/skills&type=date&legend=top-left" />
</picture>
</a>