文件索引

這是公開版索引。 兩份文件與一節內容未收錄——都與解密有關， 理由與判斷過程寫在根目錄 README.md。表格中以 「未收錄」標示，而不是刪掉整列：知道少了什麼，比看不出少了什麼好。

檔案依角色命名：RE_NOTES_* 是分章日誌（只追加，失敗與更正留在原地， 以較晚章節為準）；REF_* 是穩定知識（規格/名冊，會被更新但不記過程）； HANDOFF.md 是現況（每輪重寫，不追加）。命名規則見全域 skill notes。

先讀這兩份

檔案	用途
NEXT_STEPS.md	接手先讀這份。 下一步做什麼、為什麼是這個順序
HANDOFF.md	上一輪的成果、卡點、踩過的錯

總覽

檔案	用途
OVERVIEW.md	整體架構與成果總覽（主報告）。§3 的演算法虛擬碼已移除，形狀描述與 §3.1 的過程紀錄保留

分章日誌（依主題，時間序在章節內，不在檔名）

各檔案涵蓋的主題如下。進度一律看 HANDOFF.md，不要從這張表推斷。

檔案	主題
RE_NOTES_CRYPTO.md	未收錄。 裝置連線、IL2CPP dump、加密演算法逆向、catalog。前兩項本身無害（部落格文章寫的就是那段），但它們與演算法推導在同一份日誌裡逐章交錯，拆不乾淨
RE_NOTES_LIVE2D.md	Live2D 模型／貼圖／physics／motion／expression
RE_NOTES_3D.md	3D mesh/骨架/材質/貼圖/動作抽取、glTF 匯出
RE_NOTES_AVATAR.md	Humanoid Avatar、動作烘焙、彈簧骨物理、臉部/頭髮/相機、shader

穩定知識（reference）

檔案	內容
REF_ALGORITHM_MATH.md	未收錄。 加密演算法的數學式——讀完即可實作，正是不該公開的那一份
REF_CHARACTER_ROSTER.md	63 個角色 ID 名冊（分支/期別/資產統計）

未收錄的程式

scripts/ 整個目錄未收錄：裡面混著 Frida 解密 hook 與一次性診斷腳本， 逐支審不划算。離線的物理重現（sim_swing.py、compare_swing.py）與 參數抽取（extract_swing.py）在根目錄，那三支不碰解密。

現行資料版本（避免用到已被取代的資料）

見 HANDOFF.md §4 —— 目前現行的是 _extracted_motions_3d_v2/（含三次係數），不要用舊版。