cli-anything-live2d 是做什么的?
用于 Live2D Cubism 模型的全功能 CLI。包含 42 条命令,涵盖检查、编辑、代码规范检查、差异对比、批量操作、资源管理、生成和部署——全部无需 Live2D Editor。
命令(共 42 条)
读取(18 条)
| 命令 | 用途 |
|---|
inspect <model> | 模型概览(版本、数量、特性) |
validate <model> | 检查所有引用的文件是否存在 |
motions <model> | 列出动作及淡入淡出时间 |
motion-info <file> | 详细的动作分析 |
expressions <model> | 列出表情预设 |
expr-info <file> | 详细的表情分析 |
textures <model> | 列出纹理及其尺寸和大小 |
physics <file> | 物理模拟配置 |
moc3 <file> | Moc3 二进制信息 |
params <model> | 参数分组 |
param-list <model> | 所有动作/表情的参数 |
deps <model> | 依赖关系图 |
compare <a> <b> | 快速比较 |
diff <a> <b> | 详细差异对比 |
scan <dir> | 在目录中查找所有模型 |
export <model> | 导出为 JSON/CSV |
stats <dir> | 项目概览 |
manifest <model> | 文件清单(含 SHA256 校验和) |
编辑(10 条,全部自动备份)
| 命令 | 用途 |
|---|
edit-motion | 编辑动作的淡入淡出时间或文件路径 |
add-motion | 向分组添加动作 |
rm-motion | 移除动作 |
add-expr | 添加表情 |
rm-expr | 移除表情 |
edit-texture | 替换纹理路径 |
edit-model | 编辑 moc3/physics/pose/userdata |
param-edit | 编辑 .exp3.json 中的参数值 |
rename-group | 重命名动作分组 |
find-replace | 批量重命名文件引用 |
生成(3 条)
| 命令 | 用途 |
|---|
init | 生成完整的模型模板 |
gen-motion | 生成骨架 .motion3.json |
gen-expr | 生成骨架 .exp3.json |
分析(4 条)
| 命令 | 用途 |
|---|
lint | 最佳实践检查 |
runtime-check | 检查 Cubism Viewer / Web SDK / Yoyo 兼容性 |
atlas | 纹理图集分析 |
orphan | 查找未被引用的文件 |
工作流(7 条)
| 命令 | 用途 |
|---|
undo | 从自动备份中恢复 |
backup-clean | 轮换旧备份 |
restore-file | 从备份中恢复特定文件 |
batch | 批量编辑多个模型 |
snapshot | 生成 HTML 预览 |
watch | 文件更改时自动验证 |
flatten | 扁平化目录以用于部署 |
其他(3 条)
| 命令 | 用途 |
|---|
migrate | 模型格式版本升级 |
pack | 将模型 + 依赖打包为 zip |
yoyo-check | 检查 Yoyo 桌面宠物就绪状态 |
所有读取命令均支持 --json。编辑命令自动备份。
示例
cli-anything-live2d inspect model.model3.json
cli-anything-live2d lint model.model3.json --level info
cli-anything-live2d edit-motion model.model3.json -g Idle -i 0 --fade-in 0.3
cli-anything-live2d find-replace model.model3.json -f "old_tex" -f "new_tex"
cli-anything-live2d orphan model.model3.json
cli-anything-live2d runtime-check model.model3.json --target web-sdk
cli-anything-live2d flatten model.model3.json --out-dir ./deploy/
cli-anything-live2d batch ./models/ --set-fade-in 0.3 --dry-run
cli-anything-live2d snapshot model.model3.json --embed
cli-anything-live2d stats ./project/