井室钢筋与工程量 Skill（标准井 → 异形井 → 配筋校审）

1. 适用场景

两种模式最终都输出表1/表2/表3这三张固定命名的表（见 §7）。本技能不画 CAD 图。

1.1 模式决策速查（一眼入口）

收到需求先判模式，再走对应流程，避免跑偏：

• 要「把标准井放大成异形井、算钢筋量与工程量」→ 模式A 核算 → 走 §6
• 要「校核已经设计好的配筋是否合规」→ 模式B 校审 → 走 §4
• 输入不全（缺标准图 / 目标尺寸 / 设计值）→ 先按 §2 输入清单逐项追问，禁止臆造数字出表

两模式共用：输入清单 §2、输出三表 §7、红线 §8 与 §10。本技能不画 CAD 图。

1.2 流程地图（一眼总览）

无论哪种模式，骨架都是「判定模式 → 收齐输入 → 跑流程 → 出三表 → 查漏」：

• 模式A 核算：§1.1 判定 → §2 收输入(标准图+目标尺寸) → §6 确定性 SOP 放大配筋 → §7 出三表（经 review_rebar.py 渲染）→ §10 红线查漏。
• 模式B 校审：§1.1 判定 → §2 收输入(标准图+已设计配筋+现场条件) → §4 流程(含 §3 规则/§3.5 边界/§5 模板) → §7 出三表 → §8 免责。
• 共用底座：输入 §2、输出三表 §7、红线 §8 与 §10；本技能不画 CAD 图。

1.5 标准图根基（已入库，校审对照基准）

用户投喂的标准井设计图集（共 11 本 PDF），由助手用 fitz 提取文字层并沉淀为根基资料：
- 结构化参数表 → references/standard_wells.md（井型清单、统一技术条件、细部详图、校审对照用法）。
- 原始文字层 → references/standard_wells_raw.md（11 本 PDF 全文提取，可追溯）。

已入库井型（均为 2.0m×2.0m 现浇钢筋混凝土电缆井，适用覆土 0.7~4.0m）：直线 / 转角(0°–90°) / 90°直角转角 / 三通 / 四通 共 5 类（各含外形图+配筋图），另含井腔、集水坑详图。
统一基准：250mm 钢筋混凝土壁/板、100mm C15 垫层、3+3mm SBS 防水、50/70mm 细石砼保护层、顶φ800 井筒+底φ500 集水坑、铁件 Q235B 热镀锌。

> ✅ 配筋符号已补全：已视觉读取全部 5 类主井及集水坑 PNG 配筋图，精确配筋直径/间距（井壁/板 Φ14@150、分布筋 Φ12@150、拉结 Φ10@600、埋管洞口 Φ20 加筋、顶板洞口 12Φ14@50、集水坑 8/16Φ14@50 等）已回填 references/standard_wells.md 第四节。校审异形井时仍以规范阈值+现场条件为主，本根基图作"同类参考"。

1.5.1 引用规程规范清单（已下沉 → references/norms_cited.md）

完整清单（07SD101-8、22S521、DB11/T 963-2021、DB11/T 147-2015、DB11/T 2423-2025，共 5 项国标/地标，2026-07-22 联网核实可溯）已下沉至 references/norms_cited.md，校审时按需调阅。

> ⚠️ 红线：数值条款（如 963-2021 工作井抗震/防水等级、井盖承载力等级）出具正式校审时须调取原文 PDF 摘录，禁止臆造数值。

2. 输入清单

> 校审模式强烈建议用户填 review_input_template.json（见脚本目录）后投喂；若用户在对话里直接口述设计值，由助手把口述整理成 JSON 再跑 review_rebar.py，禁止凭记忆/空跑给"通过"结论（见 §10 红线）。

3. 校审规则（模式B 核心，必须内联）

> 口径：①~④为确定性规范阈值校审（高可信，直接比对代码）；⑤为现场条件驱动的强度校核（估算级，提示性，最终须设计院复核）。所有结论须附规范依据。

