Pinar
首页方案新功能帮助
登录
⌘ K

快速开始捕获与图钉AI 智能体项目与集合云与套餐隐私与数据
快速开始
捕获与图钉
元素、区域、整页和 iframe 捕获图钉、评论和颜色捕获整页智能定位器与 DOM 选择遮盖敏感区域复制、查看并重新打开捕获
AI 智能体
项目与集合
云与套餐
隐私与数据
帮助/捕获与图钉

智能定位器与 DOM 选择

了解页面变化后图钉如何跟随元素,以及 Pinar 何时会要求手动放置。

5 分钟
示意图: 智能选择会勾出光标下的元素,便于在钉住前用方向键遍历 DOM。

本指南内容

  1. 1稳健指纹
  2. 2置信度与歧义
  3. 3选择器回退与竞争匹配
1

稳健指纹

元素图钉会组合稳定选择器、DOM 路径、标签、id、名称、测试 id、角色、类名、文本、标签和几何信息。重新打开时,Pinar 会评估选择器、结构、语义和几何,而不是只信任一条脆弱路径。

2

置信度与歧义

匹配可以是精确、可能、歧义或未解析。当两个候选项过于相似时,Pinar 会保留备选,而不是把图钉吸附到错误元素。跨源 iframe 目标可能保持未解析。

3

选择器回退与竞争匹配

捕获时,Pinar 优先使用能通过 id、data-testid 或 data-test,或标签加名称唯一匹配节点的选择器。如果这些都不唯一,它会改为存储结构化 CSS 路径。看起来像生成的类名会从指纹中去掉,以免哈希后的 CSS 模块成为唯一信号。

重新打开时,来自稳定选择器、结构、语义和几何策略的候选项会合并并排序。精确置信度需要高分的稳定选择器或结构命中;语义和几何匹配保持为可能。当前两个可行分数相差不到很窄的边距时,结果为歧义,不会选定任何元素。

  • 当其他节点共享相同标签、文本和类名时,位置性 :nth-of-type 选择器得分更低。
  • 区域图钉在作为元素目标时会被拒绝,并在定位器评分期间保持未解析。
  • 当 iframe 的内容文档不可读时,重定位会以跨源 frame 警告停止,而不是猜测。
还需要更多背景?查看该分类全部内容

本页内容

稳健指纹置信度与歧义选择器回退与竞争匹配
支持 Fair Source 开发

想直接支持公开源码开发?可在 GitHub 赞助或请我们喝杯咖啡。

请我喝咖啡在 GitHub 赞助
Pinar·© 2026·Pinar v0.3.6
Terms of ServicePrivacy Policy