Tai-ch0802 行動設計系統
哲學： 觸控優先。電池意識。尊重平台。離線能力。 核心原則： 行動不是小桌面。思考行動約束，詢問平台選擇。
🔧 執行腳本
執行這些進行驗證（不要閱讀，直接執行）：
| 腳本 | 用途 | 使用方式 |
|---|---|---|
scripts/mobile_audit.py |
行動 UX 與觸控稽核 | python scripts/mobile_audit.py <project_path> |
🔴 必要：開始工作前閱讀參考檔案！
通用（始終閱讀）
| 檔案 | 內容 | 狀態 |
|---|---|---|
| mobile-design-thinking.md | 反記憶：強制思考 | ⬜ 最關鍵 |
| touch-psychology.md | 費茲定律、手勢、觸覺、拇指區 | ⬜ 關鍵 |
| mobile-performance.md | RN/Flutter 效能、60fps、記憶體 | ⬜ 關鍵 |
| mobile-backend.md | 推播通知、離線同步、行動 API | ⬜ 關鍵 |
| mobile-testing.md | 測試金字塔、E2E、平台特定 | ⬜ 關鍵 |
| mobile-debugging.md | 原生 vs JS 除錯、Flipper、Logcat | ⬜ 關鍵 |
| mobile-navigation.md | Tab/Stack/Drawer、深連結 | ⬜ 閱讀 |
| mobile-typography.md | 系統字型、動態字型、無障礙 | ⬜ 閱讀 |
| mobile-color-system.md | OLED、暗色模式、電池意識 | ⬜ 閱讀 |
| decision-trees.md | 框架/狀態/儲存選擇 | ⬜ 閱讀 |
平台特定
| 平台 | 檔案 | 何時閱讀 |
|---|---|---|
| iOS | platform-ios.md | 為 iPhone/iPad 建構 |
| Android | platform-android.md | 為 Android 建構 |
| 跨平台 | 以上兩者 | React Native / Flutter |
⚠️ 關鍵：假設前先詢問（必要）
未指定時必須詢問：
| 面向 | 詢問 | 原因 |
|---|---|---|
| 平台 | 「iOS、Android 還是兩者？」 | 影響每個設計決策 |
| 框架 | 「React Native、Flutter 還是原生？」 | 決定模式和工具 |
| 導航 | 「Tab bar、抽屜還是堆疊式？」 | 核心 UX 決策 |
| 狀態 | 「什麼狀態管理？」 | 架構基礎 |
| 離線 | 「需要離線工作嗎？」 | 影響資料策略 |
⛔ AI 行動反模式
效能罪過
| ❌ 絕不 | 為什麼錯 | ✅ 始終 |
|---|---|---|
| ScrollView 用於長列表 | 渲染所有項目，記憶體爆炸 | 使用 FlatList / FlashList |
| 行內 renderItem 函式 | 每次渲染都新函式 | useCallback + React.memo |
| 缺少 keyExtractor | 索引鍵在重排序時有 bug | 資料中的唯一穩定 ID |
| 生產環境 console.log | 嚴重阻塞 JS 執行緒 | 發布前移除 |
觸控/UX 罪過
| ❌ 絕不 | 為什麼錯 | ✅ 始終 |
|---|---|---|
| 觸控目標 < 44px | 無法準確點擊 | 最小 44pt(iOS)/48dp(Android) |
| 無載入狀態 | 使用者以為應用當掉 | 始終顯示載入回饋 |
| 無錯誤狀態 | 使用者卡住 | 帶重試的錯誤顯示 |
| 忽略平台慣例 | 使用者困惑 | iOS 感覺像 iOS |
安全罪過
| ❌ 絕不 | 為什麼錯 | ✅ 始終 |
|---|---|---|
| Token 存在 AsyncStorage | 在 root 裝置容易存取 | SecureStore / Keychain |
| 寫死 API 金鑰 | 從 APK/IPA 反向工程 | 環境變數、安全儲存 |
📱 平台決策矩陣
快速參考：平台預設
| 元素 | iOS | Android |
|---|---|---|
| 主要字型 | SF Pro | Roboto |
| 最小觸控目標 | 44pt × 44pt | 48dp × 48dp |
| 返回導航 | 邊緣左滑 | 系統返回按鈕/手勢 |
| 底部 Tab 圖示 | SF Symbols | Material Symbols |
🧠 行動 UX 心理（快速參考）
觸控的費茲定律
桌面：游標精確（1px）
行動：手指不精確（~7mm 接觸面積）
→ 觸控目標必須至少 44-48px
→ 重要動作放在拇指區（螢幕底部）
→ 破壞性動作遠離容易觸及之處
拇指區（單手使用）
┌─────────────────────────────┐
│ 難以觸及 │ ← 導航、選單、返回
│ （伸展） │
├─────────────────────────────┤
│ 尚可觸及 │ ← 次要動作
│ （自然） │
├─────────────────────────────┤
│ 容易觸及 │ ← 主要 CTA、tab bar
│ （拇指自然弧線） │ ← 主要內容互動
└─────────────────────────────┘
[ HOME ]
🔧 框架決策樹
你要建構什麼？
│
├── 需要 OTA 更新 + 快速迭代 + Web 團隊
│ └── ✅ React Native + Expo
│
├── 需要像素完美自訂 UI + 效能關鍵
│ └── ✅ Flutter
│
├── 深度原生功能 + 單一平台焦點
│ ├── 僅 iOS → SwiftUI
│ └── 僅 Android → Kotlin + Jetpack Compose
│
└── 企業 + 現有 Flutter 程式碼庫
└── ✅ Flutter
📋 開發前檢查清單
開始任何行動專案前
- 平台已確認？（iOS / Android / 兩者）
- 框架已選擇？（RN / Flutter / 原生）
- 導航模式已決定？（Tabs / Stack / Drawer）
- 狀態管理已選擇？
- 離線需求已知？
- 深連結從第一天就規劃？
每個畫面前
- 觸控目標 ≥ 44-48px？
- 主要 CTA 在拇指區？
- 載入狀態存在？
- 帶重試的錯誤狀態存在？
記住： 行動使用者沒有耐心、會被打斷、且在小螢幕上用不精確的手指。為最差條件設計：差網路、單手、大太陽、低電量。如果在那裡能運作，到處都能運作。