sketchup-editable-model

# 可编辑 SketchUp 模型 交付可继续推拉、移动、替换构件和调整材质的模型。建模时同步组织结构，不把整个方案做成一个不可分辨的网格，再在交付时补分组。 ## 开始工作 - 从用户资料确认建模范围、已知尺寸、单位和细节要求。建筑模型未指定单位时采用毫米并说明；不从透视图片推断精确尺寸。缺失但不影响开始的尺寸列为假设，关键比例无依据时向用户询问。 - “拉模型”默认指搭建模型；明确要求下载、导入素材时按该意图处理，并保留来源信息。 - 修改已有模型时，先检查大纲、标签、材质、组件共用关系和模型单位，沿用有意义的原结构。仅处理任务范围内的对象。 - 检查实际可用的 SketchUp 操作能力与版本。能在 SketchUp 内创建并验证时优先交付 `.skp`；无法运行 SketchUp 时，交付桌面版 SketchUp 内可执行的 Ruby `.rb` 建模脚本及运行方法，明确尚未生成或验证 `.skp`。不要把 OBJ、图片或改后缀的文件称为原生 SU 模型。 ## 分组和组件：按后续修改的对象拆分 - 每个需要独立选择、移动、隐藏或替换的构件拥有自己的群组或组件。墙体、楼板、屋顶、门、窗、栏杆、楼梯、家具与场地不粘连。 - 墙体通常按楼层、墙段及内外墙拆分；不把整栋所有墙合成一个群组。保留合理的墙体厚度、洞口与连接关系，避免为拆分制造重复面。 - 门窗总成下按需要拆为框、扇、玻璃等子对象；同一块几何上需要不同表面材质时，直接分面赋材质，不必把每个面单独成组。 - 单独造型默认用群组；重复且应联动修改的门窗、柱、家具等用共享组件定义。只改某一个实例时先使其唯一；命名不同不等于定义独立。 - 组件轴和插入点放在有意义的位置，例如门框底角、柱底中心。避免用非等比缩放重复组件来代替不同规格建模。 - 大纲按实际规模采用“项目／单体 → 楼层或区域 → 构件”的浅层结构；不创建空类别，也不把单个小物件强行套入建筑楼层体系。 - 新建对象取有意义的名字，如 `A栋_02F_外墙_北侧_01`、`A栋_02F_窗_W01_03`。组件定义表达类型与规格，例如 `窗_W01_1200x1500`，实例名表达位置。 - 根层级不散落新建建筑裸线裸面；导入底图与辅助对象单独归入参考组，默认锁定，工作构件默认可编辑。 ## 标签：管理显示，不代替群组 - 新建原始边和面全部保持 `Untagged`（旧版 `Layer0`），活动标签也保持默认；分类标签赋给群组或组件实例。 - 按需使用 `REF_参考`、`ARC_墙体`、`ARC_楼板`、`ARC_屋顶`、`ARC_门窗`、`STR_结构`、`INT_家具`、`SITE_场地`。用户已有命名优先。 - 用大纲表达楼层父子关系、标签表达专业或构件类别，避免为每个对象创建一个标签。版本支持且有必要时使用标签文件夹。 - 检查父组与子对象的标签组合，确保隐藏某一类构件不会错误地连带隐藏其他类别。关闭“按标签着色”检查真实材质。 ## 材质：按独立替换的范围归类 - 创建可读、可检索的材质名，采用“类别_用途_颜色或规格”，例如 `MAT_涂料_外墙_暖白`、`MAT_涂料_内墙_暖白`、`MAT_金属_窗框_深灰`、`MAT_玻璃_窗_透明`、`MAT_木材_地板_橡木`。 - 外墙和内墙即使同色，如果以后需要分别改色，使用不同材质对象；同用途、同规格且预期一起修改的表面复用同一材质。不要按颜色一键合并所有材质，也不要为每个构件复制一份材质。 - 默认将材质明确赋给构件内的面，父群组／组件保持默认材质，降低继承导致的修改歧义。需要实例级换色时，可有意采用实例材质继承，但必须让相应内部面保持默认，并在交付说明标明该策略。 - 检查面朝向后再赋材质；不靠背面涂色掩盖翻面。实体外表面正面朝外。薄片或双面可见材料按实际需要设置背面材质。 - 玻璃使用独立透明材质，窗框与玻璃可分别修改。不要用整扇窗的透明度代替玻璃材质。 - 贴图采用明确的实际尺寸和方向；木纹、砖缝、石材尺度应符合模型单位。缺少真实贴图时用命名清楚的纯色占位，并说明。 - 不依赖任意版本都有“材质文件夹”功能；模型内用命名前缀归类，外部贴图按类别放入 `textures/`。保留使用到的贴图来源和依赖。 - 仅清理本次新建且确认无用的重复材质。已有模型中未使用的材质可能属于用户的备选方案，不自动全局清理。 ## 几何质量与导入素材 - 对可推拉的墙板等构件保持干净的平面、闭合轮廓与真实厚度，减少无意义三角化。曲面细分与目标精度匹配，不为“精细”盲目增加面数。 - 检查零厚度、重复面、穿插和洞口封堵。需要实体的构件检查封闭性；地形、布面等有意开放的表面不强行封闭。 - 导入第三方模型后先检查尺寸、轴向、嵌套和材质。只在需要的层级拆解并重新组织，避免全局炸开或破坏贴图坐标。 - 单一网格按可识别的构件边界、连通几何或材质区域拆分，并复核拆分结果；仅按材质拆分不保证得到可编辑构件。不能可靠恢复的内部结构明确说明。 ## 用 Ruby 生成时 - 使用 SketchUp Ruby API，在专属模块内封装代码；参数集中管理，长度显式使用 `.mm`、`.m` 等单位转换，避免把内部英寸当毫米。 - 在新建且命名的任务根组内部创建实体，不向当前模型无差别散布几何。若用户正在嵌套编辑状态，先检查并明确目标上下文，不能误写进其他构件。 - 用一次正常的 `start_operation` / `commit_operation` 包裹建模；失败时 `abort_operation` 并报告错误，不嵌套 operation。文件保存与其他外部文件写入不受撤销事务保护。 - 重复执行不得删除用户模型，也不得悄悄叠加重复对象；识别本脚本标记的任务根组，报告已存在，或按用户请求生成独立命名的新版本。替换仅限明确指定的生成对象。 - 共用组件或材质在修改前检查影响范围；对本次需要独立修改的对象分离定义或材质。不要通过全局删除、全局清理来简化实现。 - 只有 SketchUp 实际成功保存后才宣称生成了 `.skp`。纯脚本语法检查不等于模型运行验证；Ruby 运行能力与 API 支持必须按实际环境检查。 - 保存采用新的版本文件名，保留原模型；脚本同时交付时附桌面版 Ruby 控制台加载命令，路径使用实际文件位置，例如 `load 'C:/project/build_model.rb'`。 ## 验收与交付 交付前进行与环境相符的检查，报告“已验证／未验证／不适用”，不把清单当成完成证据： 1. 抽查墙、楼板、门窗能独立选中和移动，且没有粘连；在副本或可撤销操作中进行，验证后恢复。 2. 抽查重复组件的联动符合预期；需要独立的实例已唯一化。 3. 检查本次创建的边面均在默认标签、构件命名可读、参考与工作对象分离。 4. 临时调整一项外墙材质，确认外墙正确变化且内墙、窗框等无意外联动；随后恢复。抽查透明度、贴图尺度和面朝向。 5. 检查整体尺寸、楼层标高及关键洞口；原生文件可用时保存并重新打开，确认结构与材质保留。 交付已生成的模型或脚本，加一份简短的模型说明：单位和尺寸假设、主要分组树、标签用途、材质名与使用部位、组件联动范围、检查结果和剩余限制。重点告诉用户在哪里改墙体尺寸、如何只改一个窗、如何单独替换某类材质。 ## 官方参考 需要核实行为或编写 API 调用时查阅相应文档，并按目标版本核对支持情况： - [标签与原始几何](https://help.sketchup.com/en/sketchup/controlling-visibility-tags) - [群组和组件材质继承](https://www.sketchup.com/blog/en-US/article/assigning-materials-groups-and-components) - [SketchUp Model API：事务与保存](https://ruby.sketchup.com/Sketchup/Model.html) - [SketchUp Material API](https://ruby.sketchup.com/Sketchup/Material.html)