Surf 通过命令行或 Unix socket 控制 Chrome,面向浏览器自动化、测试与调试。核心用法是先导航再读取页面获取元素引用:surf navigate "https://example.com"、surf page.read,然后按引用或坐标点击 surf click --ref "e1"、输入 surf type --text "hello"、截图 surf screenshot --output /tmp/shot.png。
主要能力包括:标签页与窗口管理(tab.list、tab.new、window.new、--window-id 隔离);输入与页面检查(key、hover、drag、page.read、page.text、page.state);语义定位(locate.role、locate.text、locate.label);滚动、等待、对话框处理;设备与网络模拟(emulate.network、emulate.cpu、emulate.device、emulate.viewport、emulate.geo);表单填写、下拉选择、文件上传、iframe 切换;网络请求、控制台、JavaScript 执行与性能指标;Cookie、历史与书签;健康检查与冒烟测试。
AI 助手功能无需 API Key,但需在 Chrome 中登录对应服务,例如 surf chatgpt "explain this code"、surf gemini "summarize" --with-page、surf perplexity "deep dive" --mode research、surf grok "query"、surf aistudio "query",以及 surf aistudio.build 构建应用。
工作流可用管道式 surf do 'go "url" | click e5 | screenshot',或保存 JSON 到 ~/.surf/workflows/ 后用 surf do my-workflow 运行,支持参数、循环与步骤输出。
限制:AI 功能依赖浏览器登录状态,模型选择为尽力而为,UI 变化可能导致失败,可用 surf grok --validate 排查;思考型模型响应可能超过 45 秒,AI Studio 构建可能需数分钟。资料未提供安装方式、收费与价格信息。