# 軌跡 · 求解實驗

後續架構計畫：[`滑冰機器人：以身體為主體的閉環控制`](SKATING-ROBOT-ARCHITECTURE.md)（2026-09-25）。規劃多剛體、關節驅動、冰刀接觸 profiles 與感知回授；尚未取代本頁的簡化求解器。

入口：[`solver-study.html`](solver-study.html)，也可由[軌跡](index.html)與[系列研究](research.html)進入。這是獨立的人工輸入驗證頁，與音樂滑行及影片動作分析共用身體模型，使用自己的指示與求解流程。

## 使用方式

1. 主畫面右上方的俯視圖每格 2 m，跟隨目前位置；點選即將座標目標加入路書，採用點選當下的目標速度、強度及自動剪冰設定。金色十字表示目前已交給求解器的目標。目標速度為零時，先按 W 推進，再點選位置。
2. 右側集中播放、強度、推進、方向、換腳、減速與銜接動作；鍵盤操作相同。方向、動作與目標依序執行。下方僅保留初始條件，不再重複提供目標與動作輸入表單。
3. 「開始／暫停」「前進 1 格」控制求解時間。初始質量、速度、支撐腳及前後向需按「重新開始」套用。
4. 對照按鈕從固定條件開始：正常速度、不同支撐腳、高速三轉，以及 Power Pull。比較準備階段、延後理由、受力與事件紀錄。
5. 匯出 JSON 保存初始條件、按固定步數索引的指示、末端完整快照與約 10 Hz 診斷。診斷最多保留最近 30 分鐘；引擎的指示序列用於重播。播放牆鐘與硬體耗時不是物理狀態，不要求逐次一致。

無音訊、整段重播或任意時間跳轉，讓指示與動作結果可重現。剪冰可依目前目標持續推蹬，並非重播錄製片段。切換到背景頁籤會暫停，避免一次補跑大量模擬步驟。本機 `file://` 不允許 Worker 時，頁面會使用同一核心的主執行緒備援；狀態列會標示。

## 鍵盤與銜接選項

滑行畫面左上方的**滑行路書**以方向符號、動作名稱和順序號顯示目前項目及接下來三項；上方保留候補總數。一般指示按照 FIFO 執行，完成後自動推進。W、A、D、F 可在上一個動作進行時加入候補，M 只改變下一次 W 的推進方式。相對左右轉在執行時解算，兩個左轉指示不會被合併成最後一筆。

同側剪冰最多預送下一項，利用真實週期接縫交接路書；不同動作則等前項安全完成。「清空候補」保留目前動作，並撤銷已預送但尚未接入的下一輪。S／停止是即時介入：取消候補、關閉後續自動剪冰，保留當前接觸動作安全收尾。空白鍵只暫停時間，路書仍保留；「重新開始」清空整份序列。

路書不把命令收到回覆視為完成。完成依求解快照中的接觸階段、週期／動作交接或滑行目標達成判定。若求解器停止驗證，項目會保留供檢查。匯出 JSON 同時包含路書狀態及實際送入核心的指令；尚未執行的候補不會偽裝成已執行的重播紀錄。

| 按鍵 | 指示 |
| --- | --- |
| [ / ] | 強度減少／增加 25%；範圍 25%–200%，預設 100% |
| W / ↑ | 蹬冰／Forward Power Pull：目標速度累加 0.35 × 強度 m/s；滑行模式則維持滑行 |
| A / ←、D / → | 目標航向向左／右增加 20° × 強度；預設自動接入符合前後向的剪冰 |
| F | 切換支撐腳，經過落冰、移重、原腳釋放，不瞬間改名 |
| M | 循環選擇推進方式；選擇本身不啟動動作 |
| S / ↓ | 由實際／目標速度較低者減去 0.35 × 強度 m/s，連按可停止；清除待執行動作，保留必要接觸銜接 |
| 1 / 2 / 3 | 將畫面對應的預估銜接選項加入路書末端 |
| 空白鍵 | 播放／暫停 |

移動／動作鍵會開始播放。一次按下執行一次，不接受鍵盤自動重複；強度調整鍵可按住連續調整。輸入框、下拉選單、可編輯文字、中文輸入法組字與 Ctrl／Alt／Command 組合保留正常用途；強度滑桿有焦點時仍可使用方括號快捷鍵。按鈕有焦點時，空白鍵保留原生按鈕操作。可取消「鍵盤指令」，改以畫面按鈕操作。

