68 lines
2.9 KiB
Markdown
68 lines
2.9 KiB
Markdown
# 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 或更高。
|