# 滑冰機器人：以身體為主體的閉環控制架構

設計日期：2026-09-25。狀態：**開始實作；MuJoCo 原生／WASM、41 DoF 身體與實驗頁已建立，尚未通過完整 P0–P4 驗收**。

實作入口：[滑冰機器人實驗](robot-study.html)；[實作與測試紀錄](robot/README.md)。既有 P0–P4 報告的通過／未通過狀態保留；本次調整開發優先順序，不改寫舊測試結果。

本計畫的「機器人」先指瀏覽器中的虛擬滑冰者。它根據自身姿態、速度、接冰反應與目標，計算關節驅動；實際移動由身體與冰面的作用產生。第一人稱是控制器的身體座標與感知方式，不要求第一人稱攝影機，也不包含實體機器人的硬體製作。

## 2026-09-26：新的開發平台

[LAB 02 神經控制實驗室](robot/lab/index.html)已接入前進推蹬、左右連續剪冰、換側、滑行與停止，以及原操作頁的按鍵、強度、路書與慢放。固定 Yuzuru 身材，採程序化接觸階段、有限每刀力與質心積分，12 → 48 → 32 → 2 MLP 修正動態支撐下的平衡；骨架以固定骨長 IK 呈現。12 個完整指令情境神經與 PD 均 12/12、無回授 0/12；指定完整示範在 120／240／480 Hz 皆完成。詳見[逐案報告與限制](robot/lab/artifacts/locomotion/command-verification.json)。

第一版[LAB 01 雙腳平衡](robot/lab/balance.html)與原訓練／失敗報告保留。LAB 02 先交付簡化環境中的 S1／S2，以及 S3 左右剪冰方向控制；不代表完整關節引擎已通過相同門檻。接下來改善接觸足的運動一致性，再將支撐要求分配到實際關節、擴充後退與花式動作。詳見[平台與執行策略](robot/lab/README.md)、[新訓練方法](robot/lab/NEURAL-LOCOMOTION.md)、[原雙腳訓練報告](robot/lab/artifacts/training-report.json)。

## 目前產品目標與交付順序

**2026-09-26，依使用者澄清：首要目標是完成可信的虛擬滑冰動作，接受高階指令後即時執行與銜接。** 固定同一套身材、冰鞋、冰刀與均勻冰面；參數可採工程近似。接觸研究用來支援動作，精密材料校準與完整文獻實驗重現不作前置門檻。

可信度以完整動作判斷：推蹬有屈膝、轉刀、推伸與回收；換腳有承重轉移；滑行有持續位移；轉彎配合身體與刀向；停止逐漸減速並站穩。人物、冰刀、冰痕、速度和指令進度讀取同一狀態，不能只讓單張姿態或單一力曲線好看。

### 固定且足夠的環境

- 沿用目前加入踝／足旋轉的 37 個內部自由度＋6 個浮動根自由度模型與固定羽生身材。下方 35＋6 表格保留初版設計背景。
- 固定刀具與冰況，不先混合設備訓練。允許使用合成曲線、低階公式或有限承載近似，調參以完整動作表現及基本受力合理性為依據，保存版本。
- 第一版保留沿刀易滑、橫向有限導引與側滑、負荷／刃角造成的回應變化，以及離冰失去支撐。切入深度可省略或視為有效狀態；ROH、冰硬度等可折入固定 profile，不必每項各自辨識。
- 先使用模擬器可提供的理想姿態與接觸回授。感測器雜訊、真實定位、磨耗、溫度泛化、冰屑與水膜研究延後。
- 保留固定骨長、關節活動範圍、有限驅動及接觸力；檢查可見穿透、抖動、無來源加速與對時間步的嚴重敏感。完整微觀模型和逐事件收斂認證可並行，不把明顯數值故障當作可接受的簡化。

### 以可操作的完整片段交付

| 順序 | 交付動作 | 檢查重點 |
| --- | --- | --- |
| S1：完成第一個指令 | 從已穩定的雙腳滑行接收「減速／停止」，完成漸進側滑、解除制動與停穩。 | 與相同初速自然滑行比較，確認動作造成減速；膝髖配合、刀齒不作制動、停後能繼續接指令。 |
| S2：完成推進與循環 | 「前進」觸發一次完整推蹬，包含接冰轉刀、推伸、卸重、回收；再做左右交替，串接滑行與停止。 | 先低速、小幅，確認推進、持續位移與回收側；連續兩個以上週期不重設人物、不回到片頭姿態。 |
| S3：方向控制 | 高階「左轉／右轉／目標方向」調整弧線、側傾、支撐與必要的剪冰。 | 改目標時自然準備與銜接，不能突然旋轉整個人物；比較大小轉彎及指令強度。 |
| S4：動作元素 | 後退、三轉、Power Pull、連續剪冰，再逐項加入旋轉與跳躍。 | 依入口足、前後向與用刃接續；動作風格可參考既有 Oleg、羽生與 skopinaskate 資料，但不宣稱逐幀還原。 |
| S5：節目編排 | 路書／音樂下達速度、方向、動作與強度，接入 Serenity 與舊版比較。 | 串接完整節目，允許調整節奏、幅度與準備時間；不靠重新播放孤立動作片段銜接。 |

S1 與 S2 的姿態重定向、動作控制和簡化接觸可以並行。單刀測試是定位阻礙的工具，不另外擴成必須全部完成的材料研究專案。LAB 02 已有「前進 → 左右連續剪冰 → 減速 → 低速停穩」完整示範與降階驗證；完整關節引擎及其餘 S4／S5 任務仍是執行計畫。

