美術資源¶

本檔角色：依「出貨資產／參考與原始工程／技術與設計契約」分類的美術資源總覽與索引。細化文檔、提示詞、authoring 原始件與參考成品收於 美術資源/；HUD 規格在賽內機制.md §2.4。未列入本索引或正式 manifest 的個人工作檔不構成 repository 權威。

1. 資料夾結構¶

repo 根/
├── release-input/     ← Git 忽略的本機 Immutable Release 投遞區
│   ├── parts/         ← 零件 GLB、選定參考 PNG 與四視角檢查圖
│   ├── tracks/        ← 場地 GLB、選定參考 PNG 與四視角檢查圖
│   ├── audio/         ← WAV／FLAC master；依 vehicles／tracks／ui／music 分類
│   └── ui/
│       ├── themes/        ← default／moon-rabbit 主題 PNG 母檔
│       ├── race-messages/ ← 兩組賽中訊息 PNG 原圖
│       ├── race-countdown/← 倒數與起跑來源／逐幀 PNG
│       └── social/og/      ← SEO／分享圖母檔
└── 美術資源/
    ├── Immutable Release/   ← 大型 authoring master 的 prepare／publish 操作手冊
    ├── authoring-source-manifest.json ← authoring source 清冊與 release input 對照；檔案 bytes 以 release asset 為權威
    ├── 設計系統.md        ← UI 設計系統（視覺原則 / 色票 / 字級 / 間距 / 元件規則）
    ├── 主題外觀與 RWD.md  ← Skin Layer / Default·月兔方向 / 多比例 RWD 穩定規格
    ├── 主題審查計畫.md    ← 代表 viewport / 原型 / 驗收工作（非 canon）
    ├── 前端技術策略.md    ← 程式架構/ui-frontend.md 的美術分類入口
    ├── 頁面線框.md        ← 各頁 wireframe
    ├── UGC卡片.md         ← UGC 卡片與評分顯示
    ├── 美術方向.md        ← 公版 GLB 美術方向＋IP 邊界（參考件）
    ├── 提示詞/            ← 圖像生成提示詞（活文件；收納規則見 §8）
    ├── 參考雛形/
    │   ├── 定版/          ← 已採用的版面基準與小型審查預覽
    │   └── 草稿/          ← 早期概念稿（WebP q92）
    └── 實際使用圖/   ← 受版控的 favicon／SVG、README 與可重跑工具；不放高解析 PNG

完整的高解析投遞路徑為 release-input/ui/themes/、release-input/ui/race-messages/、 release-input/ui/race-countdown/ 與 release-input/ui/social/og/；對應的提示詞、README、設定與生成工具仍受 Git 版控。圖庫提示詞依用途收在 提示詞/賽中訊息圖示/ 與 提示詞/賽內倒數與起跑動畫/。

三種性質不可混用：

1.1 出貨資產¶

由母圖產出的最佳化 UI 檔隨主題進 public/assets/themes/<id>/assets/；共用 icon sprite 進 public/assets/sprites/。只有通過 manifest 與 release gate 的檔案才屬出貨面。

1.2 參考與原始工程¶

風格／版面參考：參考雛形/定版/、參考雛形/草稿/ 與提示詞；不直接進 runtime，機制仍以 canon 為準。
authoring 原始件：大型 GLB、無損 PNG 與音訊 master 由 specs immutable GitHub Release 作唯一權威；本機 payload 分別放在 release-input/parts/、release-input/tracks/、release-input/audio/ 與 release-input/ui/，其中音訊再依 vehicles／tracks／ui／music 分類，只供投遞且不進 Git，操作見 Immutable Release。
審查／施工資產：主題審查計畫.md 只安排 viewport、原型與驗收，不建立產品 canon。

1.3 技術與設計契約¶

穩定視覺值：設計系統.md。
主題 Skin 與 RWD：主題外觀與 RWD.md。
UI implementation authority：程式架構/ui-frontend.md。
頁面資料入口與 route identity：程式架構/pages-contracts.md／程式架構/race-routing.md。

