# PDF 中文字体离线文件下载记录

## 保存路径确认

- 实施记录保存路径：`docs/reports/implementation/2026-05-11-pdf-font-offline-download.md`
- 离线字体文件保存路径：`deploy/fonts/wqy-microhei.ttc`

## 背景

生产环境无法在线安装中文字体包，需要提前准备 PDF 导出使用的中文字体文件，保证生产配置项 `ccdi.report.pdf-font-path` 指向的字体可以离线放置。

## 修改内容

- 新增离线字体文件：`deploy/fonts/wqy-microhei.ttc`
- 字体来源：Debian 官方包源 `fonts-wqy-microhei_0.2.0-beta-4_all.deb`
- 从离线包中提取路径：`usr/share/fonts/truetype/wqy/wqy-microhei.ttc`

## 生产放置方式

生产服务器解压或上传后，将字体放到配置指定路径：

```bash
sudo mkdir -p /usr/share/fonts/truetype/wqy
sudo cp wqy-microhei.ttc /usr/share/fonts/truetype/wqy/wqy-microhei.ttc
sudo chmod 644 /usr/share/fonts/truetype/wqy/wqy-microhei.ttc
```

如果服务器存在 `fc-cache`，可执行：

```bash
sudo fc-cache -fv
```

## 验证记录

- 文件大小：约 4.9M
- 文件类型：TrueType font collection data
- SHA256：

```text
2420e8078af796b19a3f6ef13de527a1a91c1e7171eea115926c614ced1009b3
```