### 動作產生與驗收

採用「高階目標 → 技能／接觸階段 → 參考姿態與有限關節驅動 → 模擬回應 → 平衡修正」。既有動作資料與程序化姿態提供合理的初始動作，回授調整幅度、相位、承重與自由肢體；不要求網路從零發現所有花滑技法。神經模型可先針對一個短任務訓練修正量，與非神經控制器比較，無須等待所有停止方式、材料參數或花式元素完成。

每次交付同時檢視：

1. **視覺／技術可信度**：正常速度及慢速播放，檢查腳位、膝踝、肩髖、手臂、重心、接冰與冰痕；前後姿態連續，沒有原地假推或碎步重播。
2. **指令與銜接**：同一技能在不同強度、左右方向及連續命令下仍可用；目標改變時有準備、執行與恢復過程。
3. **基本模擬一致性**：無瞬移、抓力有限、離冰不承重、驅動與減速來源可查，數值穩定且可重播。環境和控制參數在一次比較中固定。

上述稱為「指定簡化環境中的虛擬動作任務驗收」。材料實測吻合、精確受力、跨設備泛化與實體機器人能力是另一層驗證；既有 P 階段的未解問題仍如實保留。

## 1. 核心決定

採用 **35 個內部關節自由度 + 6 個浮動根節點自由度** 的多剛體模型；以兩組軀幹轉動近似脊椎。使用離線建立的冰刀／冰面 response profiles，省去執行時的熱流、材料破壞與微觀水膜計算，但保留即時接觸、力矩、動量及平衡求解。

動作資料提供「想完成的任務與參考姿態」，控制器決定「這一刻如何施力」。禁止以直接平移骨盆、指定根節點速度、旋轉整個人物或強制足點貼地的方式，使失敗動作看似成功。初始條件、明示重設與重播檢查點載入是例外；每次例外均需記錄。

保留目前「軌跡滑行」與 AI 編排作為比較基準。新引擎先在獨立驗證頁建立，通過分階段門檻後才接回 `index.html`，不直接替換現行預設。

## 2. 現況與改造邊界

2026-09-25 實際程式查核：

| 現有部分 | 已經做到 | 新架構需要的改變 |
| --- | --- | --- |
| [`skater-model.js`](skater-model.js) | 路徑、兩節肢體 IK、手腕與掌向、曲線冰刀幾何 | 幾何與畫面介面可重用；不再由姿態函式決定真實身體位置 |
| [`reference-study-core.js`](reference-study-core.js) | 影片擬合的 32 個混合幾何控制量，重建姿態 | 這些量含腳位、伸展比例與角度，**不是 32 個解剖自由度**；須經重定向器轉成新關節／任務目標 |
| [`hanyu-profile.js`](hanyu-profile.js) | 1.72 m／57 kg 基準，以及固定肢段比例 | 保留來源骨長與選手資料；質量分布、關節能力、裝備慣量另列，不能當成羽生個人實測值 |
| [`solver-physics.js`](solver-physics.js) | 肢段重心與慣量近似、有界接觸合力／力矩擬合、殘差與限制檢查 | 新增真正的關節力矩與多剛體前向動力學；現有診斷保留作 baseline |
| [`solver-core.js`](solver-core.js) | 短期候選搜尋、根節點加速度／轉向控制、姿態及接觸階段 | 從「先更新根節點，再驗證姿態」改成「求關節驅動，由物理步進得到根節點」 |
| [`solver-controls.js`](solver-controls.js)、[`solver-roadbook.js`](solver-roadbook.js)、[`solver-forecast.js`](solver-forecast.js) | 指令強度、FIFO 路書、動作入口／出口推估 | 沿用使用方式；推薦仍是語意候選，實際能否執行由閉環狀態決定 |
| [`solver-worker.js`](solver-worker.js) | `init/reset/command/step/snapshot` 訊息邊界 | 保留協定概念，增添版本、generation、固定物理步號與完整檢查點 |
| [`choreography-core.js`](choreography-core.js)、[`choreography-library.js`](choreography-library.js) | 音樂段落與可重複元素 | 轉為節奏、方向、展幅、接觸意圖及參考姿態；不能直接成為外加推力 |

2026-09-26：活躍男性模型的幾何與預設質量統一由 `hanyu-profile.js` 取得，採 Yuzuru 1.72 m／57 kg；捨棄通用 70 kg 的執行預設。Rocker／Counter／Loop 可使用獨立女性組態，但換身材需重算相符擬合，不改標既有男性結果。歷史驗證報告保留當時身材與條件。

現有求解器檢查失敗會保留上一個有效姿態並停止模擬時間。這可作除錯暫停，但不是物理上的維持平衡。新引擎要分開 `paused-for-inspection`、`recovering`、`slipping`、`falling` 與 `numerical-failure`。

## 3. 閉環分層

```mermaid
flowchart TB
  U[路書、游標、音樂與動作選擇] --> G[任務與動作階段管理]
  R[來源觀測、擬合姿態、元素資料庫] --> G
  G --> P[短期預測：路徑、接觸時序、質心與角動量目標]
  P --> W[全身控制：關節加速度、力矩與預期接觸力]
  W --> A[關節致動器：力矩、速度、功率與變化率限制]
  A --> D[多剛體前向動力學與冰刀接觸求解]
  B[身體、靴刀、冰面 profiles] --> D
  D --> S[模擬感測：關節、慣性感測、刀上承重與滑移]
  S --> E[狀態估計：身體座標、質心、動量、接觸可信度]
  E --> G
  E --> P
  E --> W
  D --> V[唯讀快照：人物、冰痕、受力與驗證紀錄]
```

