इस प्रोजेक्ट के बारे में

## अवलोकन GRE झेनकाओ 3000 एक शुद्ध फ्रंटएंड GRE शब्दावली शिक्षण प्रगतिशील वेब ऐप (PWA) है, जो GRE की तैयारी करने वाले उम्मीदवारों के लिए विशेष रूप से डिज़ाइन किया गया है। इसमें 《GRE झेनकाओ 3000 शब्द (अव्यवस्थित संस्करण)》 का पूरा शब्दकोश (कुल 3275 प्रविष्टियाँ, जिनमें चीनी अर्थ, ध्वन्यात्मक प्रतीक और अंग्रेजी उदाहरण वाक्य शामिल हैं) अंतर्निहित है, और एबिंगहॉस विस्मरण वक्र के अनुसार पुनरावृत्ति अंतराल निर्धारित करता है, जिससे उपयोगकर्ताओं को कुशलतापूर्वक शब्द याद करने में मदद मिलती है। ## मुख्य विशेषताएँ - **प्रतिदिन नए शब्द**: डिफ़ॉल्ट रूप से प्रतिदिन 100 नए शब्द सीखें, सेटिंग्स में समायोजित किया जा सकता है (50–150, चरण 10)। नए शब्द अव्यवस्थित शब्द सूची के क्रम में न सीखे गए शब्दों में से चुने जाते हैं। - **एबिंगहॉस अंतराल पुनरावृत्ति**: प्रत्येक कार्ड में 8 चरण (0–7) होते हैं, अंतराल 8 मिनट से 15 दिन तक भिन्न होता है, और उपयोगकर्ता के उत्तर प्रदर्शन के आधार पर ease कारक गतिशील रूप से समायोजित होता है (प्रारंभिक मान 2.5, सही उत्तर पर +0.1, गलत उत्तर पर −0.2), वास्तविक प्रतीक्षा समय = आधार अंतराल × (ease / 2.5)। - **पुनरावृत्ति प्रश्न प्रकार**: अंग्रेजी शब्द दिखाएँ, 4 चीनी अर्थों में से सही विकल्प चुनें (1 सही + 3 व्यवधान)। - **ऑफ़लाइन उपलब्ध**: शब्दकोश ऐप के साथ पैक है, पहली बार खोलने के बाद Service Worker ऐप शेल और शब्दकोश डेटा को कैश करता है, इसके बाद इंटरनेट बंद होने पर भी शब्द याद किए जा सकते हैं। - **PWA इंस्टॉल करने योग्य**: मोबाइल होम स्क्रीन पर जोड़ने का समर्थन करता है (iOS Safari / Android Chrome), स्वतंत्र विंडो में चलता है। - **डेस्कटॉप ऐप**: macOS इंस्टॉलेशन पैकेज (Electron पैकेजिंग) प्रदान करता है, स्थानीय रूप से Linux संस्करण भी बनाया जा सकता है। - **शॉर्टकट कुंजियाँ**: नए शब्द पृष्ठ पर स्पेस/एंटर से अर्थ खोलें, 1/2/3 क्रमशः नहीं जानता/अस्पष्ट/जानता है चिह्नित करें; पुनरावृत्ति पृष्ठ पर 1–4 से उत्तर चुनें, स्पेस/एंटर से अगला प्रश्न। ## इंटरफ़ेस और नेविगेशन नीचे चार प्रवेश द्वार: - **आज**: प्रगति डैशबोर्ड, दिन की अध्ययन स्थिति, लगातार चेक-इन दिनों की संख्या आदि दिखाता है। - **अध्ययन**: नए शब्द अध्ययन पृष्ठ, शब्द ऊपर, अर्थ डिफ़ॉल्ट रूप से संकुचित, कार्ड पर क्लिक करें या स्पेस दबाएँ तो खुलता है। नीचे तीन बटन: नहीं जानता, अस्पष्ट, जानता है। - **पुनरावृत्ति**: पुनरावृत्ति पृष्ठ, शब्द ऊपर, चार विकल्प लंबवत व्यवस्थित। - **शब्दकोश**: न सीखे, पुनरावृत्ति में, महारत हासिल के आधार पर फ़िल्टर करें, शब्द पर क्लिक करने पर ही अर्थ दिखता है। 7 दिन के स्तर में प्रवेश करने वाले शब्द महारत हासिल के रूप में दर्ज होते हैं। ## तकनीकी कार्यान्वयन - **फ्रंटएंड फ्रेमवर्क**: Vite पर आधारित, React का उपयोग (या समान फ्रेमवर्क, स्पष्ट रूप से नहीं बताया गया लेकिन आधुनिक फ्रंटएंड प्रथाओं के अनुरूप)। - **PWA समर्थन**: vite-plugin-pwa (Workbox) के माध्यम से Web App Manifest और Service Worker उत्पन्न करता है, ऑफ़लाइन कैशिंग और इंस्टॉल करने योग्यता प्राप्त करता है। - **डेटा भंडारण**: सभी अध्ययन प्रगति ब्राउज़र localStorage में संग्रहीत (कुंजी नाम gre3000.vocab.v1), बैकएंड सर्वर पर निर्भर नहीं। - **शब्दकोश पार्सिंग**: मूल शब्दकोश 《GRE झेनकाओ 3000 शब्द (अव्यवस्थित संस्करण)》 PDF से, Python स्क्रिप्ट (pymupdf) के माध्यम से तालिका पार्स करना, वॉटरमार्क हटाना, टूटी पंक्ति के शब्दों को जोड़ना, डुप्लिकेट हटाने के बाद JSON फ़ाइल उत्पन्न करना। ## उपयोग विधि ### ऑनलाइन उपयोग सीधे https://gre-3000-vocab.vercel.app पर जाएँ और सीखना शुरू करें। सर्वोत्तम अनुभव के लिए मोबाइल होम स्क्रीन पर जोड़ने की सिफारिश की जाती है। ### स्थानीय रूप से चलाना ```bash git clone https://github.com/jayden-dong411/gre-3000-vocab.git cd gre-3000-vocab npm install npm run dev ``` डेवलपमेंट सर्वर डिफ़ॉल्ट रूप से http://127.0.0.1:43173 पर चलता है। ### उत्पादन बिल्ड ```bash npm run build npm run preview ``` बिल्ड आउटपुट dist/ निर्देशिका में है, किसी भी स्टैटिक होस्ट पर तैनात किया जा सकता है। ### डेस्कटॉप ऐप GitHub Releases से macOS इंस्टॉलेशन पैकेज डाउनलोड करें, या स्थानीय रूप से `npm run desktop` चलाकर सीधे विंडो खोलें, `npm run pack:mac` / `npm run pack:linux` से पैकेज और वितरित करें। ## ध्यान देने योग्य बातें - डिवाइस बदलने पर अध्ययन प्रगति सिंक नहीं होगी (क्योंकि डेटा ब्राउज़र में स्थानीय रूप से संग्रहीत है)। - मोबाइल होम स्क्रीन पर इंस्टॉल करने के लिए HTTPS आवश्यक है (localhost को छोड़कर)। - macOS इंस्टॉलेशन पैकेज Apple द्वारा नोटराइज़्ड नहीं है, पहली बार खोलने पर सिस्टम द्वारा अवरुद्ध किया जा सकता है, टर्मिनल में `xattr -cr` कमांड चलाकर हटाना आवश्यक है। ## सारांश GRE झेनकाओ 3000 एक पूर्ण सुविधाओं वाला, अच्छी तरह से डिज़ाइन किया गया GRE शब्दावली शिक्षण उपकरण है, जो PWA की ऑफ़लाइन क्षमता और इंस्टॉल करने योग्य विशेषताओं का पूरा उपयोग करता है, साथ ही डेस्कटॉप ऐप समर्थन भी प्रदान करता है। इसका एबिंगहॉस पुनरावृत्ति एल्गोरिदम उपयोगकर्ता के उत्तर प्रदर्शन को ध्यान में रखता है, जो निश्चित अंतराल से अधिक लचीला है। शब्दकोश स्रोत स्पष्ट है, पार्सिंग प्रक्रिया पारदर्शी है। व्यवस्थित रूप से GRE शब्दावली रटने की आवश्यकता वाले उम्मीदवारों के लिए उपयुक्त है।