平法算量 Pro（结构图纸 → 混凝土 + 钢筋工程量 · 付费技能）

定位：估算 / 复核级（混凝土 ±3%、钢筋 ±8~12%）。用途是交叉复核广联达 GTJ 报量，不可替代结算级报量——交付时必须写明这一点。

已验证案例（学府雅苑二标段，四个独立算例量级互印证）：A1#（2417 m³ / 240.2 t / 99.4 kg/m³）、A3#（2568.5 / 270.35 / 105.3）、A5#（2808.1 / 288.33 / 102.7）、A6#（3031.6 / 315.69 / 104.1）。可作为新项目的合理性标尺（剪力墙住宅含钢量合理区间 95~115 kg/m³，约 38~44 kg/m²）。

-1. 第 −1 步：环境与路径自查（先于门禁，恰好一次）

python3 --version || python --version     # 需要 Python ≥ 3.8（支付内核纯标准库）

• 路径基准：本技能所有脚本路径一律相对技能根目录（SKILL.md 所在目录），不是当前工作目录。算量脚本另有 TAKE_BASE 环境变量指定工程目录（见 §1），两者不要混淆。
• 解释器自查恰好一次：有解释器 → 继续走门禁；算量依赖（ezdxf/Pillow/openpyxl）缺失按 §0 补装，依赖缺失不能成为跳过交付的理由。
• 没有解释器 / 终端不可用（部分平台沙箱不提供 Python）→ 立即停止，向用户如实输出一句话环境说明（「本技能需要 Python ≥3.8，当前环境不可用」）并结束任务。禁止换工具名重试、禁止硬凑结果。
• 可以先跑 python scripts/30_takeoff.py --demo 看免费演示输出（内置样例数据，不计费）。

付费门禁在受限环境的预期行为：支付未配置的环境（平台沙箱预览、离线审阅等）里，门禁返回退出码 4（环境/配置缺失）——这是预期结果，输出「付费技能，需先完成购买或配置」的说明即止，不要把 4 当成 bug 修，也不要反复重试、更不要绕过。

0. 付费门禁：支付宝 AI 按量付费（A2M / HTTP 402 · PAYSKILL 契约，先于一切算量动作）

> 本技能为 Pay Skill，按次付费（¥19.90/栋起，支付宝 AI 按量付费）。任何真实图纸算量动作之前，必须先过付费门禁。 未付费时云端计费服务返回 HTTP 402 并通过 Payment-Needed 响应头下发账单；只有完成支付、携带凭证（Payment-Proof）重试并通过服务端验付调用后，才能取得算量授权。未授权就跑主算量等于白送，且无法事后追补。

计费口径：billing = per_use（纯按次），1 次 = 1 栋楼完整算量任务；额度自购买起 365 天有效，按未用次数可退。档位以 payments/catalog.py 为唯一真值，payments/cli.py catalog 可实时打印：

> 订阅制 SKU（pingfa.takeoff.pro_monthly）已预留但 enabled: False，不对外暴露。
> 免费体验：python scripts/30_takeoff.py --demo（内置样例，不计费）。

两条门禁路径（按部署模式二选一）：

# ① 干活前：校验授权并预占 1 次额度
python payments/cli.py gate --task-id "<任务ID>"
# ② 干活（跑 30_takeoff.py / 31_report.py）
# ③ 干完：成功扣次（默认）；失败归还（加 --fail）
python payments/cli.py settle --hold "<①返回的 hold_id>"
python payments/cli.py settle --hold "<①返回的 hold_id>" --fail

A2M 四步链路（probe → pay → complete → ack，不可省略颠倒）：

# ① probe —— 请求业务资源接口。未付费 → 服务端返回 HTTP 402，Payment-Needed 账单头
#    与原始请求自动落地状态目录（订单持久化，POSIX 下 0600 权限）
python scripts/payment_gate.py probe --url "$PINGFA_PAY_RESOURCE_URL" --intent "楼栋平法算量"   
#    → 退出码 0：已授权，进入算量流程；退出码 3：需要付费，账单已落地，走 ②

# ② pay —— 把 402 账单交给支付宝官方 CLI（alipay-bot 402-buyer-pay），向用户展示
#    用途与金额，等待扫码授权。脚本只做编排：不接触支付密钥，不自行实现付款或签名
python scripts/payment_gate.py pay --state-dir .state/pingfa-takeoff

