هل يُفسد llms.txt v2 ملفي الحالي؟

لا. صيغة الملف لم تتغيّر — فالملف المتوافق مع v1 متوافق مع v2. التغييرات تتعلّق بقابلية الاكتشاف (علاقات الروابط) ودلالة المسارات الفرعية وتوقّعات الأدوات، لا ببنية Markdown.

ما الغرض من rel="describedby" في llms.txt v2؟

يشير من صفحة إلى ملف llms.txt الذي يغطّيها، حتى لا يضطرّ الوكيل إلى تخمين العنوان. يمكن أن يكون عنصر في HTML أو ترويسة استجابة HTTP باسم Link:، وصيغة الترويسة تعمل أيضًا مع الملفات غير HTML.

هل يمكن أن يوجد llms.txt في غير جذر الموقع؟

نعم، وتعرّف v2 معنى ذلك: الملف يغطّي الصفحات الواقعة تحت مساره، وإذا انطبق عدد منها فإن الوكلاء يستخدمون الأكثر تحديدًا. أي أن /docs/llms.txt يغطّي كل ما تحت /docs/.

هل لا يزال llms_txt2ctx جزءًا من المواصفة؟

لا. أزالت v2 أدوات توسيع السياق، وأزالت معها المعنى الآلي لقسم «Optional». ولا تزال أقسام Optional مسموحة كعُرف للروابط الثانوية.

هل llms-full.txt موجود في المواصفة؟

لا — ولم يكن موجودًا في أي من الإصدارين. إنه ممارسة صناعية شائعة لمجموعات التوثيق الكبيرة: مفيدة لكنها غير مطلوبة.

الدليل

llms.txt v2: ما الذي تغيّر

نُشر: 2026-08-31

خضع مقترح llms.txt للمراجعة في أغسطس 2026، بعد نحو عامين من النسخة الأصلية. صيغة الملف نفسها لم تتغيّر — فالملف المكتوب وفق v1 لا يزال ملفًا صالحًا وفق v2. الذي تغيّر هو كل ما يحيط بالملف: كيف تجده الوكلاء، وأي أدوات تتوقّعها المواصفة.

الصيغة لم تتغيّر

البنية المطلوبة هي ذاتها تمامًا: علامة BOM اختيارية، وعنوان H1 يحمل اسم المشروع (ولا يزال العنصر الإلزامي الوحيد)، وملخّص في اقتباس، ونص اختياري بلا عناوين، ثم صفر أو أكثر من أقسام H2 تحتوي قوائم روابط بصيغة Markdown. إن كان ملفك يحصل على 100 وفق v1، فسيظل يحصل على 100.

١. علاقات روابط تُغني الوكلاء عن التخمين

هذه هي الإضافة الجوهرية، وهي إجابة على أكثر طلب تكرارًا خلال عامين من التبنّي: إذا كانت لدينا صفحة، فكيف يجد الوكيل نسختها بصيغة Markdown، أو ملف llms.txt الذي يغطّيها، دون تخمين العناوين؟

تجيب v2 بعلاقتَي روابط معياريتين:

rel="describedby" — تشير إلى ملف llms.txt الذي يغطّي هذه الصفحة.
rel="alternate" type="text/markdown" — تشير إلى نسخة هذه الصفحة بصيغة Markdown.

كلتاهما يمكن أن تكون عنصر <link> في HTML:

<link rel="describedby" href="/llms.txt">
<link rel="alternate" type="text/markdown" href="/docs/page.html.md">

… أو ترويسة استجابة HTTP، وهي الخيار الوحيد للموارد غير HTML مثل ملفات Markdown نفسها، ويمكن ضبطها في إعدادات خادم الويب أو شبكة التوصيل دون تعديل أي صفحة:

Link: </docs/page.html.md>; rel="alternate"; type="text/markdown", </docs/llms.txt>; rel="describedby"

إن كنت قد اتبعت سابقًا نصيحة الإعلان عن الملف بواسطة rel="alternate" type="text/plain" — بما في ذلك إصدارات أقدم من أدلّتنا نحن — فاستبدلها بـ rel="describedby". كان ذلك عُرفًا معقولًا قبل أن يكون للمواصفة عُرف خاص؛ أما الآن فلديها واحد.

٢. صيغتا عناوين .md مسموحتان الآن

