jettcheng1018
/
dramaling-vocab-learning
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
70 Commits 1 Branch 0 Tags 150 MiB
Commit Graph

14 Commits

Author SHA1 Message Date
鄭沛軒 14b55d6f7a refactor: 完全移除query-word API調用並修正資料傳遞問題 
🎯 主要修正：
- 完全移除queryWordWithAI函數和相關API調用
- 移除handleCostConfirm中的query-word調用
- 簡化ClickableTextV2組件介面，移除onNewWordAnalysis回調

🔧 架構優化：
- 統一使用analyze-sentence API作為唯一資料來源
- 實現findWordAnalysis智能詞彙匹配（處理大小寫問題）
- 提取POPUP_CONFIG常數，提高代碼可維護性
- 移除未使用的變數viewportHeight

🚨 關鍵問題發現：
- 前端期望result.data.WordAnalysis但API回傳undefined
- 導致ClickableTextV2接收到空物件，無法顯示詞彙資料
- 添加智能屬性名稱匹配：WordAnalysis || wordAnalysis

📊 Debug增強：
- 添加資料傳遞過程的詳細調試
- 確認API回應和組件接收的資料一致性
- 為問題診斷提供完整的資訊鏈

🎯 新架構效果：
- 只使用一個API端點，避免資料不一致
- 智能大小寫匹配，確保詞彙查找成功
- 簡化的代碼邏輯，更易維護

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 16:17:26 +08:00
鄭沛軒 36659d3bed clean: 清理前端debug程式碼，保持生產代碼整潔 
🧹 清理內容：
- 移除API接收階段的詳細調試資訊
- 移除詞彙點擊路由的debug輸出
- 移除例句檢查的console.log
- 移除各種JSON.stringify調試

✅ 保留功能：
- 例句顯示區塊（藍色區塊）
- 強化的getWordProperty函數
- 同義詞補充機制
- 所有Portal彈窗功能

🎯 代碼狀態：
- 乾淨的生產代碼，無debug污染
- 功能完整且性能優化
- 準備用於後續問題修正

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 14:39:21 +08:00
鄭沛軒 3b61cf8ce4 fix: 修正AI例句生成和前端詞彙顯示問題 
🔧 後端修正：
- 修正Gemini AI prompt，要求生成實用例句和翻譯
- 擴展WordAnalysisResult添加Example和ExampleTranslation屬性
- 修正後處理邏輯，優先使用AI例句，沒有時使用優質例句庫
- 添加GetQualityExampleSentence和GetQualityExampleTranslation函數

🎯 例句品質提升：
- bonus: "Employees received a year-end bonus for excellent performance."
- company: "The tech company is hiring new software engineers."
- 移除垃圾模板例句，提供真實場景和實際用法

🔍 前端Debug增強：
- 添加詳細的API接收調試資訊
- 添加詞彙點擊路由調試
- 新增例句區塊顯示（藍色區塊）
- 強化getWordProperty函數的屬性查找

📊 診斷發現：
- API確實生成了優質例句
- 前端調用了錯誤的query-word API覆蓋了正確資料
- 需要修正前端詞彙查找邏輯

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 14:33:29 +08:00
鄭沛軒 a6a7e53638 fix: 修正前端popup詞彙資料顯示不完整問題 
🔧 前端修正：
- 強化getWordProperty函數的屬性查找邏輯
- 支援多種屬性名稱格式（大小寫兼容）
- 添加前端同義詞補充機制（getSynonymsForWord）
- 移除不必要的調試代碼

🎯 解決的問題：
- 詞性標籤正確顯示
- CEFR等級標籤正確顯示
- 同義詞區塊現在會顯示（補充本地資料）
- 前端能正確處理AI回傳的不完整資料

