cli-anything-live2d 是做什麼的？
功能完整的 CLI 工具，用於 Live2D Cubism 模型。42 個指令涵蓋檢查、編輯、lint、比對、批次操作、資產管理、生成及部署——全部無需 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/