SketchUp 里的参考插件,与CAD参照功能基本一致.多人协作建模的新方式.同步修改,原路写回.

处理过大模型的都知道，特别在以前 SketchUp 的承载能力有限，会非常的卡。要是拆分出去，每次修改拷回变更都是一个磨人的过程，特别是赶时间汇报的时候，把多个拆分的模型整合在一起时，卡个十几分钟也是常有的事。那时候就在想有没有这样一个插件，可以做到和CAD的参照功能一样，改完参照，主模型点同步即可，不管是多人协作还是自己单独干都能极大的提高效率。

现在好了，有了AI，我可以按自己的要求来开发一款这样的插件了。SC 参照管家孕育而生。

SC 参照管家盯两件事：源文件有没有真变；你在参照壳里改的东西，能不能有控制地写回源文件。模型不上传第三方服务器，走本机、NAS 或局域网。

图注：六个核心动作：建立参照、变更检测、同步重载、双向写回、快照回滚、局域网协作。

工具栏点「插入参照」，选一个外部 .skp。弹窗里两个选项：路径模式、插入点。路径模式我基本都选相对路径，项目文件夹整体拷走、换电脑，链接还能接上；解析不到时它会退回绝对路径兜底。插入点选鼠标指定，在模型里点一下落位，超过 60 秒不点会取消。如果参照模型是放到公司内网服务器时，要选把绝对路径。

插完，管理器面板会多一行，显示源文件路径、状态灯和行内按钮。绿色「正常」表示源文件和上次登记时一致；按钮会跟着状态变。

图注：管理器面板把参照路径、状态灯、行内「同步 / 写回 / 重新定位 / 处理」和设置区放在同一处。

默认 10 秒扫一次，设置里能改到 5 到 60 秒。10 秒够用；模型特别大、源文件在 NAS 上时调到 20 秒。

状态有六种：正常、正在核对、可能已更新、已变更、丢失、冲突。丢失多半是源文件被移走，冲突是参照实例被拆散后重新插入。看到「正在核对」先别点同步，它还在跑判定。

判定分五层，成本从低到高，哪层能下结论就停：

图注：任一层给出确定结论即停止；任何一层判「已变更」都立即生效。

这套逻辑最直接的收益是少误报。只转相机保存、打开就按 Ctrl+S，缩略图和样式会重写，文件大小、整文件哈希都可能变，但模型内容没变，插件不会弹同步。

因为SketchUp软件的原生问题，放在局域网的别的机器上时，通知会比较耗时（能接受范围）没办法做到和CAD一样的速度。

参照变黄「已变更」后，弹窗标题是「检测到源文件变更」，里面写着保存者和更新时间，按钮两个：「立即同步」「稍后处理」。我通常先看保存者再点。

「稍后处理」之后，本次 SketchUp 会话里这个参照不会再自动弹，手动点同步不受影响。忙的时候先压着，回到这个模型再处理。

同步前会自动做宿主快照。重载后位置、旋转、材质、图层都保留。面板「同步全部」和菜单「同步全部过期参照」可以一次处理多个黄灯。

图注：检测到源文件变更后的确认弹窗，标注保存者、更新时间和“同步前自动创建快照”。

写回是另一条路。双击参照进壳内，改几何、材质或结构，退出后行内才出现「写回」。写回前会备份源文件。

壳外（插入进去后是一个组件）挪位置、转角度、改标签、改显示名、覆盖材质，都不会写回源文件。插件只认壳内定义的变化。只想调整总装摆放，别进壳内改。

源文件被同事打开着，写回会发协商请求。对方装了插件，会看到三个选项：先保存副本再应用、直接应用、稍后再说。确认后热应用，两边都不用关模型。对方没装插件，插件会提示你让他不保存关闭，再重试。等 5 分钟没回应就算失败，修改还在宿主里，不会丢。

源文件同时被两个人改，先约好谁写。两边都点写回，后手容易把前手覆盖掉。

快照放模型同目录的 _suxref/，文件名带时间戳，默认留 10 份。写回源文件前，源目录的 _suxref/ 也会留一份。

NAS 上的源文件，插件会先整份镜像到本机缓存再加载。SketchUp 读 .skp 是随机小块读，SMB 冷缓存下每次小 IO 都走网络，顺序拷贝一遍反而快。缓存默认上限 2048MB，设置里能调到 64 到 16384MB，超了按最久未用清理。

同网段、双方都装插件，保存时 UDP 广播会直接告诉对方，省掉最长 10 秒的等待。端口默认 51717，几台机器要一致。防火墙挡了就会退回定时检测。

局域网广播只在小网段里好用。跨公网、异地，不行，因为需求太小，还要用服务器做云端中继，代价太大，我没有做。

图注：源端保存后广播或探测，宿主核验落「已变更」，确认同步；写回先向源端发请求，再协商应用。

Mac 版还在规划，只跑 Windows，SketchUp 2024 及以上（理论上2016以上都可以，但是我没测试）。

只装一边，识别不了保存者，也做不了源端热应用写回，只能走文件探测和占用提示（也能正常使用，只是没装的那台电脑没有提示而已）。

相机、缩略图、样式变化不算内容，这是有意排除。大模型判定有成本，超预算只给「可能已更新」。嵌套参照不递归接管，只管你手动插进来的那层。

QUICK START

三分钟上手步骤

安装包为 .rbz，用 SketchUp 扩展管理器安装；后续更新以官网为准。