📱 用戶體驗改善：
- popup現在顯示完整的詞彙資訊
- 同義詞區塊有實際內容
- 所有標籤和區塊正確渲染

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 13:27:12 +08:00
鄭沛軒 a5c439bbaf docs: 完成AI詞彙分析系統規格文件並整合個人化重點學習範圍 
📋 文件內容：
- 創建完整的AI詞彙分析生成系統規格文件
- 整合個人化重點學習範圍系統設計
- 詳細的功能規格、技術架構、API規格

🎯 重大概念更新：
- 高價值詞彙 → 重點學習範圍概念
- AI不再自己決定，改由CEFRLevelService判定
- 個人化判定邏輯：用戶程度+1~2階級

🔧 前端修正：
- 修正getWordProperty函數處理AI資料格式不完整問題
- 智能處理同義詞、例句等缺失欄位
- 前端能夠適應AI回應格式變化

🏗️ 後端詞彙庫擴充：
- 新增用戶例句中的所有詞彙翻譯和定義
- 修正同義詞函數返回空數組而非無意義文字
- 確保AI分析和本地增強的整合

📊 規格文件特色：
- v2.0版本整合個人化系統
- 完整的CEFR等級判定邏輯
- Portal設計技術規格
- 用戶程度設定系統架構
- 個人化快取策略

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 03:00:50 +08:00
鄭沛軒 421edd0589 refactor: 重構ClickableTextV2使用React Portal避免CSS繼承問題 
🎯 主要改進：
- 使用React Portal將詞彙彈窗渲染到document.body
- 完全脫離父級CSS繼承，解決字體大小和對齊問題
- 確保彈窗樣式與vocab-designs頁面的詞卡風格100%一致

🏗️ 技術架構：
- 導入createPortal和useEffect來管理Portal渲染
- 添加mounted state確保只在客戶端渲染Portal
- 統一getCEFRColor函數，支援完整的6個CEFR等級
- 保持原有API和功能完全不變

✅ 解決的問題：
- 詞彙標題現在正確靠左對齊
- 按鈕文字大小恢復正常（不再受text-lg影響）
- 彈窗樣式與展示頁面完全一致
- 移除了不必要的樣式重置類別

📝 代碼清理：
- 移除舊的ClickableText.tsx組件
- 優化VocabPopup組件結構
- 更新組件頂部文檔說明Portal架構

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-21 01:00:01 +08:00
鄭沛軒 db952f94be fix: 統一popup樣式，修正詞卡風格與實際功能的一致性問題 
- 修正ClickableTextV2組件的popup樣式，與詞卡風格展示頁面保持一致
- 調整詞彙標題為左對齊
- 統一按鈕容器padding (p-4)
- 修復TypeScript錯誤和類型問題
- 新增詞卡風格選項到展示頁面
- 實現完整的popup樣式一致性測試

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-20 23:10:26 +08:00
鄭沛軒 453ecd6d1c fix: 修正手機端詞彙popup定位問題 
- 解決手機版popup容易被屏幕邊緣截掉的問題
- 實現響應式popup寬度：min(320px, calc(100vw - 32px))
- 針對手機端(≤640px)特殊處理：popup自動居中顯示
- 優化邊界檢測邏輯，確保popup始終在可視範圍內
- 大屏幕保持智能定位，小屏幕採用安全居中策略
- 添加動態寬度計算，適應不同屏幕尺寸
- 預留最小邊距16px，避免popup貼邊顯示

修正後手機端用戶體驗大幅改善，popup不再被截掉。

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-20 20:13:20 +08:00
鄭沛軒 4e69030bc2 feat: 實現完整的詞彙儲存功能與UI設計優化 
- 新增後端批量詞卡保存API (POST /api/flashcards/batch)
- 實現前端詞卡選擇對話框組件 (CardSelectionDialog)
- 優化句子分析頁面設計，以句子為主體
- 重新設計ClickableTextV2詞彙popup，採用現代玻璃morphism風格
- 改進詞卡清單頁面，採用簡潔的清單設計
- 添加CEFR等級標註與六級顏色設計
- 新增收藏功能與收藏詞卡tab頁面
- 創建詞彙版型展示頁面 (vocab-designs)
- 建立完整的UI/UX設計規範文件
- 撰寫詞彙生成與儲存系統技術規格文件
- 使用假數據實現快速測試功能
- 優化例句圖片展示與播放按鈕設計

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-20 17:52:22 +08:00
鄭沛軒 f90286ad88 ux: 優化用戶友善文案，將「高價值詞彙」改為「重點學習詞彙」 
文案優化：
- 程度指示器：「💎 高價值範圍」→「📈 重點學習範圍」
- 設定頁面：「高價值詞彙範圍」→「重點學習範圍」
- AI Prompt：「標記為高價值」→「標記為重點學習」
- 詞彙標記：「高價值詞彙」→「重點學習詞彙」

