
React Grab 快速指南从页面元素到源码行一次复制到位【免费下载链接】react-grabCopy any UI element for your agent项目地址: https://gitcode.com/GitHub_Trending/re/react-grab你让 AI 智能体修一个按钮它却要在几百个文件里自己猜组件在哪React Grab 改变这个流程在浏览器里悬停任意界面元素按复制快捷键元素本体连同源文件、行号就进了剪贴板。它面向 Next.js、Vite、Webpack、TanStack Start 四类 React 项目的开发环境官方基准测试显示智能体配合它工作可快约 2 倍。 谁用得上谁用不上React Grab 是一座选取桥梁把浏览器里的鼠标选取翻译成智能体能读懂的源码上下文。它只在开发环境生效CLI 会自动识别框架并往框架入口文件写入一段仅开发时加载的注入。目前 CLI 支持四种框架Next.jsApp Router 与 Pages Router 均可、Vite、Webpack、TanStack Start。适合谁日常和 AI 智能体结对开发前端需要精准指出就是这个按钮的人受够了智能体找不到组件、反复来回确认的团队想先冻结页面再慢慢选元素的人它能让动画停住、让 React 的状态更新排队不适合谁生产环境的最终用户它不随生产构建发布线上页面看不到任何痕迹Remix、Astro、SvelteKit、Gatsby 项目CLI 目前不会为它们做自动配置非 React 项目它靠 React 的内部结构定位组件主要服务 React 技术栈⚠️ 开工前自查清单运行安装命令前逐项过一遍Node 环境Node.js 18 及以上命令通过 npx 执行无需预装任何东西框架项目属于上述四种之一monorepo 先切到具体 app 目录再操作开发服务器React Grab 只在开发环境注入先启动 dev server 再打开页面包管理器CLI 自动识别当前包管理器并装上react-grab包入口文件init 会改动一个框架入口文件如app/layout.tsx或src/main.tsx跑完看一眼改动快捷键默认复制快捷键是 ⌘C / CtrlC和浏览器习惯冲突的话后面可用 configure 命令换按键✅ 从安装到复制成功的 5 步在项目根目录的终端运行npx grablatest init确认它识别出的框架与将要修改的文件按提示完成启动开发服务器用浏览器打开应用页面指针悬停到目标元素上按 ⌘C / CtrlC 复制验证效果粘贴到任意文本编辑器应是一行元素 所属组件 源码位置末尾形如components/login-form.tsx:46:19。把这行交给智能体让它打开该文件的该行如果精准落在你选中的组件上配置完成。它凭什么找到源码选中元素时React Grab 先把页面冻住临时接管 React 内部的状态调度器让更新排队暂停 CSS、SVG 与 Web Animations 动画并把悬停样式原样拍快照你挑元素时屏幕纹丝不动。退出选取后一切自动恢复。它不改你的业务代码不动服务端与网络请求也不会注入生产构建。找文件的路径分两步先靠 bippy一个读取 React 内部结构的库从 DOM 元素反查到组件树React 19 及以上直接读调试栈更早版本则回溯重建组件层级再拉取打包产物附带的 source map把打包后第几行翻译回源文件第几行。Next.js 服务端组件的虚拟地址则交给开发服务器的符号化端点翻译。打个比方它像查验集装箱的报关员。页面展示的是打包压缩后的成品React Grab 对着装箱单source map查出每个零件来自哪个工厂、哪条流水线。代码结构速览核心编排在 core/index.tsx激活状态机、事件监听、插件分发都在这一个文件里方便追踪完整流程复制、评论、在编辑器中打开三个内置动作都是插件放在 src/core/plugins/外部动作按同一条注册路径接入冻结逻辑React 更新冻结、动画冻结、悬停样式快照集中在 src/utils/一个文件管一件事覆盖层 UI 用 SolidJS 编写通过动态 import 懒加载渲染层即使失败也不影响选取功能CLI 的检测与安装逻辑在 packages/cli/架构全文可看 docs/architecture.mdReact 或 Next.js 升级、内部结构变化时需要适配的通常就是调度器、调试栈、source map 这几处解析逻辑选取与安装的主流程不动。失败自查表现象可能原因处理方法init 报 unknown-framework没认出项目框架确认属于四种受支持框架monorepo 需切到具体 app 目录init 报 unsupported-frameworkRemix/Astro/SvelteKit/Gatsby 暂不支持等待官方更新或参照 README 的手动接入方式打开页面完全没反应非开发模式或入口未注入确认启动的是 dev server手动接入时检查开发限定注入是否写进入口文件复制出的位置指向打包文件source map 不可用检查开发服务器是否产出 source mapNext.js 服务端组件需 dev server 在线复制卡在 Grabbing… 不动开发服务器连接池打满0.1.48 已修复把react-grab升到最新版复制快捷键没反应按键冲突或激活模式不匹配用 configure 命令换按键并选择按压或长按模式像用顺手工具一样用它它只在开发环境存在生产构建不带痕迹最终用户无感复制出的上下文含项目文件路径与组件结构别原样贴到公开渠道覆盖层会短暂接管键盘事件与页面样式退出选取自动还原页面表现怪异时刷新即可复位React、Next.js 大版本更新后若解析失效跟随项目更新升级React Grab 的定位很克制开发时按需启用把智能体指到准确的那一行用完即无痕迹。想让智能体读懂你的页面给它这张地图就够了。【免费下载链接】react-grabCopy any UI element for your agent项目地址: https://gitcode.com/GitHub_Trending/re/react-grab创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考