① 直径校审
- 依据 GB 55008-2021 / GB 50069-2002：受力主筋（板、墙）最小直径 ≥ 10 mm；分布筋 ≥ 8 mm；箍筋 ≥ 8 mm（构造）；洞口加强筋 ≥ 12 mm（20S515 / 07SD101-8 电缆井惯例）。
- d_prov ≥ d_min 判合规；否则 ❌ 标注"直径 X<最小 Y"。
- 现场条件敏感：覆土深/荷载大/水位高时，直径应按 ⑤ 强度校核结果取大值，不得仅卡最小值。

② 间距校审
- 依据 GB/T 50010-2010(2024) §9.2.1（板）：受力筋间距 ≤ min(200, 1.5h)（h=板厚）；§9.2.3（墙/分布筋）≤ 300；最小间距 ≥ max(d, 25)（§9.2.1）。
- s_min ≤ s_prov ≤ s_max 判合规；越界 ❌ 标注"间距 X>上限 Y 或 <下限 Z"。
- 间距同时受 ρ_min 控制（见 ④）：间距不得大到使 ρ < ρ_min。

③ 锚固长度校审
- 依据 GB/T 50010 §8.3.1：带肋钢筋基本锚固 lab = α·(fy/ft)·d，α=0.14；锚固 la = ζa·lab（ζa=1.0 基础）。HRB400/C30：ft=1.43 → la ≈ 35.25·d（取 35d）。
- 例：Φ10→352 / Φ12→423 / Φ14→493 / Φ16→563 / Φ20→704（mm）。
- 抗震：设防烈度 ≥7 时用 laE = ζaE·la（§11.1.7），ζaE：一/二级 1.15、三级 1.05、四级 1.0。
- La_prov（实际锚固/弯折长）≥ la(或 laE) 判合规；否则 ❌ 标注"锚固 X<要求 Y(la/laE)"。
- 弯折构造筋（口字框①、弯脚）按构造详图/标准图集取值，用户提供后方可比对。

④ 最小配筋率校审
- 依据 GB 50069-2002 §5.2.2 / GB/T 50010 §8.5.1：受弯构件 ρ_min = 0.20%（混凝土 ≤ C35，取严值）；井室常用 0.20%。
- 单层每米 As_prov = 1000·d / s（mm²/m）；ρ_prov = As_prov / (1000·t)（t=构件厚）。
- ρ_prov ≥ ρ_min 判合规；否则 ❌ 标注"ρ=X%<最小 Y%"。

⑤ 现场条件强度校核（GB 50009-2012 荷载组合，估算级，提示性）
- 按 GB 50009-2012 §3.2.3/§3.2.4 基本组合 S = γG·SGk + γQ1·SQ1k + ΣγQi·ψci·SQik 估算所需 As_req，与 As_prov 比较；分项系数：γG=1.2(永久,不利) / γQ活=1.4 / γQ水=1.27(不利)；土压取朗肯主动 Ka=tan²(45−φ/2)（φ 缺省 30°，可由 site.soil_phi 指定）。
- 井壁（水平向，取包络）：① 土压+活载 M1 = 1.2·(0.5·Ka·γ土·H²·H/3) + 1.4·(Ka·q地面·H·H/2)；② 土压+水压力 M2 = 1.2·(0.5·Ka·γ土·H²·H/3) + 1.27·(0.5·γw·hw²·hw/3)；取 M=max(M1,M2)。
- 顶板/底板（竖向，短跨 Ls，取包络）：① 向下 q_down = 1.2·(25·t + γ土·H覆) + 1.4·q地面，M_down=q_down·Ls²/10；② 底板抗浮 q_up = 1.27·γw·(H覆+H) − 1.0·(25·t+γ土·H覆)（>0 时）M_up=q_up·Ls²/10；取 M=max(M_down,M_up)。
- As_req = M·1e6/(0.9·fy·0.9·t)（per m，有效高度 0.9·t，GB/T 50010 受弯）。
- As_prov ≥ As_req → "现场条件(覆土Xm/荷载YkPa)下强度满足(GB50009组合, 估算, 待设计院复核)"；否则 ❌ "As_req=Z> As_prov, 不满足, 建议升级直径或加密间距"。

