算量通 · 云端精算（按量付费）
本技能是云端服务的调用说明：算量引擎、规则库、定额口径都在服务端，本地没有实现 —— 不调用云端，本技能不产生任何结果。包里没有脚本，也不需要脚本：按下面的三步报文闭环发 HTTP 请求即可。
何时使用
- 用户要给一批构件（独立基础 / 条基 / 柱 / 梁 / 板 / 砌体 / 土方 / 桩 / 垫层）算混凝土量、模板量、挖方量
- 需要每行带计算式、可独立对审的工程量
- 需要一份"先出实量，再对标对方清单"的草稿（数量仍需人工对照图纸确认）
一眼看懂怎么调
# ① 首调（不带凭证）→ HTTP 402，响应头 Payment-Needed 内含应付金额与 out_trade_no，订单已落库
curl -i -X POST https://wzh78.asia/api/skill/v1/calc \
-H 'Content-Type: application/json' \
-d '{"project":"示例工程","items":[
{"category":"duji","name":"DJpJ-1","count":4,"length_m":2.2,"width_m":2.2,"height_m":0.6},
{"category":"beam","name":"DL-1","count":2,"length_m":6.0,"width_m":0.3,"height_m":0.5}]}'
# ② 客户端走支付宝完成付款，取得 Payment-Proof（Base64URL，由支付环节产出，不要自己造）
# ③ 带 Payment-Proof 头重试同一 URL → HTTP 200 + 结果 + 响应头 Payment-Validation
curl -i -X POST https://wzh78.asia/api/skill/v1/calc \
-H 'Content-Type: application/json' \
-H 'Payment-Proof: <Base64URL>' \
-d @items.json
调用方若装有支付宝「AI 付」技能（alipay-aipay），它会自动处理 402 → 收银 → 带 Payment-Proof 重试；无需手工搬运凭证。
计费与凭证（三步报文闭环）
| 步 | 请求 | 服务端行为 |
|---|---|---|
| ① | 无 Payment-Proof |
HTTP 402 + 响应头 Payment-Needed（Base64URL JSON，含应付金额、收款方、out_trade_no），订单已落库 |
| ② | 客户端完成支付宝付款 | 取得 Payment-Proof（Base64URL，含 payment_proof / trade_no） |
| ③ | 带 Payment-Proof 重试同一 URL |
验付 → 生成资源 → 履约确认 → HTTP 200 + 结果 + 响应头 Payment-Validation（validated: true） |
硬约束：① 结果只在验付通过后生成一次，同一 Payment-Proof 重试不重复扣费；② 凭证无效/未付 → 重回 402（不报 500）；③ 出现 502 FULFILLMENT_CONFIRM_FAILED 时用同一凭证重试，资源不会丢。
输入字段（速查，完整表见 references/02）
每个构件一个对象，category 决定其余字段：
| category | 含义 | 字段 |
|---|---|---|
duji |
独立基础 | length_m(a)×width_m(b)×height_m(h)，可选 a2_m/b2_m/h2_m(上台) |
strip |
条形基础/地梁 | width_m×height_m×length_m，可选 trench_depth_m/cushion_t/cushion_out |
column |
柱 | width_m×height_m(截面)×length_m(柱高) |
beam |
梁 | width_m×height_m×length_m，可选 thickness_m(板厚) |
slab |
板 | length_m×width_m×thickness_m |
wall |
砌体墙 | length_m×thickness_m×height_m，可选 hole_m2/embed_m3/mortar/brick/level |
pit |
基坑土方 | bottom_length_m×bottom_width_m×depth_m，可选 slope(默认0.33)/workface_m(默认0.3) |
pile |
桩 | diameter_m×length_m，可选 pile_type |
rebar |
钢筋 | diameter_mm+total_m 或 length_m/spacing_m（需平法标注与柱表） |
公共字段：name（构件名，逐行对审用）、count（数量，以人工核对图纸后的数量为准）、concrete（砼标号，可选）。
输出解读
content 下四块：summary（分项汇总）/ details（逐构件，含计算式）/ formulas（可复算）/ warnings（⚠️ 待人工确认项）。
- 数字带计算式，可逐步复算；禁黑箱
warnings非空 = 有需要人工确认的项（缺尺寸、剖面缺失、标号冲突等），必须转达给用户，不得静默丢弃- 数量是 AI 草稿：尺寸逐项可改、数量以人为准；本项目"先出实量、再对标"，禁止为凑对方清单反推输入
不适用 / 必须提前说明
- 纯钢结构（门式刚架、H 型钢柱梁、檩条、支撑）：不识别，硬跑必错 → 直接说做不了
- 钢筋精算：需柱表/平法逐根解析，先确认有平法标注与柱表
- 纯文本估量：不得作为工程量依据
参考文件
references/01-按量付费调用协议.md— 402 三报文闭环、Payment-Needed/Payment-Proof/Payment-Validation字段表、幂等与重试、错误码references/02-输入字段速查.md— 全 category 字段表与填法、常见错填references/03-输出结构与交付.md— 200 响应结构、转 Excel 交付、⚠️ 语义
两条路：自助付费 / 加微信领试用
- 不想加微信 → 直接自助付费用：按上面协议调用，无凭证首调返回 402，支付宝付 ¥1/次 后带
Payment-Proof重试即出结果 —— 全程无需联系任何人。 - 想先免费试 / 要人工复核 / 批量项目 / 开票 → 加微信：wangzhihan78（发「算量通试用」）
- 网页注册入口（注册 0 积分，试用额度加微信领）：https://wzh78.asia/suantong/