حدّدت v1 صيغة واحدة لعنوان النسخة المكافئة بصيغة Markdown: إضافة .md إلى عنوان الصفحة الكامل، فيصبح page.html هو page.html.md. لكن عمليًا استبدلت عدة أدوات نشر الامتداد فأنتجت page.md. وتقرّ v2 بالصيغتين. أما العناوين التي لا تحتوي اسم ملف، فأضف إليها index.html.md أو index.md.

لا شيء يحتاج إلى ترحيل هنا — فالصيغة التي تُنتجها بالفعل صحيحة الآن.

٣. ملفات المسارات الفرعية باتت معرّفة كما ينبغي

أجازت v1 وجود llms.txt خارج الجذر لكنها لم تقل قط ما يعنيه ذلك. وتعرّفه v2: الملف يغطّي الصفحات الواقعة تحت مساره، وإذا انطبق أكثر من ملف فإن الوكلاء يستخدمون الأكثر تحديدًا. أي أن /docs/llms.txt يغطّي كل ما تحت /docs/، والوكيل الذي يقرأ صفحة توثيق يفضّله على ملف الجذر.

هذا مهم لكل من يتحكّم في مسار دون التحكّم في المستضيف — موقع مشروع على GitHub Pages، أو قسم توثيق على نطاق مشترك — وهو سبب تمسّك المواصفة باسم ملف تقليدي بدلًا من /.well-known/ الذي لا يوجد إلا في جذر الأصل.

النتيجة العملية: إذا كان التوثيق هو الجزء الذي يهمّ الوكلاء، فإن ملف /docs/llms.txt مخصّصًا له أصبح خيارًا من الدرجة الأولى، لا منطقة رمادية.

٤. أدوات توسيع السياق خرجت (وفقد قسم «Optional» أثره الآلي)

وصفت v1 أداة llms_txt2ctx التي توسّع ملف llms.txt إلى سياق واحد للنموذج. وتتخلّى v2 عنها وتصرّح بالتوقّع مباشرة: يطالع الوكلاء ملف llms.txt أو يبحثون فيه، ثم يتبعون الروابط التي يحتاجونها — ومن ثم ينبغي أن تشير الروابط إلى محتوى ملائم للنماذج، ويبقى الملف نفسه صغيرًا بما يكفي ليدخل في السياق.

ومع تلك الأداة يزول المعنى الآلي لقسم ## Optional، الذي كان وجوده أصلًا لإخبار تلك الأدوات بما تحذفه. لا تزال أقسام Optional مسموحة، ولا تزال عُرفًا مفيدًا للروابط الثانوية التي يمكن للوكيل تجاوزها — لكنها لم تعد تُشغّل أي سلوك آلي.

لاحظ أن llms-full.txt لم يكن جزءًا من المواصفة في أي من الإصدارين. إنه ممارسة صناعية واسعة الانتشار، وجيّدة لمجموعات التوثيق الكبيرة — لكن لا تتعامل معه كمطلب.

ما ينبغي فعله هذا الأسبوع

أضف rel="describedby" يشير إلى ملف llms.txt الخاص بك — سطر واحد في القالب، أو قاعدة ترويسة واحدة في شبكة التوصيل.
إن كنت تنشر نسخًا مكافئة بصيغة Markdown، فأعلن عنها بواسطة rel="alternate" type="text/markdown".
استبدل أي إشارة rel="alternate" type="text/plain" بـ rel="describedby".
إن كان التوثيق هو الجزء الأكثر قيمة، ففكّر في ملف /docs/llms.txt مخصّص له.
أعد تشغيل المدقّق — فهو يبلّغ الآن عمّا إذا كانت صفحاتك تعلن علاقات v2، ويتبع ملفات المسارات الفرعية كما تنصّ v2 على أن يفعل الوكلاء.

لماذا حدثت المراجعة أصلًا

لأن الفرضية لم تبقَ تخمينًا. عندما طُرح llms.txt في سبتمبر 2024، كانت عبارة «الوكلاء سيقرأون موقعك» تنبؤًا. أما اليوم فمنصات التوثيق تولّد الملف تلقائيًا، وأداة Lighthouse في Chrome تفحص المواقع للتحقّق من وجوده ضمن اختبارات التصفّح الوكيلي، ومختبرات الذكاء الاصطناعي نفسها تنشر ملفات llms.txt لتوثيق المطوّرين الخاص بها. v2 هي صورة المقترح بعد أن اختبر التبنّي الحقيقي افتراضاته.

تابِع القراءة

تحقّق من ملف llms.txt الخاص بك →