ما هو llms-full.txt؟ الملف المرافق للمحتوى الكامل

ما هو llms-full.txt؟

llms-full.txt هو ملف مصاحب لـ llms.txt الذي يحتوي على المحتوى الفعلي من الصفحات المشار إليها في llms.txt, مضمّمة معاً في مستند Markdown واحد. ويعيش في جذر نطاق: https://example.com/llms-full.txt.

إنها اتفاقية نشر يستخدمها بعض مزوّدي التوثيق، وليست تنسيقاً تحدده حالياً مسودة llmstxt.org V2. ويجب أن يدعمها العميل صراحةً أو يُضبط لاستهلاكها.

أين llms.txt هو الفهرس (جدول محتويات)، llms-full.txt هو المجموعة الكاملة، المحتوى الكامل القابل للقراءة، جاهز لإدخاله في نافذة سياق نموذج لغة كبير ضمن طلب HTTP واحد.

llms-full.txt مقابل llms.txt

يحل الملفان مشكلتين مختلفتين:

llms.txt (الفهرس). ملف Markdown قصير بعناوين أقسام وروابط منسّقة. حجمه صغير (عادةً من 1 إلى 10 كيلوبايت). يسهل صيانته. ويخبر عميل نموذج اللغة الكبير أي صفحات للقراءة. ويجب على العميل اتباع الروابط ثم جلب كل صفحة على حدة.
llms-full.txt (المجموعة). ملف Markdown أكبر يضمّن محتوى تلك الصفحات. وقد يتراوح حجمه بين 50 KB و5 MB أو أكثر وفق حجم التوثيق. ويحمّل العميل عنوان URL واحداً ويحصل على كل شيء دفعة واحدة، من دون حاجة إلى زحف إضافي.

يمكن أن يناسب نشر الملفين مواقع التوثيق الكثيفة ذات مسار استيعاب معروف: llms.txt للاكتشاف الخفيف، و llms-full.txt للعملاء المضبوطين صراحةً لتحميل المجموعة الكاملة.

بنية الملف

لا توجد مواصفة صارمة لـ llms-full.txt بما يتجاوز كونه Markdown صالحاً. والعرف الغالب (الذي أرساه Mintlify وتتبعه Anthropic وVercel وغيرهما) هو:

يبدأ كل ملف صفحة مدرج بعنوان URL الخاص به كعنوان من المستوى الثاني أو كرأس كتلة كود.
يتبع محتوى Markdown الكامل للصفحة مباشرةً في الأسفل.
خط أفقي (---) أو يفصل سطر فارغ بين الصفحات المتتالية.

مثال أدنى يتضمن صفحتين داخل الملف:

# example.com, full content\n\n## https://example.com/getting-started/\n\n# Getting started\n\nWelcome to Example. To install...\n\n---\n\n## https://example.com/api-reference/\n\n# API reference\n\nBase URL: https://api.example.com/v1...\n

من ينشره؟

الـ llms-full.txt شاع هذا العرف بفضل Mintlify, الذي ينشئ تلقائياً كلاً من llms.txt و llms-full.txt لكل موقع توثيق Anthropic ينشر واحداً في docs.anthropic.com/llms-full.txt، وهو بحجم عدة ميغابايت ويتضمن مرجع API الكامل والأدلة ووثائق النماذج بصيغة Markdown متسلسلة.

تُظهر نقطة نهاية Anthropic المتحقق منها أن الاتفاقية مستخدمة في الإنتاج. لكنها لا تثبت أن روبوت محادثة أو زاحفاً أو محرك بحث محدداً يستهلك الملف تلقائياً.

كيفية إنشاء llms-full.txt

هناك ثلاث طرق شائعة:

الإنشاء الثابت وقت البناء. اكتب سكربت بناء يقرأ مصادر Markdown نفسها التي يستخدمها موقعك، ويزيل العناصر الخاصة بـ HTML، ويدمجها في /public/llms-full.txt (أو دليل الإخراج المكافئ لإطارك). وهذا ما تفعله Mintlify ومعظم مولّدات المواقع الثابتة.
مسار خادم ديناميكي. بالنسبة إلى الأطر التي تدعم العرض من جهة الخادم، أنشئ مساراً في /llms-full.txt الذي يجلب محتواك وقت الطلب، ويدمجه، ويعيد استجابة نصية عادية. وهو أبطأ لكل طلب لكنه يبقى حديثاً دائماً.
صيانة يدوية. بالنسبة إلى المواقع الصغيرة، يمكنك صيانة llms-full.txt يدوياً: انسخ مصدر Markdown لصفحاتك الأساسية في ملف واحد وحدّثه عند تغيّر المحتوى. لا يتوسع هذا الأسلوب جيداً مع الوثائق الكبيرة، لكنه صالح تماماً لموقع من 5 صفحات.

متى تنشر llms-full.txt

انشر llms-full.txt إذا استوفى موقعك شرطاً واحداً على الأقل من هذه الشروط:

لديك توثيق تقني يسأل المطورون المساعدات الذكية عنه بانتظام.
ينتشر محتواك عبر صفحات كثيرة سيكلّف عميل نموذج اللغة الكبير جلبها واحدةً واحدة.
تريد أن يكون المحتوى قابلاً للاستخدام في مسارات RAG أو في تدفقات عمل وكلاء الذكاء الاصطناعي التي تتوقع مجموعة نصية ذات عنوان URL واحد.
أنت مزود SaaS أو API قد يطرح مستخدموه أسئلة برمجية على Cursor أو Windsurf أو أدوات مشابهة.

إذا كان موقعك يضم أقل من 10 صفحات ذات محتوى مفيد، فإن ملفاً مصاناً جيداً llms.txt وحده كافٍ على الأرجح. أما المساحة الإضافية التي يشغلها llms-full.txt يثبت جدواه عند التوسع في التوثيق.

التحفظات والمقايضات

حجم الملف. llms-full.txt قد يصبح كبيراً جداً. وقد ينتج موقع توثيق من 500 صفحة ملفاً يتجاوز 10+ MB، وهو ما يتجاوز نافذة سياق معظم نماذج اللغة الكبيرة الحالية. فكّر في تضمين الصفحات ذات الإشارة الأعلى فقط بدلاً من الموقع الكامل.
عبء الصيانة. بخلاف llms.txt (الذي لا يحتوي إلا على روابط)، llms-full.txt يكرر المحتوى. وإذا تغيرت الصفحات من دون محفّز إعادة بناء، يصبح الملف متقادماً. أتمت خطوة التوليد.
لا يوجد مخطط موحّد. بخلاف llms.txt, الذي يملك بنية محددة في llmstxt.org, llms-full.txt تنسيقاً متعارفاً عليه في المجتمع من دون مواصفة رسمية. نظّم ملفك بوضوح حتى يتمكّن أي عميل من تحليله.
الإتاحة العامة. كل ما في llms-full.txt عام بحكم التعريف. لا تدرج محتوى ما كنت لن تنشره بخلاف ذلك على عنوان URL عام.

واصل القراءة

ما هو llms.txt, ابدأ هنا إذا كنت جديداً على الاتفاقية.
كيفية إنشاء llms.txt (وllms-full.txt), وقوالب وأدلة لكل حزمة تقنية.
مقارنة: llms.txt مقابل robots.txt مقابل sitemap.xml، ومتى تستخدم كل ملف.
المدقّق، وطابق ملف llms.txt لديك مع المواصفة.