CLI 基本用法 — info / export / dump 三种模式

模式概述

AssetStudioMod CLI 的 -m / --mode 参数决定做什么事：

模式	作用	默认
info	统计每种资源类型的数量（不导出）	—
export	按类型筛选并导出	默认（不加 `-m` 就是 export）
dump	按 TypeTree 把资源序列化成 JSON 输出	—
live2d	导出 Live2D Cubism 模型	—
splitObjects	把所有 GameObject + Animator + Clip 拆成独立 FBX	—
animator	导出 Animator 控制器和绑定的 Clip	—
extract	解压 AssetBundle 到磁盘	—

info 模式：先看看有什么

info 模式不做任何导出，只统计每种资源类型有多少条：

AssetStudioModCLI <asset folder path> -m info

输出大致：

AssetBundle 数量: 128
Unity 版本: 2022.3.20f1
  Texture2D: 1245
  Sprite: 892
  AudioClip: 234
  Mesh: 56
  Font: 3
  MonoBehaviour: 678
  Shader: 45
  Animator: 23
  AnimationClip: 156
  TextAsset: 89

可以加 --load-all 统计所有类型（默认只统计可导出类型）。

export 模式：默认模式

不加 -m 就是 export 模式。导出所有可导出类型：

AssetStudioModCLI <asset folder path> -o <output folder>

按类型筛选导出：

AssetStudioModCLI <path> -t tex2d -o <output>
AssetStudioModCLI <path> -t tex2d,sprite,audio -o <output>

-t 支持的类型：

类型名	对应资源
`tex2d`	Texture2D + Texture2DArray
`sprite`	Sprite
`audio`	AudioClip
`mesh`	Mesh
`font`	Font
`textasset`	TextAsset
`monobehaviour`	MonoBehaviour
`animator`	Animator
`shader`	Shader
`movietexture`	MovieTexture / VideoClip

dump 模式：JSON 序列化

把资源按 TypeTree 序列化成 JSON 输出到文件：

AssetStudioModCLI <path> -m dump -t monobehaviour -o <output>

dump 模式常用于研究 MonoBehaviour 结构——导出的 JSON 字段名和 Unity 源码一致，方便对照。

跨平台运行（dotnet 方式）

Linux / macOS 上用 dotnet 运行：

dotnet AssetStudioModCLI.dll <asset folder path> -m info
dotnet AssetStudioModCLI.dll <path> -t tex2d -o <output>

Windows 上也能用 dotnet AssetStudioModCLI.dll（.NET 跨平台特性），但直接用 AssetStudioModCLI.exe 更方便。