file-starter/INSTALLATION_GUIDE.md

Word文档合并功能安装指南

系统要求

1. LibreOffice安装（必需）

PDF转Word功能需要系统安装LibreOffice：

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install libreoffice

CentOS/RHEL:

sudo yum install libreoffice

macOS:

brew install libreoffice

Windows: 从 LibreOffice官网 下载并安装

2. Node.js依赖安装

等待当前npm安装完成后，继续安装剩余依赖：

# 如果pdf-lib安装完成，继续安装其他依赖
npm install pdf-merger-js
npm install html-pdf-node
npm install libreoffice-convert

或者一次性安装所有依赖：

npm install pdf-lib pdf-merger-js html-pdf-node libreoffice-convert

验证安装

验证LibreOffice安装

# 检查LibreOffice是否安装成功
libreoffice --version

验证Node.js依赖

# 检查所有依赖是否安装成功
npm list pdf-lib pdf-merger-js html-pdf-node libreoffice-convert

配置说明

临时文件目录

文档处理服务会在系统临时目录创建文件：

• 默认路径: /tmp/document-processing/
• 处理完成后会自动清理

文件大小限制

• 默认支持最大10MB的Word文档
• 可通过修改代码调整限制

故障排除

常见问题

1. LibreOffice未找到

   # 检查安装路径
   which libreoffice
   

2. 依赖安装失败

   # 清理缓存重试
   npm cache clean --force
   npm install
   

3. 权限问题

   # 确保有写入临时目录的权限
   chmod 777 /tmp/document-processing/
   

测试功能

安装完成后，可以通过以下步骤测试功能：

1. 启动开发服务器：

   npm run dev
   

2. 访问管理后台：http://localhost:8080/admin/word-merge

3. 上传多个Word文档进行测试

生产环境部署

Docker部署

需要在Dockerfile中添加LibreOffice安装：

# 基于Ubuntu的示例
FROM ubuntu:20.04

# 安装LibreOffice
RUN apt-get update && \
    apt-get install -y libreoffice && \
    apt-get clean

# 其他Node.js环境配置...

系统要求

• 内存: 至少2GB RAM（处理大文档时需要更多）
• 磁盘空间: 至少500MB可用空间
• CPU: 推荐多核处理器

性能优化建议

1. 增加内存限制：处理大文档时可能需要调整Node.js内存限制
2. 并发控制：限制同时处理的文档数量
3. 缓存优化：使用Redis缓存处理结果
4. 文件清理：定期清理临时文件

支持格式

输入格式

• ✅ Microsoft Word (.doc, .docx)
• ✅ 其他格式可通过扩展支持

输出格式

• ✅ PDF (.pdf)
• ✅ Microsoft Word (.docx)

联系方式

如遇安装或使用问题，请参考：

1. 查看详细文档：docs/word-merge-feature.md
2. 检查系统日志
3. 联系技术支持