万工-建筑设计资料集

⚠️ 使用边界与责任声明

本 skill 是设计辅助工具，不是设计责任主体。所有输出：

1. 必须经注册建筑师/注册工程师人工审核后方可作为设计依据；
2. 涉及强制性条文、结构安全、消防安全的结论，必须回原文（verify.py 取证）并经专业签字人确认；
3. 数值/条文号可能因版本更新失效，使用前须核对现行有效版本；
4. 本 skill 不承担因使用其输出导致的任何工程责任。

一句话：AI 提供线索，人做最终判断，签字人担最终责任。

一套建筑设计参考资料的查证操作系统，不是资料摘要。

第一性原理：不背数据

《建筑设计资料集》是数据表 + 图示的"做法字典"，不是规范。凭记忆复述尺寸、指标就是错误源头。本 skill 不复制任何具体尺寸、面积、模数、间距数字。它只做三件事：

路由 → 取证 → 引用

1. 路由：把用户的查询定位到「哪一分册的哪个章节，PDF 第几页」
2. 取证：用 scripts/verify.py 从源 PDF 抽取原文（文字层直抽；扫描件自动 OCR 指定页）
3. 引用：输出必须带 分册名 + PDF 页码 + 原文/图示摘录，并说明"精确数值以原书页面对照为准"

任何一次给出具体数值/做法之前，必须已经跑过取证或明确指向可打开的页码。 这是本 skill 的绝对红线。

角色身份（岗位型）

语料与分册路由总览

源目录：由环境变量 WANGOING_ZILIAOJI_SRC 指定（未设置时默认回退到本 skill 内 corpus/ 目录）；其下含两批书：方案设计资料 与 建筑设计资料集（第三版）1-8全套
> 换机 / 换人使用：把语料放到任意目录，设置环境变量 WANGOING_ZILIAOJI_SRC 指向该父目录即可，verify.py 自动读取，无需改代码。
> 离线/在线分界：list / route / toc 仅依赖内置索引 _codes.json，可离线使用；get / search 需语料 PDF 就位（默认读上方源目录，或用 WANGOING_ZILIAOJI_SRC 指向你的语料）。

建筑空间组合论（彭一刚 第三版）        理论：体量/群体/内部空间/外部体形/形式美法则
建筑设计资料集 第1分册 建筑总论         术语/模数/气象/无障碍/防火/节能/色彩/制图
建筑设计资料集 第2分册 居住             住宅/住区/低层/多层/高层/宿舍/老龄化
建筑设计资料集 第3分册                  办公·金融·司法·广电·邮政（源自书内标题）
建筑设计资料集 第4分册                  教科·文化·宗教·博览·观演（幼儿园/学校/图书馆/博物馆/剧场/宗教建筑）
建筑设计资料集 第5分册                  休闲娱乐·餐饮·旅馆·商业（影剧院/餐饮/旅馆/商业）
建筑设计资料集 第6分册 体育·医疗·福利    场馆/医院/疗养/福利院
建筑设计资料集 第7分册 交通·物流·工业·市政
建筑设计资料集 第8分册 建筑专题          防灾/绿色建筑/太阳能/既有建筑改造/地下/农村

> 各分册的精确主题与章节以 verify.py toc <分册> 与 references/01-路由表.md 为准；上述主题为路由提示，具体条目随目录而定。

页码说明：所有页码均为 PDF 页码（与 PDF 阅读器显示一致）。资料集正文前有封面/版权/前言/目录若干页，印刷页 = PDF页 − offset（各分册 offset 见 _codes.json，约 +11~+12）。get/route/toc 输出的都是可直接打开的 PDF 页码。

工作流

W1 路由（先定位，再取证）

拿到"想查什么"，先用路由命中分册与章节：

python scripts/verify.py route "住宅 楼梯间"
python scripts/verify.py route "医院 候诊"
python scripts/verify.py route "车库 坡道"

路由不到时，换更具体的词，或 verify.py toc <分册> 浏览该分册全部章节。

W2 取证（抽原文 / OCR）

python scripts/verify.py get "第2分册" 108          # 抽 PDF p108（文字层，毫秒级）
python scripts/verify.py get "第1分册" 200 --ocr      # 扫描件自动 OCR

W3 引用（带页码输出）

输出结论时，凡涉及具体做法/尺度，必须给出分册名 + PDF 页码 + 原文/图示摘录，并提示"精确数值以原书页面对照为准"。

W4 规划条件与指标（设计交付链路 · 见 references/07）

当用户要做方案/投标/汇报，先走「规划条件录入 → 指标表 → 规范核查 → 表达适配」：

# ① 规划条件逐项录入（漏项追问，不臆造）——见 07 §1 录入卡
# ② 指标合法性回查（住宅专项 / 强条）
python scripts/verify.py route "容积率 上限"
# ③ 表达适配：--scenario 映射到 wps_bridge 的 --style/--theme（见 07 §4，不改代码）
python scripts/wps_bridge.py ppt --input o.json --output 汇报.pptx --size a3 --theme premium --narrative

指标须带 value + limit；规划条件为上限，不得"优化"突破；场景映射纯约定（07 §4）。

W5 排版方法论（决策层 · 见 references/08）

排版前先走决策，再调引擎——不替用户定调性：

# ① 三步决策：框架(投标/概念/品牌) → 页面类型+布局 → 色彩体系（见 08 §1-§3，用 AskUserQuestion 固化）
# ② Z0-Z3 文档结构组织 outline JSON（概念/展开/落地分层，见 08 §2）
# ③ 落地：决策 → wps_bridge --style/--theme/--narrative（引擎参数见下方模块，已冻结不重述）
python scripts/wps_bridge.py ppt --input o.json --output 汇报.pptx --size a3 --theme premium --narrative

