abdallah3id/rawda-cite-jafari-8b

ABD3ID AI

Jafari Cite 8B · Retrieval-Grounded Source Quotation

مساعد استشهاد بالمصادر في الفقه الجعفري، يعتمد على المقاطع المسترجعة

Project page and mirror documentation maintained by Abdalla Eid

العربية · English

---

نبذة بالعربية

ABD3ID AI — Jafari Cite 8B هو اسم عرض لمرآة النموذج Sadiq-Cite 8B. صُمم النموذج كمرحلة استشهاد ضمن نظام استرجاع: يستقبل سؤالًا ومقاطع مصدرية جرى استرجاعها مسبقًا، ثم يحاول اختيار المقاطع ذات الصلة ونقل اقتباساتها وبيانات كتبها وصفحاتها. وهو مخصص لمواد الفقه الجعفري/الإمامي كما يصفه إصدار المصدر.

هذا ليس روبوت محادثة عامًا ولا جهة إفتاء. لا ينبغي استخدامه لاستنباط حكم، أو تطبيق حكم على حالة السائل، أو اعتبار الاقتباس وحده جوابًا شرعيًا. إذا لم تقدم المنظومة مقاطع ذات صلة، فالسلوك المقصود هو التصريح بعدم العثور على مادة مناسبة بدل اختلاق إجابة.

حالة النسخة: بحسب معلومات الإصدار، هذه مرآة للأوزان دون تدريب إضافي أو تقييم مستقل أجراه مشروع ABD3ID AI. Abdalla Eid يدير صفحة المشروع ووثائق المرآة؛ ولا تنسب هذه البطاقة إليه تأليف النموذج الأصلي أو تدريبه.

كيف يعمل؟

1. يبحث نظام الاسترجاع في مجموعة مصادر يحددها المشغّل، ويستخرج مقاطع مرقمة.
2. يمرر التطبيق إلى النموذج السؤال والنصوص المسترجعة مع اسم الكتاب ورقم الصفحة لكل مقطع.
3. يحاول النموذج نقل النصوص التي يراها ذات صلة، وإظهار مرجعها، أو التصريح بأن السياق المقدم لا يتضمن مادة مناسبة.
4. يمكن لمكوّن التحقق sadiq_fiqh.verify() مطابقة الاقتباسات الناتجة مع المقاطع الممررة وإرجاع حالة لكل اقتباس.
5. يراجع المستخدم النص والمصدر والصفحة والسياق قبل عرضه أو الاعتماد عليه.

التحقق البرمجي من وجود اقتباس في المقاطع لا يثبت صحة المصدر الأصلي، ولا صحة نسبة القول، ولا صحة الحكم الفقهي أو انطباقه على واقعة.

بنية الإدخال المتوقعة

أرسل السؤال مع المقاطع المسترجعة، وأرفق بيانات المصدر بكل مقطع. لا تعتمد على النموذج لاختراع بيانات الكتاب أو الصفحة:

السؤال:
<سؤال البحث>

المقاطع المسترجعة:
[1] (اسم الكتاب، ص 120)
<نص المقطع>

[2] (اسم الكتاب، ص 245)
<نص المقطع>

أظهرت اختبارات تنسيق الإدخال في بطاقة المصدر أن الاقتباس قد يستمر عبر قوالب مختلفة، لكن بيانات الإسناد تتدهور عند حذف بيانات المصدر: عند تمرير مقاطع بلا كتاب أو صفحة، أبلغ المصدر عن 0% لمطابقة الاستشهادات لمقطع. أرسل دائمًا بيانات المصدر مع كل مقطع، أو احذف الاستشهادات غير المتحققة قبل عرض الناتج.

التقييم المنشور من مصدر النموذج

الأرقام التالية من بطاقة Sadiq-Cite المصدرية، وليست اختبارات مستقلة لمرآة ABD3ID AI. تذكر البطاقة المصدرية 282 سؤالًا محجوبًا مع المقاطع المسترجعة و100 اختبار رفض بمقاطع غير ذات صلة:

