> methodology.md
كيف نقيس
هذه الصفحة هي المكان الحرفي لقراءة كيفية إسناد ادعاءات الجودة والتكلفة الخاصة بـ Maguyva إلى أدلة. إنها حقائق فقط: ما الذي نقيسه، وكيف نُقيّمه، وما الذي لا ندّعي زوراً أننا دقّقناه.
سارية اعتباراً من 17 يوليو 2026. لا تُختلَق هنا أي معايير قياس جديدة غير مُدقَّقة. الأعداد الحالية موجودة على واجهات المنتج التي تُعاد توليدها من البيانات المصدرية؛ وتشرح هذه الصفحة نموذج القياس.
هذه ترجمة بمساعدة الذكاء الاصطناعي مُقدَّمة لراحتك. النسخة الإنجليزية الرسمية هي الوحيدة المُلزِمة — أي اتفاق تدخل فيه عند التسجيل يخضع للنص الإنجليزي. اقرأ النسخة الإنجليزية الرسمية
tl;dr — ترتكز ادعاءات الجودة على بوابات إصدار قائمة على الاختبارات (fixtures) وعلى لوحات language-audit متعددة الأبعاد — لا على إثبات وحيد بـ«دقّة 100٪». اجتياز الاختبارات (fixtures) لا يعني استخراجاً صحيحاً مُتحقَّقاً منه بصورة مستقلة. أمّا ادعاءات التكلفة فهي حسابات تسعير مساحة العمل وشفافية علنية لتكاليف التشغيل، وليست تدقيقاً تنافسياً من طرف ثالث.
1. لماذا توجد هذه الصفحة
لا ينبغي أن يضطر المشترون المتشكّكون إلى تفكيك النصوص التسويقية عكسياً لفهمها. تُفهرِس Maguyva المستودعات وتَعرِض ادعاءات الدقّة وتغطية اللغات والتكلفة عبر الموقع. وتحتاج تلك الادعاءات إلى واجهة منهجية صادقة بشأن نطاق القياس: ما المدعوم بالاختبارات (fixtures)، وما المدعوم بحكم بشري، وما هو مجرّد صياغة لا شهادة مستقلة.
2. ماذا نقيس
تُقاس جودة ذكاء الكود في المقام الأول على محرّك اللغات — أي استخراج الرموز والعلاقات والرسوم البيانية من الشيفرة المصدرية — لا على درجات ذاتية لـ«رضا الوكيل».
- مجموعات اختبارات (fixtures) لكل لغة: الحواف والرموز المتوقّعة التي يجب على المعالِج استخراجها بشكل صحيح
- بوابات الإصدار: لا تُطرَح اللغات إلا عندما تتجاوز دقّة الاختبارات (fixtures) والاستدعاء وF1 العتبات المنشورة (الدقّة ≥ 0.95، الاستدعاء ≥ 0.99، F1 ≥ 0.97 على الاختبارات، مع حدّ أدنى لعدد الحواف لضمان الثقة الإحصائية)
- أبعاد language-audit: الدقّة، والسلامة البنيوية، والاكتمال، والجودة، والأداء على لوحة التحقّق
- حلقات المُدوّنة النصية والفحص العشوائي: حواف مأخوذة كعيّنات من مستودعات حقيقية ومُصنَّفة وفق معيار (صحيحة، إيجابية كاذبة، خطأ في النوع/النطاق/البيانات الوصفية) — موصوفة في منشورات مدوّنتنا حول language-grind
- أعلام قدرات المنتج: ما يُعلن عنه الخادم (AST، والمتغيّرات المحلية، واستخراج الرسم البياني) بمعزل عن حجم الكتالوج
مهم: الاختبارات (fixtures) تتحقّق في مقابل اختبارات كتبناها نحن. «الأخضر» يعني اجتياز الحالات المعروفة. ولا يعني تلقائياً أن كل نمط واقعي يُستخرَج بنقاء. هذا التمييز متعمَّد ومُعلَن.
3. الأخضر مقابل المُتحقَّق منه بصورة مستقلة
تستخدم لوحة language-audit عدّة محاور بحيث لا يمكن قراءة ضوء أخضر واحد على أنه «مثالية مُثبَتة». وعادةً ما تُقسَّم الأرقام الرئيسية على اللوحة إلى:
- overall_green — خالٍ من التراجعات في مقابل اختبارات (fixtures) اللقطة الذاتية وبوابات المُدوّنة ذات الصلة (شرط ضروري لا كافٍ)
- independently_verified — يملك إشارة حكم قوية مثل بذرة فحص عشوائي (يشمل لغات لا تزال تُظهِر أخطاءً مُقيَّمة)
- verified_clean / صفر خطأ مُقيَّم على الحواف المأخوذة كعيّنات — مجموعة فرعية أكثر صرامة من اللغات المُقيَّمة
- التنسيق / الثقة بالمرجع — ما إذا كانت الاختبارات (fixtures) نفسها تُعامَل كمراجع موثوقة
- الأعلام البنيوية — استخراج الرسم البياني وقدرة AST ليسا مطابقين للانتماء إلى الكتالوج
عدد اللغات في التسويق (مثل «279+ لغة») هو حجم الكتالوج: اللغات المُهيّأة ومُدخلات الخادم. وحجم الكتالوج ليس اتفاقية مستوى خدمة (SLA) لجودة AST. نُفضِّل التقارير المتدرّجة على عددٍ استعراضي وحيد. لمعرفة واجهة المنتج الحالية، راجع «التوافق» و«أدلة اللغات»؛ وللتفاصيل السردية، راجع منشور التحسين الذاتي التكراري للغات على المدوّنة.
4. جودة البحث والاسترجاع
جودة البحث الدلالي متعدّدة الأنماط: يُدمَج النص، وAST، والرسم البياني، والتضمينات. ونوثّق المقايضات الهندسية المتعمَّدة بدلاً من ادعاء استرجاع لا يُبارى:
- تستخدم التضمينات عائلة نماذج تجارية (voyage-4-large وفق لقطة مدوّنة يونيو 2026) اختِيرت في مقابل لوحات صدارة الاسترجاع العامة وقت اتخاذ القرار
- تُكمَّم المتجهات ثنائياً لأجل التخزين والتكلفة؛ وهذا يقايض عمداً بعض دقّة الاسترجاع مقابل بحث Hamming أرخص وأسرع دون قاعدة بيانات متجهات منفصلة
- توجيه النيّة وأوزان الدمج استدلالات مُهندَسة ذات آثار تشغيلية مقيسة (مثل انخفاض معدّلات النتائج الصفرية بعد توجيه النيّة)، وليست مجموعة تقييم استرجاع معلومات (IR) مستقلة منشورة على مُدوّنات العملاء
- تتضمّن منشورات المدوّنة أقسام «ما لا يزال غير مثالي» — فالإشارات الناقصة جزء من السجلّ، لا هوامش لإخفائها
5. ادعاءات التكلفة
لغة التكلفة في Maguyva تتعلّق ببنية التسعير وشفافية التشغيل، لا بدراسة رسمية لإجمالي تكلفة الملكية (TCO) مُعتمَدة من طرف ثالث.
- تسعير مساحة العمل: تُحتسَب الفاتورة حسب المستودعات، والأسطر المُفهرَسة، وتواتر إعادة البناء — لا حسب مقعد بشري أو مقعد وكيل. وتوضّح الأسئلة الشائعة ونصوص الخطط هذه الأبعاد.
- مقارنات من نوع «أقل بنحو 10–30 ضعفاً» على صفحة التسعير هي حسابات توضيحية في مقابل نطاقات نموذجية لسعر المقعد، بحسب الأداة المُسعَّرة بالمقعد التي تقارنها. وهي ليست حزمة معايير تنافسية مستقلة ومُثبَّتة.
- صدق تكلفة التشغيل: تنشر صفحة /team تفصيلاً شهرياً حقيقياً لإنفاق البرمجيات (الاشتراكات، وأدوات MCP/البحث، والتكاليف المرتبطة بالاستخدام). وذلك شفافية «العميل رقم صفر»، لا بياناً مالياً مُدقَّقاً.
- تكاليف التضمين والبنية التحتية تكاليف منتج مقبولة (تضمينات متميّزة، وتخزين، وإعادات بناء الرسم البياني). ندفعها عن قصد ونقول ذلك في منشور voyage-4-large وفي سرد التسعير.
6. ما لا ندّعيه
هذه الصفحة أيضاً قائمة بما لا ندّعيه. إن لم يكن الأمر مذكوراً على لوحة القياس، فلا تعامل النبرة التسويقية كدليل.
- لا ضمان مُطلَق شامل للدقّة لكل لغة. تُطبَّق عتبات الاختبارات (fixtures) لكل لغة على الحالات المعروفة؛ والخطأ الواقعي المتبقّي متوقَّع ومُعلَن.
- لا ادعاء بأن overall_green يساوي استخراجاً مثالياً في الإنتاج لكل نمط في المستودعات
- لا حزمة شهادات امتثال من طرف ثالث يُدّعى أنها أثر منهجي على هذه الواجهة (راجع «الأمان» للاطّلاع على حقائق التعامل مع البيانات، لا على شارات امتثال)
- لا مقارنة تنافسية مستقلة بين عدّة مورّدين على مُدوّنات مشتركة تُنشَر كبطاقة نتائج دائمة
- تظلّ نتائج البحث والتحليل بذل أفضل جهد وفق شروط الخدمة — Maguyva ليست بديلاً عن مراجعة الشيفرة أو الاختبار أو تدقيقات الأمان
7. كيف تتحقّق بنفسك
لا تزال الحركة المقصودة للمشتري هي: افهرِس مستودعاً تفهمه أصلاً، واطرح سؤالاً حقيقياً واحداً، وافحص الاستشهادات.
- ابدأ مجاناً: المستودعات الصغيرة التمثيلية أفضل من فهرسة الشركة بأكملها في اليوم الأول
- استخدم أدوات MCP (intelligent_search، find_symbol، dependency_search) وافتح المسارات المُستشهَد بها
- اقرأ «كيف يعمل» للاطّلاع على بنية الإدخال والاسترجاع
- اقرأ «التوافق» و«أدلة اللغات» لمعرفة مستويات القدرات، لا حجم الكتالوج فقط
- اقرأ «الأمان» و«الخصوصية» لمعرفة التعامل مع البيانات؛ فهذه الصفحة لا تحلّ محلّهما