SparkyFitness - MyFitnessPal 的自架替代方案

SparkyFitness 是一套全面的健身追蹤與管理應用程式，設計用於協助使用者監控營養、運動及身體數據。它提供每日進度追蹤、目標設定及詳細報告工具，助你維持健康生活方式。

文件： https://codewithcj.github.io/SparkyFitness

✨ 功能

🍎 營養追蹤

• 記錄您的每日餐點
• 建立並管理自訂食物和分類
• 透過互動式圖表檢視摘要並分析趨勢

💪 運動紀錄

• 記錄您的運動活動
• 瀏覽並搜尋完整的運動資料庫
• 追蹤健身進展

💧 飲水攝取監控

• 追蹤每日飲水目標
• 簡單快速地記錄飲水量

📏 身體測量

• 記錄身體指標（例如體重、腰圍、手臂）
• 新增自訂測量類型
• 以圖表視覺化進展

🎯 目標設定

• 設定並管理健身與營養目標
• 長期追蹤進度

🗓️ 每日簽到

• 監控每日活動
• 透過習慣追蹤保持一致

🤖 AI 營養教練（SparkyAI）

• 透過聊天記錄食物、運動、身體數據及步數
• 上傳食物圖片自動記錄餐點
• 包含聊天紀錄及個人化指導

🔒 使用者驗證與個人檔案

• 安全登入系統
• 切換使用者個人檔案
• 支援家庭存取與管理

📊 全面性報告

• 產生營養與身體指標摘要
• 追蹤數週或數月的長期趨勢

🎨 可自訂主題

• 切換明亮與深色模式
• 以極簡、無干擾介面設計

需要協助嗎？

• 加入 Discord

https://discord.gg/vcnMT5cPEA

• 在討論區發文

� 快速開始

幾分鐘內即可啟動 SparkyFitness：

# Clone the repository
git clone https://github.com/CodeWithCJ/SparkyFitness.git
cd SparkyFitness
Copy environment template and edit as needed
cp docker/.env.example .env
Start development environment (with live reloading)
./docker/docker-helper.sh dev up
Access application at http://localhost:8080

📖 文件說明

完整的安裝指南、開發設定與使用說明，請參閱我們的詳細文件：

👉 SparkyFitness 文件網站

快速連結

• 🚀 入門指南 - 開發與正式環境完整設定指南
• 🐳 Docker 指南 - Docker 部署與設定
• 🔧 開發工作流程 - 開發者指南與貢獻流程
• 📊 功能總覽 - 完整功能文件
• 🏗️ 架構設計 - 技術架構與設計
• 請參考 Wiki 以取得範例環境設定及行動應用程式配置。

🐳 Docker 部署

正式環境（推薦）：

cp docker/.env.example .env  # Edit as needed
./docker/docker-helper.sh prod up
Access at http://localhost:3004

開發：

cp docker/.env.example .env  # Edit as needed  
./docker/docker-helper.sh dev up
Access at http://localhost:8080 (live reloading)

如需詳細的安裝說明、環境設定及疑難排解，請參閱完整文件。

⚠️ 已知問題 / Beta 功能 ⚠️

以下功能目前處於測試階段，尚未經過充分測試。可能會出現錯誤或功能不完整的情況：

• AI 聊天機器人
• 多用戶支援
• 家人及朋友訪問
• Apple Health Data 整合

本應用程式正在積極開發中。由於 Supabase 到 PostgreSQL 的遷移，部分功能可能無法如預期運作。在應用程式穩定前，可能會引入重大變更（BREAKING CHANGES）。 您可能需要因新版本調整 Docker/環境變數。因此，不建議使用 Watchtower 或類似應用進行自動升級。請務必閱讀發佈說明以了解任何重大變更（BREAKING CHANGES）。

--- Tranlated By Open Ai Tx | Last indexed: 2025-10-04 ---