# ③ complete —— 先查单（402-query-payment-status，状态不明先查原订单，不重复付款），
#    再携带 Payment-Proof 重试原始请求（参数保持一致）；服务端验付（验证凭证与订单，
#    无效或过期不交付）后返回资源，结果落地 result.json
python scripts/payment_gate.py complete --state-dir .state/pingfa-takeoff

# ④ ack —— 履约确认：服务端返回资源后发送履约回执（失败可重试）；买家侧回执由官方 CLI
#    取得非空资源后自动发送。成功路径不需要（也不要）再单独调用回执、重发付款或资源请求

local 模式退出码分流表（按退出码分支，不要靠猜）：

三条硬约束（平台自查项，必须遵守）：

1. 先门禁后干活：不许"先干完再补授权"。
2. 一次任务一次结算：30_takeoff.py 已内置 atexit 结算——正常结束自动扣次，中途异常自动归还预占；手工模式必须 settle --hold <hold_id>（成功默认）/ settle --hold <hold_id> --fail（失败归还），否则额度被预占到 TTL 到期，且预占中的额度同样不可退款。
3. 配置缺失 ≠ 免费：退出码 4 是让你去配置，不是让你跳过门禁。

订单持久化与幂等（平台自查项）：

1. 同一订单重试不会重新扣费：complete 遇 result.json 直接透传（幂等命中），不重复付款、不重复请求。
2. 状态不明先查原订单：支付结果不确定时用查单命令确认，不重复下单、不追加回执。
3. 原始请求与账单随订单持久化：probe 把请求参数与 402 账单写入状态目录（request.json / payment_needed.txt，0600），支付后复用同一订单——凭证重试时请求参数保持一致，否则验付不通过。

支付依赖包（两个包用途不同，勿混）：

配置与排查：PINGFA_PAY_RESOURCE_URL 指向云端计费服务的资源接口。作者侧服务端实现（402 账单签发与 RSA2 加签、Payment-Proof 验收、验付调用、履约确认、订单去重与幂等）见 payments/ 内核与 references/payment-integration.md。常用排查命令：

python payments/cli.py doctor                      # 体检支付配置与密钥，列出全部阻断项
python payments/cli.py status                      # 查看余额（可用 / 预占 / 已用）
python payments/cli.py refund-quote <订单号>        # 退款试算：只报价，不动钱

> 别把「无变更」当成功：结算接口在重复结算时返回「未发生变更」而不是「已扣次」，看到这句说明本次没有扣次，不要向用户汇报成已扣费。
> 作者本机自用：设环境变量 PINGFA_PAY_OFFLINE=1 显式跳过门禁（分发版本默认拒绝放行，绝不"没配就免费"）。

0b. 算量环境依赖

pip install ezdxf Pillow openpyxl

• ODA File Converter（必装，DWG→DXF 的唯一可靠途径）：默认路径
  C:\Program Files\ODA\ODAFileConverter 27.1.0\ODAFileConverter.exe
  （版本号可变，脚本里 odafc.win_exec_path 指向实际路径。）
• Python 解释器（★必须用 venv，managed 3.13.12 不带依赖）：
  C:/Users/T/.workbuddy/binaries/python/envs/default/Scripts/python.exe
  已装 ezdxf 1.4.4 / Pillow 12.3.0 / openpyxl 3.1.5。
  ⚠️ 本机 managed 版 .../versions/3.13.12/python.exe 没有 ezdxf/PIL，误用会 ModuleNotFoundError。
  若 venv 缺失依赖：envs/default/Scripts/pip.exe install ezdxf Pillow openpyxl。

1. 工作目录约定

每个楼栋建一个独立目录，脚本从 TAKE_BASE 环境变量或当前目录解析 BASE：

<楼栋>_takeoff/
  in/            # 原始 DWG（从图纸目录拷入）
  dxf/           # 转换后的 a3_1.dxf ... （命名随意，脚本 glob *.dxf）
  sheets.json    # 图纸索引（uid/no/name/win/src）
  sheets_text/   # <uid>_<图名>.txt  按图切分的文字
  geom/          # <uid>.tsv  按图展开的线/多段线
  proj.json      # ★本楼参数（图层名、楼层表、墙身表、板筋口径）
  *.json         # 中间结果 wallcol_area / edge_members / beams_all / area_*
  takeoff_result.json
  <楼栋>楼混凝土及钢筋工程量估算表.xlsx
  <楼栋>楼工程量计算说明.md