⑥ 保护层 / 材料等级
- 依据 GB 55008 / GB 50069：迎水面 ≥ 50 mm，背水面 ≥ 25 mm。井室混凝土 ≥ C30、抗渗 ≥ P6，钢筋 HRB400。不满足 → ❌。

3.5 边界条件与异常处置（防跑偏，模式A/B 通用）

• 输入缺失 / JSON 非法：若用户未给标准图或目标尺寸（如「帮我改个井的配筋」），立即按 §2 输入清单逐项追问，禁止臆造数字出表；review_rebar.py 读 JSON 失败会显式报错 exit≠0，技能应回读 stderr 提示用户补全 review_input_template.json 字段后再跑。
• 软弱地基 / 高地下水 / 邻近既有构筑物 / 复杂管线：必须提醒用户补充地质勘察与管线探测资料；此类情况校审结论的⑤强度项标注「待补勘，暂缓判定」，不得直接判合规。
• 几何参数非法：H≤0、t≤0、负壁厚等，脚本对该构件 compute_as_req 返回 None，结论标注「几何参数缺失，跳过强度校核」；直径/间距/锚固等确定性项仍照常校审。
• 水位字段单位：site.water_above_base_m 单位为米（正=高出底板、负=低于底板），非 mm；填错单位会导致强度校核失真（已修过的隐蔽坑，见 §10）。
• 抗震锚固：site.seismic ≥ 7 时自动触发 laE（一/二级 1.15、三级 1.05），结论标注 laE 而非 la；seismic=0/6 用 la。
• 超出图集适用范围：异形井尺寸/荷载超过 07SD101-8、20S515 适用范围（如覆土 >4 m、重型车辆 > 城-A 100 kN）时，必须标注「超出标准图集范围，需专项结构计算」，不得直接套用标准井配筋。

4. 校审流程（模式B，强制顺序）

0. 模式判定：依 §1.1 模式决策速查判定（放大算量/改尺寸→模式A 走 §6；校核已设计配筋→模式B 走本 §4）。两模式共用 §2 输入清单与 §7 输出三表，仅流程与结论口径不同。
1. 收料：标准井设计图 + 用户已设计配筋 + 现场条件清单。读图用 PyMuPDF 渲染 PNG（纯文本提取对 CAD 矢量图失效，见 §9）；DWG 需先转 DXF。
2. 整理 JSON：把用户设计值按 review_input_template.json 结构化为 bars[]（每根含 category=chamber/opening、member、location、d、spacing、La_prov、single_len、count、t、note）。
3. ⏸ 确认闸（必须暂停）：按以下模板复述并等待确认，不得带未确认数据下判：
   【现场条件确认】覆土 X m｜地面荷载 Y kPa｜水位高出底板 Z m｜抗震 N 度｜邻近既有构筑物：有/无｜地基承载 K kPa 【钢筋设计值确认】（逐根） 编号1 Φ16@150 La_prov=1880 …（共 M 根） 编号2 … 【材料/几何确认】C30/P6/HRB400｜井 L×W×H=…，壁厚/板厚=… 以上按此校审，确认或修正后继续？
   用户确认后再进第4步；若用户修正，回写 JSON 后重跑引擎。
4. 跑引擎：python review_rebar.py <设计.json> → 默认仅生成 *_校审三表.md（cat 出来即可整段贴进 CAD 图框查阅）；如需 docx/xlsx 另存再加 --docx。终端打印校审汇总（合规数/不合规数 + 不合规清单）。
5. 查漏（防虚假通过 / 防假更新）：脚本须实际运行（exit=0）且 重读生成的 md/xlsx 确认关键数字已落位、且与输入 JSON 一致、且相对上版确有变更（旧值消失、新值出现）；仅看脚本 print "成功/已更新" 不算（脚本可能写回原内容，如 Python 循环重赋值循环变量却未改原列表 → 假更新）；空跑/解析为空/数值未变更必须显式报错 exit≠0，绝不说"通过"。
6. 交付：三表 + 校审汇总 + 免责声明（§8）。

