docs: 冻结 v0.6.0 架构与验收边界

This commit is contained in:
SkyJourney
2026-07-30 10:23:04 +08:00
parent 83e6559c2c
commit 81d9099eae
2 changed files with 403 additions and 10 deletions
+24 -10
View File
@@ -1,6 +1,6 @@
# Markdown PDF 导出器进度
最后更新:2026-07-29
最后更新:2026-07-30
## 1. 当前概况
@@ -61,6 +61,13 @@ DOM 兼容和桌面发行包复用陈旧 Web 产物的问题。
并修复红头标题居中、代码块自动换行、左侧内容留白和跨页分页。Windows
安装包、Docker Compose、本机安装与发布验证均已完成。
`v0.6.0` 已完成开发立项,核心范围冻结为 DOCX 导出与 Markdown
工具栏。DOCX 采用 Node.js 编排、固定版本 Pandoc、动态
`reference.docx` 和 Chromium/Electron 高分辨率 PNG 媒体管线,不引入
Python;左侧编辑器计划升级为 CodeMirror 6,并通过项目自有命令注册层
支持基础工具栏及后续 Front Matter、ECharts YAML 工具扩展。完整设计与
验收门禁见 [v0.6.0 设计文档](V0.6.0_DESIGN.md)。
## 2. 已完成
### 2.1 项目骨架
@@ -934,18 +941,25 @@ ECharts 第二阶段浏览器与 PDF 验证结果:
## 6. 推荐接手顺序
### 阶段一:v0.5.x 稳定性与性能观测
### 阶段一:v0.6.0 分阶段开发
- 为增量分页补充超长文档性能基线,记录稳定前缀页数和后缀重算耗时
- 覆盖 Windows 100%、125% 和 150% 显示缩放的快速/精确分页差异
- 扩展 Desktop 多窗口、文件外部变化和链接打开的真实端到端回归
- 持续检查连续预览中媒体宽高、单滚动容器和资源释放。
- 阶段 1:冻结架构、能力边界和 Word/WPS 验收门禁
- 阶段 2:冻结 Pandoc 版本、许可证、Docker 与 Desktop 分发方式
- 阶段 3:实现 DOCX 共享模型和跨端导出协议
- 阶段 4:实现 CodeMirror 6 与可扩展基础 Markdown 工具栏;
- 阶段 5~8:依次实现资源预处理、动态 reference.docx、Pandoc 转换服务
以及 Web/Desktop 导出交互;
- 阶段 910:完成自动化和 Word/WPS 互操作验收,再构建正式发布产物。
### 阶段二:导出配置扩展
每个阶段验收通过后创建一个独立提交,再进入下一阶段。当前阶段不得混入
后续阶段的功能实现。
- Front Matter 元数据覆盖;
- 浏览器本地配置预设;
- 配置 JSON 导入和导出。
### 阶段二:后续版本扩展
- Front Matter 可视化编辑工具;
- ECharts YAML 可视化配置工具;
- 更完整的自定义主题 DOCX 显式样式清单;
- 浏览器本地配置预设及配置 JSON 导入和导出。
## 7. 首版验收目标