开始前先建目录、拷 DWG 进 in/、写 proj.json。

2. 执行顺序（严格按序，脚本在 scripts/）

统一调用方式（示例）：

export TAKE_BASE="D:/WorkBuddy/技术管理/output/a3_takeoff"
PY="C:/Users/T/.workbuddy/binaries/python/envs/default/Scripts/python.exe"   # ★含 ezdxf/PIL/openpyxl
cd "$TAKE_BASE"
"$PY" <skill>/scripts/00_convert.py
"$PY" <skill>/scripts/05_layers.py
"$PY" <skill>/scripts/10_sheets.py
"$PY" <skill>/scripts/12_sheet_text.py
"$PY" <skill>/scripts/13_geom.py
"$PY" <skill>/scripts/09_fixsym.py
"$PY" <skill>/scripts/20_wallcol.py
for s in 结施-22 结施-24 结施-26 结施-28 结施-30 结施-35 结施-37; do "$PY" <skill>/scripts/21_slab.py "$s"; done
"$PY" <skill>/scripts/24_edges.py
"$PY" <skill>/scripts/25_beams.py 结施-23 结施-25 结施-27 结施-29 结施-31 结施-32 结施-33 结施-34 结施-36 结施-38
"$PY" <skill>/scripts/30_takeoff.py
"$PY" <skill>/scripts/31_report.py

3. 换楼必做的三件事（换项目最大工作量）

因为图层体系、楼层表位置、配筋口径每个项目都不同，换楼不能直接跑：

3.1 重新探测图层（步 2）

A1# 用 BEAM/COLU_TH/砼墙；A3#（探索者）用 梁/梁虚线/WCOL/砼柱/DWCOL；A6#（工大）用 梁/梁虚线/砼墙/WCOL/砼柱/COLU_LC。没有通用图层名，且同一设计院不同楼栋也可能变。把探测结果填进 proj.json：

{
  "layers": {
    "wall": ["砼墙","外墙水池墙","WCOL"],
    "col":  ["砼柱","DWCOL","COLU_LC","COLU_HATCH","构造柱","COLUMN"],
    "beam": ["梁","梁虚线","BEAM_梁实线_S","砼梁","BEAM"],
    "slab_neg": ["楼板负筋钢筋"]
  },
  "exclude_kw": ["大样","拆分","装配式","节点详图","内隔墙","楼梯详图","专项说明","墙身详图"],
  "no_prefix": ["结施","建施","结总","结构"]
}

> ⚠️ 必须排除"墙身详图"：大样类图纸比例 0.25、窗口互相重叠，会触发重叠告警并污染统计。
> ⚠️ 图层可能只存在于块参照内部：05_layers.py 已展开 INSERT 虚拟实体计数（实测某楼 梁 图层顶层仅 3 个 TEXT，真正的梁线全在块内）。若只看顶层会误判"该图层无几何"。
> ⚠️ wall 图层宁少勿多：只填"砼墙/WCOL/WALL"这类填充多段线图层。不要填 CURTWALL（幕墙）、wall（纯墙线图层，全是 LINE，20_wallcol.py 会把每条线按 20mm 宽刷成面积而虚增截面）。A6# 配置就是正确范本：["砼墙","WCOL","WALL"]。

10_sheets.py 的 EXCLUDE_KW / 图号前缀、12_sheet_text.py 的窗口归属都读这里。

3.2 重建楼层表（步 11 的 FLOORS）

★ 关键陷阱：混凝土强度等级的"楼层表"不在结构总说明，而是嵌在各张板配筋图的右侧表格里（列：结构标高 / 层高 / 墙柱砼等级 / 梁板砼等级）。总说明只写"混凝土强度等级详楼层表"。

定位方法（见 references/param_templates.md 的现成脚本片段）：

在某张板配筋图文字里找 "墙、柱砼" 标签 → 取其左侧"层高/标高"列、右侧"墙柱砼""梁板砼"列，
按 y 坐标归一化（round(y/100)*100）后三列对齐输出。

