snapshot before v0.5 refactor

.opencode/templates/fonts/README.md

@@ -0,0 +1,67 @@
+# 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 或更高。