Clubhouse Games

本專案收錄多款 Clubhouse Games（世界遊戲大全） 的規格與網頁版實作。我們將各類別的經典遊戲規格化並實作為獨立網頁，透過一個統一的「遊戲總覽選單」進行入口整合，讓使用者能在瀏覽器中直接體驗多款小遊戲。

專案包含從紙牌、棋盤到益智與運動等共計 20 餘款遊戲的規格說明，並已實作包含二十一點、黑白棋、接龍等經典作品。

---

0. 下一階段：One-shot／Few-shot 遊戲開發中心

Clubhouse Games 接下來不只收錄遊戲，而會成為一個公開的 AI 遊戲開發實驗中心：測試模型能否透過一次或少量指令，把遊戲規格轉成真正可以操作、測試與發布的作品。

每次實驗預計記錄：

• 輸入條件：模型、工具、初始 Prompt、參考素材與 Shot 數量。
• 開發過程：產生的程式骨架、互動邏輯、素材處理與修正次數。
• 結果評估：規則正確性、可玩性、完成度、開發耗時與人工介入程度。
• 公開證據：可玩 Demo、原始碼、成功路徑、失敗原因與後續改進。

目標不是宣稱「一個 Prompt 就能完成所有遊戲」，而是建立一套可以比較不同模型、提示策略與 Agent 工作流的實驗紀錄。

---

1. 遊戲一覽與分類結構

為了利於管理，遊戲被劃分為多個類別，其原始碼與規格文件也依此結構擺放：

• 01 紙牌 (4款)：二十一點、連環新接龍（FreeCell）、克朗代克接龍、最後一張牌
• 02 棋盤 (3款)：黑白棋、西洋跳棋、四子棋
• 03 牌塊與骰子 (2款)：西洋骨牌、快艇骰子
• 04 運動與街機 (5款)：玩具網球／足球／拳擊／棒球、羽毛球接殺訓練
• 05 益智 (3款)：神秘液體排序、章魚燒、俄羅斯方塊
• 06 迷你遊戲 (5款)：彈戲、軌道車、猜顏色、坦克對決、武士反應訓練

(詳細規格請見 GitHub 倉庫 內各分類資料夾下的規格文件)

---

2. 系統架構與總覽選單

本專案的核心架構是透過單一的 index.html 站台首頁作為「總覽選單」，所有的遊戲實作則獨立置於 Games/ 目錄之下。

• 總覽選單：負責遊戲列表呈現與入口跳轉。
• 子遊戲實作：各遊戲獨立開發與打包，例如 Games/Blackjack-main/。
• 單一開發伺服器：在本地開發時，只需啟動一個 dev server，選單與所有建置好的遊戲都會在同一個 Port 提供服務，免去管理多個微服務的麻煩。

---

3. 已實作遊戲範例

目前已完成建置並整合進系統的遊戲範例包含：

• 二十一點 (Games/Blackjack-main/)
• 連環新接龍 (FreeCell) (Games/FreeCell/)
• 最後一張牌 (Last Card) (Games/Last-Card/)
• 接龍 (Klondike) (Games/Klondike/)
• 羽毛球接殺訓練 (Games/Block-the-smash/)
• 武士反應訓練 (Games/Instant-Flash/)
• 神秘液體排序 (Games/Mystery-Liquid-Sort/)

---

4. 本地開發與啟動流程

專案採用 TypeScript 等前端技術，且各遊戲可獨立建置：

1. 安裝根目錄依賴：

   npm install

2. 安裝子專案依賴（若有新增遊戲）：

   cd Games/Blackjack-main && npm install && cd ../..

3. 建置指定的遊戲（將子遊戲編譯產出準備就緒）：

   npm run build:game Blackjack-main

4. 啟動統一開發伺服器：

   npm run dev

5. 開啟 http://localhost:3000 即可看到總覽選單，點擊「進入遊戲」即可無縫切換到已建置的子遊戲。

---

5. 部署到 GitHub Pages

專案支援將選單與所有建置完成的子遊戲打包並發佈至 GitHub Pages。相關的建置流程、CI 腳本與本地 build:pages 任務皆記錄於 docs/DEPLOYMENT.md 中，確保自動化部署的一致性與便利性。