أخطاء llms.txt الشائعة
نُشر:
تندرج معظم مشكلات llms.txt ضمن حفنة من الأنماط. إليك تلك التي يرصدها المُحقِّق لدينا أكثر من غيرها — مع الإصلاح السريع لكلٍّ منها.
1. أكثر من عنوان H1 واحد
تنصّ المواصفة على وجود # Title واحد بالضبط على المستوى الأعلى. وتُربك عناوين # الإضافية البنية. اخفض رتبة بقيتها إلى عناوين أقسام ##.
2. غياب ملخّص الاقتباس
الاقتباس المكوّن من جملة أو جملتين أسفل العنوان مباشرةً هو السياق الذي يقرؤه النموذج أولًا. وتخطّيه هو الإغفال الأكثر شيوعًا على الإطلاق. أضِف واحدًا:
# Acme > Acme turns CSV files into charts. These links cover setup, the API, and pricing.
3. أقسام بلا روابط (أو غياب الأقسام)
لا تُضيف أقسام ## الفارغة شيئًا. ينبغي أن يحتوي كل قسم على قائمة نقطية بصيغة Markdown من الروابط إلى صفحات حقيقية. وإن لم تكن لديك أي أقسام على الإطلاق، فجمِّع صفحاتك الرئيسية تحت عناوين مثل ## Docs و## Guides.
4. الروابط المعطوبة
قد يكون الملف منسّقًا بشكل مثالي ومع ذلك يُشير إلى صفحات معطّلة — ما يهدر ميزانية زاحف ويُقوّض الثقة. يجب أن يُحلَّل كل عنوان URL بنجاح. هذا هو الفحص الذي تتخطّاه معظم الأدوات؛ أمّا نحن فنجلب كلًّا منها.
5. الروابط النسبية أو روابط http://
استخدم عناوين URL مطلقة بصيغة https:// في كل موضع. فقد لا تُحلِّل النماذج المسارات النسبية مثل /docs/start، كما تبدو روابط http:// العادية غير جديرة بالثقة وقد تتعطّل في ظل الزحف المقتصر على HTTPS.
6. نوع المحتوى الخاطئ
قدِّم الملف بنوع text/plain; charset=utf-8. وإن أعاد خادمك text/html (وهو خطأ شائع في الإعداد)، فلن يعامله بعض المستهلكين بوصفه llms.txt.
7. ملف متضخّم وغير منتقى
إنّ llms.txt فهرس منتقى، لا تفريغ لـ sitemap. فمئات الروابط دون أوصاف تطمر الإشارة. أبقِ على أفضل الصفحات، وأضِف : description قصيرًا بعد كلٍّ منها، وانقل الروابط الثانوية إلى قسم ## Optional.
التقطها كلها دفعةً واحدة
مرِّر ملفك عبر المُحقِّق — فهو يُقيّم البنية، وقابلية الوصول إلى الروابط، وأفضل الممارسات، ويُخبرك بالضبط بما عليك إصلاحه مما سبق. هل أنت جديد على الصيغة؟ ابدأ بـ كيفية إنشاء ملف llms.txt.