方向指示會清除座標目標，改用航向。左右依**行進方向**定義，後退時仍維持後退姿態，不把左右鍵解讀成身體立即掉頭。W 的蹬冰／Power Pull 從上一筆目標速度累加 `0.35 × intensity`，最高 4 m/s。蹬冰完成後保留目標速度供下次 W 累加，但滑行不會替未達到的目標持續加速。畫面分別顯示實際／目標速度；實際推蹬仍受入口速度、接觸與正功條件限制。滑行模式保留當前速度，原地不會無故加速。原地或後退使用 Forward Power Pull 時，會明確改為蹬冰準備／延續，保留這一版的前進入口限制。S 從實際／目標較低者減速，避免按下煞車時仍追趕較高的目標；下一次左右指示再依勾選設定啟用自動剪冰。

強度在按鍵、按鈕或地圖點選當下擷取，早於非同步 Worker 回覆；推薦選項和示範情境也遵守此規則。每筆路書、預估與匯出指令保留自己的 `intensity`，改變滑桿不修改舊指令。除 W 的速度目標可逐次累加，其他動作只使用自身強度：左右改變單次角度，剪冰／Power Pull／蹬冰改變受限的推進幅度，換腳／三轉小幅調整執行節奏；不改變支撐腳、三轉前後向翻轉或接觸安全條件。強度不是人體肌力的量測值。

曾完成推進後，如果三轉消耗滑速，後續三轉、前進 Power Pull 或明確指定的剪冰，可先執行可見的準備蹬冰，再移重回原指令指定的支撐腳。準備保留該指令的強度、支撐腳與入刃，最多五次；仍不足便保留待執行動作並提示調整。這不算原指令已完成，也不在一般滑行時憑空補速。自動轉向、新建的靜止 Power Pull 與後退 Power Pull 仍保留原本的入口限制。

`solver-controls.js` 是純函式的輸入與銜接規則層。`solver-forecast.js` 沿用這些規則，先依目前動作及路書候補逐項推估完成後的狀態，再從末端的支撐腳、身體前後向及預期用刃提供最多三個選項：

- 優先列出目前刃側的三轉；平刃時標示先建立入刃。
- 另一刃側的三轉明列「先入內／外刃」，不把換刃當成瞬間完成。
- 有滑速且需要轉向時，第三項提供對應的前／後、左／右剪冰；其餘狀態則提供同腳 Power Pull 或蹬冰準備。總數仍不超過三項。

