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 均已生成并校验。

packages/document-visual-diff/tests/report.test.ts

@@ -6,6 +6,7 @@ import { describe, expect, it } from "vitest";
 import {
   createPdfVisualDiffReport,
   getBlockingVisualDiffIssues,
+  isCrossEngineRasterEquivalent,
   renderPdfVisualDiffHtml,
   serializePdfVisualDiffJson,
   type PdfDocumentSnapshot,
@@ -84,6 +85,27 @@ function antialiasBlockRaster(edgeColor: string): PdfPageRaster {
   };
 }
 
+function adjacentLineRaster(includePreviousLine: boolean): PdfPageRaster {
+  const canvas = createCanvas(40, 50);
+  const context = canvas.getContext("2d");
+  context.fillStyle = "#ffffff";
+  context.fillRect(0, 0, 40, 50);
+  if (includePreviousLine) {
+    context.fillStyle = "#111111";
+    context.fillRect(8, 12, 20, 3);
+  }
+  context.fillStyle = "#111111";
+  context.fillRect(8, 20, 20, 4);
+  const png = Uint8Array.from(canvas.toBuffer("image/png"));
+  return {
+    widthPx: 40,
+    heightPx: 50,
+    dpi: 144,
+    sha256: createHash("sha256").update(png).digest("hex"),
+    png,
+  };
+}
+
 function snapshot(label: string, pageRaster: PdfPageRaster): PdfDocumentSnapshot {
   return {
     schemaVersion: 1,
@@ -561,6 +583,58 @@ describe("PDF 视觉差异报告", () => {
     });
   });
 
+  it("正文页数不同时分别验证未配对页面自身的页码语义", async () => {
+    const pageNumber = (text: string): PdfTextLineSnapshot => ({
+      text,
+      normalizedText: text,
+      bounds: { x: 9, y: 22, width: 2, height: 1 },
+      baselineY: 23,
+      role: "page-number",
+      items: [],
+    });
+    const baseline = flowSnapshot(
+      "baseline",
+      [
+        [contentLine("甲", 8), pageNumber("1 / 2")],
+        [contentLine("乙丙", 8), pageNumber("2 / 2")],
+      ],
+      "#111111",
+    );
+    const candidate = flowSnapshot(
+      "candidate",
+      [[
+        contentLine("甲", 8),
+        contentLine("乙丙", 12),
+        pageNumber("1 / 1"),
+      ]],
+      "#cc0000",
+    );
+    const pageSemantics = (count: number) => bodySemantics(count).map(
+      (item, index) => ({
+        ...item,
+        footerVisible: true,
+        footerAlignment: "center" as const,
+        pageNumberText: `${index + 1} / ${count}`,
+      }),
+    );
+    const report = await createPdfVisualDiffReport(baseline, candidate, {
+      expectedEditableText: "甲乙丙",
+      expectedEditableParagraphs: flowParagraphs,
+      baselinePageSemantics: pageSemantics(2),
+      candidatePageSemantics: pageSemantics(1),
+    });
+
+    expect(report.status).toBe("warning");
+    expect(report.basic.bodyFlow).toMatchObject({
+      legal: true,
+      baselineBodyPageCount: 2,
+      candidateBodyPageCount: 1,
+    });
+    expect(report.issues.map((issue) => issue.code)).toContain(
+      "BODY_FLOW_PAGE_COUNT_DIFFERENCE",
+    );
+  });
+
   it("新增正文页缺少预期页码时不得认定为合法分页流动", async () => {
     const pageNumber = (text: string): PdfTextLineSnapshot => ({
       text,
@@ -664,6 +738,71 @@ describe("PDF 视觉差异报告", () => {
       .toMatchObject({ inkIou: 1, edgeIou: 1 });
   });
 
+  it("局部视觉裁剪不得把目标行上方的相邻行墨迹纳入比较", async () => {
+    const targetLine = contentLine("乙", 10);
+    targetLine.bounds = { x: 4, y: 10, width: 10, height: 2 };
+    const baseline = flowSnapshot(
+      "baseline",
+      [[targetLine]],
+      "#111111",
+    );
+    const candidate = flowSnapshot(
+      "candidate",
+      [[targetLine]],
+      "#111111",
+    );
+    baseline.pages[0]!.raster = adjacentLineRaster(true);
+    candidate.pages[0]!.raster = adjacentLineRaster(false);
+    const report = await createPdfVisualDiffReport(baseline, candidate, {
+      expectedEditableText: "乙",
+      expectedEditableParagraphs: [{
+        index: 0,
+        text: "乙",
+        role: "body",
+        section: "body",
+        blockKind: "table-cell",
+      }],
+      pageSemantics: bodySemantics(1),
+    });
+
+    expect(report.issues.map((issue) => issue.code)).not.toContain(
+      "SEMANTIC_BLOCK_RASTER_MISMATCH",
+    );
+  });
+
+  it("仅对带行内代码结构语义的混排允许 WPS 底纹栅格混合差异", () => {
+    const metrics = {
+      baselineWidthPx: 236,
+      baselineHeightPx: 24,
+      candidateWidthPx: 233,
+      candidateHeightPx: 26,
+      comparedWidthPx: 236,
+      comparedHeightPx: 26,
+      dimensionsMatch: false,
+      geometryNormalized: true,
+      spatialTolerancePx: 4,
+      meanAbsoluteError: 22.1,
+      changedPixelRatio: 0.449,
+      inkIou: 0.908,
+      edgeIou: 1,
+      backgroundColorDelta: 11.38,
+      foregroundColorDelta: 2.6,
+    };
+
+    expect(isCrossEngineRasterEquivalent(
+      metrics,
+      false,
+      "paragraph",
+      true,
+    )).toBe(true);
+    expect(isCrossEngineRasterEquivalent(
+      metrics,
+      false,
+      "paragraph",
+      false,
+    )).toBe(false);
+  });
+
   it("缺少语义块证据时不得把正文整页栅格自动降级", async () => {
     const report = await createPdfVisualDiffReport(
       snapshot("baseline", raster("#111111")),