docs: 补充版本变更日志与发版规则

2026-08-26 11:48:53 +08:00
parent 64445322eb
commit 55614fafed
2 changed files with 254 additions and 1 deletions
@@ -0,0 +1,239 @@
+# 变更日志
+
+本文档记录 MorphDoc（原 Markdown PDF 导出器）的重要版本变更。
+
+格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循
+[Semantic Versioning](https://semver.org/lang/zh-CN/)。发布时以对应版本章节作为
+Gitea Release 页面正文的基础；构建产物、校验和及详细验收记录可继续写入
+`docs/releases/v<version>.md`。
+
+## [Unreleased]
+
+### 变更
+
+- 暂无。
+
+## [0.6.2] - 2026-08-26
+
+### 修复
+
+- 修复真实长文档中表格分页后的列宽、偏移和行样式丢失，冻结逻辑表格列轨并将
+  打印几何稳定传递到 Paged.js 分片。
+- 修复 Markdown 表格中 `<br>` 变体、连续换行、实体和行内代码的 DOCX 翻译，
+  避免换行逃逸到目标单元格段落之外。
+- 修复全 JSON 围栏缩进、表格末行对齐、代码高亮和行内代码连续性。
+- 改进 PDF 文本流排序和数值范围归一化，减少窄字符重叠、跨视觉行破折号及重复
+  表头映射造成的视觉比较误报。
+
+### 验证
+
+- 合成基线与长庆真实文档两套严格门禁为 `280/280`，M4N 复杂表格文档为
+  `140/140`。
+- 健康数据长文档残余误报为 `6/115`（`5.22%`），均核查为重复表头自动对齐或
+  取样错配，基础设施错误为 0。
+- 全项目测试、类型检查、生产构建、正式 Docker、内置字体 NSIS/ZIP 和离线发行
+  归集通过。
+
+### 发行与兼容性
+
+- Desktop 安装器、免安装 ZIP 与 Docker 镜像统一为 0.6.2。
+- Docker 继续内置固定 Chromium、Pandoc 3.9.0.2 和受校验字体包；Desktop
+  继续直接内置 Serif、Sans、Mono 字体，无需安装系统字体。
+- Windows 安装器尚未进行 Authenticode 签名，仅适用于公司内部发布。
+
+## [0.6.1] - 2026-08-04
+
+### 修复
+
+- 重构通用 CSS 到 WordprocessingML 翻译链，统一字体、字号、行距、段距、缩进、
+  边框、底纹、表格、引用和代码样式。
+- 修复字体实际嵌入、中文标点字距、精确行距、打印媒体环境和 Markdown 行内代码
+  连续性问题。
+
+### 验证
+
+- 建立 14 套主题 × 两个方向 × 五组页边距的 140 场景视觉矩阵，`140/140`
+  全部通过。
+- 四套独立封面执行 Chromium、Word、WPS 整页严格门禁，正文执行与物理分页无关
+  的语义块门禁。
+- 源码服务、Docker Web API 和实际安装 Desktop 三条生产 DOCX 导出链通过。
+
+### 发行与兼容性
+
+- Serif、Sans、Mono 三套字体直接内置于 Desktop 安装器和免安装 ZIP，不再发布
+  独立字体安装器或字体 ZIP。
+- Docker 内置固定 Chromium、Pandoc 3.9.0.2 和三套正式字体包。
+
+## [0.6.0] - 2026-08-02
+
+### 新增
+
+- 新增原生可编辑 DOCX 导出，支持 Microsoft Word 与 WPS，并保留纸张、页边距、
+  字体、段落、标题、代码块、表格、媒体、封面、页眉页脚和页码配置。
+- 建立通用主题到 DOCX 样式翻译引擎，覆盖 14 套内置主题。
+- 新增可扩展 Markdown 工具栏，支持标题、强调、代码、引用、列表、任务列表、
+  分隔线及 M×N 表格。
+- PDF 与 DOCX 统一收口至“导出”菜单，并提供生成进度提示。
+
+### 变更
+
+- 产品更名为“墨呈”，英文名 MorphDoc，并保留原 NSIS 安装身份以支持覆盖升级。
+- Desktop 内置固定 Pandoc 3.9.0.2；Docker 内置 Chromium、Pandoc 和正式字体，
+  支持完全离线部署。
+- 正式字体资产改由 Git LFS 管理，发行产物统一归集到 `release/v<version>/`。
+
+### 修复
+
+- 修复精确预览放大后的右侧留白、保存与导出默认路径、Desktop DOCX 媒体捕获
+  超时及品牌迁移后的安装目录问题。
+
+## [0.5.1] - 2026-07-29
+
+### 新增
+
+- 新增 4 套红头、3 套正式文档和 3 套标书主题，内置主题总数增至 14 套。
+- 支持主题推荐页边距、页面装饰、页眉页脚、页码和结构化公文、报告及标书
+  Front Matter。
+- 内置 Fandol 中文字体、两份教程和 14 份主题示例。
+- Desktop 增加新建、保存、另存为快捷键和未保存确认；另存为后跟随新路径。
+
+### 修复
+
+- 修复红头标题居中、正式文档字体、代码块长内容越界和大型代码块跨页留白。
+- Docker Web 镜像补齐 `samples` 目录。
+
+### 兼容性
+
+- 未声明主题推荐设置的主题继续使用原有 16mm 默认页边距。
+
+## [0.5.0] - 2026-07-28
+
+### 新增
+
+- 新增共享 Preview Engine，统一 Web 连续预览、快速分页、Playwright PDF 与
+  Electron PDF 渲染链路。
+- 新增连续预览和修改位置之后的增量分页，支持稳定前缀复用。
+- Desktop 支持多窗口、同文件单例、本地路径与 Markdown 链接，以及聚焦时检测
+  外部文件变化。
+- Web 统一处理文档锚点和 HTTP/HTTPS 外链。
+
+### 变更
+
+- 内置主题统一为 Typora Github、Typora Pixyll、Typora whitey 和 Typora Clean。
+- Windows 安装包统一使用 NSIS，并提供免安装 ZIP。
+
+### 修复
+
+- 修复连续预览双滚动条、ECharts 尺寸、PDF 本地链接、围栏代码块样式和发行包
+  复用陈旧 Web 构建产物的问题。
+
+## [0.4.5] - 2026-07-28
+
+### 新增
+
+- Web 与 Desktop 支持新建和保存 Markdown；Desktop 增加 `.md`、`.markdown`
+  文件关联、单实例系统打开、自定义主题目录和窗口状态恢复。
+- 新文档可按一级标题或首行生成合法文件名，并直接导出 PDF。
+
+### 变更
+
+- 图片、Mermaid 和 ECharts 改为按文档顺序串行执行媒体分页回填，每个媒体元素
+  至多重排一次，并保持标题原尺寸。
+- Web 取消本地素材目录入口。
+
+## [0.4.4] - 2026-07-27
+
+### 变更
+
+- Desktop 发行包仅保留简体中文和英文语言资源，显著缩减目录版、安装包和 ZIP
+  体积，同时保留 Chromium 图形与软件渲染后备组件。
+
+## [0.4.3] - 2026-07-27
+
+### 变更
+
+- Windows Desktop 从 Squirrel 迁移到标准 NSIS 安装向导，支持安装范围和安装目录
+  选择。
+- 安装包改用英文、无空格、包含版本与平台的文件名，并继续提供免安装 ZIP。
+
+## [0.4.2] - 2026-07-27
+
+### 变更
+
+- 移除 Windows Desktop 原生应用菜单栏，使应用内容直接位于系统标题栏下方。
+- 此版本仅更新 Desktop，Web 与 Docker Compose 继续保持 0.4.1。
+
+## [0.4.1] - 2026-07-27
+
+### 新增
+
+- 支持 Web 素材目录、Desktop 同目录资源和受限公网图片下载。
+- 支持图片标题、图片整块分页以及超高图片在单页内容区内自适应缩放。
+
+### 修复
+
+- 修复本地与网络图片的资源解析、自然尺寸解码和 PDF 分页边界问题。
+
+## [0.4.0] - 2026-07-27
+
+### 新增
+
+- 首次发布 Electron Windows Desktop，复用与 Web 相同的渲染和 PDF 核心。
+- 支持桌面 Markdown 文件选择、原生保存和离线 PDF 导出。
+
+### 修复
+
+- 固定桌面端英文可执行文件名，避免中文名称影响安装和自动化链路。
+
+## [0.3.1] - 2026-07-27
+
+### 新增
+
+- 扩展 ECharts 第二阶段图表协议和示例覆盖，完善更多系列、坐标轴及组合图表。
+
+## [0.3.0] - 2026-07-27
+
+### 新增
+
+- 新增 ECharts YAML 围栏、安全校验、浏览器 SVG 渲染和 PDF 输出。
+- 增强编辑区折叠、页码导航和快速预览外层滚动交互。
+
+### 修复
+
+- ECharts 媒体块参与统一不可跨页处理，避免图表被分页裁断。
+
+## [0.2.0] - 2026-07-27
+
+### 新增
+
+- 完善 Mermaid 配置、安全渲染、资源等待和预览缩放。
+- 增强长文档分页、滚动同步和预览/PDF 边界处理。
+
+### 变更
+
+- 收敛 Web 预览和 Chromium PDF 的共享渲染抽象，减少链路分叉。
+
+## [0.1.0] - 2026-07-26
+
+### 新增
+
+- 实现 Markdown 安全渲染核心、网页实时预览、本地主题兼容和导出设置。
+- 支持真实分页预览、固定 Chromium PDF 导出和 PDF 精确预览。
+- 支持长文档分页、页码导航、滚动同步以及 AIO Docker 容器部署。
+
+[Unreleased]: https://gitea.rk-health.com/yixiong/MorphDoc/compare/v0.6.2...main
+[0.6.2]: https://gitea.rk-health.com/yixiong/MorphDoc/src/tag/v0.6.2
+[0.6.1]: https://gitea.rk-health.com/yixiong/MorphDoc/releases/tag/v0.6.1
+[0.6.0]: https://gitea.rk-health.com/yixiong/MorphDoc/releases/tag/v0.6.0
+[0.5.1]: https://gitea.rk-health.com/yixiong/MorphDoc/releases/tag/v0.5.1
+[0.5.0]: https://gitea.rk-health.com/yixiong/MorphDoc/releases/tag/v0.5.0
+[0.4.5]: https://gitea.rk-health.com/yixiong/MorphDoc/src/tag/v0.4.5
+[0.4.4]: https://gitea.rk-health.com/yixiong/MorphDoc/releases/tag/v0.4.4
+[0.4.3]: https://gitea.rk-health.com/yixiong/MorphDoc/releases/tag/v0.4.3
+[0.4.2]: https://gitea.rk-health.com/yixiong/MorphDoc/src/tag/v0.4.2
+[0.4.1]: https://gitea.rk-health.com/yixiong/MorphDoc/src/tag/v0.4.1
+[0.4.0]: https://gitea.rk-health.com/yixiong/MorphDoc/src/tag/v0.4.0
+[0.3.1]: https://gitea.rk-health.com/yixiong/MorphDoc/src/tag/v0.3.1
+[0.3.0]: https://gitea.rk-health.com/yixiong/MorphDoc/src/tag/v0.3.0
+[0.2.0]: https://gitea.rk-health.com/yixiong/MorphDoc/src/tag/v0.2.0
+[0.1.0]: https://gitea.rk-health.com/yixiong/MorphDoc/src/tag/v0.1.0
@@ -1,5 +1,16 @@
 # 发版规则

+## 变更日志与发布说明
+
+根目录 [`CHANGELOG.md`](../CHANGELOG.md) 是版本变更摘要的单一事实来源。
+每项面向用户或部署方的重要新增、修复、行为变化和兼容性变化应先记录在
+`Unreleased`；冻结版本时将相关内容移动到带发布日期的版本章节。
+
+Gitea Release 页面正文应以 `CHANGELOG.md` 对应版本章节为基础生成，可按发布
+场景补充下载提示，但不得与变更日志中的功能、兼容性和验证结论冲突。
+`docs/releases/v<version>.md` 用于保存更详细的发布门禁、验证结论和内部发行说明，
+不单独维护另一份相互矛盾的版本摘要。
+
 ## 唯一产物目录

 所有正式分发文件必须统一归集到仓库根目录下的：
@@ -54,7 +65,8 @@ TTF、OTF、WOFF 和 WOFF2 必须由 Git LFS 跟踪。新增或升级字体前
 1. 完成全量测试、类型检查、生产构建和视觉门禁。
 2. 构建字体直接内置的 Desktop 安装包和便携 ZIP。
 3. 构建并验证版本化 Docker 镜像。
-4. 准备 `docs/releases/v<version>.md`。
+4. 将 `CHANGELOG.md` 中本版本变更从 `Unreleased` 冻结为带日期的版本章节，
+   并以该章节为基础准备 `docs/releases/v<version>.md` 与 Gitea Release 正文。
 5. 执行：

   ```powershell
@@ -65,6 +77,8 @@ TTF、OTF、WOFF 和 WOFF2 必须由 Git LFS 跟踪。新增或升级字体前
 7. 创建内容完整的 `release:` 提交。
 8. 重新生成 release 清单，确保 `gitCommit` 指向该发布提交。
 9. 创建 annotated `v<version>` 标签，标签说明与发布提交正文一致。
+10. 发布 Gitea Release，正文以 `CHANGELOG.md` 对应版本章节为基础，并附上
+    本轮正式分发文件。

 安装器公开分发前应完成 Authenticode 签名；未签名产物只能按内部发布风险
 规则分发。