安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install anzhuang-suanliang
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 anzhuang-suanliang。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

安装工程量提取是一套 Openclaw Skills 工作流程，用于从 DWG 图纸和扫描索引中提取安装工程量，并生成两个互补视图：初步估算工程量清单和材料计划草案。它整理电气回路与线芯、电缆、电缆桥架、给水系统管道、设备、立管和支吊架估算，同时显示规格匹配结果、置信度、歧义项以及需要人工复核的项目。
此技能旨在加快早期工程量计划，并交叉核对图纸或专业估算软件的结果。其输出不是最终或按定额编制的工程量清单、结算工程量或竣工实测数据，也不会生成价格、费用或税费。

应用场景

根据安装 DWG 图纸编制初步 MEP 工程量清单和材料计划。
使用单独的扫描索引对照楼层平面图、系统图、设计说明和干线图。
按附近的回路标签整理电气导管长度，并使用可配置的预留量估算展开后的导线或电缆工程量。
按系统和管径复核给水系统管道长度，并识别立管、设备和支吊架材料估算。
查找需要人工复核的未匹配区段、含糊的回路规格、断开的管道走向及其他图纸问题。
将 CAD 识别的长度、面积或体积测量值作为非最终依据导入，以供核对。
在保留明确范围和置信度限制的同时，将早期计划工程量与专业软件输出交叉核对。

工作原理

分别扫描每张相关 DWG（例如楼层平面图、系统图、设计说明或干线图），生成 JSON 扫描索引。
将楼层平面图扫描结果、系统图和说明扫描结果，以及可选的干线图扫描结果传递给计划脚本。计划器读取扫描 JSON，无需自行解析 DWG 文件。
将电气线段与附近的回路标注匹配，按系统和管径分类管道，并在图元支持的情况下提取设备或材料表信息。
应用配置的工程量规则，处理线芯、电缆预留量、桥架区段限制、管道系统分区、立管、支吊架和材料损耗。
生成 XLSX 工作簿，其中包含双口径工程量和核对明细，包括匹配项、未匹配簇、置信度及工程量检查。
复核匹配率、含糊的回路、需人工检查的项目和规范覆盖状态；在将图纸估算用于计划或报告前进行验证。

配置指南

要求：Python 3.10 或更高版本，用于 DWG 扫描的 cad-file-reader >= 0.25.0，以及用于生成 XLSX 的 openpyxl。如果 CAD reader 安装在常规搜索路径之外，请将 CAD_SKILL_DIR 设置为其目录。无需 CAD 解析，计划器也可直接处理现有的 .scan.json 文件。
按以下两阶段工作流程运行，并将示例图纸名称替换为你的文件：

将每张图纸扫描到各自的 JSON 索引中

python scripts/mep_scan.py floor-plan.dwg --out floor-plan.json
python scripts/mep_scan.py system-diagram.dwg --out system.json
python scripts/mep_scan.py design-notes-or-elevation.dwg --out notes.json
python scripts/mep_scan.py trunk-plan.dwg --out trunk.json

根据现有扫描索引生成双口径 XLSX

python scripts/mep_plan.py \ --scan floor-plan.json \ --system system.json notes.json \ --trunk-scan trunk.json \ --out-prefix installation-plan 若要核对 CAD 测量候选项，请使用可用的 cad_measure.sh 工作流程生成候选项，并通过 --cad-measurement 将其传递给 mep_plan.py。这些候选项仅作为复核依据，并标记为 final_quantity=false；不会参与此技能的工程量计算。有关项目专属配置和用法的详情，请参阅 README.md 和参考规则文件。

工作原理

