插入参照
把外部 .skp 文件作为参照插入当前模型（宿主）。参照内容会以组件形式进入模型，
但 SC 参照管家会记住它的来源文件，后续可自动检测并同步。
- 点击工具栏或面板的「插入参照」；
- 选择外部 .skp 文件，确认插入选项：路径模式（绝对 / 相对）与落位方式（原点 / 鼠标指定）；
- 插入完成后，参照会出现在管理器面板列表中，状态灯为绿色（正常）。
路径建议：团队协作或项目需要挪动时，选择相对路径——
只要宿主模型与源文件的相对位置不变，换电脑、拷项目都不会断链。解析失败时会自动回退绝对路径兜底。
同步与写回
同步（拉取更新）
源文件被（同事或你在另一台电脑）修改并保存后，插件在后台检测到变更 （默认每 10 秒扫描一次，可设置），管理器中该参照的状态灯变为黄色（已变更），并弹窗提醒。
- 点击弹窗中的「同步」，或在管理器中选中该参照点「同步」；
- 同步前自动为宿主模型创建快照（默认保留最近 10 份）；
- 同步重载后，参照的位置、旋转、材质、图层等设置全部保留。
写回（推送修改）
双击进入参照（壳内）所做的修改——几何、材质、结构——会点亮面板上的「写回」按钮：
- 点击「写回」，修改将保存回源文件；写回前自动备份源文件（保留最近 10 份）；
- 若源文件正被他人占用：对方装了本插件时，会收到协商请求，确认后热应用，双方都不用关模型； 未安装插件时，请对方不保存关闭该文件后重试；
- 注意：参照在宿主中的摆放（位置 / 旋转 / 标签 / 显示名）属于宿主，不会写回源文件。
管理器面板
| 元素 | 说明 |
|---|---|
| 状态灯（绿） | 正常——本地与源文件一致 |
| 状态灯（黄） | 已变更——源文件有新版本，可同步 |
| 状态灯（红） | 丢失——源文件路径失效，可重新定位 |
| 状态灯（紫） | 冲突——参照实例全部脱离等特殊情况 |
| 「写回」按钮 | 仅当参照在壳内被修改后出现（脏标记） |
| 路径切换 | 每行可切换绝对 / 相对路径，解析失败自动回退 |
| 移位标记 | 参照被挪动过会出现提示，可一键复位变换 |
右键点击参照实例也有同样的操作菜单（同步 / 写回 / 复位 / 打开管理器）。
设置说明
| 设置项 | 默认 | 说明 |
|---|---|---|
| 检测间隔 | 10 秒 | 源文件变更扫描周期，可在 5–60 秒之间调整 |
| 快照份数 | 10 份 | 每个宿主模型保留的同步前快照数量 |
| 局域网通知 | 开启 | 同网段内他人保存源文件时即时提醒（UDP 广播，专业版） |
| 镜像缓存 | 开启 | 网络源（NAS）先拷贝到本机再加载，大幅提升同步速度（专业版） |
| 界面语言 | 跟随 SketchUp | 可强制中文 / 英文 |
设置保存在本机 %APPDATA%\SC_suXREF\prefs.json，跨模型、跨窗口生效。
激活与授权
- 激活：菜单「扩展 → SC 参照管家 → 激活与授权」（或点面板右上角授权角标）， 粘贴授权码（SCXR- 开头）点击激活。1 个授权可在 2 台电脑使用；
- 离线激活：内网环境点「生成请求码」，在任意联网设备打开官网激活页换取许可文本， 粘贴回插件导入；
- 换机：在旧机器点「解绑此机器」释放席位（每月 3 次），到新机器重新激活；
- 联网校验：每次启动 SketchUp 会静默联网校验一次授权状态； 断网时凭本地签名许可继续使用，离线宽限 30 天，期内联网自动续期。
疑难排查
- 状态灯一直是红色（丢失）：源文件被移动或删除。点击该行的重定位按钮重新指定源文件； 建议改用相对路径避免复发。
- NAS 同步很慢：确认已开启「镜像缓存」；首次同步需要完整拷贝，之后命中缓存即为秒级。
- 同事的变更没提醒：确认双方都保存到了同一个源文件路径，且检测间隔未调到过大； 局域网即时通知需要双方安装本插件。
- 激活提示「激活数已达上限」：1 个授权限 2 台机器。在旧机器解绑后重试， 或联系作者扩容。
- 写回按钮不出现：只有在参照（壳内）做了修改后才会出现；宿主外的摆放调整不会触发写回。
更多问题请通过 首页 FAQ 或 rao@shuichanga.cn 联系作者。