Works

Xpath-helper-X 是一款面向 RPA 开发与自动化测试的 Chrome 扩展，基于开源 xpath-helper-plus 进行二次开发与定制，整合 Vue3 + Vite + Element Plus 的 Side Panel 工作台，简化 XPath 编写、验证与批量提取流程。

← 返回作品列表

Xpath-helper-X

当前版本 v1.0.26
更新日期 2026-09-04
安装包大小 50.4 KB（51,620 字节），文件名 xpath-helper-x-v1.0.26.zip
SHA256 校验 7b5d159642602f8ed2856ca7344ed49347c39d267d86c88e2dff610cc7e41fa5
浏览器要求 Chrome 116 及以上版本（MV3 / Side Panel）
授权方式 免费使用；上游基于 Apache-2.0 开源协议，禁止商业转售
界面语言 简体中文 / 英文（跟随 Chrome UI 语言，可手动切换）
更新日志 前往 Gitee 发行版页面查看更新日志 ↗，或查看仓库 提交记录 ↗
发行版下载 查看Gitee源码 ↗
下载说明

本扩展未上架 Chrome 应用商店。推荐从 Gitee 发行版页面 ↗ 下载 v1.0.26 构建产物压缩包 xpath-helper-x-v1.0.26.zip（50.4 KB），解压到本地目录后，在 Chrome 的 chrome://extensions/ 页面以「加载已解压的扩展程序」方式导入。具体步骤见下方「安装部署」页签。

反馈与联系

使用中遇到问题或有改进建议，欢迎通过 联系页面 或邮件 lxdfox@qq.com 反馈，也可以在 Gitee 仓库提交 Issue。反馈时请附 Chrome 版本号与问题截图。

软件介绍

Xpath-helper-X 是一款面向 RPA 开发与自动化测试的 Chrome 扩展。开发者在网页上编写 XPath 时，常面临表达式冗长、易随页面变动而失效、调试效率低等问题；本扩展将编辑器、拾取器与实时验证整合在 Chrome 原生 Side Panel 中，支持一键生成、自动精简、列表模式与跨 frame 提取，显著提升定位效率，是 RPA 流程开发、爬虫元素定位与 UI 自动化测试场景下的得力帮手。

免责说明

本项目基于开源 xpath-helper-plus（Apache-2.0 协议）进行二次开发，本人为非职业开发者，仅在业余时间维护；扩展由 AI 与人工协同完成开发，使用过程中遇到问题欢迎反馈。

适用场景

面向 RPA 流程开发、爬虫元素定位、UI 自动化测试与前端调试等需要大量 XPath 编写的场景。

  • RPA 流程开发在八爪鱼 RPA / Playwright / Selenium 等自动化脚本中编写稳定可靠的元素定位表达式
  • 爬虫元素定位在数据采集类爬虫项目中快速生成与对比不同结构的 XPath，挑选稳定性最高的版本
  • UI 自动化测试测试用例中编写/调试 XPath 时实时验证匹配元素数量、位置与属性
  • 前端调试在浏览器中直接评估 XPath 表达式，用于排查渲染结果、批量提取字段值
  • 跨 frame 提取支持同源/跨源 iframe，在子 frame 内拾取，结果回到主面板统一管理

安装步骤

本扩展未上架 Chrome 应用商店，可通过 Gitee 发行版获取构建产物后手动加载，全程约 2 分钟，无需后端服务。

  1. 下载构建产物 打开 v1.0.26 发行版页面 ↗，下载附件 xpath-helper-x-v1.0.26.zip（50.4 KB，SHA256 见「基本信息」表格）。
  2. 解压到本地目录 将压缩包解压到一个固定目录（建议不要放在桌面或临时目录，避免误删导致扩展失效）。
  3. 打开 Chrome 扩展页 在地址栏输入 chrome://extensions/ 并回车，进入扩展管理页面，开启右上角的「开发者模式」。
  4. 加载已解压的扩展 点击「加载已解压的扩展程序」，选择上一步解压得到的目录（内含 manifest.json）即可完成安装。

界面与核心功能

一、Side Panel 工作台

基于 Chrome 原生 Side Panel 实现的常驻工作台。点击工具栏的扩展图标或按下 Alt+Shift+X 唤出侧边栏，左侧是 XPath 编辑器与查询历史，右侧是实时匹配结果与匹配元素数量；侧边栏与页面并列显示，编辑与验证互不遮挡，调试效率明显优于注入式弹窗。

Xpath-helper-X 软件主界面

