<!--
  📦 模組：CHANGELOG
  🕒 最後更新：2025-06-14T05:30:00+08:00
  🧑‍💻 作者/更新者：@s123104
  🔢 版本：v1.5.0
  📝 摘要：更新成就系統與厭世來源分頁功能
-->

# 📝 更新日誌 (Changelog)

所有重要的專案變更都會記錄在這個文件中。

格式基於 [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)，並遵循 [語義化版本](https://semver.org/spec/v2.0.0.html)。

---

## [v2.1.0] - 2025-06-18

### ✨ 新增 (Added)

- 智能 PWA 安裝模態窗，自動檢測用戶設備和瀏覽器
- 動態生成對應的安裝指引（iOS Safari、Android Chrome、桌面版等）
- 近期記錄編輯功能，支援修改心情分類和描述內容
- 即時厭世分數計算和顯示
- 系統檢測功能，提供個性化安裝體驗

### 🔧 修正 (Fixed)

- 修正近期記錄區塊捲軸無法顯示到最底部的問題
- 優化近期記錄容器的高度計算和滾動行為
- 修正 PWA 模態窗在不同螢幕尺寸下的顯示問題
- 改善觸控滾動的響應性和流暢度

### 🎨 改進 (Improved)

- 重構 PWA 模態窗 UI/UX，採用現代化設計語言
- 增強模態窗視覺效果，添加毛玻璃背景和動畫
- 優化近期記錄項目的排版和間距
- 改進響應式設計，適配更多設備尺寸
- 強化 PWA 安裝按鈕的互動效果

### 🔄 變更 (Changed)

- 升級版本號至 v2.1.0
- 更新 Service Worker 內部版本至 v15
- 調整近期記錄容器的 CSS 樣式和行為
- 重構 PWA 檢測和安裝邏輯

### 🛠️ 技術改進 (Technical)

- 添加設備和瀏覽器自動檢測算法
- 實作動態內容生成系統
- 優化 CSS 媒體查詢和響應式規則
- 改善 JavaScript 模組化結構
- 強化 PWA 緩存更新機制

---

## [v2.4.2+] - 2025-06-15

### 🎯 重大改進 - PWA 自動更新系統強化

#### 🔧 代碼清理與修復

- **完全移除 "good" 心情**：清理所有遺留的 "good" 心情相關代碼
- **數據遷移優化**：簡化數據遷移函數，移除不必要的 good → bad 轉換邏輯
- **統計系統完善**：確保所有 6 種心情（錢途茫茫、身心俱疲、鳥事一堆、缺乏成長、破爛心情、職場霸凌）完整支援

#### 🚀 PWA 自動更新革命性升級

- **Service Worker 架構重設計**：採用版本控制策略 (v2.4.2)
- **智能緩存策略實現**：
  - 網路優先策略：重要文件如 script.js、styles.css
  - 緩存優先策略：靜態資源如圖片、字型文件
  - Stale-While-Revalidate：動態內容的最佳平衡策略
- **強制更新機制**：確保移動端 PWA 用戶能及時收到更新通知
- **版本檢測系統**：雙重版本號管理（軟體版本 v2.4.2 + 內部版本 v14）

#### 💡 用戶體驗革新

- **智能更新提示**：美觀的漸層色彩更新通知界面
- **非阻塞式更新**：用戶可選擇立即更新或稍後提醒（5 分鐘後再次提醒）
- **強制更新模態**：重要更新時顯示全屏模態對話框
- **更新進度反饋**：清楚顯示更新狀態與進度
- **錯誤處理優化**：友善的錯誤提示與恢復機制

#### ⚡ 性能與可靠性提升

- **定期自動檢查**：每 30 秒自動檢查更新
- **可見性觸發**：頁面重新獲得焦點時主動檢查更新
- **緩存清理機制**：自動清理舊版本緩存，避免冗餘
- **雙向通信系統**：Service Worker 與主應用的完整通信機制

#### 🎨 UI/UX 設計優化

- **動畫效果增強**：下載圖標脈衝動畫、更新圖標旋轉動畫
- **視覺層次優化**：採用現代化的卡片設計和陰影效果
- **顏色系統統一**：藍色到靛青的漸層配色，綠色成功提示，紅色錯誤警告
- **響應式適配**：完美適配各種屏幕尺寸的更新提示界面

#### 🔧 開發者體驗改善

- **詳細日誌系統**：完整的 Service Worker 生命週期日誌記錄
- **錯誤監控**：未處理 Promise 拒絕和錯誤事件的完整監控
- **調試支援**：開發階段的緩存控制和版本調試功能
- **版本控制**：清晰的版本號管理策略，便於追蹤和部署

### 📊 技術規格升級

- **內部版本號**：v14（Service Worker 強制更新標識）
- **軟體版本**：v2.4.2（用戶可見版本）
- **緩存策略**：三層緩存架構（核心、動態、擴展）
- **支援心情**：6 種完整心情分類支援
- **PWA 標準**：完全符合 PWA 最新標準規範

---

## [v2.4.2] - 2025-06-15

### 🔧 預設值修正

#### 🎯 心情預設值調整

- **預設心情修正**：將快速標記預設心情從 "good" 改為 "bad"
- **模態窗預設**：事件記錄模態窗預設心情改為 "bad"
- **樣式邏輯更新**：fillCell 函數邏輯更新，"bad" 為預設無樣式狀態

### 🔄 數據遷移機制

#### 📊 自動數據轉換

- **good → bad 遷移**：自動將現有的 "good" 數據轉換為 "bad"
- **遷移通知系統**：顯示遷移完成通知，告知用戶更新筆數
- **安全遷移邏輯**：保持數據完整性，僅轉換心情類型
- **向後兼容**：確保舊版本數據正常運作

#### 🔔 用戶體驗優化

- **遷移提示**：清晰的視覺通知顯示遷移狀態
- **數據統計**：顯示實際遷移的記錄數量
- **無縫轉換**：用戶無感知的平滑數據轉換

### 📱 PWA 版本控制

#### 🚀 強制更新機制

- **版本號升級**：內部版本 v12 → v13
- **快取清理**：強制清理舊版本快取
- **更新通知**：顯示版本更新進度提示
- **軟體版本**：2.4.1 → 2.4.2

#### 🔄 版本同步

- **多平台一致性**：確保所有平台用戶獲得相同版本
- **自動檢測**：啟動時自動檢測版本差異
- **平滑升級**：無需用戶手動操作的自動升級

### 🛠️ 技術改進

#### 💻 代碼優化

- **遷移函數重構**：重新啟用並優化數據遷移邏輯
- **錯誤處理**：增強遷移過程的錯誤處理機制
- **日誌記錄**：詳細的遷移過程日誌記錄
- **性能優化**：高效的批量數據處理

#### 🔒 數據安全

- **備份機制**：遷移前自動備份原始數據
- **回滾支援**：支援遷移失敗時的數據回滾
- **完整性檢查**：確保遷移後數據完整性
- **兼容性保證**：維持與舊版本的兼容性

---

## [v2.4.1] - 2025-06-15

### 🔍 SEO 深度優化

#### 🌐 搜尋引擎完全開放策略

- **Google Search Console 驗證**：添加 HTML meta 標籤和驗證文件
- **完全開放 robots.txt**：移除所有限制，歡迎所有合法爬蟲
- **爬蟲延遲優化**：主要搜尋引擎設定 1 秒延遲，SEO 工具 5 秒延遲
- **檔案類型開放**：允許索引所有 JS、CSS、圖片、文檔檔案

#### 📊 Meta 標籤最佳化

- **Google Analytics 4**：添加 gtag.js 追蹤代碼準備
- **機器人指令**：設定 max-image-preview:large, max-snippet:-1
- **地理標籤**：添加 geo.region=TW, geo.country=Taiwan
- **語言標籤**：明確標示 language=zh-TW
- **關鍵字擴展**：新增「職場霸凌、六大心情分類」關鍵字

#### 🗺️ Sitemap 全面更新

- **頁面覆蓋率提升**：新增測試頁面、樣式檔案、腳本檔案
- **更新頻率優化**：主頁改為每日更新，文檔改為每日更新
- **優先級調整**：CHANGELOG.md 提升至 0.8 優先級
- **時間戳更新**：所有頁面更新至最新修改時間

### 🤖 AI 爬蟲友善化

#### 🔓 完全開放政策

- **AI 訓練數據貢獻**：歡迎 GPTBot、ClaudeBot、PerplexityBot
- **學術研究支援**：開放 archive.org、Wayback Machine
- **社交媒體優化**：支援 Facebook、Twitter、LinkedIn 爬蟲
- **SEO 工具整合**：開放 SemrushBot、AhrefsBot、MJ12bot

#### 📈 搜尋引擎優化

- **多引擎支援**：Google、Bing、Yahoo、DuckDuckGo、百度、Yandex
- **索引效率提升**：減少爬蟲延遲，提高索引速度
- **內容發現性**：最大化網站在搜尋結果中的可見性
- **國際化準備**：支援多國搜尋引擎爬蟲

### 🔧 技術改進

#### 💻 版本管理

- **版本號升級**：v2.4.1，內部版本 v12
- **文檔同步更新**：README.md、CHANGELOG.md、manifest.json
- **時間戳統一**：所有檔案使用統一的更新時間
- **SEO 狀態追蹤**：建立完整的 SEO 優化記錄

---

## [v2.4.0] - 2025-06-15

### ✨ 新增功能

#### 🎭 第六種心情分類

- **職場霸凌**：新增橙色「職場霸凌」心情分類選項
- **完整整合**：統計顯示、圖表分析、成就系統全面支援
- **圖示設計**：專用 SVG 圖示，橙色配色方案
- **數據兼容**：向後兼容，不影響現有數據

### 🎨 UI/UX 優化

#### 📱 響應式佈局調整

- **電腦版佈局**：心情選擇改為 3 列顯示 (grid-cols-3)
- **手機版佈局**：保持 2 列顯示 (grid-cols-2)
- **視覺平衡**：6 個選項完美分佈，提升選擇體驗
- **標籤更新**：「離職四大原因」→「離職六大原因」

### 📊 數據系統擴展

#### 🔢 統計功能增強

- **第六項統計**：主頁面新增「職場霸凌」統計顯示
- **圖表支援**：趨勢圖表完整支援 6 種心情數據
- **計算邏輯**：所有統計函數更新支援新心情類型
- **視覺識別**：橙色圖示與數字，清晰區分

### 🏆 成就系統調整

#### 🌈 彩虹收集者更新

- **條件調整**：需要體驗所有 6 種心情才能解鎖
- **挑戰提升**：增加成就難度，提升遊戲性
- **邏輯更新**：checkRainbowDay 函數支援 6 種心情檢測

### 🔧 技術改進

#### 💻 代碼架構優化

- **模組化設計**：心情配置、顏色配置、圖示配置統一管理
- **函數更新**：updateProgress、updateChart、getMoodDisplayName 全面支援
- **性能優化**：高效的數據處理和圖表渲染
- **錯誤處理**：完善的邊界情況處理

### 📱 PWA 更新

#### 🔄 版本管理

- **版本號升級**：v2.4.0，內部版本 v11
- **Manifest 更新**：描述文字更新為「六大心情分類」
- **SEO 優化**：所有 meta 標籤更新支援新功能描述
- **結構化數據**：JSON-LD 更新功能列表

---

## [v2.3.0] - 2025-06-15

### 🔄 數據格式調整

- **恢復爛日子狀態**：將原本遷移的「爛日子」改回「bad」狀態
- **移除遷移邏輯**：停用自動數據遷移，保持原始數據格式
- **向後兼容**：支援舊版本的 bad 狀態數據

### ✨ 新增功能

- **破爛心情統計**：在統計區域新增綠色「破爛心情」圖示顯示
- **第 5 種心情狀態**：完整支援 bad 狀態的統計和圖表顯示
- **心情選擇擴展**：在事件記錄模態窗中新增「破爛心情」選項

### 📊 圖表優化

- **趨勢圖表更新**：圖表支援顯示 5 種心情狀態的趨勢
- **統計完整性**：所有統計功能完整支援 bad 狀態
- **視覺化改進**：使用綠色配色區分破爛心情狀態

### 🎯 成就系統調整

- **彩虹收集者**：更新為需要體驗所有 5 種心情才能解鎖
- **統計準確性**：確保所有成就統計包含 bad 狀態數據

### 🔧 技術改進

- **代碼清理**：移除不必要的數據遷移邏輯
- **性能優化**：簡化數據載入流程
- **錯誤處理**：改善數據格式兼容性

---

## [v2.2.0] - 2025-06-15

### 🔧 重大修復

#### 🏆 成就系統深度修復

- **邏輯修復**：修復所有 10 個成就的解鎖條件判斷邏輯
- **動畫匹配**：修復動畫名稱與實際動畫函數的匹配問題
- **100 格檢測**：修復「自由追求者」成就的完成檢測邏輯
- **稀有度調整**：重新平衡成就稀有度分配，提升挑戰性

#### 🎨 動畫系統完善

- **動畫播放**：確保所有動畫效果（閃爍、金光、火焰、閃電、彩虹、自由爆發）正常顯示
- **CSS 動畫**：完善所有動畫的 CSS 定義，包含白鴿飛翔的 8 種路徑
- **效果優化**：優化動畫播放順序和時間，提升視覺體驗

### 🗑️ 內容清理

#### 移除「爛日子」相關內容

- **成就定義**：全面移除「爛日子」相關描述
- **測試數據**：清理測試文件中的「爛日子」測試案例
- **心情圖示**：統一使用「身心俱疲」SVG 圖示
- **顯示名稱**：更新所有顯示文字為標準化心情名稱

### ✨ 測試框架升級

#### 🧪 專業測試介面

- **視覺設計**：全新的現代化測試介面設計
- **逐個測試**：支援單獨測試每個成就的邏輯和動畫
- **即時統計**：動態顯示測試數據統計
- **日誌系統**：完整的測試日誌記錄與顯示

#### 🎯 測試功能增強

- **動畫預覽**：可單獨預覽每種動畫效果
- **數據生成**：智能生成符合各成就條件的測試數據
- **邏輯驗證**：深度驗證每個成就的解鎖條件
- **清理功能**：一鍵清空測試數據重新開始

### 📝 技術改進

#### 🔄 代碼優化

- **函數重構**：重構動畫播放函數，提升可維護性
- **邏輯簡化**：簡化成就檢測邏輯，減少計算複雜度
- **錯誤處理**：增強錯誤處理機制，提升穩定性

#### 🎨 用戶體驗

- **響應式設計**：測試介面完全響應式，支援各種設備
- **視覺回饋**：增強視覺回饋，讓測試過程更直觀
- **操作便利**：簡化測試操作流程，提升使用效率

---

## [v2.0.0] - 2025-06-14

### 🚀 重大更新：AI Export Modal 專業化改造

#### 💼 企業級 AI 分析介面

- **四統計卡設計**：總記錄數、總厭世指數、平均指數、最高指數
- **動態數據計算**：即時統計顯示，自動更新
- **專業卡片佈局**：響應式網格設計，支援 2x2 手機佈局
- **漸層配色方案**：藍、紅、橙、紫四色漸層設計

#### 🤖 多 AI 平台支援

- **GROK 整合**：新增 Grok AI 支援
- **一鍵導航**：直接跳轉至 ChatGPT、Claude、Gemini、Grok
- **智能提示詞生成**：結構化數據摘要，專業分析建議
- **複製功能增強**：一鍵複製，即時回饋

#### ✨ 視覺體驗升級

- **動畫效果**：滑入動畫、卡片懸浮效果
- **使用說明**：詳細的 5 步驟使用指南
- **字符計數**：即時顯示提示詞長度
- **無障礙優化**：完整的鍵盤導航支援

### 🎨 圖標系統現代化

#### 🔄 Font Awesome 全面整合

- **成就圖標升級**：所有 10 個成就從 emoji 轉為 FA 圖標
- **顏色系統**：專業的色彩搭配，提升視覺質感
- **響應式圖標**：針對手機端優化的圖標大小
- **標題圖標更新**：📋→fas fa-clipboard-list，✨→fas fa-sparkles

#### 🌈 特殊圖標支援

- **Remix Icon 整合**：彩虹圖標支援
- **自由爆發效果**：Font Awesome 白鴿圖標特效
- **動態圖標**：支援旋轉、縮放等動畫效果

### 📊 圖表標籤一致性

#### 📈 心情趨勢圖優化

- **標籤統一**：圖表標籤與按鈕標籤完全一致
- **更新對應**：錢途茫茫、身心俱疲、鳥事一堆、缺乏成長
- **視覺一致性**：顏色、字體、間距標準化

### 🔧 技術債務清理

#### 🧹 代碼品質提升

- **函數重構**：提升可讀性與維護性
- **性能優化**：減少不必要的 DOM 操作
- **錯誤處理**：增強異常情況處理機制

---

## [v1.x.x] - 2025 年初期版本

### 🏗️ 基礎功能建立

- 100 格離職集點系統
- 四大心情分類記錄
- 基礎成就系統
- PWA 功能支援
- Chart.js 圖表整合

### 📱 移動端優化

- 響應式設計
- 觸控操作優化
- 離線功能支援

---

## 🔮 未來規劃 (Roadmap)

### v2.2.0 計劃功能

- [ ] **數據匯出增強**：支援 CSV、JSON 格式匯出
- [ ] **主題系統**：深色模式、自定義配色
- [ ] **多語言支援**：英文、日文國際化
- [ ] **社群功能**：匿名分享、厭世排行榜

### v2.3.0 計劃功能

- [ ] **AI 智能建議**：基於數據的個人化建議
- [ ] **數據視覺化升級**：更多圖表類型
- [ ] **離職計算器**：基於數據的離職時機分析
- [ ] **心理健康資源**：相關文章與工具推薦

---

## 📈 版本統計

| 版本   | 發布日期   | 主要功能 | 代碼行數 | 檔案數 |
| ------ | ---------- | -------- | -------- | ------ |
| v1.0.0 | 2025-01    | 基礎功能 | ~1,500   | 5      |
| v2.0.0 | 2025-06-14 | AI 整合  | ~2,500   | 8      |
| v2.1.0 | 2025-06-15 | 測試框架 | ~2,800   | 10     |

---

## 🤝 貢獻者

- **[@s123104](https://github.com/s123104)** - 專案創建者與主要開發者
- **社群回饋** - 來自使用者的寶貴建議與問題回報

---

## 📄 授權資訊

本專案採用 [MIT License](LICENSE) 授權，歡迎自由使用與貢獻。

---

<div align="center">

**💖 感謝所有使用者的支持與回饋**

_讓我們一起讓職場更美好！_

</div>