### 感知與狀態

- 真實模擬狀態 `x`：`q = {basePosition, baseQuaternion, jointConfiguration}`、`v = {baseSpatialVelocity, jointRates}`，加上致動器狀態、接觸／表面狀態。`q` 與 `v` 都包含浮動基底，只有物理引擎可寫入。
- 感測值 `y`：關節角與角速度、骨盆／胸廓陀螺儀和比力、各刀接觸位置與反力、相對滑移、局部冰面法向。IMU 比力不直接等同重力方向，估測時需考慮身體加速度。
- 估計狀態 `xHat`：身體相對重力的姿態、行進方向、各腳負重、質心、角動量、用刃／刀齒接觸可信度。MVP 先使用無雜訊的模擬感測，之後加入固定 seed 的延遲、雜訊與遮失；不能把此步稱為已驗證真人感知。
- 主體座標以骨盆的前、左、上為基礎，另外保存重力方向、刀身座標及世界速度。後退時身體前方與速度方向不同；速度接近零時不以 `atan2(0,0)` 強制重設朝向。
- 未來的冰面摩擦與真實狀態不是控制器可任意讀取的答案。先以已知平冰場驗證，再測未知低抓地區域；規劃使用估計值與不確定區間。

世界路書與游標目標需要位置／速度估計。初始位置與航向由已知場景錨點初始化；之後由慣性感測積分、關節與刀身運動約束更新，顯示累積漂移。冰刀在滑動，不能套用步行的「接地腳速度為零」假設；單靠慣性感測與接觸不能保證長時間絕對定位。MVP 的 `ideal-state` 模式明示使用理想位置／速度感測以隔離控制問題；`sensor-limited` 模式只允許已聲明的感測，例如冰場地標定位，或帶雜訊的模擬外部定位。估測器可用 EKF／互補濾波逐步擴充，包含 IMU bias 與可信度，不能偷偷讀取真實世界速度補正。兩種模式分別報告，不互稱為相同的感知驗證。

### 任務與動作元素

每個元素保存 `entryConditions`、`phases`、`taskTargets`、`exitConditions`、`abortOptions`、來源與可信度。階段可為準備、移重、推蹬、離冰、回收、落冰，含允許的時間範圍。

相位推進同時依據時間與事件。例如「接收腳已承重、原腳已卸重」後才回收；預期時間到了但尚未接冰，不能瞬間將支撐腳標籤改名。完成條件未成立時，可延長滑行、縮小轉角或接入恢復動作。預測路書不得修改真實引擎狀態。

### 規劃與全身控制

先以接觸階段狀態機 + 小規模候選預測實作，再升級質心／角動量 MPC；不以第一版就完成全身非線性 MPC 為前提。

全身控制器求解關節驅動，使足部、胸廓、雙手與動量目標在限制內成立。可用加權／分層 QP 求 `dv/dt, tau, lambdaPlanned`。接觸力在控制器內是預測值；物理引擎依實際狀態重新求得 `lambdaActual`。兩者的差是回授訊號，不能拿預測值覆蓋實際反力。

優先順序：關節／接觸硬限制 → 防止失衡與不合理穿透 → 完成支撐移轉與行進 → 參考姿態 → 音樂時點與表情。旋轉動作保留需要的角動量，不把全身角動量一律壓成零。

## 4. 身體自由度與脊椎近似

以下是**本專案建議的 reduced model**，不是聲稱人體只有這些自由度，亦不是已測得的個別選手活動範圍。

| 結構 | 每側／每組自由度 | 總數 | 處理方式 |
| --- | ---: | ---: | --- |
| 浮動骨盆 | 平移 3、旋轉 3 | 6 | 無根節點致動器；由外力與肢體運動共同決定 |
| 髖 | 3 × 2 | 6 | 屈伸、外展內收、軸向轉動 |
| 膝 | 1 × 2 | 2 | 主屈伸；必要時加入與屈曲連動的被動微轉，不當成任意扭轉軸 |
| 踝／足與靴 | 2 × 2 | 4 | 蹠屈背屈、有限內外翻；以靴的耦合剛度／阻尼限制 |
| 腰腹、胸廓 | 3 × 2 | 6 | 每組屈伸、側彎、扭轉，限制總活動量與節段分配 |
| 頸／頭 | 3 | 3 | 頭相對胸廓的轉動 |
| 肩 | 3 × 2 | 6 | 初版肩帶以耦合近似；不能無限拉長肩寬補姿態 |
| 肘 | 1 × 2 | 2 | 屈伸 |
| 前臂 | 1 × 2 | 2 | 旋前旋後；與腕屈伸分開 |
| 腕 | 2 × 2 | 4 | 屈伸、橈尺偏；掌向由完整運動鏈得到 |
| **合計** | **內部 35 + 根節點 6** | **41** | 指廣義速度自由度；四元數表示的位置變數數量可能不同 |

冰刀固定在靴上，第一版不另設腳趾關節；刀齒是刀的幾何接觸，不是腳趾致動器。肩帶若在伸臂、收臂或胸廓反轉時成為主要誤差，可新增每側兩個鎖骨自由度，成為 39 + 6 = 45 DoF；須透過相同保留資料比較才升級。