2. Design System¶

詳見美術資源/設計系統.md：

項目	內容
視覺原則	3D 主視覺優先、工具面板深色低噪、狀態回饋＝顏色＋圖示＋文字＋形狀
色票	背景三級 / 文字三級 / primary / gameplay accent（speed·energy）/ 狀態 / 地形提示
字級	`display` 32 →`caption` 12 ＋ `hud` 18（不做 viewport 動態縮放）
間距 / 尺寸	`space` 4–32px / `radius` 4·8px / 觸控 ≥44px / HUD 按鈕 64·72px
元件規則	Button / Segmented / Toggle·Slider / Stat Bar / Card / Toast·Modal
動畫	級距＝程式架構/ui-frontend.md §7（motion token）；行為常數＝ui.md §12

3. HUD 規格¶

規格權威 = 賽內機制.md §2.4（欄位／錨點／widget 行為，本檔不重列）；視覺布局 = 美術資源/頁面線框.md §8。螢幕方向：建議橫向、不強制（直向適應規則見賽內機制 §2.4）。

設計選擇：無 cooldown timer / 無「即將過熱」彈窗。HUD 極簡化。

4. UGC 卡片¶

詳見 UGC卡片.md：

┌──────────────────────────┐
│  [GLB Preview]           │
│                          │
│  零件名稱      [badge]   │
│  Alice #a3f7c91d         │
│  ★ 4.3 (85 票) · 1,247 用│
│  [Fork] [Try]            │
└──────────────────────────┘

包含：GLB preview thumbnail、創作者（name #1a2b3c4d）、UGC rating＋使用次數、狀態 badge（Local / On-chain / Fork / similarity-pending / Blocked）、操作按鈕。（創作者信譽分只顯示在創作者卡／個人頁，資產卡不重複，UGC卡片.md §2）

5. 頁面 wireframe¶

頁面路由清單以程式架構.md §13 頁面路由為唯一權威；本節只談 wireframe / 視覺，不重複定義路由。

各頁 wireframe 詳見美術資源/頁面線框.md；該檔覆蓋產品 route 的版面細化，最後一節收斂 RWD／動畫／觸控通則。參考成品見 §6。

6. 參考成品¶

位置	內容	來源提示詞
`參考雛形/定版/`	可進 Git 的小型審查預覽；高解析／無損 master 進 immutable Release	提示詞/UI資產.md
`參考雛形/草稿/`	早期整頁概念藝術：13 頁 × desktop/mobile ＋ hero moodboard（`ui-<page>-<platform>.webp`）	提示詞/頁面概念圖.md
immutable Release	`release-input/parts/`、`tracks/`、`audio/`、`ui/` 的 authoring GLB／PNG／音訊 master；manifest 鎖 logical path、Release asset、size 與 SHA-256	Immutable Release
`實際使用圖/`	受版控的 favicon、小型 SVG、設定、README 與可重跑生成工具；高解析 PNG 不在此目錄	提示詞/UI資產.md

格式分工：高解析／無損 PNG master 進 immutable Release；Git 只留審查所需的小型預覽。草稿供風格回顧，可用 WebP q92 一般 blob。

工程對版以本 repo 線框、定版 PNG 與代表 viewport 驗收為準；概念稿只提供風格與 onboarding 視覺，不得反向覆寫 canon。

正式車庫 PNG 母檔只供再製與衍生；app runtime 由各 public/assets/themes/<id>/assets/ manifest 引用最佳化 WebP，母檔不得進 Angular build 或 PWA precache。

7. 美術方向¶

詳見美術資源/美術方向.md（參考件、非 spec）：公版 GLB 風格、比例、零件辨識標準、不可直接照抄的 IP 邊界。零件功能規格見零件與場景.md + 建模參數.md。

8. 圖像提示詞¶

收納規則：實作需要生圖 → 提示詞一律收 美術資源/提示詞/（活文件、隨需求增修）；高解析 PNG 母檔收 release-input/ui/，可重跑設定／程式收 美術資源/實際使用圖/，版面基準收 參考雛形/定版/、早期概念稿收 參考雛形/草稿/；個人測試輸出不納入本 repo 權威。

