# Fonts 目录

## 说明

本目录存放 Deep Research 系统生成 PDF 报告所需的中文字体。
**所有字体文件均通过 `.gitignore` 排除**，不会进入 git 版本库，以避免仓库体积膨胀（~140MB）。

## 快速开始

首次使用时，运行：

```bash
bash .opencode/templates/fonts/download-fonts.sh
```

脚本会自动从官方 GitHub 下载以下字体：

| 文件 | 字体名 | 用途 |
|---|---|---|
| `SourceHanSerifSC-Regular.otf` | 思源宋体 Regular | 正文 |
| `SourceHanSerifSC-Bold.otf` | 思源宋体 Bold | 正文粗体/术语 |
| `SourceHanSansSC-Light.otf` | 思源黑体 Light | 页眉页脚 |
| `SourceHanSansSC-Medium.otf` | 思源黑体 Medium | 三级标题、图表 |
| `SourceHanSansSC-Bold.otf` | 思源黑体 Bold | 一二级标题 |
| `SourceHanSansSC-Heavy.otf` | 思源黑体 Heavy | 封面大标题 |
| `LXGWWenKai-Regular.ttf` | 霞鹜文楷 Regular | 摘要、引文、批注 |

## 许可证

全部字体为 **SIL Open Font License 1.1**，可自由商用、嵌入 PDF 分发。

- 思源宋体 / 思源黑体：© Adobe Systems Incorporated + Google，SIL OFL 1.1
- 霞鹜文楷：© LXGW（基于台北黑体和 Klee One 修改），SIL OFL 1.1

## 手动下载（脚本失败时的备用方案）

如果 `download-fonts.sh` 因网络问题失败，请手动从官方 Release 下载并放入本目录：

- **思源宋体**：https://github.com/adobe-fonts/source-han-serif/releases
  - 取 `SubsetOTF/CN/` 路径下的 `SourceHanSerifCN-Regular.otf` 和 `SourceHanSerifCN-Bold.otf`
  - 放入本目录并重命名为 `SourceHanSerifSC-Regular.otf` 和 `SourceHanSerifSC-Bold.otf`

- **思源黑体**：https://github.com/adobe-fonts/source-han-sans/releases
  - 取 `SubsetOTF/CN/` 路径下的 Light / Medium / Bold / Heavy 四个字重
  - 放入本目录并重命名（CN → SC）

- **霞鹜文楷**：https://github.com/lxgw/LxgwWenKai/releases
  - 取最新版 `LXGWWenKai-Regular.ttf` 放入本目录（无需改名）

## 常见问题

### Q: 下载速度慢 / 失败
A: 国内网络访问 GitHub 可能不稳定。`download-fonts.sh` 会自动尝试镜像。仍失败可手动从国内字体镜像下载（注意认证版本号一致）。

### Q: 为什么不用系统自带的苹方/微软雅黑？
A: 这两个字体许可**禁止嵌入 PDF 分发**。用思源系列（SIL OFL）可无限制嵌入，报告传给客户/团队不会有许可问题。

### Q: 字体文件可以入 git 吗？
A: 不推荐。140MB 会严重拖慢 git 操作。目前策略是 `.gitignore` + `download-fonts.sh` 按需下载。

### Q: 我已经有字体文件了，在别的路径
A: 有两种选择：
  1. 直接 `cp / ln -s` 到本目录
  2. 调用 `report-template.py` 时用 `--fonts-dir /path/to/your/fonts`

### Q: 字体版本会影响渲染吗？
A: 思源字体 v2.x 之后字形基本稳定。霞鹜文楷不同版本字形有微调，建议锁定到 v1.330 或更高。
