- [ الرئيسية ](/ar/) / - ما هو llms-full.txt # ما هو llms-full.txt؟ ملف مرافق يضمّ وثائقك الكاملة في عنوان URL واحد، حتى تتمكن نماذج اللغة الكبيرة من تحميلها كلها في طلب واحد. آخر تحديث: 25 أغسطس 2026 في هذه الصفحة - [ ما هو llms-full.txt؟ ](#definition) - [ llms-full.txt مقابل llms.txt ](#vs-llms-txt) - [ بنية الملف ](#structure) - [ من ينشره؟ ](#who-uses-it) - [ كيفية إنشاء واحد ](#how-to-create) - [ متى تنشر llms-full.txt ](#when-to-use) - [ التحفظات والمفاضلات ](#caveats) ## ما هو llms-full.txt؟ **`llms-full.txt`** هو ملف مصاحب لـ [`llms.txt`](/ar/what-is-llms-txt/) الذي يحتوي على *المحتوى الفعلي* من الصفحات المشار إليها في `llms.txt`, مضمّمة معاً في مستند Markdown واحد. ويعيش في جذر نطاق: `https://example.com/llms-full.txt`. إنها اتفاقية نشر يستخدمها بعض مزوّدي التوثيق، وليست تنسيقاً تحدده حالياً مسودة llmstxt.org V2. ويجب أن يدعمها العميل صراحةً أو يُضبط لاستهلاكها. أين `llms.txt` هو *الفهرس* (جدول محتويات)، `llms-full.txt` هو *المجموعة الكاملة*، المحتوى الكامل القابل للقراءة، جاهز لإدخاله في نافذة سياق نموذج لغة كبير ضمن طلب HTTP واحد. مثال نسخة في جملة واحدة llms.txt هي الخريطة. llms-full.txt هو النطاق. ## 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](https://platform.claude.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 صفحات. ملاحظة Astro وNext.js في Astro، يوجد llms-full.txt.ts نقطة نهاية في src/pages/ باستخدام getStaticPaths و Astro.glob() يمكنه إنشاء الملف وقت البناء. وفي Next.js App Router، يمكن لـ app/llms-full.txt/route.ts يعمل معالج المسار بالطريقة نفسها. راجع دليل كيفية الإنشاء لأمثلة خاصة بالأطر. ## متى تنشر 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](https://llmstxt.org/), `llms-full.txt` تنسيقاً متعارفاً عليه في المجتمع من دون مواصفة رسمية. نظّم ملفك بوضوح حتى يتمكّن أي عميل من تحليله. - **الإتاحة العامة.** كل ما في `llms-full.txt` عام بحكم التعريف. لا تدرج محتوى ما كنت لن تنشره بخلاف ذلك على عنوان URL عام. ## واصل القراءة - [ما هو llms.txt](/ar/what-is-llms-txt/), ابدأ هنا إذا كنت جديداً على الاتفاقية. - [كيفية إنشاء llms.txt (وllms-full.txt)](/ar/how-to-create/), وقوالب وأدلة لكل حزمة تقنية. - [مقارنة: llms.txt مقابل robots.txt مقابل sitemap.xml](/ar/comparison/)، ومتى تستخدم كل ملف. - [المدقّق](/ar/validator/)، وطابق ملف llms.txt لديك مع المواصفة. ## المصادر - [ llmstxt.org، اقتراح v2 الحالي (لا يعرّف llms-full.txt) ](https://llmstxt.org/) - [ توثيق Anthropic، مثال llms-full.txt ](https://platform.claude.com/llms-full.txt) - [ Mintlify، عمّمت اصطلاح llms-full.txt ](https://www.mintlify.com/)