v3.0.12

简体中文 | English

浏览器管理

• 新增浏览器时，Provider 提供的字段标题、说明、占位提示和选项会跟随界面语言。数字输入框也可以显示占位提示。
• Provider 可以指定摘要行展示的标识，并为详情字段提供翻译。要看到 EgoLite、Brow、Bumble 和 AgentBay 的新文案，请同时更新扩展和对应 Provider。

App 模拟

• 网页右键菜单会根据当前标签页状态显示「开启端模拟」或「关闭端模拟」。
• 首次启用带设备外壳的端模拟时，页面可以在第一次刷新时进入设备外壳。

完整变更

v3.0.11

简体中文 | English

浏览器控制

• 本地 CDP 未绑定控制会话的普通新开页可并行导航，慢页加载期间仍可读取和截图其他标签页。新开的标签页会报告导航状态。文档可读时返回 ready，导航回执超时时返回 pending，调用方可用同一个 tabId 检查后续状态。
• 修复鼠标和触控拖动逐次累加回执延迟的问题。回执慢时会跳过过期的中间移动点，仍尝试到达终点并释放输入。
• 本地托管 Chrome 关闭时取消未派发任务，确认浏览器退出后发送关闭回执。脚本的总截止时间也会传给本地宿主，排队动作超时后不会派发，未能返回给调用方的新控制会话会释放标签页占用。

扩展与官网

• 工具箱可以先打开已缓存的工具，并在新版本可用时提示刷新。浏览器列表减少短暂加载造成的界面闪动。
• 更新官网的安装和使用指引。扩展离线 ZIP 下载地址取自官网的更新配置。

完整变更

v3.0.10

简体中文 | English

设备外壳

• 修复外部浏览器 Provider 在空白页启用 App 模拟和设备外壳时，等待根 WebView 超时的问题。空白页先准备配置，首次导航进入 HTTP 页面后再等待业务 WebView。
• 保留已有 HTTP 页切换外壳时的刷新行为；业务 WebView 缺失时仍明确报错，不将后续业务操作转到外层页面。
• Ego Provider 内置宿主代码，需要更新到包含本次宿主修复的 Provider 版本才能生效。

MCP 配置

• 配置向导新增 OpenCode v1/v2、Pi 和 DeepSeek Harness 支持。
• 更新和卸载保留其他服务、设置及 JSONC/YAML 注释；损坏配置会明确报错并保留原文件。安装或重新配置遇到已有远程 Mearl 条目时，同样报错并保留原文件。

扩展账户

• 修复授予权限后账户信息未恢复加载的问题。

完整变更

v3.0.9

简体中文 | English

安装引导

• 首次安装时优先探测构建配置指定的欢迎页，网络可达时打开该页面，失败或超时后回退到公网欢迎页。探测不再依赖目标网站的 Manifest 主机权限。
• 本地构建支持 .env.local 配置欢迎页；发布构建读取同名 GitHub 仓库变量。

更新与发布

• 扩展、CLI 检查和稳定版 setup 从 GitHub Pages 读取更新配置；发布成功后自动刷新网站配置，不受商店提审结果影响。
• beta setup 直接下载与自身版本一致的扩展 ZIP；显式指定更新配置源的用法保持有效。
• Release 仅附带扩展 ZIP 和许可证，不再生成 config.json、toolbox.json 附件。依赖旧 Release 配置地址的客户端需升级。
• 移除扩展对 github.com 和 release-assets.githubusercontent.com 的常驻主机权限。

完整变更

v3.0.8

简体中文 | English

安装与配置

• 无交互终端时，安装命令自动采用默认项，无需额外传入 --yes；交互终端仍显示安装提示。非交互卸载仍需显式确认参数。
• 修复 --skip-skill 对 preset 选择的影响：保留独立管理的 Skill，同时正常安装 preset 及其声明的托管资源。
• Agent 服务弹窗根据浏览器 preset 提供对应的安装指引；微信应用配置的安装入口与文档统一使用 mearlhq/profile-wechat。

