أخطاء مدقّق llms.txt: هل نرفض أم نحذّر؟

بموجب اقتراح v2، لا يوجد قسم مطلوب سوى مشروع H1 أو اسم الموقع. وينبغي لأداة التحقق رفض H1 المفقود أو المشوه وصياغة رابط قائمة الملفات المكسورة. ولا ينبغي لها اعتبار ملخص مفقود أو عنوان URL نسبي أو ملف كبير غير صالح، إلا إذا عرّفت قواعدها المنشورة ملفًا أكثر صرامة بوضوح.

أهم النقاط

• تحتاج الصيغة المطلوبة والتوجيه التحريري إلى درجتي خطورة مختلفتين.
• استخدمت 90 من أصل 113 استجابة مقاسة تبدأ بـH1 ملخصًا على شكل اقتباس، وتوضح الاستجابات الـ23 الأخرى أن شيوع ذلك ليس شرطًا.
• تجعل رموز القواعد القابلة للقراءة آليًا سلوك CI قابلًا للتدقيق.

ما الذي ينبغي أن يكون خطأً؟

ينبغي أن تحدد الأخطاء محتوى لا يستطيع المحلل تفسيره وفقًا للاقتراح. ومن أمثلتها الملف الفارغ، أو أن يكون أول سطر ذي معنى ليس H1، أو وجود H1 إضافي، أو أن تكون إحدى خانات قائمة الملفات ليست رابط Markdown.

تهم أرقام الأسطر ورموز القواعد المستقرة. فـH1_REQUIRED قابل للتنفيذ، أما «ملفك سيئ» فليس كذلك. وينبغي لمهمة CI أن تنتهي بحالة غير صفرية فقط بسبب أخطاء موثقة، لا بسبب تفضيل أسلوبي ذاتي.

ما الذي ينبغي أن يبقى تحذيراً؟

ملخص الاقتباس اختياري، وكذلك المقدمة التفسيرية وأقسام H2 والملاحظات بعد الروابط وقسم Optional. وقد توصي أداة التحقق بها حيث تحسن الفهم، لكنها لا ينبغي أن تعيد كتابة الاقتراح.

تستحق عناوين URL النسبية تحذيرًا لأنها قد تكون ملتبسة خارج سياقها الأصلي، مع أن v2 لا يجعل عناوين URL المطلقة الشكل الوحيد الممكن نحويًا. وحجم الملف سياقي أيضًا. فقد تكون خريطة وثائق كبيرة مقصودة حتى عندما يكون الملف الأصغر والمنظم أسهل استهلاكًا.

كيف تبدو ملفات الإنتاج؟

تتضمن لقطة دليلنا 113 ملفًا يعيد نصًا ويبدأ بـH1. وتستخدم تسعون منها ملخص اقتباس. ويحتوي الوسيط على 7 أقسام H2 و76 رابط قائمة محللًا، بينما تراوحت أعداد الأقسام المرصودة بين 0 و84.

توضح هذه التوزيعات سبب عدم الخلط بين الشيوع والصلاحية. فالميزة الشائعة ليست مطلوبة تلقائيًا، والبنية غير الشائعة المسموح بها ليست خاطئة تلقائيًا. افحص الأمثلة الحقيقية بجوار القواعد الرسمية.

سياسة شفافية للخطورة

انشر القواعد الدقيقة ودرجة خطورتها وإصدار المواصفة. وافصل بين ثلاث طبقات:

1. أخطاء: لا يستطيع المحلل إنشاء البنية المطلوبة.
2. تحذيرات: قد يقلل المحتوى المسموح به من قابلية النقل أو الوضوح.
3. معلومات: ملاحظات تشغيلية مثل الحجم أو علاقات الاكتشاف المفقودة.

استخدم أداة التحقق المجانية لرؤية التشخيصات على مستوى السطر، ثم طبّق دليل أفضل الممارسات على الخيارات التي لا يستطيع مدقق الصياغة حسمها.

يحدد مرجع الصيغة القواعد، بينما توضح الأمثلة المتحقق منها تنوع ملفات الإنتاج.

هل يكون غياب الاقتباس غير صالح؟

لا. فهو اختياري في v2، وإن كان مفيدًا غالبًا.

هل يكون الملف الذي يتجاوز حجمه 50 كيلوبايت غير صالح؟

لا يظهر في الاقتراح حد أقصى عالمي. وقد يستدعي الحجم مراجعة معلوماتية، لا خطأً نحويًا مختلقًا.

هل يمكن أن يكون الملف الصالح رديئًا؟

نعم. لا تستطيع الصياغة تحديد ما إذا كانت الصفحات المختارة حديثة أو ذات صلة أو آمنة.