关于 cli-anything-live2d
cli-anything-live2d 是用于检查、编辑、验证和打包 Live2D Cubism 模型的命令行工具,无需 Live2D Editor。它面向模型创作者及资源工作流,涵盖分析、批量修改、生成和部署准备。
主要功能
- 01检查模型结构与资源
- 02编辑动作、表情和纹理
- 03执行 lint 与运行时兼容性检查
- 04批量编辑模型并追踪变更
- 05生成模板并打包资源
适用场景
- 01检查模型文件及其依赖
- 02对多个模型应用编辑
- 03准备模型资源以供部署
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ hkuds/ cli-anything --skill cli-anything-live2d安装后在 Claude Code 中输入/cli-anything-live2d确认已加载。
详细介绍
cli-anything-live2d
面向 Live2D Cubism 模型的全功能命令行工具。42 条命令,涵盖检查、编辑、lint、diff、批量操作、资源管理、生成和部署——无需 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> | 详细 diff |
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/
评论
支持 Markdown