纪律：留白占位页（平面/模型）只给章节标题不伪造图；不出现第三方公司名（用项目名替代）；一页一主题。

取证操作

命令

# 1) 列出全部 9 本书：分册 | 页数 | 主题域 | 文字层/扫描件
python scripts/verify.py list

# 2) 按主题路由：该查哪一分册哪一页
python scripts/verify.py route "高层住宅核心筒"

# 3) 取原文：分册(或ID/名关键字) + PDF 起页 [止页]
python scripts/verify.py get "第2分册" 108
python scripts/verify.py get "第1分册" 200 205 --ocr

# 4) 全文关键词检索（限有文字层的 4 本分册 + 空间组合论）
python scripts/verify.py search "楼梯井"

# 5) 单本书的章节目录（含 PDF 页码）
python scripts/verify.py toc "第3分册"

Python 解释器：需 Python 3.10+ 并已安装 pymupdf 与 rapidocr-onnxruntime（建议建独立 venv 后运行）；以 python scripts/verify.py ... 调用即可

文字层 vs 扫描件

9 本中 4 本有文字层可直接抽（第2/3/7/8 分册，毫秒级），5 本为扫描件需 OCR（空间组合论、第1/4/5/6 分册，约 2-4 秒/页）。verify.py get 自动判断；扫描件首次 OCR 结果不缓存（每次实时），第二次起仍走 OCR。

输出规范

引用格式（必须）

> 建筑设计资料集 第2分册 居住（第三版）
> 「（摘录该页关于住宅楼梯间的做法/数据表要点）」
> —— 源：建筑设计资料集 第2分册 居住（第三版）.pdf 第 108 页（PDF 页码）
> 注：精确尺寸/指标以原书页面对照为准

引用《建筑空间组合论》时注明其理论属性：

> 建筑空间组合论（彭一刚 第三版）第 X 章
> 「（摘录空间组合的理论要点）」
> —— 源：_BK0002[建筑空间组合论].pdf 第 X 页

禁止：只给做法/数字不给出处；只给分册名不给页码；用"我记得""一般做法""通常是"搪塞；把资料集的尺寸当作强制性规范数值用在消防/结构安全判定上。

条文强制力识别（蒸馏自 code-to-skill · 方法论重写）

> 来源：蒸馏自 code-to-skill v1.0.5 @user_1745aec9（该源无 license 字段，按无license纪律——仅吸收通用语言学标注规则，非原文摘录、不复制其代码）。本段为方法论重写，供本 skill 在引用外部规范/标准条文时统一标注其强制力等级，避免把"推荐"误当"强制"或反之。

引用任何规范、标准、图集条文时，先按条文的助动词判定其强制力等级，再对外输出：

使用纪律：
1. 输出引用外部条文时，强制力等级须随条文一起给出（如「GB 50016 第 5.5.17 条：疏散门应（Shall）向疏散方向开启」）。
2. 本 skill 自身的结论（资料集做法/尺度参考）不套用上表——资料集是做法字典，不是规范，没有强制力等级。
3. 强制力等级以条文原文助动词为准，不以"重要性"判定；条文废止/版本更新导致等级变化的，标【待核项】回现行有效版本核对。
4. 与上节"禁区"一致：不得把资料集某页做法说成"规范强制要求"。

边界与禁区

该做
- 查证并引用具体分册页码与原文/图示
- 指出某做法出自哪一册、哪一页，便于复核
- 提示"精确数值以原书页面对照为准"
- 标记信息不足、需用户补充的输入（如具体户型、层数）

不该做
- ❌ 凭记忆给任何尺寸/面积/模数/间距。没路由+取证就不能给具体做法数字
- ❌ 用"大概""一般""通常是"搪塞
- ❌ 把资料集的尺寸当消防/结构安全的强条判据（强条走 GB 50016 / GB 55037 / 专业规范 / 万工-消防设计 skill）
- ❌ 做施工详图深化与结构计算书
- ❌ 把"资料集某页做法"说成"规范强制要求"

能力边界声明：本 skill 是设计参考资料索引，不覆盖消防/结构/给排水/电气的法定强条判据，也不覆盖地方性法规（项目所在地地方性法规需另行核对）、软件模拟与计算。

与「万工-消防设计」「万工-住宅标准化设计」的挂钩

• 当查询落到住宅强条/消防判定：指向「万工-消防设计」skill（GB 55037 / GB 50016 / 图集）。
• 当查询落到住宅企业落地做法（非强条经验）：指向「万工-住宅标准化设计」skill。
• 本 skill 负责"一般做法/尺度参考"，三者互为引用、互不替代。

参考文件

配套知识库（Knowledge 轨）

与 skill 同源：skill 负责可执行路由+取证，知识卡片负责检索/比对/进化。_codes.json 的每条都标注分册、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 深度兼容。

典型链路

1. 路由取证：python scripts/verify.py route "住宅 楼梯间" --top 5 && python scripts/verify.py get 第2分册 108
2. 组装 outline JSON（结构见下），AI 依据取证结果填充（引用必须带 source/clause/page，不臆造）
3. 产出 + 自检：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）

页脚自动右下角页码；标题居中；表格蓝头白字；引用灰字注（来源+条款+页码）。字体缺失时 WPS 自动替换显示，可改系统字体名。

PPT 主题配色（--theme，8 套）

--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）

• 环境探测顺序：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 全链路，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