首页
/ Tarsier项目中的无OCR纯DOM元素标记方案解析

Tarsier项目中的无OCR纯DOM元素标记方案解析

2025-07-09 01:53:33作者:魏侃纯Zoe

在自动化测试和网页交互领域,Tarsier项目提供了一个创新的解决方案。近期社区讨论中,开发者提出了一个关键需求:如何在不依赖OCR技术的情况下,仅通过DOM元素信息实现网页元素的标记和交互。本文将深入解析这一技术方案及其实现原理。

需求背景

传统网页自动化工具通常需要结合视觉识别(OCR)和DOM分析两种技术。但在某些场景下,开发者只需要:

  1. 获取页面DOM结构
  2. 标记可交互元素
  3. 通过LLM模型决策交互流程

这种纯DOM方案的优势在于:

  • 避免OCR服务依赖
  • 减少计算资源消耗
  • 提高执行速度

技术实现演进

项目维护者通过issue讨论明确了两种实现路径:

  1. 初始解决方案
    开发者通过创建虚拟的OCR服务凭证(fake service_account.json)来绕过强制OCR校验,但这属于临时方案。

  2. 正式解决方案
    在v0.6.33版本中引入了DummyOCRService:

from tarsier import Tarsier, DummyOCRService
tarsier = Tarsier(DummyOCRService())
screenshot, tag_to_xpath = await tarsier.page_to_image(page)

核心工作机制

该方案的技术实现包含以下关键点:

  1. 元素标记系统
  • 自动为DOM元素生成唯一标签
  • 建立标签与XPath的映射关系
  • 保留元素层级结构和交互属性
  1. 轻量化处理
  • 跳过图像处理和文字识别环节
  • 直接输出空白截图占位符
  • 专注于DOM结构分析
  1. LLM集成接口
    生成的tag_to_xpath映射可直接提供给大语言模型:
  • 模型根据任务描述选择操作目标
  • 通过标签反查具体DOM元素
  • 执行点击、输入等交互指令

应用场景建议

这种方案特别适合以下场景:

  1. 结构化页面测试
    对元素位置固定的管理系统、后台页面等,DOM结构比视觉特征更可靠。

  2. 低代码自动化
    结合LLM实现自然语言驱动的自动化流程,如"点击登录按钮"等简单指令。

  3. 资源受限环境
    在无法使用OCR服务或需要快速执行的场景下提供替代方案。

注意事项

开发者需要注意:

  • 动态生成的内容可能导致XPath不稳定
  • 纯DOM方案无法处理Canvas等非标准元素
  • 需要确保页面完全加载后再执行标记

这种技术方案为Tarsier项目提供了更灵活的使用方式,体现了开源项目响应社区需求的敏捷性。通过分离OCR和DOM处理逻辑,项目架构变得更加清晰和可扩展。

登录后查看全文
热门项目推荐

热门内容推荐

最新内容推荐

项目优选

收起
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
178
262
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
867
513
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
129
183
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
265
305
HarmonyOS-ExamplesHarmonyOS-Examples
本仓将收集和展示仓颉鸿蒙应用示例代码,欢迎大家投稿,在仓颉鸿蒙社区展现你的妙趣设计!
Cangjie
398
371
CangjieCommunityCangjieCommunity
为仓颉编程语言开发者打造活跃、开放、高质量的社区环境
Markdown
1.07 K
0
ShopXO开源商城ShopXO开源商城
🔥🔥🔥ShopXO企业级免费开源商城系统,可视化DIY拖拽装修、包含PC、H5、多端小程序(微信+支付宝+百度+头条&抖音+QQ+快手)、APP、多仓库、多商户、多门店、IM客服、进销存,遵循MIT开源协议发布、基于ThinkPHP8框架研发
JavaScript
93
15
note-gennote-gen
一款跨平台的 Markdown AI 笔记软件,致力于使用 AI 建立记录和写作的桥梁。
TSX
83
4
cherry-studiocherry-studio
🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端
TypeScript
598
57
GitNextGitNext
基于可以运行在OpenHarmony的git,提供git客户端操作能力
ArkTS
10
3