用途:cluso-inspector 是一个可视化元素选择器,用于从网页中提取 HTML、截图和上下文信息。当 AI 代理需要确认用户所指的具体元素、文字描述无法说清、或经过两次以上尝试仍无法定位或修复问题时,可借助它让用户直接点选目标元素。
主要能力:运行后返回 JSON 输出,包含 screenshotPath(PNG 文件路径,可用 Read 工具查看)、html(元素的 outerHTML)、selector(CSS 选择器路径)、bounds(元素位置与尺寸)以及 stateClasses(提取的 hover/active/focus/disabled 状态)。截图带有垂直上下文,包含上方标题和下方按钮,便于理解布局与样式关系。
使用方式:执行 npx cluso-inspector <url>,其中 url 为页面地址,通常是 http://localhost:PORT,也可以是任意 URL。命令会打开 Electron 窗口加载目标页面,用户悬停时显示双重覆盖层(蓝色为截图区域,紫色为元素),点击即可选择,随后检查器捕获并返回 JSON 给代理。
适用场景:需要澄清用户所指元素、用户主动表示要展示某物、视觉调试、反复讨论 UI 元素仍存在困惑,或需要理解视觉上下文(布局、样式、元素关系)时。
限制:资料未提供关于收费、价格、平台支持范围、浏览器兼容性或性能表现的说明,暂未提供。使用前需确保本地具备运行 npx 与 Electron 的环境。