# 滑冰機器人物理實驗

[新的神經平衡實驗室](lab/index.html) · [開啟關節物理實驗頁](../robot-study.html) · [架構與執行計畫](../SKATING-ROBOT-ARCHITECTURE.md) · [系列研究](../research.html)

這個獨立頁面使用 MuJoCo 3.14.0 的前向動力學、關節力矩與實際接觸；骨架畫面直接來自物理狀態的正向幾何。
舊版 `solver-core.js` 和 Serenity 音樂編舞保留作為基準。目前交付是可檢查失敗的研究原型，尚未完成 P0–P4 的全部門檻。

**2026-09-26 目標調整：優先完成接受高階指令的可信虛擬滑冰動作。** 固定設備與均勻冰面，允許合成、簡化的接觸參數；先交付完整停止，再串起推蹬、換腳、滑行與停止。精密材料校準及完整 P 階段驗證可並行，不再作所有動作開發的前置門檻。新任務依[目前產品目標與交付順序](../SKATING-ROBOT-ARCHITECTURE.md)驗收，下列既有失敗與研究範圍保留。

## 新的降階神經平衡平台

[神經控制實驗室 LAB 02](lab/index.html)已整合方向按鍵、強度、路書、後續建議、慢放與紀錄匯出。固定 Yuzuru 1.72 m／57 kg，前進推蹬、左右連續剪冰、換側、滑行與停止由同一狀態接續；12 → 48 → 32 → 2 MLP 修正動態支撐下的平衡，神經與 PD 在 12 個完整指令情境均 12/12、無回授 0/12。這是程序化足部技能＋有限接觸力積分＋神經平衡＋固定骨長 IK，尚未由網路控制完整 37 關節。

[操作與方法](lab/README.md) · [新 CUDA 訓練紀錄](lab/NEURAL-LOCOMOTION.md) · [完整指令驗證](lab/artifacts/locomotion/command-verification.json)。[LAB 01 雙腳平衡](lab/balance.html)與[原訓練報告](lab/artifacts/training-report.json)保留。下方 MuJoCo 驗證仍是原結果，不由新平台的降階成果替代。

<!-- ROBOT-VALIDATION:START -->

## 目前完成範圍

驗證資料打包時間：2026-09-25T18:23:59.917821+00:00。這是本機研究原型，打包不代表已部署。

| 階段 | 狀態 | 已知範圍與缺口 |
| --- | --- | --- |
| P0：固定契約與身體基準 | 通過 | 57 kg、16 剛體、35 個內部自由度＋6 個浮動基座自由度；固定肢段、正慣量與來源 hash 通過。 |
| P1：原生／WASM 接觸切片 | 部分完成 | 自由剛體守恆、方向性阻力、固定姿態換刃幾何與原生／WASM 數值對照已有結果；接觸事件步長收斂未通過，完整接觸儲能帳與瀏覽器成本門檻未完成。 |
| P2：身體、限制與重定向 | 部分完成 | 41 DoF 剛體模型、兩段軀幹、前臂與腕、刀刃幾何及限制原型已建立；尚未完成觀測驅動重定向、完整動態限制與自碰撞驗收。 |
| P3：平衡、滑行與移重 | 有限場景原型 | 已實作 ideal-state 回授、局部人體場景和新實例 checkpoint 重播檢查。原生與 WASM 人體控制器是不同實作，擾動施加時間也不同；存活與重播不等於完整 P3 驗收。 |
| P4：持續推進與弧線 | 待完成 | 蹬冰仍為未通過的試驗；Power Pull、前後左右連續 crossover 尚未實作。未接入 Serenity 音樂編舞。 |

完整摘要：[`validation-summary.json`](validation-summary.json)。各測試保留獨立指標，不混成一個正確率。

### 舊版控制器的局部基準案例

