feat: 完善字体包发行与 Docker 内置字体

deploy/README.md

@@ -74,11 +74,11 @@ docker compose -f deploy\compose.yaml up -d
 3 套标书主题；挂载目录只用于额外的本机扩展主题，无需重复
 放置内置主题。内置主题与挂载主题 ID 重复时以内置版本为准。
 
-## 可选字体包挂载
+## 内置字体包
 
-Compose 默认将项目的 `.local/font-packs` 只读挂载到容器中的
-`/app/.local/font-packs`。目录为空或不存在字体包时，应用仍可正常启动，
-Preview、PDF 和 DOCX 会使用主题原有字体安全降级。
+v0.6.0 的发行镜像固定将受校验字体包内置到
+`/app/.local/font-packs`。Compose 不挂载宿主机字体目录，因此部署端
+无需额外复制字体，Preview、PDF 和 DOCX 可以离线使用同一套原生资产。
 
 字体包使用固定目录结构：
 
@@ -91,36 +91,29 @@ Preview、PDF 和 DOCX 会使用主题原有字体安全降级。
         └── fonts/
 ```
 
-从仓库外准备好冻结字体源后，可以构建并挂载项目字体包：
+从源码构建镜像前，先从仓库外冻结源生成字体包，再构建镜像：
 
 ```powershell
 npm run build:font-pack
-$env:MD_TO_PDF_FONT_PACK_DIR = (Resolve-Path 'output\font-packs\root').Path
 docker compose -f deploy\compose.yaml up -d
 ```
 
-也可以将完整字体包根目录复制到 `.local/font-packs`，直接使用默认配置。
-字体包目录以 `:ro` 挂载，容器内非 root 用户不能修改宿主机资产；清单、
-许可、文件类型、路径边界、容量和 SHA-256 仍会由运行时注册器再次校验。
-字体包缺失、版本不兼容或资源损坏不会阻断 PDF/DOCX 主链，只会产生诊断
-并回退到主题字体。
+字体二进制仍不提交到 Git。Docker 构建上下文只放行本次生成的
+`output/font-packs/root`，镜像构建会在缺少清单时立即失败。运行时注册器
+仍会复核许可证、文件类型、路径边界、容量和 SHA-256。更换字体包内容时
+必须提升字体包 SemVer 并重新构建镜像，不能覆盖同一个版本。
 
-可选字体包二进制位于被 Git 和 Docker 构建上下文忽略的目录，既不提交到
-仓库，也不打入应用镜像。更换字体包版本后重启容器即可重新发现；不要在
-同一个 `<pack-id>/<semver>` 目录中覆盖不同内容。
-
-发布前可以对已经构建好的镜像执行真实字体包矩阵：
+发布前执行真实内置字体门禁：
 
 ```powershell
 $env:MD_TO_PDF_IMAGE = 'yixiong/md-to-pdf:v0.6.0'
-$env:MD_TO_PDF_FONT_PACK_DIR = (Resolve-Path 'output\font-packs\root').Path
 npm run verify:docker-font-pack
 ```
 
-该命令要求本机 Docker 引擎已经启动，镜像已经存在，并且字体包已通过
-`npm run build:font-pack` 生成。验收会依次挂载空目录、有效字体包和篡改
-字体包，检查只读挂载、健康状态、Pandoc capability、WOFF2 资源、DOCX
-字体部件和损坏后的安全降级；所有临时容器、网络和目录会在结束时清理。
+该命令要求本机 Docker 引擎已经启动，并且冻结字体源可供
+`npm run build:font-pack` 生成。验收会重建指定镜像，核对镜像内清单哈希、
+确认不存在字体运行时挂载，并检查健康状态、Pandoc capability、WOFF2
+资源和 DOCX 字体部件；所有临时容器、网络和目录会在结束时清理。
 
 ## 运行参数
 
@@ -131,7 +124,6 @@ npm run verify:docker-font-pack
 | `MD_TO_PDF_REUSE_PLAYWRIGHT_RUNTIME` | `0` | 是否复用基础镜像中的 Chromium |
 | `MD_TO_PDF_PORT` | `8080` | 宿主机监听端口 |
 | `MD_TO_PDF_THEME_DIR` | `../.local/themes` | 宿主机主题目录 |
-| `MD_TO_PDF_FONT_PACK_DIR` | `../.local/font-packs` | 宿主机可选字体包根目录 |
 | `MD_TO_PDF_APP_VERSION` | `0.6.0` | 字体包兼容性判断使用的应用版本 |
 | `PDF_CONCURRENCY` | `1` | 同时执行的 PDF 任务数 |
 | `PDF_MAX_QUEUE` | `4` | 等待队列上限 |