المقياس المبلغ عنه في المصدر	النتيجة	ملاحظة
إجابات تضمنت اقتباسًا واحدًا على الأقل	99.6%	لا يقيس وحده صحة الاستشهاد
اقتباسات أمكن تتبعها إلى المقاطع المقدمة	87.5%	84.5% مطابقة حرفية بعد تطبيع إملائي و3.0% شبه حرفية
اقتباسات لم توجد في المقاطع المقدمة	10.8%	خطر جوهري؛ قد يعيد النموذج بناء نص من ذاكرته
إجابات كانت جميع اقتباساتها متحققة	79.4%	يبين أن الناتج الكامل ليس موثوقًا تلقائيًا
إجابات تضمنت إحالة كتاب وصفحة	97.2%	وجود إحالة لا يعني أنها صحيحة
إحالات طابقت مقطعًا مقدمًا	82.5%	تتطلب توفير بيانات المصدر مع المقاطع
رفض صحيح في 100 اختبار بمقاطع غير مرتبطة	100%	نتيجة مجموعة الاختبار المنشورة
رفض خاطئ لسؤال قابل للإجابة	0.4% (1 من 282)	بحسب عينة المصدر

الخلاصة العملية: وفق الأرقام المنشورة، لم توجد الاقتباسات في المقاطع المقدمة في 10.8% من الحالات، ولم تكن كل الاقتباسات متحققة في 20.6% من الإجابات. لذلك شغّل أداة التحقق على كل إجابة، ولا تعرض اقتباسًا غير متحقق على أنه منقول من المصدر. لا تفسر هذه الأرقام على أنها نسبة صحة فقهية.

حساسية بيانات الإحالة لقالب الإدخال

في اختبار مصدر النموذج على 60 سؤالًا بأربعة أشكال لإدخال المقاطع، أُبلغ عن النتائج التالية:

شكل إدخال المقاطع	إجابات فيها اقتباسات	الاقتباس الحرفي	إحالات طابقت مقطعًا
القالب الأصلي مع بيانات المصدر	100%	88.8%	67.8%
كتلة سياق على نمط AnythingLLM	98.3%	85.5%	79.7%
وسوم XML للمستندات	100%	87.7%	66.7%
مقاطع بلا كتاب أو صفحة	100%	83.0%	0%

هذه نتائج بطاقة المصدر وليست ضمانًا لتكرار النسب على كل corpus أو إعداد استدلال. دقة نظام الاسترجاع نفسه لم تثبتها هذه الأرقام.

بدء الاستخدام

يمكن تشغيل النموذج عبر خادم محلي متوافق مع OpenAI، مثل LM Studio، ثم استخدام واجهة sadiq_fiqh للتهيئة والتحقق وفق حزمة المشروع المصدر:

pip install sadiq-fiqh

from sadiq_fiqh import Passage, Sadiq, verify

assistant = Sadiq(
    base_url="http://localhost:1234/v1",
    model="sadiq-cite-8b",
)

passages = [
    Passage(
        text="ضع هنا نصًا مسترجعًا من مصدرك.",
        book="اسم الكتاب",
        page=120,
    )
]

answer = assistant.cite("اكتب سؤال البحث هنا", passages)
verification = verify(answer, passages)

print(answer)
print(verification)

مثال تهيئة توضيحي؛ يلزم تشغيل الخادم وتحميل الأوزان وضبط عنوانه وإصدار الحزمة بما يناسب بيئتك. لا ترسل مقاطع أو بيانات خاصة إلى خدمة خارجية دون تصريح مناسب.

يمكن كذلك استخدامه في خطوط عمل مثل AnythingLLM أو n8n أو عميل متوافق مع OpenAI، شرط تمرير المقاطع المسترجعة وبيانات مصادرها. توصي بطاقة المصدر باستخدام فك ترميز حتمي (temperature=0) لثبات الاقتباس؛ وهذا لا يضمن صحة الناتج.

