# image-excel-extractor-electron

**Repository Path**: Adnois/image-excel-extractor-electron

## Basic Information

- **Project Name**: image-excel-extractor-electron
- **Description**: 一个使用 AI 视觉模型进行 OCR 识别并导出到 Excel 的桌面应用程序。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-16
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: ocr

## README

# 图片批量识别导出工具 (Electron 版)

一个使用 AI 视觉模型进行 OCR 识别并导出到 Excel 的桌面应用程序。

## 功能特点

- 🖼️ 批量选择图片或整个文件夹
- 🤖 支持多种 AI 服务商（OpenAI、Claude、通义千问、DeepSeek、自定义）
- 📊 自动提取图片文字信息并导出 Excel
- 💾 配置本地保存，一次配置永久使用
- 🎨 现代化 UI 界面

## 技术栈

- **Electron** - 跨平台桌面应用框架
- **React 18** - 前端 UI 框架
- **TypeScript** - 类型安全
- **Tailwind CSS** - 样式框架
- **XLSX** - Excel 文件生成
- **electron-store** - 本地配置存储

## 开发

```bash
# 安装依赖
npm install

# 开发模式（同时启动 Vite 和 Electron）
npm run electron:dev
```

## 构建 Windows 安装包

### 在 Windows 上构建

```bash
# 方式一：使用批处理脚本
build-windows.bat

# 方式二：手动构建
npm install
npm run build
npx electron-builder --win --x64
```

### 在 macOS 上为 Windows 构建

需要安装 Wine：

```bash
brew install --cask wine-stable
npm run electron:build:win
```

构建完成后，安装包位于 `dist-electron` 目录。

## 配置 AI 服务

1. 点击右上角 ⚙️ 设置按钮
2. 选择 AI 服务商
3. 输入 API Key
4. 选择模型
5. 保存配置

### 支持的服务商

| 服务商 | 模型 | API 地址 |
|--------|------|----------|
| OpenAI | GPT-4o, GPT-4o Mini, GPT-4 Turbo | https://api.openai.com/v1 |
| Anthropic | Claude 3.5 Sonnet, Claude 3.5 Haiku | https://api.anthropic.com/v1 |
| 通义千问 | Qwen-VL Max, Qwen2.5-VL | https://dashscope.aliyuncs.com/compatible-mode/v1 |
| DeepSeek | DeepSeek-VL3, DeepSeek-Chat | https://api.deepseek.com/v1 |
| 自定义 | 任意 OpenAI 兼容模型 | 自定义 |

## 使用方法

1. **选择图片**：点击"选择图片"或"选择文件夹"添加要识别的图片
2. **开始识别**：点击"开始批量识别"按钮
3. **查看结果**：切换到"结果导出"标签页查看识别结果
4. **选择字段**：勾选需要导出的字段
5. **导出 Excel**：点击"导出 Excel"保存结果

## 项目结构

```
image-excel-extractor-electron/
├── src/
│   ├── main.js          # Electron 主进程
│   ├── preload.js       # 预加载脚本
│   ├── ai-service.js    # AI 服务调用模块
│   ├── App.tsx          # React 主组件
│   ├── main.tsx         # React 入口
│   ├── types.ts         # TypeScript 类型定义
│   └── index.css        # 样式文件
├── public/
│   └── icon.svg         # 应用图标
├── package.json         # 项目配置
├── vite.config.ts       # Vite 配置
├── tailwind.config.js   # Tailwind 配置
└── build-windows.bat    # Windows 构建脚本
```

## 与 Tauri 版本的区别

| 特性 | Electron 版 | Tauri 版 |
|------|-------------|----------|
| 安装包大小 | ~150MB | ~15MB |
| 内存占用 | 较高 | 较低 |
| 开发门槛 | 较低 | 较高 (需要 Rust) |
| 跨平台 | Windows/Mac/Linux | Windows/Mac/Linux |
| 原生 API | 通过 Node.js | 通过 Rust |

## 许可证

MIT