技能介绍

要解决的问题

大多数浏览器自动化方案需要独立启动一个浏览器实例，这意味着你要重新登录各种网站、重建书签和浏览历史。当你的日常工作已经围绕某个浏览器展开时，这种割裂感尤其明显。另一个常见痛点是现代 SPA 应用——React、Vue、Angular 渲染的页面里，简单的 el.click() 往往无法触发真正的交互逻辑，按钮点了没反应是家常便饭。

工作原理

这个技能通过 Chrome DevTools Protocol（CDP）连接到你已经在使用的 Brave 浏览器，端口固定为 9222。它不会启动、重启或关闭浏览器——所有生命周期管理都交给你手动完成。

连接建立后，你可以通过 cdp_exec.py 执行一系列操作：

list 查看当前标签页，open 打开新页面
eval 执行 JavaScript 提取页面内容（优先使用，避免修改状态）
interact 使用 CDP 原生鼠标事件进行点击，生成的事件带有 isTrusted=true，能绕过部分反爬虫检测
type 输入文本，支持人类化逐字输入模式

对于 SPA 点击失效的问题，click-smart 命令提供了一套多策略自动回退机制：

编辑器同步——点击前先同步富文本编辑器状态（CKEditor、Lexical、ProseMirror 等）
命中检测——确保元素可见且未被遮挡
CDP 原生点击——完整的鼠标事件序列
React Fiber 调用——直接触发 React 的 onClick 处理器
Vue emit 调用——遍历组件树触发事件
dispatchEvent——派发原生 MouseEvent
Enter 键提交——表单按钮的兜底方案

适用边界

这个技能的前提是 Brave 浏览器已经以 --remote-debugging-port=9222 启动。如果端口未响应，它会提示你手动开启，而不是尝试自动启动。

多个 agent 可以同时 attach 到同一个浏览器实例，共享所有登录状态。但要注意，它不是万能的——对于需要图形界面交互、浏览器扩展操作或跨浏览器场景的任务，它并不适用。此外，反检测能力有限，遇到严格的验证码或行为分析系统仍需人工介入。

截图预览

使用场景

你日常用 Brave 浏览器登录了多个内容平台，需要自动在掘金发布文章但发布按钮 CDP 点击无效，用 click-smart 自动尝试 Vue 框架事件触发。
需要从小红书等反爬虫网站采集数据或执行操作，用 interact 模拟真实鼠标事件绕过 JS 检测，同时保留登录状态。
需要批量操作已登录的编辑器平台（CSDN、阿里云开发者社区），用 editor-sync 先同步富文本内容再触发发布按钮。
需要在 React/Vue 渲染的 SPA 页面自动填写表单或点击提交，但标准点击无效，用 click-smart 的 6 种策略自动回退找到可行方案。