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
@@ -0,0 +1,135 @@
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import test from "node:test";
+import { fileURLToPath } from "node:url";
+
+import {
+  createDocxReleaseGateSuites,
+  isSuiteAggregatePassed,
+  resolveDocxReleaseGateSuite,
+  summarizeSuiteProgress,
+  writeJsonAtomic
+} from "./docx-release-gate-suites.mjs";
+
+const repositoryDirectory = path.resolve(
+  path.dirname(fileURLToPath(import.meta.url)),
+  ".."
+);
+
+function passedAggregate(suite) {
+  return {
+    suite: { id: suite.id },
+    execution: {
+      expectedCaseCount: 140,
+      completedCaseCount: 140,
+      passedCaseCount: 140
+    },
+    gatePassed: true
+  };
+}
+
+test("发布门禁拆分为四套独立 140 且真实文档按字节升序", () => {
+  const suites = createDocxReleaseGateSuites(repositoryDirectory);
+  assert.equal(suites.length, 4);
+  assert.equal(suites[0].id, "synthetic-baseline-140");
+  assert.ok(suites.every((suite) => suite.expectedCaseCount === 140));
+  assert.deepEqual(
+    suites.slice(1).map((suite) => suite.markdownByteLength),
+    suites.slice(1).map((suite) => suite.markdownByteLength).toSorted((a, b) => a - b)
+  );
+  assert.ok(suites.slice(1).every((suite) => suite.outputDirectoryName.includes(String(suite.markdownByteLength))));
+});
+
+test("next 严格遵守合成基线和真实文档大小顺序", () => {
+  const suites = createDocxReleaseGateSuites(repositoryDirectory);
+  const aggregates = new Map();
+  assert.equal(resolveDocxReleaseGateSuite({ suites, requestedId: "next", aggregates }).id, suites[0].id);
+  aggregates.set(suites[0].id, passedAggregate(suites[0]));
+  assert.equal(resolveDocxReleaseGateSuite({ suites, requestedId: "next", aggregates }).id, suites[1].id);
+  assert.throws(
+    () => resolveDocxReleaseGateSuite({ suites, requestedId: suites[2].id, aggregates }),
+    /必须先通过前置套件/u
+  );
+  for (const suite of suites) {
+    aggregates.set(suite.id, passedAggregate(suite));
+  }
+  assert.equal(resolveDocxReleaseGateSuite({ suites, requestedId: "next", aggregates }), undefined);
+});
+
+test("只有显式指定套件时才允许受控越过前置门禁", () => {
+  const suites = createDocxReleaseGateSuites(repositoryDirectory);
+  const aggregates = new Map();
+  assert.equal(
+    resolveDocxReleaseGateSuite({
+      suites,
+      requestedId: suites[3].id,
+      aggregates,
+      allowOutOfOrder: true
+    }).id,
+    suites[3].id
+  );
+  assert.equal(
+    resolveDocxReleaseGateSuite({
+      suites,
+      requestedId: "next",
+      aggregates,
+      allowOutOfOrder: true
+    }).id,
+    suites[0].id
+  );
+});
+
+test("套件进度独立统计通过、门禁失败和基础设施错误", () => {
+  const suite = createDocxReleaseGateSuites(repositoryDirectory)[0];
+  const records = {
+    [suite.caseIds[0]]: { fingerprint: "same", status: "passed" },
+    [suite.caseIds[1]]: { fingerprint: "same", status: "gate-failed" },
+    [suite.caseIds[2]]: { fingerprint: "same", status: "error" },
+    [suite.caseIds[3]]: { fingerprint: "old", status: "passed" }
+  };
+  const progress = summarizeSuiteProgress({ suite, fingerprint: "same", records });
+  assert.deepEqual(progress, {
+    expectedCaseCount: 140,
+    completedCaseCount: 3,
+    pendingCaseCount: 137,
+    passedCaseCount: 1,
+    gateFailedCaseCount: 1,
+    errorCaseCount: 1,
+    complete: false,
+    gatePassed: false
+  });
+  assert.equal(isSuiteAggregatePassed({ suite: { id: suite.id }, execution: progress, gatePassed: false }, suite), false);
+});
+
+test("Windows 瞬时文件锁不会中断原子进度写入", () => {
+  const directory = fs.mkdtempSync(path.join(os.tmpdir(), "mdtp-gate-atomic-"));
+  const filePath = path.join(directory, "progress.json");
+  let attempts = 0;
+  try {
+    writeJsonAtomic(filePath, { completed: 9 }, {
+      rename(source, destination) {
+        attempts += 1;
+        if (attempts < 3) {
+          const error = new Error("temporary Windows lock");
+          error.code = "EPERM";
+          throw error;
+        }
+        fs.renameSync(source, destination);
+      },
+      sleep() {}
+    });
+    assert.equal(attempts, 3);
+    assert.deepEqual(
+      JSON.parse(fs.readFileSync(filePath, "utf8")),
+      { completed: 9 }
+    );
+    assert.deepEqual(
+      fs.readdirSync(directory).filter((name) => name.endsWith(".tmp")),
+      []
+    );
+  } finally {
+    fs.rmSync(directory, { recursive: true, force: true });
+  }
+});