Releases: peiwen2015/Running-Analytics
Release list
v1.5.0 - FIT 下載、月份管理與批次轉檔流程
這個版本把原本的單檔 FIT 轉 Excel 工具，擴充成更完整的月份工作流：可從 Garmin Connect 下載 FIT、依月份整理 FIT 與 Excel、批次轉檔，並在批次完成後補齊活動資訊。
Excel Schema 維持 跑步分析資料 v1.1，本版沒有變更 Excel 欄位結構。
新增功能
-
Garmin FIT 下載
- 支援下載指定月份跑步活動
- 支援只下載今天的跑步活動
- 下載進度頁會顯示登入、搜尋、下載、略過與錯誤狀態
-
月份資料夾管理
- FIT 存放於
FIT/YYYY-MM/ - Excel 輸出於
EXCEL/YYYY-MM/ - FIT 清單可讀取月份子資料夾
- FIT 存放於
-
批次轉檔
- 可選擇月份並掃描
FIT/YYYY-MM/ - 顯示每個 FIT 的轉檔狀態
- 支援一鍵轉換未完成項目
- 支援 FIT 較新時自動重轉
- 批次轉檔進度頁顯示目前處理檔案與完成狀態
- 可選擇月份並掃描
-
活動資訊補資料流程
- 批次轉檔完成後，可直接選擇本次轉出的 Excel 補活動資訊
- 可編輯鞋款、課表類型、訓練目的、感受、補給、備註與訓練指標
- 儲存後可回到同一次批次轉檔清單
- 已補資料的 Excel 會在本次清單中顯示
✓ 已補
改善
- Garmin 下載回傳 ZIP 時會自動解壓出真正 FIT
- 改善 Garmin
429 Too Many Requests限流錯誤提示 - Excel 預設檔名改為穩定格式：
跑步分析資料 v1.1_YYYYMMDD_活動ID.xlsx- 若手動 FIT 檔名無法取得 activityId，使用
FIThash 短碼作為替代 ID
- 批次轉檔與單檔轉檔共用一致的 Excel 命名規則
- 每公里平均配速等平均時權重錯誤調整
- 改善批次頁載入效能
修正
- 修正 Garmin Original 下載可能實際回傳 ZIP，導致 FIT 解析失敗的問題
- 修正月份判斷避免誤把 activityId 判斷成日期
- 修正 Excel 下載回應標頭
注意事項
- Excel Schema 仍維持
跑步分析資料 v1.1 - Garmin Connect 可能對大量登入或下載請求回傳
429 Too Many Requests - 若遇到 Garmin 限流，建議停止重試並等待一段時間後再下載
v1.4.3 強化 Excel Schema 與長期資料庫架構
Running Analytics Converter v1.4.3 主要強化 Excel Schema 與長期資料庫架構，讓輸出的 Excel 更接近未來 SQLite、Dashboard 與 AI 分析可直接使用的 Master Dataset。
新增與改善：
活動資訊改為固定 Schema 區塊：
- Metadata
- Activity
- Environment
- Subjective
- Training Metrics
- Running Economy
Activity 區塊新增活動摘要：
- 距離 (km)
- 時間
- 平均配速
Environment 區塊新增：
- 天氣描述
Subjective區塊：
- 感覺如何改為與Garmin一致
- 感受難度改為與Garmin一致
Training Metrics 區塊新增：
- Stamina 起始 (%)
- Stamina 結束 (%)
新增 Running Economy 區塊：
- 平均步頻
- 平均步幅
- 平均觸地時間 (GCT)
- 平均垂直振幅
- 平均垂直比
Section 標題加強視覺：
- 深色底
- 白字粗體
- 合併 A:B
- 更接近 Data Dictionary / Schema 文件風格
Web 介面新增「天氣描述」欄位。
保持相容：
- 舊 FIT 檔名沒有 Garmin Activity ID 仍可轉檔
- FIT Hash 仍會固定產生
- Excel Schema 版本維持 v1.1
v1.4.2 主要強化「課表類型」與「訓練目的」的選擇流程，讓轉檔時更快、更不容易選錯
新增
- 轉檔頁新增「課表與訓練目的對照」表
- 每個課表類型可對應一個或多個訓練目的
- 對照表提供「套用」按鈕
- 按下「套用」後會自動帶入：
- 課表類型
- 對應的訓練目的
- 訓練目的支援多選
- 課表與訓練目的的對應關係可在「下拉選單設定」頁修改
- 對應關係會儲存在：
config/dropdown_options.json - 儲存Garmin活動ID與FIT檔的SHA
改善
- 課表類型、訓練目的、對應關係都改為可設定
- 對照表不再寫死在程式裡
- 如果之後修改課表或訓練目的，可以同步修改對應關係
- 轉檔頁會依設定檔即時產生對照表
- 套用對應時使用精確選項值，避免文字模糊比對造成錯誤
- 美化首頁，增加Logo
- Windows .bat 的友善錯誤提示
- EXCEL格式版本變為v1.1
保留
- App 版本：v1.4.2
- Excel 格式版本維持：跑步分析資料 v1.0
- 原本 Web 轉檔流程不變
- 原本 CLI 轉檔方式不變
- 自動天氣、最大心率、Critical Power、Training Effect、Training Load 功能不變
- Excel 輸出格式不變
v1.4.1 訓練目的改為可多選
v1.4.0 - Web 轉檔摘要、下載按鈕與友善錯誤提示
v1.4.0
新增
- App 版本號正式化：
Running Analytics v1.4.0 - Excel 格式版本獨立保留為：
跑步分析資料 v1.0 - Web 轉檔完成後顯示活動摘要
- 活動日期
- 距離
- 時間
- 平均配速
- 平均心率
- 平均功率
- 天氣
- Training Effect
- Training Load
- 新增「下載 Excel」按鈕
- 新增「開啟 EXCEL 資料夾」按鈕
- CLI 支援查看版本：
python fit_to_excel.py --version 改善
「開啟 Excel」維持跨平台支援Windows
macOS
Linux
常見錯誤改成較容易理解的提示未選擇 FIT 檔
FIT 格式不正確
FIT 沒有每公里分段資料
檔案權限問題
天氣查詢逾時或失敗
macOS 啟動檔設定為可執行
保留
macOS 啟動檔：跑步分析資料轉檔.command
Windows 啟動檔：跑步分析資料轉檔.bat
Web 介面選擇 .fit 檔
自動輸出 Excel 到 EXCEL/
自動帶入天氣、最大心率、Critical Power、Training Effect、Training Load
可在 Web 介面修改下拉選單
CLI 轉檔方式
短版功能說明
## 功能
- macOS / Windows 本機執行
- 從 Web 介面選擇 Garmin `.fit` 檔
- 自動轉成 Excel
- 自動抓 Open-Meteo 歷史天氣
- 自動帶入最大心率、Critical Power、Training Effect、Training Load
- 每公里心率%、功率%、總平均配速自動計算
- 可修改鞋款、課表類型、訓練目的、Garmin 主觀感受選項
- 轉檔完成後可直接開啟或下載 Excel
- CLI 方式仍可使用v1.3.0 - Windows support
Adds Windows support for the local Web app.
New:
- Added Windows launcher: 跑步分析資料轉檔.bat
- Updated Excel opening behavior to support Windows, macOS, and Linux
- Updated README with Windows startup instructions
Existing:
- macOS launcher remains supported
- FIT to Excel conversion remains unchanged
- Dropdown settings page remains supported
v1.2.0 - Dropdown settings page
Adds a dropdown settings page to the local Web interface.
New:
- Edit shoes, workout types, training focus, and Garmin RPE options in the app
- Save changes to config/dropdown_options.json
- Updated navigation between conversion and settings pages
Existing:
- FIT to Excel conversion remains unchanged
- CLI usage remains supported
v1.1.0 - Web interface
Adds a local web interface for selecting FIT files and exporting Excel files.
Keeps CLI conversion support.
v1.0.0 - CLI version
Original command-line FIT to Excel version.