# 重新关联文件流程介绍

当您修改模型文件路径或名称后，可通过重新关联功能同步更新至 D5 项目，同时保留历史灯光 / 材质配置。本流程支持 **SU/SketchUp** 和 **3dsMax** 实时插件用户。

  * 模型重命名 / 路径变更后的数据同步
  * 避免重复灯光叠加
  * 保留历史材质参数
  * 新旧模型属性继承

# 一、操作流程

### 方案一：关联过 drs 的模型

**适用场景：** 模型已关联过 D5 项目，但修改了本地存储路径或名称

#### 操作步骤：

##### 启动关联

  1. 在 DCC 插件中点击「启动」按钮。
  2. 弹窗选择「同步本地项目」模式。

<figure class="doc-image doc-image--stack">
  <img src="https://docs-static.d5render.cn/t/18217684-957c-4109-9021-5866cc58cc60/u/7531f9aa-9f13-43a5-858c-19dac517bbc6/1744787490546/image.png" alt="步骤一" />
  <figcaption>步骤一</figcaption>
</figure>

##### 选择替换对象

在弹窗中勾选需要替换的目标模型。（替换后将继承D5材质）

<figure class="doc-image doc-image--stack">
  <img src="https://docs-static.d5render.cn/t/18217684-957c-4109-9021-5866cc58cc60/u/7531f9aa-9f13-43a5-858c-19dac517bbc6/1744787561359/image.png" alt="步骤二" />
  <figcaption>步骤二</figcaption>
</figure>

##### 替换并关联

点击「替换并关联」完成同步。

### 方案二：同时打开 drs 与建模文件

**适用场景：** 需同时更新模型文件与关联项目

#### 操作步骤：

  1. 同时打开 D5 项目文件（.drs）和修改后的模型文件
  2. 在 DCC 插件中点击「启动」按钮

<figure class="doc-image doc-image--stack">
  <img src="https://docs-static.d5render.cn/t/18217684-957c-4109-9021-5866cc58cc60/u/7531f9aa-9f13-43a5-858c-19dac517bbc6/1744788316775/image.png" alt="步骤一" />
  <figcaption>步骤一</figcaption>
</figure>

  3. 在替换弹窗中选择对应模型
  4. 按需求勾选「灯光」/「材质」选项
  5. 点击「替换并关联」完成同步

<figure class="doc-image doc-image--stack">
  <img src="https://docs-static.d5render.cn/t/18217684-957c-4109-9021-5866cc58cc60/u/7531f9aa-9f13-43a5-858c-19dac517bbc6/1744789841895/image.png" alt="步骤二" />
  <figcaption>步骤二</figcaption>
</figure>

<figure class="doc-image doc-image--stack">
  <img src="https://docs-static.d5render.cn/t/18217684-957c-4109-9021-5866cc58cc60/u/7531f9aa-9f13-43a5-858c-19dac517bbc6/1744789862410/image.png" alt="替换联动逻辑" />
  <figcaption>替换联动逻辑</figcaption>
</figure>

#### 选项说明：

  * 勾选「灯光」：替换同 ID 的灯光组（历史参数保留）
  * 勾选「材质」：替换同名称材质（历史参数保留）

::: warning 注意
* 「灯光」替换仅支持 SU/3dsMax 实时插件
  * 非实时插件和直读模型不显示灯光 / 材质勾选选项
:::


# 二、常见问题

### Q1：插件同步时，DCC中提示“正在渲染中，请在渲染结束后重试。”是为什么？

A：一般是D5中进入图片/视频渲染模式后，再在DCC中进行删减模型操作（实时更新或手动更新），会遇到此报错。这个是合理的。

![image](https://docs-static.d5render.cn/t/18217684-957c-4109-9021-5866cc58cc60/u/7531f9aa-9f13-43a5-858c-19dac517bbc6/1744797455870/image.png)

![image](https://docs-static.d5render.cn/t/18217684-957c-4109-9021-5866cc58cc60/u/7531f9aa-9f13-43a5-858c-19dac517bbc6/1744797461334/image.png)

在此情况下退出图片/相机模式，再重新关联同步即可。