v2.1.0.1

v2.1.0.1 - Browser Runtime, MCP and Cookie Persistence

中文发行说明

BroSDK v2.1.0.1 聚焦多环境浏览器运行时、统一 MCP Agent 接入、Cookie 持久化兼容性和发布产物一致性。该版本保留全局 MCP 与单环境 MCP 两种入口，适合桌面宿主、浏览器侧边栏和本机 AI Agent 使用。

Highlights

• 多环境浏览器启动与关闭链路进一步收敛到真实并发模型，减少环境之间的队列阻塞和状态串扰。
• 全局 MCP /sdk/v1/mcp 提供统一入口，浏览器工具通过 env.* 调用并要求显式传入 envId；单环境 /sdk/v1/mcp/env/{envId} 继续保留，适用于环境内侧边栏和单环境助手。
• Cookie OSS 新增 v2 加密对象格式，并保留旧 v1、明文导入和 Chromium Cookie 数据库的读取兼容路径。
• 统一 DLL、MCP serverInfo.version 和发布压缩包中的产品版本，避免构建产物版本漂移。

浏览器运行时与生命周期

• 优化多环境同时启动、关闭和 SDK 停止期间的运行时调度、CDP reactor、bridge 连接和任务收敛。
• 改进浏览器启动阶段的 Cookie/Storage 恢复和失败诊断；兼容性恢复问题可以以降级状态呈现，避免把可继续运行的浏览器误报为普通启动失败。
• 强化 libuv CDP 与 libuv bridge 的连接、回调和队列处理，降低初始连接丢包、目标状态短暂不一致和关闭期间竞态导致的误判。
• 改进代理 bridge 对 Chromium 代理参数、系统代理探测和最终路由的诊断摘要，保留敏感信息脱敏边界。

MCP 与 AI Agent

• 全局 MCP 继续提供环境列表、环境生命周期、任务查询、健康检查和浏览器工具路由；envId 必须按十进制字符串传递，避免 JavaScript 大整数精度损失。
• 单环境 MCP 继续可用，默认页面工具覆盖 tabs、tab_groups、navigate、snapshot、diff、act、download、upload、read、grep、screenshot、pdf、wait、windows、evaluate 和 run 等能力。实际工具和参数以 tools/list 为准。
• 页面观察默认使用 CDP Accessibility Tree；仅在显式要求或 AX 不可用时使用只读 DOM fallback。页面交互优先使用原生 CDP 输入，减少对网页的侵入。
• snapshot、navigate 和 act 的页面句柄契约更加明确：page 绑定环境和页面，ref 绑定当前 document identity；导航、刷新或 document 替换后旧 ref 必须重新观察。
• 支持稳定的页面观察身份、受限 stale ref 重新解析和 session 级 diff/artifact 隔离，避免多个 Agent 互相推进对方的观察游标。
• 导航成功后可尽力返回新的 snapshot、controls 和 document 信息；结果不可用时，Agent 应重新调用 snapshot，不得猜测旧 ref。
• 全局 browser.open、browser.close 等异步管理操作继续通过 task.get 查询终态；MCP 工具调用的成功受理不等于浏览器操作已经完成。
• 扩展不是基础页面操作的前置条件。窗口、标签组、书签、历史和统一浏览器状态等扩展能力仍要求 BroSDK 启动时加载匹配的 MCP Bridge 扩展。