@xiaobuyu/nodesign 0.0.1

package/server/lib/docx/text-lint.js

@@ -0,0 +1,225 @@
+/**
+ * text-lint.js — 构建后的字符层/版式层体检（2026-08-19）。
+ *
+ * 闭合 schema 管格式键、渲染目视管版面，**文字符号这一层两边都管不着**：
+ * 斜杠带不带空格不一致、`12ms` 缺空隙、中文后面跟半角逗号 —— 人眼查全文
+ * 一致性不可靠，正则穷举才靠得住。检查跑在 **content 源**上（不解 docx），
+ * 每条发现都能定位到具体块。
+ *
+ * 三条设计红线（放宽任何一条都会把这层变成噪音）：
+ *   1. **只收高精度规则**。假警报会训练 agent 忽略警报 —— 拿不准的宁可不报。
+ *   2. **一致性类规则全文聚合后才裁决**：两种写法并存才是问题，全文统一用
+ *      哪种都不是（斜杠风格、中西文间距都是排版偏好，不是对错）。
+ *   3. **只报不改**。文字内容是 agent/用户的，引擎不代笔。
+ *
+ * 两档措辞：`errors` = 按 GB/T 15834 / 排版常识基本可断定是错的；
+ * `notes` = 建议（惯例/一致性），采不采纳由写的人定。都不挡构建。
+ */
+
+import { effectiveSizePt } from './build.js';
+
+const CJK = '\\u4e00-\\u9fff\\u3400-\\u4dbf';
+
+/** 一个段落块 → 拼好的纯文本（run 边界处的间距问题也要能查到，所以先拼再扫） */
+function textOfPara(b) {
+  if (typeof b?.text === 'string') return b.text;
+  const parts = [];
+  for (const r of b?.runs ?? []) {
+    if (typeof r === 'string') parts.push(r);
+    else if (r && typeof r.text === 'string') parts.push(r.text);
+    else if (r?.br) parts.push('\n');
+    // fld（页码域）没有文字形态，跳过
+  }
+  return parts.join('');
+}
+
+/** content + 页眉页脚 + 表格单元格 → [{ where, text }]，where 能定位回源 */
+export function collectTexts(content, opts = {}) {
+  const out = [];
+  const push = (where, b) => {
+    const t = textOfPara(b);
+    if (t.trim()) out.push({ where, text: t });
+  };
+  for (const [i, b] of (content ?? []).entries()) {
+    if (!b || typeof b !== 'object') continue;
+    if (b.t === 'p') push(`content[${i}]`, b);
+    else if (b.t === 'table') {
+      for (const [ri, row] of (b.rows ?? []).entries()) {
+        for (const [ci, cell] of (row ?? []).entries()) {
+          if (typeof cell === 'string') { if (cell.trim()) out.push({ where: `content[${i}].rows[${ri}][${ci}]`, text: cell }); }
+          else if (cell && typeof cell === 'object') push(`content[${i}].rows[${ri}][${ci}]`, cell);
+        }
+      }
+    }
+  }
+  for (const [name, blocks] of [['header', opts.header], ['footer', opts.footer]]) {
+    for (const [i, b] of (blocks ?? []).entries()) {
+      if (b?.t === 'p') push(`${name}[${i}]`, b);
+    }
+  }
+  return out;
+}
+
+/** 命中清单 → 一行报文：最多点名 4 处，多的收成 ×N */
+function fmtHits(hits, max = 4) {
+  const shown = hits.slice(0, max).map(h => `${h.where}「${h.sample}」`).join('、');
+  return hits.length > max ? `${shown} 等 ${hits.length} 处` : shown;
+}
+
+/** 在 text 里跑正则收命中（sample 带一点上下文，agent 才对得上号） */
+function scan(texts, re) {
+  const hits = [];
+  for (const { where, text } of texts) {
+    for (const m of text.matchAll(re)) {
+      const s = Math.max(0, m.index - 4);
+      hits.push({ where, sample: text.slice(s, m.index + m[0].length + 4).replace(/\n/g, ' ') });
+    }
+  }
+  return hits;
+}
+
+export function lintDocxSource({ tokens, content, opts = {} }) {
+  const errors = [];
+  const notes = [];
+  const texts = collectTexts(content, opts);
+
+  /* ── 错误档（基本可断定是错的） ── */
+
+  // 重复标点：「。。」「，，」几乎必是手误。！？的叠用是修辞，不管
+  for (const [re, label] of [[new RegExp('([，。；、：])\\1+', 'g'), '重复标点']]) {
+    const hits = scan(texts, re);
+    if (hits.length) errors.push(`${label}：${fmtHits(hits)}`);
+  }
+
+  // 括号全半角不配对：「（x)」「(x）」
+  {
+    const hits = scan(texts, /（[^（）()\n]*\)|\([^()（）\n]*）/g);
+    if (hits.length) errors.push(`括号全半角不配对：${fmtHits(hits)}`);
+  }
+
+  // 中文后紧跟半角标点（GB/T 15834：中文语境用全角）。只查后继是中文/空白/行尾
+  // 的情形 —— 「12:30」「Node.js, Express」这类西文语境不碰
+  {
+    const hits = scan(texts, new RegExp(`[${CJK}][,;?!:](?=[${CJK}\\s]|$)`, 'gm'));
+    if (hits.length) errors.push(`中文后面跟着半角标点（该用全角）：${fmtHits(hits)}`);
+  }
+
+  /* ── 建议档：单点惯例 ── */
+
+  // 数值与单位符号之间留空隙（GB 3100 惯例）。单位表故意收窄：裸 s/m/g 歧义太大
+  {
+    const hits = scan(texts, /\d(?:ms|GB|MB|KB|TB|Hz|kHz|MHz|fps|mm|cm|km|kg|dpi)(?![A-Za-z])/g);
+    if (hits.length) notes.push(`数字和单位之间通常留一个空格（如「150 ms」）：${fmtHits(hits)}`);
+  }
+
+  /* ── 建议档：一致性类（全文聚合，两种写法并存才报） ── */
+
+  // 中西文之间的空格。数字不算（「第3个」加空格属于过度矫正），URL 整段跳过
+  {
+    let spaced = 0;
+    const unspaced = [];
+    for (const { where, text } of texts) {
+      const t = text.replace(/\S*:\/\/\S*/g, ' ');
+      for (const m of t.matchAll(new RegExp(`[${CJK}][A-Za-z]|[A-Za-z][${CJK}]`, 'g'))) {
+        unspaced.push({ where, sample: t.slice(Math.max(0, m.index - 4), m.index + m[0].length + 4) });
+      }
+      spaced += (t.match(new RegExp(`[${CJK}] [A-Za-z]|[A-Za-z] [${CJK}]`, 'g')) ?? []).length;
+    }
+    if (unspaced.length && spaced > unspaced.length) {
+      notes.push(`中西文之间的空格不一致：全文 ${spaced} 处有空格，这 ${unspaced.length} 处没有 —— ${fmtHits(unspaced)}`);
+    }
+    // 全文都不空 = 一种自洽的风格，不报
+  }
+
+  // 斜杠两侧空格的一致性。三类豁免：带协议的 URL、无协议的域名路径
+  //（github.com/xxx —— 给它"统一"加空格反而是改错）、两侧都是数字的（日期 03/07）
+  {
+    const spaced = [];
+    const tight = [];
+    for (const { where, text } of texts) {
+      const t = text.replace(/\S*:\/\/\S*/g, ' ');
+      for (const m of t.matchAll(/([\w.\-一-鿿]+) ?\/ ?([\w.\-一-鿿])/g)) {
+        if (/\.[a-z]{2,4}$/i.test(m[1])) continue;   // 左边以 .com/.cn/.js 这类结尾 = 域名或文件名
+        if (/\d$/.test(m[1]) && /\d/.test(m[2])) continue;
+        (m[0].includes(' ') ? spaced : tight).push({ where, sample: t.slice(Math.max(0, m.index - 3), m.index + m[0].length + 6) });
+      }
+    }
+    if (spaced.length && tight.length) {
+      const [minor, label] = spaced.length < tight.length ? [spaced, '带空格'] : [tight, '不带空格'];
+      notes.push(`斜杠写法不一致（${spaced.length} 处「A / B」vs ${tight.length} 处「A/B」），少数派是${label}的：${fmtHits(minor)}`);
+    }
+  }
+
+  // 日期范围连接号的一致性（字符本身不裁 —— 「-」「–」「至」都是有人在用的惯例，
+  // 一份文档里混着用才是问题）
+  {
+    const styles = new Map();   // 连接串 → hits
+    for (const { where, text } of texts) {
+      for (const m of text.matchAll(/\d{4}[.．年/-]\d{1,2}[月]?( ?[-–—~～至] ?)(?=\d{4}|至今|今)/g)) {
+        const key = m[1];
+        if (!styles.has(key)) styles.set(key, []);
+        styles.get(key).push({ where, sample: text.slice(Math.max(0, m.index), m.index + m[0].length + 7) });
+      }
+    }
+    if (styles.size > 1) {
+      const desc = [...styles.entries()].map(([k, v]) => `「${k.replace(/ /g, '␣')}」×${v.length}`).join('、');
+      notes.push(`日期范围的连接号写法不统一：${desc}`);
+    }
+  }
+
+  /* ── 版式断言（token 层，只收零误报的三条） ── */
+
+  // 行距小于单倍 = 文字上下行叠压，多半是把磅值当倍数写了
+  const checkSp = (whereName, sp) => {
+    if (sp && (sp.lineRule ?? 'multiple') === 'multiple' && sp.line != null && sp.line < 1) {
+      errors.push(`${whereName}.spacing.line = ${sp.line}（倍数小于 1，文字会叠压）`);
+    }
+  };
+  checkSp('base', tokens?.base?.spacing);
+  for (const [id, st] of Object.entries(tokens?.styles ?? {})) {
+    checkSp(`styles.${id}.para`, st?.para?.spacing);
+
+    // 标题（有 outlineLevel 的）不带 keepNext → 会孤零零留在页底
+    if (st?.para?.outlineLevel != null && st.para.keepNext !== true) {
+      notes.push(`styles.${id} 是标题（outlineLevel ${st.para.outlineLevel}）但没写 keepNext —— 分页时它可能孤零零留在页底`);
+    }
+  }
+
+  // 标题层级字号倒挂：更深一级的某个标题比浅一级的某个标题还大。
+  // 同层可以有多种字号（Title 和 Heading1 常同在层级 0），所以比的是
+  // 浅层的**最小**对深层的**最大** —— 只要深层最大越过了浅层最小就是倒挂
+  {
+    const byLevel = new Map();   // level → { min: {id,pt}, max: {id,pt} }
+    for (const [id, st] of Object.entries(tokens?.styles ?? {})) {
+      const lv = st?.para?.outlineLevel;
+      if (lv == null) continue;
+      const pt = effectiveSizePt(tokens, id);
+      const e = byLevel.get(lv) ?? { min: { id, pt }, max: { id, pt } };
+      if (pt < e.min.pt) e.min = { id, pt };
+      if (pt > e.max.pt) e.max = { id, pt };
+      byLevel.set(lv, e);
+    }
+    const levels = [...byLevel.keys()].sort((a, b) => a - b);
+    for (let i = 1; i < levels.length; i++) {
+      const hi = byLevel.get(levels[i - 1]).min;
+      const lo = byLevel.get(levels[i]).max;
+      if (lo.pt > hi.pt) {
+        notes.push(`标题字号倒挂：${lo.id}（层级 ${levels[i]}，${lo.pt}pt）比 ${hi.id}（层级 ${levels[i - 1]}，${hi.pt}pt）还大`);
+      }
+    }
+  }
+
+  return { errors, notes };
+}
+
+/** 给 build_docx 的返回文案拼提醒段。空的返回 ''（一个字都不占） */
+export function formatLint({ errors, notes }, max = 10) {
+  const lines = [];
+  for (const e of errors) lines.push(`⚠ ${e}`);
+  for (const n of notes) lines.push(`· ${n}`);
+  if (!lines.length) return '';
+  const shown = lines.slice(0, max);
+  const more = lines.length - shown.length;
+  return `\n\n排版/符号体检（${errors.length} 条较确定的问题，${notes.length} 条建议 —— 不挡构建，采不采纳你判断，改了记得重新 build）：\n`
+    + shown.join('\n') + (more > 0 ? `\n（另有 ${more} 条略去）` : '');
+}