這一簡化可整理為 16 個物理剛體：骨盆、腹部、胸廓、頭部；每側上臂、前臂、手、大腿、小腿、足靴刀。旋前旋後是肘／前臂複合關節的獨立座標；引擎分解多軸關節時可能增加內部連桿物件，不增加物理自由度。

各段另有簡化碰撞形狀與鄰接過濾。靴刀相撞、腿部互穿、手臂穿過軀幹都需檢查；剪冰允許投影交叉，不能允許真實三維肢體穿透。解算與軌跡規劃共用碰撞模型，不能只有畫面上避開。

**脊椎不使用自由平移來配合影片。** 骨盆 → 腰腹 → 胸廓的有限長剛體鏈，透過兩組轉動自然產生胸廓位置變化；繪圖可用曲線連接，曲線不增加物理自由度。若需要微小位移，只能由明確的關節耦合函式導出，並計入 Jacobian 與慣量，不能新增無成本伸縮。

兩段式軀幹有研究依據：Hu 等人的運動模型比較中，拆開腰腹與胸廓能改善所測動作的追蹤；該研究不是花滑驗證。本計畫採其簡化方向，不直接複製其全部模型或宣稱個別椎間負荷可被準確推算。[研究全文](https://link.springer.com/article/10.1007/s10439-025-03762-7)

身體 profile 必須包含：父子關係、關節軸／順序、定長骨段、肢段質量、局部質心、慣量張量、耦合活動範圍、角速度、力矩－角度－速度包絡、功率與力矩變化率限制。不能只用所有關節共用的 `maxTorque`。初版用淨關節力矩致動器，省略個別肌肉；因此輸出是模型力矩／機械功，不是肌肉活化或選手生理負荷。

沿用 Hanyu 的既有身高與骨長作基準。57 kg 是現有 profile 引用的歷史名冊數字，不是比賽當日測重；手腳慣量與能力沒有個人量測。新 profile 區分 `athleteMass`、`equipmentMass`、`totalSimulatedMass`，裝備不得重複計入。重新拆分軀幹時保持總質量，檢查質心與慣量是否因拆分而無意改變。

## 5. 動力學與平衡

核心模型採浮動基底多剛體方程：

```text
M(q) vDot + b(q,v) = Sᵀ tau + Σ J_i(q)ᵀ lambda_i + fExternal
qNext = integrateConfiguration(q, vNext, dt)
```

`S` 只選內部關節；骨盆的六個自由度沒有虛構馬達。`b` 含重力及速度相關項。關節力矩受到能力包絡與功率限制；接觸力／衝量與身體積分一起求解。不得先把冰刀移回地面，再把修正後位置當物理解。

上式 `lambda` 是力／力矩；碰撞與離散接觸另用衝量 `pContact`，例如 `M Δv = dt(Sᵀtau − b + fExternal) + JᵀpContact`。跨越落冰衝擊時檢查動量／衝量殘差，不要求瞬間加速度有限。`fExternal` 僅供有名稱與紀錄的環境作用或測試擾動；控制器不得藉此施加骨盆扶正力，重力也不能重複加入。

控制器可使用較小的質心動量模型預測：

```text
m cDDot = m g + Σ F_i + F_external
Hdot = Σ ((r_i - c) × F_i + M_i) + M_external
H = Σ [ I_i_world omega_i + (c_i - c) × m_i (v_i - cDot) ]
```

這裡 `H` 包含手、腿、軀幹的相對運動。不能用單一剛體的 `I * omega` 取代全身角動量，再期待收臂、揮腿、胸髖反轉自然正確。

平衡判準是「可用接觸力／力矩、關節能力和可恢復的未來狀態是否足以完成目標」，不是要求每幀質心投影都在刀正上方。轉彎需要側傾；`tan(theta) ≈ v²/(gR)` 只適合近穩態圓周的合理性檢查，不能直接指定身體角度代替解算。支撐多邊形／ZMP 可作部分診斷，但不能單獨判定單刀滑行、刀齒接觸與騰空的穩定性。

失衡回應依當前接觸選擇：調整踝膝／髖與軀幹、移動自由腿與雙手、改變接觸位置、補一步、降低未來速度目標或中止動作。實際速度仍由可用阻力與驅動改變。無法恢復時記錄跌倒／失敗；若尚未實作身體碰撞，可在失敗事件暫停供檢視，不假裝站穩。

## 6. 冰刀、內外刃、刀齒與冰面 profile

### 6.1 幾何決定接觸候選

`BladeGeometryProfile` 描述縱向 rocker（允許主 rocker 與前端不同曲率）、橫向 hollow、刀寬、刀尾、刀齒位置／方向、刀與靴的固定變換。原有半徑 2.1 m 等數值是繪圖近似，先標示 `legacy-illustrative`，不冒充刀型測量。

每步從真實刀姿態找候選接觸，初版每刀至多 4 個有效接觸點作起始預算：可在單刃、雙刃及刀齒間分配，之後以加密收斂測試確認足夠。同一個接觸 patch 不能因增加採樣點就取得多倍抓地力。

接觸紀錄分三組，避免把不同物理概念混成互斥選單：

- 幾何／承重：`airborne / inner-rail / outer-rail / dual-rail / toe-pick`，允許多個接觸共存。
- 相對運動：沿刀滑行、側向黏著／側滑、旋轉滑移。
- 事件：碰撞落冰、卸重離冰、換刃；接觸標籤可有小幅 hysteresis，但不得使已離冰的刀繼續承重。

內／外刃依**左右腳的解剖刀側 + 實際接觸與承重**判定。重心位移是形成壓刃的原因之一，不是足以決定刃側的單一公式。顯示時另列 `intendedEdge` 與 `loadedEdge`；未知／雙刃／低負重保留明確狀態。軌跡取真正承重接觸點，離冰不畫；換刃不可跨 hollow 畫出虛構連線。

### 6.2 省去材料細算，保留當下受力

把冰刀接觸的速度分解成沿刀 `vParallel`、橫刀 `vLateral`，另保留法向速度與繞法向的旋轉速度。材料 profile 的主要輸入與輸出：

| 輸入 | profile 輸出／作用 |
| --- | --- |
| 刀型、刀齒／刃的接觸模式、俯仰／壓刃角、接觸位置 | 接觸 patch 幾何、阻力／抓地 response 的適用範圍 |
| 法向負重、估計接觸壓力、沿刀速度 | 沿刀阻力、低速過渡；負重本身由求解器計算 |
| 橫向速度、刃角、冰面狀態 | 橫向承載／切冰極限、超限後側滑與犁削阻力 |
| 旋轉速度、接觸 patch 與負重 | 有限旋轉阻力矩；不能給單點無限抗扭能力 |
| 法向接近速度、幾何與冰面模型 | 法向接觸的順應性／耗散與落冰處理 |
| 溫度、硬度、磨損、表面類別 | 選擇／內插材料 response；MVP 先固定一種均勻冰面 |

離線保存低維分表或分離近似，不建立不可校正的巨大八維表。幾何可預存刀上局部 patch 候選與插值係數；世界接觸位置、Jacobian、法向力、關節力矩與平衡誤差仍依當下身體計算。若需要熱／刻痕記憶，另設可重播的少量表面狀態；無記憶查表無法表示累積磨損。

壓刃角、速度、溫度、負重會影響冰上接觸；速度滑冰的傾刀模型與一般冰摩擦實驗可提供依賴關係，但不能直接當成花式冰刀的量測係數。[傾刀模型](https://arxiv.org/abs/1910.13802)、[冰摩擦實驗](https://journals.aps.org/prx/abstract/10.1103/PhysRevX.11.011025)

### 6.3 即時接觸求解

法向接觸滿足非吸引性；硬接觸可用間隙／正向衝量互補，或使用具有已知誤差與能量帳的順應性近似。不要混用兩套法向模型重複加力。

方向性的橢圓／力界線是初版可用的數值近似：

```text
F_normal >= 0
(F_parallel / C_parallel)^2 + (F_lateral / C_lateral)^2 <= 1
```

`C` 是 profile 與當下負重提供的容量，不是固定測得的冰面摩擦係數。容量約束只限制可行反力，**不足以決定真實滑動阻力**；還需要與速度相關且耗散的接觸律。接近零容量需有退化分支，不能直接除以零。

法向力與 profile 容量相互依賴：以先前負重 warm start，再有限次更新接觸力與容量，檢查殘差；不直接把體重除以站立腳數當作負重。接觸點的力臂自然產生力矩；若另加 patch 旋轉阻力，避免與離散點產生的同一力矩重複計算。

殘差超限時可在既定預算內回退並細分物理步重試；細分次數與最小步長先設定並記錄。仍不收斂則標示 `numerical-failure`，不接受未收斂的衝量為成功步。這與身體真的滑倒／失衡分開，避免把數值失敗誤認為技術不可行。

沿刀滑行不應被足部「全方向鎖地」約束消除。橫向在有限容量內可近似黏著，超過則允許側滑。低滑移的非完整約束只能作可比較的簡化模式，不能在刃轉、旋轉或側滑時無條件鎖住。

刀齒是獨立的小範圍接觸：需要實際幾何觸及、有限負重／嵌入／剪切承載，並可脫離；不能指定成世界固定鉸鏈。刃跳與點冰跳的接觸序列應不同，但都由關節作功與反力產生起跳。

**減速／停止技能使用刀刃側滑，不以刀齒制動。** 先驗證雙腳漸進犁式，再做後置拖刀與 hockey stop。將實際刀向相對行進方向、立刃角、負重和側滑速度納入控制；協調重心與關節力矩抵抗接觸力矩，接近停止後平順轉入站立。意外刀齒承重需使此技能驗證失敗，保留其碰撞及力學後果。必須有相同初始狀態的自然滑行對照，不能用跌倒造成的降速或單純期末低速宣稱煞停成功。2026-09-26 的實作與限制見[煞停量測紀錄](robot/BRAKING.md)。

被動接觸的切向力與力矩不得製造淨能量；監測接觸相對速度的功率與法向順應性儲能。摩擦可以將推蹬轉為前進的動量改變，但能量來自關節作功，不是直接給根節點「推力加成」。

完整能量帳使用 `Δ(T + Vgravity + Velastic) = Wactuator + Wexternal − Edissipated + numericalResidual`。彎膝降低質心、已有肢體動能轉移或靴部彈性能釋放，可能在沒有新致動器正功時增加瞬時行進速度；不能只看根節點速度增加就判定能量造假。所有主動／被動力只計入一次，數值殘差獨立報告。

### 6.4 profile 的可信度與建立程序

每份資料保存 `schemaVersion, id, units, provenance, evidenceClass, validDomain, uncertainty, calibrationSet, validationSet, hash`；`evidenceClass` 分為 `measured / literature-model / prototype / legacy-illustrative`。低阻力、一般、易側滑三種 profile 可以用於敏感度測試，名字不代表量測過的實際冰場。

1. 幾何先從刀型資料或測量建立；無資料則沿用有標籤的原型。
2. 以有公尺尺度、時間與負重的滑行減速、傾刀側滑、旋轉衰減、刀齒接觸資料校正。只有單視角影片時，不能唯一反推摩擦、肌力與冰刀參數。
3. 現有 `.8 lateralGrip / .08 longitudinalGrip` 僅作舊模型對照，不升格為新的「合理實測值」。
4. 先以守恆與敏感度驗證工程 profile，再另以未參與擬合的資料驗證。沒有量測時只能聲稱模型穩定／現象合理。
5. 查表出界必須回報並使用明確的保守替代或拒絕該動作；禁止靜默外插並宣稱精確。摩擦參數插值要維持非負、耗散與容量限制。

## 7. 引擎選擇與執行成本

建議先用 **MuJoCo 原生環境作動力學參考實驗**，透過小型垂直切片評估自訂冰刀接觸，再決定同核心的 WebAssembly 打包路線。它具有多剛體、關節限制、接觸與各向異性摩擦能力；但一般形狀設定的三個摩擦值不是「沿刀、橫刀、旋轉」三者。各向異性需要接觸 pair／接觸座標的正確設定，並驗證切線軸隨刀向旋轉。[官方接觸說明](https://mujoco.readthedocs.io/en/stable/modeling.html#contact-parameters)

這是引擎候選選擇，不是已有可用的瀏覽器建置。WASM 編譯、接觸擴充介面、離線載入、授權包裝與性能都列為 P1 可行性門檻。若不符合需求，沿相同協定選另一個成熟 articulated-body 核心；不先在 JavaScript 中從零寫一套未驗證全身動力學，再拿自己產生的結果驗證自己。

| 工作 | 第一輪工程目標頻率 | 說明 |
| --- | --- | --- |
| 剛體、致動器、接觸 | 240 Hz 固定步長 | 是測試起點；與 480 Hz、接觸加密比較，落地不足時提高精度 |
| 全身控制 | 120 Hz | 輸出有界力矩並在物理步持有；需驗證接觸突變延遲 |
| 短期預測／MPC | 20–30 Hz | 預看約 0.5–1.2 s，warm start；非已有測得的性能 |
| 音樂與任務管理 | 10–20 Hz + 事件 | 音樂決定意圖／相位目標，不改變物理步長 |
| 畫面 | 30–60 Hz | 只插值快照；冰痕取物理接觸，不取繪圖插值足點 |

核心在 Web Worker 中執行，以 typed arrays 傳遞快照；手機與桌機都先量 p50/p95/p99、接觸求解迭代與啟動成本。初步預算以每個 60 Hz 顯示區間的模擬＋控制 p95 小於 8 ms 為評估目標，並非性能承諾。超時先減少預測候選／繪圖頻率，不能放大物理步長跳過接觸。

模擬時間、音樂時間與牆鐘分離。姿態／參考資料離線預算，物理只計算即將播放的一小段；音樂落後或追上能力不足時以同一緩衝策略暫停／恢復。不能再讓音樂先走、模型仍等待整曲計算。即時麥克風無法暫停來源，改採明示且有界的輸入緩衝／延遲，測試另列。

拖曳時間需從檢查點前向重播；檢查點包含 `q,v`、致動器、控制器積分與規劃器狀態、接觸 warm start、動作相位、路書與待處理指令、surface state、估測器狀態／共變異數、感測延遲佇列／遮失狀態、PRNG 當前狀態與 profile hash。seed 只足以從頭重播，不能代替中途 PRNG 狀態。不能只取某個姿態就宣稱是同一物理歷史；同一建置驗證可重播，跨引擎／硬體則報容差，不能預設逐 bit 相同。

## 8. 資料與模組契約

下列是模組規劃；目前已實作的檔案與尚未完成的部分見 [實作紀錄](robot/README.md)，不以空目錄作為完成證據：

```text
ice/robot/
  profiles/       body, actuator, boot-blade, ice-response, skill
  model/          skeleton, mass properties, coordinates, profile compiler
  contact/        blade geometry, patch selection, response table adapter
  dynamics/       engine adapter, fixed stepping, checkpoints
  sensing/        sensor sampling, state estimator, noise/latency profiles
  control/        phase manager, centroidal planner, whole-body controller
  retarget/       observed landmarks / fitted motion -> task references
  diagnostics/    energy, momentum, contact, limits, recovery, replay
  robot-worker.js
  robot-view-adapter.js
robot-study.html
verification/ice/robot/  manifests, deterministic cases, plots, reports
```

擬保留協定：`init / command / step / snapshot / reset`，增加 `checkpoint / restore / perturb / set-profile`。每筆命令綁定固定步號、強度與版本；更換 morphology 或接觸 profile 須明示重設或另開測試，不能中途偷偷改慣量。原路書和主頁繪圖可透過 adapter 共用，核心不能讀 DOM。

```text
Command: {id, stepIndex, intensity, intent, expectedEntry, generation}
Observation: {stepIndex, joints, imu, bladeLoads, contactSlip, uncertainty}
TaskReference: {phase, jointTargets, bladeTargets, comTarget, momentumTarget, timeWindow}
Actuation: {jointTorques, saturatedJoints, mechanicalPower}
Snapshot: {stepIndex, q, v, pose, contacts, com, momentum, phase,
           diagnostics, events, profileHashes, generation}
```

`pose` 由同一個 `q` 做正向幾何輸出；繪圖不得再次呼叫舊 IK 改動腳踝或骨盆。保留手腕／前臂／掌向，以及接觸點、rail ID、負重、滑移、預期與實際用刃。

## 9. 動作資料如何進入新模型

Oleg、羽生與 skopinaskate 的來源、既有 observations 和保留驗證點不動。依 [`MOTION-RECONSTRUCTION-WORKFLOW.md`](MOTION-RECONSTRUCTION-WORKFLOW.md) 執行：

1. 先保留已完成的鏡頭配準與觀測可信度。影片取景不是物理攝影機／公尺位置量測，來源鏡頭不能直接決定物理力或速度。
2. 在新骨架上重新做受限 retarget／擬合：固定 Hanyu 骨長，以可信 landmarks、接觸與姿態連續性求參考關節，人工角度只作初始化。
3. 將轉折、接冰、離冰、手部收放標為事件窗口；較快動作使用密集觀測。誤差峰值是補採樣線索，不等於已測出真人發力時點。
4. 離線軌跡最佳化建立可追蹤 reference，保存必要的速度、接觸意圖及 feedforward torque。無法同時貼合影片與物理條件的區段標示矛盾，不以根節點補償力掩蓋。
5. 即時控制在相同動作內可調節相位、關節與接觸時序；來源參考不等於強制播放的答案。
6. 分開報告投影誤差、接觸事件誤差、動力學殘差、控制成功率。全部自由度的三維真值與真人受力目前並不存在。

這條「影片姿態 → 軌跡最佳化 → 回授控制」在花滑研究已有先例，但該研究也指出簡化刀形與轉向約束會引入不真實能量、旋轉仍有困難。因此這裡把能量與接觸驗證放在增加花式動作之前。[Yu、Park、Lee，2019](https://mrl.snu.ac.kr/research/ProjectSkate/Figure_Skating_Simulation_from_Video___PG2019.pdf)

## 10. 驗證頁規劃

`robot-study.html` 延續求解頁的路書、強度和方向控制。主畫面配一個小型俯視圖；第一人稱鏡頭只是可選檢視方式。

- 主畫面：人體、實際冰痕、質心、重力、刀上反力與滑移箭頭；可並列「參考姿態／舊求解／閉環機器人」。
- 身體狀態：左右負重、內外刃／刀齒、前後進、胸髖角差、雙手掌向、角動量及當前相位。
- 能力限制：哪一個關節已達力矩／角速度／功率限制，哪一刀容量不足；顯示動作延後或改接的原因。
- 測試工具：固定 seed、固定方向／量級的外推衝量、降低局部抓地、改變感測延遲；重設／單步／慢速／匯出完全相同的場景。
- 對照：無回授、只有姿態追蹤、姿態＋動量控制；同樣 reference、初始狀態與擾動，不用不同 seeds 製造優勢。
- 檢視模式允許失敗停格，物理模式如未跌倒則繼續嘗試恢復；兩者清楚標示。

## 11. 實作順序與完成門檻

以下 P0–P7 保留工程研究工作分解及原驗收方向。當前交付依上方 S1–S5 推進：在固定、可用的簡化接觸與骨架下，動作開發、有限任務訓練可與 P1／P2 深入驗證並行，不需等待整個 P1／P2 清單通過。會使動作明顯失真或數值失控的問題，仍在受影響任務內優先修正。

| 階段 | 工作與交付物 | 通過條件 |
| --- | --- | --- |
| P0：固定契約 | morphology／單位／座標／profile schema，舊引擎 baseline、來源與未用驗證集、所有輸入 hash | 無 generic/Hanyu 混用；左右腳、前後進、角度單位、質量與慣量一致 |
| P1：物理垂直切片 | 一把刀＋受控載重、後接最小雙腿模型；原生引擎、WASM/Worker 可行性 | 滑行耗散、方向性接觸、刃角改變 patch；步長與採樣收斂；瀏覽器成本可接受；測試載重夾具不能帶進自由滑行驗證 |
| P2：身體與重定向 | 41 DoF 骨架、兩段軀幹、力矩能力 profile、碰撞模型、已擬合姿態轉換 | 定長、耦合角度、掌向與靴限制；三維自碰撞；新舊軀幹同資料比較；不使用待驗證影格調參 |
| P3：站穩、滑行與換腳 | 感知、狀態估計、有限力矩控制、移重、自由滑行、恢復策略 | 平冰面、無預存可釋放能量的被動滑行不生能；負重轉移與總能量帳合理；可重現小擾動恢復，失敗明示 |
| P4：持續推進與弧線 | 前／後 stroking、Power Pull、連續左右 crossover、煞車 | 推進可追溯關節作功、接觸與能量轉換；連續剪冰無重設接縫、無腿／靴穿透；推腳回到解剖原側 |
| P5：轉身元素 | Three Turn → Rocker／Counter → Loop；以相同足／刃與方向入口驗證 | 接觸與相位連續、無強制根節點偏航；弧線／刃側／事件與參考對照，容許明示失敗 |
| P6：旋轉、刀齒與跳躍 | 原地旋轉、小跳、點冰／刃起跳、落冰；逐項增加難度 | 空中動量、起落衝量、收臂反應與能量損失收斂；只有明確順應性模型、解析接觸歷時與量測頻寬時才比較衝擊力峰值；不靠改姿態製造高度 |
| P7：Serenity 整合 | 音樂意圖 adapter、分段緩衝／檢查點、頁面切換與相同時間比較 | P4 以上適用元素先接入；未通過元素不排入「物理已驗證」節目；首播／跳轉／重播同步 |

**首個可交付版本改為固定環境的 S1 完整停止指令，再交付 S2 的推進—滑行—停止流程。** 不等待不同阻力、連續剪冰與完整 P0–P4 認證全部完成。P 階段仍記錄各項工程證據；Serenity 可逐步接入已完成的虛擬動作元素，並明示其簡化環境。

### 共同驗收，不混成一個「正確率」

| 層級 | 記錄指標／案例 |
| --- | --- |
| 數值與守恆 | 無外力自由運動、空中角動量、被動滑行能量、步長減半、接觸加密、重播差值 |
| 動力學閉環 | 連續步的 `M vDot + b - Sᵀtau - Jᵀlambda - fExternal` 殘差；衝擊步的離散動量／衝量殘差；總能量帳、功率與接觸容量飽和 |
| 技術動作 | 支撐腳、刃側、刀齒、離冰／落冰時點、推腳回收側、週期銜接、來源中的轉折與手部收放 |
| 控制能力 | 指定場景／速度／冰面下成功率、擾動恢復時間、路徑偏差與失敗原因；只適用該測試集合 |
| 來源吻合 | 保留時點的投影誤差、輪廓／面向、鏡頭與動作事件分開；不能換算成真人力學正確率 |
| 執行與產品 | CPU p95/p99、音樂同步、幀遺失、Worker 重設競態、檢查點恢復；桌面／手機分開報告 |

具體數值門檻在 P0 依尺度、來源不確定度與對照引擎先行固定，不能看完結果再改。首輪需至少保留以下負例：過低抓地仍硬轉、過大速度仍三轉、空中靠揮手憑空增加總角動量、無驅動靠 Power Pull reference 自行加速、刀齒未接地卻成為支點。

## 12. 研究依據與適用界線

以下為一手研究／官方技術說明；查核日期 2026-09-25。模型自由度、頻率與模組配置均為本計畫的工程選擇，並非論文原樣實作。

| 來源 | 本計畫用途 | 適用限制 |
| --- | --- | --- |
| [Yu, Park & Lee，Figure Skating Simulation from Video，2019](https://mrl.snu.ac.kr/research/ProjectSkate/Figure_Skating_Simulation_from_Video___PG2019.pdf) | 來源姿態、離線最佳化與回授控制可分工 | 簡化接觸仍有轉向能量與旋轉問題，不當成完備花滑物理 |
| [Hu 等，An Augmented Full-Body Model…，2025](https://link.springer.com/article/10.1007/s10439-025-03762-7) | 分開腰腹、胸廓、頸肩的建模取捨 | 所測運動不是花滑；兩組脊椎關節不提供椎間受力真值 |
| [Tazaki，Humanoid Dance Simulation Using Hybrid Model Predictive Control，2024](https://www2.kobe-u.ac.jp/~tazaki/docs/tazaki_humanoids2024.pdf) | 質心預測與全身動力學使用不同精度／時域的架構 | 人形機器人舞蹈模擬，不是冰刀接觸驗證 |
| [Quillen & Dean，Models of Ice Skating…，2021](https://www2.eecs.berkeley.edu/Pubs/TechRpts/2021/EECS-2021-162.html) | 非完整約束、混合接觸與滑行規劃的簡化基準 | 簡化機器人步態，不直接覆蓋花滑旋轉／刀齒 |
| [van Leeuwen，The Friction of Tilted Skates on Ice，2020](https://arxiv.org/abs/1910.13802) | 傾刀角與速度對阻力的 response 結構 | 速度滑冰刀；不直接搬用到花式刀 |
| [Liefferink 等，Friction on Ice，2021](https://journals.aps.org/prx/abstract/10.1103/PhysRevX.11.011025) | 溫度、壓力、速度與壓入／犁削作用 | 實驗接觸不是完整花式冰刀，不能給出通用花滑係數 |
| [Acuña 等，Instrumented Figure Skating Blade…，2014](https://scholarsarchive.byu.edu/facpub/2015/) | 若要驗證真人受力，需獨立刀上力學量測 | 測量分量有限，不能當成全方向摩擦校正 |
| [MuJoCo：Computation](https://mujoco.readthedocs.io/en/stable/computation.html)、[Modeling](https://mujoco.readthedocs.io/en/stable/modeling.html) | 接觸／關節動力學核心候選 | 引擎能力不等於已建立正確的花滑接觸模型；瀏覽器包裝需另驗證 |

暫不採用逐椎骨／全肌肉、水膜熱流／冰晶破壞即時計算；也不把端到端強化學習當成第一步。若後續加入 learned controller，只能在固定的模型與獨立測試上比較，保留力矩限制與能量／接觸檢查。需另防止策略利用接觸或插值漏洞完成動作。

最初交付為設計文件；後續實作保留原滑行動作、既有研究參數與預設選項。新引擎在獨立實驗頁逐項驗證，尚未接入音樂編舞。部署狀態與測試結果分別記錄。
