dots快速上手教程：Windows/Linux 3分钟跑通不被封号的AI浏览器Agent
【免费下载链接】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 是一个开源的AI 浏览器 Agent：它自带一个"真实感"的 Firefox 浏览器，让 AI 智能体替你上网、点击、填表，而且不容易被网站拦截或封号。这是一份 dots 快速上手教程——在 Windows 或 Linux 上只需两行命令，3 分钟即可跑通，打开网页就能看到你与 AI 的对话，以及它实时操作的浏览器。
dots 的核心理念只有一句话：每个 AI Agent 都是模型 + 浏览器。模型随时可以换，但网站看到的永远是浏览器——页面加载失败、弹出人机验证、登录失效、点击没生效，都发生在浏览器里。dots 把"让浏览器像真人"这件事做到了 C++ 引擎层，这正是它不被封号的关键。
dots 防封号原理：为什么网站拦不住它 🕵️
普通自动化浏览器会暴露一堆自动化特征，而 dots 的 6 个设计让页面"无从查起"：
- 真 Firefox 引擎，C++ 层打补丁：指纹在引擎内部决定，不是靠 JavaScript 事后伪装，页面无法检测
- 一个 seed 对应一个身份：屏幕、字体、GPU、时区、语言互相自洽，
--seed保证每次运行都是"同一个人" - 页面里找不到自动化痕迹：没有 WebDriver 标志、没有 DevTools 协议、没有自动化全局变量
- 像人的手：指针移动到目标再点击、按键逐个触发，页面收到的都是可信事件
- 会记事的浏览器：
--profile-dir让登录状态和 cookies 跨次运行保留 - 代理即身份：搭配
--proxy时，时区与语言自动跟随出口
一键安装步骤：Windows 与 Linux 各两行命令
dots 需要 Python 3.11+，用 uv（Astral 出品的 Python 包管理工具）一行即可安装使用，uv 会自动管理 Python 环境。
Windows（PowerShell）最快安装
先按 uv 官方提供的一行 PowerShell 安装脚本装好 uv，然后刷新 PATH：
$env:Path = "$env:USERPROFILE\.local\bin;$env:Path"再运行 dots（把sk-or-...换成你的 OpenRouter Key）：
uvx --from git+https://gitcode.com/gh_mirrors/dots140/dots dots --openrouter-key sk-or-...Linux（Bash）最快安装
先按 uv 官方提供的一行脚本装好 uv，然后加载环境：
source $HOME/.local/bin/env uvx --from git+https://gitcode.com/gh_mirrors/dots140/dots dots --openrouter-key sk-or-...打开界面：左边对话、右边浏览器
命令跑起来后，浏览器里打开http://127.0.0.1:8765：左边是对话框，右边是浏览器窗口，AI 的每一步操作你都看得清清楚楚。💻
第一次任务示例：让 dots 替你查机票
不知道怎么下指令？照抄这条"查票价"提示词即可（换成你自己的 URL 和日期）：
打开
<粘贴网址>。单程、米兰到里斯本、经济舱、1 名成人。查下个月 12 号到 16 号每一天的最便宜票价，某天没票就明说，不要猜数字。
把网址交给它，然后看着右边的浏览器自己翻日期、比价——这就是 dots 的使用方式：你负责说人话，浏览器负责"像人一样干活"。
常用参数速查：换模型、固定身份、保持登录、走代理 🧰
| 参数 | 作用 |
|---|---|
--openrouter-key | OpenRouter 的 API Key，必填；缺失会直接拒绝启动 |
--model | 切换 OpenRouter 上的任意模型，一个参数换大脑 |
--seed | 固定浏览器身份种子，每次运行还原同一个"人" |
--profile-dir | 指定浏览器配置目录，保留登录与 cookies |
--proxy | 走代理上网，时区与语言自动跟随出口 |
📌 小贴士：Key 也可以写在命令旁的.env文件里，dots 启动时会自动读取；dots --help可列出全部选项。命令入口实现在 src/dots/cli.py，它把参数原样交给内嵌的浏览器引擎；引擎版本在 pyproject.toml 中被精确锁定，保证每次运行行为一致、指纹不漂移。
最快接入方式：把同一个浏览器给 Claude Code / Codex 用
dots 底层使用的隐形浏览器（invisible-playwright-mcp）以 MCP 服务形式开放：Claude Code、Codex、Gemini CLI 或任何支持 MCP 的客户端，都能把它当作浏览器直接调用。dots只是这个浏览器的图形界面——同一个"不被拦截的浏览器"，既能自己用，也能装进你现有的 AI 助手里。
常见问题 FAQ
- 没有 Key 会怎样？不带 OpenRouter Key 启动时，dots 会在启动前直接报错退出，不会空等。
- 支持哪些系统？Windows 与 Linux 双平台（见 pyproject.toml 中的系统分类）；Python 需 3.11 及以上，uv 会自动处理。
- 源码在哪里看？主入口 src/dots/__main__.py、命令行 src/dots/cli.py、入口测试 tests/test_entry.py、项目说明 README.md、许可证 LICENSE（MIT 协议，可自由使用）。
现在，两行命令之后，你就有了一个不被封号的 AI 浏览器 Agent。试着给它一个真实的网址，看看它怎么替你干活吧。🚀
【免费下载链接】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），仅供参考