二、元素拾取与一键生成

按住 Shift 键并将鼠标悬停到目标元素上，扩展会自动从当前元素向上查找 ID、稳定属性、class 等锚点，生成最短、可用且唯一的 XPath，并回填到 Side Panel 编辑器。生成的 XPath 会自动剔除 active、hover、is-open 等运行时状态 class，显著降低后续维护成本。

小贴士

开启「列表模式」可让生成的 XPath 匹配同类元素集合，适合批量字段提取；Side Panel 顶部按钮可一键复制当前 XPath，或将其转换为 CSS 选择器后再复制。

元素拾取 · Shift 悬停生成 XPath 并高亮匹配

三、实时查询与结果高亮

在编辑器中输入或调整 XPath，匹配节点数量与结果立即刷新；命中元素会在页面上短暂高亮显示，便于核对是否正确。需批量提取时，可在「列表模式」下查看所有匹配元素的文本与属性抽样，对比不同 XPath 的稳定性。

四、跨 frame 与快捷键

支持同源与跨源 iframe 内的元素拾取与求值：在子 frame 内按 Shift 拾取后，操作会自动路由回产生查询的同一标签页与 frame，结果统一汇集到 Side Panel。常用快捷键如下，也可前往 chrome://extensions/shortcuts 自定义。

Alt+Shift+X 打开/关闭 Side Panel（可在 chrome://extensions/shortcuts 自定义）
Shift+点击/悬停 页面元素拾取：自动生成 XPath 并回填到编辑器
编辑器内输入 实时验证：编辑即求值，匹配数量与结果立即刷新
Esc 退出元素拾取状态
说明

Chrome 内部页面（如 chrome://）与 Chrome 应用商店等受限页面不允许注入内容脚本，侧边栏在这些页面会显示「不可用」状态。

运行时依赖与第三方组件

Xpath-helper-X 在开发期与运行期依赖以下开源组件（按用途分组）。所有组件均遵循其原始开源许可协议，版权归各自作者所有。本项目上游 xpath-helper-plus 遵循 Apache License 2.0。此处仅作使用声明与致谢，组件清单可能随版本迭代调整。

运行时依赖（dependencies）

组件版本主要用途
Vue^3.2.25Side Panel / UI 框架
VueUse Core^12.8.2组合式工具集（响应式、存储等）
xpath-to-css^1.1.0XPath 转 CSS 选择器

开发期依赖（devDependencies）

组件版本主要用途
Vite^6.4.3构建工具 / Dev Server
@vitejs/plugin-vue^5.2.4Vite 的 Vue SFC 支持
TypeScript~5.9.3类型系统
vue-tsc~2.2.12Vue + TS 类型检查
unplugin-auto-import^20.3.0Vue API 自动按需引入
unplugin-vue-components^30.0.0组件按需引入
UnoCSS^66.8.1原子化 CSS 引擎
vite-plugin-crx-reload（上游内置）Chrome 扩展热更新
rollup-plugin-copy（上游内置）静态资产拷贝到 extension/
Vitest^3.2.7单元测试
@types/chrome^0.2.7Chrome API 类型定义
@types/node^20.19.43Node.js 环境类型定义
jsdom^26.1.0测试用 DOM 模拟
ESLint + @antfu/eslint-config^9.34.0 / ^4.19.0代码风格统一
提示

上表仅列出主要依赖，开发构建还会引入 Vite 自身的若干传递依赖（如 Rollup、esbuild、chokidar、kolorist 等）。组件清单可能随上游升级而调整，实际以 package.json 与构建输出为准。

已知限制

为避免使用预期与实际不符，现将当前版本的能力边界如实列出。以下限制会随上游与本项目的迭代逐步改善。

  • 仅支持 Chrome 系浏览器MV3 / Side Panel API 当前仅在 Chrome 116+ 与部分基于 Chromium 的浏览器中可用，Edge / Brave 等基于 Chromium 的浏览器需对应版本支持
  • 受限页面无法使用Chrome 内部页面（chrome://）、Chrome 应用商店等受限页面不允许注入内容脚本，扩展在这些页面显示不可用状态
  • 未上架应用商店本扩展未发布到 Chrome 应用商店，需从 Gitee 发行版 ↗ 获取构建产物后以「加载已解压的扩展程序」方式安装；浏览器更新或目录被移动时可能需要重新加载
  • 维护节奏不固定作者非职业开发者，仅利用业余时间维护；问题响应、Bug 修复与版本发布周期无法承诺时效
← 返回作品列表