一個完全免費、注重隱私、專注於輕量化網頁體驗的 GGPoker 手牌分析工具，讓您隨時隨地都能覆盤。
English • 繁體中文
從 Pokercraft 收集你的資料檔案
請在你的 Pokercraft 手牌區塊，點選紅色按鈕來下載「手牌歷史」（Hand histories）檔案。
如果你的帳戶有太多手牌紀錄，GGNetwork 會阻止你進行大量下載，因此你可能需要分開按月或按週下載紀錄。
立即體驗 👉 ggpokerAnalyzer
- 📈 全方位數據分析: 計算超過 40 項關鍵撲克數據 (VPIP, PFR, 3-Bet, C-Bet 等)。
- 📊 圖表視覺化: 以圖表呈現盈利走勢、位置數據、時間勝率等，讓數據一目了然。
- 💡 智能建議: 根據您的數據，提供個人化的改進建議，幫助您找到策略漏洞。
- 🔐 隱私至上: 所有牌譜數據只在您的瀏覽器本地處理，絕不上傳到任何伺服器，確保您的數據安全。
- 🌐 多語言支援: 支援繁體中文與英文介面。
- 💾 數據整合: 支援上傳 .txt 牌譜檔案，並可合併舊的 .json 分析報告，進行長期數據追蹤。
與市面上需要複雜設定和訂閱費的專業追蹤軟體（如 PokerTracker, Hold'em Manager）不同，本工具的目標是提供一個輕量、快速、免費且安全的替代方案。我們專注於網頁體驗，讓您不需要安裝任何軟體，只需打開瀏覽器，無論是在電腦前還是在移動裝置上，都能隨時隨地快速覆盤，找到自己的優勢與待改進之處。
- 完全免費且開源： 無任何使用成本，程式碼透明，具備高度信任感。
- 高度隱私保護： 所有運算均在使用者本機端完成，手牌數據不經過任何伺服器，無數據外洩風險。
- 跨平台、免安裝： 只需要瀏覽器即可運作，方便在任何裝置上使用。
- 數據可攜與累積： 分析結果可匯出成 JSON 檔案，方便使用者自行備份，並可在下次合併分析，實現長期數據追蹤。
- 直觀的數據視覺化： 提供圖表化呈現，比單純閱讀文字檔更易於理解自己的表現趨勢。
- 無即時 HUD 功能： 與專業軟體相比，無法在牌桌上即時顯示對手數據。
- 依賴手動上傳： 需要手動從 GGPoker 客戶端導出紀錄並上傳，操作上不如自動匯入的軟體便利。
- 數據維度較基礎： 目前提供的數據指標雖然核心，但與專業軟體相比仍不夠細緻 (例如：缺少特定牌型組合的獲利分析)。
- 前端計算效能瓶頸： 當手牌數量達到數十萬級別時，純前端 JavaScript 計算可能遇到效能瓶頸。
- 缺乏對手分析功能： 工具完全聚焦在使用者 (Hero) 本身的數據，無法建立對手資料庫進行針對性分析。
我們有一個宏大的願景，希望在社群的共同努力下，一步步實現以下功能：
- [雲端後端整合]： 將計算密集型的解析與統計工作移至後端，解決前端效能瓶頸。
- [使用者帳號系統]： 引入帳號系統，讓使用者可以將分析結果自動儲存於雲端，實現跨裝置數據同步。
- [手牌視覺化重播]： 點擊單一手牌紀錄，以圖形介面重播該手牌的完整過程。
- [進階數據篩選器]： 允許使用者根據位置、起手牌、牌局結果等多維度篩選數據。
- [起手牌矩陣熱圖]： 以 13x13 的矩陣圖顯示所有起手牌的 VPIP、PFR、獲利等數據。
- [特定賽事/盲注分析]： 增加篩選功能，可只分析特定盲注等級或賽事類型 (如 Rush & Cash)。
- [更豐富的圖表類型]： 增加圓餅圖 (行動分佈)、雷達圖 (玩家風格評估) 等。
- [簡易對手數據標記]： 允許使用者在分析時，針對特定對手 ID 加上標籤 (如：魚、緊兇)。
- [目標導向學習模組]： 根據數據弱點，自動推薦相關的撲克學習資源或文章連結。
- [社群分享報告]： 產生一個可分享的唯讀報告頁面連結，方便與教練或朋友討論數據。
- Vite: 高效能的前端建構工具。
- Vanilla JavaScript (ESM): 無框架，專注於核心邏輯。
- Tailwind CSS: 用於快速建構現代化 UI。
- Chart.js: 實現數據視覺化圖表。
/
├── index.html \# 主 HTML 檔案
├── package.json \# 專案依賴與腳本
├── vite.config.js \# Vite 設定檔
├── demo_data/
│ ├── lite_data/ \# 輕量版本測試的手牌資訊100手左右
│ └── 10000_data/ \# 一萬手的手牌資訊
└── src/
├── main.js \# 應用程式主進入點
├── style.css \# CSS 樣式
├── utils.js \# 共用輔助函式
├── lib/
│ ├── parser.js \# 手牌紀錄解析邏輯
│ └── stats.js \# 數據統計與合併邏輯
└── ui/
├── dashboard.js \# 儀表板 UI 渲染邏輯
└── lang.js \# 多語言翻譯與管理
環境需求:
- Node.js (建議版本 18.x 或更高)
- npm / pnpm / yarn
步驟:
- Clone 專案庫
git clone https://github.com/Layorx/GGPoker-Hand-Analyzer.git
cd GGPoker-Hand-Analyzer
-
安裝依賴
npm install -
啟動開發伺服器
npm run dev應用程式將會在 http://localhost:5173 (或另一個可用端口) 上運行。
-
建構專案
npm run build建構後的靜態檔案會輸出到 dist 資料夾中。
這個專案是開源的，我們非常歡迎任何形式的貢獻！無論您是經驗豐富的開發者，還是剛入門的新手，都歡迎您一起加入，讓這個工具變得更好！
如何貢獻:
- 發現問題或有新想法？
請到 GitHub Issues 頁面提交您的問題或建議。請盡可能詳細地描述，方便我們理解。 - 想貢獻程式碼？
- Fork 這個專案庫。
- 建立一個新的分支 (
git checkout \-b feature/AmazingFeature)。 - 進行您的修改並 Commit (
git commit \-m 'Add some AmazingFeature')。 - 將您的分支推送到遠端 (
git push origin feature/AmazingFeature)。 - 開啟一個 Pull Request，並詳細說明您的修改內容。
我們將會盡快 review 您的貢獻。感謝所有為這個專案付出時間和精力的開發者！
本專案採用 MIT License 授權。
