# Word文档合并功能安装指南

## 系统要求

### 1. LibreOffice安装（必需）
PDF转Word功能需要系统安装LibreOffice：

**Ubuntu/Debian:**
```bash
sudo apt-get update
sudo apt-get install libreoffice
```

**CentOS/RHEL:**
```bash
sudo yum install libreoffice
```

**macOS:**
```bash
brew install libreoffice
```

**Windows:**
从 [LibreOffice官网](https://www.libreoffice.org/download/download-libreoffice/) 下载并安装

### 2. Node.js依赖安装
等待当前npm安装完成后，继续安装剩余依赖：

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

或者一次性安装所有依赖：
```bash
npm install pdf-lib pdf-merger-js html-pdf-node libreoffice-convert
```

## 验证安装

### 验证LibreOffice安装
```bash
# 检查LibreOffice是否安装成功
libreoffice --version
```

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

## 配置说明

### 临时文件目录
文档处理服务会在系统临时目录创建文件：
- 默认路径: `/tmp/document-processing/`
- 处理完成后会自动清理

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

## 故障排除

### 常见问题

1. **LibreOffice未找到**
   ```bash
   # 检查安装路径
   which libreoffice
   ```

2. **依赖安装失败**
   ```bash
   # 清理缓存重试
   npm cache clean --force
   npm install
   ```

3. **权限问题**
   ```bash
   # 确保有写入临时目录的权限
   chmod 777 /tmp/document-processing/
   ```

## 测试功能

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

1. 启动开发服务器：
   ```bash
   npm run dev
   ```

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

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

## 生产环境部署

### Docker部署
需要在Dockerfile中添加LibreOffice安装：

```dockerfile
# 基于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. 联系技术支持