团队协作中节点颜色不能硬编码，因环境、平台、版本差异会导致样式错乱；应采用语义标签（如status: "reviewed"）+统一映射文件（theme.json）解耦样式，结合事件驱动更新、受控枚举防冲突、Git merge=union策略及Dynamo-IFC-网页颜色桥接机制保障一致性。
模型节点颜色样式在团队协作中为什么不能硬编码
因为不同开发者本地环境、图纸版本、bim平台（如 revit + dynamo、rhino + grasshopper、或自研可视化引擎）对节点渲染的控制粒度不同，硬写 color 或 fill 值会导致：同一节点在 a 的机器上是蓝色，在 b 的机器上变成默认灰；版本回退后样式丢失；git 合并时因 json/yaml 配置块冲突而覆盖他人标注逻辑。
真正可行的方式是把颜色决策交给「语义标签」而非视觉值：
- 给节点打上
status: "reviewed"、type: "structural"、source: "ifc_import"这类可枚举、易比对的标签 - 在统一的
theme.json或style-mapping.js里定义"reviewed" → "#2563eb"，所有客户端加载同一份映射 - 版本控制系统只跟踪标签和映射文件，不跟踪最终色值——这样 Git diff 干净，CR 时也能一眼看出语义变更
如何让图纸版本变化自动触发节点样式刷新
很多团队卡在“改了 IFC 属性但颜色没变”，本质是没建立属性变更到样式的响应链。不是靠轮询或手动刷新，而是利用平台提供的事件钩子绑定更新逻辑。
以主流 BIM 轻量化库 @xeokit/xeokit-sdk 为例：
- 监听
model.added和model.updated事件，拿到变更的entityId - 查该 entity 的
properties（比如properties["IfcWall"]["Status"]），匹配预设规则 - 调用
viewer.setNodeColor(nodeId, color)更新——注意必须用nodeId，不是原始 IFC GUID - 避免在每次
updated中全量重绘：只处理properties字段实际变化的节点，否则性能暴跌
多人同时编辑时颜色覆盖冲突怎么防
典型场景：A 把某柱子标为 status: "approved"，B 同时把它标为 status: "revised"，最后保存顺序决定谁的颜色生效——但这不是样式问题，是状态语义冲突。
解决方案不是加锁 UI，而是前置约束：
- 所有状态字段必须走受控枚举，禁止自由输入字符串，校验逻辑放在提交前（如
validateStatus(value)） - 服务端接收更新时，拒绝
status字段与当前版本不一致的请求（带etag或version_id校验） - 前端显示冲突时，不覆盖颜色，而是叠加提示 badge：
conflict: ["approved", "revised"]，强制人工介入 - Git 中
style-mapping.js文件启用merge=union，防止分支合并时覆盖整行映射
Revit + Dynamo 环境下怎么同步节点颜色到轻量化网页
Revit 本身不存“节点颜色”，Dynamo 里设置的 Element.Color 只影响视图显示，不出现在导出的 IFC 或 JSON 中。想让网页端也看到对应颜色，得补一层映射桥接。
实操关键点：
- 在 Dynamo 脚本末尾加
Element.GetParameterValueByName("XEO_ColorCode")，读取自定义参数而非视觉色值 - 导出时把该参数写入 IFC 的
Pset_XEODisplay或额外生成mapping.csv，含guid,color两列 - 网页加载时，先解析 IFC 获取
GlobalId，再查 CSV 或 Pset 找对应色值，调用setNodeColor() - 别依赖 Revit 视图主题（View Template）——它不参与导出，纯本地渲染
最常被忽略的是：Dynamo 导出 IFC 默认不携带自定义参数，必须勾选 Export parameters as property sets，否则 XEO_ColorCode 就是空的。
