4、项目资源管理：Asset Store、本地资源库、资源引用与打包、版本控制（Git LFS）

资源管理这件事，说实话，是很多 Isaac Sim 项目从「能跑」到「能交付」的分水岭。我见过太多团队，仿真跑得挺顺，一换机器就缺贴图、缺模型、路径全乱。嗯，今天咱们就把这块彻底理清楚。

4.1 Asset Store：官方资源怎么拿、怎么用

Isaac Sim 内置的 Asset Store 其实是个好东西。它藏在 Window 菜单下，点开就能看到官方提供的机器人模型、环境场景、传感器预设。

下载后的资源默认放在 Nucleus 服务器的 /Assets/Isaac/4.2 目录下。注意，这些资源是只读的，你不能直接改。想修改？复制一份到你的项目目录再动手。

4.2 本地资源库：搭建你自己的资产仓库

Asset Store 的资源够用，但项目做深了，你肯定会有自己的模型、纹理、自定义脚本。这时候就需要本地资源库了。

我建议你在项目根目录下建一个 assets/ 文件夹，按类型分好子目录：

my_robot_project/
├── assets/
│   ├── models/          # .usd, .stl, .obj
│   ├── textures/        # .png, .jpg, .exr
│   ├── materials/       # .mdl
│   ├── scripts/         # .py, .omni
│   └── environments/    # .usd 场景文件
├── worlds/              # 仿真世界配置
├── configs/             # 参数配置文件
└── logs/                # 运行日志

在 Omniverse 中引用本地资源，推荐用相对路径。比如你的场景文件在 assets/environments/ 下，引用纹理时写成 ../textures/floor.png，这样项目拷到别的机器上路径也不会断。

4.3 资源引用与打包：别让路径搞崩你的仿真

资源引用是新手最容易翻车的地方。Isaac Sim 里引用资源有三种方式：

1. 路径：C:/Users/me/project/assets/model.usd —— 换台机器就废
2. 相对路径：../assets/model.usd —— 推荐，但要注意工作目录
3. Omniverse URL：omniverse://localhost/Projects/my_project/model.usd —— 团队协作首选

我个人强烈推荐用 Omniverse URL。为什么？因为 Nucleus 服务器会自动处理文件同步，你同事改了模型，你这边刷新一下就能看到最新版，不用手动拷来拷去。

4.4 版本控制：Git LFS 的正确打开方式

说到版本控制，我得先泼盆冷水：别用普通 Git 管理 .usd 文件。一个高精度的机器人模型动辄几百 MB，Git 的 diff 算法对这种二进制文件毫无办法，每次提交都会把整个文件复制一遍，仓库体积瞬间爆炸。

解决方案就是 Git LFS（Large File Storage）。它会把大文件替换成一个指针文件，真正的二进制内容存在远端服务器上。

4.4.1 安装与配置

# 安装 Git LFS
git lfs install

# 在项目里追踪 .usd 和纹理文件
git lfs track "*.usd"
git lfs track "*.usda"
git lfs track "*.usdc"
git lfs track "*.png"
git lfs track "*.jpg"
git lfs track "*.exr"

# 提交 .gitattributes
git add .gitattributes
git commit -m "Configure Git LFS for simulation assets"

4.4.2 哪些文件该用 LFS

4.4.3 团队协作流程

多人同时编辑同一个 .usd 文件时，冲突是难免的。我的建议是：

• 分工明确：每人负责不同的 layer 或 prim，减少冲突概率
• 频繁提交：小步快跑，别攒一周的改动一次性 push
• 用 Live Sync：Omniverse 的协作功能，实时同步场景修改，比 Git 更灵活

4.5 避坑指南：我踩过的那些坑

最后分享几个实战中遇到的典型问题，你遇到了可以直接抄答案：

• 纹理丢失：场景打开后模型是灰色的。检查 .usd 文件里的纹理路径，如果是路径，改成相对路径或 Omniverse URL 就能解决。
• LFS 配额超限：GitHub 免费版 LFS 只有 1GB 存储。我的做法是自建 Git 服务器，或者用 GitLab 的免费 LFS 额度（也是 1GB，但可以多个项目分开用）。
• 协作冲突：两个人同时改同一个 prim 的 transform。解决方案是用 Omniverse 的 Layer 功能，每人一个编辑层，最后合并。
• 打包后文件太大：检查是不是不小心把源文件（.blend、.fbx）也打包进去了。交付时只保留 .usd 和纹理，源文件单独归档。