# Serenity · 由研究元素到音樂編舞

2026-09-25。入口：[軌跡](index.html)。預設「軌跡滑行」，同頁可切換 AI 編排 (1) 樂句編舞、(2) 大幅滑行、(3) 長步滑行、(4) 重心與伸展比較。預設顯示「滑冰者＋冰刃軌跡」，「60 秒冰痕」不勾選（保留最近 22 秒）。

這是一場以長弧、前後呼應、收束與開展為主的單人藝術編舞。把來源研究中
可辨識的動作元素重新組合，保留呼吸與滑行，不以連續跳躍堆疊難度。
它不是指定舞的競技編排，也不聲稱精確重演任何一位選手的原節目。

## 動作元素庫

每個元素有固定 ID、來源、來源時間範圍、建議時長及進出方向描述。
同一元素可在不同樂段重複；身材、觀測與原始擬合檔案不會因此改變。

| ID | 元素 | 來源性質 | 編舞用途 |
| --- | --- | --- | --- |
| oleg-forward | 長刃前進蹬冰 | Oleg 教學衍生的既有程序模型 | 開場、留白、向下一句延伸 |
| oleg-coda | 延伸滑出與安靜收束 | 同一程序模型的較短片段 | 最後減速，不重新加速蹬冰 |
| oleg-fi | 前內三轉與後外刃出弧 | 同上 | 從前滑轉入後滑 |
| oleg-backward | 後退推蹬與交叉步 | 同上 | 保留後滑，延續流動 |
| oleg-bo | 後外三轉與接回前滑 | 同上 | 回答前內三轉，完成方向往返 |
| hanyu-lunge | 寬步屈膝與刀尾伸展 | 平昌影格擬合，原片 2:07.2–2:09.2 | 展開身體與冰面線條 |
| hanyu-fold | 俯身收束 | 平昌影格擬合，原片 2:09.2–2:10.7 | 低語、樂句收尾 |
| hanyu-rise | 起身伸腿與展開 | 平昌影格擬合，原片 2:10.7–2:12.8 | 接回推進，呼應旋律回升 |
| hanyu-reach | 寬步轉向與自由腿前伸 | 平昌影格擬合，原片 2:17.4–2:19.2 | 長線條高潮；不沿用其後不穩定的快速轉身 |
| cluster-rocker | Rocker 收腿轉向 | skopinaskate 擬合，Reel 0.85–2.20 秒 | 轉向主題的第一句 |
| cluster-counter | Counter 反向制動 | skopinaskate 擬合，2.20–3.80 秒 | 對前一轉向形成回應 |
| cluster-loop | Loop 收緊再展開 | skopinaskate 擬合，3.80–6.40 秒 | 收緊冰面曲線後釋放；不是 Loop 跳躍 |

