# antrcp-doc
**Repository Path**: antzou/antrcp-doc
## Basic Information
- **Project Name**: antrcp-doc
- **Description**: 离线批量文档助手。核心功能包括:模板管理、批量生成文档等。
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-12
- **Last Updated**: 2026-07-16
## Categories & Tags
**Categories**: Uncategorized
**Tags**: 模板引擎, 批量生成文档, 邮件合并
## README
antrcp-Doc
### antrcp-Doc 介绍
**中文名:蚂蚁批量文档助手**
> [!TIP]
> **antrcp-Doc** 完全离线的 Word 文档批量生成工具,基于模板 + Excel 数据,一键输出成百上千个个性化文档。所有数据本地处理,无需联网,保障信息安全。
## 项目简介
**antrcp-Doc** 是 [antrcp-Assistant](https://gitee.com/antzou/antrcp-assistant) 的子项目,专注**Word 文档批量生成**。用户只需准备一个 `.docx` 模板(内含 `{{变量名}}`)和一个包含数据的 `.xlsx` 文件,即可快速生成多个或者合并为单个 Word 文档,适用于证书、合同、邀请函、入职通知书、报销单等办公场景。
## 核心功能
| 功能 | 说明 |
| :--- | :--- |
| **模板管理** | 支持导入、删除、重命名 Word 模板;自动提取模板中的变量并预览 |
| **Excel 模板导出** | 根据模板变量自动生成 Excel 列头,用户填写数据即可 |
| **批量生成** | 读取 Excel 每一行数据,替换模板中的变量,生成独立 Word 文件 |
| **自定义文件名** | 支持使用变量定义输出文件名(如 `{姓名}_{学号}.docx`),自动补 `.docx` 后缀 |
| **变量插入助手** | 在文件名规则编辑器中一键插入变量,避免手动输入错误 |
| **邮件合并** | 区域循环可选按指定条数生成多个文档,也可合并为单个文档 |
| **模板预览** | 双击模板即可使用系统默认程序打开,快速检查设计效果 |
- [UI说明](UI.md)
## 变量类型说明
antrcp-Doc 支持以下三种变量类型,您可以在 Word 模板中使用对应的标记来引用数据:
| 变量类型 | 模板语法 | Excel 数据示例 | 说明 |
| :--- | :--- | :--- | :--- |
| **普通变量** | `{{姓名}}` | `张三` | 直接替换为文本内容,支持任意字符串。 |
| **图片变量** | `{{@照片}}` | `D:\photos\avatar.png` | 将指定路径的图片嵌入到文档中(支持 `.png`、`.jpg`、`.bmp` 等格式)。路径需为本地绝对路径。 |
| **数字大写变量** | `{{$金额}}` | `1280.6` | 将小写数字自动转换为中文大写金额(如 `1280.6` → `壹仟贰佰捌拾元陆角整`)。适用于合同、报销单等场景。 |
> 💡 **注意事项**:
> - 变量名(如 `姓名`、`@照片`、`金额`)必须与 Excel 列头**完全一致**(包括大小写和特殊符号)。
> - 图片变量路径中请勿包含中文或特殊字符,以免读取失败。
> - 数字大写变量仅支持纯数字或数字字符串(如 `"1280.6"`),会忽略千分位逗号和货币符号(如 `¥1,280.6` 也可识别)。
## 区块循环
支持**区块循环**语法,用于在一页内生成多份格式相同的区块(例如一张A4纸打印两份报销单),或 全部合并为一个文档。
### 模板语法
在 Word 模板中,使用 `{{?forms}}` 和 `{{/forms}}` 包裹需要循环的区域,内部的变量使用 `{{变量名}}` 格式。
## 典型场景视频演示:
[奖状](https://www.bilibili.com/video/BV1rr7N6hEYY/)、
[证书](https://www.bilibili.com/video/BV17HTs6DECZ/)、
[合同](https://www.bilibili.com/video/BV1gLKQ61ENf/)、
[报销单](https://www.bilibili.com/video/BV1nCTj6eETz/)、
[多联多文档报销单](https://www.bilibili.com/video/BV129TQ6kELZ/)、
[多联单文档报销单](https://www.bilibili.com/video/BV1CLNq6xEBB/)。
## 更新公告
- [更新日志](resources/update/history.md)
## 应用下载
请根据您的需求选择合适的版本:
| 文件类型 | 容量 | 下载链接 | 特点 |
| :--- | :--- | :--- | :--- |
| **7z** | 94MB | [antrcp-doc-4.38.0.20260714-1225-win32.win32.x86_64.7z](https://pan.baidu.com/s/1L4LvNZaJFHlkmsv0cVN8Vw?pwd=twwa) | 高压缩比,推荐使用 7z 解压 |
| **zip** | 114MB | [antrcp-doc-4.38.0.20260714-1225-win32.win32.x86_64.zip](https://pan.baidu.com/s/1xoHrSdWErN9ICxw-RFArcw?pwd=twwa) | 系统自带支持,无需安装额外解压软件 |
> 💡 提示:两个版本内容完全相同,仅压缩格式不同。
## 法律声明
使用本软件即表示您同意以下条款:
1. **合法用途**:不得利用本软件生成虚假合同、公章、政府公文、证明文件等违法内容。
2. **结果自负**:生成文档的准确性、合法性及用途完全由您负责,开发者不承担任何法律责任。
3. **数据安全**:所有处理均在本地离线完成,不会上传任何模板、数据或生成结果。
4. **技术局限**:变量提取基于 Word 模板中的 `{{}}` 标记,请确保模板格式正确;Excel 列头需与变量名完全一致。
> 使用即表示同意上述条款,不同意者请立即停止使用。
## 系列产品
- [[ antrcp-assistant ]](https://gitee.com/antzou/antrcp-assistant):办公助手
- [[ antrcp-dev ]](https://gitee.com/antzou/antrcp-dev):开发者助手
- [[ antrcp-ai ]](https://gitee.com/antzou/antrcp-ai):ai助手
- [[ antrcp-template ]](https://gitee.com/antzou/antrcp-template):模板源码
- [[ antrcp-invoice ]](https://gitee.com/antzou/antrcp-invoice):发票助手
- [[ antrcp-image ]](https://gitee.com/antzou/antrcp-image):图像助手
- [[ antrcp-doc ]](https://gitee.com/antzou/antrcp-doc):批量文档助手
- [[ antrcp-media ]](https://gitee.com/antzou/antrcp-media):影音助手
- [[ antrcp-filehub ]](https://gitee.com/antzou/antrcp-filehub):文件枢纽
---
**antrcp-Doc** – 让文档批量生成更简单、更可靠 🐜