A3# 实测结果：墙柱 地下二层~2 层 C40、3、4 层 C35、5 层~机房层 C30；梁板全楼 C30。
⚠️ 极易错：4 层常被误判为 C30（实为 C35）；层高表"层高"列可能与标高一栏行错位，用标高差反算核对。

3.3 重新抄配筋口径

• 剪力墙身配筋表（Q1）按区段，在各段墙柱平面图内（不在总说明）。每段一行：墙厚 / 水平筋 / 竖向筋 / 拉筋。→ 填 WALL_SPEC。
• 板底筋回源图注（"图中未注明板厚/底筋为…"），逐张板图抄。→ 填 SLAB_BOTTOM + FLOORS 的板厚列。
• 暗柱/边缘构件配筋表独立成图（图名含"暗柱"），每段一张。

4. 关键算法与陷阱清单（血泪教训，务必逐条对照）

单位与坐标

1. 1 图面单位 = 1 mm（需首张图验证：如图框宽 ≈ 420×? 或量一段已知标注）。所有长度除以 1000 转 m。
2. 图框块参照的窗口 win = 插入点 + 块内 extents × scale；文字/几何按中心点落在 win ± 500 内归属该图。
3. 同图号多张图（如同一"结施-12"含 一层平面 + 2~3层平面）→ 生成 uid = 图号_序号（按 y 降序）。窗口重叠自检必须"无重叠"。

楼层与板位约定（★ 决定"哪一层算哪张板图"）

3a. "N 层结构平面布置及板配筋图" = 位于该层底标高的板（即 N-1 层的顶板 / N 层的楼板）。因此 story N ← 结施-N 的板图，每层的板落在该层底标高，全楼恰好各计一次，且不重复。
3b. 推论：地下一层通常没有独立板图（其底板是筏板，属基础；其顶板就是"一层结构平面"那张板，已计入 1 层）。A6# 就是这种情况——地下一层只计墙柱、不另计板。若项目有"夹层结构平面布置及板配筋图"（如 A3#），则地下一层另计一张夹层板。
3c. 同理 "N 层梁配筋图" = 位于该层底标高的梁系，与板图配对一致。
3d. 施工图常把多层合并成一张：如"四至十七层结构平面布置及板配筋图"（A6#）需按 14 个楼层分别计取同户型面积；"四至六层/七至九层梁配筋图"同理组内共用。

符号与文字

4. 钢筋符号两套编码并存：天正字体私有区 U+E530~E534 与文本码 %%130~%%133，都代表 Φ。必须先规范化，否则 4Φ25+12Φ20+6Φ14 会被读成 4?.25… 甚至整串丢失。
5. \P 换行、{...} 格式码、\A1; 类控制码需清理。残留 \u0084/\u0090/\u0091 也删掉。
6. 长钢筋串首字符 x 会偏出：暗柱纵筋串（如 4Φ25+12Φ20+6Φ14(空心)）首字符 x 可能距构件代号 1000+ px。→ DX_TOL 必须 ≥1500（900 会漏读，A3# 曾因此整体丢 YBZ11）。

混凝土

7. 墙柱：以墙+柱图层填充多段线做栅格并集（不是各构件截面相加，否则重叠区重复计）。框架柱 KZ 从墙面积中扣除后单列。
8. 梁：梁图层双线轮廓总长 ÷ 2 = 梁中心线长；再 × 解析截面（标注宽×高）。
9. 板：以墙/梁/柱线为屏障泛洪填充（PIL：画屏障 → MaxFilter(3) 补缝 → 从 (0,0) floodfill(...,2) → 统计 0 值像素 = 板内净面积）。
10. 装配式"折断图"无屏障：夹层/一层楼盖常是折断示意图，只有板轮廓无墙梁 → 泛洪会得到 0.38 m² 之类的荒谬值。兜底：按标准层同户型面积取用（A3# 取 407.5 m²），在 AREA_FALLBACK 里登记。
11. 板厚回源图注（"未注明板厚 h=xxx"）。局部降板区按所在层主板厚统一计。

钢筋

