- [ الرئيسية ](/ar/) / - أفضل الممارسات # أفضل الممارسات عشر قواعد، والأخطاء التي نراها غالباً، وأنماط عملية للتدويل والأمن وCI. آخر تحديث: 12 أغسطس 2026 في هذه الصفحة - [ عشر قواعد ](#rules) - [ الأخطاء الشائعة ](#mistakes) - [ مواقع متعددة اللغات ](#i18n) - [ الأمن والخصوصية ](#security) - [ الأتمتة في CI ](#automation) ## عشر قواعد ملاحظة الإصدار 2، نُشر في 10 أغسطس 2026 يدعم الاقتراح الآن الملفات في أي مسار، وبدائل Markdown على مستوى الصفحة، و describedby علاقة. استخدم الملف المنطبق ذي المسار الأكثر تحديداً للصفحة. هذه اتفاقيات لاكتشاف الوكلاء، وليست إشارات لترتيب Google. - **نقِّ المحتوى.** تتفوق قائمة قصيرة من الصفحات عالية الإشارة على قائمة طويلة من الصفحات المتوسطة. وقد تكون عشرة إلى ثلاثين وصلة نقطة بداية عملية، لكن عددها ينبغي أن تحدده المهام المقصودة. - **استخدم عناوين URL مطلقة.** دائماً `https://yourdomain.com/...`. عناوين URL النسبية مسموحة تقنياً لكنها هشة. - **جمّع حسب سطح المنتج.** أقسام مثل *المنتج*, *الأسعار*, *المطوّرون* تعكس طريقة تفكير المستخدم (وLLM). تجنب فئات المدونة/الوثائق/الأدلة ما لم تتوافق مع التنقل الفعلي في موقعك. - **أبقِ الملخص واقعياً.** ينبغي أن تبدو فقرة الاقتباس بعد العنوان H1 مثل افتتاحية Wikipedia، لا مثل واجهة دعائية لصفحة هبوط. - **جملة واحدة لكل عنصر.** ملاحظة النقطتين مخصّصة لإزالة الالتباس، لا للتسويق. - **استخدم `Optional` استخدم الوسم باعتدال.** إنه موضع تحريري واضح للصحافة وأصول العلامة التجارية والأرشيف، لكن V2 لا يمنحه دلالات آلية خاصة. - **اعكس عناوين URL المستقرة لديك.** إذا كانت صفحة في `llms.txt` ينقلها أو يحدّثها أو يعيد توجيهها. وعناوين URL القديمة تفسد سمعة الملف. - **انشر `llms-full.txt` فقط لحاجة استيعاب محددة.** يمكن للتوثيق الموحّد مساعدة مستهلك معروف، لكنه يزيد أيضاً تكاليف الحجم والحداثة والأمن. - **شغّل [المدقّق](/ar/validator/) في CI.** يجب أن يفشل البناء إذا أدت عملية ترحيل للمحتوى إلى كسر ملفك. - **أرّخ ملفك.** ملاحظة قصيرة مثل *«آخر مراجعة في 2026-04-01»* يفيد وجوده في النص لكل من البشر والزواحف. ## الأخطاء الشائعة - **لا يوجد H1.** العنصر الإلزامي الوحيد هو H1. ومن دونه يكون الملف غير صالح. - **عناوين H1 متعددة.** استخدم H2 للأقسام. ويجب أن يكون هناك H1 واحد بالضبط. - **مقدمة مخصصة.** تقع رؤوس YAML وJSON خارج قواعد الصياغة المنشورة، وقد تجعل المحللات المطابقة ترفض الملف أو تسيء قراءته. - **جداول Markdown أو صور ملصقة.** أبقِ المقدمة مركزة، واستخدم قوائم الروابط داخل أقسام H2. فالبنى الزائدة تزيد غموض التحليل، وغالباً ما تكرر الصفحات المرتبطة. - **تضمين عناوين URL المحمية بالمصادقة.** إذا كانت الصفحة تتطلب تسجيل الدخول، فلا تسردها؛ سيصل نموذج اللغة الكبير إلى طريق مسدود. - **أوصاف طويلة أكثر من اللازم.** عبارة «المنصة الأكثر تقدماً في العالم والمدعومة بالذكاء الاصطناعي للتحول التآزري للجيل القادم» لا تفيد أحداً. أبقِ كل ملاحظة بالقدر اللازم فقط لتمييز الوجهة. - **إدراج 500 عنوان URL بلا نطاق.** أعد فحص المهام، وقسّم حدود المحتوى الفعلية إلى ملفات على مستوى المسار، أو وفّر مورداً منفصلاً للمحتوى الكامل لمستهلك معروف. - **حجب المورد عن غير قصد.** تأكد من أن كل ملف معلن في الجذر أو على مستوى المسار قابل للوصول وفق سياسة الزحف التي تقصدها. تحذير نمط مضاد: استخدام llms.txt لحقن SEO لا يفيد حشو الملف بملاحظات غنية بالكلمات المفتاحية. ولا دليل على أن أي نموذج لغة كبير رئيسي يستخرج كثافة الكلمات المفتاحية من llms.txt . كما يبدو منخفض الجودة لأي شخص يجلب الملف مباشرةً. ## مواقع متعددة اللغات لا تفرض المواصفة المقترحة بنية واحدة للتدويل. ويشيع خياران: - **ملف واحد للغة الافتراضية في الجذر.** الخيار الأبسط عندما تتشارك الموارد المسردة والمستهلكون المقصودون لغة واحدة. - **نسخ خاصة بكل لغة.** قدّم `/llms.txt` (افتراضي)، `/fr/llms.txt`, `/es/llms.txt`. اربط بها من نص ملف الجذر لديك أو تحت *اختياري* القسم، أو صرّح بالملف المنطبق باستخدام `rel="describedby"` في الصفحات المحلية. أي نمط تختاره، لا تكرر مجموعات عناوين URL عبر اللغات: يجب أن يشير كل بديل إلى النسخة المترجمة من كل صفحة. ## الأمن والخصوصية - **كل ما في `llms.txt` عام.** تعامل مع الملف كإذاعة عامة. - **لا تُدرج أبداً عناوين URL للتجهيز أو المعاينة.** يمكن لأي عميل يجلب الملف العام رؤيتها. - **لا تدرج عناوين URL التي تحتوي على أسرار في سلاسل الاستعلام.** قد يبدو هذا بديهياً؛ لكننا رأيناه يحدث. - **إذا كانت الصفحة تعرض بيانات مستخدمين خلف المصادقة، فلا مكان لها هنا.** - **افحص الملف عند كل إصدار.** عنوان URL لمسودة مسرّبة هو أكثر أخطاء الأمن شيوعاً. تعامل مع الملف كإعداد خارجي، من دون افتراض أن الوكلاء يطيعونه. وفي تحليل Ahrefs لـ 137,210 نطاقاً، كان أكبر وكيل مستخدم في فئة البحث هو `prompt-injection-survey/1.0`. ولا تثبت تلك التسمية هجوماً ولا مشغّله، لكنها تذكير مفيد بإبقاء المحتوى واقعياً ومراجعة التغييرات وتقييد أي وكيل مستهلك. ## الأتمتة في CI تعامل مع `llms.txt` مثل أي أثر آخر: أنشئه، وتحقّق منه، واربط إصداراتك باجتيازه. - أنشئه من مصدر محتواك (CMS أو مجموعة MDX أو قاعدة البيانات). - شغّل [المدقّق](/ar/validator/) في CI؛ وافشل البناء عند أي خطأ. - قارن الملف عبر الإصدارات، ونبّه مالك الوثائق عند وجود عمليات حذف كبيرة. - اختبر عنوان URL الإنتاجي اختباراً سريعاً بعد النشر: `curl -fsS https://yourdomain.com/llms.txt | head -1`. ## Next - [الفوائد والقيود](/ar/benefits-limitations/)، وما ينبغي توقعه وما لا ينبغي توقعه. - [أمثلة من العالم الحقيقي](/ar/examples/)، انسخ ما ينجح. - [المدقّق](/ar/validator/). ## المصادر - [ llmstxt.org، اقتراح المجتمع ](https://llmstxt.org/) - [ Ahrefs: حلّلنا 137 ألف موقع، و97% من ملفات llms.txt لم تُقرأ قط (يونيو 2026) ](https://ahrefs.com/blog/llmstxt-study/)