xxih/ai-harness-zh/browser

Browser Tools

一组用于协作式站点探索与抓取的最小 CDP 工具。

鸣谢：基于 Mario Zechner 的文章 What if you don't need MCP?，并在 Factory.ai 的版本基础上改编。

Setup

首次使用前，请先安装依赖：

npm install --prefix skills/browser

Start Chrome

./skills/browser/scripts/start.js              # 全新 profile
./skills/browser/scripts/start.js --profile    # 复制你的 profile（cookies、登录态）

在 :9222 启动开启远程调试的 Chrome。

Navigate

./skills/browser/scripts/nav.js https://example.com
./skills/browser/scripts/nav.js https://example.com --new

在当前标签页导航，或使用新标签页打开。

Evaluate JavaScript

./skills/browser/scripts/eval.js 'document.title'
./skills/browser/scripts/eval.js 'document.querySelectorAll("a").length'

在当前活动标签页中执行 JavaScript（异步上下文）。

IMPORTANT：代码必须是单个表达式；如果有多条语句，请使用 IIFE：

• 单个表达式：'document.title'
• 多条语句：'(() => { const x = 1; return x + 1; })()'
• 避免在代码字符串中换行，保持单行

Screenshot

./skills/browser/scripts/screenshot.js

截取当前视口的截图，并返回临时文件路径。

Pick Elements

./skills/browser/scripts/pick.js "Click the submit button"

交互式元素选择器。点击选择，Cmd/Ctrl+Click 可多选，按 Enter 结束。

Workflow

1. 使用 start.js --profile 启动 Chrome，以复用你当前的登录状态。
2. 通过 nav.js https://target.app 驱动页面导航，或用 --new 打开辅助标签页。
3. 使用 eval.js 检查 DOM，用于快速计数、属性校验或提取 JSON 载荷。
4. 需要视觉证据时用 screenshot.js，需要精确选择器或文本快照时用 pick.js。

Usage Notes

• 使用其他工具前先启动 Chrome
• --profile 会同步你本机真实的 Chrome profile，因此大多数站点会保持登录状态
• JavaScript 代码在页面中的异步上下文里执行
• pick 工具允许你通过点击的方式直观选择 DOM 元素