# MinerU-Batch

**Repository Path**: lliaoliao/miner-u-batch

## Basic Information

- **Project Name**: MinerU-Batch
- **Description**: 基于 [MinerU](https://mineru.net) API 的批量文档解析桌面客户端，支持将 PDF、图片批量提交至 MinerU 云端进行智能解析，自动提取为 Markdown 格式。
- **Primary Language**: Go
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-02-25
- **Last Updated**: 2026-02-26

## Categories & Tags

**Categories**: doc-tools

**Tags**: None

## README

# MinerU-Batch

基于 [MinerU](https://mineru.net) API 的批量文档解析桌面客户端，支持将 PDF、图片批量提交至 MinerU 云端进行智能解析，自动提取为 Markdown 格式。
![输入图片说明](07374260-434c-400e-ae60-115914d59d2e.png)
![输入图片说明](7e464391-1e73-4d86-a951-3af2eb7b3b71.png)
## 功能特性

- **批量上传** — 一次选择多个 PDF / PNG / JPG 文件，批量提交解析
- **文件夹导入** — 直接选择文件夹，自动加载其中所有符合条件的文件
- **实时状态追踪** — 自动轮询解析进度，上传、解析、完成各阶段状态一目了然
- **一键下载** — 解析完成后批量下载结果，自动提取为 `.md` 文件；历史记录支持重新下载
- **历史记录** — 本地 SQLite 持久化存储，仅显示当天批次，支持按文件夹名称快速回溯
- **明暗主题** — 支持明亮 / 暗色模式切换

## 快速运行（已编译版本）

`build/` 目录下为预编译的可执行文件，下载后可直接使用，无需安装 Go 或 Node.js：

```
build/
├── bin/                    # 可执行程序输出目录
│   └── MinerU-Batch.exe    # Windows 64 位主程序
├── appicon.png             # 应用图标源图
├── windows/
│   ├── icon.ico            # Windows 程序图标
│   ├── info.json           # 应用信息（版本、作者等）
│   └── installer/          # Windows 安装包相关资源
├── darwin/                 # macOS 构建资源
└── README.md               # 构建目录说明
```

**Windows 用户**：直接运行 `build/bin/MinerU-Batch.exe` 即可。

## 技术栈

| 层级 | 技术 |
|------|------|
| 桌面框架 | [Wails v2](https://wails.io) |
| 后端语言 | Go 1.24 |
| 前端框架 | Vue 3 + Vue Router |
| UI 组件库 | [TDesign Vue Next](https://tdesign.tencent.com/vue-next) |
| 本地存储 | SQLite ([modernc.org/sqlite](https://pkg.go.dev/modernc.org/sqlite)) |
| 构建工具 | Vite 5 |

## 使用说明

1. **设置 Token** — 在左侧面板输入 MinerU API Token（[点此获取](https://mineru.net/apiManage/token)）
2. **选择文件** — 点击「添加文件」选择单个/多个文件，或点击「选择文件夹」一次性加载整个目录
3. **设置输出目录** — 选择解析结果的保存位置
4. **上传解析** — 点击「上传解析」，等待云端处理完成
5. **下载结果** — 解析完成后点击「下载结果」，Markdown 文件将保存至输出目录

## 从源码构建

### 环境要求

- Go 1.24+
- Node.js 18+
- [Wails CLI](https://wails.io/docs/gettingstarted/installation)

### 安装依赖

```bash
# 安装 Wails CLI（如尚未安装）
go install github.com/wailsapp/wails/v2/cmd/wails@latest

# 安装前端依赖
cd frontend && npm install && cd ..
```

### 开发模式

```bash
wails dev
```

### 构建生产版本

```bash
wails build
```

构建产物输出至 `build/bin/` 目录。

## 项目结构

```
MinerU-Batch/
├── main.go              # 应用入口
├── app.go               # 核心业务逻辑（文件选择、API 调用、上传下载）
├── db.go                # SQLite 数据持久化（历史记录）
├── wails.json           # Wails 项目配置
├── frontend/
│   ├── src/
│   │   ├── App.vue
│   │   └── views/
│   │       └── HomeView.vue   # 主界面
│   └── wailsjs/              # Wails 自动生成的 Go 绑定
└── build/                     # 预编译文件与构建资源（见上文「快速运行」）
```

## 致谢

本项目的核心文档解析能力由 **[MinerU](https://mineru.net)** 提供支持。MinerU 是一款高质量的智能文档解析服务，具备强大的 PDF 结构化提取和 OCR 识别能力，能够将复杂的文档精准转换为结构化的 Markdown 格式。感谢 MinerU 团队为开发者提供了稳定、高效的 API 服务，使本工具的开发成为可能。

> MinerU 官网：[https://mineru.net](https://mineru.net)
>
> MinerU 开源项目：[https://github.com/opendatalab/MinerU](https://github.com/opendatalab/MinerU)

## 许可证

[MIT License](LICENSE.md)

## 作者

**zhangxingyu** — [lliaoliao@126.com](mailto:lliaoliao@126.com)