تخطَّ إلى المحتوى
Search docs
Search docs…

قواعد التوثيق: الاستشهاد بالنصوص الإسلامية التراثية عبر MCP

عقد التوثيق لإجابات خادم MCP لمعرض القرآن: انقل من نتائج الأدوات فقط، وفرّق بين المتن والحاشية، ولا تخترع بيانات الطبعة.

في هذه الصفحة

قد يكتب المساعد المتصل بالمكتبة إجابة سيئة مع ذلك. وهذه القواعد هي العقد الذي يُبقي الإجابة قابلة للتحقق. ويعرضها الخادم لعميلك أيضًا مورد qurangallery://grounding-rules، وتوجّه تعليماته النموذج إلى السلوك نفسه.

القواعد

  1. انقل ما أعادته الأداة فقط. انسب النص إلى كتاب فقط إذا جاء في نتيجة أداة. لا تُكمل اقتباسًا أو إسنادًا (isnād) أو لفظًا من معرفتك العامة.
  2. افصل المتن عن الحاشية. يبيّن كل مقطع في matchedIn موضع العثور على الألفاظ: body أو footnote أو both أو unknown. والمتن هو نص المؤلف (المتن). أما الحاشية فكلام المحقق أو المعلّق. لا تعرض الحاشية أبدًا على أنها كلام المؤلف (قراءة النتيجة).
  3. الصفحة المطبوعة ليست ترقيم الشاملة. printedPage هو المجلد والصفحة كما تُرقّمهما تلك الطبعة، مثل 1/ 6. وحين ترقّم المكتبة الكتاب آليًا تكون الصفحة رقم صفحة في الشاملة لا المطبوع، ويجب وسمها بذلك. وثّق الطبعة مع الصفحة: فرقم الصفحة نفسه يعني نصًا مختلفًا في طبعة مختلفة.
  4. لا تخترع بيانات النشر. لا تظهر edition وeditor وpublisher في المقطع إلا إذا كانت لدى المكتبة. فإذا غابت فقل إنها غير متوفرة. ولا تملأها من الذاكرة.
  5. بيّن كيف جرت المطابقة. تعني relaxedToTokens: true أن العبارة بنصها لم توجد، وإنما وُجدت ألفاظها. وهذا يدعم القول «هذه الألفاظ ترد في هذه الصفحة» لا «هذا اللفظ مطبوع هنا».
  6. عدم العثور محدود بنطاقه. «لم يوجد في هذه المجاميع الثمانية» نتيجة صحيحة. أما «غير موجود» فلا تستطيع الأدوات إثباتها.
  7. لا حكم على الحديث ولا فتوى. لا يحكم الخادم على حديث بأنه صحيح أو حسن أو ضعيف، ولا يصدر فتوى. وإن نقل مصدر حكمًا فانقله على أنه قول ذلك المصدر، مع الكتاب والصفحة.
  8. انسب المصدر. يحمل كل مقطع sourceUrl بالصيغة https://shamela.ws/book/{bookId}/{pageId}. اربطه، وانسب النص إلى shamela.ws مصدرًا له.

ما يحمله المقطع

الحقلالاستعمال
book وauthor وauthorDiedتسمية الكتاب ومؤلفه؛ وauthorDied بالهجري.
printedPageالمجلد والصفحة المطبوعان.
edition وeditor وpublisherعند وجودها فقط. لا تخمّنها أبدًا.
matchedIn وmatchQualityالمتن أم الحاشية؛ مطابقة تامة أم تقريبية.
bookId وpageIdمعرّفا الصفحة في الشاملة.
sourceUrlالصفحة على shamela.ws، للتحقق من الاقتباس.
arabicالمقطع بنصه حرفيًا. انقله كما هو.

التوثيق الجيد يُقرأ هكذا: البخاري، صحيح البخاري، ط السلطانية، 1/6 (المتن)، رابط shamela.ws. والسيئ يذكر كتابًا ورقم حديث تذكّرهما النموذج.

التحقق من إجابة

خذ sourceUrl أو bookId وpageId، وافتح الصفحة وقارن. ويستطيع مساعدك ذلك عنك بـshamela_get_page، أو أن يحوّل توثيقًا مطبوعًا إلى صفحة بـshamela_resolve_printed_page (قائمة الأدوات الكاملة).

ما لا يضمنه الخادم

يضمن أن المقطع والكتاب والصفحة حقيقية وأنها جُلبت فعلًا. ولا يضمن أن الجملة التي يبنيها مساعدك حولها قراءة منصفة. انظر ما يفعله خادم MCP.

عدّل هذه الصفحة على GitHub