| 案例 | 原始狀態 | 模擬秒數 |
| --- | --- | --- |
| standing | survived-not-skill-certified | 30 |
| standing-yaw90 | survived-not-skill-certified | 30 |
| posture-only | fail | 1.35 |
| passive | fail | 0.302 |
| standing-left-impulse | survived-not-skill-certified | 30 |
| standing-right-impulse | survived-not-skill-certified | 30 |
| standing-forward-impulse | survived-not-skill-certified | 30 |
| standing-backward-impulse | survived-not-skill-certified | 30 |
| glide-025 | survived-not-skill-certified | 30 |
| glide-025-yaw90 | survived-not-skill-certified | 30 |
| glide-1 | fail | 2.37 |
| transfer-left | survived-not-skill-certified | 30 |
| transfer-right | survived-not-skill-certified | 30 |
| stroke | fail | 5.12 |
| brake | survived-not-skill-certified | 30 |

`survived-not-skill-certified` 只表示未觸發該次失敗停格；不代表完整平衡恢復、步長收斂、能量帳或動作成功。

另見[原生人體控制器案例](reports/native-standing-results.json)和[checkpoint 完整檢查](reports/checkpoint-results.json)。原生／WASM 人體控制器為不同實作且擾動時序不同，不做逐 bit 一致性解讀。

brake 案例尚缺命令時速度與同條件無煞車對照，不能由期末低速度判為已驗證煞車。

<!-- ROBOT-VALIDATION:END -->

## 數據與適用範圍

- [固定的驗證契約](reports/protocol.json)與[來源基準](reports/baseline-manifest.json)：數值門檻先於第一份結果固定。
- [身體與刀刃幾何](reports/morphology-results.json)：編譯模型核對，以及受控足部姿態的承重刃／rocker／刀齒測試。受控 fixture 不能證明自由人體平衡。
- [原生 MuJoCo](reports/native-results.json)與[同版本 WASM 對照](reports/wasm-fixture-results.json)：比較位置、速度、方向及能量差；不是人體動作「正確率」。WASM 數值測試在 Node 執行，成本不能當作瀏覽器／手機驗收。
- [最終應用案例](reports/application-results.json)：每次站立、擾動、滑行、移重、蹬冰與減速分別記錄存活、失敗、力矩和計算成本。
- [原生人體站立／滑行案例](reports/native-standing-results.json)：獨立 Python 控制器的能力限制、負重移轉及旋轉座標對照；它與 WASM 人體控制器是不同實作，擾動施加時間也不同，不能當作逐 bit parity。
- [checkpoint 與控制狀態](reports/checkpoint-results.json)：新實例／跨 generation 重播、命令佇列、擾動重播、錯誤資料拒絕及 snapshot 不驅動物理的檢查；仍不是滑冰動作或瀏覽器訊息傳送驗收。
- [接觸回應開發掃描](reports/contact-stability-development.json)與[近剛性回應診斷](reports/contact-hard-development.json)：保留未改善的結果。參數經這些案例選擇，不能再稱它們為未碰觸的獨立校正集。
- [初版原生結果](reports/native-results-initial.json)、[初版 WASM 對照](reports/wasm-fixture-initial-results.json)、[先前控制器結果](reports/application-results-initial.json)：保留失敗歷程；不是目前版本的驗收證據。

`pass / fail / not-run / blocked / unsupported` 分別表示通過、失敗、未執行、證據未完成與未支援。
`survived-not-skill-certified` 只表示局部測試未觸發失敗停格。不能把未跌倒、同模型重播或良好的影像投影誤差提升為整個物理動作驗證。
初版原生報告未逐步記錄接觸事件，其中原先假設為零的事件差不能作為通過證據；現版已改為實際事件序列比較，並保留失敗結果。

## 如何操作目前原型

1. 預設選「雙腳直線滑行 · 平衡優先」、480 Hz、初速 1 m/s。按「開始」觀察雙腳平行滑行；自然減速是滑行阻力的結果，不是推蹬或定速控制。
2. 改初速、朝向、步頻或冰面後，按「重設」再「開始」才套用。設 0 m/s 可驗證站立；前進初速上限 3 m/s，後退下限 −2 m/s；直滑使用 480 Hz。
3. 直滑模式先停用移重、轉刀、推蹬與煞車。保留「向左／向前 2 N·s」小幅擾動及檢查點，用來單獨檢查雙腳支撐。
4. 「還原檢查點」回到保存的物理與控制狀態並暫停。¼ 倍速只改觀看速度；「單步」仍前進一個固定物理步。
5. 舊版「姿態 + 平衡回授」及「支撐力分配＋重心回授」保留；重設後可檢視原本移重與推蹬的失敗。

