1. 项目定位与用途
Actionbook 是一个面向 AI 代理的并行网页操作 CLI 工具，核心创新在于使用预定义操作手册替代实时页面解析，使代理能够直接执行已验证的交互步骤。它旨在为 AI 代理提供快速、准确、并发的网页自动化能力，适用于需要大规模网页操作的场景，如数据采集、监控和表单填写等。项目采用 monorepo 管理，核心为 Rust CLI，辅以浏览器扩展、MCP 服务器、Dify 插件等包，形成完整工具链。
项目档案命令行工具
Actionbook CLI 使用指南：AI 代理并行网页操作工具安装与命令详解
Actionbook 是一个面向 AI 代理的并行网页操作 CLI，通过预定义操作手册实现 10 倍速度提升。本文详细介绍其安装方法（npm/cargo）、核心命令（browser/open/click/fill）、AI 集成方式（Skills/MCP），以及适用场景如批量数据采集和多网站监控，帮助快速上手网页自动化。
AI 总结
Actionbook 是一个面向 AI 代理的并行网页操作 CLI 工具，通过预定义操作手册替代实时页面解析，实现 10 倍速度提升和准确交互，支持同时操作数十个浏览器标签页。
中文项目介绍
Actionbook 是一个专为 AI 代理设计的并行网页操作命令行工具。它通过预定义的操作手册（action manuals）替代传统的实时页面解析与决策流程，使 AI 代理能够直接、高效地控制网页，显著提升自动化任务的速度和可靠性。
传统 AI 代理在网页操作中面临三大挑战：速度慢（每步需解析页面）、准确性低（难以应对现代网页的虚拟 DOM 和动态组件）、并发能力差（任务串行执行）。Actionbook 通过操作手册消除解析开销，专为 SPA 和流式组件设计确保交互准确，并采用无状态架构支持并行操作多个标签页，从而解决这些问题。
它适用于批量数据采集（如同时访问 192 个投资组合公司网站收集标语仅需 2 分钟）、多任务并行自动化（如监控多个电商价格）、以及增强 AI 代理的网页操作能力。技术层面，Actionbook 采用 Rust 开发 CLI 核心，支持隔离模式和扩展模式两种浏览器控制方式，并能通过 CDP 协议自动化 35+ 款 Electron 应用。同时提供 Skills 系统和 MCP 服务器，方便与 Claude Code、Cursor 等 AI 工具集成。
详细信息与使用说明
2. 解决的问题
Actionbook 解决了传统 AI 代理网页操作的三大痛点：速度问题——传统方式每步解析页面导致任务缓慢（如搜索 Airbnb 房间需 15 分钟），Actionbook 通过操作手册直接执行，速度提升 10 倍以上；准确性问题——现代网站使用虚拟 DOM、SPA 和流式组件，传统代理交互 brittle，Actionbook 专为这些技术设计，确保可靠交互；并发问题——传统代理串行处理页面，Actionbook 无状态架构支持同时操作数十个标签页，实现真正并行。
3. 适用场景
Actionbook 主要适用于以下场景：批量数据采集，例如同时访问 192 个投资组合公司网站收集标语仅需 2 分钟；多任务并行自动化，如同时监控多个电商平台的价格变化；AI 代理增强，为 Claude Code、Cursor 等编码助手提供网页操作能力，通过添加 Skills 或 MCP 集成；复杂交互处理，如下拉菜单、日期选择器和动态内容的可靠操作。这些场景均受益于其并行、准确和高效的特点。
4. 安装方式
Actionbook 提供两种安装方式：全局 npm 安装（推荐）：运行 `npm install -g @actionbookdev/cli` 即可将命令行工具安装到系统路径。源码构建：使用 Rust 工具链，运行 `cargo install --git https://github.com/actionbook/actionbook --path packages/cli --locked` 从源码编译安装（需 Rust 1.70+）。安装后首次使用需运行 `actionbook setup` 进行初始配置，包括设置 API key 和选择浏览器模式。扩展模式需额外运行 `actionbook extension install` 安装 Chrome 扩展到用户浏览器。
5. 使用方式
基本使用流程包括：启动浏览器会话：`actionbook browser start`；打开标签页：`actionbook browser open <url> --session <session_id>`；并行操作：对多个标签页同时执行 `snapshot`（获取页面结构）、`click`（点击元素）、`fill`（填写表单）等命令，通过 `--tab` 参数区分标签页，例如 `actionbook browser click @e5 --session s1 --tab t1 &`。此外，可使用 `actionbook search <query>` 查找操作手册，`actionbook get <actionId>` 获取手册详情。对于 AI 代理，可通过 `npx skills add actionbook/actionbook` 添加 Skills，或使用 MCP 服务器集成。
6. 补充说明与实现特点
Actionbook 具有以下实现特点：双模式浏览器控制——隔离模式启动独立 Chrome 进程，扩展模式连接用户现有浏览器 via Chrome 扩展；多端自动化——除浏览器外，通过 Chrome DevTools Protocol 支持 35+ 款 Electron 应用（如 VS Code、Slack、Figma）的自动化；无状态并行架构——每个标签页操作独立，可同时处理数十个会话；AI 集成层——提供 Skills 系统（指导代理使用 CLI）和 MCP 服务器（IDE 集成）两种方式；操作手册仓库——预定义的网站操作手册集合，包含验证过的选择器和步骤，确保操作可靠。项目文档系统完整，涵盖安装、API 参考、示例和社区贡献指南。
思维导图
Actionbook
CLI 核心
Rust 实现
命令解析
CDP 通信
多会话管理
浏览器扩展
Chrome 扩展桥接
扩展模式
操作注入
AI 集成
Skills 系统
MCP 服务器
Dify 插件
应用支持
Electron 应用自动化
35+ 应用列表
文档系统
安装指南
API 参考
示例教程
社区贡献
常见问题
Actionbook 是什么？
Actionbook 是一个面向 AI 代理的并行网页操作命令行工具，使用预定义操作手册替代实时页面解析，使代理能够快速、准确、并发地控制网页。
如何安装 Actionbook？
可通过 npm 全局安装：`npm install -g @actionbookdev/cli`；或使用 Rust 从源码构建：`cargo install --git https://github.com/actionbook/actionbook --path packages/cli --locked`（需 Rust 1.70+）。
Actionbook 支持哪些浏览器和应用？
默认使用系统浏览器（Chrome、Brave、Edge、Arc、Chromium）；此外通过 Chrome DevTools Protocol 支持 35+ 款 Electron 应用，如 VS Code、Slack、Figma 等。
如何将 Actionbook 集成到 AI 代理中？
可通过两种方式：一是添加 Skills 系统：运行 `npx skills add actionbook/actionbook` 为 AI 代理提供使用指南；二是使用 MCP 服务器：运行 `npx -y @actionbookdev/mcp@latest` 将 Actionbook 作为工具接入 Cursor、Claude Code 等 IDE。
Actionbook 的并行操作如何实现？
Actionbook 采用无状态架构，通过会话（session）和标签页（tab）标识符管理多个浏览器实例。命令如 `actionbook browser open` 创建标签页，后续操作通过 `--session` 和 `--tab` 参数指定目标，支持同时执行 snapshot、click、fill 等命令，实现真正并行。