feat: 建立 DOCX 共享协议与准备服务

2026-07-30 11:04:18 +08:00
parent fb3ddada39
commit f7d4efeafc
10 changed files with 512 additions and 3 deletions
@@ -1,6 +1,6 @@
 # v0.6.0 DOCX 导出与 Markdown 工具栏设计

-状态：阶段 1 架构已冻结；阶段 2 Pandoc 运行时与许可证方案已冻结。
+状态：阶段 1～3 已完成，DOCX 架构、Pandoc 分发及共享协议已经冻结。

 ## 1. 版本目标

@@ -136,6 +136,19 @@ apps/web/
 `packages/docx-engine` 不依赖 Fastify、Electron 或浏览器 UI。Server 和
 Desktop 只提供平台运行时、传输与保存能力。

+阶段 3 已在 `packages/core/src/docx.ts` 建立以下跨端协议：
+
+- DOCX 请求及 Zod Schema；
+- 源图片资源；
+- 固定 Pandoc 版本和运行时 capability；
+- HTTP/IPC 共用错误码与错误响应；
+- DOCX 结果、媒体诊断和分阶段耗时；
+- MIME、扩展名和安全输出文件名。
+
+`packages/application` 提供 `prepareDocxExport()`，统一完成请求校验、
+主题查找、图片解析和 Markdown 安全渲染，并返回 DOCX 引擎需要的源请求、
+渲染文档、主题清单及 CSS。该方法不调用 Pandoc。
+
 ### 4.2 转换流程

 1. 校验 Markdown、主题和导出配置；