dots使用指南:左侧对话、右侧实时浏览器,玩转内置Web界面的5个技巧
【免费下载链接】dotsOpen-source dots for the web: an AI agent with its own browser, one that does not get blocked.项目地址: https://gitcode.com/gh_mirrors/dots140/dots
dots 是一个开源的 Web AI Agent 工具:它自带一个"不被拦截"的浏览器,启动后打开内置 Web 界面,左侧是对话窗口、右侧是实时浏览器画面,你可以一边和 AI 聊天,一边亲眼看它上网查资料、点按钮、填表单。本指南面向新手,带你在几分钟内跑起 dots,并掌握 5 个最实用的内置界面技巧。
为什么 dots 值得关注:浏览器才是关键
传统 AI Agent 失败,往往不是模型不够聪明,而是网页根本没加载出来、弹出了人机验证、登录失效、点击没落上——这些都发生在浏览器里,在模型开始思考之前。
dots 的思路很直接:把浏览器做成整个产品的核心。根据 README.md 的说明:
- 🎭 基于一个在 C++ 层面修补过的真实 Firefox 引擎,指纹在引擎内部决定,而不是用 JS 画上去的;
- 🪢 一个种子对应一个"身份":屏幕、字体、GPU、时区、语言彼此自洽;
- 🫥 页面上找不到任何自动化痕迹:没有 WebDriver 标志、没有 DevTools 协议、没有自动化全局变量;
- ✍️ 像真人一样操作:鼠标会移动到目标再点击,按键逐次按下;
- 🧠 浏览器会"记住":登录状态和 Cookie 可以跨会话保留。
而模型部分则是可插拔的——OpenRouter 上的任意模型都能用,一个参数即可切换。
三步快速启动:安装 dots 的最短路径
第 1 步:准备 uv。uv 是 Astral 出品的快速 Python 包管理工具,按官方文档安装即可(Windows 用 PowerShell,Linux 用 curl 脚本)。
第 2 步:准备一个 OpenRouter 的 API Key,用来驱动模型。没有 Key 时,dots 会在启动前直接拒绝运行(这一点由 tests/test_entry.py 中的测试明确保证)。
第 3 步:拉取源码并运行。克隆仓库(仓库地址:https://gitcode.com/gh_mirrors/dots140/dots),然后执行一条带--openrouter-key参数的启动命令即可。dots 的入口定义在 pyproject.toml 中,它只做了很小的一件事:把参数原样交给底层界面命令 cli.py,因此dots --help列出的就是完整选项清单。
启动成功后,打开浏览器访问http://127.0.0.1:8765——左侧对话、右侧浏览器,实时在线,dots 的主界面就在这里。
玩转内置 Web 界面的 5 个技巧
技巧 1:用"一句话 + URL"派任务,别写长提示词
内置界面的对话框最适合具体、可验收的指令。README 给了一个很好的示范句式:
Go to
<粘贴网址>。单程,米兰到里斯本,经济舱,1 个成人。检查下月 12 到 16 日每一天,读出当天最低价。某天无票就明说,不要猜数字。
要点:给网址、给明确范围、要求"读出来"而不是"猜"。右侧浏览器画面会让你实时确认 Agent 走没走对路线。
技巧 2:盯着右侧画面看"手"怎么走
dots 的鼠标是移动过去再点击、按键是一下一下按的,所以右侧画面里你能看到指针的完整轨迹。遇到人机验证或登录弹窗时,配合--profile-dir指定的资料目录(保留 Cookie 和登录状态),下一次运行接着上次登录,不用重复输密码。
技巧 3:用 --model 一键切换 AI 大脑
浏览器是固定的人格,模型是随换随用的零件。在启动命令上加一个--model参数,就能在 OpenRouter 的任意模型之间切换——想换更强的推理模型处理复杂表格,或换便宜的模型跑批量任务,都不用改代码。入口实现见 src/dots/main.py,它直接调用 src/dots/cli.py 的main。
技巧 4:用 --seed 固定"人格",保证每次都是同一个人
同一个网站对不同"身份"的容忍度不同。--seed参数保证每次运行生成同一个身份:屏幕尺寸、字体、GPU、时区、语言互相一致,不会这次像纽约用户、下次像东京用户。跑稳定任务时,固定种子是最被低估的一步。
技巧 5:--proxy 让时区和语言跟着出口走,用 --help 补齐所有选项
"从哪里连上来"也是身份的一部分。使用--proxy时,dots 会让时区和语言跟随代理出口,让"位置、语言、网络"三者对得上。而完整的能力清单不用猜——在终端执行dots --help即可列出全部选项(tests/test_entry.py 中专门校验了--openrouter-key、--model、--proxy、--seed、--profile-dir都会出现在帮助里)。
常见问题
- 端口被占?用
--port指定其他端口,再访问对应的127.0.0.1:<端口>。 - 想在别的 AI 助手里用同一个浏览器?dots 的底层引擎以 MCP 服务的形式提供,Claude Code、Codex、Gemini CLI 等任何 MCP 客户端都能接入,dots 就是它的界面层。
- 许可证?项目采用 MIT 协议,见 LICENSE。
小结
dots 把复杂的事情做减法了:你只需要一个 API Key 和一条命令,就能拥有"左侧对话、右侧实时浏览器"的 Web Agent 界面。记住这 5 个技巧——一句话派任务、盯画面、换模型、固定种子、配代理——你就掌握了这个内置 Web 界面的全部精髓。
【免费下载链接】dotsOpen-source dots for the web: an AI agent with its own browser, one that does not get blocked.项目地址: https://gitcode.com/gh_mirrors/dots140/dots
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考