# 图片批量处理工具

**Repository Path**: CC4186666/picture-batch-processor

## Basic Information

- **Project Name**: 图片批量处理工具
- **Description**: 一款强大的桌面图片批量处理工具，支持批量添加文字、蒙版、Excel 数据导入等功能。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-02-05
- **Last Updated**: 2026-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 图片处理工具

## README

# 图片批量处理工具

一款强大的桌面图片批量处理工具，可以给相同宽高的图片对应 Excel 中的字段批量添加文字，支持批量添加文字、蒙版、Excel 数据导入等功能。

![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Platform](https://img.shields.io/badge/platform-Windows-lightgrey.svg)
![Version](https://img.shields.io/badge/version-1.0.9-green.svg)

## ✨ 功能特性

- 📷 **批量图片处理** - 支持同时处理数百张图片
- 📊 **Excel 数据导入** - 自动匹配 Excel 数据到图片
- 🎨 **可视化编辑** - 拖拽调整文字位置，实时预览效果
- 🖼️ **蒙版支持** - 为图片添加水印或装饰层
- 🖼️ **子图片插入** - 画布插入子图片，支持文件夹按名匹配 / Excel 图片列 / 手动指定，可缩放、旋转、镜像翻转
- 💾 **模板系统** - 保存和加载编辑配置
- 🔤 **自定义字体** - 导入和使用自己的字体
- 📦 **灵活导出** - 支持 ZIP 打包或直接导出
- 🔍 **智能搜索** - 快速筛选和管理图片
- ✨ **多选编辑** - 支持 Ctrl+点击、Shift+点击、框选，批量修改属性
- 🎯 **批量对齐** - 多选标签可批量修改对齐方式和最大宽度

## 🚀 快速开始

### 下载安装

从 [Releases](../../releases) 页面下载最新的安装包：

- **图片批量处理_1.0.9_x64-setup.exe** - 安装包（推荐）
- 运行安装程序，按照提示完成安装

### 基本使用

1. **上传图片** - 点击「图片上传」区域，选择要处理的图片
2. **导入 Excel** - 点击「Excel 导入」，选择数据文件并设置文件名列
3. **添加文字** - 双击「字段池」中的字段添加到画布
4. **调整位置** - 拖拽文字到合适位置
5. **导出图片** - 点击「批量导出」选择保存位置和方式

详细使用说明请查看 [用户使用手册](./用户使用手册.md)

## 💻 开发指南

### 环境要求

- **Node.js** >= 18.0.0
- **pnpm** >= 8.0.0
- **Rust** >= 1.70
- **Tauri CLI** >= 2.0

### 安装依赖

```bash
# 克隆项目
git clone https://gitee.com/CC4186666/picture-batch-processor.git
cd picture-batch-processor

# 安装依赖
pnpm install
```

### 开发模式

```bash
# 启动开发服务器
pnpm tauri:dev
```

### 构建打包

```bash
# 构建生产版本
pnpm tauri:build
```

## 🛠️ 技术栈

### 前端

- **React** 19 - UI 框架
- **TypeScript** - 类型安全
- **Vite** - 构建工具
- **Ant Design** 6 - UI 组件库
- **Zustand** - 状态管理
- **XLSX** - Excel 解析
- **JSZip** - ZIP 打包

### 后端

- **Tauri** 2 - 桌面应用框架
- **Rust** - 系统编程语言

## 📁 项目结构

```text
picture-batch-processor/
├── src/                    # 前端源代码
│   ├── components/         # React 组件
│   ├── stores/            # Zustand 状态管理
│   ├── utils/             # 工具函数
│   └── types/             # TypeScript 类型定义
├── src-tauri/             # Tauri 后端代码
│   ├── src/               # Rust 源代码
│   ├── icons/             # 应用图标
│   └── target/            # 编译输出
├── public/                # 静态资源
├── 用户使用手册.md         # 用户文档
└── README.md              # 项目说明
```

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request

## 📝 开发规范

### Git 提交信息

```text
feat: 添加新功能
fix: 修复 bug
docs: 更新文档
style: 代码格式调整
refactor: 重构代码
perf: 性能优化
test: 测试相关
chore: 构建/工具相关
```

### 代码规范

- 使用 ESLint 和 Prettier 格式化代码
- 遵循 TypeScript 最佳实践
- 组件使用函数式组件 + Hooks
- 状态管理使用 Zustand

## 📄 许可证

[MIT License](LICENSE)

## 📝 更新日志

### v1.0.9 (2026-07)

- 🔤 **字间距调整** - 文字标签支持字间距（横排为水平字间距、竖排为字符下边距）
- 📝 **换行避头标点** - 横排自动换行 / 竖排换列时，避头标点自动拉回上行/上列末（符合中文排版规范）
- 🖼️ **子图片表格字段匹配** - 子图片支持 Excel 单元格内嵌图片（WPS DISPIMG + 浮动图片双解析，按文件名列匹配背景图）
- 🖱️ **双击识别图片列** - 字段池双击字段自动识别图片列并添加为子图，无需先导入素材
- 🔒 **子图片锁定长宽比** - 子图片尺寸调整支持锁定长宽比
- 🐛 **缩放手柄命中修复** - 修复小子图 / 画布缩放时手柄难以点中（命中半径方向错误）
- 🐛 **子图片健壮性修复** - 切 Sheet 重选、选错列保护、rawData 失效兜底、空表头列名、相对路径等多项修复

### v1.0.8 (2026-07)

- 🐛 **修复白屏** - 修复子图片功能引入后，旧版模板/项目应用导致白屏的问题（旧数据缺 type 字段未归一化）

### v1.0.7 (2026-06)

- 🔍 **全局缩放与缩略图导航** - 画布支持全局缩放，并提供缩略图快速定位导航
- ✨ **拖手柄缩放字号** - 选中文字标签后，拖拽边角手柄即可直接调整字号
- ✨ **子图片批量插入** - 支持在画布中批量插入子图片
- ✨ **文字竖排** - 文字标签支持竖向排列，属性面板同步优化
- ⚡ **导出优化** - 优化导出时图片标签数据的获取逻辑
- 🐛 **文案优化** - 优化多标签及内部文字对齐相关文案

### v1.0.5 (2026-04)

- ✨ **模板数据填充** - 模板可根据 Excel 数据自动填充并应用标签
- ✨ **模板管理增强** - 模板新增「应用」与「覆盖保存」操作
- 🖼️ **蒙版边框模式** - 蒙版新增边框模式，支持偏移调节
- 🎹 **快捷键帮助面板** - 新增快捷键说明面板，导出过程支持取消
- 🐛 **绘制修正** - 修正坐标取整与文本对齐问题

### v1.0.4 (2026-02)

- ✨ **批量对齐方式** - 多选标签可批量修改内部对齐方式（左/中/右），保持视觉位置不变
- ✨ **批量最大宽度** - 多选标签可批量调整自动换行的最大宽度（maxWidth）
- 🎯 **精确高度计算** - 竖排功能支持多行文字的实际高度计算，对齐更精准
- 🐛 **边界检测优化** - 标签拖拽到边缘自动修正位置
- 🐛 **拖拽性能提升** - 修复拖拽过程中的闪烁问题
- 🎹 **快捷键完善** - 支持 Ctrl+A 全选、Ctrl+C/V 复制粘贴

### v1.0.3 (2026-02)

- ✨ **多选功能** - 支持 Ctrl+点击多选、Shift+点击范围选择、框选
- ✨ **批量编辑** - 多选标签后可批量修改属性（字体、颜色、大小等）
- ✨ **批量拖拽** - 多选标签可一起拖动移动位置
- ✨ **对齐功能** - 支持左/右/居中/顶部/底部/水平垂直等间距对齐
- ✨ **横排竖排** - 快速将多个标签排列成一行或一列
- 🐛 **边界检测** - 标签拖拽到边缘自动修正位置
- 🐛 **拖拽优化** - 修复拖拽过程中的闪烁问题

### v1.0.0 (2026-02)

- 🎉 首次发布

## 🙏 致谢

- [Tauri](https://tauri.app/) - 跨平台桌面应用框架
- [React](https://react.dev/) - UI 框架
- [Ant Design](https://ant.design/) - UI 组件库
- [XLSX](https://github.com/SheetJS/sheetjs) - Excel 处理库

---

**Made with ❤️ by 土豆饼** · v1.0.9