صيغة الملف
ملف .json للاختبار: محتواه وطريقة فتحه
يُصدَّر اختبار CanQuiz في ملف .json: نص يحتوي على الأسئلة والخيارات والإجابات. هنا صيغته حقلًا بحقل، مع مثال يُفتح في المتصفح دون إنشاء حساب.
يُفتح في app.canquiz.com/abrir. ويقرأ متصفحك الملف بنفسه.
ما هو ومن أين يأتي
هو الملف الذي يُنزَّل من المكتبة: في قائمة المزيد لأي اختبار، ثم تنزيل، ثم ملف CanQuiz (لإرساله إلى شخص آخر). حجمه بضعة كيلوبايتات، ويُرسل عبر WhatsApp أو البريد الإلكتروني مثل أي مرفق، ولا تنتهي صلاحيته. لهذا تنتقل الاختبارات من شخص إلى آخر بهذه الطريقة.
إن وصلك من أحد، فلا حاجة لفهم أي شيء مما يلي: يكفي إفلاته في app.canquiz.com/abrir وحل الاختبار. هذه الصفحة لمن يريد معرفة ما بداخله، أو كتابة ملف يدويًا، أو جعل أداة أخرى تنشئ هذه الملفات.
المستوى الأعلى
الملف كائن JSON. الشيء الوحيد الذي لا غنى عنه هو قائمة الأسئلة: إن غاب كائن الإعدادات، يملؤه CanQuiz بالقيم الافتراضية.
questionsقائمةإلزامي- الأسئلة، بالترتيب الذي تظهر به. سؤال واحد على الأقل. كل سؤال موصوف في الأسفل.
settingsكائن- طريقة حل الاختبار: الخلط، ودرجة النجاح، والشروح. يمكن أن يغيب، وعندها يضع CanQuiz الإعدادات الافتراضية؛ وكل حقوله اختيارية.
metadataكائن- بيانات الاختبار. الحقل الذي يستخدمه CanQuiz عند فتحه هو title_suggestion، العنوان المقترح إن لم يحمل الملف عنوانًا آخر (الحد الأقصى للأحرف: 120). ويُحفظ الباقي كما هو.
_canquiz_urlنص- تضيفه عملية التصدير مع _canquiz و_canquiz_titulo: رابط الاختبار إن كان مُشاركًا برابط فقط، وملاحظة من سطر واحد، والعنوان الذي نُزِّل به. تُحذف هذه الحقول عند فتح الملف، فلا فرق إن حذفتها أو تركتها.
ويُفتح أيضًا المحتوى نفسه إذا كان داخل كائن آخر له حقلان، title وcontent: يصبح title عنوان الاختبار، ويحمل content الحقول questions وsettings وmetadata.
كل سؤال
الحقول نفسها لكل الأنواع. تُقارَن الإجابات بالنص الحرفي، لذا يجب أن يُكتب ما يوضع في correct_answer تمامًا كما في options.
idنصإلزامي- معرّف قصير، مثل q1 وq2 وq3. لا يظهر، لكن لا يجوز تكراره داخل الاختبار: ولا يمكن إضافة اختبار بمعرّفات مكررة إلى حساب.
typeنصإلزامي- نوع السؤال كما هو: single_choice أو multiple_choice أو true_false أو question_answer أو short_answer. وهي مشروحة في القسم التالي.
questionنصإلزامي- نص السؤال (الحد الأقصى للأحرف: 2000). نص فقط: الصيغة لا تحمل صورًا.
optionsقائمة- الخيارات، والحد الأقصى للأحرف في كل خيار: 1000. إلزامية في أسئلة الاختيار؛ والأسئلة المفتوحة لا تحمل هذا الحقل.
correct_answerنص أو قائمةإلزامي- النص الحرفي للخيار الصحيح، أو قائمة نصوص في multiple_choice. وفي الأسئلة المفتوحة، الإجابة المتوقعة. الحد الأقصى للأحرف: 2000.
explanationنص- سبب صحة الإجابة (الحد الأقصى للأحرف: 20000). يظهر عند التصحيح إن كانت الشروح مفعّلة في الاختبار.
أنواع الأسئلة
قيمة type تحدد الحقول المطلوبة وطريقة تصحيح الإجابة.
single_choiceإجابة واحدة- خيار صحيح واحد فقط بين عدة خيارات. correct_answer نص يجب أن يطابق أحد عناصر options.
multiple_choiceعدة إجابات- خياران على الأقل، وواحد صحيح أو أكثر. correct_answer قائمة بنص كل خيار صحيح.
true_falseصح أو خطأ- خياران بالضبط، بأي لغة (صح وخطأ، أو True وFalse). correct_answer أحدهما.
question_answerسؤال مفتوح- بلا options. يُجاب عنه بالكتابة، ويصحّحه الذكاء الاصطناعي بمقارنته مع correct_answer، أي الإجابة المتوقعة. هذا التصحيح يحتاج إلى حساب.
short_answerإجابة قصيرة- بلا options. يُجاب عنه بكلمة أو جملة قصيرة، ويُقارن بالإجابة الصحيحة دون اعتبار لحالة الأحرف أو علامات التشكيل أو الترقيم أو أداة تعريف في البداية؛ وإن لم يتطابق، يتحقق الذكاء الاصطناعي إن كان المعنى نفسه. يمكن أن يكون correct_answer قائمة بالإجابات المقبولة.
الإعدادات
كلها اختيارية. إن غاب أحدها، يُعدّ متوقفًا أو بقيمته المعتادة.
shuffle_questionstrue أو false- يخلط ترتيب الأسئلة في كل مرة يُحل فيها الاختبار.
shuffle_optionstrue أو false- يخلط ترتيب الخيارات داخل كل سؤال.
passing_scoreرقم- نسبة النجاح المئوية، من 0 إلى 100. تُقبل وتُحفظ، لكن CanQuiz لا يطبّقها حاليًا: النتيجة لا تقول إن كنت نجحت أو رسبت.
show_explanationtrue أو false- يُظهر الشرح عند تصحيح كل سؤال.
show_progresstrue أو false- يُظهر عدد الأسئلة التي أجبت عنها وعدد ما تبقّى.
time_limitرقم- حد بالثواني، أكبر من 0. يُقبل ويُحفظ، لكن CanQuiz لا يطبّقه حاليًا: الاختبار المنفرد ليس له عدّ تنازلي.
ai_strictness_levelرقم- من 1 إلى 10: مدى صرامة التصحيح بالذكاء الاصطناعي في الأسئلة المفتوحة.
مثال كامل
أربعة أسئلة من أربعة أنواع مختلفة، مع إعداداتها، وكلها تُصحَّح دون حساب. يمكنك نسخه أو تنزيله وفتحه في app.canquiz.com/abrir لرؤية شكله.
{
"metadata": {
"title_suggestion": "التمثيل الضوئي (مثال)"
},
"settings": {
"shuffle_questions": false,
"shuffle_options": true,
"passing_score": 70,
"show_explanation": true,
"show_progress": true
},
"questions": [
{
"id": "q1",
"type": "single_choice",
"question": "أين تحدث عملية التمثيل الضوئي في خلايا النبات؟",
"options": [
"البلاستيدات الخضراء",
"الميتوكوندريا",
"النواة",
"الجدار الخلوي"
],
"correct_answer": "البلاستيدات الخضراء",
"explanation": "تحتوي البلاستيدات الخضراء على الكلوروفيل، وهو الصبغة التي تلتقط ضوء الشمس."
},
{
"id": "q2",
"type": "multiple_choice",
"question": "ما الذي يحتاج إليه النبات للقيام بالتمثيل الضوئي؟",
"options": [
"ضوء الشمس",
"الماء",
"ثاني أكسيد الكربون",
"النيتروجين"
],
"correct_answer": [
"ضوء الشمس",
"الماء",
"ثاني أكسيد الكربون"
],
"explanation": "يستعمل النبات طاقة الضوء ليحوّل الماء وثاني أكسيد الكربون إلى سكر وأكسجين."
},
{
"id": "q3",
"type": "true_false",
"question": "الأكسجين الذي يطلقه النبات في التمثيل الضوئي مصدره جزيئات الماء.",
"options": [
"صح",
"خطأ"
],
"correct_answer": "صح",
"explanation": "ينشطر الماء داخل البلاستيدات الخضراء ويخرج منه الأكسجين، أما ثاني أكسيد الكربون فيدخل في تكوين السكر."
},
{
"id": "q4",
"type": "short_answer",
"question": "ما اسم الصبغة الخضراء التي تمتص الضوء في أوراق النبات؟",
"correct_answer": "الكلوروفيل",
"explanation": "يمتص الكلوروفيل الضوء الأزرق والأحمر ويعكس الأخضر، ولهذا تبدو الأوراق خضراء."
}
]
}بعد التعديل، يُحفظ الملف كنص بامتداد .json. ومحرر الأكواد ينبّهك إن سقطت فاصلة أو علامة اقتباس.
لماذا لا يُفتح ملف
عند فتح ملف، لا يخمّن CanQuiz: إما أن يلتزم الملف بالصيغة، وإما أن يظهر تنبيه. هذه هي الأخطاء المعتادة.
الإجابة الصحيحة كحرف
كتابة B أو 2 في correct_answer لا تصلح في الملف: يجب أن يكون نص الخيار، مكتوبًا كما هو.
بلا أسئلة
يجب أن يوجد questions وأن يحتوي على سؤال واحد على الأقل. أما settings فيمكن أن يغيب: يضع CanQuiz الإعدادات الافتراضية.
سؤال صح أو خطأ بأكثر من خيارين
true_false يحمل خيارين بالضبط. لثلاثة خيارات أو أكثر، يُستخدم single_choice.
سؤال مفتوح بخيارات
لا يمكن أن يحمل question_answer الحقل options. إن كان له خيارات، فهو سؤال اختيار.
نوع مكتوب خطأً
multiple-choice بشرطة عادية أو MultipleChoice ليست أنواعًا: تُكتب الأنواع بأحرف صغيرة وبشرطة سفلية.
نص طويل جدًا
لكل حقل حد أقصى من الأحرف، وُضع لإيقاف الملفات غير المعقولة: نص سؤال يتجاوز ألفي حرف لا يُفتح.
معرّفات مكررة
سؤالان بالمعرّف نفسه يمكن حلّهما دون حساب، لكن لا يمكن إضافتهما إلى حساب.
إن أردت أن ينشئه ذكاء اصطناعي
لا حاجة لكتابة JSON. مع تطبيق CanQuiz في ChatGPT يكفي طلب الاختبار ليُحفظ في حسابك، جاهزًا للحل. الطريقة موضّحة في صفحة إنشاء أسئلة الاختيار من متعدد من ChatGPT خطوة بخطوة.
الأسئلة الشائعة
هل أحتاج إلى حساب لفتح ملف .json؟
لا. في app.canquiz.com/abrir يكفي إفلات الملف أو اختياره لحل الاختبار كاملًا، مع التصحيح والشروح. الحساب لازم فقط لحفظه أو مراجعته لاحقًا أو تعديله: بالضغط على تسجيل الدخول والحفظ، وبعد العودة، يكون الاختبار في حسابك مع ما أجبت عنه حتى الآن. عندها يصبح الاختبار لك، ولا يعود بإمكان من أرسله إليك تغييره.
هل يُرفع الملف إلى أي خادم؟
قبل تسجيل الدخول إلى حساب، لا يُحفظ الملف في أي مكان: يقرؤه المتصفح على جهازك ويُحل الاختبار هناك. وفي حالة واحدة فقط، حين لا تطابق إجابة قصيرة الإجابة الصحيحة، يُرسل ذلك السؤال وما كتبته إلى الذكاء الاصطناعي ليتحقق إن كان المعنى نفسه، دون حفظ. وإن قررت حفظ الاختبار، فعندها يُحفظ في حسابك على CanQuiz.
كيف أصدّر أحد اختباراتي إلى JSON؟
في المكتبة: قائمة المزيد للاختبار، ثم تنزيل، ثم ملف CanQuiz (لإرساله إلى شخص آخر). ومن القائمة نفسها يمكن أيضًا تنزيل جدول بيانات (CSV) وAnki (نص مفصول بعلامات جدولة).
هل يمكنني كتابة اختبار يدويًا بهذه الصيغة؟
نعم. يكفي البدء من المثال في هذه الصفحة، وتغيير الأسئلة والإجابات بأي محرر نصوص، وحفظه بامتداد .json. وإن لم يعمل عند فتحه، فأول ما يُراجَع أن كل correct_answer مكتوب تمامًا مثل خياره.
هل يمكن أن ينشئه ذكاء اصطناعي آخر أو برنامج كتبته؟
نعم، إنه JSON عادي. إن أنشأه برنامج، فيكفي اتباع الحقول في هذه الصفحة وسيُفتح الملف كأنه مُصدَّر. وإن أردت أن تنشئه محادثة ذكاء اصطناعي، فالأسهل تطبيق CanQuiz في ChatGPT أو ربط حسابك مع Claude: يُحفظ الاختبار تلقائيًا، دون ملف.
هل يفتح ملفات Quizlet أو Kahoot أو ملف CSV؟
لا. لا يفتح CanQuiz إلا ملفات JSON التي يصدّرها هو. يصدّر إلى JSON وCSV وAnki، لكنه لا يأخذ اختبارات من تلك الأدوات ولا يصدّر إلى Quizlet أو Kahoot. إن كانت أسئلتك في مكان آخر، يمكنك لصقها كنص وترك الذكاء الاصطناعي يبني الاختبار.
كم سؤالًا يتسع له الملف؟
عند فتحه، لا يضع CanQuiz حدًا أقصى لعدد الأسئلة: الحد يقع على نص كل حقل، من ألفي حرف في نص السؤال إلى عشرين ألفًا في الشرح. والاختبار الطويل يبقى خفيفًا، بضعة كيلوبايتات من النص.
هل وصلك ملف .json؟
يكفي إفلاته في CanQuiz وحل الاختبار الآن، في متصفحك ودون إنشاء حساب.