安装指南

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

什么是

此 Openclaw Skills 工具可帮助施工团队根据房间类型、建筑和结构图纸、装修表、规格说明及详图，编制初步装饰预算、详细工程量计算和材料计划。它同时支持快速按房间模板估算和逐项输入工程量，并保留计算公式、来源依据、缺失信息及审核标记，让用户能够检查结果，而非依赖不透明的总数。
此技能可计算工程量、材料损耗和订货量、洞口扣减、侧壁及防水预留量，然后生成 Excel 和 CSV 台账，供商务和现场审核。CAD 测量候选数据可作为证据导入核验，但不会被视为最终工程量。输出仅为初步规划辅助资料，不能替代项目规则、现行标准、合同计价或正式计量结算。

应用场景

按房间类型快速编制初步估算，例如办公室、会议室、卫生间、走廊、楼梯间、屋面或外墙。
按楼层、区域、房间、建筑构件、饰面规格和节点详图索引组织详细工程量计算。
规划主要和辅助材料，列出净工程量、损耗预留、需求量及建议供应方式。
核查防水工程量，包括上翻、附加层、卷材搭接和涂层厚度输入。
将 CAD 测量候选数据转换为可审核的输入草稿，同时保留证据坐标，并将每一行标记为待核验。
在估算用于规划之前，查找缺失输入、重复行、不确定的房间类型及项目专属细节。

工作原理

按楼层、区域、房间、建筑构件和房间类型定义范围，避免混淆整栋建筑的工程量。
审查来源文件，优先查看详图和项目专属节点规则，其次查看装修表、通用规格说明、建筑图纸和结构图纸。项目规则和现行要求优先于内置默认值。
选择使用房间模板 CSV 进行快速估算，或使用分项输入 CSV 进行详细估算。快速输入会根据房间模板扩展为多个饰面项目。
验证必填字段、数值、防水参数、节点索引和重复行。未知房间类型及未解决的项目专属细节会继续标记，等待确认。
根据基础工程量计算商务估算工程量，并根据消耗率、损耗、搭接和附加层计算材料需求。瓷砖及其他按件计量的材料按单位面积向上取整。
审查待确认事项、来源依据、计算公式、洞口扣减、防水假设、工程量口径及单价来源。
导出 Excel 台账、CSV 明细文件和 Markdown 报告，供商务及现场审核。

配置指南

此技能要求其脚本、模板和规则文件在工作环境中可用。SKILL.md 未指定软件包安装命令。对于文档输入，使用现有的 markitdown 依赖读取 Word、Excel 和 PDF 文件。对于 CAD，请使用 cad-file-reader 0.25.0 或更高版本；此技能委托其读取图纸，不会独立解析大型 DWG 文件。首次使用时为图纸建立索引，之后处理同一图纸时重复使用该索引。
从快速估算模板开始，或提供详细输入 CSV。调用示例：

快速初步估算

python3 scripts/decor_qty.py \ --input 'templates/快速概算输入表.csv' \ --out-dir './概算结果' \ --project-rules 'templates/项目专属规则示例.json' \ --project 'Project name'

指定楼层的详细估算

python3 scripts/decor_qty.py \ --input './input.csv' \ --out-dir './明细结果' \ --project-rules 'templates/项目专属规则示例.json' \ --project 'Project name' \ --level '二层' 可通过 --room-templates、--quantity-rules、--price-rules 和 --material-rules 提供可选规则文件。对于 CAD 辅助输入，生成测量候选数据并将其转换为核验草稿：
scripts/cad_measure.sh '描述几何/图纸详情.descriptive.json' --out-dir '测量候选'
scripts/cad_measure_to_input.py \ --measurements '测量候选/cad-measurement-candidates.json' \ --out 'CAD导入_待核对.csv' \ --floor '二层' CAD 派生行会保留房间或构件候选项、测量数据和证据，但必须经过人工审核并映射饰面做法，之后才能纳入正式工程量计算。

数据架构

