Mac：通过 AI 对话使用 EasyBR | EasyBR-免费指纹浏览器

在支持本机操作的 AI Agent 中安装 easybr-agent Skill 后，可以直接说：“帮我使用 EasyBR，检查安装和账号状态，再打开环境执行任务。”首次使用时，Agent 可以协助下载安装和注册；已有安装、账号或环境时，直接从当前状态继续。

本教程适用于 Apple 芯片 Mac。这里的对话入口是你已经使用的 Agent，例如能够读取 Skill、运行本机命令并操作应用的 Codex 或其他 Agent。EasyBR 管理独立环境；内置的 Easy WebBridge 负责连接浏览器；Skill 告诉 Agent 怎样把这些步骤串起来。

第一步：把 Skill 交给 Agent

• 下载 easybr-agent Skill
• EasyBR 官方下载页
• 公开产品仓库（Gitee）

下载并解压 Skill，保留整个 easybr-agent 文件夹，其中应包含 SKILL.md、scripts/ 和 references/。将它交给 Agent 安装到其 Skill 目录，或让 Agent 直接读取这个目录里的 SKILL.md。Codex 的个人 Skill 目录通常是 ~/.codex/skills/；其他 Agent 按各自的 Skill 安装方式操作。

可以直接复制：

请读取我下载的 easybr-agent/SKILL.md，把这个 Skill 安装到你的技能目录。
先检查这台 Mac 的芯片、EasyBR 安装状态、登录状态及本机连接。
说明接下来需要完成哪些步骤，然后继续执行。

Skill 辅助脚本需要 Agent 可运行 Node.js 20 或更新版本，没有 npm 依赖。EasyBR 内置 Bridge 使用 Electron 自带的运行时，用户不需要为 Bridge 另装 Node.js，也不需要单独启动 Bridge 服务。Agent 若缺少本机命令、文件或界面操作能力，应先明确指出，不能把远程聊天当作已完成本机安装。

第二步：检查安装，需要时下载安装

首次使用可以这样说；已经安装并可正常使用时，Agent 核对版本和应用路径后继续，不需要每次重新下载或安装：

请从 EasyBR 官网下载适合这台 Apple 芯片 Mac 的正式安装包，
核对文件大小、SHA256、应用签名和公证结果，再安装到“应用程序”。
保留已有的浏览器环境、Cookie 和本地数据，不运行卸载或清数据脚本。
安装后启动刚安装的应用，并核对版本和应用路径。

Mac 正式包目前是 ZIP：解压后进入 mac-installer/，打开其中的 DMG，核验里面的 EasyBR 应用，再将应用安装到“应用程序”。ZIP 中附带的卸载、修复脚本不属于正常安装步骤，不需要运行。

Agent 应从官网下载页或下载接口读取当前版本和校验信息，不把本教程中的版本号当作永久最新版本。主下载源失败时，使用官网提供且版本、哈希一致的备用源。校验失败就重新核对下载来源，不能把错误文件当作可安装包。

需要更新或明确要求重装时，先正常退出 EasyBR 和必要的环境进程，保留旧应用作回滚备份，再替换应用；保留用户数据目录。安装后启动新安装的应用，核对实际版本和路径。后续版本以官网下载页为准。

第三步：注册或登录自己的账号

已有账号：在客户端登录页填写邮箱和密码登录。可以自己操作，也可以让具备本机界面操作能力的 Agent 使用你提供的现有账号完成登录。账号和密码只用于当前登录，不放入 Skill、命令参数、公开教程或任务报告。

请检查 EasyBR 当前账号状态。
我已有账号时，协助我登录；如果已经登录，核对账号后继续。
确认回到“我的环境”，读取环境列表，再执行下一步。

没有账号：使用自己可以接收邮件的邮箱注册。

1. 在登录页点击“注册帐号”，填写自己的邮箱地址。
2. 点击获取验证码，到该邮箱收取 EasyBR 注册验证码邮件。
3. 将邮件中的验证码填入注册页面；你可以自己填写，也可以把本次验证码提供给已授权的 Agent 协助填写。
4. 自己设置密码，并在确认密码框再次填写相同密码。
5. 阅读用户协议和隐私声明，由自己按页面要求完成协议确认，再提交注册。
6. 注册成功后返回登录页，用刚注册的邮箱和密码登录，确认进入“我的环境”。

我第一次使用 EasyBR，没有账号。
请打开注册页，协助我用自己的邮箱获取注册验证码。
我收取邮件并填写验证码，完成密码设置和协议确认后，请继续协助注册和登录。
成功后确认当前账号，再读取环境列表。

