From 55614fafed8cf6a9d940d27d50a5ac8557424e8e Mon Sep 17 00:00:00 2001 From: SkyJourney Date: Wed, 26 Aug 2026 11:48:53 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=E7=89=88=E6=9C=AC?= =?UTF-8?q?=E5=8F=98=E6=9B=B4=E6=97=A5=E5=BF=97=E4=B8=8E=E5=8F=91=E7=89=88?= =?UTF-8?q?=E8=A7=84=E5=88=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CHANGELOG.md | 239 ++++++++++++++++++++++++++++++++++++++++++++++++ docs/RELEASE.md | 16 +++- 2 files changed, 254 insertions(+), 1 deletion(-) create mode 100644 CHANGELOG.md diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..457d52c --- /dev/null +++ b/CHANGELOG.md @@ -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.md`。 + +## [Unreleased] + +### 变更 + +- 暂无。 + +## [0.6.2] - 2026-08-26 + +### 修复 + +- 修复真实长文档中表格分页后的列宽、偏移和行样式丢失，冻结逻辑表格列轨并将 + 打印几何稳定传递到 Paged.js 分片。 +- 修复 Markdown 表格中 `
` 变体、连续换行、实体和行内代码的 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/`。 + +### 修复 + +- 修复精确预览放大后的右侧留白、保存与导出默认路径、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 diff --git a/docs/RELEASE.md b/docs/RELEASE.md index 82494a6..47bad8f 100644 --- a/docs/RELEASE.md +++ b/docs/RELEASE.md @@ -1,5 +1,16 @@ # 发版规则 +## 变更日志与发布说明 + +根目录 [`CHANGELOG.md`](../CHANGELOG.md) 是版本变更摘要的单一事实来源。 +每项面向用户或部署方的重要新增、修复、行为变化和兼容性变化应先记录在 +`Unreleased`；冻结版本时将相关内容移动到带发布日期的版本章节。 + +Gitea Release 页面正文应以 `CHANGELOG.md` 对应版本章节为基础生成，可按发布 +场景补充下载提示，但不得与变更日志中的功能、兼容性和验证结论冲突。 +`docs/releases/v.md` 用于保存更详细的发布门禁、验证结论和内部发行说明， +不单独维护另一份相互矛盾的版本摘要。 + ## 唯一产物目录 所有正式分发文件必须统一归集到仓库根目录下的： @@ -54,7 +65,8 @@ TTF、OTF、WOFF 和 WOFF2 必须由 Git LFS 跟踪。新增或升级字体前 1. 完成全量测试、类型检查、生产构建和视觉门禁。 2. 构建字体直接内置的 Desktop 安装包和便携 ZIP。 3. 构建并验证版本化 Docker 镜像。 -4. 准备 `docs/releases/v.md`。 +4. 将 `CHANGELOG.md` 中本版本变更从 `Unreleased` 冻结为带日期的版本章节， + 并以该章节为基础准备 `docs/releases/v.md` 与 Gitea Release 正文。 5. 执行： ```powershell @@ -65,6 +77,8 @@ TTF、OTF、WOFF 和 WOFF2 必须由 Git LFS 跟踪。新增或升级字体前 7. 创建内容完整的 `release:` 提交。 8. 重新生成 release 清单，确保 `gitCommit` 指向该发布提交。 9. 创建 annotated `v` 标签，标签说明与发布提交正文一致。 +10. 发布 Gitea Release，正文以 `CHANGELOG.md` 对应版本章节为基础，并附上 + 本轮正式分发文件。 安装器公开分发前应完成 Authenticode 签名；未签名产物只能按内部发布风险 规则分发。