package/server/lib/docx/tokens.js

@@ -0,0 +1,335 @@
+/**
+ * tokens.js — docx 形态的「真相源」：token JSON schema + 三个内置词典条目。
+ *
+ * 原则（已拍板）：
+ *   - token JSON 是权威，styles.xml/docDefaults 是构建产物；
+ *   - 风格名开放（agent 可以起新名字调 token），schema 闭合（字段全集在
+ *     这里，build 层只认识这些字段，不接受任意 XML 注入——外来文档的
+ *     未建模部分走 extraXml/rawStyles 透传，不走 token 字段扩张）。
+ *
+ * ── schema v1 ────────────────────────────────────────────────
+ * {
+ *   v: 1,
+ *   provenance: 'nodesign' | 'imported',   // imported = 外来 docx dump 出来的
+ *   page: {
+ *     size: 'A4'|'Letter'|{wTwip,hTwip}, landscape?: bool,
+ *     marginsTwip: {top,bottom,left,right,header,footer,gutter},
+ *     docGrid?: {type:'lines'|'linesAndChars', linePitchTwip, charSpace?}|null,
+ *   },
+ *   lang: {latin:'en-US', eastAsia:'zh-CN'},
+ *   fonts: {                            // 具名字体槽；style.run.font 用名字引用
+ *     body:{eastAsia,ascii,hAnsi?,cs?}, heading:{...}, quote:{...}, mono:{...}, ...自定义槽
+ *   },
+ *   base: {                             // docDefaults
+ *     sizePt: number|字号名, color:'RRGGBB',
+ *     font:'body'|{...},                // 引用字体槽
+ *     spacing?: {line,lineRule,beforePt,afterPt},
+ *     cjk: {kinsoku,autoSpaceDE,autoSpaceDN,adjustRightInd,snapToGrid,overflowPunct,wordWrap},
+ *   },
+ *   styles: { [styleId]: Style },
+ *   numbering?: { [numName]: {levels:[{fmt,text,indentTwip,hangingTwip,alignedAt?}]} },
+ *   rawStyles?: [xmlString],            // dump 时装不进模型的整条 w:style 原文
+ * }
+ *
+ * Style = {
+ *   type:'paragraph'|'character'|'table',
+ *   name: string,                       // Word UI 名（'heading 1' 等内置名有魔法含义）
+ *   basedOn?, next?, link?, qFormat?: bool, uiPriority?: number,
+ *   run?: {
+ *     font?:'body'|{eastAsia?,ascii?,hAnsi?,cs?}, sizePt?: number|字号名,
+ *     bold?, italic?, color?, underline?: true|'single'|'double'|...,
+ *     strike?, caps?, smallCaps?, vertAlign?:'superscript'|'subscript',
+ *     em?:'dot'|'comma'|'circle'|'underDot',   // 着重号
+ *     kernPt?: number, spacingTwip?: number, highlight?: string,
+ *   },
+ *   para?: {
+ *     align?:'left'|'center'|'right'|'both'|'distribute',
+ *     outlineLevel?: 0-8,
+ *     indent?: {firstLineChars?, firstLineTwip?, hangingChars?, hangingTwip?,
+ *               leftChars?, leftTwip?, rightChars?, rightTwip?},
+ *     spacing?: {beforePt?, afterPt?, beforeLines?, afterLines?,
+ *                line?: number, lineRule?:'multiple'|'exact'|'atLeast'},
+ *                // lineRule=multiple 时 line 是倍数(1.5)；exact/atLeast 时是磅
+ *     keepNext?, keepLines?, pageBreakBefore?, widowControl?, contextualSpacing?,
+ *     borders?: {top?,bottom?,left?,right?: {style,sizePt8?,color,spacePt?}},
+ *     shading?: 'RRGGBB',
+ *     tabs?: [{pos:twip, val:'left'|'center'|'right'|'decimal', leader?}],
+ *     cjk?: 覆盖 base.cjk 的同名开关,
+ *   },
+ *   extraXml?: {pPr?: string, rPr?: string},  // dump 透传，build 时原样并入
+ * }
+ */
+
+import { ZIHAO } from './units.js';
+import { validateNumbering } from './numbering.js';
+
+/** 词典条目一：办公标准（素颜 Word）——中文 Word 默认观感 */
+export function presetOffice() {
+  return {
+    v: 1,
+    provenance: 'nodesign',
+    page: {
+      size: 'A4',
+      marginsTwip: { top: 1440, bottom: 1440, left: 1800, right: 1800, header: 851, footer: 992, gutter: 0 },
+    },
+    lang: { latin: 'en-US', eastAsia: 'zh-CN' },
+    fonts: {
+      body: { eastAsia: '宋体', ascii: 'Calibri' },
+      heading: { eastAsia: '黑体', ascii: 'Arial' },
+      quote: { eastAsia: '楷体', ascii: 'Calibri' },
+      mono: { eastAsia: '宋体', ascii: 'Courier New' },
+    },
+    base: {
+      font: 'body', sizePt: '小四', color: '000000',
+      spacing: { line: 1.3, lineRule: 'multiple' },
+      cjk: { kinsoku: true, autoSpaceDE: true, autoSpaceDN: true, adjustRightInd: true, snapToGrid: true },
+    },
+    styles: {
+      Normal: { type: 'paragraph', name: 'Normal', qFormat: true, para: { indent: { firstLineChars: 200 } } },
+      Title: {
+        type: 'paragraph', name: 'Title', basedOn: 'Normal', next: 'Normal', qFormat: true,
+        run: { font: 'heading', sizePt: '二号', bold: true },
+        para: { align: 'center', indent: { firstLineChars: 0 }, spacing: { beforePt: 12, afterPt: 18 }, keepNext: true, outlineLevel: 0 },
+      },
+      Heading1: {
+        type: 'paragraph', name: 'heading 1', basedOn: 'Normal', next: 'Normal', qFormat: true,
+        run: { font: 'heading', sizePt: '三号', bold: true },
+        para: { indent: { firstLineChars: 0 }, spacing: { beforePt: 13, afterPt: 13 }, keepNext: true, outlineLevel: 0 },
+      },
+      Heading2: {
+        type: 'paragraph', name: 'heading 2', basedOn: 'Normal', next: 'Normal', qFormat: true,
+        run: { font: 'heading', sizePt: '四号', bold: true },
+        para: { indent: { firstLineChars: 0 }, spacing: { beforePt: 10, afterPt: 10 }, keepNext: true, outlineLevel: 1 },
+      },
+      Heading3: {
+        type: 'paragraph', name: 'heading 3', basedOn: 'Normal', next: 'Normal', qFormat: true,
+        run: { font: 'heading', sizePt: '小四', bold: true },
+        para: { indent: { firstLineChars: 0 }, spacing: { beforePt: 8, afterPt: 8 }, keepNext: true, outlineLevel: 2 },
+      },
+      Quote: {
+        type: 'paragraph', name: 'Quote', basedOn: 'Normal', qFormat: true,
+        run: { font: 'quote', color: '404040' },
+        para: { indent: { leftChars: 200, firstLineChars: 0 } },
+      },
+      Header: { type: 'paragraph', name: 'header', basedOn: 'Normal', para: { indent: { firstLineChars: 0 }, align: 'center' }, run: { sizePt: '小五' } },
+      Footer: { type: 'paragraph', name: 'footer', basedOn: 'Normal', para: { indent: { firstLineChars: 0 }, align: 'center' }, run: { sizePt: '小五' } },
+    },
+  };
+}
+
+/** 词典条目二：公文体（GB/T 9704-2012 版式硬指标） */
+export function presetGongwen() {
+  return {
+    v: 1,
+    provenance: 'nodesign',
+    page: {
+      size: 'A4',
+      // GB/T 9704: 上37 下35 左28 右26 (mm)
+      marginsTwip: { top: 2098, bottom: 1984, left: 1588, right: 1474, header: 851, footer: 992, gutter: 0 },
+      docGrid: { type: 'lines', linePitchTwip: 560 },   // 固定 28pt 行距的格
+    },
+    lang: { latin: 'zh-CN', eastAsia: 'zh-CN' },
+    fonts: {
+      body: { eastAsia: '仿宋_GB2312', ascii: 'Times New Roman' },
+      biaosong: { eastAsia: '方正小标宋简体', ascii: 'Times New Roman' },
+      hei: { eastAsia: '黑体', ascii: 'Times New Roman' },
+      kai: { eastAsia: '楷体_GB2312', ascii: 'Times New Roman' },
+      song: { eastAsia: '宋体', ascii: 'Times New Roman' },
+    },
+    base: {
+      font: 'body', sizePt: '三号', color: '000000',
+      spacing: { line: 28, lineRule: 'exact' },
+      cjk: { kinsoku: true, autoSpaceDE: false, autoSpaceDN: false, adjustRightInd: true, snapToGrid: true },
+    },
+    styles: {
+      Normal: { type: 'paragraph', name: 'Normal', qFormat: true, para: { indent: { firstLineChars: 200 } } },
+      // 发文机关标志（红头）
+      Hongtou: {
+        type: 'paragraph', name: '红头', basedOn: 'Normal', next: 'Normal',
+        run: { font: 'biaosong', sizePt: 32, color: 'FF0000', bold: false },
+        para: { align: 'center', indent: { firstLineChars: 0 }, spacing: { line: 40, lineRule: 'exact' } },
+      },
+      Fawenzihao: {
+        type: 'paragraph', name: '发文字号', basedOn: 'Normal', next: 'Normal',
+        para: { align: 'center', indent: { firstLineChars: 0 } },
+      },
+      GwTitle: {
+        type: 'paragraph', name: '公文标题', basedOn: 'Normal', next: 'Normal', qFormat: true,
+        // 标题前后各空一行（28pt）。用 pt 不用 beforeLines：lab/02 已证 LO 对
+        // 字符/行单位的兼容不可信，*Lines 同族，公文版式是硬指标不赌。
+        run: { font: 'biaosong', sizePt: '二号' },
+        para: { align: 'center', indent: { firstLineChars: 0 }, spacing: { beforePt: 28, afterPt: 28 }, keepNext: true, outlineLevel: 0 },
+      },
+      GwH1: {   // 一、 黑体
+        type: 'paragraph', name: '公文一级', basedOn: 'Normal', next: 'Normal', qFormat: true,
+        run: { font: 'hei' }, para: { keepNext: true, outlineLevel: 0 },
+      },
+      GwH2: {   // （一） 楷体
+        type: 'paragraph', name: '公文二级', basedOn: 'Normal', next: 'Normal', qFormat: true,
+        run: { font: 'kai' }, para: { keepNext: true, outlineLevel: 1 },
+      },
+      GwH3: {   // 1. 仿宋加粗
+        type: 'paragraph', name: '公文三级', basedOn: 'Normal', next: 'Normal', qFormat: true,
+        run: { bold: true }, para: { keepNext: true, outlineLevel: 2 },
+      },
+      Chaosong: {
+        type: 'paragraph', name: '抄送', basedOn: 'Normal',
+        run: { sizePt: '四号', font: 'body' }, para: { indent: { firstLineChars: 0 } },
+      },
+      Footer: { type: 'paragraph', name: 'footer', basedOn: 'Normal', para: { indent: { firstLineChars: 0 }, align: 'center' }, run: { font: 'song', sizePt: '四号' } },
+      Header: { type: 'paragraph', name: 'header', basedOn: 'Normal', para: { indent: { firstLineChars: 0 }, align: 'center' }, run: { font: 'song', sizePt: '小五' } },
+    },
+  };
+}
+
+/** 词典条目三：学术论文体（中文期刊/学位论文常规） */
+export function presetAcademic() {
+  return {
+    v: 1,
+    provenance: 'nodesign',
+    page: {
+      size: 'A4',
+      marginsTwip: { top: 1700, bottom: 1700, left: 1800, right: 1800, header: 851, footer: 992, gutter: 0 },
+    },
+    lang: { latin: 'en-US', eastAsia: 'zh-CN' },
+    fonts: {
+      body: { eastAsia: '宋体', ascii: 'Times New Roman' },
+      heading: { eastAsia: '黑体', ascii: 'Times New Roman' },
+      quote: { eastAsia: '楷体', ascii: 'Times New Roman' },
+      caption: { eastAsia: '宋体', ascii: 'Times New Roman' },
+      mono: { eastAsia: '宋体', ascii: 'Courier New' },
+    },
+    base: {
+      font: 'body', sizePt: '小四', color: '000000',
+      spacing: { line: 1.5, lineRule: 'multiple' },
+      cjk: { kinsoku: true, autoSpaceDE: true, autoSpaceDN: true, adjustRightInd: true, snapToGrid: true },
+    },
+    styles: {
+      Normal: { type: 'paragraph', name: 'Normal', qFormat: true, para: { indent: { firstLineChars: 200 } } },
+      Title: {
+        type: 'paragraph', name: 'Title', basedOn: 'Normal', next: 'Normal', qFormat: true,
+        run: { font: 'heading', sizePt: '三号', bold: true },
+        para: { align: 'center', indent: { firstLineChars: 0 }, spacing: { beforePt: 17, afterPt: 17 }, keepNext: true, outlineLevel: 0 },
+      },
+      Abstract: {
+        type: 'paragraph', name: '摘要', basedOn: 'Normal',
+        run: { sizePt: '五号', font: 'quote' },
+        para: { indent: { firstLineChars: 200 } },
+      },
+      Heading1: {
+        type: 'paragraph', name: 'heading 1', basedOn: 'Normal', next: 'Normal', qFormat: true,
+        run: { font: 'heading', sizePt: '四号', bold: true },
+        para: { indent: { firstLineChars: 0 }, spacing: { beforePt: 13, afterPt: 13 }, keepNext: true, outlineLevel: 0 },
+      },
+      Heading2: {
+        type: 'paragraph', name: 'heading 2', basedOn: 'Normal', next: 'Normal', qFormat: true,
+        run: { font: 'heading', sizePt: '小四', bold: true },
+        para: { indent: { firstLineChars: 0 }, spacing: { beforePt: 13, afterPt: 6 }, keepNext: true, outlineLevel: 1 },
+      },
+      Caption: {
+        type: 'paragraph', name: 'caption', basedOn: 'Normal', qFormat: true,
+        run: { font: 'caption', sizePt: '五号', bold: true },
+        para: { align: 'center', indent: { firstLineChars: 0 }, spacing: { beforePt: 6, afterPt: 6 } },
+      },
+      Quote: {
+        type: 'paragraph', name: 'Quote', basedOn: 'Normal', qFormat: true,
+        run: { font: 'quote' },
+        para: { indent: { leftChars: 200, firstLineChars: 0 } },
+      },
+      Header: { type: 'paragraph', name: 'header', basedOn: 'Normal', para: { indent: { firstLineChars: 0 }, align: 'center' }, run: { sizePt: '小五' } },
+      Footer: { type: 'paragraph', name: 'footer', basedOn: 'Normal', para: { indent: { firstLineChars: 0 }, align: 'center' }, run: { sizePt: '小五' } },
+    },
+  };
+}
+
+export const PRESETS = {
+  办公标准: presetOffice,
+  公文: presetGongwen,
+  学术论文: presetAcademic,
+};
+
+/** token 校验：字段闭合 —— 未知字段直接报错，防 schema 野蛮生长 */
+export const STYLE_KEYS = new Set(['type', 'name', 'basedOn', 'next', 'link', 'qFormat', 'uiPriority', 'run', 'para', 'extraXml']);
+export const RUN_KEYS = new Set(['font', 'sizePt', 'bold', 'italic', 'color', 'underline', 'strike', 'caps',
+  'smallCaps', 'vertAlign', 'em', 'kernPt', 'spacingTwip', 'highlight']);
+export const PARA_KEYS = new Set(['align', 'outlineLevel', 'indent', 'spacing', 'keepNext', 'keepLines',
+  'pageBreakBefore', 'widowControl', 'contextualSpacing', 'borders', 'shading', 'tabs', 'cjk', 'list']);
+
+/**
+ * 行距规则的合法值。
+ *
+ * ⚠️ 单独校验它是因为**写错这个字段不会静默失效，会静默生效成荒谬值**：
+ * `lineRule` 只有 'multiple' 时 `line` 才是倍数，其余按磅算。写 `'auto'`
+ * （CSS/OOXML 里都存在这个词，很容易顺手打出来）会落进磅值分支，
+ * `line: 360` 本意「1.5 倍」就变成每行 360 磅 = 5 英寸，正文整个被挤出页面。
+ * 只查键名的闭合 schema 挡不住这种，得查值。
+ */
+const LINE_RULES = new Set(['multiple', 'exact', 'atLeast']);
+
+/** 字号：数字直接用，字符串必须是字号名 */
+function badSize(v) {
+  return typeof v === 'string' && !(v in ZIHAO);
+}
+
+/**
+ * indent 里 firstLine* 和 hanging* 互斥。OOXML 的 w:ind 里它们是**同一个属性的
+ * 正负两面**（悬挂 = 负的首行缩进），同时给的话哪个生效随渲染器不同——LO 实测
+ * firstLine 覆盖 hanging，ECMA-376 又说 hanging 优先。写 `firstLineChars: 0` +
+ * `hangingChars` 的人是想"清掉继承的首行缩进再悬挂"，但悬挂本身就含这层意思，
+ * 多写那个 0 反而把悬挂静默打掉（agent 实踩：两轮 build 白跑，2026-08-19 上报）。
+ * 跟 lineRule:'auto' 同族：写了不报错但生效成别的东西，必须在校验层拦。
+ */
+export function indentConflict(ind) {
+  if (!ind || typeof ind !== 'object') return null;
+  const fl = ind.firstLineChars ?? ind.firstLineTwip;
+  const hg = ind.hangingChars ?? ind.hangingTwip;
+  if (fl == null || hg == null) return null;
+  return 'indent 的 firstLine* 和 hanging* 互斥（同一个属性的正负两面，同时给会静默覆盖悬挂）。'
+    + '要悬挂缩进只写 hanging*——悬挂天然含「首行回到左缘」，不用再补 firstLineChars: 0';
+}
+
+export function validateTokens(tok) {
+  const errs = [];
+  if (tok.v !== 1) errs.push('v must be 1');
+  const checkSpacing = (where, sp) => {
+    if (!sp) return;
+    if (sp.lineRule != null && !LINE_RULES.has(sp.lineRule)) {
+      errs.push(`${where}.spacing.lineRule: '${sp.lineRule}' 不是合法值，只有 ${[...LINE_RULES].join(' / ')}`
+        + "（multiple 时 line 是倍数如 1.5；exact/atLeast 时 line 是磅）");
+    }
+    if (sp.line != null && sp.lineRule === 'multiple' && sp.line > 10) {
+      errs.push(`${where}.spacing: lineRule=multiple 时 line 是**倍数**，${sp.line} 倍行距几乎肯定是把磅值写这儿了`);
+    }
+  };
+  for (const [id, st] of Object.entries(tok.styles ?? {})) {
+    for (const k of Object.keys(st)) if (!STYLE_KEYS.has(k)) errs.push(`styles.${id}: unknown key ${k}`);
+    for (const k of Object.keys(st.run ?? {})) if (!RUN_KEYS.has(k)) errs.push(`styles.${id}.run: unknown key ${k}`);
+    for (const k of Object.keys(st.para ?? {})) if (!PARA_KEYS.has(k)) errs.push(`styles.${id}.para: unknown key ${k}`);
+    if (st.run?.font && typeof st.run.font === 'string' && !tok.fonts?.[st.run.font]) {
+      errs.push(`styles.${id}.run.font: no such font slot '${st.run.font}'`);
+    }
+    if (badSize(st.run?.sizePt)) errs.push(`styles.${id}.run.sizePt: unknown 字号 ${st.run.sizePt}`);
+    if (st.basedOn && !tok.styles[st.basedOn]) errs.push(`styles.${id}.basedOn: no such style '${st.basedOn}'`);
+    checkSpacing(`styles.${id}.para`, st.para?.spacing);
+    const indErr = indentConflict(st.para?.indent);
+    if (indErr) errs.push(`styles.${id}.para.indent: ${indErr}`);
+  }
+  if (badSize(tok.base?.sizePt)) errs.push(`base.sizePt: unknown 字号 ${tok.base.sizePt}`);
+  checkSpacing('base', tok.base?.spacing);
+  // 自动编号（2026-08-18）：定义本身的校验在 numbering.js，这里再钉一条**引用完整性**
+  // —— 引用一个不存在的编号名以前会产出悬空 numId（Word 打开可能直接报文档损坏），
+  // 这正是"闭合 schema 只查键名不查值"那类漏的延续。
+  errs.push(...validateNumbering(tok.numbering));
+  const numNames = new Set(Object.keys(tok.numbering ?? {}));
+  const checkList = (where, list) => {
+    if (!list) return;
+    const name = typeof list === 'string' ? list : list.name;
+    if (!name) errs.push(`${where}.list: 要写 { name: '编号名', ilvl?: N } 或直接写编号名`);
+    else if (!numNames.has(name)) {
+      errs.push(`${where}.list: 没有名为 '${name}' 的编号定义`
+        + (numNames.size ? `，现有：${[...numNames].join(' / ')}` : '（tokens.numbering 是空的）'));
+    }
+  };
+  for (const [id, st] of Object.entries(tok.styles ?? {})) checkList(`styles.${id}.para`, st.para?.list);
+  return errs;
+}