Oleg 的來源時間在程式內以原有三轉循環的 `turnQ` 表示，並非影片秒數；
診斷欄位使用 `sourcePhase`。另兩組保留來源秒數 `sourceTime`。
前進蹬冰也沿用先前 [Style Skating 姿態研究](https://www.youtube.com/watch?v=YPsnG4SxfEU&t=180s)，
並非 Oleg 原片的逐幀擬合；「Oleg」是此教學衍生循環的簡稱。

來源研究與方法：[Oleg 基礎步法](pose-study.html)、[平昌分析](reference-study.html)、
[Rocker / Counter / Loop](cluster-study.html)、[動作重建規範](MOTION-RECONSTRUCTION-WORKFLOW.md)。
Rocker、Counter、Loop 的標籤沿用來源研究的分段；原研究對刃側與時界的疑義仍保留。

## 配合兩個錄音版本

使用既有 20 Hz 音量與起音包絡安排段落，再由編舞者指定動作組合。
下列是依聲音強弱選擇的藝術段落，不是自動辨識出的拍號、節拍或精確樂句邊界。
兩版本的能量各自正規化，因此不能拿數值比較絕對音量。

| 大提琴與輕量伴奏 | 構想 |
| --- | --- |
| 0:00–0:12 | 呼吸與長刃開場 |
| 0:12–0:40 | 前內三轉、後滑、後外三轉，形成前後問答 |
| 0:40–1:04 | 收束、起身與前進，逐步展開 |
| 1:04–1:28 | 第一組 Rocker / Counter / Loop 主題 |
| 1:28–1:56 | 寬步側伸、起身、自由腿前伸 |
| 1:56–2:16 | 基礎步法接回流動 |
| 2:16–2:32 | 長弧與收束留白 |
| 2:32–2:48 | 轉向主題再現，回應較密的起音 |
| 2:48–3:12 | 伸展與長線條，回到開場意象 |
| 3:12–3:16.279 | 放慢、滑出、收尾 |

原始即興使用獨立分段：0、12、40、56、72、88、112、128、152、176、188.012 秒。
轉向群組放在 1:12–1:28 與 1:52–2:08；2:08 之後的回落改用留白，
2:32–2:56 以長伸展為主，最後十二秒收束。沒有把大提琴整套排程等比例套上原曲。

## 姿態與銜接

- 新編舞全部使用 `hanyu-profile.js` 的固定身材。Oleg 的程序姿態先轉成
  同一參數格式，再以固定肢段與逆運動學重建，不混合不同骨長的肢體座標。
- 羽生與 skopinaskate 直接使用已完成擬合的參數。來源擬合資料由
  `build-choreography-library.cjs` 擷取並保存 SHA-256；不退回舊人工指定角度。
- 樂段改變來源時間的進行速度，不倒播、不打亂姿態順序。快速姿態變化分配
  較多時間，再以音量與起音細調；這是新編舞的定時，不是新的來源動作求解。
- 元素間另安排接步：先放下自由腳、經過換重再提起下一腳，並在人體參數
  空間銜接。刀刃、腳踝、固定骨長及手腕／掌向由同一套幾何模型重新求值。
- 新冰面路徑與擺位屬於編舞。原片的鏡頭相對位移不能當作精確公尺路徑；
  尤其 Cluster 的原模型局部路徑為零，不可誤認成選手站在原地。
  新版為它安排有實際位移的弧線、反向弧瓣與迴圈。
- 接冰時軌跡取刀刃接觸點，離冰中斷；灰白也可能表示刃側未定。
  曲線刀刃與 IK 可避免穿冰、改變骨長，但不等於完整接觸力或無側滑驗證。

原片擬合仍有單鏡頭深度歧義與中間姿態不穩定。這次不把 2D 擬合誤差當成
3D 正確率，也不宣稱新的編舞已通過人體受力、肌肉力矩或競技技術驗證。
轉用固定身材時必要的腳部可達性修正會保留在 `pose.retargeting` 診斷。

## 操作與比較

各編排與「軌跡滑行」共用同一個音訊時鐘，切換保留播放時間、暫停狀態、
顯示模式與路徑種子，重新顯示該版本到當下的冰痕。舊版仍可選自由滑行、
左腳三轉或右腳三轉；原 `skater-model.js` 未修改。

展開「這首曲子的編排」可跳至各段。冰刃、雙手軌跡與人物三種顯示方式繼續可用。
游標或即時音訊輸入暫用原程序滑行，返回內建錄音後恢復所選編排。
暫停、倒轉、重播與切歌均取同一份預算動作，不以畫面幀率推進。

## 大幅滑行版（2026-09-25）

新增第三版 `expansive`。保留「舊版滑行」為預設；原「樂句編舞」的姿態與路徑
資料不變。三版使用同一音樂時鐘，切換保留進度、播放狀態與顯示模式。

原樂句編舞將每段來源路徑限制在起點周圍約 3.5 m，接段主要只前進 0.5 m；
取樣時間偏重關節的姿態變化，使轉身與伸展占去較多時間，冰面位移偏小。
新版重新安排動作，而非放大人物或加快音樂：

- 每段移動弧線最大半徑放寬至 9 m；身材、肢段與來源關節姿態保持固定。
- 增加 Oleg 前進與後退推蹬，把 Rocker／Counter／Loop、羽生的伸展段隔開。
  兩首都是 28 段，維持各曲原有十個音樂段落。完整保留每組動作，
  不再按名義時長截掉後外三轉或 Counter；後退經後外三轉接回前進。
- 段落間以前移約 2 m 的接步延續滑行，保留兩端的行進速度與方向；選擇入口
  方位時檢查整條弧線，避免把端點硬裁到冰場邊界造成折角。
- 動作定時同時考慮人體姿態與冰面路程，減少只在原地收束、慢轉的時間。
  這仍是單調的來源時間映射，不跳過來源姿態。
- 較短的樂句依取樣速度調整各段路徑倍率，將段內移動速度目標限制在
  4.4 m/s；保留完整動作順序，不靠刪掉轉身或過快滑行來填入時間。
- 尾聲先滑出，再平緩減速，避免原二次曲線在開頭突然加速。

以相同曲目、相同 seed 比較根部在冰面上的累積路程（不是人物大小、畫面
像素位移、範圍面積，也不是源影片還原正確率）：

| 比較 | 大提琴與輕量伴奏 | 原始即興錄音 |
| --- | ---: | ---: |
| 原樂句編舞路程，seed 24680 | 約 126.5 m | 約 126.6 m |
| 大幅滑行路程，seed 24680 | 約 349.2 m | 約 337.1 m |
| 三個 seed 的路程比例 | 276.30–284.24% | 266.49–279.43% |
| 低於 0.25 m/s 的時間，新版，seed 24680 | 約 1.65 s | 約 3.21 s |

公尺是模型座標單位，不是來源影片經相機校正後的實測距離。
`verify-choreography-expansive.cjs` 以兩曲、三個 seed 檢查 50,121 個姿態樣本，
包含全曲 30 Hz 與接段周圍 120 Hz；65 項通過。路程倍率以相同 30 Hz
取樣比較；另確認 12 個元素皆有排入，Oleg 動作的前後向進出條件一致。維持原有 root 6 m/s、
關節端點 10 m/s 的動畫異常門檻，並檢查骨長、刀刃不穿冰、沒有憑空加入
雙腳離冰的接步、可重複跳轉，以及舊樂句編舞資料雜湊不變。

這版直接編排路徑與速度，尚未把腳的推蹬反力積分成動量，也未求解刀冰
摩擦、側滑或能量。因此它改善的是視覺滑行的幅度與連續性，不能把距離
增長解釋為已證實得到同比例的真實推力。

## 長步滑行與編排編號（2026-09-25）

選擇列為「軌跡滑行　AI 編排 (1) (2) (3) (4)」：

| 選項 | 內容 | 模型代號 |
| --- | --- | --- |
| 軌跡滑行（預設） | 原隨機滑行 | old |
| AI 編排 (1) | 原樂句編舞 | phrases |
| AI 編排 (2) | 大幅滑行 | expansive |
| AI 編排 (3) | 長步滑行、減少短踏步 | strides |
| AI 編排 (4) | 加大承重側移重與肢體延伸 | expressive |

第三版保留十個音樂段落，將完整動作組減為 22 段。以長刃前進蹬冰、
寬步伸展與較少的前後轉換為主；Rocker／Counter／Loop 集中在一個回應段。
每組完整執行，後滑仍由後外三轉回到前進。保持固定羽生身材與既有來源姿態，
延長每次換腳可分配的時間；局部路徑半徑放寬至 10.5 模型公尺，
段內路徑速度目標降為 4 m/s，使大步與長持刃成為主體。

短痕同時有兩種原因，因此分別處理：

- 接段兩端若是同一腳支撐、另一腳持續離冰，就保持自由腳的高度銜接。
  不再為了通用的「先放下再抬起」程序，製造一次短暫點地；真正換腳
  仍先落下一腳再抬另一腳。
- 第三版冰痕改用 60 Hz 的接觸資料，在離冰／落冰、內外軌切換處再細分
  到小於 1 ms。不把原先整個 50 ms 取樣間隔留白，也不畫線穿過刀溝或
  連起離冰的兩端。前兩版的模型與冰痕取樣保留，供比較。

「短段」以同一隻腳真正連續接冰計數，定義為持續不足 0.8 秒**或**
接觸點移動不足 0.8 模型公尺；不把換刃顏色、1 秒 SVG 分塊算成碎步，
也排除曲首／曲尾被截斷的段落。這是用於減少碎步的編排指標，
不是從截圖量測的像素占比或人體技術標準。

兩曲、兩個 seed（24680、42）的結果皆為 59 段完整接冰中只有 1 段較短，
約 **1.69%**，低於約一成的參考目標；沒有為湊足比例再加入多餘踏步。
大提琴與原曲的接冰時間中位數分別為 2.317 與 2.233 秒，冰痕長度中位數
約 3.35 與 3.37 模型公尺。這些是實際接觸序列的統計，未靠淡出隱藏短痕。

`verify-choreography-strides.cjs` 的 38 項數值檢查通過，包含固定骨長、
接段不憑空離冰、刀刃不穿冰、全曲速度與跳轉一致性。
前兩版的兩曲 × 兩種 seed，共八份完整 60 Hz 姿態／路徑序列，
與此次修改前的 SHA-256 完全一致。控制器 17 項檢查通過，包含第三版的音訊進度、
版本／曲目切換、游標模式恢復與真正輸出的接觸痕跡；持續接冰的換軌時間缺口
不超過 0.521 ms，兩曲量到的最大空間缺口約 6.4 mm（模型座標，包含刀溝寬度）。

第三版首次準備會顯示提示；路徑分段與姿態計算分批讓出主執行緒。
準備期間可切回其他版本；舊的準備結果不能覆蓋後來的選擇或新種子。
之後同一曲目／種子的切換使用快取，保留當下的音訊時鐘。非同步與同步的
所有影格欄位逐一比對完全相同，不因批次大小改變舞序。

這版仍是配樂編排，不是新一輪來源重建，也未把推蹬反力積分為物理位移。
數值檢查不能解讀為來源動作或力學的正確率。

## 第四版：重心與伸展（2026-09-25）

新增 AI 編排 (4) `expressive`，沿用第三版的兩曲樂句、22 段動作、根部路徑
及接冰時序，讓同一音樂位置可以直接比較移重與身體姿態。這是從既有來源
姿態出發的編舞再設計；原始擬合資料、羽生骨長與前三版數值保持原樣。

上一版的問題不只是重心幅度：Oleg 重用流程沒有保留原程序的刀身側傾，
新路徑也未與側傾重新配合。第四版沒有指定外刃配額或直接改色，而是：

1. 以第三版幾何模型的接觸點取前後約 0.2 秒樣本，計算移動速度及去掉
   切向分量的加速度，再投影到刀尖朝向的左側。後退時仍使用同一世界向量
   與刀身座標，避免把行進方向的左右誤當成刀刃的左右。
2. 在穩定接冰且刀尖與移動方向足夠一致時，以 `h × a_side / 9.81`
   作側向重心目標，乘上 1.3 的藝術表現倍率、最多偏移 0.26 模型公尺。
   這是準穩態的有界目標，不是量測反力；低速、離冰或接觸轉換時降低信任。
   曲首與曲尾缺少完整前後取樣時，不採用該點的曲率加速度，只保留支撐移重
   與鄰近有效樣本的平滑影響，避免不對稱差分製造虛假的側向加速度。
3. 移重目標以承重接觸點為基準。使用繪圖模型自身的質量權重估算需要的
   骨盆平移，限制在身體側向 ±0.40 模型公尺，再以前後各 10 幀的三角窗
   平滑。腳的冰面目標不隨骨盆一起平移；固定骨長的可達性修正仍會記錄。
4. 骨盆略降以增加屈膝空間；軀幹側傾放大並加入弧線引導。自由腿的前後、
   左右與離冰高度分別最多放大 16%、12%、12%，離冰幅度平滑控制增益；
   手臂端點最多增加 3.5 cm 的伸展，仍限制於固定上臂／前臂可達範圍。
5. 用改變後的實際姿態重建弧形冰刀、腳踝、膝與手部。刃側仍由重心、
   刀身傾斜及信任條件推估；未定狀態繼續保留，沒有把彎曲線一律塗成外刃。

離線預算與瀏覽器非同步預算使用同一運算程序，增量計算可讓出主執行緒。
狀態保存移重資訊，任意拖曳、切版、切歌均從同一音訊時刻取樣。
首次計算顯示各階段與百分比，包含支撐重心與冰痕；同曲、同路徑的後續
切換使用快取。準備途中切換版本或種子後，先前的進度不得覆蓋目前畫面。

驗證須使用**修正後**的冰刀接觸點路徑。穩定樣本的納入條件先固定：
前後至少 0.15 秒持續接冰、模型承重比至少 0.7、速度至少 0.4、
刀尖與移動方向對齊比至少 0.9、側向加速度介於 0.1–4、
身體轉向速率低於 1.5 rad/s。前後滑、左右腳皆參與比較；
灰色未定仍留在一致性統計的分母，另公布覆蓋範圍與排除條件。
這些是模型內的一致性指標，不是來源影片還原正確率。

以兩曲、seed 42 的全曲 30 Hz 取樣（共 11,532 個第四版姿態），第三版與
第四版的實際幾何量比較如下；數值以模型公尺計，不是影片量測：

| 實際幅度（第三版 → 第四版） | 大提琴與輕量伴奏 | 原始即興錄音 |
| --- | ---: | ---: |
| 身體側向擺幅 RMS | 0.15994 → 0.21384（+33.7%） | 0.16258 → 0.21856（+34.4%） |
| 承重腳旁的平均絕對側向重心偏移 | 0.06364 → 0.09398（+47.7%） | 0.06333 → 0.09623（+52.0%） |
| 肩至腕距離／固定全臂長，平均值 | 0.90555 → 0.93916 | 0.90558 → 0.93921 |

30 項數值檢查通過。骨長誤差低於 2e-15、刀刃不穿冰、接段沒有額外雙腳
離冰；第三版的路徑、接冰時序與舊版／前三版完整狀態雜湊均保持一致。
曲首曲尾的曲率信任保護、任意順序跳轉及同步／非同步預算亦已驗證。
控制器 18 項檢查通過，包含兩曲的第三／四版切換、快取、游標模式恢復、
準備進度與過期工作隔離；實際輸出的冰痕未連起離冰或跨越刀溝。
另以 Chrome 實際播放兩曲，確認同時刻切版、暫停、首次準備與取消／返回。
受限穩定支撐樣本的逐曲一致性、覆蓋率及剩餘矛盾，另列於
[驗證摘要](../verification/ice/choreography-expressive/README.md)，不可把這些比例
解讀成人體動作的正確率。

尚未聯立求解刀冰摩擦、接觸反力、側滑、關節力矩或角動量；部分姿態／曲率
仍可能矛盾。這版改善移重表現與幾何一致性，不能視為完整人體動力學求解。
驗證腳本：`verify-choreography-expressive.cjs`；結果存於
`../verification/ice/choreography-expressive/`。

## 首次播放與逐段冰痕（2026-09-25）

第三、四版不再等待整首歌的冰痕全部算完。首次仍需建立完整姿態序列，
之後先準備當下可見的 22／60 秒歷史與約兩秒的前瞻範圍；從曲首開始只需
前三個一秒區塊。播放中提前補算，已算過的區塊供重播及跳轉重用。
每區塊仍使用原 60 Hz 姿態與小於 1 ms 的接冰／換軌細分；相鄰區塊共用
同一時刻的邊界點，不降低精度、不連起離冰痕跡。

需要準備時，音訊時鐘會暫停，記住播放意圖，正確版本就緒才同步繼續。
等待中可排入或取消播放；切曲、改路徑、游標及即時音訊切換會檢查工作是否
仍屬於目前選擇。拖曳到未計算的範圍會同樣暫停並補算，不讓音樂獨自前進。

本機 Node 剖析中，原完整冰痕階段約 14–15 秒；改為曲首三個區塊約
0.34–0.35 秒。這只代表冰痕階段，不能說整個首次啟動只需 0.35 秒；
完整姿態建置仍約 6–8 秒 CPU 時間，瀏覽器還有排程及繪製成本。
動作模型與身材資料未更動。對照腳本與結果位於
`../verification/ice/choreography-startup/`。

19 項精確冰痕區塊檢查、16 項播放生命週期檢查及 23 項完整控制器檢查
通過。另以本機 HTTP 預覽實測首次載入、等待播放／取消、未快取跳轉及
快取重播，確認準備期間實際音訊時鐘停止；這不等於已發布或完整逐幀同步量測。

## 維護

- `choreography-library.js`：精簡的已擬合來源資料，無執行期網路依賴。
- `choreography-core.js`：元素庫、兩曲段落、來源定時、擺位與接步。
- `choreography-trace-buffer.js`：可跳轉的一秒冰痕區塊與協作式預算。
- `ice.js`：依所選版本呼叫原模型或新編舞；顯示與音訊控制共用。
- `verify-choreography.cjs`：全曲與交界的數值檢查。
- `verify-choreography-ui.cjs`：真實控制器搭配 DOM／音訊替身的操作回歸。
- `verify-choreography-expansive.cjs`：新版路程倍率、完整動作組與前後向銜接檢查。
- `verify-choreography-strides.cjs`：連續接冰短段占比、骨長／銜接與前兩版全曲資料保留檢查。
- `verify-choreography-expressive.cjs`：第四版移重與伸展幅度、接冰、幾何一致性及舊版保留檢查。
- `../verification/ice/choreography/`：來源快照、測試報告及瀏覽器檢查紀錄。

原樂句編舞數值驗證 19 組通過，兩曲共 33,164 個姿態樣本，包含全曲 60 Hz 與接段
附近 120 Hz。骨長誤差小於 1e-15 m、刀刃未穿冰、銜接沒有意外雙腳離冰。
新編舞內部的腳位可達性修正最大 2.73 cm，沒有寫回原始擬合資料。
大提琴包含 30 個動作段，原始即興 29 個；各有十個音樂段落。
這些是幾何與連續性檢查，不是人體受力或來源還原正確率。

擴充元素時，先指定來源與可用時界，再檢查完整進出段。新增接步可作為藝術編排，
不能假稱為來源影片觀測。不得為通過檢查而刪除不利的數值紀錄或放鬆身材限制。
