Intuned/selector-forge 源代码：https://github.com/Intuned/selector-forge # Selector Forge

在任意页面上选取一个元素，就能获得一个可靠的选择器——由 AI 生成并评判，然后在您看到之前通过真实 DOM 重新验证。

Selector Forge 是一款独立的浏览器扩展（支持 Chrome 和 Firefox，使用 MV3），帮助您直接从正在查看的页面构建健壮的 CSS 或 XPath 选择器。您只需指向目标元素，扩展与 Intuned（https://intuned.io）的选择器后端会完成其余工作——提出候选方案、在真实页面上测试它们，并丢弃任何无法正确解析的选项。这在编写端到端测试、构建爬虫以及自动化任何可能因脆弱选择器而带来后续问题的页面时非常有用。

安装

• Chrome — Chrome 网上应用店 (https://chromewebstore.google.com/detail/selector-forge-ai-selecto/lbendfnlmhdakbeblajoffkfmafbfaha)
• Firefox — Firefox 附加组件 (https://addons.mozilla.org/en-US/firefox/addon/selector-forge/)

工作原理

1. 打开任意页面，点击扩展图标。
2. 选择一种选择模式，直接在实时页面上选取一个或多个元素。
3. 扩展捕获所选内容的紧凑快照（选中的目标、DOM 上下文、初始候选选择器）并发送到后端。
4. 后端提出并排序候选选择器；扩展针对真实 DOM 测试每个候选，并将结果反馈回去。
5. 此循环重复进行，直到后端确定出最优选择器。
6. 弹出窗口仅展示经过重新验证的选择器，每个都配有复制按钮。

浏览器始终是选择器实际匹配内容的唯一真相来源。AI 负责提出和排序，但绝不拥有对正确性的最终决定权。

信任边界

• 扩展持有选择器创建会话状态——这是循环连续性的来源。
• 浏览器是唯一真相来源——每个结果都必须经过重新验证。
• AI 提出并排序选择器，但不证明正确性。
• 对于列表，验证会检查完整的预期集合，因此过度匹配或不足匹配的选择器都会被拒绝。

详见 ARCHITECTURE.md 了解模块地图、消息层、后台/内容脚本/弹出窗口上下文以及认证和 CLI 接口。

选择模式

开发者快速入门

需要 Node 18+ 和 Yarn。

yarn install # 同时运行 `wxt prepare`
yarn dev     # 监听 + 在 Chrome 中加载 .output/chrome-mv3 （解压后）
yarn dev:firefox # 同样适用于 Firefox

首次运行 yarn dev 后，在 chrome://extensions（开启开发者模式）中加载解压后的扩展，路径为 .output/chrome-mv3。

命令

组件预览（Ladle）

yarn ladle 在隔离环境中提供弹出窗口的 React 组件预览，用于设计和审查——无需重新加载扩展，也无需真实后端。故事文件位于 stories/（*.stories.tsx）；Ladle 配置在 .ladle/ 中。弹出窗口依赖于 WXT 注入的 browser 全局变量，因此 .ladle/wxt-globals.ts 安装了一个无操作桩。yarn ladle:build 会在 dist/ladle 下生成静态包。

测试层次

• 单元测试 — 快速的 Vitest 测试（node/happy-dom），用于选择器逻辑、状态转换、存储和确定性回退。
• 浏览器测试 — Vitest 浏览器模式测试，针对真实 DOM 运行选择器生成，并证明每个候选能精确解析到预期元素集合。这是正确性的判定标准。两个层次都通过 yarn test 运行。
• 端到端测试 — 使用 Playwright 对打包后的 MV3 扩展进行测试，涵盖真实页面、指针操作流程、弹出窗口、内容脚本和后台服务工作进程。通过 yarn e2e 运行。

项目结构

entrypoints/
  background.ts         后台服务工作进程——会话状态、代理循环、网络 I/O
  content.ts            内容脚本——选择器覆盖层、DOM 访问、选择器测试
  popup/                 React 弹出窗口——模式控件、结果、复制操作
lib/
  agent/                代理循环控制器（后端轮询）
  content/              选择器覆盖层、元素注册表、DOM 检查
  background/           处理程序、上下文菜单、会话连接、CLI 桥
  messaging/            类型化、方向分区的运行时消息协议
  state/                会话状态、历史、模式、偏好
  auth/                 认证客户端 + 令牌处理
  graphql/              工作空间 + 使用查询
  config.ts             API 基础地址 + 运行时配置
tests/
  vitest (unit + browser)
e2e/
  playwright against the built extension
ARCHITECTURE.md         模块映射、信任边界、代理循环、接口

基于 WXT (https://wxt.dev) 构建，弹出窗口使用 React。

路线图

• CLI 控制 — 通过 Intuned CLI 驱动扩展：Intuned IDE 支持、本地代理运行端到端测试和自动化任务，以及通过 MCP 暴露功能。（基础连接——tabs 权限和基于 CDP 的会话启动——已就绪。）
• 智能选择工具 — 一种 multiple 模式，允许在一次操作中选择多个元素，由扩展将它们分组为单个项和列表化集合；此外还有 AI 字段检测功能，可自动为页面建议有用的字段、名称和选择器。
• 深入选择模式 — 选择后的精确细化：沿 XPath/DOM 树导航到实际想要的目标（子 span → 按钮 → 行 → 标签 → 父容器），将列表选择移至父级或子级，或添加必要示例、排除错误元素。
• 自带后端 — 目前扩展依赖 Intuned 进行认证和选择器生成。我们计划提供一个轻量级、可自托管的参考后端，能够替换该接口并完全取代 Intuned——包括一个用于生成和评判可靠选择器的开源代理——让您在自己的基础设施上运行完整循环。更远期计划：选择器/自动化历史、导出为 Playwright 或纯 JavaScript、自动分页检测，以及跨 iframe / Shadow DOM 支持。

贡献

欢迎提交 Issue 和 Pull Request。在提交 PR 前，请运行 yarn compile 和 yarn test。

许可证

MIT © The Metrics Shop, Inc.