输入与配置
输入或规则文件 用途
templates/快速概算输入表.csv 快速估算的房间类型输入，根据房间模板扩展为饰面项目。
templates/装饰算量输入表.csv 用于工程量核查和饰面做法映射的详细分项输入。
项目规则 JSON 项目专属节点和饰面规则；项目专属做法必须引用节点编号和详图。
房间模板规则 JSON 用于扩展快速输入的标准房间模板。
工程量、价格和材料规则 JSON 配置工程量清单口径、参考价格及材料分类。
CAD 测量候选 JSON 供审核且带有证据的长度或面积候选数据；候选数据不是最终工程量。体积候选数据不会直接导入。
详细输入必须包含楼层、区域、房间、构件类型、饰面做法编号和名称、做法类型、依据及房间数量。数值字段必须为非负数字，房间数量必须大于零。完全重复的行会被标记并排除在计算之外。防水条目必须填写相关的附加层、搭接和涂层厚度字段；卫生间和厨房还必须填写上翻高度。
生成的文件
输出 内容
装饰概算物资计划台账.xlsx 六个工作表：概算、物资计划、明细、汇总、缺项和依据。
概算明细.csv 清单编码、计算工程量、参考单价、估算金额、公式和状态。
概算汇总.csv 按清单项目汇总的工程量和估算金额。
物资计划.csv 净工程量、损耗率和损耗量、需求量、按完成状态统计的需求、材料类别及供应方式。
明细.csv 和 材料汇总.csv 基础工程量、订货量、公式和依据。
缺项核对.csv、依据.csv 和 Markdown 报告 待处理核查项、来源依据及书面项目摘要。
估算工程量使用基础工程量，不计损耗、搭接和附加层。材料订货量按消耗量和损耗计算；卷材还会应用搭接系数，而附加层则单独计算。必须扣除洞口，洞口侧壁根据项目口径另行列出。内置价格和防水数值仅供估算和验证参考，并非具有权威性的项目输入。

高级特性

在生成的台账中保留可审计的计算公式、来源依据、缺失项目和验证状态记录。
通过可配置文件和命令行选项应用项目专属房间模板、工程量口径、价格规则、材料分类及节点规则。
导入带有证据坐标的 CAD 长度和面积候选数据，同时将饰面做法映射留空，并将该行设为需要核验；CAD 候选数据不会自动成为最终工程量。
核查防水输入和参考阈值，包括卷材搭接、涂层厚度、附加层宽度、房间上翻及屋面防水层。这些核查仅用于提示，不能替代现行标准或项目文件。
区分商务估算工程量和材料订货量，包括损耗、消耗率、卷材搭接系数、单独计算的附加层，以及按件计量材料的向上取整。
对装饰造型、不规则天花板、复杂幕墙和楼梯细部等缺乏依据的复杂情况进行标记并要求确认，而不是擅自编造工程量。
图纸和项目数据保留在本地：此技能声明不会自动将公司数据上传到云端，也不会在线解析图纸。

name: zhuangshi-suanliang slug: zhuangshi-suanliang
displayName: 装饰算量 · 概算与物资计划
version: 0.9.0
author: lis
license: CC-BY-NC-SA-4.0
description: 根据房间类型、建筑说明、建筑图、结构图、房间装修表、做法表和节点详图，快速出装饰概算和物资计划；可导入 cad-file-reader 的长度/面积测量候选作为待核对输入，做法映射、洞口扣减、损耗、材料台账和清单量仍由本技能计算。

装饰算量 v0.9.0 0.7.0 优化概况 对接 cad-file-reader >= 0.25.0 的长度、面积、体积测量候选；只把长度/面积转成待核对输入，体积候选不直接导入。
CAD 导入行保留证据坐标，做法编号留空、需核对=是，不把识图候选冒充正式装饰量。
概算量、物资计划量、做法映射、洞口扣减、侧壁、损耗和六表台账仍由本技能计算。

它解决的一件事：施工员/技术员快速得到装饰概算合价和物资计划量，同时保留计算式、依据、缺项和校验提示，防止“跑通但算错”。

适用
快速概算：按办公室、会议室、卫生间、走廊、楼梯间、屋面、外墙等房间类型展开。
明细算量：按楼层、区域、房间、部位、做法编号和节点逐行输入。
物资计划：输出主材/辅材分类、净量、损耗量、需求量和供货方式参考。
防水：计算上翻、附加层、卷材搭接，并按内置规范参考校验。
前置
读 CAD 用已安装的 cad-file-reader >= 0.25.0；读 Word/Excel/PDF 用 markitdown。
不自行解析大 DWG，只调用读图能力；第一次输入图纸先建索引，后续同图复用。
项目做法表、节点详图、项目专属规则、企业定额、现行规范优先于内置默认值。
项目专属做法必须绑定节点编号和节点详图，并在项目规则中匹配节点规则；缺节点时进待确认项，不用默认材料层凑数。
使用流程
圈定范围：确认楼层、区域、房间、部位和房间类型，不把全楼混算。
读取依据：交叉读取房间装修做法表、建筑总说明、建筑图、结构图、门窗表、节能/防水/防火说明和节点详图。
优先级：节点详图/大样图 > 项目专属节点规则 > 房间装修做法表 > 建筑总说明 > 建筑图/结构图 > 默认参考值。
快速输入：若只需初稿，填 templates/快速概算输入表.csv；脚本按房间模板展开为多条做法。
明细输入：正式核对时填 templates/装饰算量输入表.csv，逐行绑定尺寸和做法。
计算：概算取基面量；材料需求量乘损耗、搭接、附加层和单耗；块料向上取整。
复核：检查待确认项、重复行、防水参数、清单口径和单价来源。
输出：用六表 Excel 台账做商务和现场核对。
脚本用法

# 快速概算
python3 \