الاستخدام المسؤول والقيود

• المجال المعلن هو الاستشهاد بالنصوص المسترجعة في مواد الفقه الجعفري/الإمامي، لا إصدار الأحكام أو ترجيحها.
• الاقتباس غير المتحقق قد يكون إعادة بناء لا نقلًا حرفيًا؛ افحص نتيجة verify() والمصدر الأصلي.
• الاستشهاد يحتاج اسم الكتاب ورقم الصفحة في بيانات المقطع؛ إذا غابت البيانات فقد تظهر إحالات مختلقة.
• صحة الاقتباس داخل المقطع لا تثبت صحة الكتاب أو الطبعة أو النسبة أو سلامة السياق.
• جودة النتيجة تعتمد أيضًا على corpus، ونظام الاسترجاع، والتقسيم، وترتيب المقاطع وبياناتها.
• لا تستخدم الناتج وحده للفتوى أو لتطبيق حكم على شخص؛ ارجع إلى مصدر موثوق ومختص مؤهل.
• لا تعمم المخرجات على مذاهب أو تقاليد فقهية أخرى.
• نتائج المصدر محدودة بمجموعة اختبار محددة؛ لم يُنشر في هذه البطاقة تقييم مستقل للمرآة.

المصدر والترخيص والإسناد

هذه المرآة تعتمد على Sadiq-Cite 8B، المبني على Qwen3-8B. بحسب بطاقة المصدر، الأوزان في مرآة RAWDA AI غير معدلة، ولم يُجرَ عليها تدريب إضافي أو تقييم مستقل ضمن المرآة.

المستودع المصدر يعلن ترخيص MIT للنموذج المشتق، ويذكر التزامات ترخيص Apache-2.0 للنموذج الأساسي. راجع ملفات الترخيص والإشعارات الأصلية واحتفظ بالإسنادات المطلوبة قبل الاستخدام أو إعادة التوزيع. لا يمنح اسم ABD3ID AI أو إدارة Abdalla Eid للمرآة ملكية الأوزان أو المواد upstream.

---

English Overview

ABD3ID AI — Jafari Cite 8B is a project display name for a mirror of Sadiq-Cite 8B. The model is designed as the citation stage of a retrieval pipeline: it receives a question and passages retrieved beforehand, then attempts to select relevant excerpts and provide their book and page metadata. The source release describes it for Ja'fari (Imami) jurisprudential material.

This is not a general chatbot or a fatwa system. It should not derive rulings, apply them to a person's circumstances, or present a quotation alone as a religious answer. When supplied passages do not contain relevant material, the intended behavior is to say so rather than improvise.

Release status: According to the source release description, this is an unchanged weight mirror with no additional training or independent evaluation by the ABD3ID AI project. Abdalla Eid maintains this project's page and mirror documentation; this card does not claim authorship or training of the upstream model.

How it works

1. A retrieval system searches a corpus selected by the operator and returns passages.
2. The application provides the question and retrieved text, including book and page metadata for each passage.
3. The model attempts to quote relevant supplied text and identify its source, or state that the supplied context contains no relevant material.
4. The sadiq_fiqh.verify() component can match output quotations against the supplied passages and return a per-quote status.
5. A user reviews the wording, source, page, and context before displaying or relying on the result.

Programmatic matching does not verify the original source, attribution, jurisprudential correctness, or applicability to a real case.

Expected input

Pass the question together with retrieved passages, including source metadata for each passage. Do not rely on the model to invent book or page details:

Question:
<research question>

Retrieved passages:
[1] (Book title, p. 120)
<passage text>

[2] (Book title, p. 245)
<passage text>

The source card reports that quotation behavior persisted across several prompt formats, but citation matching degraded when source metadata was omitted: with bare passages and no book or page, reported citation-to-passage matching was 0%. Always include source metadata or remove citations that have not been verified.