5. 校审输入模板（JSON 字段说明）

review_input_template.json 头部字段：

{
  "project": "项目名称",
  "site": { "cover_depth": 2.5, "ground_load_kPa": 10, "water_above_base_m": -1.0,
            "seismic": 0, "adjacent": false, "soil_bearing_kPa": 120, "soil_unit_weight": 18, "soil_phi": 30 },
  "materials": { "concrete": "C30", "impermeability": "P6", "steel": "HRB400",
                 "cover_water": 50, "cover_back": 25, "ft": 1.43, "fy": 360 },
  "well": { "L": 6000, "W": 3500, "H": 2500, "wall_t": 250, "slab_t": 250 },
  "bars": [
    { "no":"1", "name":"...", "category":"chamber", "member":"slab", "location":"water",
      "d":16, "spacing":150, "La_prov":1880, "single_len":6980, "count":86, "t":250, "note":"..." }
  ]
}

category=chamber → 表2；category=opening → 表3。member ∈ {slab,wall,stirrup,opening} 决定校审阈值。location ∈ {water,back} 决定保护层与锚固基准。

6. 核算流程（模式A，确定性 SOP；详细构造见 §10）

> 目标：把标准井放大成异形井，算出钢筋明细与工程量，产出与模式B同构的三表。输出必须经由 review_rebar.py 渲染并查漏，禁止手写出表（见 §10 单一数据源 / 防假通过红线）。如此模式A与模式B共用同一渲染与口径引擎，闭合两模式不对称。

1. 读图取基准：渲染标准井配筋图 PNG（§9 PDF 矢量化坑），逐根扒①~⑧原图基准：位置/直径/间距/单根长/简图段长/根数/实际锚固(弯折)长，汇入 bars[]（category=chamber）。
2. ⏸ 确认闸（必须暂停）：复述新尺寸（L×W×H、壁厚/板厚）、洞口（well.openings 位置/直径/数量）、集水坑（well.sump）、保护层厚度（well.c20_thk={top:70,bottom:50}）、几何口径（extL=L+2×壁厚 等），等用户确认。
3. 按 §10 放大原则算每根筋（须有实算依据，禁止无依据的直径升级映射）：
   - 直径放大：依 GB 50069/55008 实算，参照 §10「五金手册单重 / π=3.14」红线；
   - 根数：按异形井实际边长（周长/间距）重算，非简单乘系数；
   - 单根长：下料长 = 外尺寸 − 2×外保护(50) + 锚固；口字框①/弯脚构造见 §10，①上下弯脚交错(6980/6989)为大样非错误；
   - 重量：用硬编码 RHO（Φ10=0.617/Φ12=0.888/Φ14=1.21/Φ16=1.58/Φ20=2.47 kg/m），禁自算。
4. 洞口加筋：长边/顶板洞口按 §10 洞口加强筋规则生成 bars[]（category=opening）；集水坑同处理。
5. 组装输入并跑引擎出三表：按 review_input_template.json 的字段结构组装 <核算.json>（project/site/materials/well/bars[]；openings/sump/c20_thk 必须放入 well 对象内，见 §9 引擎参数层级坑），再 python review_rebar.py <核算.json> → 生成 *_校审三表.md；表1 工程量按 §7 口径自动算（混凝土扣洞、SBS/挤塑板用外周长、C20细石按面积×厚度算体积）。核算与校审共用同一输入 schema 与渲染引擎，模式A 因此与模式B 同样可一键复现。
6. ⏸ 防假通过查漏（关键）：确认真实运行 exit=0 且 重读生成的 md/xlsx 后 grep 表1 关键数字（混凝土/SBS/挤塑板/C20细石）与 表3 count（洞口加强筋须为全井总量，见 §10 计数口径红线）已落位、并相对上版确有变更（旧值消失、新值出现）；组装的 bars[] 同时过 校审阈值（直径/间距/锚固/ρ_min，见 §3），不合规须标 ❌。结论列填「估算级，待设计院复核」。空跑/解析为空/数值未变更须显式报错 exit≠0，绝不说"通过"（禁止只信脚本 print 的"已更新"提示——可能写回原内容，属假更新）。

