万工-消防设计
⚠️ 使用边界与责任声明
本 skill 是设计辅助工具,不是设计责任主体。所有输出:
- 必须经注册建筑师/注册工程师人工审核后方可作为设计依据;
- 涉及强制性条文、结构安全、消防安全的结论,必须回原文(verify.py 取证)并经专业签字人确认;
- 数值/条文号可能因版本更新失效,使用前须核对现行有效版本;
- 本 skill 不承担因使用其输出导致的任何工程责任。
一句话:AI 提供线索,人做最终判断,签字人担最终责任。
语料来源与许可状态
本 skill 的取证索引指向以下语料,均不随包分发,须用户自备并自行确认来源合法性:
| 语料 | 性质 | 许可 / 合规要求 |
|---|---|---|
| GB 系列国家、行业标准(本地 PDF 库) | 公开标准 | 用户须自备正版;语料根路径用 env WANGOING_FIRE_SRC 覆盖 |
| 消防规范网 gf.cabr-fire.com 目录与条文 | 第三方整理的公开网页 | 只做路由与取证锚点,不复制条文正文;任何数值 / 条文号须回国家正版核验 |
| 建筑消防视频教程 / 课件(蒸馏归纳) | 第三方教学内容 | 只做结构地图与要点归纳;标〔规范取证·视频未讲〕的条目来自规范取证,不是讲师讲授内容 |
> 红线:本 skill 不分发任何规范全文、图集、视频、课件原件。凡进入设计文件的数值与条文号,必须回正版原文核验。
一套消防设计的查证操作系统,不是规范摘要。
取证元信息集中声明(数值·版本·时间)
> 本节是法律风控第 5 步的统一载体——分册级元信息在每分册 frontmatter,数值级的取证时间和版本状态在这里集中声明。
> 任何在本 skill 出现的"数值/阈值/面积/宽度/距离/条文号",其取证时间和规范版本均按下表核对。
1) 本包涉及的规范范围(截至 v1.8.1)
| 规范号 | 版本状态 | 实施日期 | 主要承载分册 | 取证来源 |
|---|---|---|---|---|
| GB 55036-2022 消防设施通用规范 | 现行(强制性) | 2023-03-01 | 08 / 09 | 本地 PDF(文字层) |
| GB 51251-2017 建筑防烟排烟系统技术标准 | 现行 | 2018-08-01 | 11 | 本地 PDF(132 页,文字层) |
| GB 55037-2022 建筑防火通用规范 | 现行(强制性) | 2023-06-01 | 03 / 12 | 本地 PDF |
| GB 50084-2017 自动喷淋设计规范 | 现行 | 2018-01-01 | 07 / 12 | 本地 PDF(部分页需 OCR) |
| GB 50016-2014(2018 年版)建筑设计防火规范 | 现行 | 2018-10-01(局部修订) | 03 / 12 | 本地 PDF |
| GB 55022-2021 / GB 55021-2021(既有建筑鉴定/加固) | 现行(强条部分) | 2022-12-01 | 13 | 站点语料(本地无 PDF,置信度中) |
| 中华人民共和国消防法(2021 修订) | 现行 | 2021-04-09 | 04 | 本地 PDF |
| 住建部令第 58 号《建设工程消防设计审查验收管理暂行规定》 | 现行 | 2020-06-01 | 04 | 本地 PDF(扫描件,需 OCR) |
| 广州市既有建筑改造消防设计指引 | 地标·参考性 | — | 13 | 站点语料 |
| 广东省建设工程消防设计疑难解析 | 省级·参考性 | — | (仅路由,无取值) | 站点语料(图片版无效) |
> ⚠️ 不在本表=不在本 skill 可引用范围。如出现未列规范的数值,须先建本表条目再引用,否则视为越界。
2) 统一取证时间窗
- 本期取证时间窗:2026-08-30 ~ 2026-09-05(第二发布周期)
- 取证命令模板:
python scripts/verify.py get "<规范号或文件名关键字>" <起始页> <结束页> - 引用统一格式:
规范号 + 条文号 + PDF pNN + 取证 YYYY-MM-DD
3) 已知冲突 / 存疑数值(双标注,不擅自取舍)
| 数值 | 来源 A | 来源 B | 本 skill 处理 |
|---|---|---|---|
| 防火分区面积 4.4.2 vs 4.1.2 | 站点语料(按 GB 50016-2014 现行表述) | 本地 PDF OCR(早期表述) | 并列标注·存疑待核(设计人回正版原文核验) |
| 混凝土加固准入强度(≥C13) | GB 55021-2021 条文归纳 | — | 置信度中(本地无 PDF,须人工核条文号) |
| 养老/幼儿园自动灭火系统触发条件 | GB 55037-2022 第 8.1.9 条第 6 款 | GB 50084 附录 A(轻危险级 4 L/(min·㎡)) | 已按双规范分册承载,不互替 |
4) frontmatter 字段约定(每分册必带)
---
created: YYYY-MM-DD # 该分册首次合入日期
type: <类型> # 视频蒸馏 / 规范取证 / 设计判据 / 路由索引 ...
source: <来源> # 本地 PDF 路径 / 站点 URL / 课件名
content_grade: L1|L2|L3|L4 # 分册内容分级(见 §使用边界)
confidence: 高|中|低 # 数值可信度
status: <当前周期状态> # 草稿 / 已合入 / 存疑待核
---
> 早期分册(02/03/05/06)frontmatter 将在 v1.9 周期补全;本期先以本集中声明兜底。
第一性原理:不背条文
消防规范有法律后果,凭记忆复述数字就是事故源头。本 skill 不复制任何条文的阈值、数字、面积、宽度、距离。它只做三件事:
路由 → 取证 → 引用
- 路由:把用户的问题定位到「哪本规范的哪个章节,PDF 第几页」
- 取证:用
scripts/verify.py从源 PDF 抽取原文(文字层直接抽;扫描件自动 OCR 指定页) - 引用:输出必须带
规范号 + 条文号 + PDF 页码 + 原文摘录
任何一次给出具体数值之前,必须已经跑过取证。 这是本 skill 的绝对红线。
语料与效力层级
源目录:(本地语料根,由 WANGOING_FIRE_SRC 环境变量覆盖)\(93 项:55 本法规规范 + 38 本图集,约 11000 页)
> 换机 / 换人使用:把语料放到任意目录,设置环境变量 WANGOING_FIRE_SRC 指向该目录即可,verify.py 会自动读取,无需改动代码。
> 离线/在线分界:list / route / toc 仅依赖内置索引 _codes.json,可离线使用;get / search 需语料 PDF 就位(默认读上方源目录,或用 WANGOING_FIRE_SRC 指向你的语料)。
法律 消防法(2021修订) [55]
↓
部门规章 住建部令第58号 设计审查验收暂行规定 [53]
↓
全文强制通用规范 GB 55037 建筑防火通用规范 [9] ← 建筑防火的"宪法"
GB 55036 消防设施通用规范 [8] ← 消防设施的"宪法"
↓
专业国家标准 GB 50016 建规 / GB 50084 喷规 / GB 50974 消水规 /
GB 50116 火规 / GB 51251 烟规 / GB 50222 装修规 /
GB 50151 泡沫灭火 …
↓
产品标准 GB 12955 防火门 / GB 4351 灭火器 / GB 17945 应急照明 …
↓
管理标准 GB 25201 / GB 25506 / GB/T 40248 / GB/T 38315 / XF 3019 …
↓
行业专项 GB 50098 人防 / GB 51298 地铁 / GB 51236 航站楼 /
GB 50229 火电 / GB 50160 石化 / GB 50039 农村 …
↓ ← 解释层,不是判据
图集·图示 18J811-1 建规图示 / 15K606 防排烟图示 / 14X505-1 火规图示 /
15S909 消水规图示 / 12J814 汽车库图示 / 12J609 防火门窗 /
07J905-1 防火构造 / 19S910 自喷设计 / 20S206 自喷安装 …
冲突三条铁律(判定前必读):
- 通用规范优先 — GB 55037 / GB 55036 是 2022 改革后新设的全文强制规范。与下位专业标准冲突时以通用规范为准;引用旧专业标准前先确认其条文未被通用规范覆盖或废止。
- 程序看 55 号文 + 53 号令 — 消防法 2021 修订把设计审查验收职责划转住建主管部门。"报谁审、谁验收"一律以这两份为准,不要用旧流程。
- 从严不是通则 — 不同标准对同一对象要求不一致时,先判断适用范围是否重叠。专业标准针对特定对象(汽车库、人防、地铁)时,其专项规定优先于通用标准的一般规定;只有适用范围真正重叠时才取严。
- 图集是解释,不是判据 — 图集(18J811-1、15K606、15S909 等)是对规范条文的图示化解释与做法示例。判定合规性一律以规范正文为准;图集只用于:① 理解条文意图;② 找构造做法;③ 作为设计文件的做法佐证。绝不能拿图集里的尺寸去替代规范里的强制性数值。
图集怎么用
38 本图集按用途分三类:
| 类型 | 用途 | 代表 |
|---|---|---|
| 规范图示 | 把条文画成图,理解条文意图最快 | 18J811-1 建规图示、15K606 防排烟图示、14X505-1 火规图示、15S909 消水规图示、12J814 汽车库图示、21X505-2 报警验收图示 |
| 构造详图 | 直接可引用的做法 | 07J905-1 防火建筑构造、12J609 防火门窗、22D701-3 电缆桥架、25S402 管道支吊架 |
| 选用与安装 | 设备选型与安装做法 | 19S204-1 消防水泵、19S910 自喷设计、20S206 自喷安装、13S201 室外消火栓、15S202 室内消火栓、19D702-7 应急照明、24CX506-2 储能电站灭火 |
正确姿势:先用规范条文定判据 → 再用图集定做法 → 输出时两者都引,规范在前、图集在后。
python scripts/verify.py route "防火墙构造做法" # → 07J905-1
python scripts/verify.py route "防火分区图示" # → 18J811-1
图集与规范的对应关系见 references/01-规范路由表.md 的「图集 ↔ 规范对应」表。
工作流
先读 references/02-设计自查清单.md 拿完整检查项与页码锚点。以下是主干。
W0 定性(一切的前提,跳过必错)
拿到项目先锁死这 8 个属性,后续所有阈值都挂在它们上面:
| 属性 | 取值 | 影响 |
|---|---|---|
| 建筑类型 | 民用 / 工业 / 仓库 / 特殊工程 | 适用规范族 |
| 使用性质 | 住宅/公共建筑/厂房/库房/商业/医疗/教育… | 分区面积、疏散、设防 |
| 火灾危险性 | 甲/乙/丙/丁/戊 | 工业建筑一切指标 |
| 建筑高度 / 埋深 | m | 高层判定、消防电梯、避难层、防烟 |
| 层数(地上/地下) | 层 | 楼梯间形式、室内消火栓 |
| 建筑面积 / 占地面积 | m² | 分区、设施设防阈值 |
| 耐火等级 | 一/二/三/四 | 分区面积、间距、构件极限 |
| 是否既有建筑改造 | 是 / 否 | 走 1.0.5 条目标导向路径 |
> 定性表填不完整时,先向用户要这 8 项,不要开始查条文。
W1 总平面
防火间距 · 消防车道 · 消防车登高操作场地 · 消防救援口(≥2 个/防火分区,净 ≥1.0m×1.0m)· 市政消火栓条件
→ 路由:GB 55037 §3(PDF p21-24)、§2.2(消防救援设施,PDF p16-21)
W2 平面布置与防火分隔
防火分区面积 · 防火墙/防火隔墙 · 竖向分隔(竖井、幕墙层间封堵)· 平面布置禁忌(甲乙类不下地等)
→ 路由:GB 55037 §4(PDF p24-33)、§6.3 防火封堵(PDF p38-39)
W3 结构耐火
耐火等级 · 构件耐火极限 · 钢结构防火保护
→ 路由:GB 55037 §5(PDF p33-37)、GB 51249 钢结构防火
W4 安全疏散
出口数量/宽度/距离 · 楼梯间形式(敞开/封闭/防烟)· 前室面积 · 避难层/避难间 · 疏散门开启方向
→ 路由:GB 55037 §7(PDF p45-56)
W5 消防设施
设防判定(要不要设)→ 系统设计参数(怎么设)
→ 路由:GB 55037 §8(PDF p56-63)判定设防;GB 50974 / 50084 / 51251 / 50116 做参数
W6 构造与装修
防火墙 · 防火门窗卷帘 · 竖井与封堵 · 内部装修燃烧性能 · 外保温
→ 路由:GB 55037 §6(PDF p37-45)、GB 50222 装修、GB 12955 防火门、GB/T 51410 封堵
W7 出图与审查
设计文件深度 · 消防设计专篇 · 审查要点 · 验收/备案
→ 路由:消防法 §9-13、住建部令 58 号、GB 46034(公众聚集场所检查)
W8 现场验收评定(见 references/06-消防验收评定.md)
现场评定项目三分法(A 关键 / B 主要 / C 一般)· 抽样规则 · 合格判定 ·
假整改识别(图物一致性三方比对 + 联动反馈信号闭环)· 局部验收 · 七段式复查框架 ·
七类输出模板(法规解读 / 设计审查 / 验收评定 / 安全管理 / 隐患排查 / 设施运维 / 扑救科普)
> 04 与 06 的分工,不要混用:
> references/04 管程序与责任(报谁审、谁验收、罚则);
> references/06 管现场技术评定(评什么、怎么抽样、怎么判、怎么识别假整改)。
>
> ⚠️ 06 分册不含任何阈值:分类归属、抽样比例、不合格率等数字
> 一律先 verify.py 取证再引用,不得凭记忆给出(本 skill 第一性原理)。
取证操作
命令
# 1) 列出全部规范及其路径/页码/域
python scripts/verify.py list
# 2) 按主题路由:告诉我该查哪本哪页
python scripts/verify.py route "高层住宅疏散楼梯净宽度"
# 3) 取原文:规范号(或文件名关键字) + PDF页码
python scripts/verify.py get "GB 55037" 45 48 # 抽第45-48页(文字层)
python scripts/verify.py get "GB 50016" 55 58 --ocr # 扫描件走本地 OCR(RapidOCR)
python scripts/verify.py get "GB 50084" 21 --ocr-engine hunyuan
# ↑ 扫描件走 HunyuanOCR 在线通道(讯飞 MaaS,需 XFYUN_API_KEY):
# 表格输出 Markdown 保真更好、条文号/数值实测 6/6(2026-09-05 GB50084 p21 实测),
# 约 6 秒/页;合并单元格结构有损需人工校对;结果缓存 ocr_cache.json(键 hunyuan:页号)
# ⚠️ 结构化 JSON(tables-json / parse_md_tables)仅用于检索定位表格位置,禁止直接作数值判据——
# 引用规范数字仍须回到 OCR 原文逐字核对后再落入结论
# ⚠️ p21/p59 预热缓存(ocr_cache.json)为本机文件,不随包分发——下游环境须自行重跑 OCR
# 4) 全文关键词检索(限有文字层的 33 本)
python scripts/verify.py search "防火分区最大允许建筑面积"
# 5) 单本规范的章节目录
python scripts/verify.py toc "GB 50974"
Python 解释器:<隔离 venv>/Scripts/python.exe(路径因机而异)(已装 pymupdf + rapidocr-onnxruntime)
文字层 vs 扫描件
93 项中 有文字层可直接抽(毫秒级)与 扫描件需 OCR(约 4 秒/页)各占一半。
verify.py get 会自动判断并给出提示;扫描件首次 OCR 会缓存到 .cache/ocr_cache.json,第二次起直接命中。
查某本是否扫描件:verify.py list 的「取证」列;或 verify.py toc <编号> 看目录来源。
已知需要 OCR 的重点资料:GB 50016 建规、GB 55036 设施通规、GB 50116 火规、GB 50084 喷规、GB 50222 装修规、GB 50067 汽车库、GB 51249 钢结构、GB 50098 人防、18J811-1 建规图示、14X505-1 火规图示、19S910 自喷设计图集、大多数选用安装类图集。
分卷资料(页码已按全本连续编号,get 会自动定位到对应分卷):
GB 50151 泡沫灭火(150+84=234 页,文字层)、18J811-1 建规图示(已用 276 页单文件版)、19S204-1 消防水泵(100+96=196 页)、25S402 管道支吊架(100+99=199 页)。
输出规范
引用格式(必须)
> GB 55037-2022 第 7.1.4 条第 3 款
> 「疏散走道、首层疏散外门、公共建筑中的室内疏散楼梯的净宽度均不应小于 1.1m」
> —— 源:9.GB 55037-2022 建筑防火通用规范.pdf 第 47 页
引用图集时注明其解释属性:
> 18J811-1《建筑设计防火规范》图示 第 X 页(图示,做法佐证)
> —— 源:A131-消防图集合集\消防图集\6、18J811-1 《建筑设计防火规范》图示.pdf 第 X 页
> 判据仍以 GB 50016 正文为准
禁止:只给数字不给出处;只给规范号不给页码;用"我记得""通常""一般是"这类措辞;拿图集尺寸替代规范强制性数值。
自查报告结构
【定性】8 项属性表
【结论】符合 / 不符合 / 需论证,逐条列
【依据】每条结论后紧跟引用块(条文号+页码+原文)
【风险】需专业论证或突破条文的事项,单列并说明论证路径
【待补】信息不足、需用户提供的输入
标书/专篇写作
技术标消防章节按 references/02-设计自查清单.md 的 W1-W7 骨架展开,每条结论后附取证引用。评分要点是依据的准确与完整,不是辞藻。
边界与禁区
该做
- 查证并引用具体条文,给出处
- 指出规范冲突并说明适用顺位
- 提示需专业论证(性能化设计、专家评审)的情形
- 标记信息不足、需要用户补充的定性参数
不该做
- ❌ 凭记忆给任何数字。没跑取证就不能给阈值、面积、宽度、距离、极限
- ❌ 用"大概""通常""一般是"搪塞
- ❌ 把 A 规范的工业建筑条款套到民用建筑上
- ❌ 引用未核对版本的旧条文(2022 通用规范改革废止了大量旧条文)
- ❌ 把本 skill 当作消防工程产品选型、施工组织、事故调查的依据
- ❌ 在改造类项目上直接套新建标准(先走 GB 55037 第 1.0.5 条)
能力边界声明:本 skill 的语料是设计规范体系,不覆盖:消防产品采购选型、消防工程施工组织设计、火灾事故调查鉴定、地方性法规(项目所在地(含广东省)地方规定需另行核对)、性能化消防设计的软件与模拟。
与「万工-住宅标准化设计」的双向挂钩
当用户问的是住宅项目里企业体系具体怎么做(而非法定判据),本 skill 应指向住宅标准化 skill:
- 企业落地做法(非强条):火灾自动报警及联动、应急照明疏散、电气火灾监控、防火门监控、消防设备电源监控、防排烟/正压送风、消火栓箱选用、防火门/窗选型等
→ 查「万工-住宅标准化设计」skill:verify.py fire "<kw>"(住宅消防交叉入口) - 效力关系:国家规范 > 地方标准 > 企业做法。住宅 skill 里的做法是经验落地,不是强条判据;具体阈值仍以此 skill(GB 55037 / GB 55036 / 专业规范 / 图集)为准。
- 城市差异:城市分册常标注与总部标准的「新增/加严/放宽」差异,引用时须注明且不得突破国标下限。
- 住宅 skill 侧详见
references/03-消防交叉.md;两 skill 互为引用、互不替代。
参考文件
| 文件 | 用途 |
|---|---|
references/01-规范路由表.md |
91 项全表:路径、页数、域分类、取证方式、章节锚点;含「图集 ↔ 规范对应」表 |
references/02-设计自查清单.md |
W0-W7 完整检查项与页码锚点,自查/标书骨架 |
references/03-既有改造与隐患判定.md |
既有建筑改造定性路径(1.0.5 条)+ GB 35181 判定程序 |
references/04-审查验收与责任.md |
消防法 + 58 号令的程序链条与罚则(报谁审/谁验收) |
references/06-消防验收评定.md |
现场技术评定:A/B/C 三分法 · 抽样与判定 · 假整改识别 · 七段式复查 · 七类输出模板(不给阈值,须取证) |
references/07-给排水消防实战.md |
水消防(消火栓/自喷/给水设施/灭火器)课件蒸馏,课件值 ↔ 现行规范双标注 |
references/08-GB55036消防设施通用规范.md |
GB 55036-2022 第 12 章唯一权威收录(12.0.1–18 条文卡片,〔强制〕标注) |
references/09-火灾自动报警系统.md |
报警实战:ASR 结构 + 规范数值分离;§3 子集缺口为「视频未讲」索引(条文见 08) |
references/10-消防规范在线路由.md |
在线取证回退:消防规范网全站目录 1992 条(名称/编号年份/URL)。本地 PDF 缺失时用 |
references/11-防排烟实战.md |
GB 51251-2017:20 条强条清单 + 章节→PDF 页码路由 + 设计判据链(含 1 处源间冲突待核) |
references/12-既有建筑改造消防.md |
既有改造定性三层依据(GB 55037 原文 / GB 55022 / 属地)+ 六步判据链 + 各地指南路由 |
references/13-既有建筑鉴定与加固路径.md |
A2 模板:先鉴定后加固法定程序 · 三层次×四等级鉴定体系 · 4.2.2 鉴定目的决定验算标准 · 加固准入数值(混凝土 ≥13.0 MPa / 正拉粘结 ≥1.5 MPa)· 加固×消防交叉检查点(置信中,本地库无 GB 55021/JGJ 123,须回正版核) |
references/14-在线答疑与大讲堂索引.md |
在线取证路由:消防资源网 dayi 答疑汇编(给水 1000 问/防排烟 500 问/规范专项答疑)· v.1190119 大讲堂原理索引 · asklist 实战场景预警(〔社·低〕)。索引型不囤全文——数值判据仍走 verify.py 国标取证 |
scripts/verify.py |
取证脚本:list / route / get / search / toc / offset(支持分卷与子目录) |
scripts/fire_online.py |
离线检索在线规范目录:code GB51251 / kw 防排烟(只查本地目录,不联网) |
配套知识库(Knowledge 轨)
<工作区>/蒸馏知识库/(路径因机而异)(H 盘不存在,改落此处;可整体迁移)
与 skill 同源但分工不同:skill 负责可执行,卡片负责检索 / 比对 / 进化。
| 目录 | 内容 |
|---|---|
cards/A005消防规范-93项/ |
14 张知识卡片(fx-01 … fx-14),含核心主张 / 依据原文 / 常见坑 / 可证伪声明 |
topics/ |
11 个实战主题(建筑定性、总平面与防火间距、防火分区与分隔、安全疏散、消防设施、构造与装修、既有建筑改造、审查验收与责任、隐患判定、图集与做法、查证方法) |
bridge/待验证假设.md |
verifiable 卡片的假设与证伪条件 |
synthesis/ |
跨书目综合(目前待补) |
用法:讨论某个主题的原则性判断时,先查对应卡片拿主张与依据;执行具体取证时回到本 skill 的 scripts/verify.py。
卡片的每条原文都标注了源文件名与 PDF 页码,可用 verify.py get 复核。
WPS/Office 增强模块(scripts/wps_bridge.py · v4.0.0 产出引擎)
借鉴《WPS Office 全家桶》v4.9(四引擎识别/自动重试/硬件自适应)+《党政机关公文标准排版》GB/T 9704-2012(docx 公文样式)+《PPT 生成器/Slide maker》(配色主题/一页一主题/渲染自检)+《PDF和图片文字提取》(文字层+扫描页 OCR)。把「路由→取证→引用」一键落成 消防设计说明 / 审查意见 / 既有改造消防专篇(.docx / .pptx / .pdf / .md),与本机 WPS 深度兼容。
典型链路
- 路由取证:
python scripts/verify.py route "住宅 楼梯间" && python scripts/verify.py get 50140 30 - 组装 outline JSON(结构见下),AI 依据取证结果填充(引用必须带 source/clause/page,不臆造)
- 产出 + 自检:docx/pptx 生成 →
check视觉自检 →export导出 PDF
命令速查
python scripts/wps_bridge.py engine-info # 引擎 + 硬件自适应(首次先跑)
python scripts/wps_bridge.py outline --sample # outline JSON 模板
python scripts/wps_bridge.py docx --input o.json --output 消防设计说明.docx [--style default|gongwen|bid]
python scripts/wps_bridge.py ppt --input o.json --output 消防设计审查汇报.pptx --size a3 --theme tech [--closing]
python scripts/wps_bridge.py export --file 消防设计说明.docx --format pdf # WPS→MS→LibreOffice 降级
python scripts/wps_bridge.py extract --file 扫描版.pdf --out 提取.md [--pages 1-10] # 文字层+扫描页OCR
python scripts/wps_bridge.py check --file 方案.pptx # 视觉自检
python scripts/smoke_test.py # 发布前全链路自检(15项)
python scripts/wps_bridge.py docx --input o.json --output 公文.docx --style gongwen # v4 完整公文要素
python scripts/wps_bridge.py docx --input o.json --output 公文.docx --style gongwen --doctype 请示 # 手动指定/覆盖文种(决定收束语,自动判定不准时用)
python scripts/wps_bridge.py diagram --input d.json --output 流程.svg # v4 图表 SVG
python scripts/wps_bridge.py check --file 公文.docx --anti-ai --doc-kind 通知 # v4 去AI味自检
python scripts/wps_bridge.py extract --file 扫描.pdf --out 提取.md [--pages 1-20] # 页面状态+数字复核
排版预设(docx --style)
| 样式 | 适用 | 标题 | 正文 | 说明 |
|---|---|---|---|---|
| default | 设计说明 | 黑体 15/13 | 宋体 12 | 首行缩进2字,1.5倍行距 |
| gongwen | 公文/请示/通知 | 方正小标宋 22(二号) | 仿宋_GB2312 16(三号) | 行距28磅;一级黑体、二级楷体、三级仿宋加粗 |
| bid | 技术标书/投标文件 | 黑体 22/16/14/12 | 宋体 12(小四) | 1.5倍行距 |
页脚自动右下角页码;标题居中;表格蓝头白字;引用灰字注(来源+条款+页码)。字体缺失时 WPS 自动替换显示,可改系统字体名。
PPT 主题配色(--theme,8 套)
| 主题 | 主色/背景 | 适合 |
|---|---|---|
| midnight 午夜商务 | 深蓝 1E2761 | 商务汇报/金融 |
| tech 科技深空 | 黑底 0D1117 + 蓝 58A6FF | 技术/产品发布 |
| ocean 海洋渐变 | 深蓝 065A82 | 医疗/健康 |
| green 青绿信任 | 青绿 028090 | 环保/公益 |
| coral 珊瑚活力 | 珊瑚 F96167 | 创意/营销 |
| sage 鼠尾草静 | 石板 50808E | 健康/生活 |
| charcoal 炭灰极简 | 炭灰 36454F | 极简/设计 |
| premium 高端黑金 | 黑底 111111 + 金 D4AF37 | 高端提案/发布 |
--size a3 = 420×297mm 横版(投标/汇报惯用);--closing 自动加致谢页。
公文排版(--style gongwen,v4 完整要素)
红头 → 发文字号 → 红旗线 → 标题 → 主送机关 → 正文(仿宋三号/行距28磅/首行缩进2字)→ 收束语(按文种自动)→ 附件 → 落款 → 日期 → 附注 → 抄送版记。
支持文种:通知/通报/报告/请示/批复/函/纪要/决定/通告/公告/意见/方案/总结(doc_kind 字段自动匹配收束语与纪律)。
取模板:python scripts/wps_bridge.py outline --sample gongwen
--doctype 通知/报告/请示/函/… 可手动覆盖 outline 中的 doc_kind(自动文种判定不准时生效)。
图表生成(diagram,v4)
--input 图表 JSON(nodes/edges,type=flow|arch)→ SVG(680 宽、marker 箭头、白底防压字,可直接 show_widget 展示或插入文档)。
适用边界(务必遵守):本引擎擅长 ≤20 节点的线性流程 / 树状结构(如消防审查流程、功能分区、技术路线)。节点 >20、网状交叉、跨页大图、时序细节多、含统计/地图时,不要硬塞 SVG,改用 Markdown Mermaid 代码块或 show_widget 交互组件,并主动向用户说明能力边界与替代方案。
产出与表达规范(详见 references/05-产出与表达规范.md)
> ⚠️ 红线:使用本模块产出任何 .docx / .pptx / .md 文档前,必须先读 references/05-产出与表达规范.md(文种决策 / 格式 / 双 pass 去 AI 味 / 图表规范 / 提取规范全在其中)。未读就产出视为违规。
公文写作(文种决策/格式/双pass去AI味/评分rubric)、表达纪律(段落功能/判断强度分级/抽象词控制/句法节奏)、
图表规范(SVG 680/marker/防压字/能力边界)、意图路由与调研字段、双重复检(表达指纹 + 事实一致性/取证溯源)、
提取规范(页面诊断/结构优先级/高风险数字复核/不确定标记)。
产出前必过双重复检:复检一表达指纹(不空/不飘/不假整齐/文种贴合)、复检二事实一致性(每条数据可溯源到取证页码,未取证用〔占位符〕)。
文字提取(extract)
- PDF:文字层直取;扫描页自动 RapidOCR(标记「扫描页·OCR」);图片(png/jpg/…)自动 OCR
- 输出 Markdown:来源/页数/文字页/扫描页统计 + 分页正文
- 数字规范:面积、编号、金额等关键数字串,AI 须用 read_image 双轮校验(全局 + 聚焦),两轮不一致标 [待确认],校验过程静默不展示
视觉自检(check)
- pptx:信息过载(>400字/页)、字号过小(正文<14pt、注释<10pt)、默认主题蓝
- docx:空文档、标题层级缺失
- 按提醒修复后再导出:溢出→删减/拆分,字号→调大,默认蓝→换主题
内容规划原则(吸收 PPT Generator / Slide maker)
- 一页一主题;3 秒可懂;标题>副标题>正文>注释的视觉层次
- 每页 3-5 要点、有数据/案例支撑;避免整页纯文字
- 布局多样:左文右图 / 图标行列 / 大数据展示 / 时间轴 / 2x2 矩阵 / 对比列
- 禁止:默认蓝色堆砌(商务除外)、<14pt 正文、连续 3 页同布局
- 去 AI 味:避免「总而言之/综上所述」式连接词、三段式排比滥用、空洞形容词;标书文本用词简洁落地
需要画图时(吸收 diagram-builder)
- 流程图/架构图/疏散示意:用 show_widget 内联 SVG 或 Markdown Mermaid 代码块
- 适用于:消防疏散示意、功能分区图、审查流程框图、方案技术路线图
outline JSON 结构(citations 即「取证→引用」闭环)
{
"title": "xxx项目 设计说明",
"subtitle": "项目全称",
"meta": {"单位": "xxx", "专业": "建筑", "日期": "2026-08-31"},
"sections": [
{
"heading": "1 设计依据",
"level": 1,
"paragraphs": ["……"],
"bullets": ["……"],
"table": {"headers": ["条款", "内容"], "rows": [["……", "……"]]},
"citations": [{"source": "GB 55037-2022", "clause": "第3.2.1条", "page": "p12"}]
}
]
}
依赖与降级(按需安装,见 requirements-optional.txt)
| 环境 | 可用 | 缺失时 |
|---|---|---|
| python-docx / python-pptx | docx/ppt 生成 | 生成不可用(engine-info 显示纯Python ❌) |
| WPS / MS Office / LibreOffice | export 导出 PDF | 导出报 E010,其余功能正常 |
| pymupdf + rapidocr-onnxruntime | extract 文字层+扫描OCR | extract 不可用 / 扫描页跳过 |
- 环境探测顺序:WPS COM → MS Office COM → LibreOffice → 纯 Python(
engine-info可查) - 仅需生成 docx/pptx 的机器:
pip install python-docx python-pptx即可,导出 PDF 与 OCR 自动降级 - 发布前自检:
python scripts/smoke_test.py(engine-info→docx→ppt→check→export→extract→gongwen文种覆盖 全链路,15 项全过才发布)
v4.0.0 新增能力(文生图提示词引擎 + PPT 导演化)
- 文生图提示词引擎(
imgprompt):把结构化 brief 蒸馏成双语(EN/ZH)提示词 + 负向 + 多平台参数(即梦/纳米香蕉/Agnes/智谱),设计师写作同时即可产出配图与效果图提示词:
python scripts/wps_bridge.py imgprompt --input brief.json --output prompt.json - PPT 导演化(
ppt):14 种版面(封面/章节/内容/左文右图/图文混排/KPI/对比/时间轴/金句/大图/双栏/卡片网格/流程…)+ 叙事弧(--narrative按 act 字段插章节分隔页,形成钩子→张力→释放节奏)+--layout默认版面覆盖。详见references/05-产出与表达规范.md第七、八章:
python scripts/wps_bridge.py ppt --input o.json --output 汇报.pptx --size a3 --theme coral --narrative
约定
- 生成 docx/pptx 走纯 Python(python-docx/python-pptx,结果确定);导出 PDF 走 WPS COM(自动重试,降级 MS Office → LibreOffice)
- 所有处理本地完成,不联网、不上传
- 依赖:
pip install python-docx python-pptx(docx/pptx 必需);pymupdf rapidocr-onnxruntime(extract 需要);导出 PDF 需本机装 WPS 或 LibreOffice