# 更新紀錄

## [1.0.2] - 2026-05-25

### ⚡ 效能優化

- 將設定檔格式從 YAML 改為 TOML，改用 Python 內建 `tomllib` 解析，減少第三方依賴並加快啟動速度
- 在背景執行緒預熱重量級模組（`plotly`、`folium`、`gpxpy`、`numpy`、`geopy`），縮短首次載入頁面時間

---

## [1.0.0] - 2025-12-03

### 🎉 首次正式發布

歡迎使用**山山登山小助手** v1.0.0！這是第一個穩定版本，提供完整的登山路線分析與天氣查詢功能。

---

## ✨ 新功能

### 📊 路線分析
上傳您的 GPX 檔案，立即獲得詳細的路線資訊：

- **基本統計**
  - 📏 總距離
  - ⬆️ 累積爬升
  - ⬇️ 累積下降
  - 🏔️ 最高/最低海拔
  - ⏱️ 預估行進時間

- **智慧計算**
  - 自動過濾 GPS 雜訊，提供更準確的爬升/下降數據
  - 根據路線距離與爬升，智慧估算所需時間
  - 支援自訂行進速度參數

### 🗺️ 互動式地圖

輕鬆查看完整路線與重要地標：

- **雙地圖切換**
  - 🌍 OpenStreetMap - 適合查看周邊設施
  - 🗻 魯地圖 - 等高線地圖，適合登山路線規劃

- **清楚標示**
  - 🔵 起點終點：顯示座標與海拔
  - 🟠 航點標記：自動顯示 GPX 檔案中的所有航點（如山屋、水源、岔路等）
  - 🔴 路線軌跡：完整呈現登山路徑

- **互動功能**
  - 點擊航點查看名稱與海拔
  - 縮放與拖曳地圖
  - 自由切換地圖圖層

### 📈 視覺化圖表

一目了然的路線特性：

- **海拔剖面圖**
  - 互動式圖表，滑鼠移動即顯示該點資訊
  - 清楚呈現整段路線的海拔變化
  - 幫助識別陡峭路段與平緩路段

- **坡度分析圓餅圖**
  - 依坡度分為：平緩、緩坡、陡坡、急坡
  - 快速了解路線難度分布

### 🌤️ 天氣預報

出發前掌握天氣狀況，避免遇到惡劣天候：

- **7 天天氣預報**
  - 🌡️ 溫度：最高/最低/體感溫度
  - 💧 濕度：相對濕度
  - 🌧️ 降雨：降雨機率與預估雨量
  - 💨 風況：風速與風向（附安全等級指標 🟢🟡🟠🔴）
  - ☀️ UV 指數：附等級指標（🟢🟡🟠🔴🟣）
  - 🌅 日出/日落時間

- **日期選擇**
  - 點選任一日期查看詳細天氣
  - 方便規劃多日行程

### 🏔️ 安全提醒

貼心的登山安全提示：

- **高山症警示**
  - 當路線海拔較高（超過2100公尺）時，提醒登山者注意高山症風險
  - 附上高山症預防資訊連結，幫助登山者提早準備與注意

### 🎨 使用體驗

簡潔的介面設計：

- ✨ 臺灣山岳背景（南湖圈谷）
- 📱 響應式設計，支援電腦、手機
- ⚡ 快速載入

---

## 💡 使用提示

1. **GPX 檔案來源**
   - 可從健行筆記、Hikingbook 等網站下載
   - 也可使用登山 GPS App 記錄的航跡

2. **最佳使用方式**
   - 載入路線 GPX 檔，搭配海拔剖面圖，規劃每日行程與體力分配
   - 出發前一天查看天氣預報，注意溫度、降雨機率與 UV 指數，準備適當裝備

3. **注意事項**
   - 預估時間僅供參考，請依個人體能調整
   - 山區天氣變化快，仍需隨時注意實際天氣狀況
   - 行經高海拔地區，請留意高山症症狀

---

## 🙏 感謝使用

感謝您使用山山登山小助手！如果有任何建議或問題，歡迎回饋(<gt810034@gmail.com>)。

祝您登山愉快，平安歸來！🏔️

---

## 📝 技術資訊

**適用環境**
- 瀏覽器：Chrome、Firefox、Safari（建議使用最新版本）
- 裝置：桌機、筆電、平板、手機

**檔案限制**
- 支援標準 GPX 格式
- 檔案大小上限：30 MB

**資料來源**
- 天氣資料：Open-Meteo API
- 地圖圖層：OpenStreetMap、魯地圖

---

更新日期：2025-12-03
