release: 发布 v0.5.1

新增能力：内置 4 套红头、3 套正式文档和 3 套标书主题，支持主题推荐页边距、页面装饰、页眉页脚和页码；增加结构化公文、项目报告及标书 Front Matter，内置 Fandol 中文字体、两份教程和 14 份主题示例。

桌面工作流：重组更多菜单，增加新建、保存、另存为快捷键和未保存确认；另存为后跟随新路径，主题示例自动切换主题，Desktop 发行包完整携带教程、示例与字体。

问题修复：修正红头标题居中与正式文档字体；围栏代码按正文宽度自动换行，长内容安全断行，至少两行即可在当前页分页，并统一保留 8px 左侧内容留白；Docker Web 镜像正确打包 samples。

兼容与部署：未声明主题推荐设置时继续使用 16mm 默认页边距；Web 隐藏不适用的另存为。正式镜像 yixiong/md-to-pdf:v0.5.1 内容 ID 为 sha256:72f519a69bfd6cb2f6df30c2be938e58ceb6f20e4748a32551874de3d436b276，Compose 健康运行。

验证结果：最终修复前 65 个测试文件、286 项测试通过，最终代码块与主题定向测试 27 项通过；全项目类型检查、生产构建和 git diff --check 通过。容器检出 14 套主题、17 份 Markdown，代码块回归 PDF 为 2 页且无越界。NSIS SHA-256 为 676CCE73D782B0B15AC6BC68F253CFBC4740383583E4DAA98F746EDF9999C5CC，ZIP SHA-256 为 82BF6ADF1200604F145CC86FA3ED193955CF6741EBEE3DF8953483515CFF621F。

docs/PROGRESS.md

@@ -1,6 +1,6 @@
 # Markdown PDF 导出器进度
 
-最后更新：2026-07-28
+最后更新：2026-07-29
 
 ## 1. 当前概况
 
@@ -55,6 +55,12 @@ Web/Compose 发布仍保持 `v0.4.1`。
 聚焦时外部文件变化提示。四套主题统一命名，并修复围栏代码块的 Typora
 DOM 兼容和桌面发行包复用陈旧 Web 产物的问题。
 
+`v0.5.1` 正式版新增 10 套政企与标书主题、规范页边距和页面装饰、
+结构化公文 Front Matter、内置中文字体、教程及 14 份主题示例；同时
+重组“更多”菜单，补齐桌面文件快捷键、未保存确认和跟随新路径的另存为，
+并修复红头标题居中、代码块自动换行、左侧内容留白和跨页分页。Windows
+安装包、Docker Compose、本机安装与发布验证均已完成。
+
 ## 2. 已完成
 
 ### 2.1 项目骨架
@@ -507,8 +513,76 @@ DOM 兼容和桌面发行包复用陈旧 Web 产物的问题。
   `package` 和 `make` 强制先调用该脚本，防止安装包复制陈旧
   `apps/web/dist`。
 
+### 3.20 v0.5.1 正式文档主题与桌面文件工作流
+
+- 围栏代码按正文宽度自动换行，长单词允许安全断行；代码内容统一保留
+  `8px` 左侧内边距，并保留代码块外框、语法高亮和 Typora 兼容 DOM。
+- 多行代码块按至少两行一组生成可分页分片，当前页能容纳一组时不再将
+  整块代码推到下一页；跨页分片保持连续边框和完整文本。
+- 新增政企标准红头、函件红头、企业简版红头、简报红头 4 套红头主题，
+  正式制度、正式报告、可研报告 3 套正式文档主题，以及经典标书、商务蓝
+  标书、暗标 3 套标书主题。
+- 主题清单新增分类、文档结构预设、推荐导出设置和页面装饰；没有主题推荐
+  时保持 16mm 默认页边距，正式主题自动采用规范页边距、页眉页脚和页码。
+- Renderer 根据结构化 Front Matter 生成红头、文号、签发人、密级、
+  主送、正文、附件、落款、抄送和印发信息，也支持项目报告与标书封面。
+- 红头标题使用居中网格布局，签发人不再挤压发文机关；正文、红头标题、
+  页眉页脚使用主题内置 Fandol 中文字体，降低跨机器显示差异。
+- `samples/tutorials` 内置 ECharts 和公文主题教程，包含 YAML 示例、
+  字段说明、图表标题和图例渲染；公文教程保持 Typora Github 阅读主题。
+- `samples/themes` 为全部 14 套主题提供示例；Desktop 发行配置将教程、
+  示例和字体随应用复制，打开主题示例时自动切换相应主题。
+- 移除顶部加号入口，将文件操作、教程与示例、主题管理整合为三个菜单
+  分区；文件操作统一命名为“新建文件”“保存文件”“另存为文件”。
+- Desktop 支持 `Ctrl+N`、`Ctrl+W`、`Ctrl+S`、`Ctrl+Shift+S`，新建和
+  关闭时对未保存内容进行确认；另存为成功后当前窗口追踪新文件路径，
+  Web 端不显示或拦截“另存为”。
+
 ## 4. 已执行验证
 