scripts/decor_qty.py
--input templates/快速概算输入表.csv
--out-dir ./概算结果
--project-rules templates/项目专属规则示例.json
--project "项目名"

# 明细算量
python3 \

scripts/decor_qty.py
--input ./输入.csv
--out-dir ./明细结果
--project-rules templates/项目专属规则示例.json
--project "项目名" --level "二层"

可用规则参数：

--room-templates rules/标准房间模板.json --quantity-rules rules/清单工程量规则.json --price-rules rules/概算综合单价.json --material-rules rules/物资分类规则.json 输出
装饰概算物资计划台账.xlsx：固定包含 概算、物资计划、明细、汇总、缺项、依据。
概算明细.csv：清单编码、清单工程量、参考单价、概算合价、计算式和状态。
概算汇总.csv：按清单项汇总工程量和合价。
物资计划.csv：净量、损耗率、损耗量、需求量、完成状态需求量、分类和供货方式。
明细.csv、材料汇总.csv：基面量、订货量、计算式和依据。
缺项核对.csv、依据.csv、装饰概算物资计划报告.md。
输入校验
明细必填列：楼层、区域、房间、部位类型、做法编号、做法名称、做法类型、依据、间数。
快速输入按 房间类型 展开成明细；未知房间类型不静默跳过，进入待确认项。
数字列必须填数字，不带文字单位；不允许负数；间数必须大于0。
完全重复行标记为“重复”，不重复计入计算。
防水行要求附加层宽度、搭接宽度、涂膜厚度字段；卫生间/厨房还要求上翻高度。
项目专属做法必须填写节点编号、节点详图并匹配项目节点规则。
口径
概算量：清单/商务口径，取基面量，不含损耗、搭接、附加层。
材料订货量：基面量 × 单耗 ×（1 + 损耗率）；卷材另乘搭接系数；附加层单独计算。
块料：按单片面积向上取整。
门窗洞口：必须扣；洞口侧壁按项目口径单列。
单价：内置综合单价只是示例参考；正式概算以合同清单、地方信息价、企业定额和市场询价为准。
输出不用于结算、对量、竣工计量或正式报价。
防水与规范复核

内置值是算量参考下限和校验提示，不替代条文原文；现行规范、设计文件、节点详图和项目规则优先。

卷材搭接参考下限：80mm。
涂膜厚度参考下限：1.5mm。
室内附加层宽度参考：0.25m；屋面/地下参考：0.5m。
室内有水房间上翻参考：0.25m；淋浴区按设计/规范另核，常见参考1.8m。
屋面防水道数参考：不少于2道，按防水等级和设计复核。
防水卷材用搭接系数计算：幅宽 /（幅宽 - 搭接宽度）。
防水附加层可填直接面积，或按长度×宽度计算。

参考标准包括：

GB 50500-2013《建设工程工程量清单计价规范》
GB 50854-2013《房屋建筑与装饰工程工程量计算规范》
GB/T 50353-2013《建筑工程建筑面积计算规范》
GB 50210-2018《建筑装饰装修工程质量验收标准》
GB 50209-2010《建筑地面工程施工质量验收规范》
GB 55030-2022《建筑与市政工程防水通用规范》
GB 50207-2012《屋面工程质量验收规范》
GB 50208-2011《地下防水工程质量验收规范》
GB 50345-2012《屋面工程技术规范》
JGJ 298-2013《住宅室内防水工程技术规范》
JGJ 144-2019《外墙外保温工程技术标准》
GB 50411-2019《建筑节能工程施工质量验收标准》
GB 50325-2020《民用建筑工程室内环境污染控制标准》
GB 50222-2017《建筑内部装修设计防火规范》
GB 50327-2001《住宅装饰装修工程施工规范》
CAD 测量候选交接

先用 cad-file-reader 生成带比例、单位、计算式和证据的测量候选：

scripts/cad_measure.sh 描述几何/图纸详情.descriptive.json --out-dir 测量候选

再把候选转成装饰算量输入表草稿：

scripts/cad_measure_to_input.py --measurements 测量候选/cad-measurement-candidates.json --out CAD导入_待核对.csv --floor 二层

导入行会保留房间/部位候选、面积或长度候选和证据，但做法编号留空、需核对固定为“是”；做法映射、洞口扣减、侧壁、损耗、材料台账和正式清单量仍由本技能计算。

边界
装饰造型、线条、异形吊顶、复杂幕墙、楼梯细部不自动展开，先列待确认项。
材料消耗默认值只是参考，不能替代项目做法表、节点详图或企业定额。
图纸文字粘连、天正实体、表格跨页时可能漏读，必须用待确认项复核。
CAD 测量候选只作识图证据，final_quantity=false；做法映射、洞口扣减、侧壁、损耗和材料台账必须在本技能内完成，真图回归仍是后续增强项。
不自动把公司数据上传云端，不联网解析图纸。
司马光视角

Brand GEO Analysis Plus