視覺優化：
- 圖標升級：⭐ (價值感) → 🎯 (目標感)
- 強化學習導向的表達方式

技術修復：
- 新增DbContext個人化欄位映射，解決資料庫欄位問題
- 確保C#模型與SQLite表結構正確對應

用戶體驗提升：
- 從商業化的「價值」概念轉為教育性的「學習」概念
- 更直觀的個人化學習目標表達
- 減少用戶理解負擔，提升整體友善度

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-19 00:26:10 +08:00
鄭沛軒 255adc62c9 feat: 簡化句子分析功能並實現全詞彙可點擊 
主要變更：
- 移除句子分析中的冗長解釋，只保留翻譯
- 修改 AI Prompt 簡化回應格式
- 實現所有單字都可點擊的互動功能
- 無預存資料的詞彙支援即時 AI 查詢
- 移除付費限制，提供完全免費的詞彙查詢體驗
- 新增詞彙快取機制技術規格文檔

技術改善：
- 優化 ClickableTextV2 組件支援全詞彙點擊
- 新增動態詞彙資料更新機制
- 改善視覺提示，區分有/無預存資料的詞彙
- 整理項目文檔結構，移除過時檔案

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-18 19:41:48 +08:00
鄭沛軒 1fb7cadd52 feat: 新增完整的系統分析文檔和前端快取狀態顯示 
前端改善:
- 新增快取狀態視覺化標籤 (💾 快取結果 / 🤖 AI 分析)
- 完善ClickableTextV2組件的大小寫屬性相容性
- 修復互動式單字查詢功能在快取場景下的顯示問題
- 改善載入狀態提示，增加時間預期說明
- 新增getWordProperty輔助函數，統一處理屬性讀取

系統文檔:
- 新增完整的功能規格文檔 (User Flow + 測試案例)
- 生成快取機制分析報告 (前端+後端)
- 建立使用限制功能實現報告
- 記錄所有檢查方法和問題解決過程

清理:
- 移除過時的環境設定文檔
- 整理專案結構

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-18 14:44:48 +08:00
鄭沛軒 d69ba4ea8a feat: 完成前端整合和調試優化 
- 整合demo-v3功能到正式generate頁面
- 移除測試示例和調試內容
- 添加前端調試日誌協助排查問題
- 修復組件安全性檢查
- 符合原始功能規格要求

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-18 02:10:55 +08:00
鄭沛軒 76e95dbef2 feat: 實現互動式單字查詢系統，包含語法修正和高價值標記功能 
## 主要功能
- 智能語法錯誤檢測和修正建議（9種錯誤類型）
- 高價值詞彙標記系統（片語/俚語/中高級單字）
- 三色視覺區分：🟡高價值片語 🟢高價值單字 🔵普通單字
- 成本優化：高價值詞彙免費查詢，低價值詞彙按需收費
- 字數限制提升：50字→300字

## 技術實現
- 新增 ClickableTextV2 和 GrammarCorrectionPanel 組件
- 更新 Generate 頁面整合完整功能
- 完整的設計規格文檔（API、UI線框圖、功能規格）
- 多個演示頁面展示功能效果

## 成本效益
- 一次API調用，多次免費查詢
- 預估API成本降低80-95%
- 智能收費機制精準控制成本

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-09-17 19:57:08 +08:00