wehub-resource-sync
189 lines
9.0 KiB
Markdown
189 lines
9.0 KiB
Markdown
<!-- 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">
|
||
</a>
|
||
<h1>BrowserAct Skills</h1>
|
||
|
||
<p>
|
||
<a href="https://discord.com/invite/UpnCKd7GaU"><img src="https://img.shields.io/discord/1234567890?label=Discord&logo=discord&color=7289DA" alt="Discord"></a>
|
||
<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>
|
||
<a href="https://github.com/browser-act/skills/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License"></a>
|
||
<br><br>
|
||
<a href="https://www.browseract.com/?co-from=github"><img src="https://img.shields.io/badge/Website-BrowserAct.com-success" alt="Website"></a>
|
||
<a href="https://x.com/browseract"><img src="https://img.shields.io/badge/X-browseract-000000?style=flat&logo=x&logoColor=white" alt="X (Twitter)"></a>
|
||
<a href="https://www.linkedin.com/company/browseract/"><img src="https://img.shields.io/badge/LinkedIn-BrowserAct-0A66C2?style=flat&logo=linkedin&logoColor=white" alt="LinkedIn"></a>
|
||
<a href="https://www.youtube.com/@browseract"><img src="https://img.shields.io/badge/YouTube-@browseract-FF0000?style=flat&logo=youtube&logoColor=white" alt="YouTube"></a>
|
||
</p>
|
||
</div>
|
||
|
||
---
|
||
|
||
面向 AI 智能体（agent）构建的浏览器自动化 CLI。突破反机器人（anti-bot）拦截，卡住时可跨平台交接给人类操作，并行执行任务且互不污染，并在独立浏览器中隔离多个账号。
|
||
|
||
## 为何选择 BrowserAct
|
||
|
||
AI 智能体所需的浏览器必须能到达标准工具无法触及的页面，在智能体卡住时让人类无缝接管，避免并行任务相互污染，并且为 LLM 推理而设计——而非为人类编写的脚本。**面向智能体的浏览器必须在四件事上做到位。**
|
||
|
||
**1. 突破拦截——三层递进方案**
|
||
|
||
1. **环境层** — 隐身指纹伪装、TLS 轮换、代理切换。绝大多数拦截根本不会触发。
|
||
2. **执行层** — `solve-captcha` 自动解决 CAPTCHA；`stealth-extract` 一条命令拉取受保护页面。
|
||
3. **人工层** — `remote-assist` 生成实时 URL；用户可在任意设备接管，完成后智能体无缝继续。
|
||
|
||
**2. 三种浏览器模式——按真实场景划分**
|
||
|
||
| Mode | Scenario | Key trait |
|
||
|------|----------|-----------|
|
||
| `chrome` | 复用本地 Chrome 登录状态 | Profile 导入或 CDP attach |
|
||
| `stealth` privacy mode | 无需登录的流畅批量抓取 | 每会话全新指纹 + 代理轮换，零残留 |
|
||
| `stealth` fixed identity | 已登录账号 · 多浏览器并行 | 稳定指纹 + 稳定 IP，账号身份稳定，不会被标记为机器人 |
|
||
|
||
**3. 零干扰并发——每个智能体各走各的道**
|
||
|
||
- 跨浏览器并行 — 独立 cookie、指纹、代理。网站无法关联它们。
|
||
- 同浏览器多会话 — 共享登录状态，独立执行，任务互不阻塞。
|
||
- Privacy mode — 每会话全新指纹与空白 Profile，结束后零残留。
|
||
|
||
**4. 为智能体推理而设计——而非人类脚本**
|
||
|
||
- **紧凑文本输出** — 索引化文本格式，比 JSON 或 HTML 节省数倍 token。
|
||
- **索引化交互** — `state` 返回索引列表；`click 3` / `input 2 "..."`。无需解析 DOM。
|
||
- **语义记忆（semantic memory）** — 每个浏览器携带 `desc`，按语义与任务匹配。
|
||
- **并发安全** — 会话所有权 + 显式命名。多智能体运行永不冲突。
|
||
|
||
**安全：确认门控（confirmation gating）** — 敏感操作（创建/删除浏览器、Profile 导入、代理变更、安全与隐私开关）需要用户明确批准。先前批准不会延续。在 Skill 层强制执行，而非配置开关。
|
||
|
||
---
|
||
|
||
## 更多能力
|
||
|
||
- **更好的无头模式（headless）** — 默认无头且不打扰用户；隐身无头模式不会被检测。
|
||
- **跨平台远程交接** — 任意设备打开链接即可接管，智能体无缝继续。
|
||
|
||
---
|
||
|
||
## 安装
|
||
|
||
告诉你的 AI 智能体：
|
||
|
||
> Install browser-act. Skill source: https://github.com/browser-act/skills/tree/main/browser-act . Verify it works after installation.
|
||
|
||
[安装详情 →](docs/installation.md)
|
||
|
||
---
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
# Extract protected page content (zero config)
|
||
browser-act stealth-extract https://example.com
|
||
|
||
# Full browser automation
|
||
browser-act --session my-task browser open <id> https://example.com
|
||
browser-act --session my-task state # See clickable elements
|
||
browser-act --session my-task click 3 # Click by index
|
||
browser-act --session my-task input 2 "hi" # Type into a field
|
||
```
|
||
|
||
[更多示例与工作流 →](docs/quick-start.md)
|
||
|
||
智能体在每个会话开始时运行 `get-skills` — 一次调用即可获取环境状态、浏览器列表和命令：
|
||
|
||
```bash
|
||
browser-act get-skills core --skill-version 2.0.2
|
||
```
|
||
|
||
[智能体如何发现并使用 BrowserAct →](docs/skills.md)
|
||
|
||
---
|
||
|
||
## 兼容性
|
||
|
||
**OS：** Windows、macOS、Linux
|
||
|
||
**Agents：** Claude Code · Cursor · VS Code · OpenCode · OpenClaw · Codex · Gemini CLI — 适用于任何能执行 shell 命令并加载 Skills 的智能体。
|
||
|
||
---
|
||
|
||
## 免费范围
|
||
|
||
几乎一切都免费。仅两项功能需要付费：托管代理（Dynamic / Static），以及超出前 5 个的隐身浏览器。
|
||
|
||
| Feature | Free<br>(No Signup) | Free<br>(Login Only) | Paid |
|
||
|---------|:----------------:|:-----------------:|:----:|
|
||
| Browser automation, Chrome / Chrome-direct | ✓ | ✓ | ✓ |
|
||
| Stealth browser (≤ 5), stealth-extract, solve-captcha, remote-assist, privacy mode, Skill Forge | — | ✓ | ✓ |
|
||
| Stealth browser (> 5), Dynamic / Static proxy | — | — | ✓ |
|
||
|
||
---
|
||
|
||
## 文档
|
||
|
||
完整文档涵盖反拦截、浏览器模式、会话与并发、无头模式与远程交接、智能体设计、Skills 系统，以及完整命令参考。
|
||
|
||
[阅读完整文档 →](docs/README.md)
|
||
|
||
---
|
||
|
||
## BrowserAct 更多产品
|
||
|
||
### Skill Forge — 你的专属抓取工程师
|
||
|
||
需要大规模、反复从同一网站提取数据？不必手写爬虫。**Skill Forge** 探索站点一次，发现其 API 与数据模式，生成可部署的 Skill 包，之后无需重新探索即可稳定运行——无论 500 条还是 5,000 条记录，都走同一条稳定路径。
|
||
|
||
**任意网站。任意数据。一条命令即可开始：**
|
||
|
||
> Install browser-act-skill-forge. Skill source: https://github.com/browser-act/skills/tree/main/browser-act-skill-forge . Verify it works after installation.
|
||
|
||
然后告诉你的智能体你需要什么：
|
||
|
||
> *"Forge a Skill that extracts job listings from LinkedIn — title, company, salary, URL. I'll run 300 keywords later."*
|
||
|
||
[Skill Forge 文档 →](docs/skill-forge.md)
|
||
|
||
### Solutions Catalog
|
||
|
||
30+ 个由 Skill Forge 预先生成、可直接安装运行的 Skills。覆盖 Amazon、Google Maps、YouTube、Reddit、WeChat、Zhihu 等。
|
||
|
||
[浏览完整 Solutions Catalog →](solutions/README.md)
|
||
|
||
### 自行构建
|
||
|
||
上面找不到你需要的？几分钟内为**任意网站**生成自定义 Skill——无需编码。只需描述你想要的数据或要执行的操作，Skill Forge 会处理其余一切。
|
||
|
||
---
|
||
|
||
## 💖 支持本项目
|
||
|
||
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>
|
||
|
||
🎁 **福利：** 为仓库点 Star 后，可加入我们的 [Discord](https://discord.com/invite/UpnCKd7GaU) and post in the `#claim-500-credits` channel to receive **500 free credits**!
|
||
|
||
### 🤝 社区与支持
|
||
- 💬 [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>由 BrowserAct 团队用 ❤️ 构建</em></p>
|
||
|
||
## 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 历史图表" src="https://api.star-history.com/chart?repos=browser-act/skills&type=date&legend=top-left" />
|
||
</picture>
|
||
</a>
|