7. 输出三表（统一表头，模式A/B 共用）

表1 总工作量明细表（汇总级，含校审总结论）
| 项目 | 单位 | 数量 | 备注/校审总结论 |

> 表1 工程量计算口径（须与 review_rebar.py build_md 同步；任何改动须重跑脚本核对输出，禁虚假通过）：
> - 混凝土 = 底板(extL×extW×slab_t) + 墙(mid_perim×H×wall_t) + 顶板(extL×extW×slab_t)；扣人孔/集水坑洞（well.openings / well.sump，按 π=3.14 洞面积×板厚）。mid_perim=2(L+wt)+2(W+wt)。
> - SBS 防水 = 侧墙外表面(外周长 2×(extL+extW)×H) + 顶板(extL×extW，扣人孔) + 底板底(extL×extW)。
> - 挤塑板 = 侧墙外一圈 = 外周长 2×(extL+extW)×H（外表面用外周长，非中线周长）。
> - C20细石砼保护层 = 顶板面积×70mm + 底板面积×50mm（面积×厚度=体积 m³；顶板扣人孔、底板扣集水坑）。厚度由 well.c20_thk={top:70,bottom:50} 控制。
> - 外表面类（防水/保温/饰面）一律用外周长；混凝土墙体积用中线周长（外周长会高估体积）。
> - openings / sump / c20_thk 必须写在 well 对象内（引擎读 data["well"]），放 JSON 顶层静默无效。

表2 井室钢筋明细工作量（category=chamber）
| 编号 | 钢筋名称 | 位置 | 直径 | 间距 | 单根长(mm) | 简图(段长) | 根数 | 总长(m) | 重量(kg) | 校审结论 |

表3 洞口加强筋明细工作量（category=opening）
| 编号 | 钢筋名称 | 位置 | 直径 | 间距 | 单根长(mm) | 简图(段长) | 根数 | 总长(m) | 重量(kg) | 校审结论 |

> 校审结论列写法：✅直径/间距/锚固合规（GB 50010 §9.2.1/§8.3.1） 或 ❌间距300>200 不满足 §9.2.1，建议≤200｜现场(覆土2.5m)As_req=813≤As_prov=1026 强度满足(估算)。
> 钢筋理论重量（kg/m，五金手册权威值，禁止自算）：Φ10=0.617 / Φ12=0.888 / Φ14=1.21 / Φ16=1.58 / Φ20=2.47 / Φ22=2.98 / Φ25=3.85。π 一律取 3.14。

8. 红线与免责（必须写入交付物）

1. 本技能输出为估算级设计辅助量/校审提示，非施工图、非设计院正式计算书。
2. 校审结论中⑤强度校核与全部直径/间距/锚固取值，最终必须由具资质设计院按实际荷载、覆土、水位、抗震复核后出图确认。
3. 不画 CAD 图。
4. 引用规范与图集：
   - 通用规范：GB 55008-2021、GB 50009-2012、GB/T 50010-2010(2024版)、GB 50069-2002、GB 50007-2011。
   - 国标图集：07SD101-8《电力电缆井设计与安装》（电缆井专用）、20S515/02S515《钢筋混凝土及砖砌排水检查井》（排水/阀门井分支）、22S521《预制混凝土模块式检查井》、GB/T 23858-2009《检查井盖》。
   - 北京市地标（DB11）：DB11/T 963-2021《电力管道建设技术规范》、DB11/T 147-2015《检查井盖结构、安全技术规范》、DB11/T 2423-2025《城市道路挖掘与修复技术规范》。

9. 已知坑

• PDF 文本提取失效：CAD 矢量图 page.get_text() 只拿散乱数字，必须 page.get_pixmap(matrix=fitz.Matrix(2.5,2.5)) 渲染 PNG 读图。
• DWG 无转换器：本机无 CAD 转换器，DWG 请用户手动转 DXF。
• docx-formatter 是小说专用：技术表格必须 python-docx 自写（md_to_docx_xlsx.py）。
• PyMuPDF 路径：Windows 下用 r"C:\..." 绝对路径。
• 引擎参数层级坑：review_rebar.py 读 well = data.get("well")，故 openings / sump / c20_thk 必须放进 well 对象内；放 JSON 顶层会静默不生效（本会话首版即因此未扣洞，靠查输出才发现）。

