Autodesk Forge C#库生成Source File属性致DiffTool误报元素变更求助

问题核心 #

使用Autodesk.Forge C#库上传模型时，OSS对象的key（即UploadObjectAsync的第二个参数）会被作为元素的“Source File”属性存入模型。对比不同版本模型时，因两个版本的OSS对象key不同，DiffTool会误将所有元素标记为变更。直接用固定key会导致旧模型被覆盖，因此需要针对性调整。

解决方案：转译时指定统一的源文件名 #

无需放弃C#库，只需在调用Model Derivative服务转译模型时，通过自定义请求头x-ads-source-filename指定统一的源文件名，让转译后的模型元素使用该名称作为“Source File”属性，而非OSS对象的key。具体步骤如下：

1. 上传模型到OSS时，使用带版本标识的对象key
   给不同版本的模型设置不同的对象key（比如加入版本号），确保两个对象不会互相覆盖：

   // 版本1上传
   await ossApi.UploadObjectAsync(bucketKey, "model_v1.rvt", input.fileToUpload.Length, input.fileToUpload.InputStream, "application/octet-stream");
   // 版本2上传
   await ossApi.UploadObjectAsync(bucketKey, "model_v2.rvt", input.fileToUpload.Length, input.fileToUpload.InputStream, "application/octet-stream");
   

2. 转译模型时添加自定义请求头
   调用DerivativesApi.TranslateAsync方法时，传入包含x-ads-source-filename的请求头，指定统一的基础文件名：

   // 构造转译任务 payload
   var jobPayload = new JobPayload
   {
       Input = new JobPayloadInput
       {
           Urn = "模型的URN"
       },
       Output = new JobPayloadOutput
       {
           Formats = new List<JobPayloadFormat>
           {
               new JobPayloadFormat
               {
                   Type = "svf",
                   Views = new List<string> { "2d", "3d" }
               }
           }
       }
   };
   
   // 添加自定义请求头，指定统一的源文件名
   var headers = new Dictionary<string, string>
   {
       { "x-ads-source-filename", "project_main_model.rvt" }
   };
   
   // 发起转译请求
   await derivativesApi.TranslateAsync(jobPayload, headers);
   

   这样，两个版本的模型转译后，所有元素的“Source File”属性都会统一为你指定的值，DiffTool就不会再因为这个属性差异误报所有元素变更。

补充说明 #

• 该方法适用于Revit、DWG、IFC等所有Forge支持的格式，Model Derivative服务对这些格式都会读取x-ads-source-filename头来设置源文件名属性。
• 如果需要保留项目相关的原始文件名信息，只需保证不同版本模型的x-ads-source-filename值一致即可，无需完全舍弃原始名称。

内容的提问来源于stack exchange，提问作者kajacx