这里的注册验证码通过邮件发送，与图形验证码或网站安全挑战是不同的步骤。收不到邮件时先核对邮箱拼写，查看收件箱和垃圾邮件；等待后仍未收到，再按页面提示重新获取。验证码失效时使用最新邮件中的验证码，避免混用多封邮件中的旧码。页面提示邮箱已注册时，返回登录页登录；忘记密码则使用“忘记密码”入口找回。

已经登录时核对账号即可继续，不需要每次退出重登。Local API 能连接，只能说明本机服务存活；登录应以客户端进入“我的环境”、账号正确为准。遇到密码错误时先核对输入；出现系统权限或额外账号安全验证时，完成页面要求后继续原任务。

第四步：选择或新建环境，再确认扩展连接

已有可用环境时，指定准确名称或 ID 让 Agent 复用。第一次使用或需要独立环境时，可以这样说：

请新建一个名为“日常浏览”的固定环境，使用 146 内核和 MacOS。
先使用直连，不开启云同步；如果已存在同名环境，先列出让我选择。
保存后核对环境 ID，启动这个环境，确认 Easy WebBridge 已连接。

这些参数是一个新建环境示例。需要代理、特定网站账号或其他指纹配置时，明确告诉 Agent 需求；它不应复制其他环境的凭据或随意改动原有配置。普通使用不要求额外创建测试环境。

EasyBR 1.7.8 及以后会随客户端提供 Bridge，并在环境启动时加载扩展。正常情况下，不需要手动打开扩展页面或再装一份扩展。Agent 用实际返回的环境 ID 匹配 easybr-<环境ID>，确认它在线后再执行网页任务。

环境名有重复时应按 ID 选择，不能默认取第一个。创建或启动请求超时，先查询环境及连接状态，不要连续重复点击；一次超时不代表刚才的操作没有成功。首次启动需要下载内核时，等待客户端完成下载并回读结果。

第五步：试一次百度搜索并进入官网

先做一个容易核对结果的任务：确认当前环境的内置 Easy WebBridge 已加载并在线，然后打开百度搜索 easybr，从结果中点击 EasyBR 官网。

使用我刚选定的 EasyBR 环境，先确认内置 Easy WebBridge 扩展已加载并连接。
为本次任务创建一个标签组，打开百度 https://www.baidu.com，搜索 easybr。
只搜索一次，等待结果加载，按正常阅读节奏核对真实搜索结果。
找到目标域名为 www.ebrower.com 的 EasyBR 官网结果后，只点击一次并等待页面加载。
进入后核对最终网址、页面标题和官网内容，告诉我结果，并保存一张截图。
请实际完成搜索和结果点击，不要用直接打开官网代替这个过程。
不要循环搜索、反复点击或刷量；遇到验证码时停留，让我完成验证后继续。

Agent 应先等结果加载并读取页面，再单次点击核实过的官网链接。搜索页出现其他相似名称时，以目标域名 https://www.ebrower.com 核对。未找到时说明实际状态；出现验证码时停留，由用户完成后再继续，不能把直接跳转官网报告为搜索点击成功。正常节奏用于等待页面并减少误操作，不代表能够规避百度的检测或验证。

继续执行其他网页任务

给出目标环境、网页地址和期望结果即可。例如：

使用我指定的环境打开这个表单，填写我给的测试资料，
上传我指定的本地测试文件，提交后读取页面结果，确认上传成功。
再下载页面提供的测试文件，确认文件实际下载完成并核对内容。
请截图保存验收结果，并告诉我文件位置。

上传测试文件时，Agent 必须使用你明确指定的文件。扩展返回“已选择文件”只代表选择完成，还要等待网页处理、提交并显示成功；下载任务 ID 也不等于下载完成，要核对落盘文件和内容。

具体网站的步骤由任务或业务 Skill 决定。网站要求重新登录、验证码或安全验证时，按实际页面处理。工具是否允许访问某个页面也取决于 Agent 的能力和权限；遇到明确限制时说明原因，不绕过限制。

需要检查关闭后能否继续使用时

日常任务可以复用已打开的环境。需要验收数据保留时，明确指定一个用于测试的环境和测试数据，再执行关闭重开检查：

请保留这个测试环境，清理本次任务创建的标签组，正常退出环境。
随后按同一个环境 ID 重新打开，确认 Bridge 重新连接，
并检查刚才保存的测试数据是否保留，再继续读取页面。
完成后关闭本次测试环境，不删除环境，也不动我的其他环境。