数据或输出 用途
DWG 输入文件 楼层平面图、系统图、设计说明或立面图，以及可选的干线图。
扫描 JSON 索引 由 mep_scan.py 生成的中间记录；每张图纸可单独扫描。扫描记录包含 CAD reader 基础版本和测量候选项兼容状态。
XLSX 计划工作簿 mep_plan.py 根据扫描索引并使用提供的输出前缀生成。包含双口径估算和材料计划信息，以及核对明细。
CAD 测量候选项 可选导入的长度、面积或体积识别依据，供复核使用；候选项固定为 final_quantity=false。
规则和参考文件 references/loss_rules.json 存储损耗、预留量和阈值规则；references/standard_rules.json 记录工程量口径限制；references/dual_caliber_rules.json 将估算清单项映射到材料行。
工作簿内容可包括规格和双口径映射；导管与电缆桥架工程量；导线、电缆和干线电缆；设备；配电箱回路；未匹配坐标簇；给水系统分区和连通性检查；立管识别与估算；支吊架估算；置信度分级；工程量平衡检查；材料表提取与合并；以及核对清单。具体输出是计划草案，而非计价工程量清单。
关键计算和元数据约定：
WIRE、PIPE 和 CABLETRAY 图层上的水平 LINE/LWPOLYLINE 中心线长度包含圆弧长度（如有），但不包括垂直走向和立管。
回路匹配使用最近的回路标注，默认半径为 30 m，可通过 match_radius_mm 配置。含糊的规格会被标记，而不会被静默判定。
未匹配的电气线段按 50 m 坐标网格分组，最多列出 50 个簇供图纸复核。
导线展开量按匹配的导管长度加端部预留量，再乘以线芯数计算；电缆展开量按匹配的导管长度加端部预留量计算。默认每个回路每端预留 1.5 m，可通过 reserve_per_end_m 配置。
超过配置限值（默认 50 m）的电缆桥架区段将作为异常项排除并单独报告。订货量根据净量应用配置的损耗系数。
根据标注距离、歧义、推断值和缺失匹配情况，将置信度分为高、中、低。总长度检查会将来源总量与分类小计进行比较。
给水系统分区分别统计水平长度，不重复计入总量。连通性检查会标记开口端、孤立区段以及可能的跨图层或跨分区连接，但不会更改总长度。

高级特性

提供成对的估算和材料计划视图，并通过
dual_caliber_rules.json
规定估算清单项与材料行之间的映射。
使用可配置的回路匹配、每端预留量、桥架长度阈值和材料损耗规则。
报告含糊或未匹配的回路分配，而不是强行指定缺乏依据的规格；不会自动将未标注回路分配到配电箱。
根据图纸标注识别立管，在不同图纸间对相同编号的立管去重，并标记推断长度。还可使用立管数量、层高和楼层数进行单独的可配置估算。
按管道图层和管径间距估算给水系统支吊架，并按水平吊架间距估算桥架支吊架；这些仅是材料计划估算。
检查管道连通性和工程量总量平衡，评定置信度，并提供供人工复核的核对明细。
可将 CAD 识别的测量候选项导入核对工作表，同时确保其仍为非最终数据，且不纳入此技能的工程量计算。
明确限定适用范围：不提供价格或税费，不测量垂直长度或管件，也不替代专业建模、工程量提取、结算或竣工实测。

name: anzhuang-suanliang slug: anzhuang-suanliang
displayName: 安装算量 · 概算底稿与物资计划双口径
version: 0.4.0
author: lis
license: CC-BY-NC-SA-4.0
description: 从安装工程 DWG/扫描索引提取概算清单底稿与物资计划草稿：按回路规格分档管线，展开电线芯线与预留，估算电缆、桥架、给排水、喷淋、支吊架和设备数量。目标是概算出量、物资计划、图审查量和专业软件结果交叉核对；不替代翻样、下料、结算，也不输出金额。

安装算量（概算清单 + 物资计划双口径） 0.2.0 优化概况 对接 cad-file-reader >= 0.25.0，扫描结果记录底座版本和测量候选兼容状态。
mep_plan.py --cad-measurement 可把长度/面积/体积识图候选导入“CAD测量候选核对”工作表；候选固定 final_quantity=false，不参与本技能算量。
保留安装专业双口径输出、回路规格匹配、水系统分区、立管识别、支架估算和核对清单；不输出金额、结算量或竣工计量。

两步出表：先扫描 DWG 建索引，再用索引生成 xlsx。

# 1. 扫描；平面图、系统图、说明图、干线图可分开出 JSON
python scripts/mep_scan.py 平面图.dwg --out 平面.json
python scripts/mep_scan.py 系统图.dwg --out 系统.json
python scripts/mep_scan.py 设计说明或立面图.dwg --out 说明.json
python scripts/mep_scan.py 干线平面图.dwg --out 干线.json

# 2. 生成双口径表；已有 .scan.json 时不要重新扫 DWG
python scripts/mep_plan.py \

--scan 平面.json
--system 系统.json 说明.json
--trunk-scan 干线.json
--out-prefix 安装计划

输出包含：口径、规范约束、双口径映射、导管与桥架、电线电缆、干线电缆、设备、匹配情况、配电箱回路、未匹配坐标簇、分层、水专业、水系统分区、连通性核对、立管识别、支架估算、置信度分级、总量守恒、材料表提取、材料归并、立管估算、核对清单。

