इस प्रोजेक्ट के बारे में

# Skyrim Creation Kit Agent यह रिपॉज़िटरी *The Elder Scrolls V: Skyrim Special Edition* और *Anniversary Edition* के लिए AI-सहायित मॉड ऑथरिंग एजेंट विकसित करने हेतु शोध और इंजीनियरिंग आर्टिफैक्ट्स समाहित करती है। परियोजना सुरक्षा-प्रथम पद्धतियों पर केंद्रित है, जो उच्च-स्तरीय मॉडिंग इरादे को टाइप्ड, प्रतिवर्ती और प्रमाण-आधारित संचालनों में परिवर्तित करती है। ## मूल दर्शन सिस्टम चार सिद्धांतों पर संचालित होता है: 1. **AI तय करता है क्या**: LLM/प्लानर वांछित संचालन निर्धारित करता है। 2. **नियतात्मक सॉफ़्टवेयर तय करता है कैसे**: टाइप्ड वर्कर क्रियाएँ निष्पादित करते हैं। 3. **वैलिडेटर तय करते हैं कि काम हुआ या नहीं**: स्वचालित जाँच अखंडता सुनिश्चित करती हैं। 4. **मनुष्य तय करता है स्वीकार करना है या नहीं**: लागू करने से पहले अंतिम अनुमोदन आवश्यक है। लक्ष्य उत्पाद एक हाइब्रिड ऑर्केस्ट्रेटर है जिसमें प्राथमिक पथ हेडलेस और नियतात्मक है। Creation Kit को सिस्टम के केंद्र के बजाय एक संकीर्ण क्षमता के रूप में माना जाता है। ## वर्तमान स्थिति **शोध + सत्यापित सिंथेटिक प्रूफ ऑफ कॉन्सेप्ट।** यह अभी तक सामान्य-उद्देश्यीय मॉड ऑथरिंग एजेंट नहीं है, और वर्तमान में Creation Kit को सीधे स्वचालित भी नहीं करता। वर्तमान Gate-1 निर्णय "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 ``` प्लानर को मनमाने शेल कमांड या GUI ऑटोमेशन प्रिमिटिव नहीं मिलने चाहिए। संचालन प्रकार के आधार पर विशिष्ट वर्कर को रूट किए जाते हैं। ## सत्यापित कार्यान्वयन: POC-002 `research/poc_002/` पहला निष्पादन योग्य प्रूफ ऑफ कॉन्सेप्ट है: - केवल सिंथेटिक TES4 फिक्स्चर का उपयोग करता है। - बंद ऑपरेशन एनम के साथ सख्त पार्सर लागू करता है। - पथ नियंत्रण के साथ केवल-कैंडिडेट वर्कस्पेस लागू करता है। - फेल-क्लोज़्ड ऑर्केस्ट्रेशन और नो-ओवरराइट रसीदें सुनिश्चित करता है। - मूल फ़ाइलों के लिए SHA-256 इनवेरिएंट बनाए रखता है। - 44 स्वचालित परीक्षण शामिल हैं (प्रारंभिक बेसलाइन: 43; +1 adversarial regression)। 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 Research UI रिपॉज़िटरी एक छोटा Next.js + Drizzle/PostgreSQL शोध ऐप संरक्षित करती है जिसे "Discovery Desk" कहा जाता है। - `src/app/`, `src/db/`, और `src/lib/research/` इस UI से संबंधित हैं। - यह भविष्य के ऑथरिंग एजेंट का रनटाइम **नहीं** है। - विकास के लिए `DATABASE_URL` एनवायरनमेंट वेरिएबल आवश्यक है (देखें `.env.example`)। वेरिएबल अनुपस्थित होने पर बिल्ड प्रक्रिया तेज़ी से विफल होती है, लेकिन CI के लिए किसी लाइव PostgreSQL सर्वर की आवश्यकता नहीं है क्योंकि कनेक्शन पूल लेज़ी है। ## सुरक्षा नियम - उपयोगकर्ता की प्लगइन की एकमात्र प्रति को कभी संशोधित न करें। - मूल अपरिवर्तनीय इनपुट हैं; लेखन कैंडिडेट्स में जाता है। - AI-जनित प्लान में मनमाने शेल कमांड नहीं। - प्राथमिक पथ के रूप में कोई कोऑर्डिनेट-क्लिक GUI ऑटोमेशन नहीं। - अनुपस्थित पूर्णता प्रमाण विफलता है, सफलता नहीं। - Bethesda गेम/एडिटर बाइनरी, वैनिला प्लगइन्स, या वैनिला Papyrus स्रोत कभी कमिट न करें। - प्रोसेस आइसोलेशन एक तकनीकी सीमा है, स्वचालित लाइसेंसिंग निष्कर्ष नहीं। ## लाइसेंसिंग - **रिपॉज़िटरी-रचित कोर कोड**: MIT License। - **Mutagen / Synthesis / Spriggit**: GPL-3.0-only। संयुक्त कार्यों के लिए GPL अनुपालन आवश्यक। - **xEdit**: MPL-2.0 अपस्ट्रीम। बाहरी निष्पादन के लिए अभिप्रेत, कभी वेंडर नहीं। - **CKPE**: LGPLv3 कोड प्लस Creation Kit EULA/कानूनी ओवरले। स्थिति: `LEGAL_REVIEW_REQUIRED`। - **Creation Kit, PapyrusCompiler, वैनिला एसेट्स**: मालिकाना उपयोगकर्ता-स्थापित घटक। कभी पुनर्वितरित नहीं। तृतीय-पक्ष npm पैकेज और OFL फ़ॉन्ट्स की अलग सूचनाएँ हैं। आयातित शोध ZIPs की उत्पत्ति अनसुलझी है। ## Sky-Claw से संबंध यह एक अलग रिपॉज़िटरी और शोध ट्रैक है। यह बाद में एक प्रलेखित प्रोटोकॉल के माध्यम से Sky-Claw के साथ एकीकृत हो सकती है, लेकिन इसे स्वतंत्र रूप से परीक्षण योग्य बने रहना चाहिए और Sky-Claw के आंतरिक तत्वों को अपनी सुरक्षा सीमा नहीं मानना चाहिए। ## अस्वीकरण Bethesda Game Studios, ZeniMax Media, Valve, Nexus Mods, या तृतीय-पक्ष टूल लेखकों से असंबद्ध।