+2026-07-29 对 v0.5.1 完整工作区及最终代码块修复执行：
+
+```text
+npm test
+npm run typecheck
+npm run build
+git diff --check
+```
+
+- 最终修复前的完整工作区共 65 个测试文件、286 项测试全部通过；将
+  左侧内边距调整到共享分页规则后，Preview Engine 18 项和 Application
+  9 项定向测试再次通过；
+- Markdown ECharts、Core、Renderer、Application、Preview Engine、
+  Web、Server 和 Desktop 类型检查全部通过；
+- Web 生产资源、Server 和 Desktop 主进程/Preload 构建通过，生产资源
+  中的应用版本为 `0.5.1`；
+- 保留的手动验收服务继续运行：Web 与主题 API 均返回 HTTP 200，
+  Electron 应用及其 GPU、网络、渲染进程正常存活；
+- `git diff --check` 通过，仅有 Git 对 Windows 工作区换行转换的提示。
+- v0.5.1 Windows 目录版、NSIS 和 ZIP 经完整内嵌 Web 重建后生成；
+  目录版主程序文件版本为 `0.5.1`、产品版本为 `0.5.1.0`，启动后正常
+  响应，并保留独立验收窗口。
+- 目录版包含 14 套主题、14 份主题示例、2 份教程、5 个 Fandol WOFF2
+  中文字体及其许可文件，语言包仅保留 `zh-CN` 和 `en-US`；ZIP 中同样
+  检出主题、示例和字体资源。
+- NSIS 安装包 `md-to-pdf-0.5.1-x86_64-Setup.exe` 为 114,688,014
+  字节，SHA-256 为
+  `676CCE73D782B0B15AC6BC68F253CFBC4740383583E4DAA98F746EDF9999C5CC`。
+- 免安装包 `md-to-pdf-0.5.1-x86_64.zip` 为 152,183,607 字节，
+  SHA-256 为
+  `82BF6ADF1200604F145CC86FA3ED193955CF6741EBEE3DF8953483515CFF621F`。
+- 主程序与安装包 Authenticode 状态均为未签名，与当前发行说明一致。
+- 正式镜像 `yixiong/md-to-pdf:v0.5.1` 内容 ID 为
+  `sha256:72f519a69bfd6cb2f6df30c2be938e58ceb6f20e4748a32551874de3d436b276`；
+  Compose 强制替换后健康运行在 `http://localhost:8080`。
+- 容器确认包含 14 套主题和 17 份 Markdown 教程/示例；生产 Bundle
+  同时包含代码自动换行、任意长单词断行和 `8px` 左侧内边距。
+- 容器代码块回归 PDF 返回 HTTP 200，共 2 页、64,721 字节，
+  Mermaid/ECharts 错误数均为 0；视觉检查确认长 SQL 正确换行、跨页
+  连续、24 个字段完整且没有右侧越界。
+- 本机 NSIS 安装项版本为 `0.5.1`，发布者为 `YIXIONG Tech.ltd`；
+  用户完成安装和桌面端手动验收，未发现发布阻塞问题。
+
 2026-07-28 在当前完整工作区成功执行：
 
 ```text