package/server/lib/docx/units.js

@@ -0,0 +1,29 @@
+/**
+ * units.js — OOXML 单位换算 + 中文字号表。
+ * twip = 1/20 pt；w:sz 单位是半磅；mm→twip 按 1440/25.4。
+ */
+
+export const ptToTwip = (pt) => Math.round(pt * 20);
+export const ptToHalf = (pt) => Math.round(pt * 2);
+export const mmToTwip = (mm) => Math.round(mm * 1440 / 25.4);
+export const twipToPt = (t) => t / 20;
+
+/** 中文字号 → 磅 */
+export const ZIHAO = {
+  初号: 42, 小初: 36, 一号: 26, 小一: 24, 二号: 22, 小二: 18,
+  三号: 16, 小三: 15, 四号: 14, 小四: 12, 五号: 10.5, 小五: 9,
+  六号: 7.5, 小六: 6.5, 七号: 5.5, 八号: 5,
+};
+
+export function sizePt(v) {
+  if (typeof v === 'number') return v;
+  if (typeof v === 'string' && ZIHAO[v] != null) return ZIHAO[v];
+  throw new Error(`unknown font size: ${v}`);
+}
+
+export const PAGE_SIZES = {
+  A4: { wTwip: 11906, hTwip: 16838 },
+  A3: { wTwip: 16838, hTwip: 23811 },
+  Letter: { wTwip: 12240, hTwip: 15840 },
+  B5: { wTwip: 9978, hTwip: 14170 },
+};