實作
每次轉動魔方，背後都有一套自行實作的系統：數學模型、3D 引擎，以及考慮課程目標的求解器。Android 應用程式使用 Kotlin 和 Jetpack Compose 編寫。
專案快照
test* / androidTest* · @Teststack.kt
| Kotlin | 2.4.21 |
|---|---|
| Compose BOM | 2026.09.00 |
| Material 3 | 1.5.0-beta01 |
| Adaptive | 1.3.0 |
| Navigation 3 | 1.2.0 |
| AGP | 9.4.1 |
| KSP | 2.3.12 |
| Gradle | 9.7.0 |
Jetpack Compose 和 Material 3 定義介面元件與主題。Adaptive 根據視窗大小安排版面，Navigation 3 負責導覽與畫面還原。狀態透過 Coroutines 和 Flow 傳遞，Hilt 連接應用程式模組。
architecture.kt
app01Hilt / DIfeature07Compose / ViewModelonboardinglearninglessonpracticeprogresssettingseventsdomain07contracts / use caseslearninglessonpracticeportabilityprogresssettingseventsdata09repositories / storagecontentstoragelearninglessonpracticeportabilityprogresssettingseventscore14UI kit / cube / solvercommonmodeldesignsystemuikitnavigationanalyticscrashlyticsadsbillingpushhardwarecubescrambleimagesolverbaselineprofile01startup / frame timingfeature → domain ← data
modulesΣ 39app1baselineprofile1core14data9domain7feature7Kotlin · physical LOCΣ 136 019featurecoredataappdomainbuildSrcbaselineprofile介面、領域契約和資料分屬不同模組，Hilt 連接各項實作。Compose 接收不可變狀態和明確事件。Room 儲存歷史與學習進度，DataStore 儲存設定，Navigation 3 還原各部分的導覽堆疊。
android-ux.md
Cubiq 實作了 Google 在 Apps Experience Program 中強調的做法：Compose、自適應版面和 edge-to-edge。
engine.glsl
GLSL 著色器計算 PBR 材質、粗糙度和環境光照。模型與動畫保持同步：返回上一步時套用反向轉動，攝影機則考慮面板之間的可用空間。
有型別的記法轉換為轉動與一致的魔方狀態。算繪器佇列為層轉動產生動畫，並保留塊與面片的身分。公式按實際轉動序列播放，支援播放、暫停和速度調整。
前進一步為新轉動產生動畫，後退一步套用反向轉動。跳轉還原基礎場景和目標序列。取消會停止發出後續轉動，已經開始的轉動仍會完成。EGL 生命週期處理 pause/release；GL 無法使用時，仍保留無需 3D 的學習路徑。
solver.kt
自行實作的求解器利用目前課程的公式與輔助轉動建立解法。SolverRequest 包含魔方狀態、目標塊、鎖定目標、允許的公式、情況和方向。規劃器遵守學習目標順序，並保護已還原的塊。
分階段規劃使用有界 BFS、束搜尋和 F2L 情況辨識。驗證檢查塊的組成、翻轉、扭轉和置換奇偶性。搜尋策略限制深度和束寬。切換課程會取消搜尋，阻止過期結果生效。
結果是 PracticePlan，包含步驟、公式參照、顯示時間軸和執行時間軸。說明保留教學方向，引擎接收完整執行序列。結果類型為 plan / solved / invalid input / no constrained path。
content.md
理論儲存在 756 份 Markdown 文件中，練習由 336 個在地化情境定義。Gradle 驗證翻譯結構及對 316 幅原創插圖的參照。圖形使用 Blender/Cycles 製作；Android 引擎另用程序化幾何結構。
workflow.md
AGENTS.mdREADME.md儲存庫依代理開發需求組織：AGENTS.md 層級規定歸屬、架構限制和驗證關卡；README.md 描述模組契約，KDoc 描述 API 和不變量。
架構、設計和在地化契約與程式碼一同進行版本管理。PLAN.md 記錄範圍和交接；契約變更同步更新負責該契約的文件。檢查與產生作業透過 Gradle 執行，CI 建置兩個應用程式商店版本。
physical text linesΣ 740 244Resources / localizationKotlin · non-testLesson MarkdownKotlin · JVM testsKotlin · Android testsBuild tooling / webDocumentation測試涵蓋不可能的魔方狀態、已還原層的保持、學習計畫、過期請求取消、工作階段還原和資料匯入。CI 建置兩個應用程式商店版本；發布檢查包括 R8、APK/AAB、檢查碼，以及原生程式庫針對 16 KB 頁面大小的對齊。
Kotlin 規模按實體行統計，包含註解、空行、buildSrc 和效能基準測試程式碼，排除測試目錄。測試數量指 1 343 項 JVM 宣告和 281 項 Android 宣告，而非執行次數。文件包含備援文字；存在情境並不代表每節課都有練習。
baselineprofile · @Test總文字量按受追蹤 UTF-8 檔案的實體行統計，涵蓋原始檔、測試、XML/JSON 資源、Markdown 內容、在地化、文件、建置工具和 Web 原始碼。包含註解、空行和各語言副本；排除媒體、產生的檔案與建置輸出、供應商程式碼、服務設定和臨時 PLAN.md。這是專案文字輸入的規模，並非可執行 LOC。