返回板块
LHB-WB-SPEC-PRD-HTML-001 PRD类文档HTML出件范式技术标准
源文件：
C:/Users/xub/.workbuddy/spec/3.行政法规/范式/LHB-WB-SPEC-PRD-HTML-001_PRD类文档HTML出件范式技术标准_V1.0.0_2026-10-16.md编号：LHB-WB-SPEC-PRD-HTML-001
版本：V1.0.0
批准生效日：2026-10-16（炳哥批准，批准即生效）
批准登记：批准人＝炳哥 ｜ 批准日＝2026-10-16 ｜ 登记人＝WorkBuddy（非手签）｜ 批准日与登记日同日，不倒填
类别：范式标准（行政法规级技术标准）
适用体裁：PRD 需求文档、方案书、校核报告、验收报告、登记册 —— 以文字与表格为主体的单文件自包含 HTML
配套件：《PRD 编写范式技术标准》V1.0.0（同目录）——那件管内容，本件管版式
上位判据：《统一版式规范》G07 V1.2.0（母体）＋《G28 HTML 两栏型统一版式技术标准》V1.0.0（两栏专有判面） ／《全域文件体系基本法》V2.3.0
本文性质：范式标准。只规定「PRD 出 HTML 该长成什么样」，不升母版、不改母版四件。
0 规范缘由（为什么有这份标准）
蓝本 PRD（DSH 侧）内容写得很好，但它的 HTML 版式是私造的：
| 项 | 蓝本 PRD 实际 | W 侧母版要求 | 判定 |
|---|---|---|---|
| style 段 | 自成一套（约 100 行） | 必须逐字节等于 baseline.css |
FAIL · 私造 |
| 母版指纹 | 无声明 | 须声明且等于实算 | FAIL · 缺声明 |
表题 caption |
全部 22 张表 0 条表题 | 每表必配 | FAIL · 缺 22 条 |
图注 figcap |
无图，不适用 | — | N/A |
页脚 doc-foot |
无 | 须含溯源句与判据真源 | FAIL · 缺页脚 |
pre 组件 |
无 | 母版含，代码块必走 pre |
缺组件 |
| 打印样式 | 有但不全 | 母版已含，禁覆盖 | 部分 |
| 响应式 | 有（1020px 单断点） | 母版含双断点（1020/820） | 部分 |
结论：内容是范式，版式不是。这份标准把「版式不是」这一条钉死 —— PRD 出 HTML，一律走母版，不许私造。
1 体裁判定（先判体裁，再套判据）
1.1 三类件分派
| 体裁 | 判别特征 | 套哪套判据 |
|---|---|---|
| 文字表格型 | 以段落与表格为主体，图可有可无 | 本标准（两栏型） |
| 图示型 | 以内联 SVG 图为主体 | G07 §9 图示型判据 |
| 单栏报告型 | 旧母版单栏 .wrap 1060px |
历史件过渡，见 §6 |
分支互斥：一件只归一支。把文字型判据套图示型件，或反之，必报大量 FAIL —— 那是判据错配，不是件坏。
1.2 本标准适用范围
归入（文字表格型）：
- PRD 需求文档、需求文档升级稿；
- 方案书、实施方案、施工方案；
- 校核报告、验收报告、实证报告；
- 登记册、台账呈报件、变更台账呈报件。
不归入：
- 结构简图、流程图、关系图、总图册（→ 图示型）；
- PPT、PDF、DOCX（→ 各自工位，不走本标准）。
2 壳层五件（缺一即 FAIL）
| # | 件 | 判据 | 缺失症状 |
|---|---|---|---|
| 1 | DOCTYPE + <html lang="zh-CN"> + viewport meta |
移动端版心不崩 | 手机打开溢出 |
| 2 | <div class="layout"> 两栏容器 |
max-width:1440px 弹性两栏 |
版心退化为单栏窄条 |
| 3 | <nav class="toc"> + toc-h + ol/li 分层 |
一级 lv1 / 二级 lv2 / 附录 appendix |
目录退化为一堆裸 <a> |
| 4 | <main class="main"> + <header class="doc-head"> |
文头含 tag、h1、sub、head-grid 网格元数据、status-strip 状态条 | 元数据压成两行裸 <p> |
| 5 | <div class="doc-foot"> + .end-mark |
页脚含溯源句 + 判据真源 + 版本指纹 | 无页脚，不知源 |
文头必填字段（head-grid 网格，≥4 格）：
| 格 | 内容 |
|---|---|
| 编号 | PRD 或标准的正式编号 |
| 版本 | 件的版本号 |
| 版式指纹 | 母版指纹（本标准＝4253f7cb） |
| 生成时间 | YYYY-MM-DD HH:MM |
status-strip 状态条（≥3 枚）：状态、批准状态、档位或强制力声明。
3 组件件九项（缺项即 FAIL）
| # | 件 | 强制要求 |
|---|---|---|
| 1 | 三级标题 | h2（21px）→ h3（17px）→ h4（15.5px），不得压扁为两级 |
| 2 | caption 表题 |
每张表必配，格式「表 N-M 表名」，写在 <caption> 内，禁写在表外 <p> |
| 3 | .figure + .figcap 图注 |
每图必配，格式「图 N 图名。说明句。制图时点」 |
| 4 | 五徽章 | .b-ok 通过 / .b-warn 待批准 / .b-no 否决 / .b-info 建议默认值 / .b-gray 留白 |
| 5 | .note 提示框 |
口径声明、结论边界、免责一律走 .note |
| 6 | blockquote.warn 警示框 |
fail-closed 声明、风险警示、与本标准冲突声明 |
| 7 | code / pre |
行内参数走 code；代码块走 pre > code，禁裸文本缩进冒充 |
| 8 | 斑马纹 | 母版已含 tbody tr:nth-child(even)，禁覆盖 |
| 9 | 打印 + 响应式 | 母版已含双断点与 print 样式，禁覆盖 |
4 禁项（命中即 FAIL · 自包含铁律）
| 禁 | 原因 |
|---|---|
<script> 标签 |
零 JS 自包含铁律；一切动效靠 CSS |
<link> 标签 |
禁外链 |
http(s):// 外链（src/href） |
单文件可离线打开 |
内联 on* 事件 |
同上 |
私造 <style> 段 |
本标准第一红线：必须逐字节等于 baseline.css |
| 自创配色与字号 | 新增图形一律复用既有 CSS 变量，禁写死色值 |
表题写在表外 <p> |
图表计数配平判据读不到 |
| 表格行改写用偏移量算术 | 会静默吞掉容器；一律用 re.sub(pattern, callback, region) |
本标准第一红线展开说：
禁私造 style 段 = 禁「照着蓝本抄一套」+ 禁「就加一条」+ 禁「换个配色」
唯一合法做法 = 从母版 baseline.css 逐字节复制，一字不改
母版要改 = 走母版升版流程（请示炳哥 → 全链重刷），不是改单件
5 门禁执行
5.1 四查合一
GATE=~/.workbuddy/_assets/统一版式/format_gate.py
# 出稿前置：注入实算指纹
python $GATE --stamp <件>
# 出稿闸：四查合一，非零即禁交付
python $GATE --check <件>
| 查 | 内容 |
|---|---|
| 查一 指纹（双查） | 实算 style 指纹 == 母版指纹 == 文头声明指纹，三者任一不等即 FAIL |
| 查二 结构件 | 壳层五件齐全 |
| 查三 组件件 | 三级标题 / caption / figcap / head-grid / toc-h / viewport / print / 响应式，逐项查 |
| 查四 禁项 + 图表齐备 | 无 script/link/外链/on*；figure 数 == figcap 数、table 数 == caption 数 |
退出码：0 全过可交付 ／ 1 不合格禁交付 ／ 2 用法或读取错误。
5.2 指纹算法（母版唯一真源，闸不自备标准）
canon(style) = 抽 <style>…</style> 段 → CRLF/CR 归一为 LF → 逐行 rstrip → 删空行 → 首尾 strip
fingerprint = sha256(canon(style).encode('utf-8')).hexdigest()[:8]
本标准当前母版指纹：4253f7cb（两栏型，2026-10-16 升版）。
5.3 闸只判越界，不判压盖
必做第七步：headless 浏览器逐图复看截图，查节点压标题、轴标题与图例撞行、年份标签相撞、多行图注间距 < 18px。
三闸全绿 ≠ 无压盖。 实测曾出现闸门 rc=0、溢出 0，逐图复看仍有真重叠。
6 出稿八步（PRD 类件统一执行序）
| 步 | 动作 | 过闸判据 |
|---|---|---|
| R1 | 从 template_universal.html 复制为 〔任务夹〕/产出/〔标的〕_〔报告类型〕_V〔x.y.z〕_〔YYYY-MM-DD_HHMM〕.html |
文件名与 <title>／<h1> 逐字一致 |
| R2 | 替换占位：__FILE_STEM__／__VERSION__／__DATETIME__／__FIGCOUNT__ 等 |
无 __ 残留 |
| R3 | 填正文：每表配 caption、每图配 .figure+.figcap、结论走 .note／blockquote.warn |
图表计数配平 |
| R4 | 图形全部内联 SVG，复用既有 CSS 变量色值，禁 SVG 内写 HTML 标签 | <svg> 数 == .figure 数 |
| R5 | 跑 --stamp 注入指纹 |
文头声明 == 实算 |
| R6 | 跑 --check 过闸 |
RC=0 |
| R7 | headless 逐图复看截图 | 零压盖、零撞行 |
| R8 | 写台账 + 跑 sync_disks.py + check_dual_end.py |
三端一致 |
7 PRD 类件专有判面（十项 · H 类）
这是本标准区别于通用版式的部分。PRD 有 PRD 的硬要求。
| # | 判据 | 通过线 | 判法 |
|---|---|---|---|
| H01 | 八关键节齐全 | 节名逐字在位 | 目录锚点 == 节名 |
| H02 | 非目标节存在 | 存在且非空 | grep 节名 + 字数 > 0 |
| H03 | 已知约束节存在 | 存在且非空 | 同上 |
| H04 | 方括号占位符未澄清数 | = 0 | 正则扫「待填」「待澄清」字样（判据条文内引用须避开该二词） |
| H05 | 量化参数表存在 | 存在且状态列在位 | 见配套件第 5 节 |
| H06 | 待裁项五列完整 | 序号/事项/为何不能代裁/后果/状态 | 列头逐字比对 |
| H07 | 签署表存在 | 提交/审核/批准三行 + 日期列 | 见配套件 §11 |
| H08 | 呈报信息在位 | 文头或页脚标 approval_ref 与 prd_status | 全文搜 prd_status |
| H09 | 状态声明在位 | 明示「待批准稿不表示已生效」类声明 | 见配套件 §11.2 |
| H10 | 单文件自包含 | 零 script／零 link／零外链／零 on* | 门禁查四 |
H 类判定规则：H01—H10 全部满足 → 「PRD 件合格」；任一不满足 → 禁交付。
8 历史件过渡
| 情形 | 处置 |
|---|---|
已交付的单栏 .wrap 1060px 件 |
不强制返工；改版时再套两栏 |
| 已交付但 style 私造的件 | 新交付件不得沿用；旧件登记为历史私造件，不宣称符合本标准 |
| 从 DSH 侧搬来的件 | 一律重出：DSH 侧版式与 W 侧母版不同源，重出时套 W 侧母版并重跑门禁 |
| 双盘件 | 两侧各自出图、各自升版、各管各的，不互相代管、不同步 |
9 约束与风险
9.1 约束
- 本标准不改母版四件：改母版＝升版，须请示炳哥；
- 本标准不覆盖 G07／G28：本件是 PRD 体裁的专有判面，总纲仍在 G07；
- 本标准不代裁：母版升版、内容判据争议均转人；
- 本标准不代管 DSH 侧：跨盘只作参照。
9.2 风险登记册
| 编号 | 风险 | 影响 | 缓解 | 责任侧 |
|---|---|---|---|---|
| HRK01 | 照抄蓝本 PRD 的私造 style | 指纹不符，门禁 FAIL | 第 4 节第一红线展开 | 出件方 |
| HRK02 | 22 张表全漏表题 | 判为排版不合格 | H/R3 图表配平 | 出件方 |
| HRK03 | 无 <pre>，代码块裸缩进 |
长串换行错乱 | 第 3 节组件 7 | 出件方 |
| HRK04 | 三级标题压成两级 | 章节层级丢失 | 第 3 节组件 1 | 出件方 |
| HRK05 | 页脚无溯源句 | 不知源、不知判据 | 壳层件 5 | 出件方 |
| HRK06 | 母版升版后历史件批量 FAIL | 闸门全线拦 | 母版升版流程第 4 步全链重刷 | 母版侧 |
| HRK07 | 判据套错体裁（图示型套文字型） | 必报大量 FAIL | §1.1 先判体裁 | 出件方 |
| HRK08 | 闸门绿灯就交付，压盖漏检 | 图元互相压盖 | R7 逐图复看不可省 | 出件方 |
| HRK09 | H 类判据未落机器闸 | 靠人眼 | 先人工判，闸后补 | 编制方 |
10 交付物
| 编号 | 交付物 | 格式 | 是否必需 |
|---|---|---|---|
| HO1 | 本标准正文 | Markdown | 是 |
| HO2 | PRD 空白模板（两栏型 · 十节骨架 · 占位齐全） | HTML | 是 |
| HO3 | 门禁实测回执 | JSON | 是 |
11 验收与签署
11.1 签署表
| 角色 | 姓名 / 身份 | 状态 | 日期 |
|---|---|---|---|
| 提交方 | WorkBuddy（K3 定标，不施工） | 待提交 | 2026-10-16 |
| 审核方 | 待炳哥指定 | 待审核 | |
| 批准方 | 炳哥 | 待批准 |
11.2 当前状态声明
- 本标准经炳哥批准，2026-10-16 批准即生效；
- 本标准不改母版四件（
baseline.css／_format_baseline.json／template_universal.html／format_gate.py）——批准日实测一字未动，指纹仍为4253f7cb； - 本标准生效后母版目录新增三件（增件非改件，不影响既有指纹）：
template_prd_universal.html（PRD 空白模板）＋blueprint_prd_DSH_两栏私造版_原样参照.html（蓝本参照件，逐字节零改动收入，sha256 一致）＋PRD字段校验清单_V1.0.0_2026-10-16.md； - 本标准不追溯任何历史件，不宣称历史件符合；
- 本标准不代管 DSH 侧版式，跨盘只作参照 —— 两侧各管各的；
- 本标准不代裁任何待裁事项；
- 本标准与《PRD 编写范式技术标准》配套使用，单独一份不完整。
本标准结束。版式真源在母版，本件只规定 PRD 体裁怎么套。
利衡辨 · 全域资料站 ｜ 全域七链元路由 · 一进一出
宪法 ＞ 基本法 ＞ 行政法规 ＞ 地方法规 ＞ 地方规章
宪法 ＞ 基本法 ＞ 行政法规 ＞ 地方法规 ＞ 地方规章