diff --git a/note/ENV_SETUP_SECURE.md b/note/ENV_SETUP_SECURE.md
deleted file mode 100644
index ddaadae..0000000
--- a/note/ENV_SETUP_SECURE.md
+++ /dev/null
@@ -1,201 +0,0 @@
-# 🔐 安全的環境變數設定指南
-
-## 🎯 **為什麼使用環境變數？**
-
-✅ **絕對安全** - 不會被 Git 追蹤
-✅ **不會暴露** - Claude Code 看不到
-✅ **團隊友善** - 每個人設定自己的金鑰
-✅ **生產就緒** - 符合企業級部署標準
-
----
-
-## 📋 **Step 1: 取得 Supabase 資訊**
-
-### 1.1 登入 Supabase Dashboard
-```bash
-# 在瀏覽器中開啟:
-https://app.supabase.com
-```
-
-### 1.2 取得連接資訊
-**導航**: Settings → Database
-```
-Host: db.[your-project-id].supabase.co
-Database: postgres
-Username: postgres
-Password: [您的資料庫密碼]
-Port: 5432
-```
-
-**完整連接字串格式**:
-```
-Host=db.[project-id].supabase.co;Database=postgres;Username=postgres;Password=[password];Port=5432;SSL Mode=Require;
-```
-
-### 1.3 取得 API 金鑰
-**導航**: Settings → API
-```
-Project URL: https://[your-project-id].supabase.co
-anon public: eyJ... (前端用)
-service_role secret: eyJ... (後端用)
-JWT Secret: (在 JWT Settings 部分)
-```
-
----
-
-## 🔧 **Step 2: 設定環境變數**
-
-### 2.1 編輯 Shell 配置檔案
-```bash
-# macOS 預設使用 zsh
-nano ~/.zshrc
-
-# 如果使用 bash
-nano ~/.bashrc
-```
-
-### 2.2 在檔案末尾加入 (請替換實際值)
-```bash
-# ================================
-# DramaLing 專案環境變數
-# ================================
-
-# 資料庫連接
-export DRAMALING_DB_CONNECTION="Host=db.[your-project-id].supabase.co;Database=postgres;Username=postgres;Password=[your-db-password];Port=5432;SSL Mode=Require;"
-
-# Supabase 配置
-export DRAMALING_SUPABASE_URL="https://[your-project-id].supabase.co"
-export DRAMALING_SUPABASE_SERVICE_KEY="[your-service-role-key]"
-export DRAMALING_SUPABASE_JWT_SECRET="[your-jwt-secret]"
-
-# AI 服務
-export DRAMALING_GEMINI_API_KEY="[your-gemini-api-key]"
-
-# 前端配置 (如果需要)
-export DRAMALING_SUPABASE_ANON_KEY="[your-anon-key]"
-```
-
-### 2.3 重新載入環境變數
-```bash
-source ~/.zshrc
-# 或
-source ~/.bashrc
-```
-
-### 2.4 驗證設定
-```bash
-# 檢查環境變數是否設定成功 (不會顯示完整值，保護隱私)
-echo "Supabase URL: ${DRAMALING_SUPABASE_URL:0:20}..."
-echo "DB Connection: ${DRAMALING_DB_CONNECTION:0:30}..."
-```
-
----
-
-## 🎨 **Step 3: 配置前端 (安全方式)**
-
-### 3.1 建立前端環境變數檔案
-```bash
-# 建立前端環境變數 (從系統環境變數讀取)
-cat > frontend/.env.local << EOF
-NEXT_PUBLIC_SUPABASE_URL=\$DRAMALING_SUPABASE_URL
-NEXT_PUBLIC_SUPABASE_ANON_KEY=\$DRAMALING_SUPABASE_ANON_KEY
-NEXT_PUBLIC_API_URL=http://localhost:5000
-NEXT_PUBLIC_APP_URL=http://localhost:3001
-EOF
-```
-
-### 3.2 或者使用腳本自動生成
-```bash
-# 自動從環境變數生成前端配置
-echo "NEXT_PUBLIC_SUPABASE_URL=$DRAMALING_SUPABASE_URL" > frontend/.env.local
-echo "NEXT_PUBLIC_SUPABASE_ANON_KEY=$DRAMALING_SUPABASE_ANON_KEY" >> frontend/.env.local
-echo "NEXT_PUBLIC_API_URL=http://localhost:5000" >> frontend/.env.local
-echo "NEXT_PUBLIC_APP_URL=http://localhost:3001" >> frontend/.env.local
-```
-
----
-
-## 🚀 **Step 4: 測試配置**
-
-### 4.1 重新啟動後端
-```bash
-# 重新啟動 .NET API (會讀取新的環境變數)
-./start-dotnet-api.sh
-```
-
-### 4.2 檢查啟動日誌
-```bash
-# 應該看到:
-# ✅ 建置成功！
-# 🌐 啟動 API 服務...
-# info: Microsoft.Hosting.Lifetime[0] Application started
-
-# 如果看到資料庫連接錯誤，表示環境變數有問題
-```
-
-### 4.3 測試 API 端點
-```bash
-# 測試健康檢查
-curl http://localhost:5000/health
-
-# 測試 API 認證 (應該返回 401，表示需要認證)
-curl http://localhost:5000/api/auth/profile
-```
-
----
-
-## 🚨 **常見問題解決**
-
-### ❌ **環境變數沒有生效**
-```bash
-# 檢查是否正確載入
-echo $DRAMALING_SUPABASE_URL
-
-# 如果是空的，重新執行:
-source ~/.zshrc
-```
-
-### ❌ **資料庫連接失敗**
-```bash
-# 檢查連接字串格式
-echo $DRAMALING_DB_CONNECTION
-
-# 確認 IP 白名單設定 (Supabase Dashboard → Settings → Database → Network)
-```
-
-### ❌ **JWT 驗證失敗**
-```bash
-# 檢查 JWT Secret 是否正確
-echo "JWT Secret length: ${#DRAMALING_SUPABASE_JWT_SECRET}"
-# 應該是很長的字串 (>100 字元)
-```
-
----
-
-## 🎯 **完成後的效果**
-
-### ✅ **安全性**
-- 沒有任何機密資訊在專案檔案中
-- Git 只會追蹤安全的配置檔案
-- Claude Code 無法看到敏感資訊
-
-### ✅ **功能性**
-- 後端可以連接真實的 Supabase 資料庫
-- 前端可以使用 Supabase 認證
-- API 可以驗證用戶身份
-
-### ✅ **開發體驗**
-- 一次設定，長期使用
-- 團隊成員各自配置
-- 符合業界最佳實踐
-
----
-
-## 📞 **需要協助**
-
-**您現在需要**:
-1. 取得 Supabase 專案的實際資訊
-2. 按照 Step 2 設定環境變數
-3. 告訴我設定完成，我會協助測試
-
-**您準備好開始設定環境變數了嗎？** 🚀
\ No newline at end of file
diff --git a/note/SUPABASE_SETUP_GUIDE.md b/note/SUPABASE_SETUP_GUIDE.md
deleted file mode 100644
index 31d162c..0000000
--- a/note/SUPABASE_SETUP_GUIDE.md
+++ /dev/null
@@ -1,262 +0,0 @@
-# 🗄️ Supabase 環境變數配置指南
-
-## 📋 **配置檢查清單**
-
-### 準備工作
-- [ ] 已有 Supabase 帳號和專案
-- [ ] 已記住資料庫密碼
-- [ ] 瀏覽器已開啟 Supabase Dashboard
-
----
-
-## 🔑 **Step 1: 從 Supabase 獲取所需資訊**
-
-### 1.1 登入 Supabase Dashboard
-```bash
-# 開啟瀏覽器前往:
-https://app.supabase.com
-```
-
-### 1.2 選擇或建立專案
-- 如果沒有專案，點擊 **"New Project"**
-- 專案名稱建議: `dramaling-dev`
-- 區域選擇: **Singapore (Southeast Asia)**
-
-### 1.3 獲取 API 設定資訊
-**導航**: 左側選單 → **Settings** → **API**
-
-**需要複製的資訊**:
-```
-1. Project URL: https://[your-project-id].supabase.co
-2. anon public: eyJ[...很長的字串...]
-3. service_role secret: eyJ[...很長的字串...]
-```
-
-### 1.4 獲取 JWT Secret
-**位置**: 同頁面下方 **JWT Settings**
-```
-JWT Secret: [your-super-secret-jwt-token-with-at-least-32-characters-long]
-```
-
-### 1.5 獲取資料庫連接資訊
-**導航**: 左側選單 → **Settings** → **Database**
-
-**連接參數**:
-```
-Host: db.[your-project-id].supabase.co
-Database: postgres
-Port: 5432
-User: postgres
-Password: [您建立專案時設定的密碼]
-```
-
----
-
-## 🔧 **Step 2: 配置後端 (.NET Core)**
-
-### 2.1 編輯後端配置檔案
-**檔案**: `backend/DramaLing.Api/appsettings.Development.json`
-
-**請將以下範本中的 `[替換這裡]` 替換為實際值**:
-
-```json
-{
-  "ConnectionStrings": {
-    "DefaultConnection": "Host=db.[your-project-id].supabase.co;Database=postgres;Username=postgres;Password=[your-db-password];Port=5432;SSL Mode=Require;"
-  },
-  "Supabase": {
-    "Url": "https://[your-project-id].supabase.co",
-    "ServiceRoleKey": "[your-service-role-key]",
-    "JwtSecret": "[your-jwt-secret]"
-  },
-  "AI": {
-    "GeminiApiKey": "[your-gemini-api-key]"
-  },
-  "Frontend": {
-    "Urls": ["http://localhost:3000", "http://localhost:3001"]
-  },
-  "Logging": {
-    "LogLevel": {
-      "Default": "Information",
-      "Microsoft.AspNetCore": "Information",
-      "Microsoft.EntityFrameworkCore": "Information",
-      "DramaLing.Api": "Debug"
-    }
-  }
-}
-```
-
-### 2.2 配置範例 (請替換實際值)
-```json
-{
-  "ConnectionStrings": {
-    "DefaultConnection": "Host=db.abcdefghij.supabase.co;Database=postgres;Username=postgres;Password=MySecretPassword123;Port=5432;SSL Mode=Require;"
-  },
-  "Supabase": {
-    "Url": "https://abcdefghij.supabase.co",
-    "ServiceRoleKey": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
-    "JwtSecret": "your-super-secret-jwt-token-with-at-least-32-characters-long"
-  }
-}
-```
-
----
-
-## 🎨 **Step 3: 配置前端 (Next.js)**
-
-### 3.1 建立前端環境變數檔案
-**檔案**: `frontend/.env.local` (新建立)
-
-```bash
-# 執行以下指令建立檔案:
-cp .env.example frontend/.env.local
-```
-
-### 3.2 編輯前端環境變數
-**檔案**: `frontend/.env.local`
-
-**請將以下範本中的 `[替換這裡]` 替換為實際值**:
-
-```env
-# Supabase 前端配置 (認證用)
-NEXT_PUBLIC_SUPABASE_URL=https://[your-project-id].supabase.co
-NEXT_PUBLIC_SUPABASE_ANON_KEY=[your-anon-public-key]
-
-# API 服務配置
-NEXT_PUBLIC_API_URL=http://localhost:5000
-NEXT_PUBLIC_APP_URL=http://localhost:3001
-```
-
-### 3.3 前端配置範例 (請替換實際值)
-```env
-NEXT_PUBLIC_SUPABASE_URL=https://abcdefghij.supabase.co
-NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
-NEXT_PUBLIC_API_URL=http://localhost:5000
-NEXT_PUBLIC_APP_URL=http://localhost:3001
-```
-
----
-
-## 🧪 **Step 4: 測試配置**
-
-### 4.1 測試後端資料庫連接
-```bash
-# 重新啟動後端 API
-./start-dotnet-api.sh
-
-# 檢查啟動日誌中是否有資料庫連接錯誤
-# 如果成功，應該會看到 "Application started" 訊息
-```
-
-### 4.2 測試 API 端點
-```bash
-# 測試健康檢查
-curl http://localhost:5000/health
-
-# 預期回應:
-# {"Status":"Healthy","Timestamp":"2025-09-16T..."}
-```
-
-### 4.3 測試 Swagger API 文檔
-```bash
-# 瀏覽器訪問:
-http://localhost:5000/swagger
-
-# 應該看到 4 個控制器:
-# - Auth (用戶認證)
-# - CardSets (卡組管理)
-# - Flashcards (詞卡管理)
-# - Stats (統計分析)
-```
-
-### 4.4 測試前端 Supabase 連接
-```bash
-# 重新啟動前端
-./start-frontend.sh
-
-# 瀏覽器訪問前端並檢查 Console:
-http://localhost:3001
-
-# 在瀏覽器 Console 中不應該看到 Supabase 連接錯誤
-```
-
----
-
-## 🚨 **常見問題和解決方案**
-
-### ❌ **資料庫連接失敗**
-**錯誤**: `Npgsql.NpgsqlException: Connection refused`
-
-**解決方案**:
-1. 檢查 IP 白名單: Settings → Database → **Network Restrictions**
-2. 確認密碼正確
-3. 確認 Host 地址正確
-
-### ❌ **JWT 驗證失敗**
-**錯誤**: `401 Unauthorized`
-
-**解決方案**:
-1. 確認 JWT Secret 正確複製 (完整字串)
-2. 檢查 Issuer URL 是否正確
-3. 確認前端傳送的令牌格式
-
-### ❌ **CORS 錯誤**
-**錯誤**: `Access-Control-Allow-Origin`
-
-**解決方案**:
-1. 檢查 Program.cs 中的 CORS 設定
-2. 確認前端 URL 在允許清單中
-
----
-
-## 📝 **實際動手步驟**
-
-### 👉 **您現在需要做的**:
-
-**第一步**: 開啟 Supabase Dashboard
-```bash
-# 1. 在瀏覽器中開啟:
-https://app.supabase.com
-
-# 2. 登入並選擇專案
-# 3. 前往 Settings → API 頁面
-```
-
-**第二步**: 複製 API 資訊
-```bash
-# 將以下資訊準備好 (可以先貼到記事本):
-Project URL: https://
-Anon Key: eyJ
-Service Role Key: eyJ
-JWT Secret: your-super-secret
-Database Password:
-```
-
-**第三步**: 通知我配置資訊
-```bash
-# 告訴我您已經取得了資訊，我會幫您配置檔案
-# (當然不要貼出真實的密鑰，只要說 "我已經取得了" 即可)
-```
-
-**第四步**: 我會幫您配置檔案並測試
-
----
-
-## 🎯 **配置完成後的效果**
-
-### ✅ **後端功能**
-- Entity Framework 可以連接到 Supabase PostgreSQL
-- JWT 認證可以驗證前端的 Supabase 令牌
-- API 可以正確識別登入用戶
-
-### ✅ **前端功能**
-- 可以使用 Supabase Auth 登入
-- 可以呼叫 .NET Core API 並附加認證令牌
-- Dashboard 可以顯示真實的用戶資料
-
-### ✅ **整體效果**
-- 前後端完全整合
-- 用戶可以登入並看到個人化內容
-- 所有 API 都有適當的認證保護
-
-**準備好開始了嗎？請先取得 Supabase 的連接資訊！** 🚀
\ No newline at end of file
diff --git a/note/cache-analysis-report.md b/note/cache-analysis-report.md
deleted file mode 100644
index f475705..0000000
--- a/note/cache-analysis-report.md
+++ /dev/null
@@ -1,268 +0,0 @@
-# 快取機制檢查報告
-
-**項目**: DramaLing 英語學習平台
-**檢查日期**: 2025-01-18
-**檢查範圍**: 句子分析快取系統
-**檢查者**: Claude Code
-
-## 📋 執行摘要
-
-**快取機制狀態: ✅ 完全正常運作**
-
-用戶反映的「新句子分析慢，舊句子分析快」現象完全符合預期設計。快取機制正確實現了以下功能：
-- 新句子: 調用 Gemini AI 進行完整分析（需時間）
-- 舊句子: 從 24 小時快取中立即返回結果（快速）
-
-## 🔍 檢查方法論
-
-### 1. 程式碼分析法
-- 檢查後端 API 控制器邏輯
-- 驗證快取服務實現
-- 分析前端 API 調用方式
-
-### 2. 資料庫結構驗證
-- 檢查快取表結構和索引
-- 驗證資料遷移檔案
-- 確認資料庫關聯設定
-
-### 3. 實際運行日誌分析
-- 監控後端真實執行日誌
-- 分析快取命中/未命中模式
-- 驗證效能表現
-
-## 🔧 技術架構檢查結果
-
-### ✅ 1. 後端快取邏輯 (完全正常)
-
-**檔案位置**: `backend/DramaLing.Api/Controllers/AIController.cs:534-549`
-
-```csharp
-// 1. 檢查快取
-var cachedAnalysis = await _cacheService.GetCachedAnalysisAsync(request.InputText);
-if (cachedAnalysis != null && !request.ForceRefresh)
-{
-    _logger.LogInformation("Using cached analysis for text hash: {TextHash}", cachedAnalysis.InputTextHash);
-
-    var cachedResult = System.Text.Json.JsonSerializer.Deserialize<object>(cachedAnalysis.AnalysisResult);
-
-    return Ok(new
-    {
-        Success = true,
-        Data = cachedResult,
-        Message = "句子分析完成（快取）",
-        Cached = true,
-        CacheHit = true
-    });
-}
-```
-
-**檢查結果**:
-- ✅ 快取檢查邏輯完整
-- ✅ 支援強制刷新機制
-- ✅ 適當的日誌記錄
-- ✅ 正確的回應格式
-
-### ✅ 2. 快取服務實現 (完全正常)
-
-**檔案位置**: `backend/DramaLing.Api/Services/AnalysisCacheService.cs:33-54`
-
-```csharp
-public async Task<SentenceAnalysisCache?> GetCachedAnalysisAsync(string inputText)
-{
-    var textHash = GenerateTextHash(inputText);
-    var cached = await _context.SentenceAnalysisCache
-        .FirstOrDefaultAsync(c => c.InputTextHash == textHash && c.ExpiresAt > DateTime.UtcNow);
-
-    if (cached != null)
-    {
-        cached.AccessCount++;
-        cached.LastAccessedAt = DateTime.UtcNow;
-        await _context.SaveChangesAsync();
-
-        _logger.LogInformation("Cache hit for text hash: {TextHash}", textHash);
-        return cached;
-    }
-
-    _logger.LogInformation("Cache miss for text hash: {TextHash}", textHash);
-    return null;
-}
-```
-
-**檢查結果**:
-- ✅ 使用 SHA-256 文字雜湊
-- ✅ 正確檢查過期時間
-- ✅ 自動更新存取統計
-- ✅ 完整的錯誤處理
-
-### ✅ 3. 快取寫入機制 (完全正常)
-
-**檔案位置**: `backend/DramaLing.Api/Controllers/AIController.cs:581-594`
-
-```csharp
-// 4. 存入快取（24小時TTL）
-await _cacheService.SetCachedAnalysisAsync(
-    request.InputText,
-    baseResponseData,
-    TimeSpan.FromHours(24)
-);
-_logger.LogInformation("AI analysis result cached for 24 hours");
-```
-
-**檢查結果**:
-- ✅ 24 小時 TTL 設定正確
-- ✅ 完整的錯誤處理機制
-- ✅ 適當的日誌記錄
-
-### ✅ 4. 資料庫結構 (完全正常)
-
-**檢查項目**:
-- `SentenceAnalysisCache` 表已創建
-- 適當的索引設定 (hash, expires, hash+expires)
-- 正確的資料遷移檔案
-- DbContext 配置正確
-
-## 📊 實際運行表現分析
-
-### 真實日誌摘要 (2025-01-18)
-
-#### Cache Miss (新句子分析)
-```
-Cache miss for text hash: f9066d39daaa08943f7c17a2f8956cb998762f5e8b67a4d79201aa58ba2df376
-INSERT INTO "SentenceAnalysisCache" ...
-Cached analysis for text hash: ..., expires at: 09/18/2025 17:21:12
-AI analysis result cached for 24 hours
-```
-
-#### Cache Hit (舊句子分析)
-```
-Cache hit for text hash: f9066d39daaa08943f7c17a2f8956cb998762f5e8b67a4d79201aa58ba2df376
-Using cached analysis for text hash: ...
-UPDATE "SentenceAnalysisCache" SET "AccessCount" = @p0, "LastAccessedAt" = @p1
-```
-
-### 效能統計
-
-| 場景 | 響應時間 | 快取狀態 | AI 調用 |
-|------|----------|----------|---------|
-| 新句子 | 3-5 秒 | Miss | 是 |
-| 舊句子 | <200ms | Hit | 否 |
-| 重複查詢 | <200ms | Hit | 否 |
-
-### 快取命中率分析
-
-從日誌觀察到的快取活動：
-- **至少 3 個不同文字的快取記錄**
-- **多次成功的快取命中**
-- **正確的存取計數更新**
-- **過期時間自動延長機制**
-
-## ⚡ 效能表現評估
-
-### 優點
-- ✅ **大幅減少 AI API 調用**: 相同句子重複查詢時直接使用快取
-- ✅ **顯著提升響應速度**: 快取命中時間 <200ms vs AI 分析 3-5 秒
-- ✅ **節省成本**: 避免重複的 Gemini API 費用
-- ✅ **提升用戶體驗**: 重複查詢即時回應
-
-### 系統穩定性
-- ✅ **錯誤處理完善**: 快取失敗時自動退回 AI 分析
-- ✅ **過期機制正確**: 24 小時後自動清理舊快取
-- ✅ **統計資料完整**: 存取次數和時間準確記錄
-
-## 🎯 用戶體驗分析
-
-### 當前行為 (正常)
-1. **第一次分析新句子**: 3-5 秒 (調用 Gemini AI)
-2. **重複分析相同句子**: <200ms (快取命中)
-3. **24 小時後重新分析**: 3-5 秒 (快取過期，重新分析)
-
-### 用戶感知
-- ✅ 新句子分析慢 → **正常** (需要 AI 處理)
-- ✅ 舊句子分析快 → **正常** (快取命中)
-- ⚠️ 用戶可能不理解為什麼有時快有時慢
-
-## 💡 改善建議
-
-### 1. 用戶體驗透明化
-```typescript
-// 建議在前端顯示快取狀態
-if (result.cached) {
-    showMessage("💾 使用快取結果 (瞬間完成)")
-} else {
-    showMessage("🤖 AI 分析中... (約需 3-5 秒)")
-}
-```
-
-### 2. 載入狀態優化
-- 新句子: 顯示真實 AI 分析進度
-- 快取結果: 顯示「載入快取...」而非空白
-
-### 3. 快取統計展示
-- 在設定頁面顯示快取命中率
-- 展示節省的 AI 調用次數和費用
-
-### 4. 前端改善項目
-```typescript
-// 當前前端 API 調用 (可改善)
-body: JSON.stringify({
-    inputText: textInput,
-    analysisMode: 'full'
-    // 建議添加: forceRefresh: false
-})
-```
-
-## 🔍 潛在問題檢查
-
-### ❌ 發現的小問題
-
-1. **前端未檢查快取狀態**
-   - 當前前端沒有讀取 `result.cached` 狀態
-   - 用戶無法得知結果來源
-
-2. **缺少強制刷新選項**
-   - 前端未提供 `forceRefresh` 參數
-   - 用戶無法手動刷新快取
-
-### ✅ 非問題項目
-
-1. **快取機制本身**: 完全正常
-2. **資料庫操作**: 效能良好
-3. **錯誤處理**: 充分覆蓋
-4. **日誌記錄**: 詳細完整
-
-## 📈 效能指標
-
-### 快取效能
-- **命中率**: 高 (從日誌觀察)
-- **響應時間**: <200ms (快取命中)
-- **記憶體使用**: 合理 (資料庫儲存)
-- **磁碟空間**: 少量 (JSON 格式壓縮)
-
-### AI API 節省
-- **成本節省**: 顯著 (避免重複 API 調用)
-- **頻寬節省**: 大幅 (減少外部 API 請求)
-- **延遲減少**: 95%+ (本地快取 vs 遠端 API)
-
-## 🏁 結論
-
-### 主要發現
-1. **快取機制運作完美** ✅
-2. **效能表現優異** ✅
-3. **成本節省顯著** ✅
-4. **用戶體驗可進一步優化** ⚠️
-
-### 最終結論
-**快取系統沒有任何技術問題**。用戶觀察到的「新句子慢，舊句子快」行為完全符合系統設計預期，且正確發揮了快取應有的效能優化作用。
-
-建議的改善方向主要集中在用戶體驗透明化，讓用戶更好理解系統行為，而非修復技術問題。
-
-### 建議優先級
-1. **高優先級**: 前端顯示快取狀態提示
-2. **中優先級**: 添加強制刷新功能
-3. **低優先級**: 快取統計頁面展示
-
----
-
-**報告生成時間**: 2025-01-18
-**檢查工具**: Claude Code
-**快取系統狀態**: ✅ 健康運行
\ No newline at end of file
diff --git a/note/frontend-cache-analysis-report.md b/note/frontend-cache-analysis-report.md
deleted file mode 100644
index 7804d05..0000000
--- a/note/frontend-cache-analysis-report.md
+++ /dev/null
@@ -1,275 +0,0 @@
-# 前端快取存取與顯示檢查報告
-
-**項目**: DramaLing 英語學習平台 - 前端快取整合
-**檢查日期**: 2025-01-18
-**檢查範圍**: 前端如何存取和顯示後端快取狀態
-**檢查者**: Claude Code
-
-## 📋 執行摘要
-
-**前端快取整合狀態: ⚠️ 部分問題，已修復**
-
-### 🎯 主要發現
-- **❌ 原問題**: 主要的 generate 頁面完全沒有顯示快取狀態
-- **✅ 已修復**: 實現了完整的快取狀態追蹤和顯示
-- **✅ 後端API**: 正確提供快取相關資訊
-- **✅ 現有實現**: test-api 頁面已有快取狀態顯示範例
-
-## 🔍 檢查方法記錄
-
-### 1. 後端API回應結構檢查
-檢查 `AIController.cs` 中 API 回應格式，確認快取相關欄位
-
-### 2. 前端API調用分析
-分析 `generate/page.tsx` 中如何處理 API 回應
-
-### 3. UI顯示狀態檢查
-搜尋前端程式碼中是否有快取狀態顯示
-
-### 4. 參考實現分析
-分析 `test-api/page.tsx` 的成功實現案例
-
-## 📊 詳細檢查結果
-
-### ✅ 1. 後端API回應結構 (正常)
-
-**快取命中時的回應**:
-```csharp
-// AIController.cs:542-549
-return Ok(new
-{
-    Success = true,
-    Data = cachedResult,
-    Message = "句子分析完成（快取）",
-    Cached = true,
-    CacheHit = true
-});
-```
-
-**AI分析時的回應**:
-```csharp
-// AIController.cs:596-604
-return Ok(new
-{
-    Success = true,
-    Data = baseResponseData,
-    Message = "AI句子分析完成",
-    Cached = false,
-    CacheHit = false,
-    UsingAI = true
-});
-```
-
-**檢查結果**: ✅ 後端正確提供所有快取狀態資訊
-
-### ❌ 2. 原前端處理問題 (已修復)
-
-**原始問題**:
-```typescript
-// 原 generate/page.tsx:68-81 (問題版本)
-if (result.success) {
-  // 完全沒有處理快取狀態
-  setSentenceAnalysis(result.data.wordAnalysis || {})
-  // ... 其他處理
-}
-```
-
-**修復後**:
-```typescript
-// 新 generate/page.tsx:74-81 (修復版本)
-if (result.success) {
-  // 設定快取狀態
-  setCacheStatus({
-    isCached: result.cached || false,
-    cacheHit: result.cacheHit || false,
-    usingAI: result.usingAI || false,
-    message: result.message || '分析完成'
-  })
-  // ... 其他處理
-}
-```
-
-### ❌ 3. 原UI顯示問題 (已修復)
-
-**原始狀況**: `generate/page.tsx` 完全沒有快取狀態顯示
-
-**參考實現**: `test-api/page.tsx` 已有成功案例:
-```typescript
-{result.cached && <span className="text-blue-600 text-sm">(使用快取)</span>}
-{result.cacheHit && <span className="text-purple-600 text-sm">(快取命中)</span>}
-```
-
-**新增的UI元件**:
-```typescript
-// 新增快取狀態顯示
-{cacheStatus && (
-  <div className={`inline-flex items-center px-3 py-1 rounded-full text-sm font-medium ${
-    cacheStatus.isCached
-      ? 'bg-green-100 text-green-800'
-      : 'bg-blue-100 text-blue-800'
-  }`}>
-    {cacheStatus.isCached ? (
-      <>
-        <span className="mr-1">💾</span>
-        <span>快取結果</span>
-      </>
-    ) : (
-      <>
-        <span className="mr-1">🤖</span>
-        <span>AI 分析</span>
-      </>
-    )}
-  </div>
-)}
-```
-
-### ❌ 4. 原案例敏感性問題 (已修復)
-
-**原始問題**:
-```typescript
-// 原 generate/page.tsx:74-75 (大小寫問題)
-const translation = sentenceMeaning.translation || '翻譯處理中...'
-const explanation = sentenceMeaning.explanation || '解釋處理中...'
-```
-
-**修復**: 處理大小寫不一致問題
-```typescript
-// 新 generate/page.tsx:88-89 (支援兩種格式)
-const translation = sentenceMeaning.Translation || sentenceMeaning.translation || '翻譯處理中...'
-const explanation = sentenceMeaning.Explanation || sentenceMeaning.explanation || '解釋處理中...'
-```
-
-## 🔧 實現的改善功能
-
-### 1. 快取狀態追蹤
-- ✅ 新增 `cacheStatus` 狀態管理
-- ✅ 完整記錄快取相關資訊
-- ✅ 支援後端不同回應格式
-
-### 2. 視覺化快取狀態
-- ✅ **快取結果**: 綠色背景 + 💾 圖標
-- ✅ **AI分析**: 藍色背景 + 🤖 圖標
-- ✅ 清晰的視覺區分
-
-### 3. 用戶體驗改善
-- ✅ 載入狀態說明: "AI 分析約需 3-5 秒"
-- ✅ 即時顯示結果來源
-- ✅ 透明化系統行為
-
-### 4. 相容性改善
-- ✅ 支援新舊API回應格式
-- ✅ 向後相容性保證
-- ✅ 錯誤處理機制
-
-## 🎨 UI/UX 設計說明
-
-### 快取狀態標籤設計
-```css
-/* 快取結果 */
-.cache-hit {
-  background: bg-green-100 text-green-800
-  icon: 💾
-  label: "快取結果"
-}
-
-/* AI分析 */
-.ai-analysis {
-  background: bg-blue-100 text-blue-800
-  icon: 🤖
-  label: "AI 分析"
-}
-```
-
-### 視覺層次
-1. **主標題**: "句子分析"
-2. **狀態標籤**: 右側顯示快取/AI狀態
-3. **內容區域**: 分析結果展示
-
-## 📈 效能影響評估
-
-### 前端效能
-- **狀態管理**: 輕量級，無顯著影響
-- **渲染效能**: 增加的UI元素minimal impact
-- **記憶體使用**: 增加約 1KB 狀態資料
-
-### 用戶體驗改善
-- **透明度**: +95% (用戶了解結果來源)
-- **等待感知**: +80% (清楚知道等待時間)
-- **系統信任度**: +70% (了解系統運作方式)
-
-## 🚀 預期效果
-
-### 用戶行為改善
-1. **減少困惑**: 用戶不再疑惑為什麼有時快有時慢
-2. **提升信任**: 透明的系統狀態提升用戶信任
-3. **更好預期**: 明確的時間預期減少焦慮
-
-### 技術債務減少
-1. **一致性**: 統一了快取狀態處理方式
-2. **可維護性**: 集中管理快取狀態邏輯
-3. **可擴展性**: 為未來功能預留介面
-
-## 🔍 測試建議
-
-### 功能測試
-1. **快取命中**: 重複相同句子，確認顯示 "💾 快取結果"
-2. **AI分析**: 新句子分析，確認顯示 "🤖 AI 分析"
-3. **狀態切換**: 交替測試新舊句子
-
-### 用戶體驗測試
-1. **載入狀態**: 確認顯示分析時間預期
-2. **視覺識別**: 快取和AI狀態清晰區分
-3. **響應時間**: 快取結果應 <200ms，AI分析約 3-5秒
-
-## 🎯 問題解決摘要
-
-| 問題類型 | 原始狀態 | 修復後狀態 | 影響 |
-|---------|----------|------------|------|
-| **快取狀態追蹤** | ❌ 未實現 | ✅ 完整實現 | 高 |
-| **UI狀態顯示** | ❌ 無顯示 | ✅ 視覺化顯示 | 高 |
-| **用戶透明度** | ❌ 用戶困惑 | ✅ 清楚理解 | 高 |
-| **資料格式相容** | ❌ 案例敏感 | ✅ 向後相容 | 中 |
-| **載入體驗** | ⚠️ 基礎實現 | ✅ 詳細說明 | 中 |
-
-## 💡 未來改善建議
-
-### 短期改善 (1-2週)
-1. **快取統計頁面**: 顯示快取命中率和節省的API調用次數
-2. **強制重新分析**: 添加 "強制重新分析" 按鈕
-3. **快取時間顯示**: 顯示快取建立時間
-
-### 中期改善 (1個月)
-1. **快取管理**: 用戶可手動清除特定句子的快取
-2. **分析歷史**: 保存用戶分析歷史記錄
-3. **性能指標**: 顯示實際響應時間統計
-
-### 長期改善 (3個月)
-1. **預測性快取**: 根據用戶行為預載入可能查詢的句子
-2. **快取優化**: 智慧快取策略，優先保留高價值快取
-3. **離線支援**: 本地快取支援離線分析功能
-
-## 🏁 結論
-
-### 主要成就
-1. ✅ **完全修復**了前端快取狀態顯示問題
-2. ✅ **大幅提升**了用戶體驗透明度
-3. ✅ **解決了**案例敏感性導致的資料解析問題
-4. ✅ **統一了**快取狀態處理方式
-
-### 最終狀態
-**前端快取整合: ✅ 完全正常運作**
-
-用戶現在可以清楚看到：
-- 🤖 **新句子**: "AI 分析" 標籤 + 載入時間說明
-- 💾 **舊句子**: "快取結果" 標籤 + 瞬間返回
-
-### 價值評估
-- **技術價值**: 修復了關鍵用戶體驗問題
-- **商業價值**: 提升用戶理解和滿意度
-- **維護價值**: 建立了可擴展的狀態管理架構
-
----
-
-**報告生成時間**: 2025-01-18
-**修復狀態**: ✅ 完成
-**前端快取整合**: ✅ 健康運行
\ No newline at end of file
diff --git a/note/interactive-word-query-system-spec.md b/note/interactive-word-query-system-spec.md
deleted file mode 100644
index 8832012..0000000
--- a/note/interactive-word-query-system-spec.md
+++ /dev/null
@@ -1,795 +0,0 @@
-# AI 互動式單字查詢系統 - 完整功能規格
-
-**項目**: DramaLing 英語學習平台
-**功能模組**: 智能句子分析與互動式單字查詢
-**版本**: v1.0
-**文檔日期**: 2025-01-18
-
-## 🎯 功能概述
-
-AI 互動式單字查詢系統是一個智能英語學習工具，允許用戶輸入英文句子，獲得 AI 驅動的完整分析，並通過點擊單字的方式進行深度學習。系統具備語法修正、高價值詞彙標記、成本優化和快取機制。
-
-## 📋 核心功能特性
-
-### 🔍 主要功能
-1. **智能句子分析**: Gemini AI 驅動的句子翻譯和解釋
-2. **語法自動修正**: 檢測並建議語法錯誤修正
-3. **互動式單字查詢**: 點擊任何單字即時查看詳細信息
-4. **高價值詞彙標記**: AI 識別重要學習詞彙（免費查詢）
-5. **成本優化設計**: 低價值詞彙收費查詢，防止濫用
-6. **24小時快取機制**: 避免重複 AI 調用，提升響應速度
-7. **使用額度管理**: 免費用戶 3 小時內限制 5 次分析
-
-### 🎨 用戶體驗特色
-- **即時回饋**: 新句子 3-5 秒，快取結果 <200ms
-- **視覺化快取狀態**: 清楚顯示結果來源（AI/快取）
-- **智能語法提示**: 主動發現和修正語法錯誤
-- **分層收費模式**: 高價值詞彙免費，低價值詞彙收費
-
-## 🔄 用戶流程圖 (User Flow)
-
-```
-[1. 用戶登入]
-    ↓
-[2. 進入分析頁面 (/generate)]
-    ↓
-[3. 選擇輸入模式]
-    ├── ✍️ 手動輸入 (最多300字)
-    └── 📷 影劇截圖 (Phase 2, 付費功能)
-    ↓
-[4. 輸入英文文字]
-    ├── 即時字數統計
-    ├── 顏色警告 (280字+黃色, 300字+紅色)
-    └── 輸入驗證
-    ↓
-[5. 點擊「🔍 分析句子」]
-    ├── 檢查使用額度 (免費用戶 5次/3小時)
-    ├── 顯示載入狀態 "正在分析句子... (AI 分析約需 3-5 秒)"
-    └── 調用後端 API
-    ↓
-[6. 後端處理邏輯]
-    ├── 檢查快取 (24小時TTL)
-    │   ├── Cache Hit → 立即返回 (💾 快取結果)
-    │   └── Cache Miss → 調用 Gemini AI (🤖 AI 分析)
-    ├── 語法檢查和修正
-    ├── 高價值詞彙標記
-    └── 存入快取
-    ↓
-[7. 分析結果顯示]
-    ├── 快取狀態標籤 (💾 快取結果 / 🤖 AI 分析)
-    ├── 語法修正面板 (如有錯誤)
-    │   ├── 顯示原始 vs 修正版本
-    │   ├── [✅ 採用修正] [❌ 保持原版]
-    │   └── 說明修正原因
-    ├── 句子翻譯和解釋
-    └── 互動式文字區域
-    ↓
-[8. 互動式單字查詢]
-    ├── 點擊單字觸發分析
-    ├── 高價值詞彙 (🟢⭐ / 🟡⭐) → 免費彈窗
-    ├── 低價值詞彙 (🔵) → 收費確認對話框
-    │   ├── 顯示剩餘額度
-    │   ├── [✅ 確認查詢] [❌ 取消]
-    │   └── 扣除使用額度
-    └── 顯示詳細詞彙信息彈窗
-    ↓
-[9. 詞卡生成 (可選)]
-    ├── 點擊「📖 生成詞卡」
-    ├── AI 自動提取重要詞彙
-    ├── 預覽生成的詞卡
-    └── 保存到個人詞庫
-    ↓
-[10. 導航選項]
-    ├── 🔄 分析新句子 → 返回步驟 2
-    ├── ← 返回分析 → 返回步驟 7
-    └── ← 返回輸入 → 返回步驟 4
-```
-
-## 📐 詳細功能規格
-
-### 🔧 技術規格
-
-#### 前端技術棧
-- **框架**: Next.js 15.5.3 + TypeScript
-- **UI 組件**: React Hooks + Tailwind CSS
-- **狀態管理**: useState (本地狀態)
-- **API 調用**: Fetch API
-- **路由**: Next.js App Router
-
-#### 後端技術棧
-- **框架**: ASP.NET Core 8.0
-- **AI 整合**: Google Gemini API
-- **資料庫**: SQLite + Entity Framework Core
-- **快取**: 資料庫快取 (24小時TTL)
-- **認證**: JWT Token
-
-### 📊 資料模型
-
-#### 1. API 請求/回應格式
-
-**句子分析請求**:
-```typescript
-interface AnalyzeSentenceRequest {
-  inputText: string        // 用戶輸入的英文句子 (≤300字)
-  forceRefresh?: boolean   // 強制刷新快取 (預設: false)
-  analysisMode?: string    // 分析模式 (預設: 'full')
-}
-```
-
-**句子分析回應**:
-```typescript
-interface AnalyzeSentenceResponse {
-  success: boolean
-  message: string
-  cached: boolean          // 是否來自快取
-  cacheHit: boolean        // 快取命中狀態
-  usingAI: boolean         // 是否使用 AI 分析
-  data: {
-    analysisId: string
-    inputText: string
-    grammarCorrection: GrammarCorrectionResult
-    sentenceMeaning: {
-      Translation: string    // 注意: 首字母大寫
-      Explanation: string    // 注意: 首字母大寫
-    }
-    finalAnalysisText: string
-    wordAnalysis: Record<string, WordAnalysis>
-    highValueWords: string[]
-    phrasesDetected: PhraseInfo[]
-  }
-}
-```
-
-#### 2. 單字分析資料結構
-
-```typescript
-interface WordAnalysis {
-  word: string
-  translation: string
-  definition: string
-  partOfSpeech: string
-  pronunciation: string
-  synonyms: string[]
-  antonyms?: string[]
-  isPhrase: boolean
-  isHighValue: boolean      // 高學習價值標記
-  learningPriority: 'high' | 'medium' | 'low'
-  phraseInfo?: {
-    phrase: string
-    meaning: string
-    warning: string
-    colorCode: string
-  }
-  difficultyLevel: string   // CEFR 等級 (A1, A2, B1, B2, C1, C2)
-  costIncurred?: number     // 查詢成本
-}
-```
-
-#### 3. 語法修正結構
-
-```typescript
-interface GrammarCorrectionResult {
-  hasErrors: boolean
-  originalText: string
-  correctedText?: string
-  corrections: GrammarCorrection[]
-  confidenceScore: number
-}
-
-interface GrammarCorrection {
-  position: { start: number, end: number }
-  errorType: string
-  original: string
-  corrected: string
-  reason: string
-  severity: 'high' | 'medium' | 'low'
-}
-```
-
-### 🎨 UI/UX 規格
-
-#### 1. 主介面佈局 (`/generate`)
-
-```
-┌─────────────────────────────────────────┐
-│ Navigation Bar                          │
-├─────────────────────────────────────────┤
-│ 📝 AI 智能生成詞卡                        │
-│                                         │
-│ ┌─── 原始例句類型 ──────────────────────┐ │
-│ │ [✍️ 手動輸入] [📷 影劇截圖 🔒]         │ │
-│ └───────────────────────────────────────┘ │
-│                                         │
-│ ┌─── 輸入英文文本 ──────────────────────┐ │
-│ │ ┌─────────────────────────────────┐   │ │
-│ │ │ [Textarea: 最多300字元]         │   │ │
-│ │ │ "輸入英文句子（最多300字）..."    │   │ │
-│ │ └─────────────────────────────────┘   │ │
-│ │ 最多 300 字元 • 目前：0 字元           │ │
-│ └───────────────────────────────────────┘ │
-│                                         │
-│ ┌─────────────────────────────────────┐ │
-│ │ [🔍 分析句子] (全寬按鈕)              │ │
-│ └─────────────────────────────────────┘ │
-│                                         │
-│ 免費用戶：已使用 0/5 次 (3小時內)        │
-└─────────────────────────────────────────┘
-```
-
-#### 2. 分析結果介面
-
-```
-┌─────────────────────────────────────────┐
-│ 📝 句子分析結果              💾 快取結果  │
-│                               [← 返回]  │
-├─────────────────────────────────────────┤
-│ ⚠️  語法修正建議 (如有錯誤)             │
-│ ┌─ 原文：I go to school yesterday ──┐   │
-│ │ 修正：I went to school yesterday   │   │
-│ │ [✅ 採用修正] [❌ 保持原版]          │   │
-│ └───────────────────────────────────┘   │
-├─────────────────────────────────────────┤
-│ 📝 句子分析                             │
-│ ┌─ 用戶輸入 ────────────────────────┐   │
-│ │ I go to school yesterday          │   │
-│ └───────────────────────────────────┘   │
-│ ┌─ 整句意思 ────────────────────────┐   │
-│ │ 我昨天去學校。這句話表達了過去...   │   │
-│ └───────────────────────────────────┘   │
-├─────────────────────────────────────────┤
-│ 💡 點擊查詢單字意思                      │
-│ 🟡⭐高價值片語 🟢⭐高價值單字 🔵普通單字  │
-│ ┌─────────────────────────────────────┐ │
-│ │ I [went] to [school] [yesterday]    │ │
-│ │    🟢⭐    🔵    🟡⭐               │ │
-│ └─────────────────────────────────────┘ │
-├─────────────────────────────────────────┤
-│ [🔄 分析新句子] [📖 生成詞卡]            │
-└─────────────────────────────────────────┘
-```
-
-#### 3. 單字查詢彈窗
-
-```
-┌─── went ─────────────── ✕ ─┐
-│ ⭐ 高價值詞彙（免費查詢）      │
-│ ⭐⭐⭐⭐⭐ 學習價值           │
-│                            │
-│ [verb] /went/  🔊           │
-│                            │
-│ 翻譯: 去 (go的過去式)        │
-│ 定義: Past tense of go     │
-│                            │
-│ 同義詞: [traveled] [moved]  │
-│ 反義詞: [came] [stayed]     │
-│                            │
-│ 難度等級: [CEFR A1] (基礎)   │
-└────────────────────────────┘
-```
-
-#### 4. 收費確認對話框
-
-```
-┌─── school ─────────── ✕ ─┐
-│ 💰 低價值詞彙（需消耗額度）   │
-│ 此查詢將消耗 1 次 使用額度   │
-│ 剩餘額度：4 次              │
-│                            │
-│ [✅ 確認查詢] [❌ 取消]      │
-└────────────────────────────┘
-```
-
-### 🔧 技術實現規格
-
-#### 1. 前端組件架構
-
-```
-GeneratePage (主頁面)
-├── Navigation (導航欄)
-├── InputModeSelection (輸入模式選擇)
-├── TextInputArea (文字輸入區域)
-├── AnalysisButton (分析按鈕)
-├── UsageCounter (使用次數顯示)
-├── AnalysisView (分析結果檢視)
-│   ├── CacheStatusBadge (快取狀態標籤)
-│   ├── GrammarCorrectionPanel (語法修正面板)
-│   ├── SentenceAnalysisPanel (句子分析面板)
-│   └── ClickableTextV2 (互動式文字組件)
-│       ├── WordClickHandler (單字點擊處理)
-│       ├── CostConfirmDialog (收費確認對話框)
-│       └── WordInfoPopup (單字資訊彈窗)
-└── CardPreview (詞卡預覽, 可選)
-```
-
-#### 2. 後端API架構
-
-```
-AIController
-├── AnalyzeSentence (句子分析主API)
-│   ├── 使用限制檢查
-│   ├── 快取查詢邏輯
-│   ├── Gemini AI 調用
-│   ├── 語法修正處理
-│   ├── 高價值詞彙標記
-│   └── 快取寫入
-├── QueryWord (單字查詢API)
-│   ├── 高/低價值判斷
-│   ├── 收費邏輯處理
-│   └── 即時詞彙分析
-└── CacheManagement (快取管理API)
-    ├── GetCacheStats (快取統計)
-    ├── CleanupCache (清理過期快取)
-    └── InvalidateCache (手動清除快取)
-```
-
-#### 3. 快取系統規格
-
-```
-SentenceAnalysisCache (資料表)
-├── InputTextHash (SHA-256, 索引)
-├── AnalysisResult (JSON格式)
-├── ExpiresAt (過期時間, 索引)
-├── AccessCount (存取次數)
-├── CreatedAt / LastAccessedAt
-└── 複合索引 (Hash + ExpiresAt)
-
-快取策略:
-├── TTL: 24小時
-├── 清理: 自動背景任務
-├── 命中率: >80% (預期)
-└── 儲存格式: JSON序列化
-```
-
-## 🎮 詳細互動規格
-
-### 📝 輸入階段
-
-#### 輸入模式
-- **手動輸入**: 300字元限制，即時字數統計
-- **影劇截圖**: Phase 2 功能，付費用戶限定
-
-#### 輸入驗證
-```typescript
-// 字數限制邏輯
-if (mode === 'manual' && value.length > 300) {
-  return // 阻止輸入
-}
-
-// 視覺回饋
-const borderColor =
-  textLength >= 300 ? 'border-red-400' :
-  textLength >= 280 ? 'border-yellow-400' :
-  'border-gray-300'
-```
-
-#### 按鈕狀態
-```typescript
-// 分析按鈕啟用條件
-disabled = isAnalyzing ||
-          (mode === 'manual' && (!textInput || textInput.length > 300)) ||
-          (mode === 'screenshot')
-```
-
-### 🔍 分析階段
-
-#### 載入狀態
-- **初始**: "🔍 分析句子"
-- **載入中**: "正在分析句子... (AI 分析約需 3-5 秒)" + 旋轉動畫
-- **完成**: 自動跳轉到分析結果頁面
-
-#### 快取邏輯
-```csharp
-// 後端快取檢查流程
-1. 計算輸入文字的 SHA-256 hash
-2. 查詢資料庫是否有未過期的快取
-3. Cache Hit: 立即返回 + 更新統計
-4. Cache Miss: 調用 Gemini AI + 存入快取
-```
-
-#### 錯誤處理
-- **API 錯誤**: 顯示錯誤訊息
-- **網路錯誤**: 重試機制
-- **使用額度超限**: 提示升級或等待
-
-### 🖱️ 互動查詢階段
-
-#### 單字分類和視覺設計
-```css
-/* 高價值片語 */
-.high-value-phrase {
-  background: bg-yellow-100
-  border: 2px solid border-yellow-400
-  icon: ⭐
-  hover: bg-yellow-200 + shadow + transform
-}
-
-/* 高價值單字 */
-.high-value-word {
-  background: bg-green-100
-  border: 2px solid border-green-400
-  icon: ⭐
-  hover: bg-green-200 + shadow + transform
-}
-
-/* 普通單字 */
-.normal-word {
-  border-bottom: border-blue-300
-  hover: bg-blue-100 + border-blue-400
-}
-```
-
-#### 點擊行為邏輯
-```typescript
-// 單字點擊處理流程
-onClick(word) => {
-  const wordAnalysis = analysis[cleanWord]
-
-  if (wordAnalysis.isHighValue) {
-    // 高價值詞彙 - 立即顯示彈窗
-    showWordPopup(word, analysis)
-    // 不扣除使用額度
-  } else {
-    // 低價值詞彙 - 顯示收費確認
-    showCostConfirmDialog(word, cost: 1)
-    // 確認後扣除額度並調用API
-  }
-}
-```
-
-#### 彈窗內容結構
-```
-WordInfoPopup
-├── Header (單字 + 關閉按鈕)
-├── ValueBadge (高價值標記 + 學習價值星級)
-├── PhraseWarning (片語警告，如適用)
-├── BasicInfo (詞性 + 發音 + 發音按鈕)
-├── Translation (翻譯)
-├── Definition (英文定義)
-├── Synonyms (同義詞標籤)
-├── Antonyms (反義詞標籤)
-└── DifficultyLevel (CEFR難度等級)
-```
-
-### 💰 收費模式規格
-
-#### 免費用戶限制
-```typescript
-const FREE_USER_LIMITS = {
-  sentenceAnalysis: 5,      // 3小時內最多5次句子分析
-  timeWindow: 3 * 60 * 60,  // 3小時窗口 (秒)
-  wordQueryCost: 1,         // 每次低價值詞彙查詢成本
-  highValueWordsFree: true  // 高價值詞彙永遠免費
-}
-```
-
-#### 高價值詞彙判定邏輯
-```typescript
-// 高價值詞彙標準
-const isHighValue =
-  cefrLevel >= 'B1' ||           // B1+ 等級詞彙
-  isIdiomOrPhrase ||             // 慣用語和片語
-  isAcademicVocabulary ||        // 學術詞彙
-  learningFrequency === 'high'   // 高學習頻率詞彙
-```
-
-### 🗄️ 資料持久化規格
-
-#### 快取資料表結構
-```sql
-CREATE TABLE SentenceAnalysisCache (
-    Id UNIQUEIDENTIFIER PRIMARY KEY,
-    InputTextHash NVARCHAR(64) NOT NULL,     -- SHA-256 hash
-    InputText NVARCHAR(1000) NOT NULL,       -- 原始輸入
-    AnalysisResult NVARCHAR(MAX) NOT NULL,   -- JSON格式分析結果
-    HasGrammarErrors BIT NOT NULL,           -- 是否有語法錯誤
-    CorrectedText NVARCHAR(1000) NULL,       -- 修正後文字
-    GrammarCorrections NVARCHAR(MAX) NULL,   -- 語法修正JSON
-    HighValueWords NVARCHAR(MAX) NULL,       -- 高價值詞彙JSON
-    PhrasesDetected NVARCHAR(MAX) NULL,      -- 檢測到的片語JSON
-    CreatedAt DATETIME2 NOT NULL,            -- 建立時間
-    ExpiresAt DATETIME2 NOT NULL,            -- 過期時間
-    LastAccessedAt DATETIME2 NULL,           -- 最後存取時間
-    AccessCount INT NOT NULL DEFAULT 0       -- 存取次數
-);
-
--- 索引
-CREATE INDEX IX_SentenceAnalysisCache_Hash ON SentenceAnalysisCache(InputTextHash);
-CREATE INDEX IX_SentenceAnalysisCache_Expires ON SentenceAnalysisCache(ExpiresAt);
-CREATE INDEX IX_SentenceAnalysisCache_Hash_Expires ON SentenceAnalysisCache(InputTextHash, ExpiresAt);
-```
-
-## 🧪 測試規格
-
-### 🔬 功能測試案例
-
-#### 1. 句子分析功能測試
-
-**測試案例 1.1: 新句子分析**
-```
-輸入: "I went to school yesterday"
-預期結果:
-- 載入時間: 3-5 秒
-- 快取狀態: 🤖 AI 分析
-- 翻譯: "我昨天去學校。"
-- 解釋: 包含語法結構說明
-- 高價值詞彙: went, school, yesterday 標記為 ⭐
-```
-
-**測試案例 1.2: 快取命中測試**
-```
-前置條件: 已分析過 "I went to school yesterday"
-輸入: "I went to school yesterday" (相同句子)
-預期結果:
-- 載入時間: <200ms
-- 快取狀態: 💾 快取結果
-- 內容: 與首次分析完全相同
-- 使用額度: 不增加
-```
-
-**測試案例 1.3: 語法錯誤修正**
-```
-輸入: "I go to school yesterday"
-預期結果:
-- 語法修正面板出現
-- 原文: "I go to school yesterday"
-- 修正: "I went to school yesterday"
-- 修正原因: "過去式時態修正：句子中有 'yesterday'，應使用過去式"
-- 用戶可選擇採用或拒絕修正
-```
-
-#### 2. 互動式單字查詢測試
-
-**測試案例 2.1: 高價值詞彙查詢**
-```
-前置條件: 已完成句子分析
-操作: 點擊標記為 ⭐ 的單字 "went"
-預期結果:
-- 立即顯示詞彙資訊彈窗
-- 顯示 "⭐ 高價值詞彙（免費查詢）"
-- 不扣除使用額度
-- 包含完整詞彙信息
-```
-
-**測試案例 2.2: 低價值詞彙查詢**
-```
-前置條件: 已完成句子分析，剩餘額度 > 0
-操作: 點擊普通單字 (藍色下劃線)
-預期結果:
-1. 顯示收費確認對話框
-2. 顯示消耗額度和剩餘額度
-3. 用戶確認後扣除 1 次額度
-4. 調用 query-word API
-5. 顯示詞彙資訊彈窗
-```
-
-**測試案例 2.3: 額度不足測試**
-```
-前置條件: 剩餘額度 = 0
-操作: 點擊低價值詞彙
-預期結果:
-- 顯示 "❌ 使用額度不足，無法查詢低價值詞彙"
-- 不調用 API
-- 不顯示詞彙彈窗
-```
-
-#### 3. 使用限制測試
-
-**測試案例 3.1: 免費用戶限制**
-```
-前置條件: 免費用戶，3小時內已分析 5 次
-操作: 嘗試分析新句子
-預期結果:
-- 顯示 "❌ 免費用戶 3 小時內只能分析 5 次句子，請稍後再試或升級到付費版本"
-- 不調用分析 API
-- 使用計數不增加
-```
-
-**測試案例 3.2: 付費用戶無限制**
-```
-前置條件: isPremium = true
-操作: 多次分析句子
-預期結果:
-- 顯示 "🌟 付費用戶：無限制使用"
-- 所有分析正常執行
-- 無使用次數限制
-```
-
-### 🚀 效能測試規格
-
-#### 1. 回應時間測試
-
-| 測試情境 | 預期時間 | 測試方法 |
-|---------|----------|----------|
-| 新句子 AI 分析 | 3-5 秒 | 測量從點擊到結果顯示的時間 |
-| 快取命中查詢 | <200ms | 重複查詢相同句子 |
-| 高價值詞彙點擊 | <100ms | 點擊已標記的高價值詞彙 |
-| 低價值詞彙查詢 | 1-2 秒 | 確認後的API調用時間 |
-
-#### 2. 快取效能測試
-
-| 測試指標 | 目標值 | 測試方法 |
-|---------|-------|----------|
-| 快取命中率 | >80% | 重複查詢統計 |
-| 快取寫入成功率 | >99% | 監控快取失敗日誌 |
-| 快取過期清理 | 24小時 | 測試過期資料自動清理 |
-
-### 🔧 整合測試規格
-
-#### 1. 端到端測試流程
-
-**完整用戶旅程測試**:
-```
-1. 登入系統
-2. 導航到 /generate 頁面
-3. 輸入測試句子 "She felt ashamed of her mistake and apologized"
-4. 點擊 "🔍 分析句子"
-5. 驗證分析結果正確顯示
-6. 點擊高價值詞彙 "ashamed" (免費)
-7. 驗證詞彙彈窗內容
-8. 點擊低價值詞彙 "her" (收費)
-9. 確認收費對話框
-10. 驗證額度扣除
-11. 點擊 "🔄 分析新句子"
-12. 輸入相同句子
-13. 驗證快取命中 (💾 快取結果)
-14. 點擊 "📖 生成詞卡"
-15. 驗證詞卡生成功能
-```
-
-#### 2. API 整合測試
-
-**測試案例: API 連接性**
-```bash
-# 1. 句子分析 API 測試
-curl -X POST http://localhost:5000/api/ai/analyze-sentence \
-  -H "Content-Type: application/json" \
-  -d '{"inputText": "Hello world", "analysisMode": "full"}'
-
-# 2. 單字查詢 API 測試
-curl -X POST http://localhost:5000/api/ai/query-word \
-  -H "Content-Type: application/json" \
-  -d '{"word": "hello", "sentence": "Hello world"}'
-
-# 3. 快取統計 API 測試
-curl -X GET http://localhost:5000/api/ai/cache-stats
-```
-
-#### 3. 邊界條件測試
-
-**輸入驗證測試**:
-```
-測試案例 3.1: 空白輸入
-輸入: ""
-預期: 按鈕禁用，無法提交
-
-測試案例 3.2: 超長輸入
-輸入: 301字元的文字
-預期: 無法輸入，紅色邊框警告
-
-測試案例 3.3: 特殊字元
-輸入: "Hello @#$%^&*() world!"
-預期: 正常分析，特殊字元適當處理
-
-測試案例 3.4: 純中文輸入
-輸入: "你好世界"
-預期: 系統應適當處理或給出提示
-```
-
-### 🐛 錯誤處理測試
-
-#### 1. 網路錯誤測試
-```
-測試案例 1: 後端服務停止
-操作: 停止後端服務後嘗試分析
-預期: 顯示連接錯誤訊息，不崩潰
-
-測試案例 2: Gemini API 失敗
-模擬: API key 無效或 API 服務不可用
-預期: 回退到本地分析，不中斷用戶體驗
-```
-
-#### 2. 資料錯誤測試
-```
-測試案例 1: 損壞的快取資料
-模擬: 資料庫中有格式錯誤的 JSON
-預期: 忽略損壞快取，重新調用 AI 分析
-
-測試案例 2: 不完整的API回應
-模擬: 後端回傳缺少某些欄位的資料
-預期: 使用預設值，顯示部分資訊而非崩潰
-```
-
-## 🎯 驗收標準
-
-### ✅ 功能驗收標準
-
-1. **基本功能完整性**
-   - [ ] 用戶可成功輸入並分析英文句子
-   - [ ] 所有UI組件正確顯示和互動
-   - [ ] API調用成功且資料正確處理
-
-2. **AI功能正確性**
-   - [ ] Gemini AI 整合正常運作
-   - [ ] 翻譯和解釋內容品質符合要求
-   - [ ] 語法修正建議合理且準確
-
-3. **互動查詢功能**
-   - [ ] 高價值詞彙免費查詢正常
-   - [ ] 低價值詞彙收費機制正確
-   - [ ] 詞彙彈窗內容完整準確
-
-4. **快取系統功能**
-   - [ ] 新句子使用 AI 分析
-   - [ ] 重複句子使用快取結果
-   - [ ] 快取狀態正確顯示
-
-5. **使用限制功能**
-   - [ ] 免費用戶額度限制生效
-   - [ ] 付費用戶無限制使用
-   - [ ] 額度計算準確無誤
-
-### 📊 效能驗收標準
-
-1. **回應時間要求**
-   - [ ] 快取命中 < 200ms
-   - [ ] AI分析 < 10秒 (95%的情況下 < 5秒)
-   - [ ] 頁面導航 < 100ms
-
-2. **系統穩定性**
-   - [ ] 24小時連續運行無崩潰
-   - [ ] 記憶體使用穩定
-   - [ ] 資料庫連接池正常
-
-3. **用戶體驗標準**
-   - [ ] 用戶操作回饋及時 (<100ms)
-   - [ ] 載入狀態清晰可見
-   - [ ] 錯誤訊息用戶友善
-
-## 🔧 開發和部署規格
-
-### 📁 檔案結構
-```
-frontend/
-├── app/generate/page.tsx              (主要分析頁面)
-├── components/ClickableTextV2.tsx     (互動式文字組件)
-├── components/GrammarCorrectionPanel.tsx (語法修正面板)
-└── contexts/AuthContext.tsx          (認證上下文)
-
-backend/
-├── Controllers/AIController.cs        (AI API 控制器)
-├── Services/GeminiService.cs         (Gemini AI 服務)
-├── Services/AnalysisCacheService.cs  (快取服務)
-├── Services/UsageTrackingService.cs  (使用追蹤服務)
-└── Models/Entities/               (資料模型)
-```
-
-### 🚀 部署需求
-
-#### 環境變數
-```env
-# Gemini AI
-GEMINI_API_KEY=your_gemini_api_key
-
-# 資料庫
-CONNECTION_STRING=Data Source=dramaling.db
-
-# CORS
-ALLOWED_ORIGINS=http://localhost:3000,http://localhost:3002
-
-# 快取設定
-CACHE_TTL_HOURS=24
-CACHE_CLEANUP_INTERVAL_HOURS=6
-```
-
-#### 系統需求
-- **前端**: Node.js 18+, Next.js 15+
-- **後端**: .NET 8.0+, ASP.NET Core
-- **資料庫**: SQLite 3.x (開發), SQL Server (生產)
-- **外部API**: Google Gemini API access
-
----
-
-**文檔版本**: v1.0
-**最後更新**: 2025-01-18
-**負責人**: Claude Code
-**審核狀態**: ✅ 完成
\ No newline at end of file
diff --git a/note/usage-limit-implementation-report.md b/note/usage-limit-implementation-report.md
deleted file mode 100644
index 1628ee4..0000000
--- a/note/usage-limit-implementation-report.md
+++ /dev/null
@@ -1,551 +0,0 @@
-# 免費用戶使用限制功能實現報告
-
-**項目**: DramaLing 英語學習平台
-**功能模組**: 免費用戶使用額度管理系統
-**檢查日期**: 2025-01-18
-**檢查者**: Claude Code
-
-## 📋 功能概述
-
-免費用戶使用限制功能是一個雙層限制系統，通過前端本地計數和後端資料庫驗證，確保免費用戶在 3 小時內最多只能進行 5 次句子分析，防止濫用 AI 資源。
-
-## 🔧 當前實現架構
-
-### 📊 限制參數
-```typescript
-// 前端常數 (generate/page.tsx)
-const FREE_USER_LIMIT = 5           // 最大分析次數
-const TIME_WINDOW = "3小時"          // 時間窗口
-const isPremium = false             // 用戶類型
-
-// 後端常數 (UsageTrackingService.cs)
-const FREE_USER_ANALYSIS_LIMIT = 5  // 最大分析次數
-const FREE_USER_RESET_HOURS = 3     // 3小時重置窗口
-```
-
-## 🔄 雙層限制實現機制
-
-### 1️⃣ **前端限制層** (第一道防線)
-
-**檔案位置**: `frontend/app/generate/page.tsx:42-46`
-
-```typescript
-// 前端本地檢查
-if (!isPremium && usageCount >= 5) {
-  console.log('❌ 使用次數超限')
-  alert('❌ 免費用戶 3 小時內只能分析 5 次句子，請稍後再試或升級到付費版本')
-  return
-}
-```
-
-**實現方式**:
-- ✅ **本地狀態**: `const [usageCount, setUsageCount] = useState(0)`
-- ✅ **即時檢查**: 每次點擊分析按鈕前驗證
-- ✅ **用戶回饋**: 立即顯示限制提示，無需等待API
-- ✅ **計數更新**: 成功分析後 `setUsageCount(prev => prev + 1)`
-
-**特點**:
-- 🚀 **即時回應**: 無需API調用，立即提示
-- 🎯 **用戶友善**: 清楚說明限制原因和解決方案
-- 💰 **引導付費**: 提示升級到付費版本
-
-### 2️⃣ **後端驗證層** (權威檢查)
-
-**檔案位置**: `backend/DramaLing.Api/Controllers/AIController.cs:515-531`
-
-```csharp
-// 後端權威驗證
-var mockUserId = Guid.Parse("00000000-0000-0000-0000-000000000001");
-var canUse = await _usageService.CheckUsageLimitAsync(mockUserId, isPremium: false);
-if (!canUse)
-{
-    return StatusCode(429, new
-    {
-        Success = false,
-        Error = "免費用戶使用限制已達上限",
-        ErrorCode = "USAGE_LIMIT_EXCEEDED",
-        ResetInfo = new
-        {
-            WindowHours = 3,
-            Limit = 5
-        }
-    });
-}
-```
-
-**實現方式**:
-- ✅ **資料庫查詢**: 基於 `WordQueryUsageStats` 表
-- ✅ **時間窗口**: 查詢過去3小時的使用記錄
-- ✅ **精確計算**: `SentenceAnalysisCount + LowValueWordClicks`
-- ✅ **錯誤代碼**: 結構化錯誤回應
-
-## 🗄️ 資料庫實現詳情
-
-### 使用統計表結構
-
-**表名**: `WordQueryUsageStats`
-
-```sql
--- 使用統計記錄表
-CREATE TABLE WordQueryUsageStats (
-    Id UNIQUEIDENTIFIER PRIMARY KEY,
-    UserId UNIQUEIDENTIFIER NOT NULL,           -- 用戶ID
-    SentenceAnalysisCount INT NOT NULL,         -- 句子分析次數
-    HighValueWordClicks INT NOT NULL,           -- 高價值詞彙點擊次數
-    LowValueWordClicks INT NOT NULL,            -- 低價值詞彙點擊次數（收費）
-    CreatedAt DATETIME2 NOT NULL,               -- 記錄建立時間
-    UpdatedAt DATETIME2 NOT NULL                -- 最後更新時間
-);
-```
-
-### 使用統計查詢邏輯
-
-**檔案位置**: `backend/DramaLing.Api/Services/UsageTrackingService.cs:42-47`
-
-```csharp
-// 計算過去3小時的使用量
-var resetTime = DateTime.UtcNow.AddHours(-FREE_USER_RESET_HOURS);
-var recentUsage = await _context.WordQueryUsageStats
-    .Where(stats => stats.UserId == userId && stats.CreatedAt >= resetTime)
-    .SumAsync(stats => stats.SentenceAnalysisCount + stats.LowValueWordClicks);
-
-var canUse = recentUsage < FREE_USER_ANALYSIS_LIMIT;
-```
-
-**特點**:
-- 🕐 **滑動窗口**: 過去3小時內的累計使用量
-- 📊 **綜合計算**: 句子分析 + 付費詞彙查詢
-- 🔒 **權威性**: 無法被前端繞過
-- 📈 **可擴展**: 支援不同用戶類型的限制
-
-## 🎨 用戶介面實現
-
-### UI顯示邏輯
-
-**檔案位置**: `frontend/app/generate/page.tsx:295-312`
-
-```typescript
-// 使用次數顯示
-<div className="text-center text-sm text-gray-600">
-  {isPremium ? (
-    <span className="text-green-600">🌟 付費用戶：無限制使用</span>
-  ) : (
-    <span className={usageCount >= 4 ? 'text-red-600' :
-                    usageCount >= 3 ? 'text-yellow-600' : 'text-gray-600'}>
-      免費用戶：已使用 {usageCount}/5 次 (3小時內)
-      {usageCount >= 5 && <span className="block text-red-500 mt-1">已達上限，請稍後再試</span>}
-    </span>
-  )}
-</div>
-```
-
-### 視覺回饋系統
-
-| 使用次數 | 顏色 | 狀態 | 用戶體驗 |
-|---------|------|------|----------|
-| **0-2次** | `text-gray-600` | 正常 | 無特殊提示 |
-| **3次** | `text-yellow-600` | 警告 | 黃色提醒剩餘次數 |
-| **4次** | `text-red-600` | 危險 | 紅色警告即將達限 |
-| **5次** | `text-red-500` | 限制 | 顯示"已達上限"訊息 |
-
-### 按鈕狀態管理
-
-```typescript
-// 分析按鈕禁用邏輯
-disabled = isAnalyzing ||                                    // 正在分析中
-          (mode === 'manual' && (!textInput || textInput.length > 300)) ||  // 輸入驗證
-          (mode === 'screenshot')                            // 截圖模式未開放
-```
-
-**注意**: 前端按鈕禁用主要基於輸入驗證，使用限制檢查在函數內部進行。
-
-## 🔍 實現流程分析
-
-### 句子分析流程
-
-```
-用戶點擊「🔍 分析句子」
-         ↓
-┌─── 前端檢查 ─────────────────┐
-│ 1. 檢查 isPremium 狀態        │
-│ 2. 檢查 usageCount >= 5      │
-│ 3. 超限則顯示錯誤並 return    │
-└─────────────────────────────┘
-         ↓ (通過)
-┌─── 發送 API 請求 ────────────┐
-│ POST /api/ai/analyze-sentence │
-└─────────────────────────────┘
-         ↓
-┌─── 後端驗證 ─────────────────┐
-│ 1. 檢查資料庫使用記錄         │
-│ 2. 計算過去3小時累計使用量    │
-│ 3. 超限則返回 429 錯誤       │
-└─────────────────────────────┘
-         ↓ (通過)
-┌─── 執行分析 ─────────────────┐
-│ 1. 調用 Gemini AI           │
-│ 2. 處理分析結果              │
-│ 3. 存入快取                 │
-│ 4. 更新使用統計              │
-└─────────────────────────────┘
-         ↓
-┌─── 前端更新 ─────────────────┐
-│ 1. 顯示分析結果              │
-│ 2. usageCount + 1           │
-│ 3. 更新UI狀態顯示            │
-└─────────────────────────────┘
-```
-
-## 🚨 問題分析：前後端不同步
-
-### ⚠️ **發現的設計問題**
-
-#### 1. **計數邏輯不一致**
-
-**前端計數**:
-```typescript
-// 簡單累加，不考慮時間窗口
-setUsageCount(prev => prev + 1)
-```
-
-**後端計數**:
-```csharp
-// 基於3小時滑動窗口的資料庫查詢
-var recentUsage = await _context.WordQueryUsageStats
-    .Where(stats => stats.UserId == userId && stats.CreatedAt >= resetTime)
-    .SumAsync(stats => stats.SentenceAnalysisCount + stats.LowValueWordClicks);
-```
-
-#### 2. **時間重置機制**
-
-| 層級 | 重置機制 | 問題 |
-|------|----------|------|
-| **前端** | ❌ 無重置 | 頁面刷新會重置為0，但實際限制未重置 |
-| **後端** | ✅ 3小時滑動窗口 | 正確實現，但前端不知道何時重置 |
-
-#### 3. **快取命中對計數的影響**
-
-**當前行為**:
-- ✅ **新句子**: 消耗1次額度 (正確)
-- ❌ **快取命中**: 也消耗1次額度 (可能不合理)
-
-**問題**: 快取命中不應該消耗額度，因為沒有調用AI API。
-
-### 🔧 **當前實現的優缺點**
-
-#### ✅ **優點**
-1. **雙重保護**: 前端 + 後端雙重驗證
-2. **即時回饋**: 前端檢查提供即時用戶體驗
-3. **安全性**: 後端驗證防止繞過
-4. **視覺提示**: 分級顏色警告系統
-5. **付費引導**: 清楚的升級提示
-
-#### ❌ **問題**
-1. **不同步**: 前後端計數邏輯不一致
-2. **無時間重置**: 前端不知道何時重置額度
-3. **快取誤計**: 快取命中也消耗額度
-4. **頁面重置**: 刷新頁面會重置前端計數器
-5. **無持久化**: 前端計數器無法跨頁面保持
-
-## 💡 建議改善方案
-
-### 🎯 **短期修復**
-
-#### 1. **修復快取計數問題**
-```typescript
-// 修改前端：快取命中不增加計數
-if (result.success) {
-  // ... 其他處理
-
-  // 只有非快取結果才增加計數
-  if (!result.cached) {
-    setUsageCount(prev => prev + 1)
-  }
-}
-```
-
-#### 2. **前端計數同步**
-```typescript
-// 添加從後端獲取實際使用量的功能
-const fetchUsageStats = async () => {
-  const response = await fetch('/api/ai/usage-stats')
-  const stats = await response.json()
-  setUsageCount(stats.data.recentUsage)
-}
-
-// 在組件初始化時同步
-useEffect(() => {
-  fetchUsageStats()
-}, [])
-```
-
-#### 3. **時間重置提示**
-```typescript
-// 添加重置時間顯示
-const nextResetTime = new Date(Date.now() + (3 * 60 * 60 * 1000))
-<span className="text-xs text-gray-500 block">
-  額度將於 {nextResetTime.toLocaleTimeString()} 重置
-</span>
-```
-
-### 🚀 **中期改善**
-
-#### 1. **統一計數系統**
-- 移除前端計數器
-- 完全依賴後端API提供的使用統計
-- 每次操作後同步最新狀態
-
-#### 2. **智能快取策略**
-- 快取命中不消耗額度
-- 高價值詞彙查詢永遠免費
-- 只有實際AI調用才計費
-
-#### 3. **增強的用戶體驗**
-- 實時剩餘額度顯示
-- 重置時間倒計時
-- 使用歷史記錄
-
-## 📊 當前實現狀態評估
-
-### ✅ **運作正常的部分**
-
-1. **基本限制機制**: 確實能防止超量使用
-2. **視覺回饋系統**: 用戶能清楚看到使用狀態
-3. **後端安全驗證**: 無法繞過的伺服器端檢查
-4. **付費用戶支援**: 正確識別並給予無限制使用
-
-### ⚠️ **存在問題的部分**
-
-1. **前後端不同步**:
-   - 前端: 簡單累加計數器
-   - 後端: 3小時滑動窗口計算
-
-2. **快取計數邏輯**:
-   - 快取命中仍消耗前端計數器
-   - 實際上沒有消耗AI資源
-
-3. **頁面狀態持久性**:
-   - 頁面刷新會重置前端計數器
-   - 用戶可能誤以為額度重置
-
-### 🔍 **技術債務**
-
-1. **資料一致性**: 需要統一前後端計數邏輯
-2. **狀態管理**: 需要持久化前端狀態
-3. **用戶體驗**: 需要更準確的額度資訊
-
-## 🧪 測試用例分析
-
-### **目前的實現問題測試**
-
-#### 測試案例 1: 快取計數問題
-```
-步驟:
-1. 分析句子A (usageCount = 1)
-2. 返回並重新分析句子A (快取命中)
-預期: usageCount 應該保持 1
-實際: usageCount 變成 2 ❌
-
-問題: 快取命中不應該消耗額度
-```
-
-#### 測試案例 2: 頁面刷新問題
-```
-步驟:
-1. 分析5次句子 (usageCount = 5)
-2. 刷新頁面
-預期: 仍然顯示限制狀態
-實際: usageCount 重置為 0，可以繼續使用 ❌
-
-問題: 前端狀態沒有持久化
-```
-
-#### 測試案例 3: 後端驗證
-```
-步驟:
-1. 繞過前端檢查，直接調用API
-2. 在3小時內調用超過5次
-預期: 後端應該返回 429 錯誤
-實際: 需要驗證 ⚠️
-
-狀態: 邏輯存在，但需要實際測試
-```
-
-## 📈 效能影響分析
-
-### 前端效能
-- **狀態管理**: 輕量級 (`useState`)
-- **檢查成本**: O(1) 常數時間
-- **記憶體使用**: 微量 (單一整數值)
-
-### 後端效能
-- **資料庫查詢**: 每次分析需要查詢使用統計
-- **索引需求**: `UserId + CreatedAt` 複合索引
-- **查詢複雜度**: 簡單時間範圍查詢
-
-### 網路效能
-- **額外API調用**: 可能需要獨立的使用統計API
-- **回應大小**: 增加使用統計資訊
-
-## 🎯 功能完整性評估
-
-### ✅ **已實現功能**
-
-1. **基本限制**: 5次/3小時限制正確執行
-2. **付費區分**: 付費用戶無限制使用
-3. **視覺提示**: 清楚的使用狀態顯示
-4. **錯誤處理**: 適當的錯誤訊息和引導
-
-### ❌ **缺失功能**
-
-1. **狀態同步**: 前後端計數器不一致
-2. **時間重置**: 用戶不知道何時重置
-3. **快取優化**: 快取命中仍計費
-4. **歷史記錄**: 無使用歷史追蹤
-5. **統計面板**: 無詳細使用統計展示
-
-### ⚠️ **部分功能**
-
-1. **後端驗證**: 邏輯存在但需要實際測試
-2. **錯誤處理**: 基本實現，可更完善
-3. **用戶體驗**: 功能性足夠，體驗可優化
-
-## 🚀 改善優先級建議
-
-### **高優先級** (立即修復)
-1. ✅ **修復快取計數**: 快取命中不消耗額度
-2. ✅ **前端狀態同步**: 從後端獲取實際使用量
-3. ✅ **頁面刷新處理**: 持久化或重新獲取狀態
-
-### **中優先級** (1-2週內)
-1. **時間重置提示**: 顯示下次重置時間
-2. **使用統計API**: 獨立的使用統計端點
-3. **增強錯誤處理**: 更友善的錯誤訊息
-
-### **低優先級** (未來功能)
-1. **使用歷史記錄**: 詳細的使用歷史
-2. **彈性限制**: 基於用戶行為的動態限制
-3. **統計儀表板**: 管理員使用統計面板
-
-## 🏁 結論
-
-### **當前狀態**: ⚠️ **基本可用，存在改善空間**
-
-**功能性**: ✅ 基本限制機制運作正常
-**用戶體驗**: ⚠️ 可用但有混亂點 (快取計數、頁面重置)
-**技術實現**: ⚠️ 雙層保護好，但同步性有問題
-**商業價值**: ✅ 有效防止濫用，引導付費
-
-### **關鍵改善點**
-
-1. **統一計數邏輯**: 前後端使用相同的計算方式
-2. **快取計數修復**: 快取命中不應消耗額度
-3. **狀態持久化**: 解決頁面刷新重置問題
-4. **時間透明度**: 讓用戶知道重置時間
-
-### **建議實施**
-
-**第一階段**: 修復快取計數和狀態同步問題
-**第二階段**: 增加時間重置提示和統計API
-**第三階段**: 完整的使用歷史和管理功能
-
----
-
-## 🔄 系統暫時關閉記錄
-
-**執行時間**: 2025-01-18 15:54
-**執行者**: Claude Code
-**狀態**: ✅ 使用限制系統已暫時關閉
-
-### 📝 修改記錄
-
-#### 1. **前端修改**
-**檔案**: `frontend/app/generate/page.tsx`
-**位置**: 第24行
-**修改內容**:
-```typescript
-// 修改前
-const [isPremium] = useState(false)
-
-// 修改後
-const [isPremium] = useState(true)
-```
-
-#### 2. **後端修改**
-**檔案**: `backend/DramaLing.Api/Controllers/AIController.cs`
-**位置**: 第517行
-**修改內容**:
-```csharp
-// 修改前
-var canUse = await _usageService.CheckUsageLimitAsync(mockUserId, isPremium: false);
-
-// 修改後
-var canUse = await _usageService.CheckUsageLimitAsync(mockUserId, isPremium: true);
-```
-
-#### 3. **編譯問題修復**
-**檔案**: `backend/DramaLing.Api/Controllers/AIController.cs`
-**位置**: 第7行 (using statements)
-**修改內容**:
-```csharp
-// 新增
-using System.Text.Json;
-```
-
-### 🧪 **測試結果**
-
-✅ **多次調用測試通過**:
-- 第1次調用: 成功
-- 第6次調用: 成功 (原本第6次會被限制)
-- API無限制調用確認成功
-
-✅ **UI顯示效果**:
-```
-🌟 付費用戶：無限制使用
-```
-
-### 🔄 **復原使用限制的步驟**
-
-當需要重新啟用使用限制時，請執行以下步驟：
-
-#### **步驟1: 復原前端設定**
-```bash
-# 編輯檔案: frontend/app/generate/page.tsx
-# 第24行改回:
-const [isPremium] = useState(false)
-```
-
-#### **步驟2: 復原後端設定**
-```bash
-# 編輯檔案: backend/DramaLing.Api/Controllers/AIController.cs
-# 第517行改回:
-var canUse = await _usageService.CheckUsageLimitAsync(mockUserId, isPremium: false);
-```
-
-#### **步驟3: 重新啟動服務**
-```bash
-# 重新啟動後端
-cd backend/DramaLing.Api
-dotnet run --urls http://localhost:5000
-
-# 前端會自動重新編譯
-```
-
-#### **步驟4: 驗證復原**
-復原後應該看到:
-```
-免費用戶：已使用 0/5 次 (3小時內)
-```
-
-### ⚠️ **重要提醒**
-
-1. **資料庫統計**: 後端的使用統計仍在記錄，復原限制後會基於實際使用記錄計算
-2. **快取清理**: 如需要完全重置統計，可考慮清理 `WordQueryUsageStats` 表
-3. **前端狀態**: 前端計數器會在頁面刷新後重置，但後端限制基於資料庫記錄
-
----
-
-**報告生成時間**: 2025-01-18
-**最後更新時間**: 2025-01-18 15:54
-**分析範圍**: 前端 + 後端 + 資料庫
-**功能狀態**: 🔄 **暫時關閉，隨時可復原**
\ No newline at end of file