资产、解包与按需拉取

资产与传统农场的痛点

在 3D 动画与视效制作中，资产（贴图、HDRI、缓存序列、音效和引用库）往往占据了工程 90% 以上的体积。

在日常制作中，美术往往习惯在 Blender 中开启“自动打包资源（Pack Resources）”，把几百张贴图内嵌进 .blend，或者在多个镜头中反复引用同一个角色与场景库。这在传统渲染农场中会带来严重的效率瓶颈：

• 工程臃肿，版本爆炸：改动几个关键帧或调整一次灯光，保存的新文件依然包含数 GB 的内嵌贴图，每次提交都要重新传输几 GB，存储空间成倍浪费。
• 重复传输：同一个镜头中 5 台渲染机各自分工，传统做法要求每台机器完整同步几十 GB 的全部工程资产，哪怕它只渲染一个远景镜头。
• 跨平台路径灾难：Windows 制作环境下引用的贴图路径（如 Tex\Wood.PNG），在 Linux 云端渲染机上因为大小写不匹配（磁盘上为 tex\wood.png）或斜杠方向而直接报红甚至渲染出紫黑缺失贴图。

danio 通过自动解包、内容寻址去重与按需 Range 拉取，彻底解决了这些问题。

自动解包与轻量化

当你在 Blender 扩展中点击提交、或把文件拖进 danio 时，danio 的后台分析模块会自动追踪工程所有的外部与内部依赖：

1. 内嵌资源自动解包：打包在主 .blend 或链接库里的贴图、字体和音效，会被解出到本机的 danio 缓存目录中，按内容哈希命名，绝不会改动美术原本的文件。
2. 轻量快照与引用改写：解包后的资源在快照中被映射为统一的相对引用。提交到存储的入口 .blend 副本解除了庞大的内嵌贴图，体积缩减为轻巧的工程骨架（通常只有几 MB 到几十 MB）。
3. 缓存加速：同一个库文件或同一个 .blend 再次提交时，若内容未发生修改，直接沿用上一次的解包与改写结果，大工程扫描可在数秒内完成。

1 张贴图只上传 1 次（全局去重）

danio 的存储不按文件名或文件夹路径管理资产，而是采用内容寻址（Content-Addressable），以文件内容的 SHA-256 哈希作为唯一身份标识：

• 跨版本去重：更新任务生成版本 2、版本 3 时，只要材质贴图没有修改，它们的哈希完全一致。提交时 danio 会向主机查询已有资产列表，存储中已有的贴图彻底跳过上传，只上传修改过的 .blend。
• 跨工程与跨镜头去重：整个工作区内的去重是全局的。如果镜头 01、镜头 02、甚至另一个完全独立的项目使用了同一张 4K 环境贴图或同一个角色模型，这张贴图在工作区存储里永远只存 1 份、只上传 1 次。
• 共享 NAS 本地就地处理：当工程引用了工作室 NAS 上的共享资产时，如果主机运行在 NAS 上（如 Docker），主机可以直接在本地磁盘就地计算并打包存储，美术电脑无需经由局域网将庞大资产来回传输。

Pack 分卷与按需 Range 拉取

为了兼顾网络传输效率与对象存储性能，danio 并不将每个文件单独散落在存储里（避免成千上万小文件产生海量 API 费用），也不会简单打包成一个巨大的不可变压缩包（避免必须全量下载）：

• ~256MB Pack 分卷：小于 64MB 的文件（如贴图、着色器脚本）按路径邻近原则合并打包成约 256MB 的不可变 tar 数据包，内部条目采用 zstd 级别 3 快速压缩（已压缩的 PNG/JPEG/MP4 会自动识别并原样存放）。64MB 以上的文件与主 .blend 独立成包。
• 按需 Range 拉取：渲染机领取到一个镜头后，先比对本机缓存，列出该镜头真正缺失的文件。在对象存储（如 Cloudflare R2）中，渲染机利用 HTTP Range 头（bytes=offset-length）精确读取目标文件对应的字节区间，无需下载整个 256MB 数据包。
• 硬链接零拷贝挂载：拉取下来的文件校验哈希后存入渲染机的缓存目录。当为任务准备工作环境时，danio 通过文件系统的**硬链接（Hardlink）**或块克隆将文件铺进 jobs/ 工作目录，瞬间完成文件准备，且不消耗额外的物理磁盘空间。

引用工程与跨平台修复

大型制作中普遍使用 Blender 的链接库（Linked Libraries），danio 在后台提交与渲染阶段提供了全流程自动保障：

• 缺失库提醒与一键重链接：提交时若检测到某个外部引用的 .blend 库路径失效，提交界面会以黄色警告标注，并支持在提交对话框中直接指定新位置，仅改写本次提交的快照，不污染美术原文件。
• 大小写敏感性修复：Windows 和 macOS 文件系统不区分大小写，美术引用的材质路径经常与磁盘真实文件名大小写不一致。Linux 渲染节点对此极其严格。danio 在分析时会核对磁盘实际文件名，自动重写为真实大小写，确保在云端 Linux 实例上渲染时纹理完好。
• 超长路径防护：Windows 存在 260 字符路径长度限制。对于多层嵌套引用的项目，danio 在渲染时会自动使用 \\?\UNC 扩展路径前缀重写副本，避免 Blender 因路径超长而无法加载资产。