# document-utils

**Repository Path**: bidding-M/document-utils

## Basic Information

- **Project Name**: document-utils
- **Description**: electron-egg框架搭建的桌面端文档处理工具
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2023-12-07
- **Last Updated**: 2026-06-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: electron-egg, Electron

## README

# document-utils

<h4 align="center">一款桌面端快捷文档处理工具</h4>

## ✨ 特性

### 1. 随机数生成

- 根据输入条件（行数、列数、数据范围）生成随机数并导出到 Excel

### 2. PDF 格式转换

| 功能         | 说明                                |
| ------------ | ----------------------------------- |
| PDF 转 Word  | 提取文本内容，生成 .docx 文件       |
| PDF 转 PPT   | 将 PDF 页面渲染为图片嵌入 PPT       |
| PDF 转 Excel | 提取表格数据写入 Excel              |
| PDF 转 HTML  | 保留文本格式生成 HTML 文档          |
| PDF 转图片   | 每页渲染为图片，支持多页导出为 ZIP  |
| PDF 转文本   | 提取纯文本内容                      |
| PDF 合并     | 合并多个 PDF 文件，支持指定页码范围 |

### 3. 水印添加

| 功能           | 说明                                       |
| -------------- | ------------------------------------------ |
| 图片添加水印   | 支持明水印（文本平铺）和暗水印（像素嵌入） |
| PDF 添加水印   | 向 PDF 页面添加文本水印                    |
| Excel 添加水印 | 向工作表添加水印                           |
| PPT 添加水印   | 添加文本水印                               |
| Word 添加水印  | 添加文本水印                               |
| 视频添加水印   | 使用 WebAV 处理视频水印                    |

---

## 🛠 技术栈

- **桌面框架**: Electron 31 + [electron-egg](https://gitee.com/wallace5303/electron-egg) (ee-core v4)
- **前端**: Vue 3 (Composition API) + TypeScript + Vite
- **UI 组件库**: Element Plus
- **核心库**: pdfjs-dist、pdf-lib、jszip、exceljs、pptxgenjs、@webav/av-cliper
- **存储**: better-sqlite3
- **更新**: electron-updater（自动更新）

---

## 🚀 快速开始

### 环境要求

- Node.js >= 18
- C++ 编译工具链（用于编译 better-sqlite3 原生模块）

### 安装与运行

```bash
# 克隆项目
git clone https://gitee.com/bidding-M/document-utils.git
cd document-utils

# 安装依赖
npm install
cd frontend && npm install && cd ..

# 启动开发模式
npm run dev
```

### 构建打包

```bash
# 完整构建（前端 + Electron + 加密）
npm run build

# 各平台打包
npm run build-w          # Windows x64
npm run build-we         # Windows x64（加密版）
npm run build-m          # macOS Intel
npm run build-m-arm64    # macOS Apple Silicon
npm run build-l          # Linux
```

---

## 📂 项目结构

```
document-utils/
├── electron/            # 主进程代码
│   ├── main.ts          # 应用入口
│   ├── config/          # 窗口、服务等配置
│   ├── controller/      # IPC 控制器
│   ├── service/         # 服务层（数据库、自动更新、系统托盘等）
│   └── preload/         # 预加载脚本
├── frontend/            # 渲染进程（Vue 前端）
│   ├── src/
│   │   ├── components/  # 各功能组件
│   │   ├── hooks/       # 功能核心逻辑
│   │   ├── layout/      # 布局组件
│   │   ├── router/      # 路由
│   │   ├── views/       # 页面
│   │   └── utils/       # 工具函数
│   └── package.json
└── package.json         # 根项目配置
```

---

## 📄 License

[Apache 2.0](LICENSE)