Skip to content

v1.5.0 - FIT 下載、月份管理與批次轉檔流程

Latest

Choose a tag to compare

@peiwen2015 peiwen2015 released this 10 Jul 02:56
0953820

這個版本把原本的單檔 FIT 轉 Excel 工具,擴充成更完整的月份工作流:可從 Garmin Connect 下載 FIT、依月份整理 FIT 與 Excel、批次轉檔,並在批次完成後補齊活動資訊。

Excel Schema 維持 跑步分析資料 v1.1,本版沒有變更 Excel 欄位結構。

新增功能

  • Garmin FIT 下載

    • 支援下載指定月份跑步活動
    • 支援只下載今天的跑步活動
    • 下載進度頁會顯示登入、搜尋、下載、略過與錯誤狀態
  • 月份資料夾管理

    • FIT 存放於 FIT/YYYY-MM/
    • Excel 輸出於 EXCEL/YYYY-MM/
    • FIT 清單可讀取月份子資料夾
  • 批次轉檔

    • 可選擇月份並掃描 FIT/YYYY-MM/
    • 顯示每個 FIT 的轉檔狀態
    • 支援一鍵轉換未完成項目
    • 支援 FIT 較新時自動重轉
    • 批次轉檔進度頁顯示目前處理檔案與完成狀態
  • 活動資訊補資料流程

    • 批次轉檔完成後,可直接選擇本次轉出的 Excel 補活動資訊
    • 可編輯鞋款、課表類型、訓練目的、感受、補給、備註與訓練指標
    • 儲存後可回到同一次批次轉檔清單
    • 已補資料的 Excel 會在本次清單中顯示 ✓ 已補

改善

  • Garmin 下載回傳 ZIP 時會自動解壓出真正 FIT
  • 改善 Garmin 429 Too Many Requests 限流錯誤提示
  • Excel 預設檔名改為穩定格式:
    • 跑步分析資料 v1.1_YYYYMMDD_活動ID.xlsx
    • 若手動 FIT 檔名無法取得 activityId,使用 FIT hash 短碼作為替代 ID
  • 批次轉檔與單檔轉檔共用一致的 Excel 命名規則
  • 每公里平均配速等平均時權重錯誤調整
  • 改善批次頁載入效能

修正

  • 修正 Garmin Original 下載可能實際回傳 ZIP,導致 FIT 解析失敗的問題
  • 修正月份判斷避免誤把 activityId 判斷成日期
  • 修正 Excel 下載回應標頭

注意事項

  • Excel Schema 仍維持 跑步分析資料 v1.1
  • Garmin Connect 可能對大量登入或下載請求回傳 429 Too Many Requests
  • 若遇到 Garmin 限流,建議停止重試並等待一段時間後再下載