Evaluation reported by the upstream project

The following numbers are reported by the Sadiq-Cite source card, not by an independent evaluation of the ABD3ID AI mirror. The source card describes 282 held-out questions with retrieved passages and 100 refusal probes with deliberately unrelated passages:

Metric reported by source	Result	Note
Answers containing at least one quotation	99.6%	Does not by itself measure citation correctness
Quotes traceable to supplied passages	87.5%	84.5% exact after orthographic normalization; 3.0% near-verbatim
Quotes not found in supplied passages	10.8%	Material risk: text may be reconstructed from model memory
Answers where every quote verified	79.4%	Full answers are not automatically reliable
Answers with a book-and-page citation	97.2%	Presence of a citation does not make it correct
Citations matching a supplied passage	82.5%	Requires source metadata in the passages
Correct refusals on 100 unrelated-context probes	100%	Result from the reported test set
False refusals on answerable questions	0.4% (1 of 282)	As reported by the source card

Practical takeaway: In the reported evaluation, 10.8% of quotes were absent from the supplied passages, and 20.6% of answers did not have every quote verified. Run the verifier on every answer and do not present unverified text as a source quotation. These figures are not a measure of jurisprudential correctness.

Sensitivity of citations to input format

The source project reports the following results on 60 questions across four passage-injection formats:

Passage format	Answers with quotes	Verbatim quote rate	Citations matching a passage
Native format with source metadata	100%	88.8%	67.8%
AnythingLLM-style context block	98.3%	85.5%	79.7%
XML document tags	100%	87.7%	66.7%
Bare passages without book or page	100%	83.0%	0%

These are source-card results, not a guarantee that the figures will reproduce for every corpus or inference setup. They do not evaluate the retrieval system itself.

Quickstart

The model can be served through a local OpenAI-compatible endpoint, such as LM Studio, and used with the source project's sadiq_fiqh interface:

pip install sadiq-fiqh

from sadiq_fiqh import Passage, Sadiq, verify

assistant = Sadiq(
    base_url="http://localhost:1234/v1",
    model="sadiq-cite-8b",
)

passages = [
    Passage(
        text="Insert a passage retrieved from your corpus.",
        book="Book title",
        page=120,
    )
]

answer = assistant.cite("Enter the research question", passages)
verification = verify(answer, passages)

print(answer)
print(verification)

This is an illustrative setup. Start a compatible server, load the weights, and configure its endpoint and package version for your environment. Do not send private passages or data to an external service without appropriate authorization.

The model can also be used in workflows such as AnythingLLM, n8n, or other OpenAI-compatible clients, provided retrieved passages and source metadata are included. The source card recommends deterministic decoding (temperature=0) for consistency; this does not guarantee correctness.

Responsible use and limitations

• The stated scope is citation of retrieved Ja'fari/Imami jurisprudential texts, not issuing or deriving rulings.
• An unverified quote may be reconstructed rather than copied; inspect verify() results and the original source.
• Citations require book and page metadata; missing metadata can lead to fabricated references.
• A quote matching a supplied passage does not verify the book, edition, attribution, or context.
• Results also depend on the corpus, retrieval system, chunking, passage ordering, and metadata.
• Do not use the output alone for a fatwa or to apply a ruling to a person; consult reliable sources and qualified specialists.
• Do not generalize the outputs to other jurisprudential traditions.
• The source results cover a defined test set; this mirror has no independent evaluation reported here.

Source, license, and attribution

This mirror is based on Sadiq-Cite 8B, which is built on Qwen3-8B. According to the source card, the RAWDA AI mirror uses unchanged weights; no additional training or independent mirror evaluation is reported.

The source repository declares MIT for the derived model and notes the Apache-2.0 obligations of its base model. Review and retain upstream license files, notices, and required attributions before use or redistribution. The ABD3ID AI name and mirror documentation maintained by Abdalla Eid do not transfer ownership of upstream weights or materials.