10. 核心教训与红线（2026-07-21 多轮返工沉淀，必读；🔴通用 = 模式A/B 共用，[模式A] = 仅核算模式A 专用构造）

• 🔴 禁止虚假通过（最高优先级）：任何"校验通过/合规"结论，必须实际运行脚本 + grep 交付文件证明值真生成；不得凭记忆声称。口径：先跑生成器（确认 exit=0），再 grep 目标文件确认关键数字/结论出现；解析为空/未落位必须显式报错 exit≠0，绝不返回"成功"。
• 🔴 改技能须落到引擎并验证（虚假通过同源）：修改本技能计算逻辑，必须把改动写进 review_rebar.py 并重新运行取真实输出核对；仅更新 SKILL.md/references 文档、或仅"声明已修"而引擎未动，均视为虚假通过（前轮曾因此留下 C20=52.00m² 的错示例，shipped 示例与引擎产出不一致）。
• [表1] 周长口径：外表面工程量（挤塑板 / SBS 外墙）用外周长 2×(extL+extW)；混凝土墙体积用中线周长 mid_perim。二者不可混用。
• 🔴 [表3] 洞口加强筋计数口径（全井总量 = 单洞口 × 洞口数）：category=opening 的每根筋 count 必须为全井总量，不是单洞口数量。顶板洞口（人孔）有 N 个 → ×N；埋管洞口有 M 个 → ×M。常见错误：只填了单洞口数量（如把 2 人孔+2 埋管洞口误填成单洞口 20/12/2/5/5）。组装 bars[] 时务必按 well.openings / well.sump 的实际个数乘开；重跑引擎后重读 md/xlsx 核对 表3 各 count 确为全井总量（旧值复核：13=40/14=24/15=4/16=16/17=16/18=88 对应 2 人孔+2 埋管洞口）。
• 单一数据源：表1/2/3 数值由 review_rebar.py 统一计算并写 md；下游 docx/xlsx 只消费不复算。
• 五金手册单重红线：Φ10=0.617/Φ12=0.888/Φ14=1.21/Φ16=1.58/Φ20=2.47 kg/m，硬编码 RHO，禁止 0.00617d² 自算或手填重量。
• π=3.14：含圆（人孔φ800/集水坑φ600）面积体积一律 π=3.14，勿用 math.pi 以免第3~4位偏差被判定敷衍。
• [模式A] 口字框构造（最高优先级）：与①外圈绑扎的内侧筋（②/③/⑧/⑩，竖向⑨/⑪两端加长绑①）主体仍位于内侧（保护25），仅两端加长弯折绑扎到外侧①口字框，墙-板夹角形成连续"口"字——故⑩=⑧、⑪=⑨ 等长属正确构造，非重合/零净距隐患。禁止提示"内外层重合(净距0)须(A)单排(B)回退内尺寸二选一"。①号上下弯脚交错（上6980/下6989）是设计大样非错误。下料长一律按 外尺寸−2×外保护(50)+锚固。
• [模式A] 同笼异径合规：②=Φ16(板短跨)/③=Φ12(墙竖向) 异径合规，保持即可，禁止提示"需同径"（理由：板/墙两独立构件钢筋，受力差近量级，ρ_min/间距/锚固/裂缝/保护层六项均满足规范）。
• 统一2位小数：所有数值（工程量、钢筋长/重、校审差值）一律 :.2f。
• 估算级免责：交付物须含 §8 免责声明。
• ASCII 引号嵌 f-string 坑：修复/生成脚本中中文短语勿用 ASCII 直引号包进 f-string，用 \u201c/\u201d 或 Python 显式写入。
• [模式A] 护层取位：迎水面/与①外圈绑扎外层筋用 50；真正背水面筋用 25。误把背水面筋按 50 算会每根偏短。