> methodology.md
हम कैसे मापते हैं
यह पृष्ठ वस्तुतः वह स्थान है जहाँ आप पढ़ सकते हैं कि Maguyva के गुणवत्ता और लागत संबंधी दावे किस आधार पर टिके हैं। यहाँ केवल तथ्य हैं: हम क्या मापते हैं, उसे कैसे आँकते हैं, और किस चीज़ का लेखा-परीक्षण किए होने का हम दिखावा नहीं करते।
अंतिम अपडेट: 2026-10। वर्तमान गणनाएँ स्रोत डेटा से पुनः उत्पन्न होती हैं; यह पृष्ठ माप के मॉडल को समझाता है। लिंक किया गया साक्ष्य रिकॉर्ड लागू fixture नियमों और पुराने, असत्यापित खोज लक्ष्यों के बीच अंतर स्पष्ट करता है।
- Fixture गेट
- language-audit के आयाम
- लागत पारदर्शिता
यह आपकी सुविधा के लिए AI की सहायता से किया गया अनुवाद है। केवल आधिकारिक अंग्रेज़ी संस्करण ही बाध्यकारी है — साइन अप करते समय आप जिस भी समझौते को स्वीकार करते हैं, उस पर अंग्रेज़ी पाठ लागू होता है। आधिकारिक अंग्रेज़ी संस्करण पढ़ें
tl;dr — गुणवत्ता की रिपोर्टिंग fixture वर्गीकरण और बहु-आयामी language-audit बोर्ड का उपयोग करती है। ज्ञात fixtures पर GREEN वर्गीकरण न तो स्वतंत्र रूप से सत्यापित सही निष्कर्षण है और न ही यह गारंटी कि हर सक्षम भाषा उन सीमाओं को पूरा करती है। लागत के दावे कार्यक्षेत्र मूल्य-निर्धारण की गणना और सार्वजनिक परिचालन-लागत पारदर्शिता हैं, न कि किसी तीसरे पक्ष का प्रतिस्पर्धी लेखा-परीक्षण।
1. यह पृष्ठ क्यों मौजूद है
खरीदारों को मार्केटिंग की भाषा का मतलब निकालने के लिए उलझना नहीं चाहिए। Maguyva रिपॉज़िटरी को इंडेक्स करता है और साइट पर परिशुद्धता, भाषा कवरेज और लागत के दावे प्रस्तुत करता है। उन दावों के साथ मापने की कार्यप्रणाली भी स्पष्ट होनी चाहिए: क्या फ़िक्स्चर से समर्थित है, क्या समीक्षक के आकलन से और क्या सिर्फ़ प्रस्तुति है, स्वतंत्र प्रमाणन नहीं।
2. हम क्या मापते हैं
कोड इंटेलिजेंस की गुणवत्ता मुख्यतः भाषा-इंजन पर मापी जाती है — स्रोत से सिंबलों, संबंधों और ग्राफ़ का निष्कर्षण — न कि व्यक्तिपरक “एजेंट संतुष्टि” अंकों पर।
- प्रति-भाषा fixture सुइट: अपेक्षित एज और सिंबल जिन्हें हैंडलर को सही ढंग से निकालना होता है
- Fixture सटीकता वर्गीकरण: GREEN के लिए परिशुद्धता ≥ 0.95, रिकॉल ≥ 0.99, F1 ≥ 0.97 और कम से कम 20 अपेक्षित एज आवश्यक हैं, साथ ही fixture चयन और रखरखाव की अतिरिक्त जाँचें भी लागू होती हैं। यह ज्ञात परीक्षण मामलों का नियम है, सांख्यिकीय विश्वास का अनुमान या यह कथन नहीं कि हर सक्षम भाषा GREEN है।
- language-audit के आयाम: सटीकता, संरचनात्मक अखंडता, पूर्णता, गुणवत्ता, और सत्यापन बोर्ड पर प्रदर्शन
- डेटा-संग्रह और स्पॉट-चेक लूप: वास्तविक रिपॉज़िटरी से नमूने के रूप में लिए गए एज, जिन्हें एक मानदंड द्वारा वर्गीकृत किया जाता है (सही, फ़ॉल्स पॉज़िटिव, प्रकार/दायरा/मेटाडेटा त्रुटि) — हमारी language-grind ब्लॉग पोस्ट में वर्णित
- उत्पाद क्षमता फ़्लैग: सर्वर क्या विज्ञापित करता है (AST, स्थानीय चर, ग्राफ़ निष्कर्षण) — कैटलॉग के आकार से अलग
महत्वपूर्ण: परीक्षण हमारे लिखे फ़िक्स्चर के आधार पर सत्यापन करते हैं। GREEN का मतलब है कि ज्ञात मामले पास होते हैं। इससे अपने-आप यह साबित नहीं होता कि वास्तविक कोड लिखने के हर तरीक़े से सही निष्कर्षण होगा। हम इस अंतर को जानबूझकर सार्वजनिक रूप से स्पष्ट करते हैं।
3. हरा बनाम स्वतंत्र रूप से सत्यापित
language-audit बोर्ड कई अक्षों का उपयोग करता है ताकि किसी एकल हरी बत्ती को “सिद्ध रूप से पूर्ण” न पढ़ा जा सके। बोर्ड पर मुख्य आँकड़े प्रायः इस प्रकार विभाजित होते हैं:
- overall_green — स्व-स्नैपशॉट fixtures और संबंधित डेटा-संग्रह गेट के विरुद्ध रिग्रेशन-मुक्त (आवश्यक, पर्याप्त नहीं)
- independently_verified — इसमें एक सशक्त निर्णय-संकेत होता है, जैसे स्पॉट-चेक सीड (उन भाषाओं सहित जिनमें अब भी आँकी गई त्रुटियाँ दिखती हैं)
- verified_clean / नमूना किए गए एज पर शून्य आँकी गई त्रुटि — आँकी गई भाषाओं का एक अधिक कठोर उपसमुच्चय
- curation / संदर्भ-मान विश्वास — क्या fixtures को स्वयं विश्वसनीय संदर्भ-मान के रूप में माना जाता है
- संरचनात्मक फ़्लैग — ग्राफ़ निष्कर्षण और AST क्षमता, कैटलॉग-सदस्यता के समान नहीं हैं
विपणन की भाषा-गणना (उदाहरण के लिए “285+ भाषाएँ”) कैटलॉग का आकार है: कॉन्फ़िगर की गई भाषाएँ और सर्वर प्रविष्टियाँ। कैटलॉग का आकार AST गुणवत्ता का SLA नहीं है। एक ही दिखावटी गिनती के बजाय स्तरीकृत रिपोर्टिंग को प्राथमिकता दें। वर्तमान उत्पाद-सतह के लिए, «संगतता» और «भाषा गाइड» देखें; कथात्मक विवरण के लिए, ब्लॉग पर भाषा-संबंधी पुनरावर्ती स्व-सुधार पोस्ट देखें।
4. खोज और पुनर्प्राप्ति की गुणवत्ता
सिमेंटिक खोज की गुणवत्ता बहु-प्रकारीय है: टेक्स्ट, AST, ग्राफ़ और एम्बेडिंग को संयोजित किया जाता है। हम अजेय पुनर्प्राप्ति का दावा करने के बजाय जानबूझकर किए गए इंजीनियरिंग समझौतों का दस्तावेज़ीकरण करते हैं:
- एम्बेडिंग एक वाणिज्यिक मॉडल परिवार का उपयोग करते हैं (जून 2026 के ब्लॉग स्नैपशॉट के अनुसार voyage-4-large), जिसे निर्णय के समय सार्वजनिक पुनर्प्राप्ति लीडरबोर्ड के विरुद्ध चुना गया था
- वेक्टर भंडारण और लागत हेतु बाइनरी-क्वांटाइज़्ड होते हैं; यह जानबूझकर कुछ पुनर्प्राप्ति परिशुद्धता का समझौता करके, बिना किसी अलग वेक्टर डेटाबेस के, सस्ती और तेज़ Hamming खोज देता है
- आशय के आधार पर रूटिंग और फ़्यूज़न के भार इंजीनियर किए गए ह्यूरिस्टिक हैं। दिसंबर 2025 के एक प्रस्ताव ने शून्य-परिणाम दर का अनुमानित आधार लगभग 15% रखा और 5% से नीचे का लक्ष्य तय किया; हमने उस कमी को प्रमाणित करने वाला प्रश्न-समूह या मापन रिकॉर्ड उपलब्ध नहीं कराया है। साक्ष्य रिकॉर्ड पहले किए गए सुधार हासिल होने के दावे को ठीक करता है।
- ब्लॉग पोस्ट में “अब भी क्या अपूर्ण है” खंड शामिल होते हैं — अपूर्ण संकेत रिकॉर्ड का हिस्सा हैं, छिपाने के लिए फुटनोट नहीं
5. लागत के दावे
Maguyva पर लागत संबंधी भाषा मूल्य-निर्धारण की संरचना और परिचालन-पारदर्शिता के बारे में है, न कि किसी तीसरे पक्ष द्वारा प्रमाणित औपचारिक TCO अध्ययन।
- वर्कस्पेस की कीमत: बिलिंग रिपॉज़िटरी, इंडेक्स की गई लाइनों और रीबिल्ड की आवृत्ति पर आधारित है—हर व्यक्ति या एजेंट के लिए अलग लाइसेंस शुल्क पर नहीं। FAQ और प्लान का विवरण इन आधारों को स्पष्ट करते हैं।
- कीमत का उदाहरण 25 सशुल्क यूज़र लाइसेंसों की तुलना करता है: प्रति लाइसेंस $19–$59 की उदाहरणात्मक कीमत बनाम $49/माह वाला Crew। बचत टीम के आकार और वैकल्पिक उत्पाद के अनुसार बदलती है; यह समान सुविधाओं की तुलना या स्वतंत्र प्रतिस्पर्धी बेंचमार्क नहीं है।
- परिचालन-लागत में ईमानदारी: /team पृष्ठ एक वास्तविक मासिक सॉफ़्टवेयर-व्यय विवरण प्रकाशित करता है (सदस्यताएँ, MCP/खोज टूलिंग, उपयोग-आधारित लागतें)। यह अपने ही उत्पाद का इस्तेमाल करने की पारदर्शिता है, न कि कोई लेखा-परीक्षित वित्तीय विवरण।
- एम्बेडिंग और अवसंरचना लागतें स्वीकृत उत्पाद-लागतें हैं (प्रीमियम एम्बेडिंग, भंडारण, ग्राफ़ पुनर्निर्माण)। हम इन्हें जानबूझकर वहन करते हैं और voyage-4-large पोस्ट तथा मूल्य-निर्धारण के विवरण में यह कहते हैं।
6. हम क्या दावा नहीं करते
यह पृष्ठ उन बातों की भी सूची है जिनका हम दावा नहीं करते। यदि कोई चीज़ माप-बोर्ड पर नहीं है, तो विपणन के लहजे को प्रमाण न मानें।
- हर भाषा के लिए कोई सर्वग्राही, निरपेक्ष-परिशुद्धता की गारंटी नहीं। fixture सीमाएँ प्रति भाषा ज्ञात मामलों पर लागू होती हैं; शेष वास्तविक-दुनिया त्रुटि अपेक्षित है और उसे कम करने पर लगातार काम किया जाता है।
- यह दावा नहीं कि overall_green का मतलब हर रिपॉज़िटरी में कोड लिखने के हर तरीक़े से प्रोडक्शन में बिल्कुल सही निष्कर्षण है
- इस पेज पर कार्यप्रणाली के प्रमाण के रूप में किसी तीसरे पक्ष के अनुपालन प्रमाणन पैकेज का दावा नहीं किया गया है (डेटा सँभालने के तथ्यों के लिए सुरक्षा पेज देखें, अनुपालन बैज के लिए नहीं)
- साझा डेटा-संग्रह के साथ कोई स्वतंत्र बहु-विक्रेता तुलना, जो एक स्थायी स्कोरकार्ड के रूप में प्रकाशित हो, नहीं
- खोज परिणाम और विश्लेषण सेवा-शर्तों के अंतर्गत सर्वोत्तम-प्रयास बने रहते हैं — Maguyva कोड समीक्षा, परीक्षण या सुरक्षा लेखा-परीक्षण का विकल्प नहीं है
7. स्वयं कैसे सत्यापित करें
खरीदार के लिए सुझाया गया तरीक़ा अब भी यही है: जिस रिपॉज़िटरी को आप पहले से समझते हैं उसे इंडेक्स करें, एक वास्तविक सवाल पूछें और जवाब में दिए स्रोत देखें।
- मुफ़्त शुरू करें: पहले ही दिन पूरी कंपनी के इंडेक्स से बेहतर छोटी, प्रतिनिधिक रिपॉज़िटरी हैं
- MCP टूल (intelligent_search, find_symbol, dependency_search) का उपयोग करें और उद्धृत पथ खोलें
- अंतर्ग्रहण और पुनर्प्राप्ति की वास्तुकला के लिए «यह कैसे काम करता है» पढ़ें
- क्षमता-स्तरों के लिए «संगतता» और «भाषा गाइड» पढ़ें, केवल कैटलॉग-आकार नहीं
- डेटा-संचालन के लिए «सुरक्षा» और «गोपनीयता» पढ़ें; यह पृष्ठ उनका स्थान नहीं लेता
- खोज गुणवत्ता के साक्ष्य और सुधार (अंग्रेज़ी)
- खोज गुणवत्ता के साक्ष्य (JSON, अंग्रेज़ी)
- यह कैसे काम करता है
- संगतता
- प्राइसिंग
- टीम
- सुरक्षा
- प्राइवेसी
- स्थिति
- भाषाओं के लिए पुनरावर्ती स्व-सुधार: लगभग 280 भाषाओं में कोड इंटेलिजेंस को अनथक मेहनत से निखारना
- हमने कोड सर्च को voyage-4-large में क्यों अपग्रेड किया