单文件HTML报告 技术标准

前言

本文件为「单文件HTML报告」在现役版本 V1.1.1 下的技术标准载体，按《全域任务脑手架构宪法》第 17–23 条规定的六层主干组织， 效力层级为行政法规（skill 载体）。

本文件的上位法为《全域任务脑手架构宪法》与《全域文件体系基本法》；凡本文件出现的义务性表述，其唯一效力来源均为所标注的宪法条号与源章节，本文件不写宪法未规定者。

本文件替代 2026-09-18 归档版（无归档），差异根源是载体已由 V— 迭代至 V1.1.1。

1　范围

本文件规定了「单文件HTML报告」（V1.1.1）的术语和定义、工作流架构、技术要求、校验方法与交付要件。

LHB/TS-2026-004 兜底路线·单文件离线 HTML 报告锻造器 V1.0.0 — 输入「第三类输入」（用户粘贴的已完成报告全文／既有 HTML／笔记／图像型文档抽取文本），按 004 §4.11(2) 兜底口径一键锻造成合规单文件离线 HTML 报告：底本存档 → 壳层重写（页眉 docmeta／nav.toc 三级全锚点／main.article／footer.doc-foot）→ 版式指纹 → 闸一结构／闸二 SVG 版式／闸三渲染／闸三-B 精确视口四闸校验 → state.json。触发词：形成HTML报告、把这篇全文做成网页报告、粘贴全文出报告、HTML报告生成、第三类输入出报告。

本文件适用于该载体的加载、执行、返工、验收与升级迭代全过程。

2　规范性引用文件

• 《全域任务脑手架构宪法》—— 管任务链路（上位法）
• 《全域文件体系基本法》—— 管文件（上位法）
• 《全域工作流行政法规》—— 管工作流（同级上位）
• GB/T 1.1-2020 标准化工作导则 第 1 部分：标准化文件的结构和起草规则

3　术语和定义

下列术语和定义适用于本文件。六层主干的定义由宪法第 17 条规定，本文件直接引用。

3.1 脑（K3）

负责定标、裁决、诊断与留痕，不施工。

3.2 手（DeepSeek）

按脑下发的标准施工、返工与落盘，不定标。

3.3 本地机械闸

零 Token 校验实体，退出码非零禁止交付，不自备标准。

3.4 人

负责确认、放行与宣布；闭环宣布权留人。

3.5 六层主干

宪法第 17 条规定的架构主干，由 A 入口层至 F 终结层六级构成。

3.6 一进一出

每个任务一次进入、一次交付，不并发多形态产出。

4　工作流架构

本章按宪法第 18–23 条逐层给出本载体的承载节点。共 12 个节点，层序与条号严格对齐；每层节点均标注源章节，可逐条回查。

5　技术要求

本章汇集载体的定标性要求（脑层节点），全部来自源章节，未作增补。

关键铁律（先读再动手）

• 底本必须存档：用户提供的全文先逐字落到 素材/底本存档_原文_<ts>.html（当作 1进1出 的事实源），不得只在内存里改。
• 长文一次 Write 易被截断 → 拆成 <ts>_part1 / <ts>_part2 两次写，再用 Python 拼接，并断言 </html> 结尾与各级标题计数。
• 壳层四件必备（§4.6(3)）：页眉 docmeta（版本／版式名+指纹／生成时间／正式附图数）+ 目次 nav.toc（h2/h3/h4 三级全锚点）+ main.article + 页脚 doc-foot（附图说明／
• 锚点 id 由「层级＋序号」派生（§4.7(8)）：c<章>_<节>，保证跨章同名的「一、二、三…」小节 id 唯一。
• 章级 h2 的锚点一律挂在 <section id="cN"> 上，h2 自身不再加 id（否则与 section 重复、且目次点击落点发散）；节级 h3 的 id 挂自身 id="cN_M"。

铁律五条（违者禁交付）

• 禁私造 style 段 —— 任何 HTML 报告的 <style> 段必须逐字节等于 assets/统一版式/baseline.css；禁新增、禁追加、禁"就加一条"、禁自创配色与字号。
• 禁自建壳层 —— 出稿起点一律复制 assets/统一版式/template_universal.html（R1），占位替换后即为合规页壳；壳层四件（doctype+viewport／.wrap 版心／.docmeta+
• 图表必配题注 —— 每张表必配 <caption>（格式「表 N-M 表名」）、每图必配 figcap（格式「图 N 图名。说明句。制图时点」）。此项由闸门强制计数，缺一即 FAIL。
• 出稿必过双闸，RC≠0 禁交付：
• 母版升版须全链重刷 —— 母版指纹变更时，本 skill 副本与历史终件须同步刷新（流程见 G07 §7），禁只改新件不改旧件（否则旧件 --check 必 FAIL）。

6　校验方法

本章给出载体自带的机械校验点（安全与权限层）。退出码非零即禁止交付。

运行期修订 r3（2026-09-22 · 断言域与闸二容差补正，version 字段不动）

