feat: 实现 DOCX 媒体预处理与跨端 PNG 捕获

packages/preview-engine/README.md

@@ -12,6 +12,7 @@ src/
 ├── paged-document-runtime.ts   连续与分页渲染主流程
 ├── paged-preview.ts            分页载荷、消息协议与页面 CSS
 ├── continuous-preview.ts       无分页 DOM 更新与稳定节点复用
+├── docx-media-runtime.ts       DOCX 连续媒体舞台与 PNG 捕获计划
 ├── incremental-pagination.ts   修改边界、稳定前缀与后缀分页缓存
 ├── paged-table-handler.ts      跨页表格表头处理
 ├── media-page-backfill.ts      图片与图表按文档顺序回填
@@ -45,6 +46,16 @@ const result = await runtime.render(payload, {
 });
 
 const continuous = await runtime.renderContinuous(payload);
+
+const mediaPlan = await renderDocxMediaCapturePlan(
+  runtime,
+  root,
+  payload,
+  {
+    contentWidthPx,
+    contentHeightPx
+  }
+);
 ```
 
 `payload` 使用 `@md-to-pdf/core` 中的 `PagedDocumentPayload`。主题 CSS、
@@ -69,6 +80,17 @@ const continuous = await runtime.renderContinuous(payload);
 得到基准高度；上一页空白与媒体需求接近时，才尝试只缩放媒体主体回填，
 标题始终保持自然尺寸。
 
+## DOCX 媒体舞台
+
+`renderDocxMediaCapturePlan()` 复用连续渲染流程，等待字体、图片、
+Mermaid 和 ECharts 完成后，按 DOM 顺序标记普通图片、Mermaid SVG 与
+ECharts SVG。运行时将媒体限制在纸张内容区内，并返回整数外包围捕获框、
+显示尺寸、替代文本、图注和目标位图倍率。
+
+目标倍率默认为 3.125（300 DPI），并受 4096px 单边和 1600 万像素上限
+约束。运行时只生成平台无关的捕获计划；Server 使用 Playwright Chromium，
+Desktop 使用 Electron Chromium 输出 PNG。
+
 ## PDF 链接
 
 `preparePdfDocumentLinks()` 仅在 PDF 目标中将本地链接编码为