园林算量

园林统计苗木、算铺装面积；不替代结算。触发词：园林算量、苗木、绿化。

园林算量 v0.4.40

识图契约红线（硬规则，禁止绕行）

• 算量技能不得单独识别 DWG/DXF/PDF：识图只能由 cad-file-reader 做一次，产出统一契约后各技能共享复用。
• 禁止自行 import ezdwg/read_cad、自带或重新下载 cad-file-reader 解图；底座缺失如实标 unavailable，不得降级成「自己解图」。
• 算量入口不提供任何图纸直读或“开发直读”逃生开关：DWG/DXF/DWT 一律按退出码 23 停止；算量结果必须带契约来源（图号/坐标证据）。
• lis-skill-bus 是契约与算量技能之间的唯一定接线。
• DWG 解码兜底（ezdwg 读不了的 ACAD 新变体/损坏卷）只能在底座内用 ODAFileConverter 在副本上转 DXF 复扫校验；本技能不得调用 CAD/看图 App/ODAFileConverter。
• 内存双档：默认 CAD_MEM_LIMIT_MB=4096；仅实测超 4GB 真实大图且串行跑时临时 8192，不改全局默认；mem_guard 只终止识图子进程。

入口闸门（固定退出码，禁止 fallback）

未安装依赖时唯一正确行为是停止：打印固定提示并原样回显安装命令，不得改用其它解析器，也不得内置解析图纸。

退出码	含义	处理
0	依赖就绪	继续
20	缺 cad-file-reader 或版本 < 0.41.0	停止，回显安装命令
21	缺 lis-skill-bus 或版本 < 0.1.11	停止，回显安装命令
22	契约无效（版本/结构/来源/哈希/单位）	停止，回 cad-file-reader 重新生成
23	直接传入 DWG/DXF/DWT	停止，改走契约
24	证据不足，或只有手工来源却要求正式量	停止；仅手工契约可出 final_quantity=false 草稿

固定提示：本技能不直接识图，请先安装并调用 cad-file-reader 生成 cad-contract.json，再经 lis-skill-bus 传入；不许 fallback 到内置解析。

使用与依赖（按需读取）

强依赖 cad-file-reader（唯一识图底座），缺底座按 entry_gate 退出码 20 停止。语言/区域、脚本用法、输出字段、植物库结构、P0–P3 分层、证据坐标、联动与运行时见 references/on-demand.md；苗木口径与铺装面积口径仍在上文。

苗木口径（v0.4.13）

项目规则可加 exclude_layers、include_layers_regex 与 exclude_frame_bbox 缩小铺装候选；规则只会排除候选，不会改变置信分层。

来源	计量方式	置信	是否计入主线	说明
苗木表（单位证据完整）	设计给定（非逐株点数）	P0	是，作为设计基线	从图纸“苗木表/苗木配置表”名称+数量+单位证据解析；不能冒充平面图逐株点数
苗木表（单位缺失）	设计给定（非逐株点数）	P1	是，但 final_quantity=false	单位列为“待核对”，不默认为株；不计入株/棵/丛汇总
苗木表（数量=0，面积式/密度式）	仅复核线索	P3	否	无标题表靠“名称类表头+数量/单位表头”同排组合自识别；支持「中文名称」表头；不按株数推算
平面图图例（有坐标）	块级实例去重计数	P0	是（无冲突时）	同名块按坐标去重；与苗木表冲突时降 P3 并退出主线，逐名对照写入缺项核对
底座块实例（无坐标）	instance_count	P1	是，标明未逐点去重	底座已给出实例数，但本技能无法复点坐标
契约内块引用坐标	同名块坐标去重	P0	是（无冲突时）	只有 reader 契约给出顶层 INSERT 坐标时启用；坐标重复按去重半径排除
平面图块引用总数	meta.block_refs 计数	P2	否	只有引用总数、无坐标且未去重，只作人工核对线索
识图图例/种植文字	文字出现次数（非株数）	P2	否	来自 plant_legends 或 systems 种植文字；用于人工复核和交叉检查
块名/文字推断失败	未计算	P3	否	输出降级原因，不猜数量

铺装面积口径

• 面积(m²) = 鞋带面积(图纸单位²) × (图纸单位对应毫米数 × 比例)² ÷ 1e6。
• 外轮廓相加，洞/内岛按嵌套深度奇偶扣减。
• 有铺装图层且能成环：P0/P1 候选，无复核项时可计入主线。
• 含洞、闭环候选超过 50、疑似重复环/文字几何混入：标 需核对，退出主线。
• 图层名缺失：默认只出 REVIEW，不给面积；加 --paving-all-geometry 才出强算双口径——候选环面积合计与奇偶扣减净值，二者均强制 P3、不计入主线。
• 块内铺装：只消费 reader 契约里已展开 INSERT 变换与 HATCH/ARC/Bulge 边界的环面积，强制 P3、不计入主线。
• 过滤“同一节点重复经过”的伪环；但不能替代真实洞、内岛与外轮廓关系确认。

边界

1. 苗木数量受块引用/图例命名质量影响：无坐标、块名乱码时只能给苗木表设计基线或 P2/P3 候选，必须人工点数复核。
2. 苗木表数量单位缺失时显示“待核对”，不默认为株；需补看表头或单位列后再计入物资口径。
3. 苗木表数量是设计给定基线，不是平面图逐株点数；二者口径不可混用。
4. 铺装面积依赖可靠图层和闭合环；含洞、细缝、重复环、缺图层时进 需核对，不替代设计复核与现场核对。
5. 转换版/净化版 DWG 若图层名为空、块名乱码，铺装面积不可用；强算候选只能作排查线索。
6. 比例/单位自动检测失败时面积不可信，必须用 --scale / --drawing-mm-per-unit 指定。
7. 扫描件/图片型 PDF 不给铺装面积；苗木文字候选也需人工核对。
8. 不自动把公司数据上传云端，不联网解析图纸。
9. 输出只作概算底稿与物资计划草稿，不作为结算、对量、竣工计量或正式报价依据。

授权与保留

CC-BY-NC-SA-4.0，仅限非商业用途。商业使用（含承接造价/算量咨询业务）须另行取得作者书面授权；作者保留全部商业权利（商业使用、再发布、封装收费、授予第三方商业授权）。条款全文见 LICENSE.md。