• 闸一「&gt; 零残留」断言必须限定断言域（阻断级）。原 §4.7 口径是全域断言，但底本含代码块时必然产生合法 &gt;——用户底本里的 余额>500、len(sys.argv) > 1 经 esc() 转义后就是 &
• 闸一 h2/h3 计数须限定 <main class="article"> 域（交付级）。nav.toc 自带 <h3>目 次</h3>，全域正则会把它算进标题数，产出 h3=10≠9 假 FAIL。→ 一律在 main
• 闸二对文本横向越界的容差极小 → 中文按「字数×字号」预控（交付级）。闸二判据是「文本是否越出同 y 带的 rect」；实测 rect(40,156,600,44) 内 44 个汉字 ×12.5px ≈ 613px 即已

运行期修订 r6（2026-09-29 · 闸二匹配与取景脚本变量卫生，version 字段不动）

• 闸二 audit_svg_layout.py 的匹配正则要求 class 与 viewBox 相邻（交付级）。正则为 <svg class="..." viewBox="0 0 W H"——属性间不得插入 xmlns 等
• 取景脚本变量卫生：probe 注入与变体生成必须用独立变量（交付级，且闸门查不出）。visual_probe 类脚本若把「注入 probe JS 的字符串」和「干净底本」共用同一变量（如 s = s.replace(..

与本skill 既有闸的关系

• 本skill 原有的结构闸（如 check_six.py 六段骨架）、取证闸（check_active_writer.py）、版面闸（table_layout_gate.cjs／svg_text_overflow_gat
• U07 是前置闸：先过版式（RC=0），再过本 skill 原有闸。任一闸非零即禁交付。
• 本 skill 若与 G07 冲突（版本号／命名／版式细节），以 G07 为准；判据层冲突按宪法第16 条先请示炳哥。

7　交付要件

本章规定交付物形态、命名与落盘要求，逐条对应源章节。

运行期修订 r4（2026-09-22 · 分析型产物两则，version 字段不动）

• 宽表格是闸三-B 窄屏溢出的主因，须用滚动容器包裹（交付级）。对照表在 390／560px 必然越界（本次实测 32 处 OVER，docScrollW=654 > innerW=390）。→ 表格外加 <div cla
• 闸一「原命题留存对账」的 ORIGIN_KEYS 必须从产物实际文本层反查（交付级）。分析型产物（分析对象本身是一份方案／文章）最容易踩：若照抄被分析对象原文的措辞当 key，会因产物用的是自己的转述写法而假 FAIL（

运行期修订 r5（2026-09-24 · 盘点型产物三则，version 字段不动）

• 闸一／build 的「源标记 :指令:」扫描域必须连 <style> 一起剔除（阻断级）。原口径只剔 pre/code，但样式集中在 <style> 块内时，CSS 声明形如 color:var(--ink)／paddi
• figcaption 内嵌 <b> 会使「图号连续性」判据静默失效（交付级，最易漏）。本件图题结构为 <figcaption><b>图 1　…</b>…，而判据正则写作 <figcaption>图\s*(\d+)——取值
• 盘点型产物的底本是「扫描清单」而非成稿，须脚本产出并压缩入档（交付级）。此类任务无用户底本，若把上百个对象的自述全文读进上下文，字数必然失控。→ 先写扫描脚本落地清单文件（只留名称／版本／来源／用途首句），再读清单入上下
• 承接型（续作）产物复用前件脚手架时，<style> 块须逐字不动（省字级，收益最大的一招）。凡「前件已过四闸、本件与之前版式相同」，不必重写样式——直接复制前件的 part1_head.html，只改四处：<title>
• SVG 依赖箭头必须落在目标图元边界上，不得悬空（交付级，且闸门查不出）。本件图 3 原写法是斜线直连两点（x2="560" y2="200"），而目标卡片底边在 y=130——箭头尖端落在空白区，指向语义全失；闸二「无

附录 A（规范性）六层主干与宪法条号对照

附录 B（资料性）载体源清单

附录 C（资料性）未纳入六层的源章节

下列章节不对应宪法第 18–23 条的任何一层，原文保留于载体，此处仅登记不归类。

• 何时使用
• 文件构成
• 失败模式对照（实测）
• 变体 B：图形化图文（「一张图文」海报形态）
• 实证锚点
• 运行期修订 r1（2026-09-17 · 正文事实补正，version 字段不动）
• 运行期修订 r2（2026-09-19 · 本机坑位补正，version 字段不动）
• 运行期修订 r7（2026-09-29 · 大位图内嵌与目视取景补正，version 字段不动）
• 运行期修订 r8（2026-09-29 · 干净版重产与计数自推导，version 字段不动）
• 长文工作流挂载声明（跨层 · 调用方）
• 为何立这条（事故记要）
• 徽章口径（六枚 · 全系列统一）
• 自查口诀（交稿前默念）
• 体裁归属排除清单（G28 §10 · 2026-10-16 炳哥定案）