deep_research/platform_adapters/opencode/templates/fonts

Fonts 目录

说明

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

快速开始

首次使用时，运行：

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 或更高。