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

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

2025-07-09 04:38:10作者:魏侃纯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处理逻辑,项目架构变得更加清晰和可扩展。

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

热门内容推荐

项目优选

收起
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
713
459
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
143
226
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
306
1.04 K
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
105
161
HarmonyOS-ExamplesHarmonyOS-Examples
本仓将收集和展示仓颉鸿蒙应用示例代码,欢迎大家投稿,在仓颉鸿蒙社区展现你的妙趣设计!
Cangjie
367
357
leetcodeleetcode
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer(第 2 版)》、《程序员面试金典(第 6 版)》题解
Java
53
15
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
116
255
CangjieCommunityCangjieCommunity
为仓颉编程语言开发者打造活跃、开放、高质量的社区环境
Markdown
1.02 K
0
CangjieMagicCangjieMagic
基于仓颉编程语言构建的 LLM Agent 开发框架,其主要特点包括:Agent DSL、支持 MCP 协议,支持模块化调用,支持任务智能规划。
Cangjie
591
47
MateChatMateChat
前端智能化场景解决方案UI库,轻松构建你的AI应用,我们将持续完善更新,欢迎你的使用与建议。 官网地址:https://matechat.gitcode.com
706
97