Mika Live2D Handoff
正式 Mika Live2D 尚未交付前，LearnMore 會繼續使用 mao_pro；未完成的 Mika preview 只保留在本站 handoff 作為製作參考。此頁整理製作者需要的工單、交付範本與驗證方式。
mika_live2dfalsetruetruefalsesource120260617-mika-motion05Delivery Readiness 摘要
file plan：29/29 ready，present 29，missing 0，blocked 0。
缺檔 id：-
阻擋 id：-
主要阻擋原因：
- 目前沒有交付阻擋原因。
Source Review Progress 摘要
sourceReviewLedgerReady：false，ready：false，sourceConfirmed：false。
review rows：0/0 complete，missingEvidence 0，manual merge 0，unchanged review 0。
evidence workspace：false，workspace rows 0/0，evidence items 0/0 captured，missing 0。
下一個 source review pass：-。Ledger：JSON / Markdown。Evidence validation：JSON / Markdown
| step | layer | group | pass | status | required | captured | missing |
|---|---|---|---|---|---|---|---|
| 目前沒有 source review next row。 | |||||||
Mika Live2D Motion Quality Audit
status：ready-for-cubism-authoring，strictReady：false，auditOnly：true。
Mika motions：7 支，curve count 4～52，平均 13.57；低於最低門檻 7 支。
參考 mao_pro：curve count 132～132，平均 132。報告：JSON / Markdown。
| group | file | curves | min | gap | status |
|---|---|---|---|---|---|
idle |
idle.motion3.json |
4 |
80 |
76 |
curve-count-below-minimum |
greeting |
greeting.motion3.json |
4 |
90 |
86 |
curve-count-below-minimum |
lyric-reading |
lyric-reading.motion3.json |
5 |
80 |
75 |
curve-count-below-minimum |
point-lyrics |
point-lyrics.motion3.json |
8 |
100 |
92 |
curve-count-below-minimum |
rhythm-sway |
rhythm-sway.motion3.json |
15 |
100 |
85 |
curve-count-below-minimum |
chorus-gesture |
chorus-gesture.motion3.json |
7 |
110 |
103 |
curve-count-below-minimum |
soft-dance-loop |
soft-dance-loop.motion3.json |
52 |
120 |
68 |
curve-count-below-minimum |
交付里程碑
下一個里程碑：。此表依製作階段整理，讓製作者先補目前最前面的阻擋項目。
| id | 階段 | 狀態 | ready | 缺檔 | 阻擋 |
|---|---|---|---|---|---|
runtime |
Live2D runtime export | ready | 8/8 |
- |
- |
source |
Layered source and part map | ready | 5/5 |
- |
- |
expressions |
Model-native expressions | ready | 2/2 |
- |
- |
motions |
Model-native motions | ready | 2/2 |
- |
- |
parameters |
Mao-pro-compatible parameter map | ready | 2/2 |
- |
- |
license |
License, source, and attribution | ready | 3/3 |
- |
- |
acceptance |
Desktop and mobile acceptance | ready | 3/3 |
- |
- |
Delivery Gap 摘要
ready：false，nextMilestone：source，LearnMore 維持 mao_pro，canSwitchToLive2D：false。
Runtime 缺檔：-
Source 缺檔：-
Source blocked：-
嘴型 DisplayInfo 缺參數：-
動作 DisplayInfo 缺參數：-
Production Intake Checklist 摘要
此表把目前要交給製作者的 runtime、source、expressions、motions、parameters 與 acceptance 六包工作壓成可操作清單；未全數完成前 LearnMore 維持 mao_pro。
ready：false，topPriorityPackage：source，nextMilestone：source，remaining：1。
| package | state | owner | missing | blocked |
|---|---|---|---|---|
runtime |
ready | Live2D runtime exporter | - |
- |
source |
blocked | Live2D character artist / Cubism rigger | - |
- |
expressions |
ready | Live2D rigger | - |
- |
motions |
ready | Live2D motion designer | - |
- |
parameters |
ready | Live2D technical rigger | - |
- |
acceptance |
ready | LearnMore QA reviewer | - |
- |
Source Authoring Sheet 摘要
此表由 PSD_LAYER_MANIFEST.json、PARTS_MAP.json、RIGGING_SPEC.json 與 PARAMETER_MAP.json 產生，讓繪師與建模師照實際契約拆 source，而不是照靜態預覽圖猜。
requiredLayerCount：157，highRiskLayerCount：104，sourceConfirmedLayerCount：157。
| group | layers | occluded fill | mouth | physics | pose |
|---|---|---|---|---|---|
face |
15 |
1 |
0 |
0 |
0 |
eyes |
26 |
6 |
0 |
0 |
0 |
mouth |
9 |
2 |
9 |
0 |
0 |
hair |
32 |
23 |
0 |
31 |
0 |
body |
5 |
2 |
0 |
0 |
0 |
arms |
22 |
20 |
0 |
0 |
20 |
legs |
16 |
14 |
0 |
0 |
14 |
clothesAccessories |
32 |
14 |
0 |
18 |
0 |
Image2 Repair Plan 摘要
這份 queue 只針對 needsOccludedFill=true 的缺少/遮擋部位圖產生 image2 補圖任務；生成圖必須跟原本 Mika 參考圖一致，驗收前不會讓 sourceConfirmed 變成 true。
image2GenerationAllowed：true，repairTargetCount：82，missingImage2OutputCount：0，image2RepairReady：true。
| group | targets | generated | accepted | layers |
|---|---|---|---|---|
mouth |
2 |
2 |
2 |
mouth_lower_skin_cover, mouth_upper_skin_cover |
eyes |
6 |
6 |
6 |
eye_L_iris, eye_L_teary_highlight, eye_L_white, eye_R_iris, eye_R_teary_highlight, eye_R_white |
face |
1 |
1 |
1 |
face_base |
arms |
20 |
20 |
20 |
arm_L_lower, arm_L_upper, arm_R_lower, arm_R_upper, hand_L, hand_R, index_L, index_R, middle_L, middle_R, pinky_L, pinky_R, ring_L, ring_R, shoulder_L, shoulder_R, thumb_L, thumb_R, wrist_L, wrist_R |
legs |
14 |
14 |
14 |
ankle_L, ankle_R, heel_L, heel_R, knee_L, knee_R, leg_L_lower, leg_L_upper, leg_R_lower, leg_R_upper, shoe_L, shoe_R, toe_L, toe_R |
clothesAccessories |
14 |
14 |
14 |
skirt_front_C_left, skirt_front_C_right, skirt_front_L_pleat, skirt_front_R_pleat, skirt_hem_C, skirt_hem_L, skirt_hem_R, skirt_side_L_fold, skirt_side_R_fold, sleeve_L_cuff, sleeve_R_cuff, skirt_back_C, skirt_back_L, skirt_back_R |
hair |
23 |
23 |
23 |
hair_back_C, hair_back_C_lower, hair_back_C_upper, hair_back_L, hair_back_L_lower, hair_back_L_upper, hair_back_R, hair_back_R_lower, hair_back_R_upper, hair_back_strand_L, hair_back_strand_R, hair_front_C_left, hair_front_C_right, hair_front_L_inner, hair_front_L_outer, hair_front_R_inner, hair_front_R_outer, hair_side_L_lower, hair_side_L_upper, hair_side_R_lower, hair_side_R_upper, hair_tip_L, hair_tip_R |
body |
2 |
2 |
2 |
neck, torso |
Image2 Repair Workspace 摘要
這份工作區只準備 image2 輸入素材：共用 reference bitmap、每層 alpha mask PNG、prompt 與 metadata；正式修補圖仍必須另外產出到 source/image2-repair 並審核。
workspaceReady：true，bundleCount：82，bundleReadyCount：82，missingBundleCount：0，image2OutputCount：82。
workspaceDir：deliveries/mika-live2d/source/image2-workspace
| group | bundles | ready | missing | layers |
|---|---|---|---|---|
mouth |
2 |
2 |
0 |
mouth_lower_skin_cover, mouth_upper_skin_cover |
eyes |
6 |
6 |
0 |
eye_L_iris, eye_L_teary_highlight, eye_L_white, eye_R_iris, eye_R_teary_highlight, eye_R_white |
face |
1 |
1 |
0 |
face_base |
arms |
20 |
20 |
0 |
arm_L_lower, arm_L_upper, arm_R_lower, arm_R_upper, hand_L, hand_R, index_L, index_R, middle_L, middle_R, pinky_L, pinky_R, ring_L, ring_R, shoulder_L, shoulder_R, thumb_L, thumb_R, wrist_L, wrist_R |
legs |
14 |
14 |
0 |
ankle_L, ankle_R, heel_L, heel_R, knee_L, knee_R, leg_L_lower, leg_L_upper, leg_R_lower, leg_R_upper, shoe_L, shoe_R, toe_L, toe_R |
clothesAccessories |
14 |
14 |
0 |
skirt_front_C_left, skirt_front_C_right, skirt_front_L_pleat, skirt_front_R_pleat, skirt_hem_C, skirt_hem_L, skirt_hem_R, skirt_side_L_fold, skirt_side_R_fold, sleeve_L_cuff, sleeve_R_cuff, skirt_back_C, skirt_back_L, skirt_back_R |
hair |
23 |
23 |
0 |
hair_back_C, hair_back_C_lower, hair_back_C_upper, hair_back_L, hair_back_L_lower, hair_back_L_upper, hair_back_R, hair_back_R_lower, hair_back_R_upper, hair_back_strand_L, hair_back_strand_R, hair_front_C_left, hair_front_C_right, hair_front_L_inner, hair_front_L_outer, hair_front_R_inner, hair_front_R_outer, hair_side_L_lower, hair_side_L_upper, hair_side_R_lower, hair_side_R_upper, hair_tip_L, hair_tip_R |
body |
2 |
2 |
0 |
neck, torso |
Image2 Candidate Review 摘要
這份審查只確認 image2 候選圖狀態與 cleanup queue；它不會讓 sourceConfirmed 變成 true，也不會把未完成的 Mika 放到 LearnMore。
ready：true，candidateCount：82，outputCount：82，acceptedCount：82，needsCleanupCount：0，sourceAcceptanceReady：false。
01-mouth-face-eyes：9layers02-pose：34layers03-physics-final：39layers
| group | candidates | outputs | accepted | needs cleanup |
|---|---|---|---|---|
mouth |
2 |
2 |
2 |
0 |
eyes |
6 |
6 |
6 |
0 |
face |
1 |
1 |
1 |
0 |
arms |
20 |
20 |
20 |
0 |
legs |
14 |
14 |
14 |
0 |
clothesAccessories |
14 |
14 |
14 |
0 |
hair |
23 |
23 |
23 |
0 |
body |
2 |
2 |
2 |
0 |
Image2 Cleanup Work Order 摘要
這份工作單只列出需要重畫/整理的候選圖，並用 reference crop 對照 image2 candidate；它是正式 source cleanup 的工作順序，不代表可直接上線。
ready：false，cleanupRequired：true，cleanupLayerCount：0，cleanupPassCount：4，sourceAcceptanceReady：false。
01-fragmented-hands：0layers02-hair-physics-strands：0layers03-skirt-cloth-physics：0layers04-neck-torso-source：0layers
| pass | owner | layers | layer ids |
|---|---|---|---|
01-fragmented-hands |
Live2D source artist | 0 |
- |
02-hair-physics-strands |
Live2D source artist | 0 |
- |
03-skirt-cloth-physics |
Live2D source artist | 0 |
- |
04-neck-torso-source |
Live2D source artist | 0 |
- |
Image2 Cleanup Workspace 摘要
這份工作區把 cleanup work order 拆成 39 個 image2 清理 bundle，每包含 candidate bitmap、crop、alpha mask、preview、prompt 與 metadata；這仍是製作用資料，不代表可直接上線。
workspaceReady：false，bundleCount：0，bundleReadyCount：0，missingBundleCount：0，sourceAcceptanceReady：false。
workspaceDir：deliveries/mika-live2d/source/image2-cleanup-workspace
| pass | bundles | ready | missing | layer ids |
|---|---|---|---|---|
| 目前沒有 image2 cleanup workspace pass summary。 | ||||
Image2 Cleanup Validation 摘要
這份 gate 會檢查每個 cleanup bundle 的透明像素量、alpha 強度、bbox 面積與 canvas，避免把近乎空白或太淡的候選圖誤收進 Cubism source。
cleanupValidationReady：false，validatedBundleCount：0，reviewableBundleCount：0，blockedBundleCount：0，regenerateRequiredCount：0。
必須重生 image2：-
| pass | bundles | reviewable | blocked | blocked layer ids |
|---|---|---|---|---|
| 目前沒有 image2 cleanup validation pass summary。 | ||||
Image2 Cleanup Visual Review 摘要
這份 gate 會檢查 cleanup candidate/crop 都是 PNG bitmap、canvas 沒被裁切、metadata 明確禁止 SVG，並只允許進 source cleanup review，不會直接通過 source acceptance。
cleanupVisualReviewReady：false，sourceCleanupReady：false，reviewReadyCount：0，blockedCount：0，sourceAcceptanceReady：false。
blocked layers：-
| pass | bundles | review ready | blocked | blocked layer ids |
|---|---|---|---|---|
| 目前沒有 image2 cleanup visual review pass summary。 | ||||
Source Cleanup Staging 摘要
這份 gate 把 visual review 通過的 bitmap 候選圖對應回 PSD_LAYER_MANIFEST.json 的 expectedPsdPath 與 draft layer 檔案；它只代表可以進 source merge，不代表 Mika 已完成。
sourceCleanupStagingReady：false，readyRowCount：0，blockedRowCount：0，changedDraftLayerCount：0，sourceAcceptanceReady：false，sourceConfirmed：false。
blocked layers：-
| pass | rows | ready | blocked | changed draft layers | blocked layer ids |
|---|---|---|---|---|---|
| 目前沒有 source cleanup staging pass summary。 | |||||
Source Cleanup Merge Preview 摘要
這份 preview 會把 staging 通過的 bitmap 候選圖寫到獨立 replacement layer 目錄，供人工合併到 PSD/Cubism source；它不覆蓋 source/draft-layers，也不代表 source acceptance。
mergePreviewReady：false，replacementLayerCount：0，readyRowCount：0，blockedRowCount：0，changedDraftLayerCount：0，sourceAcceptanceReady：false，sourceConfirmed：false。
replacementLayerDir：deliveries/mika-live2d/source/source-cleanup-merge-preview/replacement-layers
| pass | rows | ready | blocked | replacements | changed |
|---|---|---|---|---|---|
| 目前沒有 source cleanup merge preview pass summary。 | |||||
Source Acceptance Preflight 摘要
這份 preflight 只確認 replacement PNG、PSD_LAYER_MANIFEST.json 與現有 draft source layer 可以互相追溯；它不把 sourceConfirmed 改成 true，也不代表 Mika 可以放到 LearnMore。
sourceAcceptancePreflightReady：false，manualMergeGateReady：false，manualMergeRequiredCount：0，unchangedPreviewLayerCount：0，blockedRowCount：0，sourceConfirmedLayerCount：157，sourceAcceptanceReady：false。
LearnMore 維持：mao_pro
| pass | rows | ready | blocked | manual merge | unchanged |
|---|---|---|---|---|---|
| 目前沒有 source acceptance preflight pass summary。 | |||||
Source Merge Work Order 摘要
這份工作單列出 PSD/Cubism source 的人工合併順序：merge-replacement 需要實際合併 replacement PNG，review-unchanged 只需比對並記錄不用替換的理由。它不會修改 sourceConfirmed。
sourceMergeWorkOrderReady：false，mergeReplacementCount：0，reviewUnchangedCount：0，blockedRowCount：0，sourceAcceptanceReady：false，sourceConfirmed：false。
LearnMore 維持：mao_pro
| pass | rows | merge | review | blocked |
|---|---|---|---|---|
| 目前沒有 source merge work order pass summary。 | ||||
Source Merge Workspace 摘要
這份 workspace 將 source merge work order 拆成逐層 metadata.json 與 checklist.md。它只代表人工作業包已準備好，不代表 PSD/Cubism source 已合併完成。
sourceMergeWorkspaceReady：false，workspaceReadyRowCount：0，missingWorkspaceRowCount：0，sourceAcceptanceReady：false，sourceConfirmed：false。
workspace：deliveries/mika-live2d/source/source-merge-workspace，LearnMore 維持：mao_pro
| pass | rows | ready | missing | merge | review |
|---|---|---|---|---|---|
| 目前沒有 source merge workspace pass summary。 | |||||
Source Merge Application 摘要
這份 application candidate 會把 source merge workspace 的輸出套到獨立 applied-layers 目錄：merge-replacement 複製 replacement PNG，review-unchanged 保留原 draft layer。它不覆蓋正式 draft-layers，也不讓 Mika 進 LearnMore。
sourceMergeApplicationReady：false，appliedReadyRowCount：0，blockedRowCount：0，appliedReplacementCount：0，retainedDraftCount：0，sourceAcceptanceReady：false，sourceConfirmed：false。
appliedLayerDir：deliveries/mika-live2d/source/source-merge-application/applied-layers，manifestPatchFile：deliveries/mika-live2d/source/source-merge-application/SOURCE_MERGE_APPLICATION.json，LearnMore 維持：mao_pro
| pass | rows | ready | blocked | replacement | retained |
|---|---|---|---|---|---|
| 目前沒有 source merge application pass summary。 | |||||
Source Acceptance Package 摘要
這份 package 把已套用的 applied-layers 固定成 Cubism source review 輸入：需要合併的層標成 manual-cubism-merge，保留原圖的層標成 review-unchanged-source。它仍不會把 sourceConfirmed 改成 true。
sourceAcceptancePackageReady：false，packageReadyRowCount：0，blockedRowCount：0，manualCubismMergeRequiredCount：0，unchangedSourceReviewRequiredCount：0，sourceAcceptanceReady：false，sourceConfirmed：false。
packageManifestFile：deliveries/mika-live2d/source/source-acceptance-package/SOURCE_ACCEPTANCE_PACKAGE.json，LearnMore 維持：mao_pro
| pass | rows | ready | blocked | Cubism merge | unchanged review |
|---|---|---|---|---|---|
| 目前沒有 source acceptance package pass summary。 | |||||
Cubism Source Review Workspace 摘要
這份 workspace 會替 source acceptance package 的每一層產生 checklist.md 與 metadata.json，用來逐層進行 editable PSD/Cubism source review。它只建立審查工作區，不會把 sourceConfirmed 或 sourceAcceptanceReady 改成 true。
cubismSourceReviewWorkspaceReady：false，reviewWorkspaceReadyRowCount：0，missingReviewWorkspaceRowCount：0，manualCubismMergeRequiredCount：0，unchangedSourceReviewRequiredCount：0，sourceAcceptanceReady：false，sourceConfirmed：false。
reviewWorkspaceDir：deliveries/mika-live2d/source/cubism-source-review-workspace，LearnMore 維持：mao_pro
| pass | rows | ready | missing | Cubism merge | unchanged review |
|---|---|---|---|---|---|
| 目前沒有 Cubism source review workspace pass summary。 | |||||
Cubism Source Review Ledger 摘要
這份 ledger 會追蹤每層 Cubism source review 的 reviewer、result、evidence files 與完成狀態。它是手動審查台帳，不會把 sourceConfirmed 改成 true，也不會讓 Mika 進 LearnMore。
sourceReviewLedgerReady：false，reviewCompleteRowCount：0，incompleteReviewRowCount：0，missingEvidenceRowCount：0，pendingManualCubismMergeCount：0，pendingUnchangedSourceReviewCount：0，sourceConfirmed：false。
ledgerFile：deliveries/mika-live2d/source/cubism-source-review-ledger/SOURCE_REVIEW_LEDGER.json，LearnMore 維持：mao_pro
| pass | rows | pending merge | pending unchanged | complete | evidence |
|---|---|---|---|---|---|
| 目前沒有 Cubism source review ledger pass summary。 | |||||
Cubism Source Review Evidence Workspace 摘要
這份 evidence workspace 會替每一層 source review 建立 README.md 與 review-notes.md，用來收集 Cubism source preview、ArtMesh 確認與 reviewer notes。它只建立證據收集位置，不會把 sourceConfirmed 改成 true。
evidenceWorkspaceReady：false，evidenceWorkspaceReadyRowCount：0，missingEvidenceWorkspaceRowCount：0，requiredEvidenceItemCount：0，missingEvidenceItemCount：0，pendingManualCubismMergeCount：0，pendingUnchangedSourceReviewCount：0，sourceConfirmed：false。
evidenceWorkspaceDir：deliveries/mika-live2d/source/cubism-source-review-evidence-workspace，LearnMore 維持：mao_pro
| pass | rows | workspace ready | missing workspace | required evidence | captured evidence | pending merge |
|---|---|---|---|---|---|---|
| 目前沒有 Cubism source review evidence workspace pass summary。 | ||||||
Cubism Source Review Evidence Validation 摘要
這份 validation 會掃描 evidence workspace 裡實際存在的證據檔，例如 source-preview-screenshot.png、cubism-artmesh-confirmation.png 與 review notes。它只驗證證據是否存在，不會把 sourceConfirmed 改成 true。
evidenceValidationReady：false，evidenceCompleteRowCount：0，missingEvidenceRowCount：0，requiredEvidenceItemCount：0，capturedEvidenceItemCount：0，missingEvidenceItemCount：0，sourceConfirmed：false。
LearnMore 維持：mao_pro
| pass | rows | complete | missing rows | required evidence | captured evidence | missing evidence |
|---|---|---|---|---|---|---|
| 目前沒有 Cubism source review evidence validation pass summary。 | ||||||
Cubism Source Review Evidence Capture Work Order 摘要
這份 work order 把 validation 中缺少的證據拆成實際 capture task，指定每個任務的 owner、證據檔名與驗收規則。它只排程真實證據捕捉，不產生假截圖，也不會把 sourceConfirmed 改成 true。
evidenceCaptureWorkOrderReady：true，captureTaskCount：0，capturedTaskCount：0，missingTaskCount：0，sourceConfirmed：false。
LearnMore 維持：mao_pro
| pass | tasks | captured | missing | layers |
|---|---|---|---|---|
| 目前沒有 Cubism source review evidence capture work order pass summary。 | ||||
Cubism Source Review Evidence Capture Package 摘要
這份 package 會把 capture work order 輸出成任務清單、CSV、每筆 TASK.md 與 CAPTURE_TEMPLATE.md。這些檔案只是捕捉指引，不算正式證據，也不會讓 sourceConfirmed 變成 true。
evidenceCapturePackageReady：true，expectedPackageFileCount：3，readyPackageFileCount：3，captureTaskCount：0，packageReadyTaskCount：0，countsAsEvidenceTaskCount：0。
capturePackageDir：deliveries/mika-live2d/source/cubism-source-review-evidence-capture-package，sourceConfirmed：false，LearnMore 維持：mao_pro
| task | layer | evidence | task file | template | expected evidence |
|---|---|---|---|---|---|
| 目前沒有 Cubism source review evidence capture package tasks。 | |||||
Cubism Source Review Evidence Capture Batch Plan 摘要
這份 batch plan 把 115 個 capture package task 分成可逐批執行的 source review 批次，第一批先處理 neck 與 torso。它只是排程，不算正式 evidence，也不會讓 sourceConfirmed 變成 true。
evidenceCaptureBatchPlanReady：true，batchCount：4，assignedTaskCount：0，unassignedTaskCount：0，captureTaskCount：0，countsAsEvidenceTaskCount：0。
sourceConfirmed：false，LearnMore 維持：mao_pro
| batch | priority | title | tasks | missing | layers |
|---|---|---|---|---|---|
batch-01-neck-torso-foundation |
1 |
neck and torso foundation source review | 0 |
0 |
|
batch-02-skirt-sleeve-cloth |
2 |
skirt and sleeve cloth source review | 0 |
0 |
|
batch-03-back-hair-physics |
3 |
back hair physics strand source review | 0 |
0 |
|
batch-04-front-side-hair-physics |
4 |
front and side hair physics source review | 0 |
0 |
|
| task | layer | evidence | owner | expected evidence |
|---|---|---|---|---|
| 目前沒有第一批 Cubism source review evidence capture tasks。 | ||||
Cubism Source Review Evidence Batch 01 Execution Package 摘要
這份 Batch 01 execution package 只針對第一批 neck 與 torso 建立執行 checklist、任務清單與 review note template。它是人工作業入口，不算正式 evidence，也不會讓 sourceConfirmed 變成 true。
batch01ExecutionPackageReady：true，expectedPackageFileCount：3，readyPackageFileCount：3，layerPacketCount：0，captureTaskCount：0，missingEvidenceTaskCount：0，countsAsEvidenceTaskCount：0。
sourceConfirmed：false，LearnMore 維持：mao_pro
| layer packet | tasks | present evidence | missing evidence | checklist | template |
|---|---|---|---|---|---|
| 目前沒有第一批 Cubism source review evidence execution layer packets。 | |||||
Cubism Source Review Evidence Batch 02 Execution Package 摘要
這份 Batch 02 execution package 針對裙襬與袖口 cloth layers 建立執行 checklist、任務清單與 review note template。它只整理目前仍需人工 Cubism 補證據的項目，不算正式 evidence，也不會讓 sourceConfirmed 變成 true。
batch02ExecutionPackageReady：true，expectedPackageFileCount：3，readyPackageFileCount：3，layerPacketCount：0，captureTaskCount：0，missingEvidenceTaskCount：0，countsAsEvidenceTaskCount：0。
sourceConfirmed：false，LearnMore 維持：mao_pro
| layer packet | tasks | present evidence | missing evidence | checklist | template |
|---|---|---|---|---|---|
| 目前沒有第二批 Cubism source review evidence execution layer packets。 | |||||
Cubism Source Review Evidence Batch 03 Execution Package 摘要
這份 Batch 03 execution package 針對後髮 back hair physics strands 建立執行 checklist、任務清單與 review note template。它只整理目前仍需人工 Cubism 補證據的項目，不算正式 evidence，也不會讓 sourceConfirmed 變成 true。
batch03ExecutionPackageReady：true，expectedPackageFileCount：3，readyPackageFileCount：3，layerPacketCount：0，captureTaskCount：0，missingEvidenceTaskCount：0，countsAsEvidenceTaskCount：0。
sourceConfirmed：false，LearnMore 維持：mao_pro
| layer packet | tasks | present evidence | missing evidence | checklist | template |
|---|---|---|---|---|---|
| 目前沒有第三批 Cubism source review evidence execution layer packets。 | |||||
Cubism Source Review Evidence Batch 04 Execution Package 摘要
這份 Batch 04 execution package 針對前髮與側髮 front/side hair physics layers 建立目前仍缺的 ArtMesh confirmation checklist、任務清單與 review note template。它只整理待人工 Cubism 補證據的項目，不算正式 evidence，也不會讓 sourceConfirmed 變成 true。
batch04ExecutionPackageReady：true，expectedPackageFileCount：3，readyPackageFileCount：3，layerPacketCount：0，captureTaskCount：0，missingEvidenceTaskCount：0，countsAsEvidenceTaskCount：0。
sourceConfirmed：false，LearnMore 維持：mao_pro
| layer packet | tasks | present evidence | missing evidence | checklist | template |
|---|---|---|---|---|---|
| 目前沒有第四批 Cubism source review evidence execution layer packets。 | |||||
Cubism Source Review Evidence Batch 01 Draft Captures 摘要
這份 draft capture package 會從目前 source merge applied layer 產生候選 preview、ArtMesh planning overlay 與 editable note draft。它刻意放在 formal evidence workspace 之外，因此 validation 不會把它當成正式 evidence。
draftCaptureReady：false，layerCaptureCount：0，draftCaptureFileCount：0，formalEvidenceWriteCount：0，countsAsEvidenceTaskCount：0。
sourceConfirmed：false，LearnMore 維持：mao_pro
| layer | ready | preview | artmesh | note | formal evidence dir |
|---|---|---|---|---|---|
| 目前沒有第一批 Cubism source review evidence draft captures。 | |||||
Cubism Source Review Evidence Batch 01 Promotion Preflight 摘要
這份 preflight 只把 draft capture 對應到正式 evidence 目標檔名，方便人工 Cubism reviewer 接手；它不會複製檔案進 formal evidence workspace，也不會更新 ledger。
promotionPreflightReady：false，readyForHumanReviewLayerCount：0，promotionReadyLayerCount：0，formalEvidenceTargetCount：0，presentFormalEvidenceCount：0，missingFormalEvidenceCount：0。
promotionReady：false，formalEvidenceWriteCount：0，sourceConfirmed：false，LearnMore 維持：mao_pro
| layer | ready for human review | promotion ready | present formal evidence | missing formal evidence | formal evidence dir |
|---|---|---|---|---|---|
| 目前沒有第一批 Cubism source review evidence promotion preflight rows。 | |||||
Cubism Rigging Work Order 摘要
此表由 RIGGING_SPEC.json 產生，列出 Cubism 需要建立的 deformer、ArtMesh、parameter keyform、expression 與 motion 輸出，確保正式 Mika 跟 mao_pro 一樣由模型參數驅動。
riggingGroupCount：8，artMeshTargetCount：157，parameterKeyformCount：68，expressionOutputCount：9，motionOutputCount：7。
| group | parts | deformers | artMeshes | keyforms | physics |
|---|---|---|---|---|---|
face |
15 |
2 |
15 |
6 |
0 |
eyes |
26 |
2 |
26 |
8 |
0 |
mouth |
9 |
2 |
9 |
6 |
0 |
hair |
32 |
2 |
32 |
14 |
5 |
body |
5 |
2 |
5 |
4 |
0 |
arms |
22 |
2 |
22 |
12 |
0 |
legs |
16 |
2 |
16 |
9 |
0 |
clothesAccessories |
32 |
2 |
32 |
9 |
1 |
Runtime Export Work Order 摘要
此表由 RUNTIME_MODEL_CONTRACT.json、EXPRESSION_MAP.json、MOTION_MAP.json 與 OLV model3/model_dict 範例產生，鎖定正式 Mika 匯出後的 runtime 目錄與 model3 FileReferences。
requiredFileGroupCount：8，displayInfoRequiredParameterCount：59，expressionOutputCount：9，motionOutputCount：7，OLV model：mika_live2d。
| group | path | model3 reference | 狀態 | count |
|---|---|---|---|---|
runtimeModelJson |
runtime/mika_live2d.model3.json |
root |
present | 1 |
moc3 |
runtime/*.moc3 |
FileReferences.Moc |
present | 1 |
textures |
runtime/textures/*.{png,jpg,jpeg,webp} |
FileReferences.Textures |
present | 1 |
displayInfo |
runtime/*.cdi3.json |
FileReferences.DisplayInfo |
present | 1 |
physics |
runtime/*.physics3.json |
FileReferences.Physics |
present | 1 |
pose |
runtime/*.pose3.json |
FileReferences.Pose |
present | 1 |
expressions |
runtime/expressions/*.exp3.json |
FileReferences.Expressions |
present | 9 |
motions |
runtime/motions/*.motion3.json |
FileReferences.Motions |
present | 7 |
Acceptance Work Order 摘要
正式 Mika 交給 LearnMore 前必須完成 source merge、VISUAL_QA.json、ACCEPTANCE_CHECKLIST.md 與 acceptance/ 桌機/手機證據；未完成時 LearnMore 維持 mao_pro。
sourceGate.ready：false，sourceConfirmed：false，sourceMergeWorkOrderReady：false，source merge replacement：0。
ready：false，visualQa.ready：true，acceptanceChecklist.ready：true，acceptanceMedia.ready：true，reviewedMediaCount：2。
missingTargets：-，incompleteChecks：0，blockingReasonCount：3。
| required field | 狀態 |
|---|---|
visualQa.ready |
ready |
acceptanceChecklist.ready |
ready |
acceptanceMedia.ready |
ready |
sourceGate.ready |
blocked |
deliveryReadiness.ready |
ready |
Runtime Export Manifest 摘要
RUNTIME_EXPORT_MANIFEST.json 會記錄正式 Cubism 匯出的每個 runtime 檔案、model3 FileReferences 對應、檔案大小與 sha256。此清單通過格式驗證不代表可上線；必須填入實際檔案並清空 blockingReasons 後，delivery gate 才會放行。
confirmedAgainstCubismExport：true，confirmedAgainstModel3：true，files：8，DisplayInfo parameters：59，expressions：9，motions：7。
manifest：/mika-avatar/handoff/mika-live2d/runtime-export-manifest.json / schema：/mika-avatar/handoff/mika-live2d/runtime-export-manifest.schema.json
目前阻擋原因：
- 目前沒有 runtime export manifest 阻擋原因。
| id | kind | path | model3 reference | size | sha256 |
|---|---|---|---|---|---|
runtimeModelJson |
model3 |
runtime/mika_live2d.model3.json |
root |
2593 |
3d4fd8ab379d85a1a37132f4322092f9df1dc32d1ef124d81e0eb6aded5e10d5 |
moc3 |
moc3 |
runtime/mika_live2d.moc3 |
FileReferences.Moc |
9728 |
1edda03bd0bf5d8dec26ae7df917984970906d49f3ec9d829d8cd6f065468a61 |
textures |
texture |
runtime/textures/texture_00.png |
FileReferences.Textures |
428613 |
95aa4a632a336e84ed148c1464af1a98e71176302b62090ca5a5b91179c26523 |
displayInfo |
displayInfo |
runtime/mika_live2d.cdi3.json |
FileReferences.DisplayInfo |
6405 |
87d6b3bdc12ec385e16c5033fcdbeb658afa8b6e1805427f9d6a12192e307f29 |
physics |
physics |
runtime/mika_live2d.physics3.json |
FileReferences.Physics |
1568 |
76c8c813677702c8b04af42deba7292ddc8599cbe5080b98ce8e8b2813a0260b |
pose |
pose |
runtime/mika_live2d.pose3.json |
FileReferences.Pose |
141 |
4b6853ee9f8a80accd3beee58a7db9295626f8b47c26bff3b2b85561c650ef8d |
expressions |
expression |
runtime/expressions/a.exp3.json |
FileReferences.Expressions |
274 |
089aa8e97d7b3251a14151c457981e820431306e0fcc5f4035fd06586f4d7fcc |
motions |
motion |
runtime/motions/idle.motion3.json |
FileReferences.Motions |
1077 |
4c89413e19a3b2cf4ab2766349be7a3bdbf3b3f75ff73b31a0fe27b84d6d0c2c |
交付範本
- 檔名：
mika-live2d-delivery-template.zip - 大小：
74021bytes - sha256：
2bb197ad475c9e226a55e4e78bc2aed63933f3c33efc888de5a65ebbf9479b73 - 下載：
/mika-avatar/handoff/mika-live2d-delivery-template.zip
製作隊列
| 項目 | 狀態 | 缺檔 | Blocked | 下一步 |
|---|---|---|---|---|
runtime |
完成 | - |
- |
export Cubism runtime model3.json, moc3, textures, DisplayInfo, Physics, and Pose |
source |
阻擋 | - |
- |
prepare layered Mika art source and editable Cubism project |
expressions |
完成 | - |
- |
produce a/i/u/e/o mouth shapes plus blink, smile, surprised, and thinking expressions |
motions |
完成 | - |
- |
produce idle, lyric reading, pointing, rhythm sway, chorus gesture, and soft dance motions |
parameters |
完成 | - |
- |
confirm ParamA/I/U/E/O, ParamMouthDown, head, body, shoulder, and arm parameters in PARAMETER_MAP.json |
license |
完成 | - |
- |
finalize source ownership, usage scope, and LearnMore attribution copy |
acceptance |
完成 | - |
- |
record desktop and mobile preview media and approve LearnMore behavior |
必要嘴型與動作
嘴型 / 表情：a, i, u, e, o, blink, smile, surprised, thinking
動作：idle, greeting, lyric-reading, point-lyrics, rhythm-sway, chorus-gesture, soft-dance-loop
Runtime Map 契約
表情 map：EXPRESSION_MAP.json 必須對到 runtime/expressions 內非空檔案，且必須在 model3 Expressions 宣告。
動作 map：MOTION_MAP.json 必須對到 runtime/motions 內非空檔案，且必須在 model3 Motions 宣告。
model3 reference required：true
所有表情與動作 map 值必須同時存在於 runtime 檔案中，並在 runtime/mika_live2d.model3.json 的 FileReferences.Expressions 或 FileReferences.Motions 宣告。
Source Layer Split 契約
拆圖清單：LAYER_SPLIT_CHECKLIST.md，PSD 規格：PSD_LAYER_SPEC.md，來源 manifest：SOURCE_MANIFEST.json / /mika-avatar/handoff/mika-live2d/source-manifest.json / /mika-avatar/handoff/mika-live2d/source-manifest.schema.json，逐層 manifest：PSD_LAYER_MANIFEST.json / /mika-avatar/handoff/mika-live2d/psd-layer-manifest.json / /mika-avatar/handoff/mika-live2d/psd-layer-manifest.schema.json，部件映射：PARTS_MAP.json / /mika-avatar/handoff/mika-live2d/parts-map.json / /mika-avatar/handoff/mika-live2d/parts-map.schema.json，rigging：RIGGING_SPEC.json / /mika-avatar/handoff/mika-live2d/rigging-spec.json / /mika-avatar/handoff/mika-live2d/rigging-spec.schema.json，來源目錄：source/
可編輯來源格式：.cmo3, .psd, .clip, .kra
參考來源：https://moonku44.com/live2d-psd/, https://www.live2d.com/en/learn/sample/, https://www.facebook.com/reel/908184438905522/
畫布規則：front-facing sRGB source, long edge around 4000px or higher when full-body detail needs it
圖層整理規則：layers must be grouped by part, clearly named, non-duplicated, and cleaned for Cubism import
建模參考角色：mao_pro
Layered source must support mao_pro-like model-native Cubism parameters, not CSS or image overlays.
SOURCE_MANIFEST.json must inventory every source file with path, sizeBytes, sha256, editable/layered flags, producer, and source proof before sourceProjectReady can be true.
PSD_LAYER_MANIFEST.json must inventory every required Mika source layer id, group, PSD path, occluded-fill flag, mouth/physics/pose role, and Cubism-driven parameter set before sourceProjectReady can be true.
PARTS_MAP.json must confirm source-layer parts for face, eyes, mouth, hair, body, arms, legs, clothes/accessories, physics targets, and pose targets before sourceProjectReady can be true.
拒收來源類型：single merged illustration, static PNG standee, CSS mouth overlay, DOM motion overlay, uneditable placeholder source
| 項目 | 規則 | Release blocking |
|---|---|---|
arms-hands-separated |
左右上臂、下臂、手掌需分離，能支援指歌詞、打拍子與抬手。 | 是 |
clothes-accessories-separated |
衣服片、帽子、飾品、緞帶、垂墜物需和身體分層，能接物理或姿勢控制。 | 是 |
eyes-separated |
左右眼需拆出眼白、眼球、高光、上下眼皮、睫毛與眉毛。 | 是 |
face-base-occluded-fill |
臉部底圖需補齊被頭髮遮住的區域，方便頭髮、表情與角度變形。 | 是 |
front-facing-layered-source |
正面角色來源必須是分層 PSD/CSP/KRA 或可編輯 .cmo3，不可只交單張合併圖。 | 是 |
hair-separated |
頭髮需拆前髮、側髮、後髮、髮束與可物理晃動小件。 | 是 |
layer-hygiene |
圖層需清楚命名、無重名、無無用隱藏圖層，特殊效果需整理成 Cubism 可匯入狀態。 | 是 |
legs-shoes-separated |
左右大腿、小腿、鞋子需分離，保留日後腿部與全身動作擴充空間。 | 是 |
mao-pro-runtime-wiring |
拆圖與建模需能像 mao_pro 一樣接 model3、DisplayInfo、Physics、Pose、Expressions、Motions。 | 是 |
mouth-internals-separated |
嘴巴需拆出上下唇、牙齒、口腔、舌頭或等效內部色塊，支援 a/i/u/e/o。 | 是 |
Source Export Preflight
工具：tools/live2d/inspect_mika_live2d_source_export.py
指令：python3 tools/live2d/inspect_mika_live2d_source_export.py deliveries/mika-live2d/source
預設 source 目錄：deliveries/mika-live2d/source
必要 source 檔案群組：sourceProject, sourceManifest, psdLayerManifest, partsMap, riggingSpec
可編輯來源格式：.cmo3, .psd, .clip, .kra
必要 manifest：SOURCE_MANIFEST.json, PSD_LAYER_MANIFEST.json, PARTS_MAP.json, RIGGING_SPEC.json
必要拆圖檢查 id：arms-hands-separated, clothes-accessories-separated, eyes-separated, face-base-occluded-fill, front-facing-layered-source, hair-separated, layer-hygiene, legs-shoes-separated, mao-pro-runtime-wiring, mouth-internals-separated
必要 ready 欄位：sourceFileReady, sourceManifestConsistency.ready, manifestStatus.sourceProject.ready, manifestStatus.sourceManifest.ready, manifestStatus.psdLayerManifest.ready, manifestStatus.partsMap.ready, manifestStatus.riggingSpec.ready
拒收規則：
- single merged illustration
- static PNG standee
- uneditable placeholder source
- source files smaller than the minimum source project byte threshold
- SOURCE_MANIFEST paths, sizeBytes, or sha256 that do not match source/ files
- SOURCE_MANIFEST TODO placeholders
- unconfirmed SOURCE_MANIFEST, PSD_LAYER_MANIFEST, PARTS_MAP or RIGGING_SPEC
目前 Source Export 狀態
API：/mika-avatar/api/live2d/mika/source-export-preflight
ready：true，sourceFileReady：true，工具：tools/live2d/inspect_mika_live2d_source_export.py
sourceManifestConsistency.ready：true，sourcePackageAcceptanceGate.ready：true
目前缺檔 id：-
目前 blocked id：-
目前阻擋原因：
- 目前沒有 source export 阻擋原因。
Runtime Model 契約
契約檔：RUNTIME_MODEL_CONTRACT.json / /mika-avatar/handoff/mika-live2d/runtime-model-contract.json / /mika-avatar/handoff/mika-live2d/runtime-model-contract.schema.json
正式 Mika 的 runtime/mika_live2d.model3.json 必須是 Version: 3，並以 FileReferences 宣告 runtime 檔案。
FileReferences.Moc、FileReferences.Textures 與 FileReferences.DisplayInfo 必須指向 runtime/ 內實際存在且非空的檔案；texture 參照本身也必須是有效 PNG、JPEG 或 WebP 圖片，且符合最低貼圖尺寸。
DisplayInfo 必須是 .cdi3.json，並在 Parameters 列出 Mika 必要嘴型與動作參數，讓 LearnMore 能像 mao_pro 一樣透過模型參數驅動。
FileReferences.Expressions 必須是非空 array，且每個項目都必須有非空、非 TODO 的 Name 與可解析到 runtime 內、符合 expression schema 的 File。
FileReferences.Motions 必須是非空 object，每個群組名稱必須非空且不可為 TODO，每個群組也必須至少包含一個動作；其內每個 File 也必須能解析到 runtime 內、符合 motion schema。FileReferences.Physics 與 FileReferences.Pose 也必須宣告且檔案存在。
表情檔必須是含有非空 Parameters 陣列的 JSON object；動作檔必須是含有 Meta 與非空 Curves 陣列的 JSON object。
runtime_model_contract：all FileReferences paths must resolve to non-empty files under runtime/ and pass type-specific validation
Runtime Export Preflight
工具：tools/live2d/inspect_mika_live2d_runtime_export.py
指令：python3 tools/live2d/inspect_mika_live2d_runtime_export.py deliveries/mika-live2d/runtime
預設 runtime 目錄：deliveries/mika-live2d/runtime
必要檔案群組：runtimeModelJson, moc3, textures, displayInfo, physics, pose, expressions, motions
DisplayInfo 必要參數：ParamA, ParamI, ParamU, ParamE, ParamO, ParamMouthDown, ParamAngleX, ParamAngleY, ParamAngleZ, ParamBodyAngleX, ParamBodyAngleY, ParamBodyAngleZ, ParamAllX, ParamAllY, ParamAllRotate, ParamBreath, ParamLeftShoulderUp, ParamRightShoulderUp, ParamArmLA01, ParamArmLA02, ParamArmLA03, ParamArmRA01, ParamArmRA02, ParamArmRA03, ParamHandLA, ParamHandRA, ParamFingerL, ParamFingerR, ParamLegLA01, ParamLegLA02, ParamLegRA01, ParamLegRA02, ParamFootL, ParamFootR, ParamEyeLOpen, ParamEyeROpen, ParamEyeBallX, ParamEyeBallY, ParamEyeLSmile, ParamEyeRSmile, ParamCheek, ParamBrowLY, ParamBrowRY, ParamHairFront, ParamHairSideL, ParamHairSideR, ParamHairBack, ParamHairBackL, ParamHairBackR, ParamoHairMesh, ParamHairFrontFuwa, ParamHairSideFuwa, ParamHairBackFuwa, ParamSkirtFront, ParamSkirtSideL, ParamSkirtSideR, ParamSkirtFuwa, ParamSleeveL, ParamSleeveR
拒收規則：
- missing model3.json FileReferences
- missing DisplayInfo a/i/u/e/o mouth parameters
- missing Physics or Pose file references
- unreferenced runtime files
- empty or placeholder expression and motion files
目前 Runtime Export 狀態
API：/mika-avatar/api/live2d/mika/runtime-export-preflight
ready：true，工具：tools/live2d/inspect_mika_live2d_runtime_export.py
目前缺檔 id：-
目前缺少 DisplayInfo 參數：-
目前阻擋原因：
- 目前沒有 runtime export 阻擋原因。
驗收證據契約
VISUAL_QA.json 的 reviewedMedia 必須列出 acceptance/ 內實際存在且非空的截圖或影片。
reviewer 與 notes 必須填寫且不可為 TODO；核准後 blockingReasons 必須是空陣列。
reviewedMedia 必須同時包含 desktop, mobile 驗收證據，檔名或路徑需可辨識桌機與手機，例如 acceptance/desktop.png 與 acceptance/mobile.png。
媒體檔必須有符合副檔名的圖片或影片容器簽章；不可用文字或空白假檔改副檔名當作驗收證據。
圖片驗收媒體必須可解析尺寸且至少為 320x240，避免用縮圖或占位圖通過驗收。
Checklist：ACCEPTANCE_CHECKLIST.md 必須完成所有必要驗收項目，且每個已勾選項目同一行必須附上 acceptance/ 內實際存在的驗收媒體路徑。
模型參數契約
正式 Mika 必須填寫 PARAMETER_MAP.json / /mika-avatar/handoff/mika-live2d/parameter-map.json / /mika-avatar/handoff/mika-live2d/parameter-map.schema.json，並以 live2d-core-parameters 驅動。
嘴型參數：a=ParamA, i=ParamI, u=ParamU, e=ParamE, o=ParamO, amplitude=ParamMouthDown
動作參數：ParamAngleX, ParamAngleY, ParamAngleZ, ParamBodyAngleX, ParamBodyAngleY, ParamBodyAngleZ, ParamAllX, ParamAllY, ParamAllRotate, ParamBreath, ParamLeftShoulderUp, ParamRightShoulderUp, ParamArmLA01, ParamArmLA02, ParamArmLA03, ParamArmRA01, ParamArmRA02, ParamArmRA03, ParamHandLA, ParamHandRA, ParamFingerL, ParamFingerR, ParamLegLA01, ParamLegLA02, ParamLegRA01, ParamLegRA02, ParamFootL, ParamFootR, ParamEyeLOpen, ParamEyeROpen, ParamEyeBallX, ParamEyeBallY, ParamEyeLSmile, ParamEyeRSmile, ParamCheek, ParamBrowLY, ParamBrowRY, ParamHairFront, ParamHairSideL, ParamHairSideR, ParamHairBack, ParamHairBackL, ParamHairBackR, ParamoHairMesh, ParamHairFrontFuwa, ParamHairSideFuwa, ParamHairBackFuwa, ParamSkirtFront, ParamSkirtSideL, ParamSkirtSideR, ParamSkirtFuwa, ParamSleeveL, ParamSleeveR
confirmedInRuntimeModel必須為truecssOverlayAllowed必須為falsecssMotionAllowed必須為falseconfirmedInRuntimeModel=true時，PARAMETER_MAP.json內所有嘴型與動作參數都必須能在 runtime expressionParameters或 motionCurves中找到證據。
Parameter Driver Contract
PARAMETER_DRIVER_CONTRACT.json / /mika-avatar/handoff/mika-live2d/parameter-driver-contract.json / /mika-avatar/handoff/mika-live2d/parameter-driver-contract.schema.json 是製作端細部規格，正式 Mika 必須以 live2d-core-parameters 驅動，並維持與 mao_pro 相容的模型參數控制方式。
禁止驅動方式：dom-mouth-overlay, css-mouth-overlay, css-motion-animation
Every listed parameter must be present in runtime expression Parameters[].Id or runtime motion Curves[].Id before PARAMETER_MAP.json confirmedInRuntimeModel can be true.
Pose retarget：source.mp4 轉成 pose_record.json，最低 30 FPS，必須同步時間軸並支援全身模型。
骨架格式：docs/schemas/mika-live2d-pose-record.schema.json / /mika-avatar/handoff/mika-live2d/pose-record.schema.json，範例：pose_record.sample.json，點位格式：[x, y, confidence] normalized to source video frame。
MotionBERT 3D 骨架格式：docs/schemas/mika-live2d-pose-record-3d.schema.json / /mika-avatar/handoff/mika-live2d/pose-record-3d.schema.json，範例：pose_record_3d.sample.json，點位格式：[x, y, z, confidence]，轉換工具：tools/choreography/motionbert_x3d_to_pose_record.py。
Retarget 工具：tools/live2d/pose_record_to_live2d_motion.py，輸出：runtime/motions/soft-dance-loop.motion3.json，格式：Cubism motion3.json parameter curves。
Retarget dry-run：/mika-avatar/handoff/mika-live2d/pose-retarget-dry-run.json / /mika-avatar/handoff/mika-live2d/pose-retarget-dry-run.md。
Retarget sample motion3：/mika-avatar/handoff/mika-live2d/soft-dance-loop.sample.motion3.json。Dry-run retarget artifact for production review; not a release-ready runtime motion until the rigged Mika model exists.
必要骨架節點：head, neck, shoulder_L, shoulder_R, elbow_L, elbow_R, wrist_L, wrist_R, hip_L, hip_R, knee_L, knee_R, ankle_L, ankle_R
骨架驅動參數：ParamAngleX, ParamAngleY, ParamAngleZ, ParamBodyAngleX, ParamBodyAngleY, ParamBodyAngleZ, ParamAllX, ParamAllY, ParamAllRotate, ParamLeftShoulderUp, ParamRightShoulderUp, ParamArmLA01, ParamArmLA02, ParamArmLA03, ParamArmRA01, ParamArmRA02, ParamArmRA03, ParamHandLA, ParamHandRA, ParamFingerL, ParamFingerR, ParamLegLA01, ParamLegLA02, ParamLegRA01, ParamLegRA02, ParamFootL, ParamFootR
A recorded dance clip must visibly move head, body, shoulders, arms, and full-body pose in sync with the skeleton timeline without vertical jitter.
| 嘴型 | runtime expression | 必要參數 | 振幅參數 |
|---|---|---|---|
a |
runtime/expressions/a.exp3.json |
ParamA |
ParamMouthDown |
i |
runtime/expressions/i.exp3.json |
ParamI |
ParamMouthDown |
u |
runtime/expressions/u.exp3.json |
ParamU |
ParamMouthDown |
e |
runtime/expressions/e.exp3.json |
ParamE |
ParamMouthDown |
o |
runtime/expressions/o.exp3.json |
ParamO |
ParamMouthDown |
Expression State Contract
RIGGING_SPEC.json 的 expressionStateTargets 必須列出每個正式表情與嘴型狀態，並和 EXPRESSION_MAP.json、model3 Expressions、expression Parameters 對齊。
- driver mode：
cubism-expression - 禁止 fallback：
css-overlay, dom-overlay, detached-png-layer - mouthAmplitudeParameter：
ParamMouthDown
Every required expression state must be declared in RIGGING_SPEC.json expressionStateTargets, mapped by EXPRESSION_MAP.json, declared by model3 Expressions, and backed by expression Parameters that drive Cubism model parts instead of detached overlays.
Japanese vowel expressions a/i/u/e/o must drive ParamA/ParamI/ParamU/ParamE/ParamO plus ParamMouthDown so singing and lyric reading can vary mouth shape and amplitude like mao_pro.
| 表情 | 種類 | runtime expression | rigging group | 必要參數 |
|---|---|---|---|---|
a |
mouth-vowel |
runtime/expressions/a.exp3.json |
mouth |
ParamA, ParamMouthDown |
i |
mouth-vowel |
runtime/expressions/i.exp3.json |
mouth |
ParamI, ParamMouthDown |
u |
mouth-vowel |
runtime/expressions/u.exp3.json |
mouth |
ParamU, ParamMouthDown |
e |
mouth-vowel |
runtime/expressions/e.exp3.json |
mouth |
ParamE, ParamMouthDown |
o |
mouth-vowel |
runtime/expressions/o.exp3.json |
mouth |
ParamO, ParamMouthDown |
blink |
face-expression |
runtime/expressions/blink.exp3.json |
eyes |
ParamEyeLOpen, ParamEyeROpen |
smile |
face-expression |
runtime/expressions/smile.exp3.json |
face, eyes, mouth |
ParamEyeLSmile, ParamEyeRSmile, ParamCheek, ParamA |
surprised |
face-expression |
runtime/expressions/surprised.exp3.json |
face, eyes, mouth |
ParamBrowLY, ParamBrowRY, ParamEyeLOpen, ParamEyeROpen, ParamO |
thinking |
face-expression |
runtime/expressions/thinking.exp3.json |
face, eyes, body |
ParamAngleX, ParamBodyAngleZ, ParamBrowLY, ParamBrowRY, ParamEyeBallX |
| 動作 | motion group | runtime motion | 必要參數 | 用途 |
|---|---|---|---|---|
idle |
idle |
runtime/motions/idle.motion3.json |
ParamAngleX, ParamAngleY, ParamAngleZ, ParamBreath |
base breathing and gentle head motion when music is not driving a special cue |
greeting |
greeting |
runtime/motions/greeting.motion3.json |
ParamAngleX, ParamBodyAngleX, ParamBodyAngleY, ParamBodyAngleZ |
short greeting or tap response without replacing Mika identity |
lyric-reading |
lyric-reading |
runtime/motions/lyric-reading.motion3.json |
ParamAllX, ParamAllY, ParamAllRotate, ParamAngleX, ParamAngleY |
reading a selected lyric line while mouth parameters handle phonemes |
point-lyrics |
point-lyrics |
runtime/motions/point-lyrics.motion3.json |
ParamLeftShoulderUp, ParamRightShoulderUp, ParamArmLA01, ParamArmRA01 |
gesture toward the current lyric area |
rhythm-sway |
rhythm-sway |
runtime/motions/rhythm-sway.motion3.json |
ParamBodyAngleX, ParamBodyAngleZ, ParamArmLA01, ParamArmLA02, ParamArmLA03, ParamHandLA, ParamHandRA, ParamLegLA01, ParamLegRA01, ParamFootL, ParamFootR, ParamSkirtFront, ParamSkirtFuwa, ParamSleeveL, ParamSleeveR |
song beat sway for tracks without bespoke choreography |
chorus-gesture |
chorus-gesture |
runtime/motions/chorus-gesture.motion3.json |
ParamBodyAngleY, ParamRightShoulderUp, ParamArmRA01, ParamArmRA02, ParamArmRA03, ParamHandRA, ParamFingerR |
larger chorus hand and upper-body accent |
soft-dance-loop |
soft-dance-loop |
runtime/motions/soft-dance-loop.motion3.json |
ParamAngleX, ParamAngleY, ParamAngleZ, ParamBodyAngleX, ParamBodyAngleY, ParamBodyAngleZ, ParamAllY, ParamAllRotate, ParamBreath, ParamLeftShoulderUp, ParamRightShoulderUp, ParamArmLA01, ParamArmLA02, ParamArmLA03, ParamArmRA01, ParamArmRA02, ParamArmRA03, ParamHandLA, ParamHandRA, ParamFingerL, ParamFingerR, ParamLegLA01, ParamLegLA02, ParamLegRA01, ParamLegRA02, ParamFootL, ParamFootR, ParamHairFront, ParamHairSideL, ParamHairSideR, ParamHairBack, ParamHairBackL, ParamHairBackR, ParamoHairMesh, ParamHairFrontFuwa, ParamHairSideFuwa, ParamHairBackFuwa, ParamEyeLSmile, ParamEyeRSmile, ParamEyeLOpen, ParamEyeROpen, ParamEyeBallX, ParamEyeBallY, ParamCheek, ParamBrowLY, ParamBrowRY, ParamSkirtFront, ParamSkirtSideL, ParamSkirtSideR, ParamSkirtFuwa, ParamSleeveL, ParamSleeveR |
smooth loop for Mika-only choreographed songs |
Motion State Contract
RIGGING_SPEC.json 的 motionStateTargets 必須列出每個正式動作狀態，並和 MOTION_MAP.json、model3 Motions、motion3 Curves 對齊。
- driver mode：
cubism-motion-parameter-curves - native motion policy：
non-interrupting-section-aware - 禁止 fallback：
css-motion-animation, dom-transform-motion, detached-png-limb maxParamAllYAbs：0.08maxRootScaleDelta：0.0forbidCssTransform：truenoVerticalJitter：true
Every required motion state must be declared in RIGGING_SPEC.json motionStateTargets, mapped by MOTION_MAP.json, declared by model3 Motions, and backed by motion3 Curves that drive Cubism model parameters without CSS or DOM fallback animation.
Song-section motions must not be interrupted before minimumDurationSeconds except when switching to a higher-priority user action; gesture cooldownSeconds must be respected.
| 動作 | motion group | runtime motion | 最短秒數 | 冷卻秒數 | 必要參數 |
|---|---|---|---|---|---|
idle |
idle |
runtime/motions/idle.motion3.json |
3.0 |
|
ParamAngleX, ParamAngleY, ParamAngleZ, ParamBreath |
greeting |
greeting |
runtime/motions/greeting.motion3.json |
1.2 |
0.8 |
ParamAngleX, ParamBodyAngleX, ParamBodyAngleY, ParamBodyAngleZ |
lyric-reading |
lyric-reading |
runtime/motions/lyric-reading.motion3.json |
1.0 |
0.4 |
ParamAllX, ParamAllY, ParamAllRotate, ParamAngleX, ParamAngleY |
point-lyrics |
point-lyrics |
runtime/motions/point-lyrics.motion3.json |
1.0 |
0.8 |
ParamLeftShoulderUp, ParamRightShoulderUp, ParamArmLA01, ParamArmRA01 |
rhythm-sway |
rhythm-sway |
runtime/motions/rhythm-sway.motion3.json |
4.0 |
|
ParamBodyAngleX, ParamBodyAngleZ, ParamArmLA01, ParamArmLA02, ParamArmLA03, ParamHandLA, ParamHandRA, ParamLegLA01, ParamLegRA01, ParamFootL, ParamFootR, ParamSkirtFront, ParamSkirtFuwa, ParamSleeveL, ParamSleeveR |
chorus-gesture |
chorus-gesture |
runtime/motions/chorus-gesture.motion3.json |
2.0 |
1.2 |
ParamBodyAngleY, ParamRightShoulderUp, ParamArmRA01, ParamArmRA02, ParamArmRA03, ParamHandRA, ParamFingerR |
soft-dance-loop |
soft-dance-loop |
runtime/motions/soft-dance-loop.motion3.json |
8.0 |
|
ParamAngleX, ParamAngleY, ParamAngleZ, ParamBodyAngleX, ParamBodyAngleY, ParamBodyAngleZ, ParamAllY, ParamAllRotate, ParamBreath, ParamLeftShoulderUp, ParamRightShoulderUp, ParamArmLA01, ParamArmLA02, ParamArmLA03, ParamArmRA01, ParamArmRA02, ParamArmRA03, ParamHandLA, ParamHandRA, ParamFingerL, ParamFingerR, ParamLegLA01, ParamLegLA02, ParamLegRA01, ParamLegRA02, ParamFootL, ParamFootR, ParamHairFront, ParamHairSideL, ParamHairSideR, ParamHairBack, ParamHairBackL, ParamHairBackR, ParamoHairMesh, ParamHairFrontFuwa, ParamHairSideFuwa, ParamHairBackFuwa, ParamEyeLSmile, ParamEyeRSmile, ParamEyeLOpen, ParamEyeROpen, ParamEyeBallX, ParamEyeBallY, ParamCheek, ParamBrowLY, ParamBrowRY, ParamSkirtFront, ParamSkirtSideL, ParamSkirtSideR, ParamSkirtFuwa, ParamSleeveL, ParamSleeveR |
授權與來源契約
授權檔：LICENSE.md，美術來源檔：ART_SOURCES.md，授權標示 manifest：ATTRIBUTION_MANIFEST.json
必要授權：commercialUse=可商用：yes, publicWebUse=可公開網站使用：yes, learnMoreUse=可用於 LearnMore：yes, sourceProof=來源或授權 URL，或明確標示內部原創/自製
必要來源欄位：角色立繪, 分層源檔, 貼圖, 製作者, 素材來源 URL 或內部原創聲明
必要公開標示位置：mika-handoff, learnmore-site-notes
attribution locations must be publicly visible on Mika handoff and LearnMore/site notes
來源證明需包含：http://, https://, 內部原創, 自製, original
驗證指令
python3 tools/live2d/inspect_mika_live2d_source_export.py deliveries/mika-live2d/source --no-fail python3 tools/live2d/inspect_mika_live2d_runtime_export.py deliveries/mika-live2d/runtime --no-fail python3 tools/live2d/validate_mika_live2d_pose_record.py deliveries/mika-live2d/pose_record.sample.json python3 tools/live2d/pose_record_to_live2d_motion.py deliveries/mika-live2d/pose_record.sample.json --output reports/mika-live2d-soft-dance-loop.sample.motion3.json --report-output reports/mika-live2d-pose-retarget-dry-run.json --markdown-output reports/mika-live2d-pose-retarget-dry-run.md python3 tools/live2d/validate_mika_live2d_delivery.py deliveries/mika-live2d python3 tools/live2d/check_mika_live2d_delivery_readiness.py deliveries/mika-live2d --no-fail
LearnMore Promotion Gate
- 目標角色：
mika_live2d/live2d - 目前預設：
mao_pro - 備援角色：
mao_pro - 必須為 true：
readyForLearnMore,deliveryReady,intakeReadyForApply,olvCustomLive2dReady - 阻擋欄位：
blockingReasons,deliveryBlockingReasons,intakeBlockingReasons,olvCustomLive2dBlockingReasons,remainingProductionQueueIds - 切換條件：
readyForLearnMore=true and deliveryReady=true and intakeReadyForApply=true and olvCustomLive2dReady=true
Do not promote mika_live2d or switch LearnMore away from mao_pro until readyForLearnMore, deliveryReady, intakeReadyForApply, and olvCustomLive2dReady are all true.
Post-Delivery Intake
- Extract the returned Mika Live2D delivery into deliveries/mika-live2d.
- Run the source export preflight against deliveries/mika-live2d/source before full intake.
- Run the runtime export preflight against deliveries/mika-live2d/runtime before full intake.
- Run delivery validation and readiness checks.
- Copy approved runtime files into live2d-models/mika_live2d/runtime.
- Register mika_live2d in model_dict.json only after runtime files pass validation.
- Run full core verification and LearnMore acceptance before changing LearnMore default.
python3 tools/live2d/inspect_mika_live2d_source_export.py deliveries/mika-live2d/source python3 tools/live2d/inspect_mika_live2d_runtime_export.py deliveries/mika-live2d/runtime python3 tools/live2d/validate_mika_live2d_delivery.py deliveries/mika-live2d python3 tools/live2d/check_mika_live2d_delivery_readiness.py deliveries/mika-live2d --no-fail python3 tools/live2d/intake_mika_live2d_delivery.py deliveries/mika-live2d --no-fail python3 tools/live2d/intake_mika_live2d_delivery.py deliveries/mika-live2d --apply python3 tools/vrm/test_mika_live2d_status.py bash scripts/verify_mika_avatar_core.sh
| 項目 | 模式 | 來源 | 目的地 |
|---|---|---|---|
runtime |
replace-dir |
/app/deliveries/mika-live2d/runtime |
/app/live2d-models/mika_live2d/runtime |
source |
replace-dir |
/app/deliveries/mika-live2d/source |
/app/deliveries/mika-live2d/source |
acceptance |
replace-dir |
/app/deliveries/mika-live2d/acceptance |
/app/deliveries/mika-live2d/acceptance |
license |
copy-file |
/app/deliveries/mika-live2d/LICENSE.md |
/app/docs/licenses/mika-live2d.md |
artSources |
copy-file |
/app/deliveries/mika-live2d/ART_SOURCES.md |
/app/docs/licenses/mika-live2d-art-sources.md |
attributionManifest |
copy-file |
/app/deliveries/mika-live2d/ATTRIBUTION_MANIFEST.json |
/app/docs/licenses/mika-live2d-attribution.json |
psdLayerSpec |
copy-file |
/app/deliveries/mika-live2d/PSD_LAYER_SPEC.md |
/app/deliveries/mika-live2d/PSD_LAYER_SPEC.md |
expressionMap |
copy-file |
/app/deliveries/mika-live2d/EXPRESSION_MAP.json |
/app/deliveries/mika-live2d/EXPRESSION_MAP.json |
motionMap |
copy-file |
/app/deliveries/mika-live2d/MOTION_MAP.json |
/app/deliveries/mika-live2d/MOTION_MAP.json |
parameterMap |
copy-file |
/app/deliveries/mika-live2d/PARAMETER_MAP.json |
/app/deliveries/mika-live2d/PARAMETER_MAP.json |
partsMap |
copy-file |
/app/deliveries/mika-live2d/PARTS_MAP.json |
/app/deliveries/mika-live2d/PARTS_MAP.json |
sourceManifest |
copy-file |
/app/deliveries/mika-live2d/SOURCE_MANIFEST.json |
/app/deliveries/mika-live2d/SOURCE_MANIFEST.json |
psdLayerManifest |
copy-file |
/app/deliveries/mika-live2d/PSD_LAYER_MANIFEST.json |
/app/deliveries/mika-live2d/PSD_LAYER_MANIFEST.json |
attributionManifestDelivery |
copy-file |
/app/deliveries/mika-live2d/ATTRIBUTION_MANIFEST.json |
/app/deliveries/mika-live2d/ATTRIBUTION_MANIFEST.json |
visualQa |
copy-file |
/app/deliveries/mika-live2d/VISUAL_QA.json |
/app/deliveries/mika-live2d/VISUAL_QA.json |
acceptanceChecklist |
copy-file |
/app/deliveries/mika-live2d/ACCEPTANCE_CHECKLIST.md |
/app/deliveries/mika-live2d/ACCEPTANCE_CHECKLIST.md |
layerSplitChecklist |
copy-file |
/app/deliveries/mika-live2d/LAYER_SPLIT_CHECKLIST.md |
/app/deliveries/mika-live2d/LAYER_SPLIT_CHECKLIST.md |
下載驗證
mkdir -p dist curl -L https://ycspace.myvnc.com/mika-avatar/handoff/mika-live2d-delivery-template.zip -o dist/mika-live2d-delivery-template.zip echo "2bb197ad475c9e226a55e4e78bc2aed63933f3c33efc888de5a65ebbf9479b73 dist/mika-live2d-delivery-template.zip" | sha256sum -c - python3 tools/live2d/package_mika_live2d_delivery_template.py --verify dist/mika-live2d-delivery-template.zip python3 tools/live2d/validate_mika_live2d_delivery.py deliveries/mika-live2d python3 tools/live2d/check_mika_live2d_delivery_readiness.py deliveries/mika-live2d --no-fail