依赖

依赖 cad-file-reader >= 0.25.0；扫描结果会记录底座版本和测量候选兼容状态。

可用 cad_measure.sh 先生成长度/面积/体积识图候选，再通过 mep_plan.py --cad-measurement 导入“CAD测量候选核对”工作表；候选固定 final_quantity=false，不参与本技能算量。

cad-file-reader 仅用于 mep_scan.py 读 DWG；找不到时设置 CAD_SKILL_DIR=/path/to/cad-file-reader。

mep_plan.py 只读 .scan.json，不依赖 CAD 解析。

Python ≥3.10；openpyxl 生成 xlsx。

口径与算法
管长＝WIRE/PIPE/CABLETRAY 图层 LINE/LWPOLYLINE 单线中心线水平投影（含弧段弧长），未含立管与竖向。
回路匹配＝线段中点就近回路标注（默认 30m 半径，match_radius_mm 可调），多规格同号回路取多数规格并计入歧义表。
配电箱回路＝优先识别“配电箱:回路”标注并按箱/回路/规格汇总；裸回路不硬归属。
未匹配坐标簇＝未匹配电气管段按 50m 网格汇总，输出前 50 簇供回图核对。
电线展开＝(匹配管长＋两端预留)×芯数；电缆展开＝匹配管长＋两端预留；预留＝每端 1.5m×回路数（reserve_per_end_m）。
桥架＝单段不超过 tray_max_segment_mm（默认 50m）才计入；超长段按异常剔除并单独列出。
订货量＝净量×(1+损耗)；损耗、预留和阈值见 references/loss_rules.json。
规范约束＝references/standard_rules.json 区分快算量、GB 50856 清单量、商务概算量和物资计划量；references/dual_caliber_rules.json 输出概算清单项与物资材料行映射。
水专业管径＝管段就近同系统 DN/De 标注；未标注管段按邻近已标注管段兜底推测，输出注明推测长度。
水系统分区＝按 PIPE 图层归并系统和高/中/低、室外等尾缀分区；分区表只拆分水平长度，不重复计总量。
连通性核对＝同图同系统/同管径端点吸附，输出开路端点、孤立段和疑似跨层/跨分区坐标簇；只回图确认，不改总长。
立管编号＝水专业标注层的 JL/PL/TL/FL/WL/YL/HL/RL/HYL/SPL-编号；同号跨图只计 1 根，折算长度按层高推定并标 [推测]。
置信度＝高（直接近距标注）、中（远距标注/歧义/邻近兜底）、低（未标注或未匹配）；总量守恒表核对源总长与分档合计。
支架＝按水专业图层/管径最大间距向上取整，桥架按水平吊架间距估算；仅供物资备料。
干线电缆＝系统图规格次数 + 干线平面/母线层就近规格匹配；无就近规格标注时按图层列“未分配量”，不硬分配规格。
立管＝配置里人工填根数×层高×(楼层数-1)，输出标 [推测]。
设备数量＝ATTRIB 属性实例数（已滤门窗编号/单字母标注噪声）；水专业器具＝块引用计数，块名 $ 前缀需对照图例命名。
依据

规范只存口径与边界，不复制全文。参考 GB 50856、GB 50500、GB 50015、GB 50084、GB 50116、GB 51309、GB 51348、GB 50974、GB 50261、GB 50303、GB 55024 和 GB 50166；详见 README.md 与 references/standard_rules.json。

边界（必须随结果告知）
输出是概算底稿和物资计划草稿；不是定额级清单、结算量或竣工计量。
不输出金额、单价、措施费、规费和税金。
未含竖向实测长度、管件、套管；立管识别只按图面编号折算；支架仅按间距估算。
回路标注覆盖不到的管长归“匹配情况-未匹配”，按图层出量，需人工分档。
水专业邻近管段兜底只是计划口径补充，抽查主干变径点后再提报。
同一设备出现在多张图时按各图分别计数后合计，跨图重复需人工剔除。
天正自定义实体的投影线可能与实际管线有出入，抽查 3~5 处回图核对后再提报。
设备/材料表跨图重复会标注“跨图重复”；乱码名称不得猜测。
CAD测量候选核对 中的值只作识图证据，final_quantity=false；不得直接当管长、材料量或结算量。
判定与升级路径
交付必须附“匹配率 + 歧义回路数 + 需人工核对项 + 规范约束覆盖状态”。
需要定额级清单、对量、结算或竣工计量：超出本技能边界，改用专业软件建模。
技能架构师
知乎内容包