release: 发布 v0.6.2 DOCX 真实文档修复

新增能力：将 DOCX 发布验收拆分为四套独立 140，支持真实语料冻结、指纹复用、失败与基础设施错误独立统计，并为表格换行、全 JSON 围栏、代码连续性和长文档分页建立通用门禁。问题修复：冻结 Paged.js 分片前的逻辑表格列轨并传递打印几何，统一 Markdown 表格换行、代码、段落与 OOXML 翻译；改进 PDF 文本流排序、语义块映射、颜色与栅格比较，消除窄字符重叠和跨行范围符号误报。兼容与部署：版本统一为 0.6.2；正式 Docker 镜像内置固定 Chromium、Pandoc 3.9.0.2 和 Serif/Sans/Mono 字体；Desktop NSIS 与 ZIP 继续直接内置字体，无需系统字体安装。验证结果：合成基线与长庆严格 280/280，M4N 140/140；健康数据残余误报 6/115（5.22%），均核查为重复表头自动对齐/取样误报且基础设施错误为 0。全项目测试、类型检查、生产构建和 git diff --check 通过；正式 Docker、NSIS、ZIP、离线镜像、部署包、清单及 SHA-256 均已生成并校验。
2026-08-26 10:50:20 +08:00
parent 01b06abc2c
commit 64445322eb
75 changed files with 9255 additions and 298 deletions
@@ -8,6 +8,7 @@ export const DOCX_FILE_EXTENSION = ".docx";
 export const MAXIMUM_DOCX_MARKDOWN_LENGTH = 1_500_000;
 export const MAXIMUM_DOCX_FILE_NAME_LENGTH = 500;
 export const MAXIMUM_DOCX_RESOURCE_COUNT = 50;
+export const MAXIMUM_DOCX_MEDIA_COUNT = 100;
 export const DOCX_MEDIA_RASTER_DPI = 300;
 export const DOCX_MEDIA_CSS_DPI = 96;
 export const DOCX_MEDIA_RASTER_SCALE =