新的[雙腳直滑驗證](reports/straight-glide.json)與[原因和修正](SUPPORT-DEVELOPMENT.md#雙腳直滑優先)獨立於下方舊版案例。原版初速 1 m/s 跌倒的結果仍保留，不改寫為新控制器的成績。

**「推蹬試驗」是已知會失衡的候選，不是可用的推進指令。** 現階段只讓右髖、膝與踝依時間改變目標角度，尚缺先確認支撐刀承重、推刃、卸重、回收與接冰的完整事件流程。固定測試及 Chrome 操作都在指令開始約 2.1 秒後失衡；不是操作者按鍵方式造成。失衡會停格，可重設或還原檢查點。煞車亦尚無足以排除原本滑行阻力的對照證據。

## 接下來的推蹬開發程序

第二階段已加入可切換的支撐力分配、重心相對支撐點回授、關節目標限速，以及接觸摩擦隔離診斷。參閱[第二階段開發與對照](SUPPORT-DEVELOPMENT.md)。完整推蹬仍未通過；原版保留。

2026-09-25 開發更新：已加入[右腳推蹬重定向對照](stroke-study.html)，以及主實驗頁的「移重＋小角度刀向試驗」與「完整推蹬 · 已知失衡」。前者只檢查站穩、左刀承重、右刀小幅外轉後回正；門檻只有 1.43°，實際約 2°，尚未驗證內外刃或有效推力；後者繼續嘗試推伸、卸重、回收和下一次接冰，仍不能作為可用推進動作。

對照頁保留三層：原始程序骨架、依固定身材轉換後的目標、MuJoCo FK 擬合結果。支撐腳、質量或關節角度沒有直接複製成真實受力。踝點到刀底距離由 morphology profile 讀取；上身也區分胸部、肩線、頸長和頭中心。擬合採固定骨長和關節界線，接觸穿透使用軟懲罰並如實列出殘差。手腕／掌面方向目前未設為擬合觀測，沒有把弱先驗的角度稱為已還原的手部動作。

共擷取 260 格、約 4.33 秒，包含原來右腳推蹬之後、下一步讓右刀落冰的片段。76 個時點用於擬合，184 個時點用於插值檢查；報告的公分誤差是對**身材轉換後的程序目標**，不是真人或影片準確率。 本輪擬合／插值 RMS 均約 1.59 cm；離線參考的最大關節速度達 profile 上限的 1.275 倍，仍需重新配置時間，不能直接認為是動態可行軌跡。

動力學試驗採求解關節增量，從既有站姿漸進施加，沒有把離線 FK 的浮動根位姿灌進模擬。這也表示尚未完整追蹤離線參考的重心路徑；不能把兩頁的動畫當成同一個運動解。強度影響推蹬展幅，必要的承重轉移門檻不隨強度降低。

切換階段使用 80 ms 濾波的實測負重、持續時間與右刀方向；原始接觸負重保留不改寫。中止後的「回正」只是控制目標，不保證真正恢復平衡。完整候選在推伸段仍會失衡，下一步需要支撐力分配與動態可行軌跡，不能繼續以放寬門檻代替成功。見[本輪測試摘要](reports/stroke-development.json)；詳細力矩、接觸與狀態時序保留於 repo 的 `verification/ice/robot/stroke-prepared-results.json`，初次失敗另存 `stroke-prepared-initial-results.json`。

先完成雙腳直滑，再回到一個右腳推蹬週期，最後擴展為左右交替。現有 `solver-core.js` 的 stroke 和 `skater-model.js` 的前進蹬冰可提供完整的關節點、刀方向與接觸階段參考；其承重與骨盆修正是程序指定，不能當作真實受力。腳向右後方伸展時，刀尖向外偏轉，並非把刀尖直接轉向後方。

1. **擷取參考與重定向**：保存髖、膝、踝、肩、肘、腕及雙刀的位置／方向，依機器人的固定骨長和實際關節軸求解，限制關節範圍、自碰撞與時間不連續。舊 `bladeYaw` 不能直接當成新模型的某一個關節角度；刀的朝向要由整條腿共同實現。先並列檢查參考骨架和重定向骨架。
2. **單段接觸與驅動驗證**：在固定簡化環境內逐段檢查刀向、承重刃、法向力、滑移、重心與關節驅動，確認動作不依賴接觸抖動或數值失控。可記錄指定場景的動作任務成功；完整 P1 接觸收斂與能量帳驗證另列，不能把前者當成後者通過。
3. **事件驅動的一次推蹬**：左刀接受承重 → 右刀接冰且外轉／用刃到位 → 向右後推伸 → 右刀卸重 → 回收接冰。時間只給參考節奏及逾時上限；實測承重、刀姿態和安全餘量決定是否進入下一段。條件不足時減幅或中止，不按時間硬切。
4. **閉環與驗收**：以有限關節力矩追蹤姿態，平衡回授調整幅度與時序。從小幅、低速開始，與同初始條件的無推蹬案例比較正向動量及能量來源；確認回收、接冰、關節能力及擾動恢復，再做連續推蹬。不可覆寫浮動根節點、鎖住刀的位置或直接施加向前速度。

上述程序已開始實作；目前完成程序參考的幾何重定向及事件控制原型，完整動力學追蹤仍未通過。它與既有花滑研究的「影片關鍵姿態 → 軌跡最佳化 → 動作控制」分工相容，但不代表本原型已具備該研究的控制能力：[Figure Skating Simulation from Video (2019)](https://mrl.snu.ac.kr/research/ProjectSkate/Figure_Skating_Simulation_from_Video___PG2019.pdf)。

## 固定條件

右手座標，世界 Z 向上，零偏航時 X 向前、Y 向人體左側；正偏航為左轉。使用 SI 單位、弧度與 `wxyz` 四元數。
35 個內部速度自由度加 6 個浮動基座自由度，兩段軀幹、前臂旋轉、腕關節及靴／刀分開表示。

沿用羽生 profile 的固定肢段與 57 kg。名冊身高 1.72 m 不用來強迫伸縮肢段；肢段比例、慣量、淨關節能力及冰面回應仍是原型假設，並非選手個人或實際冰場的量測。
感測採明示的 **ideal-state**，直接讀取引擎狀態；尚未驗證含噪、延遲或漂移的估測器。

根節點只有初始化、重設及完整 checkpoint 還原可直接寫入。控制器必須透過關節力矩及接觸改變身體；畫面不得用舊 IK 再修正骨盆／刀的位置。
換 profile 或身體參數需要重設測試，不能在途中悄悄改變質量或慣量。

## 本機重跑

在專案根目錄執行。環境為 `.venv-robot` 的 Python／MuJoCo 3.14.0／NumPy，加上 Node；瀏覽器核心已 vendored，不需要由 CDN 載入。

```powershell
.venv-robot/Scripts/python.exe verification/ice/robot/verify-morphology.py
.venv-robot/Scripts/python.exe verification/ice/robot/native-reference.py
node verification/ice/robot/verify-wasm-fixture.mjs
node verification/ice/robot/verify-robot.mjs
.venv-robot/Scripts/python.exe projects/serenity/ice/robot/model/native-standing-study.py --suite --hz 480 --output verification/ice/robot/native-standing-results.json
node verification/ice/robot/verify-restore-checkpoint.mjs
node verification/ice/robot/verify-straight-glide.mjs
.venv-robot/Scripts/python.exe verification/ice/robot/package-reports.py
```

推蹬參考與單段測試可分別重跑（擬合需要 SciPy）：

```powershell
node projects/serenity/ice/robot/model/extract-stroke-reference.cjs
.venv-robot/Scripts/python.exe -X utf8 projects/serenity/ice/robot/model/fit-stroke-reference.py
.venv-robot/Scripts/python.exe -X utf8 verification/ice/robot/verify-stroke-reference.py
node verification/ice/robot/verify-stroke-prepared.mjs
```

修改生成的參考後，亦須重跑上方 application／checkpoint 測試，再打包，讓來源 hash 相符。

所有驗證報告與最終控制器案例都完成後才打包。`package-reports.py --check-only` 可只查核 hash；
缺檔、模型或控制器與結果不一致時會拒絕覆寫網頁報告。打包只複製允許的 JSON、產生摘要及更新本頁，**不會部署**。
開發掃描腳本 `diagnose-native-contact.py`、`diagnose-contact-stability.py`、`diagnose-hard-contact.py` 不屬於每次必要的回歸測試；不要反覆調參取代缺失的驗收。

啟動本機靜態伺服器後開啟 `/ice/robot-study.html`；Worker／WASM／JSON 需要 HTTP 存取：

```powershell
python -m http.server 8769 --bind 127.0.0.1 --directory projects/serenity
```

## 尚未解決的物理問題

`brake` 測試目前記錄的是期末速度與場景存活，尚缺下達命令當時的速度、受控初速與同條件無煞車對照。
因此無法把低期末速度歸因於煞車動作，而排除原本滑行阻力；這項能力仍未驗證。

原生與 WASM 的單刀結果相符，但同一模型的接觸事件在 240／480 Hz 仍不收斂。
加大 detector buffer 可以保留接觸候選，並不等於持續承重；原始力和幾何事件仍保留，沒有以放寬閾值掩蓋。
近剛性回應、不同 cone、積分器、`impratio`、切向排列與 Noslip 的有界診斷仍未找到可推薦的新基準。
目前依 S1–S2 優先完成固定簡化環境中的停止與推進流程；只把實際阻礙這些動作的接觸抖動、明顯能量異常或數值失控列為當前阻礙。完整 P1 接觸事件收斂與能量帳工作並行保留，尚未通過的結果不更名為通過。

能量帳是 `Δ(動能 + 重力位能 + 彈性位能) = 關節功 + 外力功 − 耗散 + 數值殘差`。
目前能列出機械能、關節作功與接觸力作功；尚未獨立核對順應性接觸儲能，故不把較小的 force-work 殘差稱為完整守恆通過。
降低重心或釋放原有能量可能增加速度，不能只看根節點加速判定憑空生能。

數值不收斂、真正跌倒、能力不足、接觸未支援與性能超時分別記錄。沒有解析碰撞歷時，報表的 sample contact peak 也不是量測得到的落地力峰值。
接觸座標處理依據 [MuJoCo 官方流程](https://mujoco.readthedocs.io/en/stable/APIreference/APIfunctions.html)
與 [3.14.0 引擎原始碼](https://github.com/google-deepmind/mujoco/blob/3.14.0/src/engine/engine_core_constraint.c)。

## 原始研究的保留界線

Oleg、羽生與 skopinaskate 的影片、觀測點、擬合資料和既有切分保留原樣。
已另完成 132 個原片時點的[新舊骨架重算與刀端對照](../reference-ankle-study.html)，但整段精度未取得一致改善，因此未覆蓋原動畫；依[來源重建規範](../MOTION-RECONSTRUCTION-WORKFLOW.md)保留驗證界線。
這組合成測試目前只能檢查引擎、接觸與控制器，不能宣稱已還原真人三維動作或真實受力。

## 踝／足部旋轉變體

2026-09-26：新增左右踝的軸向旋轉工程近似，保留原 v1；身材、質量與原關節界線不變。參見[髖踝共同轉刀對照](ankle-study.html)及[開發紀錄](ANKLE-DEVELOPMENT.md)。v2 是 37 關節加 6 浮動根自由度；60°幾何求解已可達，但完整動態推蹬與單腳平衡仍未通過，主物理頁沒有把它當成可用技能。

## 後續：接觸一致的單腳工作點

[單腳平衡試驗](single-support-study.html)已接入 v2 骨架與實際關節力矩回授。保留完整速度狀態後，靜止及左右各 0.1 N·s 擾動三案在 WASM 各通過二十秒。初始化是已承重姿態，沒有把它当作換重完成；滑行減速、推刃與支撐轉換仍未通過。詳見[控制與驗證紀錄](SINGLE-SUPPORT.md)。

減速開發改以刀刃側滑為明確目標，依序驗證雙腳犁式、後置拖刀及 hockey stop；刀齒不作為制動器。已新增獨立的刀刃／刀齒負荷與耗散量測，並查明兩個既有單腳失衡案例全程沒有刀齒接觸。詳見[煞停要求、對照與未解問題](BRAKING.md)。
