Menu
AI与建筑信息的桥梁。像写代码一样读写BIM数据！让智能体自动完成建筑建模、按图建模、工程量统计或模型审查，甚至只是为你建一栋专属的数据化房屋！
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | bimdown-zh |
| version | 2.0.0 |
| description | AI与建筑信息的桥梁。像写代码一样读写BIM数据！让智能体自动完成建筑建模、按图建模、工程量统计或模型审查，甚至只是为你建一栋专属的数据化房屋！ |
| metadata | {"openclaw":{"emoji":"🏛️","requires":{"bins":["bimdown"],"install":{"npm":"bimdown-cli"}},"optionalEnv":["BIMCLAW_API"],"network":{"publish":{"endpoint":"https://bim-claw.com/api/shares/publish","method":"POST","description":"可选的分享上传步骤。会将项目的 CSV/GeoJSON/GLB 打包上传到 BimClaw 并返回一个公共分享链接。匿名发布(无需账号或 token)。智能体在每个项目首次发布前必须显式获得用户授权。","override":"设置 BIMCLAW_API 指向自建后端。"}}}} |
你的使命： 建立 AI 智能体和建筑数据的桥梁。使用此技能，你可以像读写代码一样理解和创建建筑信息模型(BIM)。
本技能依赖 bimdown 可执行文件(由 npm 包 bimdown-cli 提供)。
which bimdown 或 bimdown --version。npm install -g bimdown-cli。你是一个在 BimDown 项目环境中运行的 AI 编程助手。BimDown 使用 CSV 存储属性、GeoJSON 存储几何。
project_metadata.json::units(m / ft / in / mm,缺省为 m)。详见下文 Units 章节。CSV / GeoJSON 中的所有坐标和尺寸都直接以该单位存储,没有任何内部规范化或自动换算。base_offset、top_offset、arc、rotation)。length、area、height、start_x/y/z、end_x/y/z、x、y、rotation、points、volume、bbox_*、level_id 都由 CLI 自动计算,任何文件都不要写入。id 关联(GeoJSON 中通过 properties.id)。format_version: 2(写在 project_metadata.json 里)。旧 SVG 项目(v1)必须先用 svg-to-geojson 脚本迁移。project/
project_metadata.json # { "format_version": 2, "units": "m", ... }
global/ # 跨楼层引用与多层几何
level.csv # 楼层标高(Z 的真值源)
grid.csv # 结构轴网(内联坐标)
wall.geojson + wall.csv # 多层墙
pipe.geojson + pipe.csv # 立管
...
lv-1/ # 单层元素文件
wall.csv + wall.geojson
column.csv + column.geojson
slab.csv + slab.geojson
door.csv # 宿主元素:仅 CSV(host_id + position)
window.csv # 仅 CSV
space.csv # 仅种子点(边界由 build 自动生成)
...
lv-2/
...
分区规则：
base_level_id 始终等于其所在目录的层级。跨层元素(例如跨 lv-1→lv-3 的墙)必须放到 global/。global/。BimDown 采用 "所见即所存" 模型:CSV / GeoJSON 文件中每一个坐标、长度、厚度、position、offset,都直接以 project_metadata.json::units 字段声明的单位存储,没有内部规范单位、也不会自动换算。
文件级不变量 —— 一旦项目声明 "units": "ft",所有 0.3 都表示 0.3 英尺;同一个数在 "units": "m" 项目里则表示 0.3 米。
在写入或修改任何数值前,先读取 project_metadata.json 确认当前单位。 本文档下方所有"典型值"表均以米为基准,使用其它单位时请按比例换算(例如 0.15 m 的隔墙 ≈ 0.49 ft / 5.9 in / 150 mm)。
允许的取值(枚举):
| 值 | 含义 | 说明 |
|---|---|---|
m | 米 | 字段缺失时的默认值 —— 保持所有旧项目不变 |
ft | 英尺(十进制) | 帝国单位,十进制 —— 1.25 表示 1.25 ft,不是 1'-3" |
in | 英寸 | 帝国单位,小尺度 |
mm | 毫米 | 公制小尺度(亚洲 / 欧洲施工图常用) |
修改 units 字段时不要随意改动数据本身。 单位字段改变但数值不动,意味着项目的物理尺寸被重新解释。后续会有 bimdown convert --to <unit> 流程负责真正的换算。
按元素本性分两种模式：
geometry.coordinates 是 2D [x, y],不含 Z。base_level_id、top_level_id 在 CSV 中(FK)。默认值:base 取目录层级,top 取下一层。properties:base_offset、top_offset。level.csv 中的标高,所有锚定元素自动更新。AI 不需要做任何标高算术。geometry.coordinates 是 3D [x, y, z],Z 为绝对值(米)。base_level_id(CSV)仍然记录用于分区,但几何本身在 3D 中自洽。每个 Feature 必须有 properties.id,与配对的 CSV 行一致。
// 直墙(level-anchored,2D)
{
"type": "Feature",
"properties": { "id": "w-1" },
"geometry": { "type": "LineString", "coordinates": [[0, 0], [5, 0]] }
}
// 弧形墙:两端点 + arc 属性
{
"type": "Feature",
"properties": { "id": "w-2", "arc": { "radius": 3, "large_arc": false, "sweep": true } },
"geometry": { "type": "LineString", "coordinates": [[5, 0], [5, 6]] }
}
// 柱子(level-anchored Point;截面属性在 CSV 里)
{
"type": "Feature",
"properties": { "id": "c-1" },
"geometry": { "type": "Point", "coordinates": [2, 2] }
}
// 梁(spatial 3D LineString)
{
"type": "Feature",
"properties": { "id": "bm-1" },
"geometry": { "type": "LineString", "coordinates": [[0, 0, 3.5], [10, 5, 3.7]] }
}
// 楼板(2D Polygon,闭合环;厚度、材质在 CSV)
{
"type": "Feature",
"properties": { "id": "sl-1" },
"geometry": { "type": "Polygon", "coordinates": [[[0,0],[10,0],[10,8],[0,8],[0,0]]] }
}
断开的多边形——不要写 MultiPolygon:切分产生几何上断开的多块时(典型场景:L 形板被切到拐角),拆成多个 Feature,id 用后缀(sl-18a、sl-18b)区分,每个仍是单 Polygon。MultiPolygon / MultiLineString / MultiPoint / GeometryCollection 在 canonical form 中禁止。bimdown-cli 库的 writeBimDownGeometry 在 JSTS 返回 Multi* 时会自动做这件事——只要走库写,你不用自己关心这条规则。
你可以用以下任意形式书写,bimdown build 会自动归一化:
| 你写的形式 | build 行为 |
|---|---|
弧形墙用 N 段折线(LineString 多于 3 点且共圆) | 检测出弧 → 输出两端点 + properties.arc |
| 矩形柱写成 4 顶点 Polygon | 提取 shape/size_x/size_y 到 CSV、rotation 到 properties;几何归一为 Point |
| 圆柱写成正多边形(N≥8 顶点共圆) | 提取 shape="round"、尺寸;几何归一为 Point |
| Polygon 环未闭合 | 自动闭合 |
| Level-anchored 元素写了 3D 坐标且 Z 恒定 | 丢 Z;若 Z ≠ base_level.elevation + base_offset,则反算 base_offset |
*.geojson Feature 集合,坐标正确。bimdown render <dir> -l lv-1 -o render.png,看 PNG。渲染输出必须保存在项目目录外。bimdown build <dir> —— 校验 schema、snap 端点、几何归一化、空间边界计算。bimdown query <dir> <sql> [--json] —— DuckDB SQL 查询,含 hydrate 后的几何字段。bimdown render <dir> [-l level] [-o out.png] [-w width] —— 渲染单层为 PNG/SVG 图。bimdown build <dir> —— 校验 + snap 端点 + 几何归一化 + 计算空间边界。每次编辑后必跑。bimdown schema [table] —— 打印表的完整 schema。bimdown diff <dirA> <dirB> —— 项目结构差异。bimdown init <dir> —— 创建空项目(format_version: 2)。bimdown publish <dir> —— 上传到 BimClaw,返回分享链接(联网,事先征求用户同意)。bimdown info <dir> —— 各层级元素数量统计。bimdown resolve-topology <dir> —— 自动解析 MEP 曲线连接关系。bimdown merge <dirs...> -o <out> —— 合并多个项目。bimdown sync <dir> —— 灌入 DuckDB 后再写回文件(应用归一化)。bimdown publish 是本技能中唯一会联网的命令。运行前向用户确认:
https://bim-claw.com/api/shares/publish(可用 --api 或 BIMCLAW_API 覆盖)。project_metadata.json)。{prefix}-{n}(纯数字)适用于多数元素;lv-{any} / gr-{any} 适用于 level/grid。+X=东,+Y=北,+Z=上。不要写 crs 字段,不要做 scale(1,-1) 翻转 —— GeoJSON 原生 Y 向上。length、area、start_x/y/z、end_x/y/z、x、y、rotation、points、height、volume、bbox_*、level_id。id —— 两边都有(字符串相等匹配)。base_offset、top_offset、arc、rotation、height_offset(ceiling)—— GeoJSON properties 里。base_level_id、top_level_id、host_id、position、所有材质/尺寸/枚举属性 —— CSV 里。units 换算)| 元素 | 字段 | 范围 |
|---|---|---|
| 隔墙 | thickness | 0.1 – 0.15 |
| 外墙 | thickness | 0.2 – 0.3 |
| 结构墙 | thickness | 0.3 – 0.6 |
| 单开门 | width × height | 0.9 × 2.1 |
| 双开门 | width × height | 1.8 × 2.1 |
| 窗 | width × height | 1.2–1.8 × 1.5 |
| 窗台高 | properties.base_offset | 0.9(常规)、0(落地) |
| 柱 | size_x × size_y | 0.3–0.6 × 0.3–0.6 |
| 楼板 | thickness | 0.15 – 0.25 |
| 层高 | elevation Δ | 3.0 – 4.0 |
要让 build 能正确计算空间:
bimdown build 会对未连通的端点发出警告,并基于闭合环计算空间面。门窗依附在墙上,没有 GeoJSON 文件 —— 只在 CSV 中通过 host_id + position(墙起点到开洞中心的距离,米)定位。
id,host_id,position,width,height,operation,material
d-1,w-3,1.5,0.9,2.1,single_swing,wood
校验规则:
position - width/2 >= 0 且 position + width/2 <= wall_length{
"type": "FeatureCollection",
"features": [
{ "type": "Feature", "properties": { "id": "w-1" },
"geometry": { "type": "LineString", "coordinates": [[0,0],[5,0]] } }
]
}
所有元素继承自 element:
id(必填)、number、mesh_file。base_offset(缺省 0)。level_id、volume、bbox_*。几何基类(全部计算字段):
line_element(wall、beam、…):start_x、start_y、end_x、end_y、length。spatial_line_element(beam、duct、…):再加 start_z、end_z。point_element(column、equipment、…):x、y、rotation。polygon_element(slab、roof、…):points、area。vertical_span:
base_level_id、top_level_id。top_offset(缺省 0)。height。hosted_element:host_id、position —— 都在 CSV,没有 GeoJSON 文件。
材质枚举:concrete、steel、wood、clt、glass、aluminum、brick、stone、gypsum、insulation、copper、pvc、ceramic、fiber_cement、composite。
beam、brace、cable_tray、ceiling、column、conduit、curtain_wall、door、duct、equipment、foundation、grid、level、mep_node、mesh、opening、pipe、railing、ramp、roof、room_separator、slab、space、stair、structure_column、structure_slab、structure_wall、terminal、wall、window。
需要某表完整 schema 时执行 bimdown schema <table_name>。
动手前必读对应 SOP:
references/building-design.mdreferences/bim-modeling.md更多细节或与 Revit 互转的工具,请参考官方仓库: https://github.com/NovaShang/BimDown