@huicai/cli 2026.804.0 → 2026.1019.0

package/skills/docx-author/scripts/docx_battery.py

@@ -0,0 +1,586 @@
+# 文档引擎压力测试台：正向跑批 + **反向造缺陷** + 自动校正闭环。
+#
+# 为什么必须有反向：一个只会说「未发现问题」的体检器和没有体检器是一回事，
+# 而且更糟——它给了人一个虚假的「已检查」印象。所以每加一条检查规则，
+# 这里就要配一个「故意做坏的文档」，断言那条规则真的会响；
+# 顺带断言**正向生成的合规文档必须零必修**，防止规则写得太紧变成天天误报。
+#
+# 用法：
+#   python docx_battery.py            # 正向 120 份 + 反向全部缺陷 + 校正闭环
+#   python docx_battery.py 400        # 正向跑 400 份
+#   python docx_battery.py --keep     # 保留产物到 ./_battery 供人工翻看
+#
+# 改了 docx_layout / docx_build / docx_check 任何一个，**必须重跑本文件**。
+
+import os
+import random
+import shutil
+import struct
+import sys
+import tempfile
+import zlib
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from docx import Document                      # noqa: E402
+from docx.enum.text import WD_ALIGN_PARAGRAPH  # noqa: E402
+from docx.oxml.ns import qn                    # noqa: E402
+from docx.shared import Cm, Pt                 # noqa: E402
+
+import docx_build as B                         # noqa: E402
+import docx_check as C                         # noqa: E402
+import docx_layout as L                        # noqa: E402
+
+# ── 随机素材 ───────────────────────────────────────────────────────────────
+WORDS = ['系统', '模块', '接口', '数据', '采集', '告警', '模型', '训练', '部署', '验收',
+         '指标', '工期', '预算', '风险', '评审', '测试', '上线', '运维', '容灾', '权限',
+         '甲方', '监理', '里程碑', '交付物', '需求', '架构', '数据库', '中间件', '并发']
+TAILS = ['已按计划完成', '尚在验证中', '需甲方确认口径', '存在 3 项遗留缺陷',
+         '较基线提前 5 天', '成本超支 2.1 万元', '通过第三方检测', '进入试运行']
+
+
+def sentence(rng):
+    return (f'{rng.choice(WORDS)}{rng.choice(WORDS)}在 {rng.randint(1, 12)} 月完成'
+            f'{rng.randint(2, 40)} 项{rng.choice(WORDS)}，{rng.choice(TAILS)}。')
+
+
+def para(rng, n=None):
+    return ''.join(sentence(rng) for _ in range(n or rng.randint(1, 6)))
+
+
+def png(path, w, h):
+    """不依赖 PIL 的最小 PNG 写出（压测要能在只装了 python-docx 的环境里跑）。"""
+    def chunk(tag, data):
+        c = tag + data
+        return struct.pack('>I', len(data)) + c + struct.pack('>I', zlib.crc32(c) & 0xffffffff)
+    raw = b''.join(b'\x00' + bytes([(x * 7) % 256, (y * 11) % 256, 200]) * 1 * w
+                   for y in range(h) for x in [0])
+    raw = b''.join(b'\x00' + b''.join(bytes([(x * 7) % 256, (y * 11) % 256, 200]) for x in range(w))
+                   for y in range(h))
+    with open(path, 'wb') as f:
+        f.write(b'\x89PNG\r\n\x1a\n'
+                + chunk(b'IHDR', struct.pack('>IIBBBBB', w, h, 8, 2, 0, 0, 0))
+                + chunk(b'IDAT', zlib.compress(raw))
+                + chunk(b'IEND', b''))
+    return path
+
+
+def random_spec(rng, img):
+    prof = rng.choice(['tech', 'gov', 'report'])
+    by_chap = (prof == 'report')          # 与 docx_layout 的档位定义一致
+    blocks, chap, fig, tab = [], 0, {}, {}
+
+    def label(kind, ch):
+        d = fig if kind == 'fig' else tab
+        key = ch if by_chap else 0
+        d[key] = d.get(key, 0) + 1
+        pre = '图' if kind == 'fig' else '表'
+        return f'{pre} {ch}-{d[key]}' if by_chap else f'{pre} {d[key]}'
+
+    for i in range(rng.randint(3, 7)):
+        chap += 1
+        blocks.append({'type': 'h1', 'text': f'{rng.choice(WORDS)}{rng.choice(WORDS)}'})
+        for _ in range(rng.randint(1, 3)):
+            blocks.append({'type': 'p', 'text': para(rng)})
+        if rng.random() < 0.5:
+            blocks.append({'type': 'h2', 'text': f'{rng.choice(WORDS)}说明'})
+            blocks.append({'type': 'p', 'text': para(rng)})
+        if rng.random() < 0.45:
+            cols = rng.randint(2, 8)
+            rows = [[f'{rng.choice(WORDS)}' * rng.randint(1, 6) for _ in range(cols)]
+                    for _ in range(rng.randint(2, 18))]
+            blocks.append({'type': 'table', 'rows': rows, 'caption': f'{rng.choice(WORDS)}明细'})
+            blocks.append({'type': 'p', 'text': f'详见{label("tab", chap)}。'})
+        if rng.random() < 0.35:
+            blocks.append({'type': 'figure', 'image': img, 'caption': f'{rng.choice(WORDS)}示意'})
+            blocks.append({'type': 'p', 'text': f'如{label("fig", chap)}所示，{para(rng, 1)}'})
+        if rng.random() < 0.3:
+            blocks.append({'type': 'bullets', 'items': [para(rng, 1) for _ in range(rng.randint(2, 6))]})
+    return {'profile': prof, 'title': f'{rng.choice(WORDS)}项目{rng.choice(["建议书","实施计划","验收报告"])}',
+            'org': '压测单位', 'footer': '压测', 'blocks': blocks}
+
+
+# ── 正向：合规文档必须零必修 ───────────────────────────────────────────────
+def forward(n, workdir, verbose=True):
+    rng = random.Random(20260901)
+    imgs = [png(os.path.join(workdir, f'im{i}.png'), w, h)
+            for i, (w, h) in enumerate([(1600, 900), (900, 1600), (2400, 600), (1200, 1200)])]
+    bad, worst = 0, []
+    for i in range(n):
+        spec = random_spec(rng, rng.choice(imgs))
+        out = os.path.join(workdir, f'f{i}.docx')
+        try:
+            _p, res, _w, _lb = B.build(spec, out)
+        except Exception as e:
+            bad += 1
+            worst.append((f'f{i}', f'生成异常 {type(e).__name__}: {e}'))
+            continue
+        errs = [x for x in res['issues'] if x['level'] == 'error']
+        if errs:
+            bad += 1
+            worst.append((f"f{i}({spec['profile']})", '; '.join(sorted({x['kind'] + ':' + x['msg'][:40] for x in errs}))))
+        os.remove(out)
+        if verbose and (i + 1) % 40 == 0:
+            print(f'  正向 {i+1}/{n} …')
+    return bad, worst
+
+
+# ── 反向：每条规则配一个「故意做坏」的文档 ─────────────────────────────────
+def _base(workdir, name, img=None, blocks=None, **kw):
+    spec = {'profile': 'tech', 'title': '反向用例', 'org': '压测单位', 'inspect': False,
+            'blocks': blocks or ([{'type': 'h1', 'text': '第一章'}]
+                                 + [{'type': 'p', 'text': '本节记录 %d 项工作，均已完成。' % i} for i in range(6)]
+                                 + [{'type': 'h1', 'text': '第二章'}]
+                                 + [{'type': 'p', 'text': '第二节的内容共 %d 段。' % i} for i in range(4)])}
+    spec.update(kw)
+    out = os.path.join(workdir, name)
+    B.build(spec, out)
+    return out
+
+
+def _kinds(path, strict=False):
+    return {i['kind'] for i in C.inspect(path, 'tech', strict)['issues']}
+
+
+def _strip_eastasia(doc):
+    """正文与**样式表**两处都要剥——样式在 styles.xml 里，从 doc.element 遍历不到。"""
+    for root in (doc.element, doc.styles.element):
+        for el in root.iter():
+            if el.tag == qn('w:rFonts') and el.get(qn('w:eastAsia')) is not None:
+                del el.attrib[qn('w:eastAsia')]
+
+
+def _is_cover_table(tb):
+    """封面信息栏的确定特征：两列，且左列每个非空格都以「：」结尾。"""
+    if not tb.rows or len(tb.rows[0].cells) != 2:
+        return False
+    lefts = [r.cells[0].text.strip() for r in tb.rows]
+    lefts = [x for x in lefts if x]
+    return bool(lefts) and all(x.endswith('：') or x.endswith(':') for x in lefts)
+
+
+def _content_table(doc):
+    """取**正文里的**那张表。不能用 tables[0]：封面信息栏也是表格且排在最前，
+    按下标取会把用例打在封面表上——造不出缺陷，却被报成「规则是瞎的」。"""
+    for tb in doc.tables:
+        if not _is_cover_table(tb):
+            return tb
+    return doc.tables[-1]
+
+
+def _bodies(doc, mark='本节记录'):
+    """取真正的正文段。反向用例必须打在正文上——打在封面段上体检本来就不该响，
+    那样测出来的「漏报」是假的。"""
+    return [p for p in doc.paragraphs if mark in p.text]
+
+
+def reverse(workdir):
+    """返回 [(用例名, 期望命中的 kind, 是否命中, 实际命中集合)]。"""
+    cases = []
+    img = png(os.path.join(workdir, 'r.png'), 1600, 900)
+    small = png(os.path.join(workdir, 'small.png'), 160, 90)
+
+    def case(name, expect, mutate, **kw):
+        p = _base(workdir, name + '.docx', **kw)
+        d = Document(p)
+        mutate(d)
+        d.save(p)
+        got = _kinds(p)
+        cases.append((name, expect, expect in got, got))
+        return p
+
+    # 排版类
+    case('缺东亚字体', 'no-eastasia', _strip_eastasia)
+    case('假缩进', 'fake-indent',
+         lambda d: [setattr(p.runs[0], 'text', '　　' + p.runs[0].text) for p in _bodies(d)[:3] if p.runs])
+    case('字号混杂', 'size-mix',
+         lambda d: [setattr(r.font, 'size', Pt(9)) for p in _bodies(d)[:3] for r in p.runs])
+    case('首行缩进忽有忽无', 'indent-mix',
+         lambda d: [setattr(p.paragraph_format, 'first_line_indent', Pt(0)) for p in _bodies(d)[:3]])
+    case('连续空段', 'blank-runs',
+         lambda d: [_bodies(d)[2].insert_paragraph_before('') for _ in range(4)])
+    case('正文误居中', 'align-mix',
+         lambda d: [setattr(p, 'alignment', WD_ALIGN_PARAGRAPH.CENTER) for p in _bodies(d)[:2]])
+
+    # 结构类
+    case('标题跳级', 'level-jump', lambda d: None,
+         blocks=[{'type': 'h1', 'text': '一章'}, {'type': 'p', 'text': '正文内容一段。'},
+                 {'type': 'h3', 'text': '直接三级'}, {'type': 'p', 'text': '正文内容两段。'}])
+    case('空章节', 'empty-section', lambda d: None,
+         blocks=[{'type': 'h1', 'text': '有内容'}, {'type': 'p', 'text': '正文一段。'},
+                 {'type': 'h1', 'text': '空壳章节'}, {'type': 'h1', 'text': '又一章'},
+                 {'type': 'p', 'text': '正文两段。'}])
+    case('章节编号断号', 'number-gap', lambda d: None, numbering='none',
+         blocks=[{'type': 'h1', 'text': '一、概述'}, {'type': 'p', 'text': '正文一段。'},
+                 {'type': 'h1', 'text': '三、方案'}, {'type': 'p', 'text': '正文二段。'}])
+    case('无页码', 'no-pagenum', lambda d: None, page_numbers=False, toc=False, cover=False)
+
+    # 表格类
+    def widen(d):
+        t = _content_table(d)
+        t.autofit = False
+        for row in t.rows:
+            for c in row.cells:
+                c.width = Cm(6)
+        g = t._tbl.tblGrid
+        for gc in g.findall(qn('w:gridCol')):
+            gc.set(qn('w:w'), str(int(6 * L.CM_PT * 20)))
+    case('表格超版心', 'over-width', widen,
+         blocks=[{'type': 'h1', 'text': '表'}, {'type': 'p', 'text': '见下表。'},
+                 {'type': 'table', 'rows': [['甲', '乙', '丙', '丁'], ['1', '2', '3', '4']],
+                  'caption': '宽表'}])
+    case('表头未加粗', 'head-not-bold',
+         lambda d: [setattr(r.font, 'bold', False) for c in _content_table(d).rows[0].cells
+                    for p in c.paragraphs for r in p.runs],
+         blocks=[{'type': 'h1', 'text': '表'}, {'type': 'p', 'text': '见表 1。'},
+                 {'type': 'table', 'rows': [['甲', '乙'], ['1', '2']], 'caption': '小表'}])
+    case('长表无重复表头', 'no-head-repeat',
+         lambda d: (lambda tr: [tr.remove(x) for x in tr.findall(qn('w:tblHeader'))])(
+             _content_table(d).rows[0]._tr.get_or_add_trPr()),
+         blocks=[{'type': 'h1', 'text': '表'}, {'type': 'p', 'text': '见表 1。'},
+                 {'type': 'table', 'rows': [[f'行{i}', f'值{i}'] for i in range(20)], 'caption': '长表'}])
+
+    # 插图类
+    def distort(d):
+        sh = d.inline_shapes[0]
+        sh.height = int(sh.height * 1.6)
+    case('图片变形', 'distorted', distort,
+         blocks=[{'type': 'h1', 'text': '图'}, {'type': 'p', 'text': '如图 1 所示。'},
+                 {'type': 'figure', 'image': img, 'caption': '示意'}])
+    case('图片超版心', 'over-width', lambda d: setattr(d.inline_shapes[0], 'width', int(Cm(20))),
+         blocks=[{'type': 'h1', 'text': '图'}, {'type': 'p', 'text': '如图 1 所示。'},
+                 {'type': 'figure', 'image': img, 'caption': '示意'}])
+    case('图片发虚', 'low-dpi', lambda d: None,
+         blocks=[{'type': 'h1', 'text': '图'}, {'type': 'p', 'text': '如图 1 所示。'},
+                 {'type': 'figure', 'image': small, 'caption': '低清图', 'width_cm': 14}])
+    case('图题断号', 'fig-number-gap',
+         lambda d: [setattr(p.runs[0], 'text', '图 3  第二张') for p in d.paragraphs
+                    if p.text.strip().startswith('图 2')],
+         blocks=[{'type': 'h1', 'text': '图'}, {'type': 'p', 'text': '如图 1、图 2 所示。'},
+                 {'type': 'figure', 'image': img, 'caption': '第一张'},
+                 {'type': 'figure', 'image': img, 'caption': '第二张'}])
+    case('引用了不存在的图', 'fig-dangling-ref', lambda d: None,
+         blocks=[{'type': 'h1', 'text': '图'}, {'type': 'p', 'text': '如图 1 所示，另见图 7 所示。'},
+                 {'type': 'figure', 'image': img, 'caption': '唯一一张'}])
+    case('图从未被引用', 'fig-unreferenced', lambda d: None,
+         blocks=[{'type': 'h1', 'text': '图'}, {'type': 'p', 'text': '这里没有任何指引。'},
+                 {'type': 'figure', 'image': img, 'caption': '孤图'}])
+
+    # 文字与 AI 味
+    case('错别字', 'typo', lambda d: None,
+         blocks=[{'type': 'h1', 'text': '文字'},
+                 {'type': 'p', 'text': '系统己经按装完成，运行正常，未发现异常。'}])
+    case('半角标点', 'half-comma', lambda d: None,
+         blocks=[{'type': 'h1', 'text': '文字'},
+                 {'type': 'p', 'text': '本期完成三项工作,均通过验收,未遗留问题。'}])
+    ai = ('值得注意的是，本系统通过深度赋能业务闭环，有效提升了整体效能。'
+          '综上所述，该方案具有重要的现实意义，为后续工作奠定了坚实的基础。')
+    case('AI 味套话', 'cliche', lambda d: None,
+         blocks=[{'type': 'h1', 'text': '综述'}] + [{'type': 'p', 'text': ai} for _ in range(10)])
+    case('长句不喘气', 'sent-run', lambda d: None,
+         blocks=[{'type': 'h1', 'text': '文字'},
+                 {'type': 'p', 'text': '本次研制的智能运维平台系统软件与配套工具链在两个生产集群'
+                                       '完成部署并连续运行三十天且未出现任何影响业务的故障。'}])
+    case('破折号误用', 'bad-dash', lambda d: None,
+         blocks=[{'type': 'h1', 'text': '文字'},
+                 {'type': 'p', 'text': '本期完成三项工作—其中两项提前交付，一项按期完成。'}])
+    case('术语多种写法', 'term-variant', lambda d: None,
+         blocks=[{'type': 'h1', 'text': '术语'},
+                 {'type': 'p', 'text': '本系统提供 API 接口。Api 需鉴权。api 限流 100 QPS。'
+                                       '接口文档见附件，API 版本为 v2。'}])
+    case('通篇没有数字锚点', 'no-anchor', lambda d: None,
+         blocks=[{'type': 'h1', 'text': '综述'}]
+                + [{'type': 'p', 'text': '本部分对相关工作进行了系统梳理与全面阐述，'
+                                         '明确了总体思路与推进方式，为下一阶段奠定基础。'} for _ in range(12)])
+
+    # 报告型文档的内容硬指标（HuiCai 可研基线里真实出现过的四类）
+    feas = {'title': '智能运维平台可行性研究报告', 'date': '2026 年 9 月 23 日'}
+    case('可研计划落在编制日前', 'plan-in-past', lambda d: None, **feas,
+         blocks=[{'type': 'h1', 'text': '进度安排与年度计划内容'},
+                 {'type': 'p', 'text': '项目于 2025 年 10 月启动，2026 年 3 月完成开发，2026 年 8 月完成验收。'}])
+    case('同一对象数量矛盾', 'count-conflict', lambda d: None,
+         blocks=[{'type': 'h1', 'text': '风险'},
+                 {'type': 'p', 'text': '本项目从技术、市场、运营、财务、合规、进度与知识产权七个维度识别风险。'},
+                 {'type': 'p', 'text': '项目风险按下述五个维度识别，逐项给出应对措施与责任人。'}])
+    # 有题注、但一张架构图/进度/投资/财务/风险都没有（零题注的文档归题注检查管，这条规则刻意不判）
+    case('可研缺评审常看的图表', 'report-visuals', lambda d: None, **feas,
+         blocks=[{'type': 'h1', 'text': '承担单位和主要研究人员简况'}, {'type': 'p', 'text': '人员见表 1。'},
+                 {'type': 'table', 'caption': '主要研究人员', 'rows': [['姓名', '分工'], ['［待补］', '技术负责']]}])
+    case('可研财务评价缺指标', 'report-finance', lambda d: None, **feas)
+    return cases
+
+
+# ── 反误报：合规写法**绝不能**被判成问题 ───────────────────────────────────
+# 这一档和反向造缺陷同等重要，方向相反：规则越收越紧的过程中，最容易发生的事
+# 不是漏报，而是把「表单表没有表头行」「列表项不带句号」这类正确写法判成毛病。
+# 一个天天误报的体检器，用两次就没人看了。
+def negative(workdir):
+    img = png(os.path.join(workdir, 'n.png'), 1600, 900)
+    cases = []
+
+    def nocase(name, forbidden, **kw):
+        p = _base(workdir, 'neg-' + name + '.docx', **kw)
+        got = _kinds(p)
+        bad = [k for k in forbidden if k in got]
+        cases.append((name, not bad, bad, got))
+
+    nocase('表单式两列表', ['head-not-bold'],
+           blocks=[{'type': 'h1', 'text': '交付物'}, {'type': 'p', 'text': '交付物清单见表 1。'},
+                   {'type': 'kv', 'caption': '交付物清单',
+                    'pairs': [['软件安装包', 'V1.0.0，光盘 2 份'], ['源代码', 'Git 全量归档 1 份'],
+                              ['技术文档', '需求/设计/测试各 2 份']]}])
+    nocase('列表项无句末标点', ['no-end-punct'],
+           blocks=[{'type': 'h1', 'text': '要点'}, {'type': 'p', 'text': '本期完成三项工作。'},
+                   {'type': 'bullets', 'items': ['告警准确率达 92%', '接入成本降至 1.2 人日',
+                                                 '试运行 30 天零故障']}])
+    nocase('封面与目录', ['size-mix', 'align-mix', 'no-indent', 'blank-runs'],
+           title='正常文档', toc=True, cover=True,
+           blocks=[{'type': 'h1', 'text': '第一章'}]
+                  + [{'type': 'p', 'text': f'第 {i} 段记录了 {i*3} 项工作，均已在 {i+1} 月完成。'}
+                     for i in range(1, 7)])
+    nocase('签字栏', ['align-mix', 'no-end-punct'],
+           blocks=[{'type': 'h1', 'text': '结论'}, {'type': 'p', 'text': '同意通过验收。'},
+                   {'type': 'signature', 'roles': ['编制', '审核', '批准'], 'org': '数字技术研究院'}])
+    nocase('表格用—表示无', ['bad-dash'],
+           blocks=[{'type': 'h1', 'text': '经费'}, {'type': 'p', 'text': '执行情况见表 1。'},
+                   {'type': 'table', 'caption': '经费执行',
+                    'rows': [['科目', '预算', '实际', '差异说明'], ['设备', '120.0', '118.4', '—'],
+                             ['人力', '260.0', '268.4', '压测环境多租两月']]}])
+    # 决议/通知/签到表这类短文档**一个标题都没有**，「首个标题之前算前置件」那条规则
+    # 在它们身上完全失效，封面大标题与文号会被当成正文，报一堆字号/缩进不统一。
+    # 靠分节符定位前置件才盖得住——这条守着那个修复。
+    nocase('无标题短文档的封面', ['size-mix', 'indent-mix', 'align-mix', 'no-indent'],
+           title='关于开展项目研究与开发工作的决议', toc=False,
+           blocks=[{'type': 'p', 'text': '经公司管理层会议决定，同意本年度十二项研究与开发项目立项。'},
+                   {'type': 'kv', 'pairs': [['技术负责人意见', ''], ['总经理意见', '']]}])
+    # 中文里几乎每个虚词的叠字都有合法用法（目的的 / 为了了解 / 和和平 / 在在线）。
+    # 早先那条「虚词叠字即错」的规则在真实语料上命中 20 处、**全是误报**，还是必修级。
+    nocase('合法叠字不得判重复', ['dup-char', 'dup-phrase'],
+           blocks=[{'type': 'h1', 'text': '文字'},
+                   {'type': 'p', 'text': '明确项目目的的重要性，为了了解情况，'
+                                         '在在线账户权益领域推进，与和平发展方向一致。'},
+                   {'type': 'p', 'text': '把把手换掉，从从容容推进，认认真真核对一遍。'}])
+    nocase('正常长度句子', ['sent-run', 'sent-long'],
+           blocks=[{'type': 'h1', 'text': '文字'},
+                   {'type': 'p', 'text': '平均故障发现时间从 42 分钟降到 7.6 分钟，'
+                                         '告警准确率 93.1%，均已达标。'}])
+    nocase('图有题注且被引用', ['fig-unreferenced', 'fig-no-caption', 'fig-dangling-ref'],
+           blocks=[{'type': 'h1', 'text': '架构'}, {'type': 'p', 'text': '总体架构如图 1 所示。'},
+                   {'type': 'figure', 'image': img, 'caption': '总体架构'}])
+    # 总结/验收写的就是过去：时态规则只管「向前看」的文档
+    nocase('总结报告写已完成的进度', ['plan-in-past', 'plan-mostly-past'],
+           title='智能运维平台项目工作总结报告', date='2026 年 9 月 23 日',
+           blocks=[{'type': 'h1', 'text': '进度安排执行情况'},
+                   {'type': 'p', 'text': '项目于 2025 年 10 月启动，2026 年 8 月通过验收。'}])
+    # 计划从编制之后排，进度一节里顺带提一句已完成的原型——不是「计划落在过去」
+    nocase('可研计划在编制日之后', ['plan-in-past', 'plan-mostly-past'],
+           title='智能运维平台可行性研究报告', date='2026 年 9 月 23 日',
+           blocks=[{'type': 'h1', 'text': '进度安排与年度计划内容'},
+                   {'type': 'p', 'text': '前期原型已于 2026 年 6 月完成。项目计划 2026 年 10 月启动，'
+                                         '2027 年 3 月完成开发，2027 年 9 月完成验收。'}])
+    # 局部与整体、序数、区间，都不是「数量矛盾」
+    nocase('局部与整体的数量', ['count-conflict'],
+           blocks=[{'type': 'h1', 'text': '组成'},
+                   {'type': 'p', 'text': '网关包含五个模块，负责鉴权与路由。平台共十二个模块，分属三层。'},
+                   {'type': 'p', 'text': '第三个阶段是验收，前两个阶段已完成，另有三到五个场景试点。'}])
+    # 真实归档里的可研常常一个题注都没有：那时说「缺架构图」是瞎猜（表可能在、只是没题注），交给题注检查去报
+    nocase('零题注的可研不猜缺图', ['report-visuals'],
+           title='智能运维平台可行性研究报告', date='2026 年 9 月 23 日',
+           blocks=[{'type': 'h1', 'text': '经费预算'}, {'type': 'p', 'text': '经费合计 320 万元，明细如下。'},
+                   {'type': 'table', 'rows': [['科目', '金额'], ['人工', '240']]}])
+    # 报告里通篇是引用、文号、版本、公式、专名：书名与括注当一个整体读，箭头与运算符是停顿，
+    # 「one-api」这种连字符专名不是 API 的另一种拼法（均为 A/B 实测里的误报）
+    nocase('引用公式版本与连字符专名', ['sent-run', 'term-variant'],
+           blocks=[{'type': 'h1', 'text': '依据'},
+                   {'type': 'p', 'text': '艾瑞咨询《2026 年中国企业级 AI Agent 发展洞察报告》（2026 年 8 月发布）指出行业进入落地期。'},
+                   {'type': 'p', 'text': '工业和信息化部于 2026 年 8 月 12 日印发《信息通信行业发展「十五五」规划》（工信部规〔2026〕188 号）。'},
+                   {'type': 'p', 'text': '所得税前净现金流量 = 营业收入 + 成本节约 + 回收资产余值 − 建设投资 − 经营成本。'},
+                   {'type': 'p', 'text': '里程碑依次为高并发治理整改 → 容量基线达标 → 私有化交付包发布 → 等级保护三级测评通过。'},
+                   {'type': 'p', 'text': '后端采用 Spring Boot 3.2.5 与 Spring Cloud 2023.0.1 与 Spring Cloud Alibaba 2023.0.1.0 构建。'},
+                   {'type': 'p', 'text': '以 one-api、New API 等开源项目为代表的网关只解决接入；本项目对外提供 OpenAI 兼容 API，并提供 API 密钥管理。'}])
+    nocase('可研图表与财务齐全', ['report-visuals', 'report-finance'],
+           title='智能运维平台可行性研究报告', date='2026 年 9 月 23 日',
+           blocks=[{'type': 'h1', 'text': '方案与效益'},
+                   {'type': 'p', 'text': '总体架构见图 1，功能模块见图 2，实施进度见图 3；方案比选见表 1，投资见表 2，'
+                                         '现金流量见表 3，敏感性见表 4，风险见表 5。所得税后财务净现值（NPV）355.40 万元，'
+                                         '财务内部收益率（IRR）27.12%，静态投资回收期 4.28 年，敏感性分析显示收入最敏感。'},
+                   {'type': 'figure', 'image': img, 'caption': '系统总体架构'},
+                   {'type': 'figure', 'image': img, 'caption': '系统功能模块组成'},
+                   {'type': 'figure', 'image': img, 'caption': '实施进度计划'},
+                   {'type': 'table', 'caption': '技术方案比选', 'rows': [['方案', '结论'], ['甲', '选用']]},
+                   {'type': 'table', 'caption': '投资估算表', 'rows': [['项目', '金额'], ['人工', '300']]},
+                   {'type': 'table', 'caption': '项目投资现金流量表', 'rows': [['年', '净现金流'], ['2027', '120']]},
+                   {'type': 'table', 'caption': '敏感性分析表', 'rows': [['因素', '临界点'], ['收入', '-35.6%']]},
+                   {'type': 'table', 'caption': '风险登记表', 'rows': [['风险', '应对'], ['R1', '双供应商']]}])
+    return cases
+
+
+def bom_markdown(workdir):
+    """带 BOM 的 Markdown（Windows 编辑器的常见保存方式）不得吃掉第一个标题。"""
+    import docx_build as _DB
+    md = os.path.join(workdir, 'bom.md')
+    open(md, 'w', encoding='utf-8-sig').write('# 一、概述\n本项目已完成，交付率 98.2%。\n')
+    out = os.path.join(workdir, 'bom.docx')
+    _DB.md_to_docx(md, out, title='T')
+    from docx import Document as _D
+    heads = [p.text for p in _D(out).paragraphs if str(p.style.name or '').startswith('Heading')]
+    return bool(heads) and '概述' in heads[0], (heads[:2] if heads else '一个标题都没有')
+
+
+def xref_markdown(workdir):
+    """交叉引用：@fig:x / @tbl:x 必须换成引擎算出的真实编号（按章编号下尤其容易数错），
+    写了不存在的标签要告警而不是悄悄留在正文里。"""
+    import docx_build as _DB
+    img = png(os.path.join(workdir, 'x.png'), 1600, 900)
+    md = ('# 一、概述\n\n架构如@fig:arch 所示，投资见@tbl:inv，**另见@fig:arch**，还有@fig:none。\n\n'
+          f'![系统总体架构]({img}){{#fig:arch}}\n\n# 二、投资\n\n表：投资估算 {{#tbl:inv}}\n\n'
+          '| 科目 | 金额 |\n|---|---|\n| 人工 | 300 |\n')
+    out = os.path.join(workdir, 'xref.docx')
+    _p, _res, warns, labels = _DB.build({'profile': 'report', 'title': 'T', 'markdown': md, 'inspect': False}, out)
+    from docx import Document as _D
+    text = '\n'.join(p.text for p in _D(out).paragraphs)
+    want = dict((lab_kind, lab) for lab_kind, lab, _c in labels)
+    ok = (f"如{want.get('图')} 所示" in text and f"见{want.get('表')}" in text and '@fig:arch' not in text
+          and '@tbl:inv' not in text and any('@fig:none' in w for w in warns))
+    return ok, f'labels={labels} warns={[w for w in warns if "标签" in w]}'
+
+
+def landscape_markdown(workdir):
+    """横排插图：{.landscape} 的图要落在横向节里、不被判超宽、fix 不把它缩回纵向版心；
+    同名 SVG 显示字太小时，成稿警告要给出纸上的实际磅数。"""
+    import docx_build as _DB
+    from docx import Document as _D
+    img = png(os.path.join(workdir, 'wide.png'), 3000, 1500)
+    with open(os.path.join(workdir, 'wide.svg'), 'w', encoding='utf-8') as fh:   # 2000 宽、10px 字 ≈ 纵向版心里 2 磅
+        fh.write('<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 2000 1000">'
+                 '<text font-size="10">说明</text><text font-size="12">节点</text></svg>')
+    md = (f'# 一、架构\n\n总体架构如@fig:a 所示。\n\n![总体架构]({img}){{#fig:a .landscape}}\n\n'
+          f'# 二、明细\n\n明细见@fig:b。\n\n![服务明细]({img}){{#fig:b}}\n')
+    out = os.path.join(workdir, 'land.docx')
+    _p, _res, warns, _labels = _DB.build({'profile': 'tech', 'title': 'T', 'markdown': md, 'inspect': False}, out)
+    orient = [str(sec.orientation) for sec in _D(out).sections]
+    kinds = _kinds(out)
+    ok = (any('LANDSCAPE' in o for o in orient) and 'over-width' not in kinds
+          and any('横排插入后' in w for w in warns) and any('按版心宽插入后' in w and '横排后' in w for w in warns))
+    return ok, f'sections={orient} kinds={sorted(kinds)[:6]} warns={[w[:40] for w in warns if "磅" in w]}'
+
+
+def heading_shift_markdown(workdir):
+    """章从「##」写起（「#」留给文档标题的 Markdown 习惯）：成稿要把层级整体上提，
+    否则目录、导航窗格、按章编号的题注都错一级。"""
+    import docx_build as _DB
+    from docx import Document as _D
+    img = png(os.path.join(workdir, 'h.png'), 1600, 900)
+    md = f'## 一、概述\n\n如@fig:a 所示。\n\n![甲]({img}){{#fig:a}}\n\n### 1.1 背景\n\n正文。\n\n## 二、方案\n\n![乙]({img}){{#fig:b}}\n'
+    out = os.path.join(workdir, 'hshift.docx')
+    _p, _r, _w, labels = _DB.build({'profile': 'report', 'title': 'T', 'markdown': md, 'inspect': False}, out)
+    styles = [p.style.name for p in _D(out).paragraphs if p.style.name.startswith('Heading')]
+    ok = styles[:3] == ['Heading 1', 'Heading 2', 'Heading 1'] and [l[1] for l in labels] == ['图 1-1', '图 2-1']
+    return ok, f'styles={styles} labels={labels}'
+
+
+# ── 校正闭环：修完必须真的干净，且不能修出新错 ─────────────────────────────
+FIXABLE = ['缺东亚字体', '假缩进', '字号混杂', '首行缩进忽有忽无', '连续空段',
+           '正文误居中', '表格超版心', '表头未加粗', '长表无重复表头', '图片变形',
+           '图片超版心', '图题断号', '半角标点']
+
+
+def fix_round(workdir, cases):
+    out = []
+    for name, expect, hit, _got in cases:
+        if name not in FIXABLE or not hit:
+            continue
+        src = os.path.join(workdir, name + '.docx')
+        try:
+            dst, done = C.fix(src, os.path.join(workdir, name + '-fixed.docx'), 'tech')
+        except Exception as e:
+            out.append((name, False, f'修复异常 {type(e).__name__}: {e}'))
+            continue
+        after = C.inspect(dst, 'tech')
+        kinds = {i['kind'] for i in after['issues']}
+        before = C.inspect(src, 'tech')
+        new_err = ({i['kind'] for i in after['issues'] if i['level'] == 'error'}
+                   - {i['kind'] for i in before['issues'] if i['level'] == 'error'})
+        ok = expect not in kinds and not new_err
+        why = ''
+        if expect in kinds:
+            why = f'修完仍命中 {expect}'
+        elif new_err:
+            why = f'修出新必修 {sorted(new_err)}'
+        out.append((name, ok, why or f"已修（{'、'.join(f'{k}{v}' for k, v in done.items())}）"))
+    return out
+
+
+def main(argv):
+    n = 120
+    for a in argv:
+        if a.isdigit():
+            n = int(a)
+    keep = '--keep' in argv
+    workdir = os.path.join(os.getcwd(), '_battery') if keep else tempfile.mkdtemp(prefix='docxbat-')
+    os.makedirs(workdir, exist_ok=True)
+    print(f'压测目录：{workdir}')
+    fails = 0
+
+    print(f'\n[1/4] 正向：随机内容 × 三档规范 × {n} 份，断言合规文档零必修')
+    bad, worst = forward(n, workdir)
+    if bad:
+        fails += 1
+        print(f'  ✗ {bad}/{n} 份出现必修项：')
+        for name, why in worst[:8]:
+            print(f'      {name} → {why}')
+    else:
+        print(f'  ✓ {n} 份全部零必修（引擎不会生产出版式事故）')
+
+    print('\n[2/4] 反向：每条规则配一个故意做坏的文档，断言体检真的会响')
+    cases = reverse(workdir)
+    miss = [c for c in cases if not c[2]]
+    for name, expect, hit, got in cases:
+        print(f"  {'✓' if hit else '✗'} {name:<16} 期望 {expect}"
+              + ('' if hit else f"　实际命中：{sorted(got)[:6]}"))
+    if miss:
+        fails += 1
+        print(f'  ✗ {len(miss)}/{len(cases)} 条规则是瞎的')
+    else:
+        print(f'  ✓ {len(cases)}/{len(cases)} 条规则全部命中')
+
+    print('\n[3/4] 反误报：合规写法不得被判成问题')
+    negs = negative(workdir)
+    for name, ok, bad, _got in negs:
+        print(f"  {'✓' if ok else '✗'} {name:<16}" + ('' if ok else f'　被误报：{bad}'))
+    if any(not ok for _n, ok, _b, _g in negs):
+        fails += 1
+    else:
+        print(f'  ✓ {len(negs)}/{len(negs)} 项合规写法零误报')
+
+    ok_bom, why = bom_markdown(workdir)
+    print(f"  {'✓' if ok_bom else '✗'} {'带 BOM 的 Markdown 不吃标题':<16} {why if not ok_bom else ''}")
+    if not ok_bom:
+        fails += 1
+    ok_x, why = xref_markdown(workdir)
+    print(f"  {'✓' if ok_x else '✗'} {'交叉引用换成真实编号':<16} {why if not ok_x else ''}")
+    if not ok_x:
+        fails += 1
+    ok_h, why = heading_shift_markdown(workdir)
+    print(f"  {'✓' if ok_h else '✗'} {'章从 ## 起时层级上提':<16} {why if not ok_h else ''}")
+    if not ok_h:
+        fails += 1
+    ok_l, why = landscape_markdown(workdir)
+    print(f"  {'✓' if ok_l else '✗'} {'横排插图不判超宽、过密图报磅数':<16} {why if not ok_l else ''}")
+    if not ok_l:
+        fails += 1
+
+    print('\n[4/4] 校正闭环：fix 后必须真干净，且不得修出新必修')
+    fr = fix_round(workdir, cases)
+    for name, ok, why in fr:
+        print(f"  {'✓' if ok else '✗'} {name:<16} {why}")
+    if any(not ok for _n, ok, _w in fr):
+        fails += 1
+
+    if not keep:
+        shutil.rmtree(workdir, ignore_errors=True)
+    print('\n' + ('全部通过。' if not fails else f'有 {fails} 个环节未通过。'))
+    return 1 if fails else 0
+
+
+if __name__ == '__main__':
+    sys.exit(main(sys.argv[1:]))