xbrowser

xbrowser — browser automation CLI with plugin system, CDP driver, recording/replay, viewer/captcha interaction, and marketplace publishing. Use when: developing xbrowser plugins, writing/modifying .xcli/plugins/, publishing plugins to marketplace, building/testing xbrowser core, debugging CDP connections, recording/replaying browser flows, implementing login/captcha handling, adding new commands, understanding project architecture, writing plugin tests. Triggers: "xbrowser plugin", "plugin convention", "marketplace publish", "xbrowser dev", "xbrowser development", "xbrowser build/test", "plugin contract", "result schema", "loginConfig", "requiresLogin", "CDP driver", "xbrowser viewer", "preview", "captcha", "recording", "replay", "plugin test", "open url", "XBROWSER_CDP", "XBROWSER_SESSION".

文件上传自动化决策树与实战经验。CDP 模式下 Playwright 的 setInputFiles 受限， 而且生产站点（豆包等）有 CDP Firewall 检测合成事件，el.click() 会被拦截。 核心经验：用 page.mouse.click 真实鼠标事件 + setInputFiles + DataTransfer 注入， 完全绕过系统文件选择框。 Use when: 写插件 handler 涉及"上传文件"（图片、附件、参考图、头像、媒体等）； 录制器抓到 file input 但 playback 失败；CDP 模式 setInputFiles 报 "not a function" 或 querySelector 错误；上传后页面跳转到 about:blank。 Triggers: "upload file", "上传文件", "set input files", "file chooser", "drag drop", "参考图", "附件", "avatar upload", "image attachment", "Input.dispatchDragEvent", "DataTransfer", "file input hidden", "CDP Firewall", "isTrusted", "el.click 失败".