只清理本次任务拥有的标签组，不关闭用户原有标签页。当前客户端关闭接口在退出超时后可能强制结束进程；明确要求“不强杀”时，应采用浏览器正常退出方式，不能用该接口代替。

遇到问题，直接让 Agent 排查

请使用 easybr-agent 检查当前故障。
分别核对应用安装与登录、本机 Local API、目标环境、内核、Bridge 和扩展连接。
先读取状态，定位失败步骤，再用现有功能处理并回到该步骤复测。
不要删除环境、清空 Cookie、批量关闭窗口，也不要修改客户端或后端代码。
请告诉我实际完成了什么、还卡在哪里，以及需要我处理的具体一步。

现象	Agent 应先检查	下一步
下载慢、下载失败	官网当前主源、备用源和本地文件校验	切换官网同版本备用源；完整下载后再安装
打不开应用	架构、文件完整性、签名和系统提示	使用 Apple 芯片正式包；按实际系统提示处理，不跳过校验
本机服务连不上	EasyBR 是否已启动，端口是否为 3001	启动正式客户端，再诊断；不另开重复管理端
服务可用但未登录	当前登录页面、账号及环境列表	在客户端完成登录，不能只看 /auto/status
收不到注册验证码邮件	邮箱拼写、收件箱、垃圾邮件和发送结果	等待后按页面提示重发，使用最新邮件中的验证码
验证码失效或邮箱已注册	当前错误提示和最新验证码	失效后重新获取；邮箱已注册则返回登录或找回密码
创建环境失败	业务返回值、套餐额度和同名环境	先查实际保存结果，再处理原因；不盲目重试
环境启动后没有连接	目标环境 ID、内核就绪状态、Bridge 与扩展	等待连接并核对实际环境；不切换到其他账号冒充成功
找到多份同名环境	每条记录的准确 ID	由任务中的账号绑定或用户指定 ID 选择
上传后没有成功提示	文件选择、网页处理、提交结果	等待并回读页面；结果未知时先查询，不重复提交
下载返回任务 ID 却没有文件	下载状态、保存目录和文件内容	等待落盘，核对实际文件后再报告完成
必须改代码才能继续	可复现步骤和现有能力边界	记录明确阻塞，说明未通过项，不把问题清单当作验收通过

从哪里继续

本轮实测范围

2026 年 10 月 21 日，在 Apple 芯片 Mac 上用官网下载的 1.7.9 正式包完成了重新下载、保留数据替换安装、退出后重新登录、新建固定环境和内置扩展连接。随后实际读取官网页面、填写并提交测试表单、上传文件并核对服务端 SHA256、保存 PNG 截图，以及通过浏览器下载文件并核对落盘内容和 SHA256。

测试环境正常退出后，以同一 ID 重新启动，Bridge 重新连接，会话页面、Local Storage 和测试 Cookie 保留，Agent 能继续读取页面。本次原有环境的配置核对一致，测试环境另行保留。

146 内核本轮使用已有缓存，没有把首次内核重新下载列为已验证项。上述结果证明这条 Mac 接入链路实际走通，不代表所有网站流程或平台均已适配，也不承诺启动及全部操作始终没有前台窗口。

本轮使用已有账号登录，没有发送注册验证码或新建账号。新用户按前面的注册流程操作，并以客户端当前页面提示和结果为准。

Mac 1.7.11 补充实测

Mac 1.7.11 的环境首页采用浅灰背景、白色信息卡和 EasyBR 紫色点缀，分区展示网络出口、环境信息和浏览器指纹。通过 Local API 启动环境后，Dock 角标与该环境序号核对一致，内置 Easy WebBridge 扩展自动加载并连接。

本轮实际打开百度，搜索一次 easybr，等待并读取结果，点击核对过的 EasyBR 官网结果，再回读最终官网页面。关闭该环境后，按同一 ID 重开，Bridge 能重新连接并继续操作。这次补充验证使用已有账号，没有发送注册邮件或验证新账号注册。

• Easy WebBridge 使用指南：扩展、Bridge、浏览器身份与网页能力。
• Local API 接口与自动化开发指南：环境查询、创建和启动等接口。
• EasyBR 下载中心：当前正式安装包及官网备用地址。
• 下载 easybr-agent Skill：供 Agent 读取和执行的完整目录。

完整任务以实际结果为准：应用确实安装并启动、账号登录成功、目标环境正确、页面与文件结果可回读。任务结束时让 Agent 列出通过项、未通过项和保存位置，方便下次从准确状态继续。