# smart-ai-xpath

**Repository Path**: Elams/smart-ai-xpath

## Basic Information

- **Project Name**: smart-ai-xpath
- **Description**: 一个强大的Chrome浏览器插件，使用AI技术快速生成XPath表达式，帮助您轻松提取网页中的元素数据。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-08-16
- **Last Updated**: 2026-08-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Smart AI XPath Extractor

一个强大的Chrome浏览器插件，使用AI技术快速生成XPath表达式，帮助您轻松提取网页中的元素数据。

## ✨ 主要功能

### 🎯 核心功能
- **智能XPath生成**：使用AI自动生成XPath表达式，并自动提取浏览器页面中的元素。
- **右键快速提取**：在任何网页上右击即可快速提取元素。
- **多种元素类型**：支持提取文本、链接、图片等不同类型的元素
- **批量下载图片**：一键下载所有提取到的图片链接
- **数据导出**：支持复制和CSV格式导出提取结果

### 🤖 多模型支持
- **OpenAI系列**：GPT-3.5 Turbo, GPT-4o, GPT-4 Turbo
- **Anthropic系列**：Claude 3 Haiku, Claude 3 Sonnet, Claude 3 Opus
- **DeepSeek系列**：DeepSeek Chat, DeepSeek Coder
- **字节跳动系列**：豆包 Pro, 豆包 Lite
- **阿里云系列**：通义千问 Plus, 通义千问 Turbo, 通义千问 Max
- **自定义模型**：支持任何OpenAPI兼容的AI模型

### 🎨 界面特性
- **AI设置**：左上角弹窗设置AI地址、和提取Xpath的类型

![pop_setting.png](imgs/pop_setting.png)
- **右键启动xpath**：右击，点击右键菜单中的"Smart Ai XPath"

![right_menu.png](imgs/right_menu.png)
- **实时预览**：即时显示XPath提取结果

![xpath_page.png](imgs/xpath_page.png)
- **批量操作**：支持全选、复制选中行等批量操作

![copy_buttons.png](imgs/copy_buttons.png)

## 📦 安装步骤

### 方法一：从源码安装（开发者模式）

1. **下载或克隆项目**
   ```bash
   git clone <repository-url>
   cd smart-ai-xpath
   ```

2. **打开Chrome扩展管理页面**
   - 在Chrome浏览器地址栏输入：`chrome://extensions/`
   - 或者点击右上角三点菜单 → 更多工具 → 扩展程序

3. **启用开发者模式**
   - 在扩展程序页面右上角，打开"开发者模式"开关
![打开开发者模式](imgs/image.png)

4. **加载插件**
   - 点击"加载已解压的扩展程序"按钮
   - 选择项目文件夹（包含manifest.json的目录）
   - 插件安装完成！

5. **验证安装**
   - 在扩展程序页面可以看到"Smart AI XPath Extractor"
   - 浏览器工具栏会出现插件图标

### 方法二：打包安装

1. **打包扩展程序**
   - 在`chrome://extensions/`页面，点击"打包扩展程序"
   - 选择项目根目录
   - 生成`.crx`文件

2. **安装打包文件**
   - 将`.crx`文件拖拽到`chrome://extensions/`页面
   - 确认安装即可

## 🚀 使用方法

### 第一步：配置AI模型

1. **打开插件设置**
   - 点击浏览器工具栏中的插件图标
   - 或右击插件图标 → 选项

2. **选择AI模型**
   - 从"模型选择"下拉菜单中选择要使用的AI模型
   - GPT模型：只需输入API Key
   - 其他模型：Base URL会自动填充，只需输入API Key
   - 自定义模型：需要输入Base URL、模型名称和API Key

3. **输入API Key**
   - 在"API Key"输入框中输入您的API密钥
   - 不同模型需要对应提供商的API Key

4. **选择XPath类型**
   - 选择要提取的元素类型：
     - 所有同级文本
     - 所有同级链接
     - 所有同级图片

5. **保存设置**
   - 点击"保存设置"按钮
   - 看到"设置保存成功！"提示即完成配置

### 第二步：提取XPath

1. **在网页上右击**
   - 在任意网页上右击任意位置
   - 选择"Smart AI XPath"菜单项

2. **等待AI生成**
   - 插件会自动分析页面结构
   - 使用AI生成XPath表达式
   - 显示加载面板

3. **查看结果**
   - XPath表达式会自动显示在面板中
   - 自动运行XPath并显示提取结果
   - 可以查看提取到的所有元素

### 第三步：操作数据

1. **复制数据**
   - **复制全部**：点击"复制全部"按钮复制所有结果
   - **复制选中**：勾选需要的行，点击"复制选中"按钮

2. **下载图片**
   - **单个下载**：在结果表格中点击"下载图片"按钮
   - **批量下载**：点击"全部下载图片"按钮下载所有图片

3. **导出CSV**
   - 点击"下载CSV"按钮
   - 将结果导出为CSV文件，可用Excel打开

4. **调整面板**
   - 拖拽标题栏移动面板位置
   - 拖拽右下角调整面板大小

## 🎯 功能特点

### 智能XPath生成
- 自动分析HTML结构
- 使用AI生成最优XPath表达式
- 优先使用id、class等稳定属性
- 自动格式校验和修正

### 元素检测
- 自动识别图片、链接、按钮等元素类型
- 支持文本节点和元素节点
- 智能提取元素属性信息

### 数据操作
- 表格形式展示提取结果
- 支持复选框多选
- 全选/取消全选功能
- 实时更新结果数量

### 用户体验
- 可拖拽和调整大小的面板
- 美观的界面设计
- 实时状态通知
- 错误提示和帮助信息

## ❓ 常见问题

### Q: 插件无法使用？
A: 请检查：
- 是否已配置API Key
- API Key是否有效
- 网络连接是否正常
- 是否已重新加载插件

### Q: XPath生成不准确？
A: 可以尝试：
- 多次尝试
- 选择更具体的元素（以右击点击位置为准）
- 调整XPath类型设置
- 使用不同的AI模型
- 手动编辑生成的XPath

### Q: 图片下载失败？
A: 可能原因：
- 图片URL无效或已过期
- 网络连接问题
- 跨域限制（某些图片无法直接下载）
- 检查浏览器控制台错误信息

### Q: 如何切换AI模型？
A: 
1. 点击插件图标打开设置
2. 从"模型选择"下拉菜单选择新模型
3. 输入对应的API Key
4. 保存设置即可

### Q: 支持哪些浏览器？
A: 目前仅支持Chrome浏览器及基于Chromium的浏览器（如Edge、Brave等）


## 📝 更新日志

### v1.0.0
- 初始版本发布
- 支持多种AI模型
- 智能XPath生成
- 图片批量下载
- 数据导出功能