SkyJourney
01b06abc2c
新增能力：14 套主题按纵横方向与五组页边距组成的 140 场景视觉矩阵全部通过，封面执行整页严格门禁，正文执行分页无关的语义块门禁。 问题修复：统一 CSS 到 WordprocessingML 的通用翻译，修复字体嵌入、中文标点字距、精确行距、打印媒体与行内代码连续性，不包含按主题 ID 的特调。 发行变化：Desktop 安装器与免安装 ZIP 直接内置 Serif、Sans、Mono 三套字体包；NSIS 移除字体选择和伴随安装逻辑，不再发布独立字体安装器或字体 ZIP。正式附件收敛为 Desktop 安装器、Desktop ZIP、Docker 离线镜像、Web 部署包和发行说明。 部署兼容：Docker 镜像 md-to-pdf:v0.6.1 使用完整无缓存路径构建，固定 Chromium、Pandoc 3.9.0.2 和三套内置字体包；支持覆盖安装 v0.6.0，Windows 安装器保持未签名的内部发布状态。 验证结果：116 个测试文件、616 项测试、全项目类型检查、生产构建和 git diff --check 全部通过；140/140 视觉矩阵阻断失败和诊断失败均为 0；源码服务、Docker Web API 与实际安装 Desktop 的 DOCX 字体嵌入链路均通过。
4.0 KiB
内置字体包集合构建
本目录保存字体包配方、许可证、来源说明和正式冻结字体资产。字体二进制
位于固定的 font-packs/assets/，统一由 Git LFS 管理，普通 Git 对象只保存
LFS 指针。Desktop 安装版、便携版和 Docker 镜像都直接包含本次受校验的
完整字体包集合，不再依赖用户另行安装字体附件。
源目录
正式发布字体必须先完成许可证、来源、内部字族名、嵌入权限和哈希审查， 随后固定存放在以下版本化仓库目录：
font-packs/assets/mdtp-serif-sc/1.0.0/
├── MdTPSerifSC-Regular.ttf
├── MdTPSerifSC-Regular.woff2
├── MdTPSerifSC-Bold.ttf
└── MdTPSerifSC-Bold.woff2
font-packs/assets/mdtp-sans-sc/1.0.0/
├── MdTPSansSC-Regular.ttf
├── MdTPSansSC-Regular.woff2
├── MdTPSansSC-Bold.ttf
└── MdTPSansSC-Bold.woff2
font-packs/assets/mdtp-mono/1.0.0/
├── MdTPMono-Regular.ttf
├── MdTPMono-Regular.woff2
├── MdTPMono-Bold.ttf
└── MdTPMono-Bold.woff2
该目录中的 ttf/otf/woff/woff2 由 .gitattributes 强制使用 Git LFS。
构建器不会联网下载或自动替换字体。派生字体通过
font-packs/scripts/build-noto-static.py 从来源说明固定的 Noto CJK
可变字体生成；每个发行输入文件都必须与配方声明的
字节数和 SHA-256 完全一致；TTF 还必须是无需运行时规范化的原生静态
TrueType，并具有可安装或可编辑的文档嵌入权限。
构建与验证
npm run build:font-pack
npm run verify:font-pack
克隆仓库后应先执行 git lfs pull。缺少 LFS 内容时，字体构建会因文件大小
或 SHA-256 不匹配而拒绝继续，不允许使用系统字体或相近字体静默替代。
受版本控制的 font-packs/bundle.json 是正式字体包集合清单。构建命令会
逐包构建、验证，并拒绝 output/font-packs/root 中出现清单外字体包，
避免本地残留进入发行产物。各包报告写入
output/font-packs/<pack-id>-build-report.json。输出布局为：
root/<pack-id>/<semver>/font-pack.json
同一 ID 和版本的内容完全相同时，重复构建保持幂等；只要任一文件发生 变化，构建器就会拒绝覆盖。发行内容变化必须提升字体包 SemVer。
当前 mdtp-serif-sc@1.0.0 只替换 FandolSong 与
Mdpdf Fandol Song 的 400/700 字重，不匹配 SimSun 等通用别名，避免
错误替换仿宋、黑体、楷体或普通外部主题字体。
mdtp-sans-sc@1.0.0 提供 MdTP Sans SC、FandolHei、
Microsoft YaHei、PingFang SC、Noto Sans CJK SC 和
Source Han Sans SC 的 400/700 字重映射。主题仍需明确声明所需字体面，
注册器不会对未声明字体进行静默替换。
mdtp-mono@1.0.0 提供内部字族 MdTP Mono，并覆盖主题代码样式常用的
Cascadia、Consolas、SFMono、Menlo、Monaco 与 Courier 等候选名称。
应用层将它作为代码语义槽位的引擎级可选能力统一注入，因此新主题无需
增加主题 ID 分支；字体包缺失时仍保留主题原有候选链并输出缺失诊断。
Desktop 内置发行
组合构建命令为：
npm run desktop:make
该命令先重建完整字体包集合，再构建主安装器和便携 ZIP。electron-builder
把 output/font-packs/root 复制到 resources/font-packs；Desktop 生产
运行时优先读取该只读内置根目录，再读取用户目录中的额外字体包。内置包
因此不会被缺失、旧版或同 ID 用户包替换。NSIS 不安装系统字体、不显示
字体选择页，正式发行也不再拆分独立字体安装器或字体 ZIP。
Docker 内置发行
Docker 构建前必须先执行 npm run build:font-pack。构建上下文只放行
output/font-packs/root，Dockerfile 将其复制到
/app/.local/font-packs；Compose 不再挂载宿主机字体目录。字体因此随
镜像离线分发，同时仍由运行时注册器校验版本、路径、容量和 SHA-256。