YSbrowser SDK 0.11.0

配套 YSbrowser 定制浏览器的 Windows Python SDK，支持同步/异步调用、Context 配置、代理、状态保存和模型鼠标操作。

• 完整使用手册（含代码高亮与全文搜索）
• drag_element 每个参数和返回结构

安装

pip install ysbrowser-sdk
python -m ysbrowser_sdk install

Python >= 3.10；依赖 Patchright 1.64.2、NumPy 和 ONNX Runtime。默认下载内置的 YSBrowser 6.2；需要其他版本时，可用 --url 显式指定压缩包直链。浏览器默认安装到当前目录的 ./browsers，下载压缩包在解压完成后删除。推理不需要 PyTorch。

使用

from ysbrowser_sdk.sync_api import YSBrowser

with YSBrowser(headless=False) as browser:
    context = browser.new_context()
    page = context.new_page()
    page.set_content('<button style="position:absolute;left:700px;top:300px">目标</button>')
    mouse = context.mouse(page)
    result = mouse.move_between(100, 200, 500, 300)
    result = mouse.click_element(page.get_by_role("button", name="目标"))
    print(result.plan.model_id, result.plan.data_source)

异步代码从 ysbrowser_sdk.async_api 导入，在浏览器操作前加 await。

• 鼠标完整 API
• Context 与代理
• Context 参数及诊断
• 代理切换
• A 点到 B 点的可运行示例
• 拖动示例

鼠标使用随包条件 Flow Matching Transformer。move()、move_to() 为绝对坐标，move_by() 为相对距离，move_between() 指定起终点。省略 duration_s 自动预测运动时长。原生 page.mouse 和 Locator 保持原生调用方式，模型操作通过 context.mouse(page) 使用。