SuperAPI AI 工具集

inspect

通用与其它

查看项目

更新于 10-15 20:07

技能介绍

用途:inspect 用于把自然语言描述的元素(如“hero 里的红按钮”“从上数第三张卡片”)解析为当前预览中的具体 DOM 元素,并定位到源码位置,方便做外科手术式修改,替代内联评论式的元素提及协议。

主要能力:基于快照做匹配,使用视觉与文本启发式,包括角色/标签、文本内容、位置提示、颜色提示、尺寸提示、层级关系;可在有多个候选时列出前三个供选择;确认 UID 后通过脚本取回标签、id、class、文本、data-* 属性和 outerHTML 片段,再用 Grep 在源码 HTML 中查找匹配元素,返回源文件路径与大致行号。若用户同时要求修改,可直接按定位到的行范围执行编辑,否则只报告结果。

使用方式与前置条件:需要 Chrome DevTools MCP 已加载页面(通过 /preview 或 /done),且 .claude/last-snapshot.json 存在(由 /done 生成),否则重新取快照。优先读取 5 分钟内且同 URL 的 last-snapshot.json,否则调用 mcp__chrome-devtools__take_snapshot 获取新树;确认 UID 后用 mcp__chrome-devtools__evaluate_script 取标识信息,再 Grep 源文件,匹配优先级为 id > data-* > 唯一 class 组合 > 文本片段 > outerHTML 子串。

适用场景:在预览页面上做元素级定位与精准编辑,尤其适合需要从自然语言指代映射到源码的场景。

限制:只能解析已成功渲染的元素,不会处理报错组件;使用生成类名的 React 组件(CSS modules)选择器可能无法往返,需用 outerHTML 子串在源码中搜索;shadow DOM 内元素可被快照看到,但 Grep 源码找不到,失败时应提示用户。候选超过三个且视觉无法区分时,应询问用户确认。