⭐ 圖檔禁字鐵則（權威＝程式架構/ui-frontend.md §16）：所有出貨圖檔資產禁止內含文字（任何語言）；數字 0–9 與跨語系中立符號可。文字一律 i18n 執行期渲染（四層 fallback 階梯）；頁面概念圖（設計參考件）豁免。

檔	產出	備註
零件參考圖.md	builtin 24 零件 3D 參考圖（photoreal、Tripo）	「50K 面＋1024 紋理」＝生成高模建議值、非出貨值（程式架構/builtin-assets.md §4）
場地參考圖.md	builtin 3 場地 3D 參考圖（stylized）	⚠️ 含舊 spec 殘留——重生成前需整檔重對 canon（檔頭警示）
UI資產.md	個別 UI 資產（PNG／轉 SVG／轉 GLB）	高解析產出 → `release-input/ui/`、版面基準 → `參考雛形/定版/`
頁面概念圖.md	整頁概念藝術（3D 動畫電影卡通＋動畫熱血 70/30）	產出 → `參考雛形/草稿/`；色票 v2＝概念稿刻意暖化、app 實際色票以設計系統.md 為準

3D reference：生成服務輸入屬 authoring 過程；真正可追溯的 source 輸入是 immutable Release、其 authoring-release-manifest.json 與 checksum。main 的 runtime 成品是衍生物。

GLB repository 驗證（權威＝使用技術.md §11）：main repository scripts/glb-inspect.mjs 由 pnpm check:assets 調用，驗 shipped GLB、manifest、幾何、貼圖與 metadata policy。

9. UI 技術策略¶

詳見程式架構/ui-frontend.md：前端架構選型理由（Angular）、o4-* 元件庫策略、design token 架構（權威=主題系統）、狀態管理（Signals / RxJS）、動畫策略（CSS / GSAP / Lottie / Three.js 視場景）、字型。

10. 美術變更影響¶

美術 / 文檔 / 主題資源（含 design token）→ patch（版本規範.md §3 純資源變更）；UI 結構性變更 → 依 Conventional Commits（feat＝minor / fix＝patch，版本規範 §4）；美術不觸 deterministic / protocol——唯一例外＝公版資產物理參數變動（major，版本規範 §3）。

11. License 注意¶

來源	license
玩家自製 UGC GLB	創作者保留版權（版權.md §1）
公版 builtin assets	隨 codebase MIT（版權.md §11）
參考圖 / 概念稿（AI 生成）	通常無版權，但需注意 AI 服務 ToS
第三方工具／素材	僅可在授權相容且來源可追溯時納入；各自 license

12. 跨模組對接¶

對象	內容
美術資源/設計系統.md	設計系統
美術資源/主題外觀與 RWD.md	Skin Layer / 頁面套用強度 / 多比例 RWD 穩定規格
美術資源/主題審查計畫.md	viewport / 原型 / 驗收工作（非 canon）
程式架構/ui-frontend.md	前端選型 / 元件庫 / token / 字型 implementation authority
美術資源/頁面線框.md	頁面 wireframe
美術資源/UGC卡片.md	UGC 卡片
美術資源/美術方向.md	公版 GLB 美術方向
賽內機制.md §2.4	HUD 規格
主題系統.md	出貨 UI 資產（token / 圖 / 音訊）歸屬 default 主題
`system-constants/ui/`（ui.md §12–§16）	動畫行為 / 音訊 / 版面 / 語系 / SEO 常數
`i18n/`（語系清單.md）	UI 文字翻譯

13. 美術人員與工程師分工¶

角色	範圍
美術	參考圖 / 概念稿 / design token 值 / palette（token 名錄動不得——權威=主題系統）
前端工程	從 design token 實作 `o4-*` 元件與頁面
後端 / 物理	不直接接觸美術
玩家（UGC）	自製 GLB（不需專業美術也能用 AI 工具）