AssetStudioMod CLI 概览 — 跨平台、自动化场景、GUI vs CLI
为什么有 CLI
AssetStudio 原版只有 GUI，适合手动操作但不适合自动化。AssetStudioMod 额外提供了 AssetStudioModCLI——跨平台命令行版本，能在 Windows / Linux / macOS 上跑，方便：
- 在 CI / CD 流水线里自动处理 Unity 资源；
- 在 headless 服务器上批量导出（没有 GUI）；
- 脚本化批量导出生成资源包；
- 比 GUI 手动点快得多（资源多的时候）。
三个运行时版本的 CLI
| 版本 | Windows CLI | Linux / macOS CLI |
|---|---|---|
| .NET 4.7.2 | ✅ | ❌ |
| .NET 8 | ✅ | ✅ |
| .NET 9 | ✅ | ✅ |
Linux / macOS 下跑 CLI 需要装 .NET Runtime 8.0 / 9.0（不是 Desktop Runtime，Linux/macOS 没有 GUI 所以不需要）。
可执行文件
CLI 的可执行文件叫 AssetStudioModCLI.exe（Windows）或 AssetStudioModCLI.dll（跨平台通用）：
- Windows 直接双击
AssetStudioModCLI.exe不行（命令行工具需要在终端里跑）； - Linux / macOS 用
dotnet AssetStudioModCLI.dll <参数>。
基本用法结构
AssetStudioModCLI <asset folder path> [全局选项] [模式] [模式选项]最核心的全局选项：
| 选项 | 作用 |
|---|---|
-m / --mode | 操作模式：info / export / dump / live2d / splitObjects / animator |
-t / --types | 资源类型过滤：tex2d / sprite / audio / mesh / font / textasset / monobehaviour 等 |
-o / --output | 输出目录 |
--filter-by-name | 按名称筛选（支持 Include / Exclude / 正则） |
--filter-by-container | 按容器路径筛选（支持正则） |
-g / --group | 导出分组策略：type / containerPath / containerPathFull / sourceFile / sceneHierarchy |
--unity-version | 手动指定 Unity 版本解析 |
--assembly-folder | MonoBehaviour 程序集目录 |
--image-format | 图像导出格式：png / tga / jpeg / bmp / webp |
--audio-format | 音频导出格式：wav / native |
与 GUI 版本的分工
| 场景 | 推荐 |
|---|---|
| 手动挑几个资源看看、预览确认 | GUI |
| 批量导出几百上千个资源 | CLI（跑一遍命令就完了） |
| 服务器上无人值守处理 | CLI |
| 需要精确控制筛选条件（正则） | CLI 的 --filter-by-name / --filter-by-container |
| 导出 FBX 并手动调比例 | GUI（FBX Export Options 对话框） |
| Live2D 批量导出 | CLI（-m live2d） |
CLI 做不到 GUI 的事情：3D 预览、音频播放、实时筛选面板、手动拖选。但在批量和自动化这两个场景下 CLI 是 GUI 远追不上的。