12. 墙身：分布筋（水平/竖向）双排 2 层，重量 = 墙面面积 × 2 × (1000/间距) × 单重(kg/m)；拉筋 Φ6@600 按 (1000/600)^2 × 1.1。
13. 暗柱：纵筋 = 规格(根数×直径) × 平面图该编号数量 × (层高 + 锚固 0.30)；箍筋 = 数量 × 层高/间距 × 估周长。
14. 板底筋：按图注口径，n_片（双向=2；双层双向=4）× (1000/间距) × Φ单重 × 板面积。
15. 板支座负筋：负筋线长度 × (最近垂直支座长度 / 间距) 求根数。必须同时遍历 LINE 和 LWPOLYLINE（负筋常画成多段线，只遍历 LINE 会漏）。
16. 梁筋：按集中标注解析每延米配筋量（上/下部纵筋沿梁高+锚固、箍筋沿周长×1.5、腰筋）× 实测梁长。转换大梁（h≥1000）单列。
    16a. ★ 梁集中/原位标注的图层名与排布随设计院变：探索者用 BEAM_*_JZ / BEAM_*_YW（含 JZ/YW），工大出图用中文 梁集中标注 / 梁原位标注；且标注不一定在名称行下方——A5# 是"名称在左、箍筋/纵筋依次向右"排在同一 y 上。25_beams.py 已改为：图层名同时匹配 JZ|集中标注、YW|原位标注，并按"归属距离最近的名称行"聚类（窗口 |dx|≤1500、|dy|≤1900）。若"有截面 N / 有配筋 0"就是踩了这个坑。
    16b. 板底筋直径要可配：slab_bottom 值格式为 [名称, 层数, 间距, 直径, 负筋间距]（后两项可省，默认 8 / 190）。一层现浇板常见 Φ10@150 双层双向（非 Φ8），若硬编码 Φ8 会低估约 56%。
17. 损耗：结果统一 ×(1+3%)。
18. 钢筋单位重量 kg/m：Φ6 0.222 / Φ8 0.395 / Φ10 0.617 / Φ12 0.888 / Φ14 1.208 / Φ16 1.578 / Φ18 1.998 / Φ20 2.466 / Φ22 2.984 / Φ25 3.853。

汇总

19. 暗柱数据查询键必须是平面图 uid（edges[plan]），不是表图 uid —— 曾因串键导致暗柱全部未进钢筋汇总，含钢量偏低 20%+。
20. 交叉校核：算完先看含钢量是否落在 95~115 kg/m³；再看各层混凝土是否随层高/面积合理波动；最后与同项目已算楼栋比量级。

5. 交付物

31_report.py 生成 Excel（4 工作表），并另写 <楼栋>楼工程量计算说明.md：

1. 分楼层汇总：层高 / 墙柱砼等级 / 墙柱截面 / 板面积 / 板厚 / 梁长 / 墙柱梁板砼分量 / 砼小计 / 钢筋小计。
2. 钢筋分构件汇总：暗柱 / 板 / 墙 / 梁 / 框柱 分类 + 按直径规格明细。
3. 混凝土分强度等级：C30(梁板) / C30 / C35 / C40 等。
4. 计算依据与假设：工程概况、口径、主要假定与风险提示。

必须写明的假定/风险（通用条款，逐项确认）：
- 折断图板面积按标准层推算；
- 梁原位标注未逐根解析（±10%）；
- 门窗洞口未扣（墙砼偏保守 2~4%）；
- 二次结构（楼梯/雨棚/挑檐/女儿墙/压顶/构造柱/圈梁）与基础（筏板/承台/桩）均未计入，建议另计 3~5% 系数；
- 定位=估算/复核级，不可替代结算报量。

最后用 present_files 同时给 xlsx + md。

6. 参考文件

• references/param_templates.md — 楼层表提取脚本片段、FLOORS/WALL_SPEC/SLAB_BOTTOM 模板、板图注定位技巧。
• references/case_a1_a3.md — 四个已完成算例的完整参数与结果（做新项目的对照标尺）。
• references/payment-integration.md — 支付与授权集成：两种部署模式（local/service）、支付宝沙箱申请、A2M 对接细节、验付调用与履约确认、回调与退款处理、体验额度发放、已知边界。

脚本全部为模板：逻辑可直接跑，但 FLOORS / WALL_SPEC / SLAB_BOTTOM / 图层名必须按新楼重填。