minimal-agent 0.12.0 → 0.14.0

package/workflows/wrong-question-docx/scripts/workbook.mjs

@@ -0,0 +1,857 @@
+import { spawnSync } from 'node:child_process';
+import { mkdir, mkdtemp, readFile, stat, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { basename, dirname, join, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { DOMParser } from '@xmldom/xmldom';
+import {
+  BorderStyle,
+  Document,
+  ImageRun,
+  LineRuleType,
+  MathFraction,
+  MathRadical,
+  MathRun,
+  MathSubScript,
+  MathSubSuperScript,
+  MathSuperScript,
+  Math as OfficeMath,
+  Packer,
+  Paragraph,
+  TextRun,
+} from 'docx';
+import { strFromU8, unzipSync } from 'fflate';
+import sharp from 'sharp';
+
+export function parseSelection(text) {
+  const s = String(text ?? '').trim();
+  if (/^(全部|全抄|all)$/i.test(s)) return { all: true, items: [] };
+  if (!s) return { all: false, items: [] };
+  const items = [];
+  for (const token of s
+    .replace(/[，、；;]/g, ',')
+    .split(',')
+    .map((s) => s.trim())
+    .filter(Boolean)) {
+    const m = token.match(/^(?:(.+?)[:：])?(\d+)(?:\s*[-–~至到]\s*(\d+))?$/);
+    if (!m)
+      throw new Error(`无法理解题号：${token}，请使用5,9,13-16或章节:题号`);
+    const start = Number(m[2]);
+    const end = Number(m[3] ?? m[2]);
+    if (start < 1 || end < start || end - start > 500)
+      throw new Error(`非法题号范围：${token}`);
+    for (let n = start; n <= end; n++) {
+      const item = { section: m[1]?.trim() ?? '', number: String(n) };
+      if (
+        !items.some(
+          (i) => i.section === item.section && i.number === item.number,
+        )
+      )
+        items.push(item);
+    }
+  }
+  return { all: false, items };
+}
+
+export function selectQuestions(inventory, selection) {
+  const available = inventory.questions;
+  const wanted = selection.all
+    ? available.map((q) => ({ number: q.number, section: q.section, id: q.id }))
+    : selection.items;
+  return wanted.map((item, i) => {
+    const matches = available.filter((q) =>
+      item.id
+        ? q.id === item.id
+        : q.number === item.number &&
+          (!item.section || q.section === item.section),
+    );
+    if (matches.length > 1)
+      throw new Error(`第${item.number}题有多个章节匹配，请指定章节:题号`);
+    return {
+      ...(matches[0] ?? {}),
+      requested: item,
+      sourceId: matches[0]?.id ?? '',
+      id: `item-${String(i + 1).padStart(3, '0')}`,
+      number: item.number,
+      section: matches[0]?.section ?? item.section,
+      status: matches[0]?.status === 'exported' ? 'pending' : 'missing',
+      reason: matches[0]
+        ? matches[0].status === 'exported'
+          ? ''
+          : '题目切图未完成'
+        : '指定题目未找到',
+    };
+  });
+}
+
+async function save(path, data) {
+  await mkdir(dirname(path), { recursive: true });
+  await writeFile(path, data);
+}
+const geometry = (width, height) => {
+  const s = Math.min(1, 1920 / Math.max(width, height));
+  const w = Math.max(1, Math.round(width * s));
+  const h = Math.max(1, Math.round(height * s));
+  return {
+    sourceWidth: width,
+    sourceHeight: height,
+    width: w,
+    height: h,
+    scaleX: w / width,
+    scaleY: h / height,
+  };
+};
+async function preview(input, output) {
+  const m = await sharp(input).metadata();
+  const g = geometry(m.width, m.height);
+  await save(
+    output,
+    await sharp(input)
+      .resize({
+        width: g.width,
+        height: g.height,
+        kernel: 'lanczos3',
+        fastShrinkOnLoad: false,
+        withoutEnlargement: true,
+      })
+      .png()
+      .toBuffer(),
+  );
+  return { ...g, input, path: output };
+}
+export function validBox(b) {
+  return (
+    b &&
+    ['x', 'y', 'width', 'height'].every((k) => Number.isFinite(b[k])) &&
+    b.x >= 0 &&
+    b.y >= 0 &&
+    b.width > 0 &&
+    b.height > 0 &&
+    b.x + b.width <= 1000 &&
+    b.y + b.height <= 1000
+  );
+}
+export function toPixels(b, g, padding = 0) {
+  if (!validBox(b)) throw new Error('配图坐标非法');
+  const left = Math.max(
+    0,
+    Math.floor(((b.x / 1000) * g.width) / g.scaleX) - padding,
+  );
+  const top = Math.max(
+    0,
+    Math.floor(((b.y / 1000) * g.height) / g.scaleY) - padding,
+  );
+  const right = Math.min(
+    g.sourceWidth,
+    Math.ceil((((b.x + b.width) / 1000) * g.width) / g.scaleX) + padding,
+  );
+  const bottom = Math.min(
+    g.sourceHeight,
+    Math.ceil((((b.y + b.height) / 1000) * g.height) / g.scaleY) + padding,
+  );
+  return { left, top, width: right - left, height: bottom - top };
+}
+
+async function prepare({ root, question: q }) {
+  const artifacts = [];
+  const layers = [];
+  let height = 0;
+  let width = 0;
+  for (const [i, f] of q.fragments.entries()) {
+    const m = await sharp(f.path).metadata();
+    if (i) height += 24;
+    if (
+      f.canvas.x !== 0 ||
+      f.canvas.y !== height ||
+      m.width !== f.canvas.width ||
+      m.height !== f.canvas.height
+    )
+      throw new Error('子流程片段拼接坐标不匹配');
+    layers.push({ input: f.path, left: 0, top: height });
+    width = Math.max(width, m.width);
+    height += m.height;
+  }
+  const m = await sharp(q.path).metadata();
+  if (m.width !== width || m.height !== height)
+    throw new Error('子流程成品与原片段尺寸不匹配');
+  const faithful = join(root, `questions/${q.id}-faithful.png`);
+  await save(
+    faithful,
+    await sharp({ create: { width, height, channels: 3, background: '#fff' } })
+      .composite(layers)
+      .png()
+      .toBuffer(),
+  );
+  const enhanced = await preview(q.path, join(root, `qa/${q.id}-preview.png`));
+  const plain = await preview(
+    faithful,
+    join(root, `qa/${q.id}-faithful-preview.png`),
+  );
+  artifacts.push(faithful, enhanced.path, plain.path);
+  return { faithful, enhanced, plain, artifacts };
+}
+
+async function crop({ root, id, base, geometry: g, figures, attempt }) {
+  const artifacts = [];
+  const result = [];
+  const m = await sharp(base).metadata();
+  if (m.width !== g.sourceWidth || m.height !== g.sourceHeight)
+    throw new Error('配图底图与预览不匹配');
+  for (const [i, figure] of figures.entries()) {
+    const b = toPixels(figure.box, g, 12);
+    const path = join(root, `figures/${id}-${i + 1}-a${attempt}.png`);
+    await save(path, await sharp(base).extract(b).png().toBuffer());
+    const p = await preview(
+      path,
+      join(root, `qa/${id}-${i + 1}-a${attempt}.png`),
+    );
+    const overlay = join(root, `qa/${id}-${i + 1}-a${attempt}-box.png`);
+    const svg = Buffer.from(
+      `<svg xmlns="http://www.w3.org/2000/svg" width="${g.width}" height="${g.height}"><rect x="${b.left * g.scaleX}" y="${b.top * g.scaleY}" width="${b.width * g.scaleX}" height="${b.height * g.scaleY}" fill="none" stroke="red" stroke-width="2"/></svg>`,
+    );
+    await save(
+      overlay,
+      await sharp(g.path)
+        .composite([{ input: svg, top: 0, left: 0 }])
+        .png()
+        .toBuffer(),
+    );
+    result.push({
+      ...figure,
+      path,
+      preview: p.path,
+      overlay,
+      sourceBox: b,
+      width: b.width,
+      height: b.height,
+    });
+    artifacts.push(path, p.path, overlay);
+  }
+  return { figures: result, artifacts };
+}
+
+/** Same-target, nearby side-by-side figures are one group. Distant fragments
+ * stay separate; the subsequent visual check still decides completeness/ownership. */
+export function groupFigures(figures) {
+  const groups = figures.map((f) => ({
+    ...f,
+    box: { ...f.box },
+    members: [f.id],
+  }));
+  for (let i = 0; i < groups.length; i++) {
+    for (let j = i + 1; j < groups.length; j++) {
+      const a = groups[i];
+      const b = groups[j];
+      if (a.kind !== 'figure' || b.kind !== 'figure') continue;
+      const overlap =
+        Math.min(a.box.y + a.box.height, b.box.y + b.box.height) -
+        Math.max(a.box.y, b.box.y);
+      const gap =
+        Math.max(a.box.x, b.box.x) -
+        Math.min(a.box.x + a.box.width, b.box.x + b.box.width);
+      // The normalized gap can include a wide printed gutter (q16's 图(1)/图(2)
+      // is about 175/1000 apart). Keep it as one crop while refusing distant
+      // figures; vertically separated fragments such as q5 remain independent.
+      if (overlap < 0.3 * Math.min(a.box.height, b.box.height) || gap > 200)
+        continue;
+      const x = Math.min(a.box.x, b.box.x);
+      const y = Math.min(a.box.y, b.box.y);
+      a.box = {
+        x,
+        y,
+        width: Math.max(a.box.x + a.box.width, b.box.x + b.box.width) - x,
+        height: Math.max(a.box.y + a.box.height, b.box.y + b.box.height) - y,
+      };
+      a.members.push(...b.members);
+      a.description += `；${b.description}`;
+      groups.splice(j, 1);
+      i = -1;
+      break;
+    }
+  }
+  return groups;
+}
+
+export function checkDetail(q, detail) {
+  if (detail.question_id !== q.sourceId || detail.observed_number !== q.number)
+    return '目标题号与实际观察题号不匹配';
+  if (!['ready', 'partial'].includes(detail.status))
+    return detail.reason || '原题内容无法确认';
+  if (!detail.blocks.some((b) => b.text.trim())) return '未得到可编辑题干';
+  const unsupported = detail.blocks.flatMap((block) =>
+    unsupportedMathCommands(block.text),
+  );
+  if (unsupported.length)
+    return `公式包含暂不支持的数学标记：${[...new Set(unsupported)].map((name) => `\\${name}`).join('、')}`;
+  if (
+    detail.figures.some((f) => !validBox(f.box)) ||
+    new Set(detail.figures.map((f) => f.id)).size !== detail.figures.length
+  )
+    return '配图坐标或分组不明确';
+  const missing = detailMissingParts(q, detail);
+  if (missing.some((part) => part.kind !== 'figure'))
+    return missing.map((part) => part.reason).join('；');
+  if (detail.status === 'partial' && !missing.length)
+    return '题目自报局部缺失，但没有说明缺失内容';
+  return '';
+}
+
+export function detailMissingParts(q, detail) {
+  const parts = [...(detail.missing_parts ?? [])];
+  for (const part of q.missing_parts ?? [])
+    parts.push({
+      ...part,
+      source_limited: q.content_status === 'source_truncated',
+    });
+  const legacyFigureWarning = (q.warnings ?? []).find(
+    (warning) =>
+      /(?:图|数轴).*(?:未找到|缺失|未.*(?:观察|出现))/.test(warning) ||
+      /(?:未找到|缺失|未.*(?:观察|出现)).*(?:图|数轴)/.test(warning),
+  );
+  if (legacyFigureWarning && !detail.figures.length)
+    parts.push({
+      kind: 'figure',
+      reason: legacyFigureWarning,
+      source_limited: q.content_status === 'source_truncated',
+    });
+  return parts.filter(
+    (part, index) =>
+      part?.reason &&
+      parts.findIndex(
+        (candidate) =>
+          candidate.kind === part.kind && candidate.reason === part.reason,
+      ) === index &&
+      (!part.source_limited ||
+        parts.findIndex(
+          (candidate) =>
+            candidate.kind === part.kind && candidate.source_limited,
+        ) === index),
+  );
+}
+
+export function answerLines(type, mode, figures) {
+  const base = Math.max(type === 'long' ? 12 : 6, figures ? 10 : 0);
+  return Math.max(
+    2,
+    Math.round(
+      base * (mode === 'compact' ? 0.65 : mode === 'generous' ? 1.45 : 1),
+    ),
+  );
+}
+
+export function missingLabel(reason = '') {
+  if (/超时|timeout|时限/i.test(reason)) return '识别服务超时，请稍后补全。';
+  if (/配图|数轴|缺图/.test(reason))
+    return '必要配图缺失或不完整，请补拍完整题目。';
+  if (/不匹配|归属|多个章节/.test(reason))
+    return '题目归属无法确认，请补充题号或章节。';
+  if (/未找到/.test(reason)) return '指定题目未找到，请补充该题图片。';
+  return '原题内容尚未完整识别，请补充清晰完整的图片。';
+}
+
+const MATH_COMMANDS = {
+  angle: '∠',
+  cdot: '·',
+  cos: 'cos',
+  div: '÷',
+  ge: '≥',
+  geq: '≥',
+  in: '∈',
+  infty: '∞',
+  le: '≤',
+  leq: '≤',
+  ln: 'ln',
+  log: 'log',
+  neq: '≠',
+  notin: '∉',
+  parallel: '∥',
+  perp: '⊥',
+  pi: 'π',
+  pm: '±',
+  quad: ' ',
+  qquad: '  ',
+  sin: 'sin',
+  tan: 'tan',
+  times: '×',
+};
+
+const STRUCTURED_MATH_COMMANDS = new Set([
+  'dfrac',
+  'frac',
+  'left',
+  'mathrm',
+  'right',
+  'sqrt',
+  'text',
+  'tfrac',
+]);
+
+export function containsMathMarkup(block) {
+  return block.kind === 'formula' || /\\[A-Za-z]+/.test(block.text);
+}
+
+export function unsupportedMathCommands(text) {
+  return [
+    ...new Set(
+      [...String(text ?? '').matchAll(/\\([A-Za-z]+)/g)]
+        .map((match) => match[1])
+        .filter(
+          (name) =>
+            !(name in MATH_COMMANDS) && !STRUCTURED_MATH_COMMANDS.has(name),
+        ),
+    ),
+  ];
+}
+
+/** Convert the small TeX-like interchange form returned by vision models into
+ * native Word OMML. The source syntax stays in manifest.json for auditing; it
+ * must never leak into the learner-facing document. */
+export function mathComponents(source) {
+  const input = String(source ?? '');
+  let index = 0;
+
+  const group = () => {
+    while (/\s/.test(input[index] ?? '')) index++;
+    if (input[index] !== '{') return atom();
+    index++;
+    const value = sequence('}');
+    if (input[index] === '}') index++;
+    return value;
+  };
+
+  const command = () => {
+    index++; // backslash
+    const start = index;
+    while (/[A-Za-z]/.test(input[index] ?? '')) index++;
+    const name = input.slice(start, index);
+    if (!name) return [new MathRun(input[index++] ?? '')];
+    if (name === 'frac' || name === 'dfrac' || name === 'tfrac')
+      return [new MathFraction({ numerator: group(), denominator: group() })];
+    if (name === 'sqrt') return [new MathRadical({ children: group() })];
+    if (name === 'text' || name === 'mathrm') return group();
+    if (name === 'left' || name === 'right') return [];
+    if (!(name in MATH_COMMANDS))
+      throw new Error(`不支持的数学公式标记：\\${name}`);
+    return [new MathRun(MATH_COMMANDS[name])];
+  };
+
+  const atom = () => {
+    if (index >= input.length) return [];
+    if (input[index] === '\\') return command();
+    if (input[index] === '{') return group();
+    return [new MathRun(input[index++])];
+  };
+
+  const script = () => {
+    while (/\s/.test(input[index] ?? '')) index++;
+    return group();
+  };
+
+  const sequence = (until = '') => {
+    const out = [];
+    while (index < input.length && (!until || input[index] !== until)) {
+      let base = atom();
+      if (!base.length) continue;
+      let subScript;
+      let superScript;
+      while (input[index] === '_' || input[index] === '^') {
+        const marker = input[index++];
+        if (marker === '_') subScript = script();
+        else superScript = script();
+      }
+      if (subScript && superScript)
+        base = [
+          new MathSubSuperScript({ children: base, subScript, superScript }),
+        ];
+      else if (subScript)
+        base = [new MathSubScript({ children: base, subScript })];
+      else if (superScript)
+        base = [new MathSuperScript({ children: base, superScript })];
+      out.push(...base);
+    }
+    return out;
+  };
+
+  return sequence();
+}
+
+function blockRuns(block) {
+  if (containsMathMarkup(block))
+    return [new OfficeMath({ children: mathComponents(block.text) })];
+  return [new TextRun({ text: block.text, font: '宋体' })];
+}
+
+export async function build({ root, manifest }) {
+  const renderable = (q) => ['success', 'partial'].includes(q.status);
+  const ready = manifest.questions.filter(renderable).length;
+  const complete = manifest.questions.filter(
+    (q) => q.status === 'success',
+  ).length;
+  const partial = manifest.questions.filter(
+    (q) => q.status === 'partial',
+  ).length;
+  if (!ready) throw new Error('没有成功题，不能生成伪成品');
+  const children = [
+    new Paragraph({
+      children: [new TextRun({ text: '错题练习册', bold: true, size: 32 })],
+      spacing: { after: 180 },
+      keepNext: true,
+    }),
+    new Paragraph({
+      children: [
+        new TextRun(
+          `完整整理 ${complete} 题，局部待补 ${partial} 题，无法整理 ${manifest.questions.length - ready} 题`,
+        ),
+      ],
+      spacing: { after: 180 },
+      keepNext: true,
+    }),
+  ];
+  for (const [index, q] of manifest.questions.entries()) {
+    const isChoice = q.blocks?.some((b) => b.kind === 'option');
+    children.push(
+      new Paragraph({
+        pageBreakBefore: index > 0,
+        keepNext: true,
+        children: [
+          new TextRun({
+            text: `第${q.number}题${q.status === 'partial' ? '（配图待补）' : q.status === 'success' ? '' : '待补全'}`,
+            bold: true,
+          }),
+        ],
+        spacing: { after: 100 },
+      }),
+    );
+    if (renderable(q)) {
+      let renderBlocks = (q.blocks ?? []).map((block) => ({ ...block }));
+      // The header already identifies the target. Bare A–D labels are retained
+      // inside verified graphic options, not repeated as four empty paragraphs.
+      const options = renderBlocks.filter((b) => b.kind === 'option');
+      if (
+        q.figures.length &&
+        options.length > 1 &&
+        options.every((b) => /^[A-D][.．、]?\s*$/.test(b.text.trim()))
+      )
+        renderBlocks = renderBlocks.filter((b) => b.kind !== 'option');
+      else if (
+        options.length > 1 &&
+        options.every((b) => b.text.length <= 18 && !b.text.includes('\n')) &&
+        // 含公式标记的选项不能拼进同一个纯文本块：合并会把多个独立
+        // OfficeMath 塌缩成一个，字符串拼接出的假"公式"里混进 A/B/C/D
+        // 字母和分隔空格，既破坏可读性也让 validate() 的公式计数对不上
+        // （真实端到端跑卷纸.jpg 第9题 A/C 选项都是分数选项时实测触发）。
+        !options.some(containsMathMarkup)
+      ) {
+        let inserted = false;
+        renderBlocks = renderBlocks.flatMap((b) => {
+          if (b.kind !== 'option') return [b];
+          if (inserted) return [];
+          inserted = true;
+          return [
+            {
+              kind: 'option',
+              text: options.map((o) => o.text).join('    '),
+            },
+          ];
+        });
+      }
+      if (renderBlocks[0] && /^\d+$/.test(q.number))
+        renderBlocks[0] = {
+          ...renderBlocks[0],
+          text: renderBlocks[0].text.replace(
+            new RegExp(`^\\s*${q.number}\\s*[.．、]\\s*`),
+            '',
+          ),
+        };
+      for (const block of renderBlocks)
+        children.push(
+          new Paragraph({
+            keepNext: true,
+            children: blockRuns(block),
+            spacing: { after: 100 },
+          }),
+        );
+      const ratios = q.figures.map((f) =>
+        Math.min(1, 620 / f.width, 300 / f.height),
+      );
+      const height = q.figures.reduce(
+        (sum, f, i) => sum + f.height * ratios[i],
+        0,
+      );
+      const fit = Math.min(1, 300 / Math.max(1, height));
+      for (const [i, f] of q.figures.entries()) {
+        const ratio = ratios[i] * fit;
+        children.push(
+          new Paragraph({
+            keepNext: true,
+            children: [
+              new ImageRun({
+                type: 'png',
+                data: await readFile(f.path),
+                transformation: {
+                  width: Math.max(1, Math.round(f.width * ratio)),
+                  height: Math.max(1, Math.round(f.height * ratio)),
+                },
+                altText: {
+                  title: f.id,
+                  description: f.description,
+                  name: f.id,
+                },
+              }),
+            ],
+          }),
+        );
+      }
+      if (q.status === 'partial')
+        for (const part of q.missingParts ?? [])
+          children.push(
+            new Paragraph({
+              keepNext: true,
+              children: [
+                new TextRun({
+                  text: part.source_limited
+                    ? `配图待补：原照片未拍到完整内容。${part.reason}`
+                    : `配图待补：${part.reason}`,
+                  color: '808080',
+                  italics: true,
+                }),
+              ],
+              spacing: { after: 100 },
+            }),
+          );
+    } else
+      children.push(
+        new Paragraph({
+          keepNext: true,
+          children: [new TextRun(missingLabel(q.reason))],
+        }),
+      );
+    const n = answerLines(
+      isChoice ? 'short' : q.type,
+      manifest.answerSpace,
+      q.figures?.length,
+    );
+    q.answerLines = n;
+    // End keepNext at the first writing line; long questions may break naturally.
+    for (let i = 0; i < n; i++)
+      children.push(
+        new Paragraph({
+          children: [new TextRun(' ')],
+          spacing: {
+            before: 0,
+            after: 0,
+            line: 510,
+            lineRule: LineRuleType.EXACT,
+          },
+          border: {
+            bottom: {
+              color: 'E2E2E2',
+              style: BorderStyle.SINGLE,
+              size: 2,
+              space: 0,
+            },
+            between: {
+              color: 'E2E2E2',
+              style: BorderStyle.SINGLE,
+              size: 2,
+              space: 0,
+            },
+          },
+        }),
+      );
+  }
+  const doc = new Document({
+    styles: { default: { document: { run: { font: '宋体', size: 24 } } } },
+    sections: [
+      {
+        properties: {
+          page: {
+            size: { width: 11906, height: 16838 },
+            margin: { top: 1020, bottom: 1020, left: 1020, right: 1020 },
+          },
+        },
+        children,
+      },
+    ],
+  });
+  const path = join(root, 'wrong-questions.docx');
+  await save(path, await Packer.toBuffer(doc));
+  return { path, questions: manifest.questions, artifacts: [path] };
+}
+
+function xml(bytes) {
+  const issues = [];
+  const doc = new DOMParser({
+    onError: (level, message) => {
+      if (level !== 'warning') issues.push(message);
+    },
+  }).parseFromString(strFromU8(bytes), 'text/xml');
+  if (issues.length) throw new Error(`DOCX XML无效：${issues.join(';')}`);
+  return doc;
+}
+export async function validate({ path, manifest }) {
+  const entries = unzipSync(await readFile(path));
+  for (const name of [
+    '[Content_Types].xml',
+    '_rels/.rels',
+    'word/document.xml',
+    'word/_rels/document.xml.rels',
+  ])
+    if (!entries[name]?.length) throw new Error(`DOCX缺少${name}`);
+  for (const [name, bytes] of Object.entries(entries)) {
+    if (!name.endsWith('/') && !bytes.length)
+      throw new Error(`DOCX空文件：${name}`);
+    if (!name.endsWith('.rels')) continue;
+    const rels = xml(bytes).getElementsByTagName('Relationship');
+    const base =
+      name === '_rels/.rels' ? '' : name.slice(0, name.lastIndexOf('/_rels/'));
+    for (const r of Array.from(rels)) {
+      if (r.getAttribute('TargetMode') === 'External') continue;
+      const target = r.getAttribute('Target');
+      const resolved = target.startsWith('/')
+        ? target.slice(1)
+        : join(base, target).replaceAll('\\', '/');
+      if (!entries[resolved]?.length)
+        throw new Error(`DOCX关系目标缺失：${resolved}`);
+    }
+  }
+  const document = xml(entries['word/document.xml']);
+  const texts = Array.from(document.getElementsByTagName('w:t')).map(
+    (n) => n.textContent,
+  );
+  const mathTexts = Array.from(document.getElementsByTagName('m:t')).map(
+    (n) => n.textContent,
+  );
+  const content = [...texts, ...mathTexts].join('\n');
+  const expectedMath = manifest.questions.flatMap((q) =>
+    ['success', 'partial'].includes(q.status)
+      ? (q.blocks ?? []).filter((block) => containsMathMarkup(block))
+      : [],
+  ).length;
+  const actualMath = document.getElementsByTagName('m:oMath').length;
+  if (actualMath !== expectedMath)
+    throw new Error(`DOCX原生公式数不符：${actualMath}/${expectedMath}`);
+  if (/\\[A-Za-z]+/.test(content)) throw new Error('DOCX正文泄漏了LaTeX控制串');
+  for (const q of manifest.questions) {
+    const title = `第${q.number}题${q.status === 'partial' ? '（配图待补）' : q.status === 'success' ? '' : '待补全'}`;
+    if (!texts.includes(title)) throw new Error(`DOCX缺少${title}`);
+    for (const block of q.blocks ?? [])
+      if (
+        ['success', 'partial'].includes(q.status) &&
+        !containsMathMarkup(block) &&
+        !content.includes(block.text)
+      )
+        throw new Error(`DOCX缺少第${q.number}题文字块`);
+  }
+  const expected = manifest.questions.flatMap((q) =>
+    ['success', 'partial'].includes(q.status) ? q.figures : [],
+  ).length;
+  const drawings = document.getElementsByTagName('w:drawing').length;
+  if (drawings !== expected)
+    throw new Error(`DOCX图片数不符：${drawings}/${expected}`);
+  const rels = Array.from(
+    xml(entries['word/_rels/document.xml.rels']).getElementsByTagName(
+      'Relationship',
+    ),
+  );
+  for (const b of Array.from(document.getElementsByTagName('a:blip')))
+    if (!rels.some((r) => r.getAttribute('Id') === b.getAttribute('r:embed')))
+      throw new Error('DOCX媒体引用失效');
+  return {
+    passed: true,
+    questions: manifest.questions.length,
+    images: expected,
+    formulas: expectedMath,
+  };
+}
+
+function run(bin, args) {
+  const r = spawnSync(bin, args, {
+    encoding: 'utf8',
+    timeout: 120000,
+    maxBuffer: 8 * 1024 * 1024,
+  });
+  if (r.error || r.status !== 0)
+    throw new Error(`${bin}执行失败：${r.error?.message ?? r.stderr}`);
+  return r.stdout;
+}
+async function resolveOffice() {
+  if (process.platform === 'darwin')
+    return '/Applications/LibreOffice.app/Contents/MacOS/soffice';
+  if (process.platform === 'win32') {
+    // Windows 安装 LibreOffice 默认不写入 PATH，裸 'soffice' 在很多机器上解析不到
+    // ——真实端到端测试实测触发。probe 常见安装目录，找不到再退回裸命令名，
+    // 兼容确实把它加进 PATH 的机器。
+    for (const candidate of [
+      'C:\\Program Files\\LibreOffice\\program\\soffice.exe',
+      'C:\\Program Files (x86)\\LibreOffice\\program\\soffice.exe',
+    ]) {
+      if (await stat(candidate).catch(() => null)) return candidate;
+    }
+  }
+  return 'soffice';
+}
+export async function render({ path, root }) {
+  const dir = join(root, 'qa/rendered');
+  await mkdir(dir, { recursive: true });
+  const office = await resolveOffice();
+  const profile = await mkdtemp(join(tmpdir(), 'wq-docx-office-'));
+  run(office, [
+    `-env:UserInstallation=${pathToFileURL(profile).href}`,
+    '--headless',
+    '--convert-to',
+    'pdf',
+    '--outdir',
+    root,
+    path,
+  ]);
+  const pdf = join(root, `${basename(path, '.docx')}.pdf`);
+  if (!(await stat(pdf)).size) throw new Error('PDF为空');
+  run('pdftoppm', ['-scale-to', '1600', '-png', pdf, join(dir, 'page')]);
+  const { readdir } = await import('node:fs/promises');
+  const pages = (await readdir(dir))
+    .filter((n) => /^page-\d+\.png$/.test(n))
+    .sort((a, b) => a.localeCompare(b, undefined, { numeric: true }))
+    .map((n) => join(dir, n));
+  if (!pages.length) throw new Error('未生成渲染页面');
+  return { pdf, pages, artifacts: [pdf, ...pages] };
+}
+
+const actions = {
+  prepare,
+  crop,
+  build,
+  validate,
+  render,
+  selection: async ({ text }) => parseSelection(text),
+  select: async ({ manifest, selection }) =>
+    selectQuestions(manifest, selection),
+  detail: async ({ question, detail }) => {
+    const reason = checkDetail(question, detail);
+    const missingParts = reason ? [] : detailMissingParts(question, detail);
+    return {
+      reason,
+      status: missingParts.length ? 'partial' : 'success',
+      missingParts,
+      figures: reason ? [] : groupFigures(detail.figures),
+    };
+  },
+  absolute: async ({ path }) => resolve(path),
+};
+if (
+  process.argv[1] &&
+  import.meta.url === pathToFileURL(resolve(process.argv[1])).href
+) {
+  try {
+    const [action, payload] = process.argv.slice(2);
+    if (!Object.hasOwn(actions, action)) throw new Error('未知操作');
+    console.log(
+      JSON.stringify(
+        await actions[action](JSON.parse(await readFile(payload, 'utf8'))),
+      ),
+    );
+  } catch (e) {
+    console.error(e.stack || String(e));
+    process.exitCode = 1;
+  }
+}