浏览器与命令行

• 新用户初始化配置时自动载入内置查询预设。
• 内部操作命令支持显示帮助，便于查询参数和用法。

完整变更

v3.0.7

简体中文 | English

浏览器控制

• 接管与交还统一使用 mearl browser_control --browser <browserId>。普通浏览器自动选择唯一的未结束会话；有多个会话时通过 tabId 或 --session 明确目标。
• 外部 Provider 可声明接管、交还和结束任务能力。Ego 的 Space 生命周期通过统一命令操作，支持结束时保留指定结果页，无需独立 mearl-ego 命令。
• 更新 CLI、MCP 和官网的控制说明。Ego 统一控制需要 @mearl/provider-ego 0.1.1+ 和 Mearl 3.0.7+。

完整变更

v3.0.6

简体中文 | English

新增

• 支持发现和调用网页声明的 WebMCP 工具，并为 bb-browser 站点适配器提供工具面板。
• 扩展设置支持管理能力预设，完善工具安装与权限设置流程。
• 为独立 Ego Provider 提供原生页面宿主，支持页面操作、设备外壳、根 WebView 和已安装 App 的协议与授权服务。
• Provider 可声明宿主浏览器的 macOS Bundle ID，让该浏览器配置的扩展 Agent 接入默认关闭。用户可手动覆盖，偏好不跨浏览器同步；离线或移除 Provider 不会自动重新开启。
• 增加 pnpm dev:link，支持构建并链接本地 CLI 包供源码开发使用。

修复与兼容性

• 协调握手完成前阻止 Agent 接入；关闭后，文件上传、批量页面动作和登录态复制同样受开关约束。管理连接仍可用于安装和设置。
• 宿主请求随控制权撤销而中止，避免交还后继续处理过期授权；策略通过变更事件更新，不新增定时轮询。
• Ego 使用独立 provider-ego，移除 mearl-ego Skill，并更新官网中英文指南。启用自动协调需更新扩展和 Native Host，再重新注册 Provider。

完整变更

v3.0.5

简体中文 | English

改进

• 优化扩展弹窗和侧边栏中的 Agent 对话操作，让打开侧边栏、发送消息和换行的快捷键更容易找到。
• 改进官网的安装指引和文档导航，并在团队安装指引可访问时显示直达入口。

修复

• 在点击、输入或触发下载前恢复被冻结的后台页面，避免操作一直等待页面响应。
• 标签页的控制登记和释放不再等待图标更新，避免被冻结的页面阻塞这些操作。

完整变更

v3.0.4

简体中文 | English

版本重点

自定义官网和产品官网使用同一套 Preset 安装流程，扩展集中展示所需站点权限。

修复

• 自定义安装页和产品安装页统一从同源目录读取 Preset，用户在扩展内确认后启用能力。
• 安装和更新时复用状态正常的受管理插件，跳过重复安装。显式查询安装状态仍提供 JSON 输出。
• 将能力需要的站点权限集中在授权提示中，方便一次核对所需域名。

升级与兼容性

• 运行 npx @mearl/setup@3.0.4 安装，或运行 npx @mearl/setup@3.0.4 update 更新本机组件。使用配套的安装页和扩展。

完整变更

v3.0.3

简体中文 | English

版本重点

官网引导页改为由用户主动启用 Preset，所需授权在扩展内完成。

变更

• 打开引导页时会检查当前所选 Preset 的状态。点击启用后，扩展打开安装页供用户继续操作。
• 欢迎页直接探测配置的 HTTPS 自定义官网地址。部署者通过 MEARL_INSTALLATION_CONFIG 提供安装目录 JSON。
• 更新 Chrome 扩展的中英文产品说明。

修复

• 嵌入式安装按钮省去重复的 Preset 名称，让引导页上的选择和按钮更清楚。

升级与兼容性

• 运行 npx @mearl/setup@3.0.3 安装，或运行 npx @mearl/setup@3.0.3 update 更新本机组件。使用配套的引导页和扩展。

完整变更