---

name: sketchup-editable-model description: 根据图纸、尺寸、参考图或文字描述搭建可手动修改的 SketchUp（SU）模型，或整理已有 SU 模型的分组、组件、标签和材质。适用于拉 SU 模型、建筑体块、室内和构件建模；重点保证构件独立、材质可替换、层级清晰。

可编辑 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 调用时查阅相应文档，并按目标版本核对支持情况：

• 标签与原始几何
• 群组和组件材质继承
• SketchUp Model API：事务与保存
• SketchUp Material API