同腳三轉的四種入出狀態為 FI→BO、FO→BI、BI→FO、BO→FI；對應前內→後外、前外→後內、後內→前外、後外→前內。定義依 [US Figure Skating 規則 8105 A](https://members.usfsaonline.org/sites/default/files/media-files/2025-26%20Rulebook.pdf)及 [Skate Canada：Three Turn](https://info.skatecanada.ca/index.php/en-ca/other-categories/defined-terms/196-three-turn.html)，屬花式滑冰動作。

正在銜接或已有待執行動作時，仍可用按鈕／1–3 接著排下一項。例如左腳前內三轉尚未開始，路書末端已可預估為左腳後外，因而提供後外三轉回到前進。按 F 排入換腳後，推薦也會改依新的支撐腳產生。畫面標示推薦所依據的末端狀態；展開「路書動作狀態預估」可逐項查看動作前後的支撐腳、前後向與用刃。

預估依已選動作的轉換規則計算，不執行整段物理模擬。進行中的三轉從其起始狀態推估一次，避免轉身後又重複翻向；未知的刀刃或滑行出口會保留不確定條件。按鍵擷取選項 ID 與當時路書狀態，等待 Worker 後仍需相符，過期選項不會偷偷換成同位置的新動作。真正輪到該項時，再核對預期支撐腳與前後向；若已不符，保留候補並提示重新安排。刃側不同則先準備指定入刃，接觸與受力仍由核心檢查。推薦是可安排的動作條件，不是物理可行性的保證。

蹬冰是一次「接收腳落冰 → 移重 → 原腳推蹬 → 離冰回收」的簡化動作。通過正功與接觸力檢查後才更新速度，完成後改由接收腳支撐；它尚不是肌肉與刀冰作用的全動力學求解。目前為低速範本，速度超過 1.8 m/s 會先放緩至 1.7 m/s 再開始。

## 剪冰：四種方向與自動選用

頁面預設勾選「轉向時自動剪冰」。A／D、左右方向鍵與座標目標的轉向需求會送入同一個自動判斷：檢查滑速、行進方向、航向誤差及目前動作，再選用剪冰。已有三轉、Power Pull 或換腳時先完成接觸序列；相反方向的新指示不能在跨步中途直接交換兩腳角色。接近目標航向後接回滑行，不在微小方向誤差下反覆開始。靜止時只記錄方向目標，需要先推進取得滑速。

同方向的需求持續時，第一次進入後直接接下一輪推蹬；回收腳在原側落冰承重，另一腳保持接冰準備推蹬。週期之間不插入一般滑行、不重新抬腳落下，也不交換解剖腳別。必要的雙腳移重仍保留時間，避免用瞬間切換承重製造看似流暢的效果。「連續剪冰」兩個對照按鈕可觀察完整過程；也可在剪冰期間繼續按 A／D 更新目標方向。

剪冰入口至少需 0.45 m/s；高於 1.8 m/s 先放緩。追蹤座標目標時會依剩餘動作時間提早減速，距目標 1.2 m 內不再開始新剪冰，交由一般滑行收尾。這些是目前原型的控制門檻，不是滑冰教學標準。

取消勾選可比較一般弧線滑行。S／↓ 會減速並取消後續自動循環，正在進行的接觸銜接會平滑完成。停止、改向或選擇其他動作，也會先安全收尾，再銜接下一個動作。「剪冰 · 四種方向」提供四個獨立起始情境；每個情境只執行一段，方便比較。也可用左右指示自動接入剪冰，或由「接下來可以…」將可用的剪冰加入路書；前後向依當時姿態決定。

| 當前姿態 | 行進轉向 | 外側跨入腳 | 內側下推腳 |
| --- | --- | --- | --- |
| 前進 | 左 | 右腳 | 左腳 |
| 前進 | 右 | 左腳 | 右腳 |
| 後退 | 左 | 左腳 | 右腳 |
| 後退 | 右 | 右腳 | 左腳 |

這裡的內外是圓弧角色；內側腳以外刃引導／下推，外側腳以內刃跨入承重。後退時身體面向與行進方向相反，因此同一個「向左」指令的解剖腳別會改變。依據與座標推導見 [CROSSOVER-SOURCE.md](CROSSOVER-SOURCE.md)，採花式滑冰來源，沒有套用冰球持桿姿態。

剪冰使用跨入、落冰、移重、下方腳推蹬及回收的連續腳步位置；根節點與身體朝向仍由原求解器控制。前剪冰抬腳跨入，後剪冰先貼冰推蹬並取得前後錯位，再交叉，避免刀身互穿。本版單次完整動作為 7.2 秒；需要續接時，在相位 0.95 接到前剪冰 0.06／後剪冰 0.07，略過只用於進出滑行的動作。後續週期約 6.4 秒，屬於便於檢查的低速示意，不是教學影片測得的節奏。

核心保留 `segment`（首次進入／週期／退出）、從零開始的 `cycleIndex`、已續接次數 `continuations` 與已消費的指令 ID。同方向的手動剪冰指令只保留一個待續接要求；反覆送出不會堆疊多段重播。自動模式在接點依最新目標、距離及速度判斷是否續接。短期預測也使用相同規則，但不消費真實指令、不新增真實事件；只有通過檢查的實際步進才更新紀錄。

驗證需要看實際冰刀的三維間距、接冰次序、反力分配與支撐腳延續，不能只憑投影中的兩腿相交判斷。`state.support` 在剪冰中保留起始／回接的圈內腳角色；畫面的「主要承重腳」改依當下求解的正向反力判斷，因此能顯示跨入腳接重、雙腳移重，再回到圈內腳。完整人體碰撞、肌肉力矩與冰刀切冰仍不在此原型的求解範圍。

### 沿刀弧滾動的接觸位置

依 [Ice Coach Online 的承重教學](https://www.youtube.com/watch?v=DRwBOAwcFBk&t=62s)，前剪冰滑行以中後段接冰，推蹬時才沿 rocker 逐漸向前滾出；影片 1:40 起一直壓前端的示範是錯誤對照。模型分別控制外腳推蹬及內腳下推的接觸位置，透過刀身俯仰產生實際 `contactU / contactPoint`，再供冰痕、踝膝姿態與平衡檢查使用。

外側腳先落冰承重、沿刀弧推蹬，再抬腳跨入；接續內腳下推時也要在仍承重時完成滾動，卸重後才離冰。正加速度候選只在兩段推蹬窗口提出，減速仍可在其餘階段進行。每刀保留 `role / rockerStage / requestedContactU / rockerProvenance`，便於分辨動作角色、幾何接觸目標與來源範圍。進入與離開剪冰時平順銜接原滑行的接觸策略。

「刀上接觸與承重」圖的圓點讀取每刀實際接觸位置，百分比讀取求解的正向反力。沿刀長的前後位置和左右腳的承重比例是不同的量；離冰腳不顯示接觸點。這些是簡化模型輸出，不是影片人物的壓力量測。後退偏前接觸僅援用影片的一般方向提示，沒有把前剪冰推蹬曲線直接倒播成後剪冰；詳細來源與工程參數見 [CROSSOVER-SOURCE.md](CROSSOVER-SOURCE.md)。

### 回到原側與離冰腳踝

外刃下推腳卸重後，在空中回到支撐腳的另一側、自己的解剖原側，再落冰承重。以前進右剪冰為例，右腳回收到左腳的右側；鏡像左剪冰則由左腳回到右腳的左側。驗證以落冰瞬間的實際腳位與身體左右軸判斷，不能用動作標籤或最後恢復平行的畫面代替。

推蹬後的自由腳可漸進伸踝，腳尖隨腿後伸，再於回收落冰前對準接冰姿態。接冰中的刀弧滾動與離冰後的腳踝伸展分別處理；檢查包含實際冰刀方位、離冰間隙及落冰前後的連續性。伸展幅度為通用動作近似，未經人體量測校正。

此版自由腳增加最多約 0.22 rad 的伸展控制，以 `ankleExtension` 記錄；它與由刀弧接觸導出的 `rockerPitch` 分開，接冰時伸展控制為零。`shinRelativeAnkleAngle` 由實際膝、踝與刀身方向量得，用於檢查幾何變化，不是完整踝關節多軸解剖模型。下推腳回到原側落冰後，`cycle-transfer` 保持左右腳序並平滑移重；仍需同向剪冰便直接接下次推蹬，只有真正退出時才進入 `stance-settle` 接回一般滑行。

## 執行架構

```mermaid
flowchart LR
  A[人工目標與動作] --> B[入口條件與動作階段]
  B --> C[短期候選路徑]
  C --> D[關節 IK 與曲面冰刀接觸]
  D --> E[肢段質心 慣量 接觸反力檢查]
  E --> F{候選可行?}
  F -->|是| G[執行一個固定時間步]
  F -->|否| H[延後準備 或停止並顯示原因]
  G --> C
  G --> I[同一姿態輸出 SVG 軌跡 診斷]
```

- `solver-physics.js`：14 個肢段的通用質量比例、肢段重心、慣量張量和平行軸轉換；各段腿與手臂分別計算，膝、肘位置會影響總質心與慣量。
- `solver-core.js`：固定 1/60 秒積分，約每 0.1 秒比較七個候選控制，各看向未來 0.54 秒。依候選可行性及目標偏差選擇下一步；這是有限候選搜尋，不是全自由度最優控制。
- `solver-controls.js`：將鍵盤意圖或狀態相關選項轉成指令；與 UI 無關，可獨立驗證。核心提供 `stroke / switch-foot / three-inside / three-outside / crossover-left / crossover-right`、絕對行進 `heading` 與 `autoCrossover` 開關，保留舊的左／右腳三轉介面。
- `solver-roadbook.js`：保存 FIFO 指示、目前項目與最多一個同側剪冰預排，依實際求解狀態推進；與 DOM、播放牆鐘分開。
- `solver-forecast.js`：以動作規則推估每項前後狀態及路書末端，產生附預期入口的候補選項；不取代實際求解檢查。
- `solver-worker.js`：序列化 `init / reset / command / step / snapshot` 訊息。使用同一核心；不直接操作 DOM。
- `solver-view.js`：只投影快照，不重算姿態。冰痕使用該快照的實際接觸點；抬腳與換刃會分段，不連成虛構接冰線。
- `solver-study.js`：輸入、單步、播放、記錄與 Worker 備援。主執行緒與 Worker 都採固定步進；慢速硬體允許播放變慢，不藉大步長跳過檢查。

身體座標的前、左、上軸隨骨盆朝向；世界座標保留重力與冰面。前後向切換時改變身體朝向，世界中的行進速度保持連續。不同支撐腳先落腳、移重，再進入三轉；高速時先減速，不能直接開始轉身。

拒絕執行的候選保存在 `rejectedPose / rejectedDiagnostics`，與畫面上的最後有效 `pose / diagnostics` 分開。`halted` 時不讓模擬時間繼續前進；送出新指示可重新評估。這個停止是**驗證器中止**，不是聲稱真人能突然懸停。

## Power Pull

[來源觀察與時間點](POWER-PULL-SOURCE.md)另存，以區分影片說明與工程假設。

此原型一次執行三個 2.8 秒週期，保持同一隻支撐腳、自由腳離冰。交替內／外刃、平順屈伸、展臂及偏後中段的接觸偏好參照影片；週期、幅度和 25 mm 的後偏是示意參數，不是影片測量值。腳跟承壓不等同刀尾端點著地，也不使用前後大幅搖刀或折腰模擬推進。

本版要求已在前進且具有基本滑速；原地與後退條件會顯示延後。這是目前原型的入口限制，不代表真人無法從低速建立 Power Pull。轉彎與期望加速度須通過接觸容量與功率篩選，才更新速度。

**尚未驗證完整 Power Pull 推進機制。** 求解使用根節點平移加速度作為質心加速度近似；屈伸造成的實際肢段質心起伏尚未納入反力閉環。頁面顯示 `kinematicObservation`：姿態差分的重心速度／加速度、由此推得的垂直反力，以及求解採用值之差。它是揭露誤差的觀察量，不當作已通過的檢查。還需加入肢段相對加速度、膝踝關節作功與角動量導數，才能驗證主動壓刃如何產生推進。

## 可行性與物理假設

| 項目 | 已檢查 | 尚未涵蓋 |
| --- | --- | --- |
| 姿態 | 固定肢段長度、膝／肘／腕／前臂角度與角速度 | 肩髖全部多軸解剖限制、軟組織、碰撞 |
| 接觸 | 曲面刀刃低點、冰面高度、非負正向力、方向性反力容量 | 實測冰刀冰面摩擦、刀刃切冰、衝量模型 |
| 平衡 | 擬合合力及整體外力矩，報告殘差；動態側傾 | 全身逆動力學、每個關節的可輸出力矩 |
| 旋轉 | 質量分布對慣量的影響、整體偏航需求 | 自由肢段相對動量與慣量時間導數的完整耦合 |
| 能量 | 根節點正向動能增加功率與每步正功估計 | 肌肉功率、膝踝主動作功、全部位能與耗散守恆 |
| 銜接 | 入口／退出支撐、準備階段、速度與位置連續性 | 跳躍、空中旋轉、落地衝擊 |

2026-09-26 起，男性預設由 `hanyu-profile.js` 共用羽生組態：身高 1.72 m、名冊體重 57 kg 與既有近似肢段，不再使用 70 kg 通用版本。分段質量仍為通用比例，肢段用圓柱、頭用球體近似，並非選手個人的慣量或肢段量測。刀向／側向容量為各向異性的示意橢圓，不能解讀為已量得的摩擦係數。歷史驗證報告保留原始組態；本次更換不代表舊測試已重新通過。

接觸反力用有界迭代擬合合力與力矩。量級化殘差允許近似；因此表格的「通過」僅指設定容許範圍內，不是零誤差。角速度只測量已列出的關節。冰刃內外側接觸標記在過零時可能相差 4 mm，側滑差分會扣除這個換側幾何位移，避免把標記改名當成刀身滑移。

## 驗證與重現

在此目錄執行：

```text
node verify-solver-physics.cjs
node verify-solver-study.cjs
node verify-solver-controls-integration.cjs
node verify-solver-intensity.cjs
node verify-solver-crossovers.cjs
node verify-solver-continuous.cjs
node verify-solver-roadbook.cjs
node verify-solver-forecast.cjs
node verify-solver-ui.cjs
```

數值報告與離線繪圖位於 `../verification/ice/solver-study/`。介面測試以 DOM 替身驗證事件、輸入與備援／Worker 協定；它不等同實際瀏覽器 E2E。此次本機頁面的 Browser Use 存取遭 URL 安全政策拒絕，因此未宣稱完成桌面／手機瀏覽器視覺與互動驗收，亦未藉發佈繞過限制。

相關理論背景：[Figure Skating Simulation from Video](https://mrl.snu.ac.kr/research/ProjectSkate/Figure_Skating_Simulation_from_Video___PG2019.pdf)、[MIT Underactuated — Humanoid Robotics](https://underactuated.mit.edu/humanoids.html)。這些資料支持研究方向；本原型沒有實作論文的完整最佳化或學習控制系統。

