"""ألعاب المحاكاة التفاعلية - the notebook, as one module. Ported from `simulation_game_pipeline.ipynb`. The notebook runs in one namespace, so it is carried over as one module, cell after cell. Every standard, pattern profile, interaction type, schema, agent, prompt, lint rule, assembly and export is the notebook's text; `test_simulation_game_fidelity` compares them line by line. What differs is the platform's, and only this: * cell [1] (pip) and `nest_asyncio.apply()` are gone - the worker runs its own loop and must not be re-entered; * cell [3]: the models come from the Arabic bag's tiers, built when an agent is made with the platform's key; the notebook's table is the record. `llm_reasoning` and its siblings are therefore factories, and `make_agent` builds the one it is handed; * `RUN_CONFIG["output_dir"]` is a temporary folder: the notebook writes its intermediate JSON there, and the engine keeps the real copy; * the Crew semaphore is per event loop (each stage runs on its own); * cell [7] (the example input) is the form's job here; cells [21] and [22] (the full run and the collector) are the engine's. """ # ══════════════════════════════════════════════════════════════════════ # خلية [2] من النوتبوك # ══════════════════════════════════════════════════════════════════════ # @title 2) الاستيرادات والدوال المساعدة import os, re, json, asyncio, textwrap, datetime, pathlib, copy, html as _html from typing import Any, Optional, Literal, Callable, Awaitable # nest_asyncio removed: the worker's loop must not be re-entered. from pydantic import BaseModel, Field, field_validator, model_validator, ValidationError try: from json_repair import repair_json except Exception: # pragma: no cover repair_json = None # ---------- JSON ---------- def parse_json_safe(text: str) -> Any: """يستخرج JSON من مخرج LLM: code fences ← أول '{' لآخر '}' ← json-repair.""" if text is None: raise ValueError("مخرج فارغ") s = str(text).strip() # 1) code fences m = re.search(r"```(?:json)?\s*(.*?)```", s, flags=re.S | re.I) if m: s = m.group(1).strip() # 2) أول { لآخر } i, j = s.find("{"), s.rfind("}") if i != -1 and j != -1 and j > i: s = s[i:j + 1] try: return json.loads(s) except Exception: if repair_json is None: raise return json.loads(repair_json(s)) def dumps(obj: Any) -> str: return json.dumps(obj, ensure_ascii=False, indent=2) def save_json(obj: Any, name: str, out_dir: Optional[str] = None) -> str: out_dir = out_dir or RUN_CONFIG["output_dir"] pathlib.Path(out_dir).mkdir(parents=True, exist_ok=True) p = pathlib.Path(out_dir) / name p.write_text(dumps(obj), encoding="utf-8") return str(p) def load_json(name: str, out_dir: Optional[str] = None) -> Any: out_dir = out_dir or RUN_CONFIG["output_dir"] return json.loads((pathlib.Path(out_dir) / name).read_text(encoding="utf-8")) # ---------- نص ---------- _AR_RE = re.compile(r"[؀-ۿ]") _LATIN_RE = re.compile(r"[A-Za-z]{2,}") _WORD_RE = re.compile(r"[؀-ۿ\w]+", re.U) def count_words(text: str) -> int: return len(_WORD_RE.findall(text or "")) def latin_tokens(text: str, allowed: Optional[list] = None) -> list: allowed_l = {a.lower() for a in (allowed or [])} return [t for t in _LATIN_RE.findall(text or "") if t.lower() not in allowed_l] def arabic_ratio(text: str) -> float: letters = [c for c in (text or "") if c.isalpha()] if not letters: return 1.0 return sum(1 for c in letters if _AR_RE.match(c)) / len(letters) def norm_ar(text: str) -> str: """تطبيع بسيط للمقارنة: إزالة التشكيل والتطويل وتوحيد الألف/الياء/التاء المربوطة.""" t = re.sub(r"[ً-ْـ]", "", text or "") t = re.sub("[إأآا]", "ا", t).replace("ى", "ي").replace("ة", "ه") return re.sub(r"\s+", " ", t).strip().lower() def line_count(text: str) -> int: return len([l for l in (text or "").split("\n") if l.strip()]) def log(msg: str, level: str = "info"): icons = {"info": "ℹ️", "ok": "✅", "warn": "⚠️", "err": "❌", "run": "▶️"} if RUN_CONFIG.get("verbose", True) or level in ("warn", "err"): print(f"{icons.get(level,'•')} {msg}") # ══════════════════════════════════════════════════════════════════════ # خلية [3] من النوتبوك # ══════════════════════════════════════════════════════════════════════ # @title 3) المفاتيح والموديلات و RUN_CONFIG os.environ.setdefault("CREWAI_DISABLE_TELEMETRY", "true") os.environ.setdefault("CREWAI_TRACING_ENABLED", "false") os.environ.setdefault("OTEL_SDK_DISABLED", "true") from crewai import Agent, Task, Crew, Process, LLM RUN_CONFIG = { "output_dir": "outputs", # مجلد المخرجات (JSON + Word + HTML) "max_concurrency": 4, # عدد النداءات المتوازية "max_retries": 3, # إعادة المحاولة عند فشل التحقق الهيكلي "length_tolerance": 0.15, # ±15% لحلقة ضبط الطول "max_length_rounds": 2, # عدد جولات ضبط الطول "max_fix_rounds": 2, # عدد جولات التصحيح الموجَّه بعد المراجعة "temperature_reasoning": 0.3, "temperature_writer": 0.6, "temperature_visual": 0.5, "max_tokens": 12000, "verbose": True, } #: The notebook writes its intermediate JSON as it goes; the engine stores #: every step's output, so those files go to a temporary folder, never the cwd. import tempfile as _tempfile # noqa: E402 RUN_CONFIG["output_dir"] = str(pathlib.Path(_tempfile.gettempdir()) / "contiai_simulation_game") #: The notebook's table, kept as the record and asserted against the notebook. _NOTEBOOK_MODELS = { "reasoning": "google/gemini-2.5-pro", # تحليل / تصميم / تفاعلات / مراجعة "writer": "openai/gpt-4.1-mini", # الكتابة "visual": "openai/gpt-4.1-mini", # الوصف البصري / الأغلفة } #: What actually runs - chosen the way the Arabic training bag chooses #: (`app.agents.arabic_bag.llms`): the JSON contracts (analysis, design, #: interactions, review) on the structured tier, the screen text, the visual #: direction and the covers on the bag's writer. Defaults recorded here and #: in the exported file; each factory resolves its tier when an agent is made. MODELS = { "reasoning": "openai/gpt-4.1-mini", "writer": "google/gemini-2.5-flash", "visual": "google/gemini-2.5-flash", } def model_for(tier: str) -> str: """The model a tier resolves to now, through the bag's tiers.""" from app.agents.arabic_bag.llms import structured, writer_model return structured() if tier == "reasoning" else writer_model() def _or(tier: str, temperature: float, max_tokens: Optional[int] = None): from app.agents.arabic_bag.llms import _or as _bag_or return _bag_or(model_for(tier), temp=temperature, max_tokens=max_tokens or RUN_CONFIG["max_tokens"]) # Factories, not built models: the key is read each time an agent is made. def llm_reasoning(): return _or("reasoning", RUN_CONFIG["temperature_reasoning"]) def llm_writer(): return _or("writer", RUN_CONFIG["temperature_writer"]) def llm_visual(): return _or("visual", RUN_CONFIG["temperature_visual"]) llm_motion = llm_visual # ══════════════════════════════════════════════════════════════════════ # خلية [4] من النوتبوك # ══════════════════════════════════════════════════════════════════════ # @title 4) المعايير العامة (ثوابت تنطبق على كل المشاريع) # المصدر: «معايير تصميم وإنتاج ألعاب المحاكاة التفاعلية» (19 بندًا). كل معيار قابل للقياس له نظير في Lint (الخلية 10). STD_CORE = """\ [المعيار الأساسي] يشعر المتدرب أنه يؤدي المهمة داخل موقف عملي حقيقي، لا أنه يجيب عن أسئلة منفصلة. - تبدأ اللعبة بتحديد المهارة/الإجراء العملي الذي سيطبّقه المتدرب داخل بيئة محاكاة مرتبطة بموقف واقعي قابل للتمثيل بصريًا. - تُحدَّد المشكلة أو المهمة التي سيواجهها المتدرب داخل البيئة قبل تصميم التفاعلات. - تُبنى اللعبة مسارًا متتابعًا من المواقف؛ كل مهمة تقود إلى التالية، ولكل مهمة هدف واضح وموقف محدد وتفاعل مناسب ونتيجة. - تحدث كل مهمة داخل البيئة المناسبة لها (الطهي في المطبخ، فرز الملابس في غرفة الغسيل، الجهاز أمام الجهاز نفسه)، وتُستخدم عناصر البيئة لتوضيح المهمة. """ STD_OPENING = """\ [المشهد الافتتاحي] يضع المتدرب مباشرة داخل الموقف، ويتضمن إلزاميًا: (1) تحديد المكان، (2) ظهور الشخصية/الشخصيات المرتبطة بالموقف، (3) حوار أو موقف يوضح المشكلة أو المهمة، (4) سبب بدء المهمة، (5) توضيح المطلوب من المتدرب بصورة طبيعية داخل سياق القصة. - يُبرز المشهد عناصر المشكلة التي ستُعالج لاحقًا (اتساخ/تسرب/بلل/سخونة…) تمهيدًا للمهام. - تظهر فقاعة/إطار توجيه يخاطب المتدرب بلغة بسيطة ويوضح المهمة. """ STD_SAFETY = """\ [تعليمات السلامة] إذا تضمّن الموقف مخاطر أو أدوات أو مواد تتطلب احتياطات، تُقدَّم تعليمات السلامة قبل بدء التفاعل. - مرتبطة مباشرة بالموقف، مختصرة وقابلة للتطبيق، تظهر قبل المهمة التي تتطلبها أو في بداية اللعبة إذا انطبقت على جميع المراحل. - يمكن إتاحتها كتذكير أو تلميح أثناء اللعبة. - الشكل المعتمد: نص تمهيدي يُكتب حرفًا حرفًا مع صوت كتابة («احذر، وفكّر قبل أن تتصرف! وتذكّر قواعد السلامة»)، ثم تظهر أيقونات معبّرة مع نص قصير لكل قاعدة وصوت فرقعة خفيف، بحركة لطيفة دون اهتزاز مزعج. """ STD_START = """\ [شاشة البدء] بعد المشهد الافتتاحي والتعليمات يظهر زر واضح («ابدأ اللعبة»). عند الضغط: ينتقل المتدرب إلى بيئة المهمة، تبدأ عناصر اللعبة في التفاعل، يبدأ الوقت إن وُجد، يبدأ احتساب التقدم، وتظهر المهمة الأولى أو توجيهها. يمكن إظهار تعليمة سريعة قبل المهمة الأولى إذا احتاجت طريقة التفاعل توضيحًا. """ STD_TASK = """\ [مكونات كل مهمة — إلزامية الستة] 1) بيئة واضحة: المكان الحقيقي الذي تحدث فيه المهمة. 2) موقف أو مشكلة: حالة تحتاج تصرفًا أو قرارًا. 3) تعليمة: توضح المطلوب من المتدرب. 4) عناصر تفاعلية: أدوات/صور/شخصيات/بطاقات/أجهزة/ملابس/مكونات بحسب البيئة. 5) تفاعل: يختار أو يسحب أو يرتب أو يطابق أو ينفذ الإجراء. 6) نتيجة: تغذية راجعة ثم الانتقال إلى المرحلة التالية. - يُحدَّد نوع التفاعل وفق المهارة التي تقيسها المهمة، ويختلف بين المهام فقط عندما يخدم ذلك المهارة، لا لمجرد التنويع. - لكل مهمة فكرة واحدة/مهارة واحدة محددة. """ STD_VISUAL_REP = """\ [التمثيل البصري لكل تفاعل] - السحب والإفلات → يظهر العنصر قابلًا للسحب ومنطقة الإسقاط بوضوح. - الترتيب → تظهر البطاقات والخانات التي ستوضع فيها. - اختيار الصورة → صور واضحة متقاربة الحجم. - اختيار عنصر داخل مشهد → عناصر قابلة للتحديد دون غموض. - تنفيذ خطوة عملية → يظهر الجهاز/الأداة في الحالة المناسبة قبل التنفيذ وبعده. - كل خيار يظهر مع أيقونة/صورة للشخصية وهي تنفذه وتحته نصه؛ تظهر معدات الوقاية (مثل القفازات) بوضوح في كل خطوة عند الحاجة. - يظهر الإرشاد التفاعلي في إطار متحرك أسفل الشاشة، والدليل (Clue) في إطار أعلى العنصر/الساعة. """ STD_HINTS = """\ [التلميحات] نوعان: تلميح عام متاح طوال اللعبة، وتلميح مرتبط بالمهمة لكل مهمة/خطوة. - يظهر بوضوح دون تشتيت (أيقونة لمبة 💡 مثبتة أعلى الشاشة / بطاقة / زر / عنصر داخل البيئة). - لا يكشف الإجابة مباشرة، بل يوجّه إلى المعلومة أو الإجراء الذي يحتاج مراجعته. - يمكن أن يظهر تلقائيًا عند توقف المتدرب فترة معينة أو تكرار الخطأ. """ STD_FEEDBACK = """\ [التغذية الراجعة — لكل مهمة/خطوة] الإيجابية: تظهر عند الإجراء الصحيح، توضح النجاح، تشرح سبب الصحة عند الحاجة، نحو ثلاثة أسطر كحد أقصى، مرتبطة بالخطوة المنفذة، وتحتها زر «متابعة». السلبية: تظهر عند الخطأ، توضح الحاجة إلى إعادة المحاولة، تقدم تلميحًا دون كشف الإجابة، مختصرة (حتى ثلاثة أسطر)، وتحتها زر «أعِد المحاولة». - شكل البطاقة: عنوان قصير بارز (مثل «ممتاز!» / «ليس تمامًا!») ثم جملة توضيح بخط عادي غير بارز. - لا يمكن الانتقال للخطوة التالية إلا بعد الإجابة الصحيحة. """ STD_EFFECTS = """\ [المؤثرات المصاحبة] عند النجاح: إضاءة/توهج العنصر الصحيح، علامة نجاح ✓، حركة خفيفة تؤكد التثبيت، صوت نجاح قصير، تحديث مؤشر التقدم، الانتقال للخطوة التالية. عند الخطأ: تنبيه صوتي قصير غير مزعج، اهتزاز خفيف للعنصر، منع تثبيت العنصر في المكان الخاطئ وعودته لموضعه، ظهور رسالة التلميح، إتاحة إعادة المحاولة. [الحركة والصوت] أصوات الأدوات عند استخدامها، صوت السحب والإفلات، أصوات البيئة، مؤثرات النجاح والخطأ، حركات طبيعية للشخصيات، انتقالات هادئة. المعيار: الصوت والحركة نتيجة للفعل أو داعمان له، لا مؤثر جمالي منفصل. """ STD_TIMER_PROGRESS = """\ [الوقت] يمكن تحديده للعبة كاملة أو لمهمة؛ يظهر بوضوح إن كان مؤثرًا في الأداء؛ لا يكون شكليًا بل مرتبطًا فعلًا بالمهمة. - الشكل المعتمد: مؤقت على هيئة إشارة مرور 🚦 (أخضر وقت آمن ← أصفر انتصاف الوقت ← أحمر قرب الانتهاء) مع اختلاف صوت المؤقت حسب اللون، ويبدأ العد فقط عند أول تفاعل فعلي للمتدرب. [مؤشر التقدم] اختياري؛ يوضح المهام المكتملة والمتبقية (أسهم/مراحل/نقاط/مهام مرقمة/شريط)، ويتغير بصريًا عند الإكمال (أخضر/علامة إنجاز). - الشكل المعتمد: خط أفقي أعلى الشاشة بلون فاتح مقسّم إلى أجزاء بعدد المهام وينتهي بنجمة ⭐، يمتلئ جزء باللون الأخضر مع صوت فرقعة بعد كل مهمة، وعند اكتمال الكل يلمع الخط مع نغمة إنجاز قصيرة. """ STD_TRANSITIONS_ENDING = """\ [الانتقال بين المهام] عند إكمال كل مهمة: تغذية راجعة تؤكد الإنجاز، تحديث التقدم، ظهور المهمة التالية في المؤشر، انتقال المشهد أو تغيّر حالة البيئة، زر «التالي/متابعة» أو انتقال تلقائي؛ ويكون الانتقال منطقيًا داخل القصة. [شاشة النهاية] داخل البيئة نفسها (لا شاشة منفصلة عن القصة)، وتتضمن: اكتمال المهمة الرئيسة، رسالة تهنئة، توضيح أن اللعبة اكتملت بنجاح، نتيجة أو أثر واضح لما قام به المتدرب، وتظهر البيئة في حالتها النهائية. [ارتباط النهاية بالقصة] إذا بدأت اللعبة بمشكلة فيجب أن توضح النهاية أنها عولجت؛ وإذا بدأت بمهمة فتظهر نتيجتها النهائية. [إعادة اللعب] زر «أعِد التشغيل» يعود إلى غلاف اللعبة (لا غلاف الوحدة)، ويمكن إضافة: العودة للرئيسية، مراجعة المهام، إعادة مهمة محددة. """ STD_CHARACTER = """\ [الشخصية] تُستخدم الشخصية المعتمدة نفسها في جميع الرسومات (محور مشترك للصور والأيقونات) بملامح واضحة ومركّزة وابتسامة خفيفة تعبّر عن الهدوء والتركيز، واقعية ومتفاعلة مع المهام وليست جامدة، مع الحفاظ على هوية تصميمها. - إذا كانت سياسة الشخصيات «generic» فتوصف شخصية عامة بلا هوية جغرافية أو ثقافية محددة. """ STD_LANGUAGE = """\ [اللغة والأسلوب] - عربي فصيح مبسّط فقط، في كل النصوص وفي الوصف الموجّه للمصمم أيضًا؛ لا كلمات لاتينية إلا ما يُسمح به صراحة في الإعدادات. - جمل قصيرة مباشرة تناسب جمهورًا قد يجد صعوبة في القراءة؛ الاعتماد على الصور والأيقونات والحركة لتوضيح المهام. - لا توليد صور ولا كتابة Prompts لصور؛ الوصف البصري نصّي تنفيذي للمصمم. - لا هوية جغرافية/ثقافية (أسماء دول، أزياء محلية، أطعمة محلية…) إذا كان السياق الجغرافي فارغًا. - مخاطبة المتدرب بصيغة واحدة ثابتة طوال اللعبة (حسب إعدادات الجمهور). """ GENERAL_STANDARDS = "\n".join([STD_CORE, STD_OPENING, STD_SAFETY, STD_START, STD_TASK, STD_VISUAL_REP, STD_HINTS, STD_FEEDBACK, STD_EFFECTS, STD_TIMER_PROGRESS, STD_TRANSITIONS_ENDING, STD_CHARACTER, STD_LANGUAGE]) # القيود القابلة للقياس (تُستخدم في البرومبت وفي Lint معًا) MEASURABLE = { "feedback_max_lines": 3, # سطور بطاقة التغذية الراجعة (العنوان + التوضيح) "feedback_max_words": 40, "instruction_max_words": 22, # التعليمة/الإرشاد على الشاشة "hint_max_words": 25, "clue_max_words": 20, "option_text_max_words": 10, "safety_rule_max_words": 10, "safety_rules_min": 3, "safety_rules_max": 5, "min_options": 3, "max_options": 6, "ordering_min_steps": 3, "matching_min_pairs": 3, "narrative_min_words": 60, # الوصف السردي التنفيذي لكل مشهد "task_scene_required_kinds": ["situation", "instruction", "hint", "feedback_positive_title", "feedback_positive_body", "feedback_negative_title", "feedback_negative_body", "transition"], } # ══════════════════════════════════════════════════════════════════════ # خلية [5] من النوتبوك # ══════════════════════════════════════════════════════════════════════ # @title 5) Profiles الأنماط + أنواع التفاعل + سياسات الإعدادات + project_context_block GAME_PATTERNS = { "hub_stations": { "label": "مشهد رئيسي ومحطات", "when": "بيئة واحدة فيها عدة أجهزة/نقاط/أدوات بها مشكلات أو ألغاز، يختار المتدرب كل محطة ويعالجها.", "structure": """\ - المشهد الافتتاحي يعرض البيئة كاملة ويبرز كل المحطات (الأجهزة/النقاط) وما تعانيه، والشخصية في منتصف المشهد. - لكل مهمة: (أ) في المشهد الرئيسي تومض المحطة المعنية بلون تحذيري مع صوت تنبيه وسهم/يد تشير إليها، ويظهر توجيه في إطار متحرك: «اضغط على … واكتشف ما بها من مشكلة»، (ب) عند الضغط يظهر مشهد مقرّب للمحطة في حالتها قبل المعالجة والشخصية أمامها بملامح تركيز، مع «دليل» قصير يصف المشكلة، (ج) التفاعل، (د) التغذية الراجعة، (هـ) العودة إلى المشهد الرئيسي وقد تغيّرت حالة المحطة (نظيفة/آمنة) وامتلأ جزء من مؤشر التقدم. - المؤقت (إن وُجد) يبدأ عند الضغط على أول محطة. - شاشة النهاية داخل البيئة نفسها وقد عادت كل المحطات إلى حالتها السليمة.""", "task_line_kinds_extra": ["station_prompt"], }, "sequential_missions": { "label": "مهام متتابعة", "when": "مسار عمل منطقي من مهام متتالية كل منها في بيئتها أو في حالة مختلفة من البيئة نفسها (جمع ← تحضير ← تنفيذ ← تقديم).", "structure": """\ - المشهد الافتتاحي يقدّم التحدي كاملًا (ما النتيجة النهائية المطلوبة) والسبب. - كل مهمة تبدأ بتغيّر واضح في البيئة أو الانتقال إلى بيئة فرعية مناسبة، وتنتهي بزر انتقال باسم المهمة التالية («قِس واطبخ»، «قدّم الطبق»…) أو بانتقال تلقائي مع تلميح «المهمة التالية: …». - نتيجة كل مهمة تظهر ماديًا في المهمة التالية (ما جُمع يظهر على الطاولة، ما غُسل ينتقل إلى التجفيف…). - شاشة النهاية تعرض الناتج النهائي للمسار كله وشخصية تقيّمه.""", "task_line_kinds_extra": [], }, "card_sorting": { "label": "فرز بطاقات/عناصر", "when": "تصنيف سلسلة من البطاقات أو العناصر في مناطق إسقاط ثابتة (فترات اليوم، أرفف، سلال، درجات حرارة).", "structure": """\ - تظهر مناطق الإسقاط ثابتة في المشهد (ساعة مقسّمة/أرفف/سلال) وتظل مرئية طوال اللعبة، وتُوسَّط في الشاشة. - كل مهمة = بطاقة/عنصر واحد يظهر في المنتصف (صورة الموقف + اسمه + بيانات مساعدة إن وُجدت) مع «دليل» قصير في إطار أعلى منطقة الإسقاط، وإرشاد ثابت متحرك أسفل الشاشة: «اسحب وأفلت … في المكان الأنسب». - عند الإفلات الصحيح يثبت العنصر في مكانه بعلامة ✓ وصوت نجاح؛ وعند الخطأ يعود العنصر إلى موضعه مع علامة ✕ وصوت خطأ ويبقى متاحًا لإعادة المحاولة. - المؤقت (إن وُجد) يبدأ عند ظهور أول بطاقة. - شاشة النهاية تعرض المناطق وقد امتلأت بترتيبها الصحيح.""", "task_line_kinds_extra": [], }, } INTERACTION_TYPES = { "choice": {"label": "الاختيار", "desc": "يختار المتدرب العنصر أو القرار الصحيح من عدة بدائل نصية/أيقونية."}, "drag_drop": {"label": "السحب والإفلات", "desc": "يسحب المتدرب عنصرًا ويضعه في منطقة الإسقاط الصحيحة."}, "ordering": {"label": "الترتيب", "desc": "يرتّب المتدرب الخطوات/البطاقات في خانات بالتسلسل الصحيح."}, "matching": {"label": "المطابقة", "desc": "يربط المتدرب بين عناصر متوافقة (أداة ↔ استخدام، مكوّن ↔ كمية…)."}, "image_choice": {"label": "اختيار الصورة الصحيحة", "desc": "يختار المتدرب الصورة التي تمثل الإجراء الصحيح من صور متقاربة الحجم."}, "scene_element": {"label": "التفاعل مع عنصر داخل البيئة", "desc": "يضغط المتدرب على الجهاز/الأداة/الشخصية الصحيحة داخل المشهد."}, "action_sequence": {"label": "تنفيذ سلسلة إجراءات", "desc": "ينفذ المتدرب أكثر من خطوة متتابعة داخل البيئة (اختيار الأداة ثم استخدامها ثم الخطوة التالية)."}, "branching_decision": {"label": "الاختيار بين القرارات", "desc": "يختار المتدرب قرارًا من عدة قرارات لكل منها نتيجة ظاهرة، وواحد منها هو الأنسب."}, } # قواعد التمثيل البصري الخاصة بكل نوع (بند الحادي عشر) — تُحقن في برومبت مصمم التفاعلات والمخرج البصري INTERACTION_VISUAL_RULES = { "choice": "تظهر الخيارات بالتتابع، كل خيار مع أيقونة/صورة للشخصية وهي تنفذه وتحته نصه القصير.", "drag_drop": "يظهر العنصر قابلًا للسحب بوضوح (ظل/إطار) وتظهر مناطق الإسقاط محددة ومسماة.", "ordering": "تظهر البطاقات مبعثرة وتظهر الخانات المرقمة التي ستوضع فيها.", "matching": "يظهر عمودان/مجموعتان متقابلتان بعناصر متقاربة الحجم وخطوط ربط تظهر عند السحب.", "image_choice": "تظهر الصور واضحة ومتقاربة في الحجم في صف واحد أو شبكة، دون نص يكشف الإجابة.", "scene_element": "العناصر القابلة للتحديد داخل المشهد واضحة دون غموض وتتوهج عند المرور عليها.", "action_sequence": "يظهر الجهاز/الأداة في الحالة المناسبة قبل كل خطوة وبعدها، وتظهر الخطوات كمسار مرئي.", "branching_decision": "تظهر القرارات بطاقات متساوية الحجم، ولكل قرار نتيجة بصرية فورية في البيئة.", } def _interaction_allowed(inp) -> list: allowed = inp.type_settings.interactions_allowed or list(INTERACTION_TYPES) return [k for k in allowed if k in INTERACTION_TYPES] def project_context_block(inp) -> str: """كتلة سياق المشروع (من JSON المدخلات) تُحقن في كل برومبت — ليست hardcoded.""" ts = inp.type_settings geo = inp.geo_context.strip() or "عام بلا هوية جغرافية أو ثقافية (ممنوع ذكر أسماء دول/مدن/أزياء محلية/أطعمة محلية)." ch = inp.characters if ch.policy == "approved_character": char_txt = f"شخصية معتمدة تُستخدم في كل الرسومات: {ch.approved_character_description or 'الشخصية المعتمدة للمشروع'}" elif ch.policy == "generic": char_txt = "شخصية عامة بلا هوية جغرافية أو ثقافية، تظهر في كل المشاهد بملامح واضحة وابتسامة خفيفة." else: char_txt = "بلا شخصية ظاهرة؛ التفاعل مباشر مع عناصر البيئة." sec = ("، شخصيات ثانوية: " + "، ".join(ch.secondary_characters)) if ch.secondary_characters else "" timer_txt = ("مفعّل — " + {"whole_game": "للعبة كاملة", "per_task": "لكل مهمة"}[ts.timer.mode] + f" {ts.timer.total_seconds} ثانية، الشكل: {ts.timer.style}، يبدأ عند: {ts.timer.starts_on}") if ts.timer.enabled else "معطّل (لا تذكر مؤقتًا)" prog_txt = (f"مفعّل — الشكل: {ts.progress_indicator.style}، عدد الأجزاء = عدد المهام ({inp.size.tasks_count})، ينتهي بـ: {ts.progress_indicator.ends_with}") if ts.progress_indicator.enabled else "معطّل" hint_txt = {"general": "تلميح عام واحد", "per_task": "تلميح لكل مهمة", "both": "تلميح عام + تلميح لكل مهمة", "none": "بلا تلميحات"}[ts.hint.mode] if ts.hint.mode != "none": hint_txt += f" (أيقونة 💡 مثبتة أعلى الشاشة؛ يظهر تلقائيًا بعد {ts.hint.auto_after_seconds} ثانية توقف أو {ts.hint.auto_after_errors} أخطاء)" forced = [] if inp.optional.title: forced.append(f"العنوان مفروض: «{inp.optional.title}»") if inp.optional.subtopics: forced.append("الموضوعات الفرعية مفروضة: " + " | ".join(inp.optional.subtopics)) if inp.optional.objectives: forced.append("الأهداف مفروضة: " + " | ".join(inp.optional.objectives)) vi = inp.visual_identity vi_txt = "؛ ".join(x for x in [ ("الألوان: " + "، ".join(vi.palette)) if vi.palette else "", ("الخط: " + vi.font) if vi.font else "", vi.notes or ""]) or "غير محددة — يقترح المصمم نظامًا بصريًا موحدًا هادئًا." allowed_latin = "، ".join(ts.allowed_latin_terms) if ts.allowed_latin_terms else "لا شيء (عربي 100%)" return f"""\ === سياق المشروع (من إعدادات المدخلات) === - نوع المنتج: لعبة محاكاة تفاعلية | نمط البناء: {inp.game_pattern} - الجهة/البرنامج: {inp.descriptor.program_name or '-'} | الوحدة: {inp.descriptor.unit_name} | رقم العنصر: {inp.descriptor.item_number} | نوع العنصر: {inp.descriptor.item_type} - الجمهور: {inp.audience.description} | مستوى القراءة: {inp.audience.literacy} | صيغة المخاطبة: {inp.audience.address_form} - السياق الجغرافي/الثقافي: {geo} - سياسة الشخصيات: {ch.policy} — {char_txt}{sec} | تسمية المتدرب داخل النصوص: «{ch.trainee_label}» - الهوية البصرية: {vi_txt} - الحجم: {inp.size.tasks_count} مهام | خطوات/خيارات لكل مهمة ≤ {inp.size.max_options_per_task} | كلمات المشهد الافتتاحي ≈ {inp.size.opening_words} (±{int(RUN_CONFIG['length_tolerance']*100)}%) - المؤقت: {timer_txt} - مؤشر التقدم: {prog_txt} - التلميح: {hint_txt} - تعليمات السلامة: {ts.safety_instructions} | سيناريو انتهاء الوقت: {'مطلوب' if (ts.timer.enabled and ts.failure_scenario) else 'غير مطلوب'} - أنواع التفاعل المسموحة: {', '.join(_interaction_allowed(inp))} - خيارات ما بعد النهاية: {', '.join(ts.replay_options)} - مصطلحات لاتينية مسموحة: {allowed_latin} - كلمات ممنوعة: {('، '.join(ts.forbidden_words)) if ts.forbidden_words else '-'} - السياق السابق: {inp.context.previous or '-'} | السياق اللاحق: {inp.context.next or '-'} - الحقول المفروضة: {('؛ '.join(forced)) if forced else 'لا شيء (يقترح الوكيل العنوان والموضوعات والأهداف)'} - ملاحظات التيم: {inp.notes or '-'} """ # ══════════════════════════════════════════════════════════════════════ # خلية [6] من النوتبوك # ══════════════════════════════════════════════════════════════════════ # @title 6) مخططات Pydantic (المدخلات + مخرجات كل وكيل) # ======================= المدخلات ======================= class ContentIn(BaseModel): raw_text: str = Field(..., min_length=20, description="المحتوى الخام (نص المادة التدريبية/المعلومات التي تُبنى عليها اللعبة)") source_title: str = "" class DescriptorIn(BaseModel): """بيانات الجدول التوصيفي.""" program_name: str = "" unit_name: str item_number: str = "1" item_type: str = "لعبة محاكاة" item_name: str = "" # لو فاضي يُقترح = العنوان class SizeIn(BaseModel): tasks_count: int = Field(4, ge=2, le=8) tasks_auto: bool = False # True = يحدد محلل المحتوى العدد المناسب (2–8) max_options_per_task: int = Field(5, ge=3, le=8) opening_words: int = Field(70, ge=30, le=200, description="الطول المستهدف لنصوص المشهد الافتتاحي") class OptionalIn(BaseModel): title: str = "" subtopics: list[str] = [] objectives: list[str] = [] class ContextIn(BaseModel): previous: str = "" next: str = "" class AudienceIn(BaseModel): description: str = "متدربون بالغون" literacy: Literal["low", "medium", "high"] = "medium" address_form: str = "المخاطبة بصيغة المؤنث المفرد (أنتِ)" class CharactersIn(BaseModel): policy: Literal["approved_character", "generic", "none"] = "generic" trainee_label: str = "المتدرب" approved_character_description: str = "" secondary_characters: list[str] = [] @model_validator(mode="after") def _check(self): if self.policy == "approved_character" and not self.approved_character_description.strip(): raise ValueError("سياسة approved_character تتطلب approved_character_description") return self class VisualIdentityIn(BaseModel): palette: list[str] = [] font: str = "" notes: str = "" class TimerIn(BaseModel): enabled: bool = True mode: Literal["whole_game", "per_task"] = "whole_game" total_seconds: int = Field(120, ge=20, le=1800) style: str = "إشارة مرور ثلاثية الألوان 🚦" starts_on: str = "أول تفاعل فعلي للمتدرب" class ProgressIn(BaseModel): enabled: bool = True style: Literal["segmented_bar", "steps", "dots", "numbered_tasks", "arrows"] = "segmented_bar" ends_with: str = "نجمة ⭐" class HintIn(BaseModel): mode: Literal["general", "per_task", "both", "none"] = "per_task" auto_after_seconds: int = Field(10, ge=3, le=60) auto_after_errors: int = Field(2, ge=1, le=5) class TypeSettingsIn(BaseModel): timer: TimerIn = TimerIn() progress_indicator: ProgressIn = ProgressIn() hint: HintIn = HintIn() safety_instructions: Literal["auto", "required", "none"] = "auto" interactions_allowed: list[str] = [] forced_interactions: list[str] = Field([], description="اختياري: نوع التفاعل لكل مهمة بالترتيب") allowed_latin_terms: list[str] = [] forbidden_words: list[str] = [] replay_options: list[str] = ["أعِد التشغيل"] failure_scenario: bool = True @field_validator("interactions_allowed", "forced_interactions") @classmethod def _known(cls, v): bad = [x for x in v if x not in INTERACTION_TYPES] if bad: raise ValueError(f"أنواع تفاعل غير معروفة: {bad}. المسموح: {list(INTERACTION_TYPES)}") return v class ProjectInput(BaseModel): product_type: Literal["simulation_game"] = "simulation_game" game_pattern: Literal["auto", "hub_stations", "sequential_missions", "card_sorting"] = "auto" content: ContentIn descriptor: DescriptorIn size: SizeIn = SizeIn() optional: OptionalIn = OptionalIn() context: ContextIn = ContextIn() audience: AudienceIn = AudienceIn() geo_context: str = "" characters: CharactersIn = CharactersIn() visual_identity: VisualIdentityIn = VisualIdentityIn() type_settings: TypeSettingsIn = TypeSettingsIn() notes: str = "" @model_validator(mode="after") def _consistency(self): o = self.optional if o.subtopics and o.objectives and len(o.subtopics) != len(o.objectives): raise ValueError(f"عدد الأهداف ({len(o.objectives)}) يجب أن يساوي عدد الموضوعات الفرعية ({len(o.subtopics)})") if o.subtopics and len(o.subtopics) != self.size.tasks_count: raise ValueError(f"عدد الموضوعات الفرعية ({len(o.subtopics)}) يجب أن يساوي عدد المهام ({self.size.tasks_count}) — كل مهمة تغطي موضوعًا فرعيًا") fi = self.type_settings.forced_interactions if fi and len(fi) != self.size.tasks_count: raise ValueError("forced_interactions يجب أن يساوي طولها عدد المهام") if fi and self.type_settings.interactions_allowed: bad = [x for x in fi if x not in self.type_settings.interactions_allowed] if bad: raise ValueError(f"forced_interactions تحتوي أنواعًا غير مسموحة: {bad}") if self.game_pattern == "card_sorting" and self.type_settings.interactions_allowed and "drag_drop" not in self.type_settings.interactions_allowed: raise ValueError("نمط card_sorting يتطلب السماح بـ drag_drop") if not self.descriptor.item_name and o.title: self.descriptor.item_name = o.title return self # ======================= مخرجات الوكلاء ======================= class ContentBlock(BaseModel): index: int title: str text: str hazards: list[str] = [] candidate_task: str = "" class AnalysisOut(BaseModel): domain: str audience_summary: str central_idea: str target_skill: str realistic_setting: str main_problem: str content_blocks: list[ContentBlock] = Field(..., min_length=1) hazards_overall: list[str] = [] suggested_pattern: Literal["hub_stations", "sequential_missions", "card_sorting"] pattern_reason: str suggested_tasks_count: int = Field(4, ge=2, le=8) class TaskPlan(BaseModel): task_id: str order: int name: str skill: str environment: str situation: str interaction_type: str one_idea: str content_block_indices: list[int] = [] state_before: str state_after: str station_name: str = "" # لنمط hub_stations class TimerPlan(BaseModel): enabled: bool description: str = "" phases: list[dict] = [] # [{"color":"أخضر","seconds":40,"sound":"..."}] starts_on: str = "" class ProgressPlan(BaseModel): enabled: bool description: str = "" segments: int = 0 completion_effect: str = "" class HintPlan(BaseModel): mode: str icon_description: str = "" general_hint: str = "" auto_trigger: str = "" class SafetyPlan(BaseModel): needed: bool reason: str = "" intro_text: str = "" rules: list[dict] = [] # [{"text":"...","icon_description":"..."}] placement: str = "" class VisualSystem(BaseModel): palette: list[str] = [] style: str character_sheet: str environment_sheet: str ui_sheet: str typography: str = "" class StoryPremise(BaseModel): place: str characters: list[str] problem_or_mission: str reason: str what_is_required: str class BlueprintOut(BaseModel): title: str game_pattern: Literal["hub_stations", "sequential_missions", "card_sorting"] subtopics: list[str] objectives: list[str] objectives_intro: str = "بنهاية اللعبة، سيكون المتدرب قادرًا على أن:" story: StoryPremise environment_main: str tasks: list[TaskPlan] timer: TimerPlan progress: ProgressPlan hint: HintPlan safety: SafetyPlan visual_system: VisualSystem ending_outcome: str failure_outcome: str = "" class ElementSpec(BaseModel): id: str name: str role: str # target | distractor | zone | draggable | card | step | character | prop | left | right visual_description: str class OptionSpec(BaseModel): id: str text: str is_correct: bool = False visual_description: str = "" target_zone_id: str = "" # drag_drop pair_with: str = "" # matching consequence: str = "" # branching_decision action: str = "" # action_sequence class FeedbackSpec(BaseModel): title: str body: str button: str class EffectsSpec(BaseModel): success: list[str] = [] error: list[str] = [] ambient: list[str] = [] class TransitionSpec(BaseModel): type: Literal["button", "auto"] = "button" text: str = "" class MechanicsSpec(BaseModel): description: str correct_answer: str correct_ids: list[str] = [] order: list[str] = [] # ordering / action_sequence pairs: list[list[str]] = [] # matching zones: list[str] = [] # drag_drop (ids) class InteractionOut(BaseModel): task_id: str interaction_type: str environment_state_before: str environment_state_after: str clue: str instruction: str elements: list[ElementSpec] = [] options: list[OptionSpec] = [] mechanics: MechanicsSpec hint: str feedback_positive: FeedbackSpec feedback_negative: FeedbackSpec effects: EffectsSpec transition: TransitionSpec class ScriptLine(BaseModel): kind: str text: str ref_id: str = "" # لربط السطر بخيار/عنصر/قاعدة class SceneScript(BaseModel): scene_number: int scene_id: str scene_type: str title: str lines: list[ScriptLine] = Field(..., min_length=1) class ScriptsOut(BaseModel): scenes: list[SceneScript] = Field(..., min_length=1) class Beat(BaseModel): line_index: int visual_idea: str motion: str on_screen_text: str text_position: str transition: str class VisualOut(BaseModel): scene_number: int scene_id: str beats: list[Beat] = Field(..., min_length=1) narrative_description: str environment_state: str = "" sound_notes: list[str] = [] class ReviewIssue(BaseModel): scene_number: int = 0 target: str # scripts | interactions | visual | blueprint problem: str fix: str severity: Literal["structural", "style"] = "style" source: str = "llm" class ReviewOut(BaseModel): verdict: Literal["pass", "needs_fix"] summary: str = "" issues: list[ReviewIssue] = [] class CoverSpec(BaseModel): header: str title: str subtitle: str = "" button: str = "" visual_description: str elements_from_scenes: list[str] = [] class CoversOut(BaseModel): game_cover: CoverSpec document_cover: CoverSpec # ======================= المدخلات المختصرة (الواجهة الفعلية للمستخدم) ======================= class SimpleInput(BaseModel): """ما يكتبه المستخدم فقط؛ كل ما عداه افتراضات داخلية أو يستنتجه الوكلاء من المحتوى.""" name: str = "" # اسم اللعبة/العنصر (فاضي = يقترحه المصمم) content: str = Field(..., min_length=20) # المحتوى الكامل unit: str = "وحدة تدريبية" # اسم الوحدة item_number: str = "1" program: str = "" # اسم البرنامج/الجهة (اختياري) tasks_count: int | Literal["auto"] = "auto" # عدد المهام أو تلقائي pattern: Literal["auto", "hub_stations", "sequential_missions", "card_sorting"] = "auto" audience: str = "" # وصف الجمهور (فاضي = متدربون بالغون، لغة بسيطة) character: str = "" # وصف الشخصية المعتمدة (فاضي = شخصية عامة بلا هوية) subtopics: list[str] = [] # اختياري: لو كُتبت تُفرض objectives: list[str] = [] # اختياري: لو كُتبت تُفرض notes: str = "" # ملاحظات التيم def build_input(simple: dict, advanced: Optional[dict] = None) -> ProjectInput: """يوسّع المدخلات المختصرة إلى ProjectInput بالافتراضات المعتمدة من ملف المعايير، ثم يطبّق أي تجاوزات اختيارية.""" si = SimpleInput.model_validate(simple) auto = si.tasks_count == "auto" n = (len(si.subtopics) if si.subtopics else 4) if auto else int(si.tasks_count) low_literacy = any(w in si.audience for w in ("صعوبة في القراءة", "أمي", "لا يقرأ", "عامل", "عاملات")) full = { "product_type": "simulation_game", "game_pattern": si.pattern, "content": {"raw_text": si.content, "source_title": si.name}, "descriptor": {"program_name": si.program, "unit_name": si.unit, "item_number": str(si.item_number), "item_type": "لعبة محاكاة", "item_name": si.name}, "size": {"tasks_count": n, "tasks_auto": auto and not si.subtopics}, "optional": {"title": si.name, "subtopics": si.subtopics, "objectives": si.objectives}, "audience": {"description": si.audience or "متدربون بالغون؛ لغة بسيطة ومباشرة", "literacy": "low" if low_literacy else "medium", "address_form": "المخاطبة بصيغة المؤنث المفرد (أنتِ)" if ("عاملات" in si.audience or "متدربات" in si.audience) else "المخاطبة بصيغة المذكر المفرد (أنتَ)"}, "characters": ({"policy": "approved_character", "approved_character_description": si.character, "trainee_label": "المتدربة" if "عاملات" in si.audience or "متدربات" in si.audience else "المتدرب"} if si.character.strip() else {"policy": "generic", "trainee_label": "المتدربة" if "عاملات" in si.audience or "متدربات" in si.audience else "المتدرب"}), "notes": si.notes, } def _merge(a, b): for k, v in (b or {}).items(): a[k] = _merge(a.get(k, {}), v) if isinstance(v, dict) and isinstance(a.get(k), dict) else v return a return ProjectInput.model_validate(_merge(full, advanced or {})) # ══════════════════════════════════════════════════════════════════════ # خلية [8] من النوتبوك # ══════════════════════════════════════════════════════════════════════ # @title 8) مشغّل الـ Crew الموحّد (await + Semaphore + تحقق + إعادة محاولة) _SEM: Optional[asyncio.Semaphore] = None _SEM_LOOP = None def _sem() -> asyncio.Semaphore: # Per event loop: each stage runs on a loop of its own, and a semaphore # created on one loop cannot be awaited on another. global _SEM, _SEM_LOOP loop = asyncio.get_running_loop() if _SEM is None or _SEM._value > RUN_CONFIG["max_concurrency"] or _SEM_LOOP is not loop: _SEM = asyncio.Semaphore(RUN_CONFIG["max_concurrency"]) _SEM_LOOP = loop return _SEM async def kickoff_crew(agent: Agent, description: str, expected_output: str) -> str: """كل وكيل = Crew مستقل. لا نمرر inputs لـ kickoff (البرومبت فيه JSON وCrewAI يعمل interpolation لـ {var}).""" task = Task(description=description, agent=agent, expected_output=expected_output) crew = Crew(agents=[agent], tasks=[task], process=Process.sequential, verbose=False) async with _sem(): result = await crew.kickoff_async() return str(getattr(result, "raw", result)) class ValidationIssue(Exception): def __init__(self, issues: list): self.issues = issues super().__init__("; ".join(f"[{s}] {m}" for s, m in issues)) def _issues_text(issues: list) -> str: return "\n".join(f"- ({'هيكلي' if s == 'structural' else 'أسلوبي'}) {m}" for s, m in issues) def settle_interaction(ix: InteractionOut) -> InteractionOut: """What code can work out is not left to the model. Five of six games stopped on a task whose ids did not agree: an order that was not a full permutation, pairs naming options that do not exist. The model writes the steps in their right order or the pairs as text; the ids, the order and the shuffle are arithmetic. """ import random seen: set = set() for i, o in enumerate(ix.options, 1): if not o.id.strip() or o.id in seen: o.id = f"opt{i}" seen.add(o.id) t, m = ix.interaction_type, ix.mechanics ids = [o.id for o in ix.options] if t in ("ordering", "action_sequence"): if sorted(m.order) != sorted(ids): m.order = list(ids) if m.order == ids and len(ids) > 1: shuffled = list(ix.options) random.Random(ix.task_id).shuffle(shuffled) if [o.id for o in shuffled] == ids: shuffled = shuffled[1:] + shuffled[:1] ix.options = shuffled m.correct_ids = list(m.order) elif t == "matching": names = {e.id: e.name for e in ix.elements} def option_for(token: str) -> str: token = token.strip() for o in ix.options: if o.id == token or norm_ar(o.text) == norm_ar(token): return o.id new = f"m{len(ix.options) + 1}" ix.options.append(OptionSpec(id=new, text=names.get(token, token))) return new pairs = [[option_for(p[0]), option_for(p[1])] for p in m.pairs if len(p) >= 2] m.pairs = pairs by_id = {o.id: o for o in ix.options} for left, right in pairs: by_id[left].pair_with, by_id[right].pair_with = right, left m.correct_ids = [o.id for o in ix.options] elif t == "drag_drop": zones = [e for e in ix.elements if e.role == "zone"] for o in ix.options: if o.target_zone_id not in {z.id for z in zones}: named = [z.id for z in zones if norm_ar(z.name) == norm_ar(o.target_zone_id)] o.target_zone_id = named[0] if named else o.target_zone_id m.zones = [z.id for z in zones] m.correct_ids = [o.id for o in ix.options] elif t in ("choice", "image_choice", "scene_element", "branching_decision"): right = [o.id for o in ix.options if o.is_correct] if len(right) != 1: named = [i for i in m.correct_ids if i in ids] chosen = named[0] if len(named) == 1 else (right[0] if right else None) if chosen: for o in ix.options: o.is_correct = o.id == chosen right = [chosen] m.correct_ids = right return ix async def run_json_task(agent_factory: Callable[[], Agent], prompt: str, Schema, label: str, extra_validate: Optional[Callable[[Any], list]] = None, expected_output: str = "JSON صالح فقط، بلا أي نص قبله أو بعده، مطابق للـ skeleton المطلوب."): """يشغّل الـ Crew ← يستخرج JSON ← Schema.model_validate ← extra_validate (يرجع [(severity, msg)]). الأخطاء الهيكلية تُعاد المحاولة حتى max_retries ثم تُرمى؛ الأسلوبية تُعاد المحاولة ثم تُقبل في الآخر مع تحذير.""" last_err, feedback = None, "" style_only_result = None for attempt in range(1, RUN_CONFIG["max_retries"] + 1): log(f"{label} — محاولة {attempt}", "run") raw = await kickoff_crew(agent_factory(), prompt + feedback, expected_output) try: data = parse_json_safe(raw) obj = Schema.model_validate(data) obj = settle_interaction(obj) if isinstance(obj, InteractionOut) else obj issues = list(extra_validate(obj)) if extra_validate else [] structural = [i for i in issues if i[0] == "structural"] if not issues: log(f"{label} — ✓ تحقق كامل", "ok") return obj if not structural: style_only_result = (obj, issues) raise ValidationIssue(issues) except (ValueError, ValidationError, ValidationIssue, KeyError, TypeError) as e: last_err = e msg = _issues_text(e.issues) if isinstance(e, ValidationIssue) else str(e)[:1500] log(f"{label} — فشل التحقق: {msg[:300]}", "warn") feedback = ("\n\n=== تصحيح إلزامي ===\nمخرجك السابق فشل التحقق للأسباب التالية، أعد إخراج JSON كاملًا (ليس فرقًا) بعد معالجتها:\n" f"{msg}\n") feedback += f"مخرجك السابق (مقتطع) — أصلح ما ذُكر فقط:\n{str(raw)[:4000]}\n" if style_only_result is not None: obj, issues = style_only_result log(f"{label} — قُبل مع مخالفات أسلوبية: {_issues_text(issues)}", "warn") _STYLE_WARNINGS.append({"label": label, "issues": [m for _, m in issues]}) return obj raise RuntimeError(f"{label}: فشل التحقق الهيكلي بعد {RUN_CONFIG['max_retries']} محاولات — {last_err}") _STYLE_WARNINGS: list = [] # ══════════════════════════════════════════════════════════════════════ # خلية [9] من النوتبوك # ══════════════════════════════════════════════════════════════════════ # @title 9) تعريف الوكلاء (أدوار عامة غير مرتبطة بمجال) def make_agent(role: str, goal: str, backstory: str, llm) -> Agent: # The platform hands a factory: build the model now, with the current key. llm = llm() if callable(llm) else llm if llm is None: raise RuntimeError("لا يوجد LLM: أضف OPENROUTER_API_KEY في Colab Secrets (أو متغير بيئة) ثم أعد تشغيل خلية الإعداد.") return Agent(role=role, goal=goal, backstory=backstory, llm=llm, verbose=False, allow_delegation=False, max_iter=3, cache=False) _COMMON_BACK = ("تعمل ضمن فريق إنتاج محتوى تعليمي تفاعلي يلتزم حرفيًا بملف معايير معتمد. " "تكتب بالعربية الفصحى المبسّطة فقط، وتُخرج JSON صالحًا فقط عندما يُطلب منك ذلك.") def agent_analyst(): return make_agent("محلل محتوى تعليمي", "استخراج بنية المحتوى الخام كاملةً دون إسقاط أي معلومة، وتحديد المهارة والموقف الواقعي القابل للمحاكاة.", "خبير تحليل محتوى تدريبي ومعرفي، دقيق في تقسيم المحتوى إلى كتل مرتبة ورصد المخاطر والإجراءات العملية. " + _COMMON_BACK, llm_reasoning) def agent_designer(): return make_agent("مصمم تعليمي لألعاب المحاكاة", "تحويل التحليل إلى مخطط لعبة محاكاة متكامل: قصة، مسار مهام، نظام واجهة (وقت/تقدم/تلميح)، سلامة، ونظام بصري موحد.", "خبير تصميم تعليمي قائم على المحاكاة والتعلم بالممارسة، يبني مسارات مهام واقعية يشعر فيها المتدرب أنه داخل الموقف لا أمام أسئلة. " + _COMMON_BACK, llm_reasoning) def agent_interaction(): return make_agent("مصمم تفاعلات ألعاب تعليمية", "تصميم التفاعل الكامل لمهمة واحدة: العناصر، الآلية، الإجابة الصحيحة والمشتتات، التلميح، التغذية الراجعة، المؤثرات، والانتقال.", "خبير تصميم تفاعلات (اختيار/سحب وإفلات/ترتيب/مطابقة/سلاسل إجراءات) يربط كل تفاعل بالمهارة المقيسة وبتمثيل بصري واضح داخل البيئة. " + _COMMON_BACK, llm_reasoning) def agent_writer(): return make_agent("كاتب نصوص محتوى تعليمي تفاعلي", "كتابة كل النصوص الظاهرة على الشاشة بلغة عربية بسيطة مترابطة ومتسقة الصوت عبر المشاهد، وبالأطوال المحددة.", "كاتب سيناريو تعليمي يجيد الجمل القصيرة الواضحة لجمهور قد يجد صعوبة في القراءة، ويحافظ على نبرة مشجعة ومحترمة. " + _COMMON_BACK, llm_writer) def agent_visual(): return make_agent("مخرج بصري وحركي لمحتوى تعليمي", "تحويل كل سطر نص إلى beat بصري قابل للتنفيذ (فكرة بصرية، حركة/تكوين، نص على الشاشة وموضعه، انتقال) ثم وصف سردي تنفيذي للمشهد.", "مخرج موشن وتجربة مستخدم يصف المشاهد وصفًا تنفيذيًا دقيقًا للمصمم بالعربية دون توليد صور أو أوامر صور، ويحافظ على هوية الشخصية والنظام البصري. " + _COMMON_BACK, llm_visual) def agent_reviewer(): return make_agent("مراجع جودة محتوى تعليمي", "مراجعة المخرجات مقابل المعايير الملزمة وإرجاع قائمة مشكلات دقيقة قابلة للتصحيح لكل مشهد.", "مدقق جودة صارم يفحص المطابقة للمعايير والاتساق بين المشاهد وسلامة اللغة ووضوح التعليمات، ولا يختلق مشكلات غير موجودة. " + _COMMON_BACK, llm_reasoning) def agent_covers(): return make_agent("مصمم أغلفة وعناصر ختامية", "تصميم غلاف اللعبة وغلاف الملف التنفيذي من العناصر الحقيقية للمشاهد.", "مصمم واجهات تعليمية يستخرج أقوى العناصر البصرية من المشاهد الفعلية لبناء غلاف جذاب متسق. " + _COMMON_BACK, llm_visual) # ══════════════════════════════════════════════════════════════════════ # خلية [10] من النوتبوك # ══════════════════════════════════════════════════════════════════════ # @title 10) أدوات الـ Lint الآلي (Python) — كل معيار قابل للقياس له فحص هنا _GEO_WORDS = ["سعود", "مصر", "خليج", "إمارات", "كويت", "قطر", "عُمان", "عمان", "البحرين", "الأردن", "لبنان", "سوري", "عراق", "مغرب", "تونس", "جزائر", "ليبي", "سودان", "يمن", "الرياض", "جدة", "القاهرة", "دبي", "كبسة", "منسف", "كشري", "ثوب", "عباءة", "جلابية"] def _issue(scene_number, target, problem, fix, severity="style", source="lint"): return ReviewIssue(scene_number=scene_number, target=target, problem=problem, fix=fix, severity=severity, source=source) def lint_text(text: str, inp, where: str, scene_number: int = 0, target: str = "scripts") -> list: out = [] ts = inp.type_settings lat = latin_tokens(text, ts.allowed_latin_terms) if lat: out.append(_issue(scene_number, target, f"{where}: كلمات لاتينية غير مسموحة: {sorted(set(lat))[:6]}", "استبدلها بمقابل عربي أو أضفها إلى allowed_latin_terms")) for w in ts.forbidden_words: if w and w in text: out.append(_issue(scene_number, target, f"{where}: كلمة ممنوعة «{w}»", "استبدل الكلمة الممنوعة", "structural")) if not inp.geo_context.strip(): hits = [g for g in _GEO_WORDS if g in text] if hits: out.append(_issue(scene_number, target, f"{where}: إشارة جغرافية/ثقافية رغم أن السياق عام: {hits}", "احذف الهوية الجغرافية واجعل الوصف عامًا")) if arabic_ratio(text) < 0.85 and count_words(text) > 3: out.append(_issue(scene_number, target, f"{where}: نسبة الحروف العربية منخفضة", "أعد الكتابة بالعربية")) return out def lint_interaction(ix: InteractionOut, inp, scene_number: int) -> list: """فحوص هيكلية حسب نوع التفاعل + قيود التغذية الراجعة والتلميح.""" out, M = [], MEASURABLE t = ix.interaction_type opts = ix.options ids = [o.id for o in opts] if len(ids) != len(set(ids)): out.append(_issue(scene_number, "interactions", f"{ix.task_id}: معرفات خيارات مكررة", "اجعل id فريدًا", "structural")) n_correct = sum(1 for o in opts if o.is_correct) if t in ("choice", "image_choice", "scene_element", "branching_decision"): if not (M["min_options"] <= len(opts) <= max(M["max_options"], inp.size.max_options_per_task)): out.append(_issue(scene_number, "interactions", f"{ix.task_id}: عدد الخيارات {len(opts)} خارج [{M['min_options']},{inp.size.max_options_per_task}]", "اضبط عدد الخيارات", "structural")) if n_correct != 1: out.append(_issue(scene_number, "interactions", f"{ix.task_id}: يجب أن يكون هناك خيار صحيح واحد بالضبط (الحالي {n_correct})", "حدد is_correct لخيار واحد", "structural")) if t in ("image_choice", "scene_element", "choice") and any(not o.visual_description.strip() for o in opts): out.append(_issue(scene_number, "interactions", f"{ix.task_id}: كل خيار يحتاج وصفًا بصريًا (أيقونة/صورة الشخصية وهي تنفذه)", "أضف visual_description لكل خيار", "structural")) if t == "branching_decision" and any(not o.consequence.strip() for o in opts): out.append(_issue(scene_number, "interactions", f"{ix.task_id}: كل قرار يحتاج نتيجة ظاهرة (consequence)", "أضف consequence", "structural")) elif t == "drag_drop": zones = [e for e in ix.elements if e.role == "zone"] zone_ids = {e.id for e in zones} if len(zones) < 2: out.append(_issue(scene_number, "interactions", f"{ix.task_id}: السحب والإفلات يحتاج منطقتي إسقاط على الأقل (elements.role='zone')", "أضف مناطق إسقاط", "structural")) if len(opts) < 1: out.append(_issue(scene_number, "interactions", f"{ix.task_id}: لا توجد عناصر قابلة للسحب (options)", "أضف عناصر", "structural")) bad = [o.id for o in opts if o.target_zone_id not in zone_ids] if bad: out.append(_issue(scene_number, "interactions", f"{ix.task_id}: عناصر بلا منطقة إسقاط صحيحة: {bad}", "اضبط target_zone_id لكل عنصر على id منطقة موجودة", "structural")) elif t in ("ordering", "action_sequence"): if len(opts) < M["ordering_min_steps"]: out.append(_issue(scene_number, "interactions", f"{ix.task_id}: الترتيب/السلسلة تحتاج {M['ordering_min_steps']} خطوات على الأقل", "أضف خطوات", "structural")) if sorted(ix.mechanics.order) != sorted(ids) or not ids: out.append(_issue(scene_number, "interactions", f"{ix.task_id}: mechanics.order يجب أن يكون تبديلًا كاملًا لمعرفات الخطوات", "اضبط order", "structural")) if t == "action_sequence" and any(not o.action.strip() for o in opts): out.append(_issue(scene_number, "interactions", f"{ix.task_id}: كل خطوة في السلسلة تحتاج action", "أضف action", "structural")) elif t == "matching": if len(ix.mechanics.pairs) < M["matching_min_pairs"]: out.append(_issue(scene_number, "interactions", f"{ix.task_id}: المطابقة تحتاج {M['matching_min_pairs']} أزواج على الأقل", "أضف أزواجًا", "structural")) flat = {x for p in ix.mechanics.pairs for x in p} if not flat.issubset(set(ids)): out.append(_issue(scene_number, "interactions", f"{ix.task_id}: أزواج المطابقة تشير إلى معرفات غير موجودة في options", "اضبط pairs/ids", "structural")) if any(len(p) != 2 for p in ix.mechanics.pairs): out.append(_issue(scene_number, "interactions", f"{ix.task_id}: كل زوج يجب أن يكون عنصرين", "اضبط pairs", "structural")) # التغذية الراجعة for lbl, fb in (("الإيجابية", ix.feedback_positive), ("السلبية", ix.feedback_negative)): total_lines = line_count(fb.title) + line_count(fb.body) if total_lines > M["feedback_max_lines"]: out.append(_issue(scene_number, "interactions", f"{ix.task_id}: التغذية الراجعة {lbl} {total_lines} أسطر > {M['feedback_max_lines']}", "اختصرها إلى ثلاثة أسطر", "structural")) if count_words(fb.title + " " + fb.body) > M["feedback_max_words"]: out.append(_issue(scene_number, "interactions", f"{ix.task_id}: التغذية الراجعة {lbl} أطول من {M['feedback_max_words']} كلمة", "اختصر")) if not fb.button.strip(): out.append(_issue(scene_number, "interactions", f"{ix.task_id}: زر التغذية الراجعة {lbl} فارغ", "أضف نص الزر", "structural")) # السلبية لا تكشف الإجابة، والتلميح لا يكشفها ans = norm_ar(ix.mechanics.correct_answer) if ans and len(ans) > 6: if ans in norm_ar(ix.feedback_negative.body + " " + ix.feedback_negative.title): out.append(_issue(scene_number, "interactions", f"{ix.task_id}: التغذية الراجعة السلبية تكشف الإجابة الصحيحة حرفيًا", "أعد صياغتها كتلميح دون الإجابة", "structural")) if ans in norm_ar(ix.hint): out.append(_issue(scene_number, "interactions", f"{ix.task_id}: التلميح يكشف الإجابة الصحيحة حرفيًا", "وجّه إلى المعلومة دون الإجابة", "structural")) if count_words(ix.hint) > M["hint_max_words"]: out.append(_issue(scene_number, "interactions", f"{ix.task_id}: التلميح أطول من {M['hint_max_words']} كلمة", "اختصر")) if count_words(ix.instruction) > M["instruction_max_words"]: out.append(_issue(scene_number, "interactions", f"{ix.task_id}: التعليمة أطول من {M['instruction_max_words']} كلمة", "اختصر")) if count_words(ix.clue) > M["clue_max_words"]: out.append(_issue(scene_number, "interactions", f"{ix.task_id}: الدليل أطول من {M['clue_max_words']} كلمة", "اختصر")) for o in opts: if count_words(o.text) > M["option_text_max_words"]: out.append(_issue(scene_number, "interactions", f"{ix.task_id}: نص الخيار «{o.text[:20]}…» أطول من {M['option_text_max_words']} كلمات", "اختصر")) if not ix.effects.success or not ix.effects.error: out.append(_issue(scene_number, "interactions", f"{ix.task_id}: المؤثرات ناقصة (نجاح/خطأ)", "أضف مؤثرات النجاح والخطأ", "structural")) if ix.transition.type == "button" and not ix.transition.text.strip(): out.append(_issue(scene_number, "interactions", f"{ix.task_id}: زر الانتقال بلا نص", "أضف نص الزر", "structural")) if not ix.environment_state_before.strip() or not ix.environment_state_after.strip(): out.append(_issue(scene_number, "interactions", f"{ix.task_id}: حالة البيئة قبل/بعد ناقصة", "صف الحالة قبل وبعد", "structural")) # نصوص for where, txt in (("الدليل", ix.clue), ("التعليمة", ix.instruction), ("التلميح", ix.hint), ("التغذية الإيجابية", ix.feedback_positive.title + " " + ix.feedback_positive.body), ("التغذية السلبية", ix.feedback_negative.title + " " + ix.feedback_negative.body)): out.extend(lint_text(txt, inp, f"{ix.task_id}/{where}", scene_number, "interactions")) return out def lint_blueprint(bp: BlueprintOut, inp) -> list: out, ts = [], inp.type_settings if len(bp.tasks) != inp.size.tasks_count: out.append(("structural", f"عدد المهام {len(bp.tasks)} ≠ المطلوب {inp.size.tasks_count}")) if len(bp.objectives) != len(bp.subtopics): out.append(("structural", f"عدد الأهداف ({len(bp.objectives)}) ≠ عدد الموضوعات الفرعية ({len(bp.subtopics)})")) if len(bp.subtopics) != inp.size.tasks_count: out.append(("structural", f"عدد الموضوعات الفرعية ({len(bp.subtopics)}) يجب أن يساوي عدد المهام ({inp.size.tasks_count})")) if inp.optional.title and bp.title.strip() != inp.optional.title.strip(): out.append(("structural", f"العنوان مفروض «{inp.optional.title}» ولا يجوز تغييره")) if inp.optional.subtopics and [s.strip() for s in bp.subtopics] != [s.strip() for s in inp.optional.subtopics]: out.append(("structural", "الموضوعات الفرعية مفروضة من المدخلات ويجب نقلها حرفيًا بنفس الترتيب")) if inp.optional.objectives and [s.strip() for s in bp.objectives] != [s.strip() for s in inp.optional.objectives]: out.append(("structural", "الأهداف مفروضة من المدخلات ويجب نقلها حرفيًا بنفس الترتيب")) if inp.game_pattern != "auto" and bp.game_pattern != inp.game_pattern: out.append(("structural", f"نمط البناء مفروض: {inp.game_pattern}")) allowed = _interaction_allowed(inp) orders = [t.order for t in bp.tasks] if orders != list(range(1, len(bp.tasks) + 1)): out.append(("structural", "ترتيب المهام (order) يجب أن يكون 1..N متتابعًا")) if len({t.task_id for t in bp.tasks}) != len(bp.tasks): out.append(("structural", "task_id مكرر")) for i, t in enumerate(bp.tasks): if t.interaction_type not in allowed: out.append(("structural", f"المهمة {t.task_id}: نوع تفاعل غير مسموح «{t.interaction_type}» (المسموح: {allowed})")) if ts.forced_interactions and t.interaction_type != ts.forced_interactions[i]: out.append(("structural", f"المهمة {t.task_id}: نوع التفاعل مفروض = {ts.forced_interactions[i]}")) if not t.environment.strip() or not t.situation.strip() or not t.skill.strip(): out.append(("structural", f"المهمة {t.task_id}: البيئة/الموقف/المهارة ناقصة")) if bp.game_pattern == "hub_stations" and not t.station_name.strip(): out.append(("structural", f"المهمة {t.task_id}: نمط المحطات يتطلب station_name")) if bp.game_pattern == "card_sorting" and t.interaction_type != "drag_drop": out.append(("structural", f"المهمة {t.task_id}: نمط فرز البطاقات يتطلب drag_drop")) if bp.game_pattern == "hub_stations" and len({t.environment.strip() for t in bp.tasks}) > 2 and inp.game_pattern == "auto": out.append(("style", "نمط المحطات يفترض بيئة رئيسية واحدة؛ بيئات المهام متعددة جدًا")) # المؤقت if ts.timer.enabled: if not bp.timer.enabled or not bp.timer.phases: out.append(("structural", "المؤقت مفعّل في الإعدادات ويجب أن يحتوي phases (ألوان × ثوانٍ)")) else: tot = sum(int(p.get("seconds", 0)) for p in bp.timer.phases) if tot != ts.timer.total_seconds: out.append(("structural", f"مجموع ثواني مراحل المؤقت {tot} ≠ {ts.timer.total_seconds}")) if not bp.timer.starts_on.strip(): out.append(("structural", "حدد متى يبدأ العد (starts_on)")) elif bp.timer.enabled: out.append(("structural", "المؤقت معطّل في الإعدادات ولا يجوز تفعيله")) if ts.progress_indicator.enabled: if not bp.progress.enabled or bp.progress.segments != inp.size.tasks_count: out.append(("structural", f"مؤشر التقدم: segments يجب أن تساوي عدد المهام ({inp.size.tasks_count})")) if not bp.progress.completion_effect.strip(): out.append(("structural", "مؤشر التقدم: صف أثر الإكمال البصري/الصوتي")) if ts.hint.mode != "none" and not bp.hint.icon_description.strip(): out.append(("structural", "التلميح: صف أيقونة التلميح وموضعها")) if ts.hint.mode in ("general", "both") and not bp.hint.general_hint.strip(): out.append(("structural", "مطلوب تلميح عام (general_hint)")) # السلامة M = MEASURABLE if ts.safety_instructions == "required" and not bp.safety.needed: out.append(("structural", "تعليمات السلامة مطلوبة إلزاميًا")) if ts.safety_instructions == "none" and bp.safety.needed: out.append(("structural", "تعليمات السلامة معطّلة في الإعدادات")) if bp.safety.needed: n = len(bp.safety.rules) if not (M["safety_rules_min"] <= n <= M["safety_rules_max"]): out.append(("structural", f"عدد قواعد السلامة {n} خارج [{M['safety_rules_min']},{M['safety_rules_max']}]")) for r in bp.safety.rules: if not str(r.get("text", "")).strip() or not str(r.get("icon_description", "")).strip(): out.append(("structural", "كل قاعدة سلامة تحتاج text و icon_description")) elif count_words(r["text"]) > M["safety_rule_max_words"]: out.append(("style", f"قاعدة السلامة «{r['text'][:20]}…» أطول من {M['safety_rule_max_words']} كلمات")) if not bp.safety.intro_text.strip(): out.append(("structural", "تعليمات السلامة تحتاج intro_text")) for f in ("character_sheet", "environment_sheet", "ui_sheet", "style"): if not getattr(bp.visual_system, f).strip(): out.append(("structural", f"النظام البصري: الحقل {f} فارغ")) if ts.timer.enabled and ts.failure_scenario and not bp.failure_outcome.strip(): out.append(("structural", "مطلوب failure_outcome (سيناريو انتهاء الوقت)")) # نصوص blob = " ".join([bp.title, bp.story.problem_or_mission, bp.environment_main, bp.ending_outcome] + bp.subtopics + bp.objectives) for i in lint_text(blob, inp, "المخطط", 0, "blueprint"): out.append((i.severity, i.problem)) return out def lint_scripts(sc: ScriptsOut, scene_plan: list, interactions: dict, inp) -> list: """هيكل المشاهد مقابل خطة المشاهد + الأنواع المطلوبة من السطور + الأطوال.""" out, M = [], MEASURABLE plan_ids = [s["scene_id"] for s in scene_plan] got_ids = [s.scene_id for s in sc.scenes] if got_ids != plan_ids: out.append(("structural", f"ترتيب/معرفات المشاهد يجب أن تطابق الخطة حرفيًا: {plan_ids} (المستلم: {got_ids})")) return out for plan, scene in zip(scene_plan, sc.scenes): kinds = [l.kind for l in scene.lines] if scene.scene_number != plan["scene_number"]: out.append(("structural", f"{scene.scene_id}: scene_number يجب أن يكون {plan['scene_number']}")) missing = [k for k in plan["required_line_kinds"] if k not in kinds] if missing: out.append(("structural", f"{scene.scene_id}: سطور ناقصة من الأنواع: {missing}")) if any(not l.text.strip() for l in scene.lines): out.append(("structural", f"{scene.scene_id}: سطر فارغ")) if plan["scene_type"] == "task": ix = interactions[plan["task_id"]] n_opt_lines = sum(1 for k in kinds if k == "option") if ix.options and n_opt_lines != len(ix.options): out.append(("structural", f"{scene.scene_id}: عدد سطور option ({n_opt_lines}) يجب أن يساوي عدد خيارات التفاعل ({len(ix.options)})")) opt_refs = [l.ref_id for l in scene.lines if l.kind == "option"] if ix.options and sorted(opt_refs) != sorted(o.id for o in ix.options): out.append(("structural", f"{scene.scene_id}: ref_id لسطور option يجب أن تطابق معرفات الخيارات: {[o.id for o in ix.options]}")) for lbl, pref in (("الإيجابية", "feedback_positive"), ("السلبية", "feedback_negative")): fb_lines = [l.text for l in scene.lines if l.kind.startswith(pref)] n_lines = sum(line_count(t) for t in fb_lines) if n_lines > M["feedback_max_lines"]: out.append(("structural", f"{scene.scene_id}: التغذية الراجعة {lbl} تتجاوز {M['feedback_max_lines']} أسطر ({n_lines})")) if count_words(" ".join(fb_lines)) > M["feedback_max_words"]: out.append(("style", f"{scene.scene_id}: التغذية الراجعة {lbl} أطول من {M['feedback_max_words']} كلمة")) fbn = " ".join(l.text for l in scene.lines if l.kind.startswith("feedback_negative")) ans = norm_ar(ix.mechanics.correct_answer) if ans and len(ans) > 6: if ans in norm_ar(fbn): out.append(("structural", f"{scene.scene_id}: التغذية السلبية تكشف الإجابة")) hint_txt = " ".join(l.text for l in scene.lines if l.kind == "hint") if ans in norm_ar(hint_txt): out.append(("structural", f"{scene.scene_id}: التلميح يكشف الإجابة")) for l in scene.lines: if l.kind == "instruction" and count_words(l.text) > M["instruction_max_words"]: out.append(("style", f"{scene.scene_id}: التعليمة أطول من {M['instruction_max_words']} كلمة")) if l.kind == "hint" and count_words(l.text) > M["hint_max_words"]: out.append(("style", f"{scene.scene_id}: التلميح أطول من {M['hint_max_words']} كلمة")) if l.kind == "option" and count_words(l.text) > M["option_text_max_words"]: out.append(("style", f"{scene.scene_id}: نص خيار أطول من {M['option_text_max_words']} كلمات")) if plan["scene_type"] == "safety": n_rules = sum(1 for k in kinds if k == "rule") if n_rules != plan.get("rules_count", n_rules): out.append(("structural", f"{scene.scene_id}: عدد سطور rule ({n_rules}) يجب أن يساوي {plan.get('rules_count')}")) blob = "\n".join(l.text for l in scene.lines) for i in lint_text(blob, inp, scene.scene_id, scene.scene_number, "scripts"): out.append((i.severity, i.problem)) return out def opening_length_check(sc: ScriptsOut, inp) -> tuple: """يرجع (within_range, actual, target).""" target = inp.size.opening_words tol = RUN_CONFIG["length_tolerance"] op = next((s for s in sc.scenes if s.scene_type == "opening"), None) actual = count_words(" ".join(l.text for l in op.lines)) if op else 0 return (target * (1 - tol) <= actual <= target * (1 + tol)), actual, target def lint_visual(v: VisualOut, scene: SceneScript, inp) -> list: out = [] n = len(scene.lines) if len(v.beats) != n: out.append(("structural", f"{scene.scene_id}: عدد الـ beats ({len(v.beats)}) يجب أن يساوي عدد السطور ({n})")) idx = [b.line_index for b in v.beats] if idx != list(range(1, len(v.beats) + 1)): out.append(("structural", f"{scene.scene_id}: line_index يجب أن يكون 1..{n} بالترتيب")) for b in v.beats: if not all(getattr(b, f).strip() for f in ("visual_idea", "motion", "on_screen_text", "text_position", "transition")): out.append(("structural", f"{scene.scene_id}: beat {b.line_index} فيه حقل فارغ")) if count_words(v.narrative_description) < MEASURABLE["narrative_min_words"]: out.append(("style", f"{scene.scene_id}: الوصف السردي أقصر من {MEASURABLE['narrative_min_words']} كلمة")) blob = v.narrative_description + " " + " ".join(b.visual_idea + " " + b.motion for b in v.beats) for i in lint_text(blob, inp, f"{scene.scene_id}/الوصف البصري", scene.scene_number, "visual"): out.append((i.severity, i.problem)) return out def lint_all(inp, blueprint: BlueprintOut, interactions: dict, scripts: ScriptsOut, visuals: dict, scene_plan: list) -> list: """Lint شامل بعد اكتمال الخط — يرجع قائمة ReviewIssue (تُدمج مع مراجعة LLM).""" issues: list = [] ts = inp.type_settings sid2num = {s["scene_id"]: s["scene_number"] for s in scene_plan} for s in scene_plan: if s["scene_type"] == "task": issues.extend(lint_interaction(interactions[s["task_id"]], inp, s["scene_number"])) for sev, msg in lint_scripts(scripts, scene_plan, interactions, inp): m = re.match(r"(\S+?):", msg) issues.append(_issue(sid2num.get(m.group(1), 0) if m else 0, "scripts", msg, "أعد كتابة السطر المعني", sev)) for scene in scripts.scenes: if scene.scene_id in visuals: for sev, msg in lint_visual(visuals[scene.scene_id], scene, inp): issues.append(_issue(scene.scene_number, "visual", msg, "أعد الوصف البصري للمشهد", sev)) all_text = "\n".join(l.text for s in scripts.scenes for l in s.lines) # المؤقت ليس شكليًا: يجب أن تُذكر فكرة الوقت في النصوص الظاهرة عند تفعيله if ts.timer.enabled and not re.search(r"ثانية|ثوان|الوقت|المؤقت|دقيق", all_text): issues.append(_issue(sid2num.get("opening", 1), "scripts", "المؤقت مفعّل لكن لا يوجد أي نص ظاهر يربط المتدرب بالوقت", "أضف إشارة إلى الوقت في المشهد الافتتاحي أو شاشة البدء", "style")) # شاشة البدء start = next((s for s in scripts.scenes if s.scene_type == "start"), None) if start and not any(l.kind == "button" for l in start.lines): issues.append(_issue(start.scene_number, "scripts", "شاشة البدء بلا زر", "أضف زر «ابدأ اللعبة»", "structural")) # النهاية تغلق القصة: تقاطع كلمات مع مشكلة البداية ending = next((s for s in scripts.scenes if s.scene_type == "ending"), None) if ending: prob_words = {w for w in norm_ar(blueprint.story.problem_or_mission).split() if len(w) > 3} end_words = set(norm_ar(" ".join(l.text for l in ending.lines)).split()) if prob_words and len(prob_words & end_words) < 2: issues.append(_issue(ending.scene_number, "scripts", "شاشة النهاية لا تشير بوضوح إلى مشكلة/مهمة البداية (ارتباط النهاية بالقصة)", "اذكر صراحةً أن المشكلة عولجت أو أن المهمة اكتملت داخل البيئة نفسها", "structural")) if ts.replay_options and not any(l.kind == "replay_button" for l in ending.lines): issues.append(_issue(ending.scene_number, "scripts", "شاشة النهاية بلا زر إعادة", "أضف زر «أعِد التشغيل»", "structural")) # السلامة قبل أول مهمة خطرة if blueprint.safety.needed: order = [s["scene_type"] for s in scene_plan] if "safety" not in order or order.index("safety") > order.index("task"): issues.append(_issue(0, "blueprint", "تعليمات السلامة يجب أن تظهر قبل أول مهمة", "أعد ترتيب المشاهد", "structural")) return issues # ══════════════════════════════════════════════════════════════════════ # خلية [11] من النوتبوك # ══════════════════════════════════════════════════════════════════════ # @title 11) الخطوة 1 — محلل المحتوى → analysis.json ANALYSIS_SKELETON = """{ "domain": "المجال المعرفي للمحتوى", "audience_summary": "ملخص الجمهور وما يترتب عليه في اللغة والتفاعل", "central_idea": "الفكرة المحورية في جملة", "target_skill": "المهارة أو الإجراء العملي الذي سيطبّقه المتدرب داخل المحاكاة", "realistic_setting": "الموقف/المكان الواقعي القابل للتمثيل بصريًا", "main_problem": "المشكلة أو المهمة التي سيواجهها المتدرب داخل البيئة", "content_blocks": [ {"index": 1, "title": "عنوان الكتلة", "text": "نص الكتلة كاملًا بترتيبه الأصلي دون إسقاط معلومة", "hazards": ["خطر مرتبط إن وُجد"], "candidate_task": "فكرة مهمة محاكاة مقترحة من هذه الكتلة"} ], "hazards_overall": ["قائمة المخاطر/الاحتياطات في المحتوى كله"], "suggested_pattern": "hub_stations | sequential_missions | card_sorting", "pattern_reason": "سبب اختيار النمط", "suggested_tasks_count": 4 }""" def _analysis_validate_factory(inp: ProjectInput): def _analysis_validate(a: AnalysisOut) -> list: out = [] idx = [b.index for b in a.content_blocks] if idx != list(range(1, len(idx) + 1)): out.append(("structural", "content_blocks.index يجب أن يكون 1..N بالترتيب")) if sum(count_words(b.text) for b in a.content_blocks) < 0.6 * count_words(inp.content.raw_text): out.append(("structural", "كتل المحتوى تغطي أقل من 60% من كلمات المحتوى الخام — لا تُسقط معلومات")) if not a.target_skill.strip() or not a.main_problem.strip(): out.append(("structural", "target_skill و main_problem إلزاميان")) return out return _analysis_validate async def step_analysis(inp: ProjectInput) -> AnalysisOut: patterns_txt = "\n".join(f"- {k}: {v['when']}" for k, v in GAME_PATTERNS.items()) prompt = f"""#TASK=analysis #SCENE=0 {project_context_block(inp)} === المحتوى الخام === العنوان: {inp.content.source_title or '-'} {inp.content.raw_text} === المعايير الملزمة === {STD_CORE} {STD_LANGUAGE} === أنماط البناء المتاحة (اقترح الأنسب) === {patterns_txt} {'النمط مفروض من الإعدادات: ' + inp.game_pattern if inp.game_pattern != 'auto' else ''} === المطلوب === 1. حدّد المجال والجمهور والفكرة المحورية والمهارة العملية المستهدفة والموقف الواقعي القابل للمحاكاة والمشكلة الرئيسية. 2. قسّم المحتوى إلى كتل مرتبة بترتيبها الأصلي، وانقل نص كل كتلة كاملًا دون إسقاط أي معلومة أو رقم أو شرط. 3. لكل كتلة: المخاطر/الاحتياطات المرتبطة بها، وفكرة مهمة محاكاة يمكن بناؤها منها{'' if inp.size.tasks_auto else f' (يجب أن تكفي الكتل لبناء {inp.size.tasks_count} مهام)'}. 4. اقترح نمط البناء الأنسب مع السبب، و{'العدد الأنسب للمهام (2–8) بحسب حجم المحتوى: فكرة/مهارة واحدة لكل مهمة، دون حشو ودون إسقاط مهارة' if inp.size.tasks_auto else f'ضع suggested_tasks_count = {inp.size.tasks_count} (محدد مسبقًا)'}. 5. أخرج JSON فقط بالهيكل التالي حرفيًا: {ANALYSIS_SKELETON} """ a = await run_json_task(agent_analyst, prompt, AnalysisOut, "محلل المحتوى", _analysis_validate_factory(inp)) if inp.size.tasks_auto: inp.size.tasks_count = a.suggested_tasks_count log(f"عدد المهام (تلقائي من المحتوى): {inp.size.tasks_count}", "ok") save_json(a.model_dump(), "analysis.json") return a # analysis = await step_analysis(INPUT) # ══════════════════════════════════════════════════════════════════════ # خلية [12] من النوتبوك # ══════════════════════════════════════════════════════════════════════ # @title 12) الخطوة 2 — المصمم التعليمي → blueprint.json (+ validator النمط + خطة المشاهد) BLUEPRINT_SKELETON = """{ "title": "عنوان اللعبة (قصير وجذاب)", "game_pattern": "hub_stations | sequential_missions | card_sorting", "subtopics": ["موضوع فرعي لكل مهمة بنفس عدد المهام"], "objectives": ["هدف سلوكي قابل للقياس لكل موضوع فرعي (نفس العدد والترتيب) يبدأ بفعل مضارع"], "objectives_intro": "بنهاية اللعبة، سيكون المتدرب قادرًا على أن:", "story": {"place": "المكان", "characters": ["الشخصيات الظاهرة"], "problem_or_mission": "المشكلة/المهمة", "reason": "سبب بدء المهمة", "what_is_required": "المطلوب من المتدرب داخل القصة"}, "environment_main": "وصف البيئة الرئيسية وحالتها الأولية (ما يظهر فيها من مشكلات)", "tasks": [ {"task_id": "t1", "order": 1, "name": "اسم المهمة", "skill": "المهارة المقيسة", "environment": "البيئة/الحالة", "situation": "الموقف أو المشكلة", "interaction_type": "أحد الأنواع المسموحة", "one_idea": "الفكرة الواحدة للمهمة", "content_block_indices": [1], "state_before": "حالة العنصر/البيئة قبل", "state_after": "حالتها بعد", "station_name": "اسم المحطة/الجهاز (لنمط المحطات فقط وإلا فارغ)"} ], "timer": {"enabled": true, "description": "وصف المؤقت وموضعه وأصواته", "phases": [{"color": "أخضر", "seconds": 40, "sound": "تنبيه هادئ"}, {"color": "أصفر", "seconds": 40, "sound": "تنبيه متوسط"}, {"color": "أحمر", "seconds": 40, "sound": "تنبيه خطر"}], "starts_on": "متى يبدأ العد"}, "progress": {"enabled": true, "description": "وصف المؤشر وموضعه", "segments": 4, "completion_effect": "ما يحدث عند إكمال كل مهمة وعند إكمال الكل"}, "hint": {"mode": "per_task", "icon_description": "وصف أيقونة التلميح وموضعها وحركتها", "general_hint": "نص التلميح العام إن طُلب وإلا فارغ", "auto_trigger": "متى يظهر تلقائيًا"}, "safety": {"needed": true, "reason": "لماذا", "intro_text": "النص التمهيدي المكتوب حرفًا حرفًا", "rules": [{"text": "قاعدة قصيرة", "icon_description": "وصف الأيقونة"}], "placement": "قبل أول مهمة / في البداية"}, "visual_system": {"palette": ["الألوان"], "style": "الأسلوب البصري", "character_sheet": "ورقة الشخصية: الملامح، الزي، الإكسسوارات الثابتة، التعبيرات المسموحة", "environment_sheet": "ورقة البيئة: العناصر الثابتة، الإضاءة، الكاميرا", "ui_sheet": "ورقة الواجهة: المؤقت، التقدم، التلميح، الفقاعات، الأزرار، بطاقات التغذية الراجعة", "typography": "الخط والأحجام"}, "ending_outcome": "النتيجة/الأثر الظاهر في البيئة عند النهاية وكيف تُغلق القصة", "failure_outcome": "ما يحدث عند انتهاء الوقت (إن كان المؤقت مفعّلًا) وإلا فارغ" }""" def build_scene_plan(bp: BlueprintOut, inp: ProjectInput) -> list: """خطة المشاهد تُبنى في Python (حتمية) لا بواسطة LLM.""" ts, M = inp.type_settings, MEASURABLE plan, n = [], 1 def add(scene_id, scene_type, title, required, **extra): nonlocal n plan.append({"scene_number": n, "scene_id": scene_id, "scene_type": scene_type, "title": title, "required_line_kinds": required, **extra}); n += 1 add("opening", "opening", "المشهد الافتتاحي", ["narration", "mission_brief"]) if bp.safety.needed: add("safety", "safety", "تعليمات السلامة", ["intro_typed", "rule"], rules_count=len(bp.safety.rules)) start_req = ["button"] if ts.hint.mode in ("general", "both"): start_req.append("general_hint") add("start", "start", "شاشة بدء اللعبة", start_req) task_req = list(M["task_scene_required_kinds"]) + ["feedback_positive_button", "feedback_negative_button"] if bp.game_pattern == "hub_stations": task_req = ["station_prompt"] + task_req for t in sorted(bp.tasks, key=lambda x: x.order): add(f"task_{t.order}", "task", f"المهمة {t.order}: {t.name}", task_req + ["option"], task_id=t.task_id, interaction_type=t.interaction_type) add("ending", "ending", "شاشة النهاية", ["congratulation_title", "closure_body", "impact", "replay_button"], replay_count=len(ts.replay_options)) if ts.timer.enabled and ts.failure_scenario: add("timeout", "timeout", "سيناريو انتهاء الوقت", ["message", "retry_button"]) return plan async def step_blueprint(inp: ProjectInput, analysis: AnalysisOut): pattern = inp.game_pattern if inp.game_pattern != "auto" else analysis.suggested_pattern prof = GAME_PATTERNS[pattern] it_txt = "\n".join(f"- {k} ({v['label']}): {v['desc']}" for k, v in INTERACTION_TYPES.items() if k in _interaction_allowed(inp)) forced_it = ("أنواع التفاعل مفروضة بالترتيب: " + ", ".join(inp.type_settings.forced_interactions)) if inp.type_settings.forced_interactions else "اختر نوع التفاعل لكل مهمة وفق المهارة التي تقيسها؛ غيّره بين المهام فقط عندما يخدم المهارة." ts = inp.type_settings prompt = f"""#TASK=blueprint #SCENE=0 {project_context_block(inp)} === تحليل المحتوى (JSON) === {dumps(analysis.model_dump())} === المعايير الملزمة === {STD_CORE} {STD_OPENING} {STD_SAFETY} {STD_TASK} {STD_TIMER_PROGRESS} {STD_HINTS} {STD_TRANSITIONS_ENDING} {STD_CHARACTER} {STD_LANGUAGE} === Profile نمط البناء المعتمد: {pattern} — {prof['label']} === {prof['structure']} === أنواع التفاعل المسموحة === {it_txt} {forced_it} === المطلوب === 1. العنوان (أو انقل العنوان المفروض حرفيًا)، و{inp.size.tasks_count} موضوعات فرعية (موضوع لكل مهمة) و{inp.size.tasks_count} أهداف بنفس العدد والترتيب (أو انقل المفروض حرفيًا). 2. القصة: المكان، الشخصيات، المشكلة/المهمة، سبب البدء، المطلوب من المتدرب داخل السياق. 3. خطة {inp.size.tasks_count} مهام بالضبط (order من 1 إلى {inp.size.tasks_count}): فكرة واحدة لكل مهمة، بيئة واقعية، موقف، نوع تفاعل مسموح، حالة قبل/بعد، وربطها بكتل المحتوى. {'لكل مهمة station_name (اسم الجهاز/النقطة في المشهد الرئيسي).' if pattern == 'hub_stations' else ''} {'كل المهام drag_drop (بطاقة/عنصر إلى منطقة إسقاط).' if pattern == 'card_sorting' else ''} 4. المؤقت: {'مفعّل — ' + str(ts.timer.total_seconds) + ' ثانية موزعة على مراحل لونية مجموعها بالضبط ' + str(ts.timer.total_seconds) + '، مع صوت لكل مرحلة ومتى يبدأ العد (' + ts.timer.starts_on + ').' if ts.timer.enabled else 'معطّل — enabled=false و phases فارغة.'} 5. مؤشر التقدم: {'مفعّل — segments = ' + str(inp.size.tasks_count) + '، الشكل: ' + ts.progress_indicator.style + '، ينتهي بـ ' + ts.progress_indicator.ends_with + '، مع أثر الإكمال.' if ts.progress_indicator.enabled else 'معطّل.'} 6. التلميح: الوضع {ts.hint.mode}؛ صف الأيقونة وموضعها، {'واكتب تلميحًا عامًا واحدًا.' if ts.hint.mode in ('general', 'both') else 'general_hint فارغ.'} 7. السلامة: {'إلزامية.' if ts.safety_instructions == 'required' else ('معطّلة (needed=false).' if ts.safety_instructions == 'none' else 'قرّر needed حسب وجود مخاطر في المحتوى (أدوات/كهرباء/حرارة/مواد كيميائية/سوائل ساخنة…).')} عند التفعيل: نص تمهيدي + {MEASURABLE['safety_rules_min']}–{MEASURABLE['safety_rules_max']} قواعد قصيرة (≤ {MEASURABLE['safety_rule_max_words']} كلمات) لكل منها وصف أيقونة. 8. النظام البصري الموحّد: ورقة الشخصية (التزم بسياسة الشخصيات)، ورقة البيئة، ورقة الواجهة، الألوان، الخط. 9. نتيجة النهاية داخل البيئة نفسها بما يغلق القصة{'، وسيناريو انتهاء الوقت.' if (ts.timer.enabled and ts.failure_scenario) else '.'} 10. أخرج JSON فقط بالهيكل التالي حرفيًا (game_pattern = "{pattern}"): {BLUEPRINT_SKELETON} """ bp = await run_json_task(agent_designer, prompt, BlueprintOut, "المصمم التعليمي", lambda bp: lint_blueprint(bp, inp)) if not inp.descriptor.item_name: inp.descriptor.item_name = bp.title scene_plan = build_scene_plan(bp, inp) save_json(bp.model_dump(), "blueprint.json") save_json(scene_plan, "scene_plan.json") log(f"خطة المشاهد: {[s['scene_id'] for s in scene_plan]}", "ok") return bp, scene_plan # blueprint, scene_plan = await step_blueprint(INPUT, analysis) # ══════════════════════════════════════════════════════════════════════ # خلية [13] من النوتبوك # ══════════════════════════════════════════════════════════════════════ # @title 13) الخطوة 3 — مصمم التفاعلات → interactions.json (بالتوازي، وقبل الكتابة) INTERACTION_SKELETON = """{ "task_id": "t1", "interaction_type": "نفس نوع المهمة في المخطط", "environment_state_before": "حالة البيئة/العنصر قبل التفاعل (ما يراه المتدرب)", "environment_state_after": "حالتها بعد النجاح", "clue": "الدليل القصير الذي يصف المشكلة (يظهر في إطار أعلى العنصر)", "instruction": "الإرشاد التفاعلي القصير (إطار متحرك أسفل الشاشة) يوضح طريقة التفاعل", "elements": [ {"id": "e1", "name": "اسم العنصر", "role": "target|distractor|zone|draggable|card|step|character|prop|left|right", "visual_description": "وصف بصري تنفيذي بالعربية"} ], "options": [ {"id": "o1", "text": "نص الخيار/البطاقة/الخطوة (قصير)", "is_correct": false, "visual_description": "الشخصية وهي تنفذه + الأيقونة", "target_zone_id": "", "pair_with": "", "consequence": "", "action": ""} ], "mechanics": {"description": "آلية التفاعل خطوة بخطوة", "correct_answer": "الإجابة الصحيحة للمصمم بصيغة واضحة", "correct_ids": ["o3"], "order": [], "pairs": [], "zones": []}, "hint": "تلميح لا يكشف الإجابة", "feedback_positive": {"title": "ممتاز!", "body": "سطر توضيح يشرح سبب الصحة", "button": "متابعة"}, "feedback_negative": {"title": "ليس تمامًا!", "body": "سطر توجيه دون كشف الإجابة", "button": "أعِد المحاولة"}, "effects": {"success": ["توهج العنصر الصحيح", "علامة ✓", "صوت نجاح قصير", "تحديث مؤشر التقدم"], "error": ["اهتزاز خفيف", "صوت خطأ قصير", "عودة العنصر لموضعه"], "ambient": ["أصوات البيئة"]}, "transition": {"type": "button|auto", "text": "نص زر الانتقال أو تلميح المهمة التالية"} }""" _TYPE_RULES = { "choice": "options من {mn} إلى {mx} خيارات، واحد فقط is_correct=true، لكل خيار visual_description (الشخصية وهي تنفذه). correct_ids = [id الصحيح].", "image_choice": "options من {mn} إلى {mx} صور متقاربة الحجم بوصف بصري لكل منها، واحدة فقط صحيحة، نص الخيار قصير أو اسم فقط. correct_ids = [id الصحيح].", "scene_element": "options = العناصر القابلة للضغط داخل المشهد ({mn}–{mx})، واحد فقط هو الهدف (is_correct=true)، لكل عنصر وصف بصري وموضع داخل المشهد. correct_ids = [id الهدف].", "branching_decision": "options = قرارات ({mn}–{mx}) لكل منها consequence (نتيجة ظاهرة في البيئة)، واحد فقط هو الأنسب (is_correct=true). correct_ids = [id الأنسب].", "drag_drop": "elements تحتوي مناطق إسقاط (role='zone') اثنتين على الأقل بوصف بصري؛ options = العناصر القابلة للسحب (role draggable/card) ولكل منها target_zone_id يساوي id منطقة موجودة؛ mechanics.zones = معرفات المناطق؛ correct_ids = معرفات العناصر كلها.", "ordering": "options = الخطوات/البطاقات ({mn} على الأقل) بترتيب مبعثر، و mechanics.order = معرفاتها بالترتيب الصحيح (تبديل كامل)؛ تظهر خانات مرقمة بعددها.", "action_sequence": "options = خطوات متتابعة ({mn} على الأقل) لكل منها action (ما يفعله المتدرب) وعنصر تُنفذ عليه، و mechanics.order = الترتيب الصحيح؛ يظهر العنصر في حالته قبل كل خطوة وبعدها.", "matching": "options = عناصر الجانبين (role في elements: left/right) و mechanics.pairs = أزواج [left_id, right_id] ({mn} أزواج على الأقل) تغطي كل العناصر؛ correct_ids = كل المعرفات.", } # settle_interaction works these out, so the model is not asked to keep ids in step _TYPE_RULES["ordering"] = "options = الخطوات/البطاقات ({mn} على الأقل) مكتوبة بالترتيب الصحيح من الأولى إلى الأخيرة؛ اترك mechanics.order فارغة، فالخلط وحساب الترتيب يتمان برمجيًا." _TYPE_RULES["action_sequence"] = "options = خطوات متتابعة ({mn} على الأقل) مكتوبة بالترتيب الصحيح، لكل منها action (ما يفعله المتدرب) وعنصر تُنفذ عليه؛ اترك mechanics.order فارغة، فالخلط وحساب الترتيب يتمان برمجيًا؛ يظهر العنصر في حالته قبل كل خطوة وبعدها." _TYPE_RULES["matching"] = "mechanics.pairs = أزواج [نص الطرف الأيمن, نص الطرف الأيسر] ({mn} أزواج على الأقل) بالنص نفسه لا بمعرفات؛ اترك options فارغة، فتُبنى منها الخيارات والمعرفات برمجيًا." def _type_rule(t: str, inp) -> str: mn = MEASURABLE["ordering_min_steps"] if t in ("ordering", "action_sequence") else (MEASURABLE["matching_min_pairs"] if t == "matching" else MEASURABLE["min_options"]) return _TYPE_RULES[t].format(mn=mn, mx=inp.size.max_options_per_task) async def design_interaction(inp: ProjectInput, bp: BlueprintOut, task: TaskPlan, analysis: AnalysisOut, scene_number: int, issues_feedback: str = "") -> InteractionOut: blocks = [b for b in analysis.content_blocks if b.index in task.content_block_indices] or analysis.content_blocks others = [{"order": t.order, "name": t.name, "interaction_type": t.interaction_type} for t in bp.tasks if t.task_id != task.task_id] prompt = f"""#TASK=interaction #SCENE={scene_number} #TYPE={task.interaction_type} #TASKID={task.task_id} {project_context_block(inp)} === المخطط (ملخص) === العنوان: {bp.title} | النمط: {bp.game_pattern} القصة: {dumps(bp.story.model_dump())} البيئة الرئيسية: {bp.environment_main} النظام البصري: {dumps(bp.visual_system.model_dump())} التلميح: {dumps(bp.hint.model_dump())} المهام الأخرى (للاتساق وتجنب التكرار): {dumps(others)} === المهمة المطلوب تصميمها (JSON) === {dumps(task.model_dump())} === كتل المحتوى المرتبطة === {dumps([b.model_dump() for b in blocks])} === المعايير الملزمة === {STD_TASK} {STD_VISUAL_REP} {STD_HINTS} {STD_FEEDBACK} {STD_EFFECTS} {STD_CHARACTER} {STD_LANGUAGE} قاعدة التمثيل البصري لهذا النوع: {INTERACTION_VISUAL_RULES[task.interaction_type]} قواعد الهيكل لهذا النوع ({task.interaction_type}): {_type_rule(task.interaction_type, inp)} قيود قابلة للقياس: التغذية الراجعة ≤ {MEASURABLE['feedback_max_lines']} أسطر و≤ {MEASURABLE['feedback_max_words']} كلمة؛ التعليمة ≤ {MEASURABLE['instruction_max_words']} كلمة؛ التلميح ≤ {MEASURABLE['hint_max_words']} كلمة؛ الدليل ≤ {MEASURABLE['clue_max_words']} كلمة؛ نص الخيار ≤ {MEASURABLE['option_text_max_words']} كلمات؛ التلميح والتغذية السلبية لا يحتويان الإجابة الصحيحة. === المطلوب === 1. صمّم التفاعل الكامل لهذه المهمة فقط، داخل بيئتها، بحيث يشعر المتدرب أنه يؤدي الإجراء فعلًا. 2. العناصر التفاعلية بوصف بصري تنفيذي (الشخصية المعتمدة تظهر وهي تنفذ كل خيار؛ معدات الوقاية ظاهرة عند الحاجة). 3. المشتتات معقولة ومبنية على أخطاء شائعة من المحتوى، والإجابة الصحيحة مستندة إلى المحتوى حرفيًا. 4. التلميح يوجّه إلى المعلومة دون كشف الإجابة. التغذية الإيجابية تشرح السبب، والسلبية توجّه دون كشف. 5. المؤثرات نتيجة للفعل (أصوات الأدوات، السحب، الإفلات، النجاح، الخطأ) والانتقال منطقي داخل القصة ({'زر باسم المهمة التالية أو تلميح «المهمة التالية: …»' if bp.game_pattern == 'sequential_missions' else 'العودة للمشهد الرئيسي/البطاقة التالية مع تحديث التقدم'}). 6. أخرج JSON فقط بالهيكل التالي حرفيًا: {INTERACTION_SKELETON} {issues_feedback}""" def _val(ix: InteractionOut) -> list: out = [(i.severity, i.problem) for i in lint_interaction(ix, inp, scene_number)] if ix.task_id != task.task_id: out.append(("structural", f"task_id يجب أن يكون {task.task_id}")) if ix.interaction_type != task.interaction_type: out.append(("structural", f"interaction_type يجب أن يكون {task.interaction_type}")) return out return await run_json_task(agent_interaction, prompt, InteractionOut, f"مصمم التفاعلات [{task.task_id}]", _val) async def step_interactions(inp: ProjectInput, bp: BlueprintOut, analysis: AnalysisOut, scene_plan: list) -> dict: tnum = {s["task_id"]: s["scene_number"] for s in scene_plan if s["scene_type"] == "task"} tasks = sorted(bp.tasks, key=lambda t: t.order) results = await asyncio.gather(*[design_interaction(inp, bp, t, analysis, tnum[t.task_id]) for t in tasks]) interactions = {ix.task_id: ix for ix in results} save_json({k: v.model_dump() for k, v in interactions.items()}, "interactions.json") return interactions # interactions = await step_interactions(INPUT, blueprint, analysis, scene_plan) # ══════════════════════════════════════════════════════════════════════ # خلية [14] من النوتبوك # ══════════════════════════════════════════════════════════════════════ # @title 14) الخطوة 4 — الكاتب → scripts.json (نداء واحد للترابط + حلقة ضبط الطول) LINE_KINDS_GLOSSARY = """\ أنواع السطور (kind) ومعناها: - narration: سرد/حوار المشهد الافتتاحي (المكان، الشخصيات، المشكلة، السبب) — عدة سطور قصيرة. - dialogue: جملة حوار لشخصية (اختياري) — ضع اسم المتكلم في ref_id. - mission_brief: فقاعة توجيه تخاطب المتدرب وتوضح المهمة بصورة طبيعية. - intro_typed: النص التمهيدي لتعليمات السلامة (يُكتب حرفًا حرفًا). - rule: قاعدة سلامة واحدة (ref_id = r1, r2 …) بنفس عدد قواعد المخطط وترتيبها. - button: نص زر البدء («ابدأ اللعبة»). general_hint: نص التلميح العام (إن طُلب). quick_instruction: تعليمة سريعة قبل المهمة الأولى (اختياري). - station_prompt: (نمط المحطات) توجيه الضغط على المحطة في المشهد الرئيسي. - situation: الدليل الذي يصف المشكلة/الموقف. instruction: الإرشاد التفاعلي. option: نص خيار/بطاقة/خطوة (ref_id = id الخيار من التفاعل، بنفس العدد والترتيب). hint: التلميح. - feedback_positive_title / feedback_positive_body / feedback_positive_button ، feedback_negative_title / feedback_negative_body / feedback_negative_button. - transition: نص زر الانتقال أو تلميح المهمة التالية. - congratulation_title: عنوان التهنئة. closure_body: جملة تغلق القصة (المشكلة عولجت/المهمة اكتملت). impact: الأثر الظاهر لما قام به المتدرب. replay_button: نص زر إعادة (سطر لكل خيار بنفس ترتيب الإعدادات). - message: رسالة انتهاء الوقت. retry_button: زر إعادة المحاولة. """ def _scene_skeleton(plan: dict, bp: BlueprintOut, interactions: dict, inp: ProjectInput) -> dict: """skeleton حرفي لكل مشهد: السطور المطلوبة بالترتيب مع ref_id.""" st, lines = plan["scene_type"], [] L = lambda k, ref="": lines.append({"kind": k, "text": "…", "ref_id": ref}) if st == "opening": L("narration"); L("narration"); L("dialogue", "اسم الشخصية"); L("mission_brief") elif st == "safety": L("intro_typed") for i in range(len(bp.safety.rules)): L("rule", f"r{i+1}") elif st == "start": L("button") if "general_hint" in plan["required_line_kinds"]: L("general_hint") L("quick_instruction") elif st == "task": ix = interactions[plan["task_id"]] if bp.game_pattern == "hub_stations": L("station_prompt") L("situation"); L("instruction") for o in ix.options: L("option", o.id) L("hint") L("feedback_positive_title"); L("feedback_positive_body"); L("feedback_positive_button") L("feedback_negative_title"); L("feedback_negative_body"); L("feedback_negative_button") L("transition") elif st == "ending": L("congratulation_title"); L("closure_body"); L("impact") for i, _ in enumerate(inp.type_settings.replay_options): L("replay_button", f"rb{i+1}") elif st == "timeout": L("message"); L("retry_button") return {"scene_number": plan["scene_number"], "scene_id": plan["scene_id"], "scene_type": st, "title": plan["title"], "lines": lines} def _scripts_inputs(bp: BlueprintOut, interactions: dict, scene_plan: list, inp: ProjectInput) -> str: parts = [f"العنوان: {bp.title} | النمط: {bp.game_pattern}", "القصة: " + dumps(bp.story.model_dump()), "البيئة الرئيسية: " + bp.environment_main, "المؤقت: " + dumps(bp.timer.model_dump()), "التقدم: " + dumps(bp.progress.model_dump()), "التلميح: " + dumps(bp.hint.model_dump()), "السلامة: " + dumps(bp.safety.model_dump()), "نتيجة النهاية: " + bp.ending_outcome, "سيناريو انتهاء الوقت: " + (bp.failure_outcome or "-"), "خيارات إعادة اللعب (بالترتيب): " + dumps(inp.type_settings.replay_options)] for s in scene_plan: if s["scene_type"] == "task": t = next(x for x in bp.tasks if x.task_id == s["task_id"]) parts.append(f"--- {s['scene_id']} ({t.name}) ---\nخطة المهمة: {dumps(t.model_dump())}\nالتفاعل: {dumps(interactions[s['task_id']].model_dump())}") return "\n".join(parts) def _scripts_validate_factory(scene_plan, interactions, inp): def _v(sc: ScriptsOut) -> list: return lint_scripts(sc, scene_plan, interactions, inp) return _v async def step_scripts(inp: ProjectInput, bp: BlueprintOut, interactions: dict, scene_plan: list) -> ScriptsOut: skeleton = {"scenes": [_scene_skeleton(p, bp, interactions, inp) for p in scene_plan]} prompt = f"""#TASK=scripts #SCENE=all #TARGET_WORDS={inp.size.opening_words} {project_context_block(inp)} === المدخلات السابقة === {_scripts_inputs(bp, interactions, scene_plan, inp)} === المعايير الملزمة === {STD_OPENING} {STD_SAFETY} {STD_START} {STD_FEEDBACK} {STD_HINTS} {STD_TRANSITIONS_ENDING} {STD_LANGUAGE} {LINE_KINDS_GLOSSARY} قيود قابلة للقياس: نصوص المشهد الافتتاحي مجتمعة ≈ {inp.size.opening_words} كلمة (±{int(RUN_CONFIG['length_tolerance']*100)}%)؛ التغذية الراجعة (عنوان + توضيح) ≤ {MEASURABLE['feedback_max_lines']} أسطر و≤ {MEASURABLE['feedback_max_words']} كلمة؛ التعليمة ≤ {MEASURABLE['instruction_max_words']} كلمة؛ التلميح ≤ {MEASURABLE['hint_max_words']} كلمة؛ نص الخيار ≤ {MEASURABLE['option_text_max_words']} كلمات؛ التلميح والتغذية السلبية لا يكشفان الإجابة؛ قواعد السلامة ≤ {MEASURABLE['safety_rule_max_words']} كلمات. === المطلوب === 1. اكتب كل النصوص الظاهرة على الشاشة لكل المشاهد في نداء واحد، بصوت واحد متسق ونبرة مشجعة، وبجمل قصيرة تناسب الجمهور. 2. التزم حرفيًا بعدد المشاهد وترتيبها ومعرفاتها وأنواع السطور في الـ skeleton؛ يمكنك زيادة سطور narration/dialogue فقط. لا تغيّر معنى الإجابة الصحيحة ولا عدد الخيارات ولا ترتيبها (ref_id ثابت). 3. المشهد الافتتاحي يذكر المكان والشخصيات والمشكلة والسبب والمطلوب، ويمهّد للمهام{'، ويشير إلى الوقت المتاح' if inp.type_settings.timer.enabled else ''}. 4. شاشة النهاية تغلق القصة صراحةً (المشكلة التي بدأت بها اللعبة عولجت) وتُظهر الأثر داخل البيئة نفسها. 5. أخرج JSON فقط بالهيكل التالي حرفيًا (استبدل «…» بالنصوص): {dumps(skeleton)} """ scripts = await run_json_task(agent_writer, prompt, ScriptsOut, "الكاتب", _scripts_validate_factory(scene_plan, interactions, inp)) # حلقة ضبط الطول (المشهد الافتتاحي: المستهدف ±15%) for r in range(RUN_CONFIG["max_length_rounds"]): ok, actual, target = opening_length_check(scripts, inp) if ok: log(f"طول المشهد الافتتاحي {actual} كلمة ضمن المستهدف {target}±{int(RUN_CONFIG['length_tolerance']*100)}%", "ok"); break log(f"طول المشهد الافتتاحي {actual} كلمة خارج المستهدف {target} — جولة ضبط {r+1}", "warn") direction = "وسّع السرد بتفاصيل من القصة والبيئة" if actual < target else "اختصر السرد دون إسقاط عنصر من العناصر الخمسة" new_scene = await rewrite_scene(inp, bp, interactions, scene_plan, scripts, "opening", f"الطول الحالي {actual} كلمة والمستهدف {target} كلمة (±{int(RUN_CONFIG['length_tolerance']*100)}%). {direction}.") scripts.scenes = [new_scene if s.scene_id == "opening" else s for s in scripts.scenes] save_json(scripts.model_dump(), "scripts.json") return scripts async def rewrite_scene(inp: ProjectInput, bp: BlueprintOut, interactions: dict, scene_plan: list, scripts: ScriptsOut, scene_id: str, reason: str) -> SceneScript: """تصحيح موجَّه لمشهد واحد فقط (يُستخدم في ضبط الطول وفي المراجعة).""" plan = next(p for p in scene_plan if p["scene_id"] == scene_id) current = next(s for s in scripts.scenes if s.scene_id == scene_id) extra = "" if plan["scene_type"] == "task": extra = "التفاعل المرجعي: " + dumps(interactions[plan["task_id"]].model_dump()) prompt = f"""#TASK=rewrite_scene #SCENE={plan['scene_number']} #TARGET_WORDS={inp.size.opening_words} {project_context_block(inp)} === المشهد الحالي (JSON) === {dumps(current.model_dump())} {extra} === سياق القصة === {dumps(bp.story.model_dump())} === المعايير الملزمة === {STD_FEEDBACK} {STD_HINTS} {STD_LANGUAGE} {LINE_KINDS_GLOSSARY} === سبب إعادة الكتابة === {reason} === المطلوب === أعد كتابة هذا المشهد فقط مع معالجة السبب أعلاه، محافظًا على scene_number و scene_id و scene_type وأنواع السطور وref_id وعدد سطور option/rule/replay_button. أخرج JSON لمشهد واحد بنفس الهيكل الحالي. """ def _v(s: SceneScript) -> list: tmp = ScriptsOut(scenes=[s if x.scene_id == scene_id else x for x in scripts.scenes]) return [(sev, m) for sev, m in lint_scripts(tmp, scene_plan, interactions, inp) if m.startswith(scene_id + ":") or sev == "structural" and scene_id in m] return await run_json_task(agent_writer, prompt, SceneScript, f"إعادة كتابة [{scene_id}]", _v) # scripts = await step_scripts(INPUT, blueprint, interactions, scene_plan) # ══════════════════════════════════════════════════════════════════════ # خلية [15] من النوتبوك # ══════════════════════════════════════════════════════════════════════ # @title 15) الخطوة 5 — المخرج البصري → visual.json (بالتوازي لكل مشهد؛ beats = السطور) VISUAL_SKELETON = """{ "scene_number": 0, "scene_id": "…", "beats": [ {"line_index": 1, "visual_idea": "الفكرة البصرية لهذا السطر (ماذا يظهر، الشخصية وحالتها، العنصر وحالته)", "motion": "الحركة/التكوين (اتجاه الكاميرا، حركة العنصر، توهج/وميض، سلوك الشخصية)", "on_screen_text": "النص كما يظهر على الشاشة (نفس نص السطر أو جزؤه)", "text_position": "موضع النص (فقاعة أعلى اليمين / إطار متحرك أسفل الشاشة / بطاقة في المنتصف …)", "transition": "الانتقال إلى الـ beat التالي (قطع ناعم / تلاشٍ / تكبير …)"} ], "narrative_description": "وصف سردي تنفيذي متصل للمشهد كاملًا موجّه للمصمم (≥ 60 كلمة): البيئة وحالتها، مواضع العناصر، سلوك الشخصية، عناصر الواجهة الظاهرة (المؤقت/التقدم/التلميح)، الأصوات، وتسلسل الأحداث", "environment_state": "حالة البيئة في نهاية المشهد", "sound_notes": ["ملاحظات صوتية مرتبطة بالأفعال"] }""" async def direct_scene(inp: ProjectInput, bp: BlueprintOut, scene: SceneScript, plan: dict, interactions: dict, issues_feedback: str = "") -> VisualOut: extra = "" if plan["scene_type"] == "task": ix = interactions[plan["task_id"]] t = next(x for x in bp.tasks if x.task_id == plan["task_id"]) extra = (f"خطة المهمة: {dumps(t.model_dump())}\nالتفاعل: {dumps(ix.model_dump())}\n" f"قاعدة التمثيل البصري للنوع ({ix.interaction_type}): {INTERACTION_VISUAL_RULES[ix.interaction_type]}") elif plan["scene_type"] == "safety": extra = "خطة السلامة: " + dumps(bp.safety.model_dump()) elif plan["scene_type"] in ("ending", "timeout"): extra = f"نتيجة النهاية: {bp.ending_outcome}\nسيناريو انتهاء الوقت: {bp.failure_outcome or '-'}" lines_txt = "\n".join(f"{i+1}. [{l.kind}{(' / ' + l.ref_id) if l.ref_id else ''}] {l.text}" for i, l in enumerate(scene.lines)) prompt = f"""#TASK=visual #SCENE={scene.scene_number} #LINES={len(scene.lines)} {project_context_block(inp)} === النظام البصري الموحّد (التزم به حرفيًا) === {dumps(bp.visual_system.model_dump())} واجهة اللعبة: المؤقت {dumps(bp.timer.model_dump())} | التقدم {dumps(bp.progress.model_dump())} | التلميح {dumps(bp.hint.model_dump())} القصة: {dumps(bp.story.model_dump())} | البيئة الرئيسية: {bp.environment_main} | النمط: {bp.game_pattern} {extra} === المشهد {scene.scene_number} — {scene.title} ({scene.scene_type}) — سطور النص ({len(scene.lines)} سطرًا) === {lines_txt} === المعايير الملزمة === {STD_VISUAL_REP} {STD_EFFECTS} {STD_TIMER_PROGRESS} {STD_CHARACTER} {STD_LANGUAGE} Profile النمط: {GAME_PATTERNS[bp.game_pattern]['structure']} === المطلوب === 1. لكل سطر نص beat واحد بالترتيب نفسه (line_index من 1 إلى {len(scene.lines)}) — عدد الـ beats = {len(scene.lines)} بالضبط. 2. في كل beat: فكرة بصرية، حركة/تكوين، النص على الشاشة وموضعه، والانتقال؛ الشخصية المعتمدة ثابتة الهوية ومتفاعلة؛ الجهاز/العنصر في حالته الصحيحة قبل التنفيذ وبعده. 3. اجعل عناصر الواجهة (المؤقت/التقدم/التلميح) ظاهرة حيث تنص المعايير، والصوت والحركة نتيجة للفعل. 4. وصف سردي تنفيذي متصل للمشهد (≥ {MEASURABLE['narrative_min_words']} كلمة) بالعربية للمصمم، دون أي أوامر توليد صور. 5. أخرج JSON فقط بالهيكل التالي حرفيًا (scene_number={scene.scene_number}, scene_id="{scene.scene_id}"): {VISUAL_SKELETON} {issues_feedback}""" def _v(v: VisualOut) -> list: out = lint_visual(v, scene, inp) if v.scene_id != scene.scene_id or v.scene_number != scene.scene_number: out.append(("structural", f"scene_id/scene_number يجب أن يكونا {scene.scene_id}/{scene.scene_number}")) return out return await run_json_task(agent_visual, prompt, VisualOut, f"المخرج البصري [{scene.scene_id}]", _v) async def step_visual(inp: ProjectInput, bp: BlueprintOut, scripts: ScriptsOut, interactions: dict, scene_plan: list) -> dict: plans = {p["scene_id"]: p for p in scene_plan} results = await asyncio.gather(*[direct_scene(inp, bp, s, plans[s.scene_id], interactions) for s in scripts.scenes]) visuals = {v.scene_id: v for v in results} save_json({k: v.model_dump() for k, v in visuals.items()}, "visual.json") return visuals # visuals = await step_visual(INPUT, blueprint, scripts, interactions, scene_plan) # ══════════════════════════════════════════════════════════════════════ # خلية [16] من النوتبوك # ══════════════════════════════════════════════════════════════════════ # @title 16) الخطوة 6 — المراجعة: Lint آلي + مراجع LLM + تصحيح موجَّه → review.json REVIEW_SKELETON = """{ "verdict": "pass | needs_fix", "summary": "ملخص المراجعة في سطرين", "issues": [ {"scene_number": 3, "target": "scripts | interactions | visual", "problem": "وصف دقيق للمشكلة مع اقتباس النص المعني", "fix": "التصحيح المطلوب بدقة", "severity": "structural | style"} ] }""" async def llm_review(inp: ProjectInput, bp: BlueprintOut, interactions: dict, scripts: ScriptsOut, visuals: dict, scene_plan: list) -> ReviewOut: compact = [] for s in scripts.scenes: v = visuals.get(s.scene_id) compact.append({"scene_number": s.scene_number, "scene_id": s.scene_id, "scene_type": s.scene_type, "title": s.title, "lines": [l.model_dump() for l in s.lines], "visual_summary": (v.narrative_description if v else ""), "interaction": (interactions[next(p["task_id"] for p in scene_plan if p["scene_id"] == s.scene_id)].model_dump() if s.scene_type == "task" else None)}) prompt = f"""#TASK=review #SCENE=all {project_context_block(inp)} === المخطط (ملخص) === العنوان: {bp.title} | النمط: {bp.game_pattern} | القصة: {dumps(bp.story.model_dump())} | نتيجة النهاية: {bp.ending_outcome} الأهداف: {dumps(bp.objectives)} === المحتوى الكامل للمراجعة (JSON) === {dumps(compact)} === المعايير الملزمة (راجع المطابقة لكل بند) === {GENERAL_STANDARDS} === المطلوب === راجع كمدقق صارم وأرجع فقط المشكلات الحقيقية القابلة للتصحيح، مع scene_number الصحيح وtarget المناسب: - scripts: لغة/وضوح/طول/كشف الإجابة/اتساق الصوت/خطاب المتدرب/الهوية الجغرافية/كلمات لاتينية. - interactions: مشتتات غير معقولة، إجابة صحيحة لا تطابق المحتوى، تفاعل لا يقيس المهارة، تمثيل بصري ناقص. - visual: مخالفة النظام البصري أو هوية الشخصية، مؤثرات غير مرتبطة بالفعل، عناصر واجهة ناقصة. - تحقق خصوصًا من: المكونات الست لكل مهمة، النهاية تغلق القصة داخل البيئة نفسها، السلامة قبل أول مهمة خطرة، الأهداف تتحقق فعلًا عبر المهام. severity = structural للمخالفات التي تخرق معيارًا إلزاميًا، و style لما عداها. لو لا مشكلات: verdict = pass وissues فارغة. أخرج JSON فقط: {REVIEW_SKELETON} """ return await run_json_task(agent_reviewer, prompt, ReviewOut, "المراجع") async def step_review(inp: ProjectInput, bp: BlueprintOut, analysis: AnalysisOut, interactions: dict, scripts: ScriptsOut, visuals: dict, scene_plan: list): """Lint + مراجعة LLM → تصحيح موجَّه للمشاهد/المهام المعنية فقط. لو اتعدل نص مشهد يُعاد وصفه البصري.""" plans = {p["scene_id"]: p for p in scene_plan} num2plan = {p["scene_number"]: p for p in scene_plan} history = [] for rnd in range(1, RUN_CONFIG["max_fix_rounds"] + 1): auto = lint_all(inp, bp, interactions, scripts, visuals, scene_plan) rv = await llm_review(inp, bp, interactions, scripts, visuals, scene_plan) llm_issues = [i for i in rv.issues] issues = auto + llm_issues history.append({"round": rnd, "lint_issues": [i.model_dump() for i in auto], "llm_verdict": rv.verdict, "llm_summary": rv.summary, "llm_issues": [i.model_dump() for i in llm_issues]}) log(f"المراجعة — جولة {rnd}: Lint={len(auto)} | LLM={len(llm_issues)} ({rv.verdict})", "info") if not issues: break # تجميع حسب المشهد by_scene: dict = {} for i in issues: by_scene.setdefault(i.scene_number, []).append(i) for sn, its in by_scene.items(): plan = num2plan.get(sn) if plan is None: # مشكلات عامة (scene 0) → تُسجَّل فقط continue fb = "\n".join(f"- [{i.target}/{i.severity}] {i.problem} ← التصحيح: {i.fix}" for i in its) text_changed = False if plan["scene_type"] == "task" and any(i.target == "interactions" for i in its): t = next(x for x in bp.tasks if x.task_id == plan["task_id"]) interactions[t.task_id] = await design_interaction( inp, bp, t, analysis, sn, issues_feedback="\n=== مشكلات من المراجعة يجب معالجتها ===\n" + fb) text_changed = True if text_changed or any(i.target == "scripts" for i in its): new_scene = await rewrite_scene(inp, bp, interactions, scene_plan, scripts, plan["scene_id"], "مشكلات من المراجعة يجب معالجتها:\n" + fb) scripts.scenes = [new_scene if s.scene_id == plan["scene_id"] else s for s in scripts.scenes] text_changed = True if text_changed or any(i.target == "visual" for i in its): scene = next(s for s in scripts.scenes if s.scene_id == plan["scene_id"]) visuals[plan["scene_id"]] = await direct_scene(inp, bp, scene, plan, interactions, issues_feedback="\n=== مشكلات من المراجعة يجب معالجتها ===\n" + fb) final_lint = lint_all(inp, bp, interactions, scripts, visuals, scene_plan) review = {"rounds": history, "final_lint_issues": [i.model_dump() for i in final_lint], "style_warnings_accepted": _STYLE_WARNINGS, "final_status": "pass" if not [i for i in final_lint if i.severity == "structural"] else "structural_issues_remain"} save_json(review, "review.json") save_json({k: v.model_dump() for k, v in interactions.items()}, "interactions.json") save_json(scripts.model_dump(), "scripts.json") save_json({k: v.model_dump() for k, v in visuals.items()}, "visual.json") log(f"المراجعة انتهت — الحالة: {review['final_status']} | مشكلات متبقية: {len(final_lint)}", "ok" if review["final_status"] == "pass" else "warn") return review, interactions, scripts, visuals # review, interactions, scripts, visuals = await step_review(INPUT, blueprint, analysis, interactions, scripts, visuals, scene_plan) # ══════════════════════════════════════════════════════════════════════ # خلية [17] من النوتبوك # ══════════════════════════════════════════════════════════════════════ # @title 17) الخطوة 7 — الأغلفة → covers.json (بعد الوصف البصري لاستخراج عناصرها من المشاهد الحقيقية) COVERS_SKELETON = """{ "game_cover": {"header": "لعبة محاكاة", "title": "اسم اللعبة", "subtitle": "سطر فرعي قصير (اختياري)", "button": "العب الآن", "visual_description": "وصف تنفيذي للغلاف: البيئة في حالتها الأولى، الشخصية، العناصر الأبرز، موضع العنوان والزر، الحركة الخفيفة", "elements_from_scenes": ["عناصر مأخوذة من المشاهد الفعلية"]}, "document_cover": {"header": "ملف تنفيذي — لعبة محاكاة تفاعلية", "title": "اسم العنصر", "subtitle": "اسم الوحدة/البرنامج", "button": "", "visual_description": "وصف غلاف الملف", "elements_from_scenes": []} }""" async def step_covers(inp: ProjectInput, bp: BlueprintOut, scripts: ScriptsOut, visuals: dict) -> CoversOut: env_states = {k: v.environment_state for k, v in visuals.items()} opening = visuals.get("opening") prompt = f"""#TASK=covers #SCENE=0 {project_context_block(inp)} العنوان: {bp.title} | الوحدة: {inp.descriptor.unit_name} | البرنامج: {inp.descriptor.program_name or '-'} النظام البصري: {dumps(bp.visual_system.model_dump())} وصف المشهد الافتتاحي: {opening.narrative_description if opening else bp.environment_main} حالات البيئة في نهاية كل مشهد: {dumps(env_states)} === المعايير الملزمة === - غلاف اللعبة: ترويسة «لعبة محاكاة»، اسم اللعبة، زر «العب الآن»، فيكتور تفاعلي بحركة خفيفة، الشخصية المعتمدة والبيئة في حالتها الأولى (قبل المعالجة) لتمهيد المشكلة. - زر «أعِد التشغيل» في النهاية يعود إلى هذا الغلاف. {STD_CHARACTER} {STD_LANGUAGE} === المطلوب === صمّم غلاف اللعبة وغلاف الملف التنفيذي مستخرجًا عناصرهما من المشاهد الحقيقية أعلاه. أخرج JSON فقط: {COVERS_SKELETON} """ def _v(c: CoversOut) -> list: out = [] if not c.game_cover.button.strip(): out.append(("structural", "غلاف اللعبة يحتاج زرًا")) if not c.game_cover.title.strip(): out.append(("structural", "غلاف اللعبة يحتاج عنوانًا")) for i in lint_text(c.game_cover.visual_description + " " + c.game_cover.title, inp, "غلاف اللعبة", 0, "covers"): out.append((i.severity, i.problem)) return out c = await run_json_task(agent_covers, prompt, CoversOut, "الأغلفة", _v) save_json(c.model_dump(), "covers.json") return c # covers = await step_covers(INPUT, blueprint, scripts, visuals) # ══════════════════════════════════════════════════════════════════════ # خلية [18] من النوتبوك # ══════════════════════════════════════════════════════════════════════ # @title 18) التجميع → all_content.json def assemble(inp: ProjectInput, analysis: AnalysisOut, bp: BlueprintOut, scene_plan: list, interactions: dict, scripts: ScriptsOut, visuals: dict, review: dict, covers: CoversOut) -> dict: plans = {p["scene_id"]: p for p in scene_plan} scenes = [] for s in scripts.scenes: p = plans[s.scene_id] entry = {"scene_number": s.scene_number, "scene_id": s.scene_id, "scene_type": s.scene_type, "title": s.title, "lines": [l.model_dump() for l in s.lines], "visual": visuals[s.scene_id].model_dump() if s.scene_id in visuals else None} if s.scene_type == "task": t = next(x for x in bp.tasks if x.task_id == p["task_id"]) entry["task_plan"] = t.model_dump() entry["interaction"] = interactions[p["task_id"]].model_dump() scenes.append(entry) all_content = { "meta": {"generated_at": datetime.datetime.now().isoformat(timespec="seconds"), "product_type": inp.product_type, "game_pattern": bp.game_pattern, "models": MODELS, "tasks_count": len(bp.tasks)}, "input": inp.model_dump(), "descriptor": {**inp.descriptor.model_dump(), "item_name": inp.descriptor.item_name or bp.title, "subtopics": bp.subtopics, "objectives": bp.objectives, "objectives_intro": bp.objectives_intro}, "analysis": analysis.model_dump(), "blueprint": bp.model_dump(), "covers": covers.model_dump(), "scenes": scenes, "review": review, } save_json(all_content, "all_content.json") log("all_content.json جاهز", "ok") return all_content # ══════════════════════════════════════════════════════════════════════ # خلية [19] من النوتبوك # ══════════════════════════════════════════════════════════════════════ # @title 19) تصدير Word (RTL صحيح: bidi / bidiVisual / szCs / runs مختلطة / أعمدة ثابتة / جداول متداخلة) from docx import Document from docx.shared import Pt, Cm, RGBColor from docx.enum.text import WD_ALIGN_PARAGRAPH, WD_BREAK from docx.enum.section import WD_ORIENT from docx.oxml.ns import qn from docx.oxml import OxmlElement _LATIN_SEG = re.compile(r"([A-Za-z][A-Za-z0-9&/\-\.\(\) ]*[A-Za-z0-9\)]|[A-Za-z])") _PPR_AFTER_BIDI = ("w:adjustRightInd", "w:snapToGrid", "w:spacing", "w:ind", "w:contextualSpacing", "w:mirrorIndents", "w:suppressOverlap", "w:jc", "w:textDirection", "w:textAlignment", "w:textboxTightWrap", "w:outlineLvl", "w:divId", "w:cnfStyle", "w:rPr", "w:sectPr", "w:pPrChange") _RPR_AFTER_BCS = ("w:i", "w:iCs", "w:caps", "w:smallCaps", "w:strike", "w:dstrike", "w:outline", "w:shadow", "w:emboss", "w:imprint", "w:noProof", "w:snapToGrid", "w:vanish", "w:webHidden", "w:color", "w:spacing", "w:w", "w:kern", "w:position", "w:sz", "w:szCs", "w:highlight", "w:u", "w:effect", "w:bdr", "w:shd", "w:fitText", "w:vertAlign", "w:rtl", "w:cs", "w:em", "w:lang", "w:eastAsianLayout", "w:specVanish", "w:oMath") _RPR_AFTER_SZCS = _RPR_AFTER_BCS[_RPR_AFTER_BCS.index("w:highlight"):] _RPR_AFTER_RTL = _RPR_AFTER_BCS[_RPR_AFTER_BCS.index("w:cs"):] class DocxRTL: """مغلّف python-docx بقواعد العربية التي اعتمدناها.""" def __init__(self, font: str = "Arial", base_size: float = 11): self.font, self.base = font, base_size self.doc = Document() sec = self.doc.sections[0] sec.page_height, sec.page_width = Cm(29.7), Cm(21.0) sec.left_margin = sec.right_margin = Cm(2.0) sec.top_margin = sec.bottom_margin = Cm(2.0) self._section_bidi(sec) st = self.doc.styles["Normal"] st.font.name = font; st.font.size = Pt(base_size) rpr = st.element.get_or_add_rPr() rf = rpr.find(qn("w:rFonts")) if rf is None: rf = OxmlElement("w:rFonts"); rpr.insert(0, rf) for a in ("w:ascii", "w:hAnsi", "w:cs", "w:eastAsia"): rf.set(qn(a), font) self.content_width_cm = 17.0 # ---------- عناصر XML ---------- @staticmethod def _section_bidi(sec): sectPr = sec._sectPr if sectPr.find(qn("w:bidi")) is None: b = OxmlElement("w:bidi") sectPr.insert_element_before(b, "w:rtlGutter", "w:docGrid", "w:printerSettings", "w:sectPrChange") @staticmethod def rtl_paragraph(p, align: Optional[str] = None, space_after: float = 4, space_before: float = 0, keep_next=False, outline=None): pPr = p._p.get_or_add_pPr() if pPr.find(qn("w:bidi")) is None: pPr.insert_element_before(OxmlElement("w:bidi"), *_PPR_AFTER_BIDI) # لا نضع jc=right للعربي؛ start = يمين في RTL. center/justify عند الحاجة فقط. if align == "center": p.alignment = WD_ALIGN_PARAGRAPH.CENTER elif align == "justify": p.alignment = WD_ALIGN_PARAGRAPH.JUSTIFY pf = p.paragraph_format pf.space_after, pf.space_before = Pt(space_after), Pt(space_before) if keep_next: pf.keep_with_next = True if outline is not None: ol = OxmlElement("w:outlineLvl"); ol.set(qn("w:val"), str(outline)) pPr.insert_element_before(ol, "w:divId", "w:cnfStyle", "w:rPr", "w:sectPr", "w:pPrChange") return p def _style_run(self, run, size=None, bold=False, color=None, rtl=True, italic=False): size = size or self.base run.font.name = self.font rPr = run._r.get_or_add_rPr() rf = rPr.find(qn("w:rFonts")) for a in ("w:ascii", "w:hAnsi", "w:cs", "w:eastAsia"): rf.set(qn(a), self.font) run.font.size = Pt(size) # w:sz szcs = OxmlElement("w:szCs"); szcs.set(qn("w:val"), str(int(size * 2))) rPr.insert_element_before(szcs, *_RPR_AFTER_SZCS) # w:szCs — وإلا الحجم لا يُطبّق على العربي if bold: run.font.bold = True bcs = OxmlElement("w:bCs"); rPr.insert_element_before(bcs, *_RPR_AFTER_BCS) if italic: run.font.italic = True if color: run.font.color.rgb = RGBColor.from_string(color) if rtl: r = OxmlElement("w:rtl"); rPr.insert_element_before(r, *_RPR_AFTER_RTL) def add_text(self, p, text: str, size=None, bold=False, color=None, italic=False): """يقسّم النص المختلط: المقاطع اللاتينية في runs بدون rtl حتى لا تنقلب.""" text = str(text if text is not None else "") pos = 0 for m in _LATIN_SEG.finditer(text): if m.start() > pos: self._style_run(p.add_run(text[pos:m.start()]), size, bold, color, True, italic) self._style_run(p.add_run(m.group(0)), size, bold, color, False, italic) pos = m.end() if pos < len(text): self._style_run(p.add_run(text[pos:]), size, bold, color, True, italic) return p # ---------- فقرات ---------- def para(self, text="", size=None, bold=False, color=None, align=None, container=None, space_after=4, italic=False, first=False): host = container if container is not None else self.doc if first and container is not None: p = host.paragraphs[0] else: p = host.add_paragraph() self.rtl_paragraph(p, align, space_after) if text: # أسطر متعددة داخل الفقرة الواحدة parts = str(text).split("\n") for i, part in enumerate(parts): if i: p.add_run().add_break(WD_BREAK.LINE) self.add_text(p, part, size, bold, color, italic) return p def heading(self, text, level=1): sizes = {0: 22, 1: 16, 2: 13.5, 3: 12} colors = {0: "1F3864", 1: "1F3864", 2: "2E5597", 3: "404040"} p = self.doc.add_paragraph() self.rtl_paragraph(p, "center" if level == 0 else None, space_after=6, space_before=10 if level else 0, keep_next=True, outline=min(level, 8)) self.add_text(p, text, sizes.get(level, 12), True, colors.get(level, "000000")) return p def bullets(self, items, container=None, size=None): for it in items: p = self.para("", container=container, space_after=2) self.add_text(p, "• " + str(it), size) def page_break(self): self.doc.add_page_break() # ---------- جداول ---------- def table(self, rows, widths_cm, container=None, header=True, font_size=None, shade_first_col=False): """rows: list[list[cell]] — cell = str | list[str] (فقرات) | {'nested': rows, 'widths': [...]} يضبط bidiVisual + tblLayout fixed + tblW + tblGrid + tcW لكل خلية.""" host = container if container is not None else self.doc n_rows, n_cols = len(rows), len(widths_cm) tbl = host.add_table(rows=n_rows, cols=n_cols) try: tbl.style = self.doc.styles["Table Grid"] except Exception: pass tblPr = tbl._tbl.tblPr bv = OxmlElement("w:bidiVisual") tblPr.insert_element_before(bv, "w:tblStyleRowBandSize", "w:tblStyleColBandSize", "w:tblW", "w:jc", "w:tblCellSpacing", "w:tblInd", "w:tblBorders", "w:shd", "w:tblLayout", "w:tblCellMar", "w:tblLook", "w:tblCaption", "w:tblDescription") total_tw = int(sum(widths_cm) * 567) tblW = tblPr.find(qn("w:tblW")) if tblW is None: tblW = OxmlElement("w:tblW"); tblPr.insert_element_before(tblW, "w:jc", "w:tblCellSpacing", "w:tblInd", "w:tblBorders", "w:shd", "w:tblLayout", "w:tblCellMar", "w:tblLook") tblW.set(qn("w:w"), str(total_tw)); tblW.set(qn("w:type"), "dxa") lay = tblPr.find(qn("w:tblLayout")) if lay is None: lay = OxmlElement("w:tblLayout"); tblPr.insert_element_before(lay, "w:tblCellMar", "w:tblLook", "w:tblCaption", "w:tblDescription") lay.set(qn("w:type"), "fixed") grid = tbl._tbl.tblGrid for gc in list(grid): grid.remove(gc) for w in widths_cm: gc = OxmlElement("w:gridCol"); gc.set(qn("w:w"), str(int(w * 567))); grid.append(gc) fs = font_size or (self.base - 1) for r_i, row in enumerate(rows): for c_i in range(n_cols): cell = tbl.cell(r_i, c_i) cell.width = Cm(widths_cm[c_i]) tcPr = cell._tc.get_or_add_tcPr() tcW = tcPr.find(qn("w:tcW")) if tcW is None: tcW = OxmlElement("w:tcW"); tcPr.insert(0, tcW) tcW.set(qn("w:w"), str(int(widths_cm[c_i] * 567))); tcW.set(qn("w:type"), "dxa") val = row[c_i] if c_i < len(row) else "" is_head = (header and r_i == 0) or (shade_first_col and c_i == 0) if is_head: shd = OxmlElement("w:shd"); shd.set(qn("w:val"), "clear"); shd.set(qn("w:color"), "auto"); shd.set(qn("w:fill"), "DCE6F1" if r_i == 0 and header else "F2F2F2") tcPr.append(shd) self._fill_cell(cell, val, fs, bold=is_head) return tbl def _fill_cell(self, cell, val, fs, bold=False): if isinstance(val, dict) and "nested" in val: # جدول متداخل: نكتب عنوانًا اختياريًا في paragraphs[0] ثم الجدول (بدل ترك سطر فاضي) p0 = cell.paragraphs[0]; self.rtl_paragraph(p0, space_after=0) if val.get("title"): self.add_text(p0, val["title"], fs, True) widths = val.get("widths") or [ (cell.width.cm if cell.width else 6) / max(1, len(val["nested"][0])) ] * len(val["nested"][0]) self.table(val["nested"], widths, container=cell, header=val.get("header", True), font_size=max(8, fs - 1)) if not val.get("title"): # إزالة الفقرة الفارغة الأولى إن لم تُستخدم (Word يتطلب فقرة بعد الجدول داخل الخلية، فنبقي الأخيرة) p0._p.getparent().remove(p0._p) return lines = val if isinstance(val, list) else str(val).split("\n") for i, ln in enumerate(lines): p = cell.paragraphs[0] if i == 0 else cell.add_paragraph() self.rtl_paragraph(p, space_after=1) self.add_text(p, ln, fs, bold) def save(self, path): pathlib.Path(path).parent.mkdir(parents=True, exist_ok=True) from app.services.docx_rtl import fix_directions fix_directions(self.doc) # right-to-left as Word reads it self.doc.save(path); return path # ======================= بناء ملف Word من all_content ======================= def _fb_rows(ix): return {"nested": [["النوع", "العنوان", "التوضيح", "الزر"], ["إيجابية ✅", ix["feedback_positive"]["title"], ix["feedback_positive"]["body"], ix["feedback_positive"]["button"]], ["سلبية ❌", ix["feedback_negative"]["title"], ix["feedback_negative"]["body"], ix["feedback_negative"]["button"]]], "widths": [2.0, 2.6, 5.4, 2.2]} def _opt_note(o): return " | ".join(x for x in [ ("منطقة الإسقاط: " + o["target_zone_id"]) if o.get("target_zone_id") else "", ("يُطابق: " + o["pair_with"]) if o.get("pair_with") else "", ("النتيجة: " + o["consequence"]) if o.get("consequence") else "", ("الإجراء: " + o["action"]) if o.get("action") else ""] if x) or "-" def export_docx(all_content: dict, path: Optional[str] = None) -> str: ac = all_content inp, bp, cov, desc = ac["input"], ac["blueprint"], ac["covers"], ac["descriptor"] font = (inp.get("visual_identity", {}).get("font") or "Arial") d = DocxRTL(font=font) W = d.content_width_cm # ---- الغلاف ---- for _ in range(5): d.para("") d.para(cov["document_cover"]["header"], 14, False, "595959", "center") d.para(desc["item_name"], 26, True, "1F3864", "center", space_after=10) d.para(cov["document_cover"].get("subtitle") or desc["unit_name"], 14, False, "2E5597", "center") d.para(desc.get("program_name") or "", 12, False, "595959", "center") d.para("", 12); d.para(f"نمط البناء: {GAME_PATTERNS[bp['game_pattern']]['label']} | عدد المهام: {len(bp['tasks'])}", 11, False, "595959", "center") d.para(f"تاريخ الإنتاج: {ac['meta']['generated_at'][:10]}", 10, False, "7F7F7F", "center") d.page_break() # ---- أولًا: الجدول التوصيفي ---- d.heading("أولًا: الجدول التوصيفي", 1) rows = [["البند", "البيان"], ["اسم البرنامج", desc.get("program_name") or "-"], ["اسم الوحدة", desc["unit_name"]], ["رقم العنصر", str(desc["item_number"])], ["نوع العنصر", desc["item_type"]], ["اسم العنصر", desc["item_name"]], ["الموضوعات الفرعية", [f"{i+1}. {s}" for i, s in enumerate(desc["subtopics"])]], ["الأهداف التعليمية", [desc["objectives_intro"]] + [f"• {o}" for o in desc["objectives"]]], ["الجمهور", inp["audience"]["description"]], ["السياق السابق / اللاحق", f"{inp['context'].get('previous') or '-'} / {inp['context'].get('next') or '-'}"]] d.table(rows, [4.0, W - 4.0], shade_first_col=True) # ---- ثانيًا: غلاف اللعبة ---- d.heading("ثانيًا: غلاف اللعبة", 1) gc = cov["game_cover"] d.table([["البند", "البيان"], ["الترويسة", gc["header"]], ["اسم اللعبة", gc["title"]], ["سطر فرعي", gc.get("subtitle") or "-"], ["الزر", gc["button"]], ["الوصف البصري", gc["visual_description"]], ["عناصر مستخرجة من المشاهد", [f"• {e}" for e in gc.get("elements_from_scenes", [])] or "-"]], [4.0, W - 4.0], shade_first_col=True) # ---- ثالثًا: فكرة اللعبة ونمط اللعب ---- d.heading("ثالثًا: فكرة اللعبة ونمط اللعب", 1) an, st = ac["analysis"], bp["story"] d.table([["البند", "البيان"], ["المهارة/الإجراء المستهدف", an["target_skill"]], ["الموقف الواقعي", an["realistic_setting"]], ["المشكلة الرئيسية", an["main_problem"]], ["المكان", st["place"]], ["الشخصيات", "، ".join(st["characters"])], ["المشكلة/المهمة في القصة", st["problem_or_mission"]], ["سبب بدء المهمة", st["reason"]], ["المطلوب من المتدرب", st["what_is_required"]], ["البيئة الرئيسية وحالتها الأولية", bp["environment_main"]], ["نمط البناء", f"{GAME_PATTERNS[bp['game_pattern']]['label']} ({bp['game_pattern']})\n" + GAME_PATTERNS[bp["game_pattern"]]["structure"]]], [4.0, W - 4.0], shade_first_col=True) d.heading("مسار المهام وأنواع التفاعل", 2) trows = [["#", "المهمة", "المهارة المقيسة", "البيئة", "نوع التفاعل", "قبل ← بعد"]] for t in bp["tasks"]: trows.append([str(t["order"]), t["name"] + (f"\n(المحطة: {t['station_name']})" if t.get("station_name") else ""), t["skill"], t["environment"], INTERACTION_TYPES[t["interaction_type"]]["label"], f"{t['state_before']}\n← {t['state_after']}"]) d.table(trows, [0.8, 3.2, 3.2, 2.8, 2.5, 4.5]) d.heading("واجهة اللعبة: الوقت، التقدم، التلميح", 2) tm, pg, hn = bp["timer"], bp["progress"], bp["hint"] hud = [["العنصر", "المواصفة"]] if tm["enabled"]: hud.append(["المؤقت", [tm["description"], f"يبدأ العد: {tm['starts_on']}"]]) hud.append(["مراحل المؤقت", {"nested": [["اللون", "المدة (ثانية)", "الصوت"]] + [[p.get("color", ""), str(p.get("seconds", "")), p.get("sound", "")] for p in tm["phases"]], "widths": [3.0, 3.0, 6.5]}]) else: hud.append(["المؤقت", "غير مستخدم"]) hud.append(["مؤشر التقدم", [pg["description"], f"عدد الأجزاء: {pg['segments']}", pg["completion_effect"]] if pg["enabled"] else "غير مستخدم"]) hud.append(["التلميح", [f"الوضع: {hn['mode']}", hn["icon_description"], f"الظهور التلقائي: {hn['auto_trigger']}"] + ([f"التلميح العام: {hn['general_hint']}"] if hn.get("general_hint") else [])]) d.table(hud, [4.0, W - 4.0], shade_first_col=True) # ---- رابعًا: النظام البصري ---- d.heading("رابعًا: النظام البصري الموحّد", 1) vs = bp["visual_system"] d.table([["البند", "المواصفة"], ["الأسلوب", vs["style"]], ["الألوان", "، ".join(vs["palette"]) or "-"], ["ورقة الشخصية", vs["character_sheet"]], ["ورقة البيئة", vs["environment_sheet"]], ["ورقة الواجهة", vs["ui_sheet"]], ["الخط", vs.get("typography") or "-"]], [4.0, W - 4.0], shade_first_col=True) # ---- خامسًا: المشاهد ---- d.page_break(); d.heading("خامسًا: المشاهد والمهام (الملف التنفيذي)", 1) for sc in ac["scenes"]: d.heading(f"المشهد {sc['scene_number']}: {sc['title']}", 2) if sc["scene_type"] == "task": ix, tp = sc["interaction"], sc["task_plan"] d.table([["البند", "البيان"], ["الهدف/المهارة", tp["skill"]], ["البيئة", tp["environment"]], ["حالة البيئة قبل / بعد", f"قبل: {ix['environment_state_before']}\nبعد: {ix['environment_state_after']}"], ["الموقف / الدليل", ix["clue"]], ["التعليمة (إطار متحرك أسفل الشاشة)", ix["instruction"]], ["نوع التفاعل", INTERACTION_TYPES[ix["interaction_type"]]["label"]], ["آلية التفاعل", ix["mechanics"]["description"]], ["الإجابة الصحيحة (للمصمم)", ix["mechanics"]["correct_answer"]], ["التلميح 💡", ix["hint"]], ["التغذية الراجعة", _fb_rows(ix)], ["المؤثرات", ["عند النجاح: " + "، ".join(ix["effects"]["success"]), "عند الخطأ: " + "، ".join(ix["effects"]["error"])] + (["أصوات البيئة: " + "، ".join(ix["effects"]["ambient"])] if ix["effects"].get("ambient") else [])], ["الانتقال", f"{'زر' if ix['transition']['type'] == 'button' else 'تلقائي'}: {ix['transition']['text'] or '-'}"]], [4.0, W - 4.0], shade_first_col=True) if ix["elements"]: d.heading("العناصر التفاعلية في المشهد", 3) d.table([["المعرف", "العنصر", "الدور", "الوصف البصري"]] + [[e["id"], e["name"], e["role"], e["visual_description"]] for e in ix["elements"]], [1.8, 3.0, 2.0, W - 6.8]) if ix["options"]: d.heading("الخيارات / العناصر القابلة للتفاعل", 3) d.table([["المعرف", "النص", "صحيح؟", "الوصف البصري", "ملاحظات"]] + [[o["id"], o["text"], "✅" if o["is_correct"] else "", o.get("visual_description") or "-", _opt_note(o)] for o in ix["options"]], [1.8, 3.4, 1.5, 6.5, 3.8]) mech = ix["mechanics"] if mech.get("order"): d.para("الترتيب الصحيح: " + " ← ".join(mech["order"]), bold=True) if mech.get("pairs"): d.para("الأزواج الصحيحة: " + "، ".join(f"{a} ↔ {b}" for a, b in mech["pairs"]), bold=True) elif sc["scene_type"] == "safety": sf = bp["safety"] d.para("السبب: " + (sf.get("reason") or "-")); d.para("الموضع: " + (sf.get("placement") or "-")) d.table([["#", "القاعدة", "وصف الأيقونة"]] + [[str(i+1), r.get("text", ""), r.get("icon_description", "")] for i, r in enumerate(sf["rules"])], [0.8, 6.0, W - 6.8]) d.heading("النص والإخراج البصري", 3) vrows = [["#", "النوع", "النص على الشاشة", "الفكرة البصرية", "الحركة / التكوين", "موضع النص", "الانتقال"]] beats = {b["line_index"]: b for b in (sc["visual"] or {}).get("beats", [])} for i, l in enumerate(sc["lines"], 1): b = beats.get(i, {}) vrows.append([str(i), l["kind"] + (f"\n({l['ref_id']})" if l.get("ref_id") else ""), l["text"], b.get("visual_idea", ""), b.get("motion", ""), b.get("text_position", ""), b.get("transition", "")]) d.table(vrows, [0.9, 2.2, 3.5, 3.5, 3.1, 1.9, 1.9], font_size=9) if sc["visual"]: d.heading("الوصف السردي التنفيذي للمشهد", 3) d.para(sc["visual"]["narrative_description"], align="justify") if sc["visual"].get("environment_state"): d.para("حالة البيئة في نهاية المشهد: " + sc["visual"]["environment_state"], italic=True) if sc["visual"].get("sound_notes"): d.bullets(sc["visual"]["sound_notes"]) # ---- سادسًا: ملاحظات للمصمم ---- d.heading("سادسًا: ملاحظات تنفيذية للمصمم", 1) notes = ["كل النصوص والتعليق الصوتي بالعربية الفصحى المبسّطة، وبصوت واحد ثابت طوال اللعبة.", "الالتزام بورقة الشخصية في كل الرسومات والأيقونات (الملامح، الزي، معدات الوقاية) مع تعبيرات طبيعية متفاعلة.", "الأصوات والحركات نتيجة للفعل: صوت الأداة عند استخدامها، السحب والإفلات، النجاح والخطأ، وتحديث مؤشر التقدم.", "انتقالات هادئة بين المشاهد، وإبراز حالة العنصر قبل التنفيذ وبعده.", "لا يمكن الانتقال للمهمة التالية إلا بعد الإجابة الصحيحة، ويعود العنصر الخاطئ إلى موضعه."] if tm["enabled"]: notes.append(f"المؤقت مرتبط بالأداء: {tm['description']} — يبدأ العد عند {tm['starts_on']}.") if bp.get("failure_outcome"): notes.append("سيناريو انتهاء الوقت: " + bp["failure_outcome"]) if inp.get("notes"): notes.append("ملاحظات التيم: " + inp["notes"]) d.bullets(notes) # ---- ملحق: المراجعة ---- rv = ac.get("review", {}) d.heading("ملحق: تقرير المراجعة والجودة", 1) d.para(f"الحالة النهائية: {rv.get('final_status', '-')} | جولات المراجعة: {len(rv.get('rounds', []))} | مشكلات متبقية: {len(rv.get('final_lint_issues', []))}") if rv.get("final_lint_issues"): d.table([["المشهد", "الهدف", "المشكلة", "التصحيح المقترح"]] + [[str(i["scene_number"]), i["target"], i["problem"], i["fix"]] for i in rv["final_lint_issues"]], [1.5, 2.2, 7.0, W - 10.7], font_size=9) path = path or str(pathlib.Path(RUN_CONFIG["output_dir"]) / f"{_safe_name(desc['item_name'])}.docx") d.save(path) log(f"Word: {path}", "ok") return path def _safe_name(s: str) -> str: s = re.sub(r"[\\/:*?\"<>|]+", "_", s or "simulation_game").strip() or "simulation_game" return s[:80] def docx_to_pdf(docx_path: str) -> Optional[str]: """اختياري: تحويل إلى PDF للمعاينة (يتطلب LibreOffice: !apt-get install -y libreoffice-writer).""" import shutil, subprocess if not shutil.which("soffice"): log("LibreOffice غير مثبت — تخطّي تحويل PDF", "warn"); return None out_dir = str(pathlib.Path(docx_path).parent) subprocess.run(["soffice", "--headless", "--convert-to", "pdf", "--outdir", out_dir, docx_path], check=False, capture_output=True, timeout=180) pdf = str(pathlib.Path(docx_path).with_suffix(".pdf")) return pdf if pathlib.Path(pdf).exists() else None # ══════════════════════════════════════════════════════════════════════ # خلية [20] من النوتبوك # ══════════════════════════════════════════════════════════════════════ # @title 20) تصدير HTML (RTL يدوي، قابل للطباعة) def _h(x) -> str: return _html.escape(str(x if x is not None else "")) def _html_table(rows, header=True, cls=""): out = [f''] for i, r in enumerate(rows): tag = "th" if (header and i == 0) else "td" out.append("" + "".join(f"<{tag}>{_cell_html(c)}" for c in r) + "") out.append("
") return "\n".join(out) def _cell_html(c): if isinstance(c, dict) and "nested" in c: return (f"
{_h(c['title'])}
" if c.get("title") else "") + _html_table(c["nested"], c.get("header", True), "nested") if isinstance(c, list): return "
".join(_h(x) for x in c) return _h(c).replace("\n", "
") def export_html(all_content: dict, path: Optional[str] = None) -> str: ac = all_content inp, bp, cov, desc, an, st = ac["input"], ac["blueprint"], ac["covers"], ac["descriptor"], ac["analysis"], ac["blueprint"]["story"] font = inp.get("visual_identity", {}).get("font") or "Arial" css = f""" :root {{ --ink:#1f2937; --head:#1F3864; --sub:#2E5597; --line:#d1d5db; --shade:#DCE6F1; --soft:#F2F2F2; }} * {{ box-sizing:border-box; }} body {{ direction:rtl; font-family:'{font}', 'Noto Naskh Arabic', 'Segoe UI', Tahoma, sans-serif; color:var(--ink); background:#fff; margin:0; line-height:1.7; }} .page {{ max-width:1000px; margin:0 auto; padding:32px 24px; }} header.cover {{ text-align:center; padding:80px 16px 40px; border-bottom:3px solid var(--head); margin-bottom:32px; }} header.cover .kicker {{ color:#595959; font-size:15px; }} header.cover h1 {{ color:var(--head); font-size:34px; margin:12px 0; }} header.cover .sub {{ color:var(--sub); font-size:18px; }} h2 {{ color:var(--head); font-size:22px; border-inline-start:6px solid var(--head); padding-inline-start:10px; margin:36px 0 12px; }} h3 {{ color:var(--sub); font-size:18px; margin:24px 0 8px; }} h4 {{ color:#404040; font-size:15px; margin:16px 0 6px; }} table {{ width:100%; border-collapse:collapse; table-layout:fixed; margin:8px 0 16px; font-size:14px; }} th, td {{ border:1px solid var(--line); padding:6px 8px; vertical-align:top; text-align:start; word-wrap:break-word; }} th {{ background:var(--shade); font-weight:700; }} table.kv td:first-child {{ background:var(--soft); font-weight:700; width:22%; }} table.nested {{ margin:0; font-size:13px; }} table.beats {{ font-size:12.5px; }} .latin {{ direction:ltr; unicode-bidi:isolate; }} .scene {{ border:1px solid var(--line); border-radius:10px; padding:12px 16px; margin:18px 0; page-break-inside:avoid; }} .scene .badge {{ display:inline-block; background:var(--head); color:#fff; border-radius:6px; padding:2px 10px; font-size:12px; margin-inline-start:8px; }} .narr {{ text-align:justify; background:#fafafa; padding:10px 12px; border-radius:8px; }} ul {{ padding-inline-start:22px; }} .meta {{ color:#6b7280; font-size:13px; }} @media print {{ .page {{ padding:0; }} .scene {{ break-inside:avoid; }} }} """ H = [] H.append(f"{_h(desc['item_name'])}
") H.append(f"
{_h(cov['document_cover']['header'])}

{_h(desc['item_name'])}

{_h(cov['document_cover'].get('subtitle') or desc['unit_name'])}
{_h(desc.get('program_name') or '')}
نمط البناء: {_h(GAME_PATTERNS[bp['game_pattern']]['label'])} | عدد المهام: {len(bp['tasks'])} | {_h(ac['meta']['generated_at'][:10])}
") # أولًا H.append("

أولًا: الجدول التوصيفي

") H.append(_html_table([["اسم البرنامج", desc.get("program_name") or "-"], ["اسم الوحدة", desc["unit_name"]], ["رقم العنصر", str(desc["item_number"])], ["نوع العنصر", desc["item_type"]], ["اسم العنصر", desc["item_name"]], ["الموضوعات الفرعية", [f"{i+1}. {s}" for i, s in enumerate(desc["subtopics"])]], ["الأهداف التعليمية", [desc["objectives_intro"]] + [f"• {o}" for o in desc["objectives"]]], ["الجمهور", inp["audience"]["description"]], ["السياق السابق / اللاحق", f"{inp['context'].get('previous') or '-'} / {inp['context'].get('next') or '-'}"]], header=False, cls="kv")) gc = cov["game_cover"] H.append("

ثانيًا: غلاف اللعبة

") H.append(_html_table([["الترويسة", gc["header"]], ["اسم اللعبة", gc["title"]], ["سطر فرعي", gc.get("subtitle") or "-"], ["الزر", gc["button"]], ["الوصف البصري", gc["visual_description"]], ["عناصر مستخرجة من المشاهد", [f"• {e}" for e in gc.get("elements_from_scenes", [])] or "-"]], header=False, cls="kv")) H.append("

ثالثًا: فكرة اللعبة ونمط اللعب

") H.append(_html_table([["المهارة/الإجراء المستهدف", an["target_skill"]], ["الموقف الواقعي", an["realistic_setting"]], ["المشكلة الرئيسية", an["main_problem"]], ["المكان", st["place"]], ["الشخصيات", "، ".join(st["characters"])], ["المشكلة/المهمة في القصة", st["problem_or_mission"]], ["سبب بدء المهمة", st["reason"]], ["المطلوب من المتدرب", st["what_is_required"]], ["البيئة الرئيسية وحالتها الأولية", bp["environment_main"]], ["نمط البناء", f"{GAME_PATTERNS[bp['game_pattern']]['label']} ({bp['game_pattern']})\n" + GAME_PATTERNS[bp["game_pattern"]]["structure"]]], header=False, cls="kv")) H.append("

مسار المهام وأنواع التفاعل

") H.append(_html_table([["#", "المهمة", "المهارة المقيسة", "البيئة", "نوع التفاعل", "قبل ← بعد"]] + [[str(t["order"]), t["name"] + (f"\n(المحطة: {t['station_name']})" if t.get("station_name") else ""), t["skill"], t["environment"], INTERACTION_TYPES[t["interaction_type"]]["label"], f"{t['state_before']}\n← {t['state_after']}"] for t in bp["tasks"]])) tm, pg, hn = bp["timer"], bp["progress"], bp["hint"] hud = [] if tm["enabled"]: hud += [["المؤقت", [tm["description"], f"يبدأ العد: {tm['starts_on']}"]], ["مراحل المؤقت", {"nested": [["اللون", "المدة (ثانية)", "الصوت"]] + [[p.get("color", ""), str(p.get("seconds", "")), p.get("sound", "")] for p in tm["phases"]]}]] else: hud.append(["المؤقت", "غير مستخدم"]) hud.append(["مؤشر التقدم", [pg["description"], f"عدد الأجزاء: {pg['segments']}", pg["completion_effect"]] if pg["enabled"] else "غير مستخدم"]) hud.append(["التلميح", [f"الوضع: {hn['mode']}", hn["icon_description"], f"الظهور التلقائي: {hn['auto_trigger']}"] + ([f"التلميح العام: {hn['general_hint']}"] if hn.get("general_hint") else [])]) H.append("

واجهة اللعبة: الوقت، التقدم، التلميح

" + _html_table(hud, header=False, cls="kv")) vs = bp["visual_system"] H.append("

رابعًا: النظام البصري الموحّد

" + _html_table([["الأسلوب", vs["style"]], ["الألوان", "، ".join(vs["palette"]) or "-"], ["ورقة الشخصية", vs["character_sheet"]], ["ورقة البيئة", vs["environment_sheet"]], ["ورقة الواجهة", vs["ui_sheet"]], ["الخط", vs.get("typography") or "-"]], header=False, cls="kv")) H.append("

خامسًا: المشاهد والمهام (الملف التنفيذي)

") for sc in ac["scenes"]: H.append(f"

المشهد {sc['scene_number']}: {_h(sc['title'])}{_h(sc['scene_type'])}

") if sc["scene_type"] == "task": ix, tp = sc["interaction"], sc["task_plan"] H.append(_html_table([["الهدف/المهارة", tp["skill"]], ["البيئة", tp["environment"]], ["حالة البيئة قبل / بعد", f"قبل: {ix['environment_state_before']}\nبعد: {ix['environment_state_after']}"], ["الموقف / الدليل", ix["clue"]], ["التعليمة", ix["instruction"]], ["نوع التفاعل", INTERACTION_TYPES[ix["interaction_type"]]["label"]], ["آلية التفاعل", ix["mechanics"]["description"]], ["الإجابة الصحيحة (للمصمم)", ix["mechanics"]["correct_answer"]], ["التلميح 💡", ix["hint"]], ["التغذية الراجعة", _fb_rows(ix)], ["المؤثرات", ["عند النجاح: " + "، ".join(ix["effects"]["success"]), "عند الخطأ: " + "، ".join(ix["effects"]["error"])] + (["أصوات البيئة: " + "، ".join(ix["effects"]["ambient"])] if ix["effects"].get("ambient") else [])], ["الانتقال", f"{'زر' if ix['transition']['type'] == 'button' else 'تلقائي'}: {ix['transition']['text'] or '-'}"]], header=False, cls="kv")) if ix["elements"]: H.append("

العناصر التفاعلية في المشهد

" + _html_table([["المعرف", "العنصر", "الدور", "الوصف البصري"]] + [[e["id"], e["name"], e["role"], e["visual_description"]] for e in ix["elements"]])) if ix["options"]: H.append("

الخيارات / العناصر القابلة للتفاعل

" + _html_table([["المعرف", "النص", "صحيح؟", "الوصف البصري", "ملاحظات"]] + [[o["id"], o["text"], "✅" if o["is_correct"] else "", o.get("visual_description") or "-", _opt_note(o)] for o in ix["options"]])) if ix["mechanics"].get("order"): H.append(f"

الترتيب الصحيح: {_h(' ← '.join(ix['mechanics']['order']))}

") if ix["mechanics"].get("pairs"): H.append("

الأزواج الصحيحة: " + _h("، ".join(f"{a} ↔ {b}" for a, b in ix["mechanics"]["pairs"])) + "

") elif sc["scene_type"] == "safety": sf = bp["safety"] H.append(f"

السبب: {_h(sf.get('reason') or '-')}
الموضع: {_h(sf.get('placement') or '-')}

") H.append(_html_table([["#", "القاعدة", "وصف الأيقونة"]] + [[str(i+1), r.get("text", ""), r.get("icon_description", "")] for i, r in enumerate(sf["rules"])])) beats = {b["line_index"]: b for b in (sc["visual"] or {}).get("beats", [])} vrows = [["#", "النوع", "النص على الشاشة", "الفكرة البصرية", "الحركة / التكوين", "موضع النص", "الانتقال"]] for i, l in enumerate(sc["lines"], 1): b = beats.get(i, {}) vrows.append([str(i), l["kind"] + (f"\n({l['ref_id']})" if l.get("ref_id") else ""), l["text"], b.get("visual_idea", ""), b.get("motion", ""), b.get("text_position", ""), b.get("transition", "")]) H.append("

النص والإخراج البصري

" + _html_table(vrows, cls="beats")) if sc["visual"]: H.append(f"

الوصف السردي التنفيذي للمشهد

{_h(sc['visual']['narrative_description'])}

") if sc["visual"].get("environment_state"): H.append(f"

حالة البيئة في نهاية المشهد: {_h(sc['visual']['environment_state'])}

") if sc["visual"].get("sound_notes"): H.append("") H.append("
") notes = ["كل النصوص والتعليق الصوتي بالعربية الفصحى المبسّطة، وبصوت واحد ثابت طوال اللعبة.", "الالتزام بورقة الشخصية في كل الرسومات والأيقونات مع تعبيرات طبيعية متفاعلة.", "الأصوات والحركات نتيجة للفعل، وتحديث مؤشر التقدم بعد كل مهمة.", "انتقالات هادئة، وإبراز حالة العنصر قبل التنفيذ وبعده.", "لا انتقال للمهمة التالية إلا بعد الإجابة الصحيحة."] if tm["enabled"]: notes.append(f"المؤقت مرتبط بالأداء: {tm['description']} — يبدأ العد عند {tm['starts_on']}.") if bp.get("failure_outcome"): notes.append("سيناريو انتهاء الوقت: " + bp["failure_outcome"]) if inp.get("notes"): notes.append("ملاحظات التيم: " + inp["notes"]) H.append("

سادسًا: ملاحظات تنفيذية للمصمم

") rv = ac.get("review", {}) H.append(f"

ملحق: تقرير المراجعة والجودة

الحالة النهائية: {_h(rv.get('final_status','-'))} | جولات المراجعة: {len(rv.get('rounds', []))} | مشكلات متبقية: {len(rv.get('final_lint_issues', []))}

") if rv.get("final_lint_issues"): H.append(_html_table([["المشهد", "الهدف", "المشكلة", "التصحيح المقترح"]] + [[str(i["scene_number"]), i["target"], i["problem"], i["fix"]] for i in rv["final_lint_issues"]])) H.append("
") path = path or str(pathlib.Path(RUN_CONFIG["output_dir"]) / f"{_safe_name(desc['item_name'])}.html") pathlib.Path(path).parent.mkdir(parents=True, exist_ok=True) pathlib.Path(path).write_text("\n".join(H), encoding="utf-8") log(f"HTML: {path}", "ok") return path