عن المشروع

# Skyrim Creation Kit Agent يحتوي هذا المستودع على مخرجات بحثية وهندسية لتطوير وكيل تأليف تعديلات مدعوم بالذكاء الاصطناعي لـ *The Elder Scrolls V: Skyrim Special Edition* و*Anniversary Edition*. يركّز المشروع على منهجيات تضع السلامة أولاً، وتحويل نية التعديل عالية المستوى إلى عمليات مُصنّفة وقابلة للعكس ومدعومة بالأدلة. ## الفلسفة الأساسية يعمل النظام وفق أربعة مبادئ: 1. **الذكاء الاصطناعي يقرر ماذا**: يحدد LLM/المخطط العملية المطلوبة. 2. **البرمجيات الحتمية تقرر كيف**: ينفذ العمال المُصنّفون الإجراءات. 3. **المدققون يقررون هل نجح الأمر**: تضمن الفحوصات الآلية السلامة. 4. **الإنسان يقرر هل يقبل**: يلزم موافقة نهائية قبل التطبيق. المنتج المستهدف هو منسّق هجين يكون فيه المسار الأساسي غير رسومي وحتمي. يُعامل Creation Kit كقدرة ضيقة بدلاً من كونه جوهر النظام. ## الحالة الحالية **بحث + إثبات مفهوم تركيبي مُتحقق منه.** هذا ليس بعد وكيل تأليف تعديلات عام الأغراض، ولا يقوم حالياً بأتمتة Creation Kit مباشرة. حكم البوابة الأولى الحالي هو "VIABLE WITH LIMITATIONS". وبينما يمكن لمعظم العمليات على مستوى السجلات أن تتجنب Creation Kit بشكل معقول، تبقى عدة مجالات غير محلولة (مثل FaceGen، وnavmeshes، ودلالات المهام المعقدة). ### مفردات الحالة - `VERIFICADO`: مدعوم بدليل مباشر أو اختبار قابل للتكرار. - `PASS`: نُفذت التجربة واجتازت البوابات المحددة. - `NO VERIFICADO`: معقول لكن لم يُعد إنتاجه هنا. - `HIPOTESIS`: تجربة أو ادعاء تصميمي مقترح. - `EXPERIMENTAL`: مُنفذ فقط كتجربة. - `BLOQUEADO`: لا يمكن المضي قدماً في البيئة المتاحة. - `DESCARTADO`: مرفوض صراحةً. - `LEGAL_REVIEW_REQUIRED`: المسار التقني موجود، لكن آثار الترخيص/EULA غير محلولة. ## البنية شكل المنتج الموصى به هو **منسّق هجين + مسار أساسي غير رسومي أولاً**: ```text User Intent ↓ Intent normalizer ↓ Planner / LLM ↓ Typed ModPlan ↓ Policy / safety engine ↓ Capability router ├─ Headless plugin worker ├─ Papyrus worker ├─ xEdit validator └─ Creation Kit worker [disabled until independently verified] ↓ Candidate workspace ↓ Validator ↓ Human approval ``` يجب ألا يتلقى المخطط أوامر shell عشوائية أو أوليات أتمتة GUI. تُوجّه العمليات إلى عمال محددين بناءً على النوع. ## التنفيذ المُتحقق منه: POC-002 `research/poc_002/` هو أول إثبات مفهوم قابل للتنفيذ: - يستخدم تركيبات TES4 اصطناعية فقط. - ينفذ محللاً صارماً مع تعدادات عمليات مغلقة. - يفرض مساحات عمل للمرشحين فقط مع احتواء المسارات. - يضمن تنسيقاً يفشل مغلقاً وإيصالات عدم الكتابة فوق. - يحافظ على ثوابت SHA-256 للملفات الأصلية. - يتضمن 44 اختباراً آلياً (خط الأساس الأولي: 43؛ +1 انحدار خصومي). لتشغيل POC-002: ```bash cd research/poc_002 python -m compileall . python -m unittest test_suite.py -v ``` ملاحظة: هذا لا يثبت التوافق مع إضافات Skyrim حقيقية عشوائية، أو سلوك وقت تشغيل Creation Kit، أو xEdit، أو PapyrusCompiler، أو Mutagen، أو الصحة داخل اللعبة. ## واجهة Discovery Desk البحثية يحتفظ المستودع بتطبيق بحثي صغير Next.js + Drizzle/PostgreSQL يُسمى "Discovery Desk". - تنتمي `src/app/` و`src/db/` و`src/lib/research/` إلى هذه الواجهة. - **ليست** وقت تشغيل وكيل التأليف المستقبلي. - يتطلب التطوير متغير بيئة `DATABASE_URL` (انظر `.env.example`). تفشل عملية البناء بسرعة إذا كان المتغير مفقوداً، لكن لا حاجة إلى خادم PostgreSQL حي لـ CI لأن مجمع الاتصالات كسول. ## قواعد السلامة - لا تعدّل أبداً النسخة الوحيدة للمستخدم من إضافة. - الملفات الأصلية مدخلات غير قابلة للتغيير؛ تُكتب التغييرات إلى مرشحين. - لا أوامر shell عشوائية في الخطط المولدة بالذكاء الاصطناعي. - لا أتمتة GUI بالنقر الإحداثي كمسار أساسي. - غياب دليل الإكمال فشل، وليس نجاحاً. - لا تلتزم أبداً بثنائيات ألعاب/محررات Bethesda، أو الإضافات الأصلية، أو مصادر Papyrus الأصلية. - عزل العمليات حد تقني، وليس استنتاجاً تلقائياً للترخيص. ## الترخيص - **الكود الأساسي المؤلف في المستودع**: رخصة MIT. - **Mutagen / Synthesis / Spriggit**: GPL-3.0-only. تتطلب الأعمال المدمجة الامتثال لـ GPL. - **xEdit**: MPL-2.0 من المنبع. مخصص للتنفيذ الخارجي، ولا يُضمّن أبداً. - **CKPE**: كود LGPLv3 بالإضافة إلى EULA/طبقة قانونية لـ Creation Kit. الحالة: `LEGAL_REVIEW_REQUIRED`. - **Creation Kit، PapyrusCompiler، الأصول الأصلية**: مكونات خاصة مثبتة من المستخدم. لا يُعاد توزيعها أبداً. لحزم npm الخارجية وخطوط OFL إشعارات منفصلة. لملفات ZIP البحثية المستوردة مصدر غير محلول. ## العلاقة بـ Sky-Claw هذا مستودع ومسار بحثي منفصل. قد يتكامل لاحقاً مع Sky-Claw عبر بروتوكول موثق، لكن يجب أن يبقى قابلاً للاختبار بشكل مستقل وألا يفترض أن internals الخاصة بـ Sky-Claw هي حد السلامة الخاص به. ## إخلاء المسؤولية غير تابع لـ Bethesda Game Studios، أو ZeniMax Media، أو Valve، أو Nexus Mods، أو مؤلفي الأدوات الخارجية.