@@ -108,7 +109,7 @@ export type DocxMediaAlignment = z.infer<

 export const docxTableLayoutSchema = z.object({
  ordinal: z.number().int().min(1).max(256),
-  widthPercent: z.number().positive().max(100),
+  widthPercent: z.number().positive().max(300),
  leftOffsetPercent: z.number().min(0).max(100),
  columnWidthPercents: z
    .array(z.number().positive().max(100))
@@ -145,6 +146,13 @@ export const docxTextBlockLayoutSchema = z.object({
  ordinal: z.number().int().min(1).max(100_000),
  text: z.string().min(1).max(100_000),
  letterSpacingPt: z.number().min(-20).max(100),
+  alertRole: z.enum(["title", "body"]).optional(),
+  fontSizePt: z.number().min(1).max(200).optional(),
+  bold: z.boolean().optional(),
+  italic: z.boolean().optional(),
+  color: z.string().regex(/^#[0-9a-f]{6}$/iu).optional(),
+  leftIndentPt: z.number().min(0).max(2_000).optional(),
+  rightIndentPt: z.number().min(0).max(2_000).optional(),
  alignment: z
    .enum(["left", "center", "right", "justify", "distribute"])
    .optional(),
@@ -162,7 +170,10 @@ export const docxListItemLayoutSchema = z.object({
  ordinal: z.number().int().min(1).max(100_000),
  text: z.string().min(1).max(100_000),
  depth: z.number().int().min(0).max(64),
-  textStartPt: z.number().min(0).max(2_000)
+  textStartPt: z.number().min(0).max(2_000),
+  alignment: z
+    .enum(["left", "center", "right", "justify", "distribute"])
+    .optional()
 });

 export type DocxListItemLayout = z.infer<
@@ -194,11 +205,22 @@ export type DocxInlineCodeLayout = z.infer<
  typeof docxInlineCodeLayoutSchema
 >;

+export const docxEmojiRunLayoutSchema = z.object({
+  ordinal: z.number().int().min(1).max(100_000),
+  text: z.string().min(1).max(1_000),
+  color: z.string().regex(/^#[0-9a-f]{6}$/iu)
+});
+
+export type DocxEmojiRunLayout = z.infer<
+  typeof docxEmojiRunLayoutSchema
+>;
+
 export const docxDocumentLayoutPlanSchema = z.object({
  tables: z.array(docxTableLayoutSchema).max(256),
  textBlocks: z.array(docxTextBlockLayoutSchema).max(100_000).optional(),
  listItems: z.array(docxListItemLayoutSchema).max(100_000).optional(),
-  inlineCodes: z.array(docxInlineCodeLayoutSchema).max(100_000).optional()
+  inlineCodes: z.array(docxInlineCodeLayoutSchema).max(100_000).optional(),
+  emojiRuns: z.array(docxEmojiRunLayoutSchema).max(100_000).optional()
 });

 export type DocxDocumentLayoutPlan = z.infer<
@@ -208,12 +230,12 @@ export type DocxDocumentLayoutPlan = z.infer<
 export const docxMediaCaptureTargetSchema = z.object({
  id: z.string().regex(/^docx-media-\d+$/u),
  kind: docxMediaKindSchema,
-  ordinal: z.number().int().min(1).max(MAXIMUM_DOCX_RESOURCE_COUNT),
+  ordinal: z.number().int().min(1).max(MAXIMUM_DOCX_MEDIA_COUNT),
  kindOrdinal: z
    .number()
    .int()
    .min(1)
-    .max(MAXIMUM_DOCX_RESOURCE_COUNT),
+    .max(MAXIMUM_DOCX_MEDIA_COUNT),
  altText: z.string().max(1_000),
  caption: z.string().max(1_000).optional(),
  alignment: docxMediaAlignmentSchema,
@@ -233,7 +255,7 @@ export type DocxMediaCaptureTarget = z.infer<
 export const docxMediaCapturePlanSchema = z.object({
  targets: z
    .array(docxMediaCaptureTargetSchema)
-    .max(MAXIMUM_DOCX_RESOURCE_COUNT),
+    .max(MAXIMUM_DOCX_MEDIA_COUNT),
  echartsErrors: z.array(z.string().max(1_000)),
  mermaidErrors: z.array(z.string().max(1_000)),
  documentLayout: docxDocumentLayoutPlanSchema.optional()
@@ -3,8 +3,10 @@ import {
  DOCX_MIME_TYPE,
  DOCX_MEDIA_RASTER_SCALE,
  DOCX_PANDOC_VERSION,
+  MAXIMUM_DOCX_MEDIA_COUNT,
  MAXIMUM_DOCX_MEDIA_EDGE_PIXELS,
  MAXIMUM_DOCX_MARKDOWN_LENGTH,
+  MAXIMUM_DOCX_RESOURCE_COUNT,
  createDocxFileName,
  defaultExportConfig,
  docxCapabilitySchema,
@@ -167,6 +169,43 @@ describe("DOCX 共享协议", () => {
      }).success
    ).toBe(false);
  });
+
+  it("区分用户资源上限与渲染后媒体上限", () => {
+    expect(MAXIMUM_DOCX_RESOURCE_COUNT).toBe(50);
+    expect(MAXIMUM_DOCX_MEDIA_COUNT).toBe(100);
+    expect(
+      docxExportRequestSchema.safeParse({
+        markdown: "# 文档",
+        resources: Array.from({ length: 51 }, (_, index) => ({
+          path: `asset-${index}.png`,
+          data: "AA=="
+        })),
+        exportConfig: defaultExportConfig
+      }).success
+    ).toBe(false);
+    const targets = Array.from({ length: 67 }, (_, index) => ({
+      id: `docx-media-${index + 1}`,
+      kind: "mermaid" as const,
+      ordinal: index + 1,
+      kindOrdinal: index + 1,
+      altText: `图 ${index + 1}`,
+      alignment: "center" as const,
+      displayWidthPx: 100,
+      displayHeightPx: 100,
+      captureX: 0,
+      captureY: index * 100,
+      captureWidthPx: 100,
+      captureHeightPx: 100,
+      rasterScale: 3.125
+    }));
+    expect(
+      docxMediaCapturePlanSchema.safeParse({
+        targets,
+        echartsErrors: [],
+        mermaidErrors: []
+      }).success
+    ).toBe(true);
+  });
 });

 describe("DOCX 主题样式协议", () => {