SuperAPI AI 工具集

cli-anything-live2d

设计与创作

查看项目

更新于 10-15 12:23

技能介绍

cli-anything-live2d 是一个功能完整的 Live2D Cubism 模型命令行工具,共包含 42 条命令,覆盖检查、编辑、lint、diff、批量操作、资源管理、生成和部署,全部无需 Live2D Editor 即可完成。

用途 该工具用于从命令行对 Live2D Cubism 模型(.model3.json)进行查看、校验、修改、质量检查、版本对比、批量处理与部署准备,适合需要在编辑器之外自动化处理模型文件的场景。

主要能力 读取类命令(18 条):inspect 查看模型概览(版本、数量、特性);validate 检查所有引用文件是否存在;motions 列出动作及淡入时间;motion-info 分析单个动作文件;expressions 列出表情预设;expr-info 分析单个表情文件;textures 列出纹理及尺寸大小;physics 查看物理模拟配置;moc3 查看 Moc3 二进制信息;params 查看参数组;param-list 列出动作/表情中的全部参数;deps 查看依赖图;compare 快速比较两个模型;diff 详细对比;scan 扫描目录中所有模型;export 导出为 JSON/CSV;stats 查看项目概览;manifest 生成带 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/

适用场景 适用于需要在不打开 Live2D Editor 的情况下检查、校验、批量修改、对比、打包或部署 Live2D Cubism 模型的工作流,例如模型资源管理、部署前检查、批量参数调整、兼容性验证等。

限制 资料未提供该工具的安装方式、运行环境要求、收费模式、价格、平台支持及具体效果说明,这些信息暂未提供。