ZIAFORGE / 1.0.1

ZIAForge उपयोगकर्ता मार्गदर्शिका

इरादे से लेकर सत्यापित परिणाम तक। Code, Work और एप्लिकेशन नियंत्रण के लिए एक व्यावहारिक मार्गदर्शिका।

अंग्रेज़ी प्रामाणिक है। मशीन द्वारा अनुवादित सहायता को मानव-समीक्षित अनुवादों से अलग लेबल किया गया है। स्वचालित जाँचें मूल-भाषा की सटीकता को प्रमाणित नहीं करती हैं।

पहले कदम

ZIAForge चर्चा, योजना, कार्यान्वयन और सत्यापन को एक ही कार्य में रखता है। Git प्रोजेक्ट के लिए Code चुनें, या एक साधारण फ़ोल्डर में दस्तावेज़ों, शोध और अन्य परिणामों के लिए Work चुनें।

एक अलग प्रोजेक्ट में एक छोटे से कार्य से शुरुआत करें। यदि आप मूल CLI चुनते हैं, तो पहले इसे स्थापित करें और टर्मिनल में इसके स्वयं के खाते से साइन इन करें। वैकल्पिक रूप से, एक API कनेक्शन कॉन्फ़िगर करें। एक CLI सदस्यता और एक सशुल्क API अलग-अलग कनेक्शन विधियाँ हैं; ZIAForge आपको साइन इन नहीं करता है या उनके बीच क्रेडिट ट्रांसफर नहीं करता है।

  1. सेटिंग्स खोलें और वर्कस्पेस फ़ोल्डर और भाषा की जाँच करें। अबाउट चल रहे बिल्ड की सटीक पहचान दिखाता है।
  2. Code के लिए, साइडबार में Git रिपॉजिटरी जोड़ें। Work के लिए, कार्य बनाते समय एक अलग फ़ोल्डर चुनें।
  3. CLI, मॉडल, रीज़निंग प्रयास और पहुँच स्तर के साथ एक प्रीसेट सहेजें। आप बिना किसी सहेजे गए प्रीसेट के सीधे कस्टम भी चुन सकते हैं।
  4. एक कार्य बनाएं, उसका मार्ग, भूमिकाएँ और मैन्युअल या स्वचालित प्रगति चुनें। प्रारंभ करने से पहले विकल्पों की समीक्षा करें।

संबंधित निर्देश: प्रोजेक्ट अवलोकन · प्रदाता संगतता.

सही डेस्कटॉप पैकेज स्थापित करें

अपने ऑपरेटिंग सिस्टम और CPU आर्किटेक्चर के लिए एक पैकेज चुनें: x64 या arm64। बिल्ड पाइपलाइन macOS DMG/ZIP, Windows NSIS इंस्टॉलर/ZIP, और Linux DEB/RPM/AppImage/tar.gz/ZIP प्रारूप तैयार कर सकती है। जेनरेट की गई फ़ाइल या क्रॉस-बिल्ड इस बात का प्रमाण नहीं है कि उसका इंस्टॉलर और मूल UI आपकी मशीन पर पास हो गया; उस रिलीज़ के सत्यापन रिकॉर्ड से परामर्श करें।

Electron 44 का उपयोग करने वाले macOS बिल्ड के लिए macOS 13 या बाद के संस्करण की आवश्यकता होती है। Apple सिलिकॉन पर arm64 पैकेज और Intel के लिए x64 पैकेज का उपयोग करें। प्रतिस्थापन से पहले किसी पुराने ऐप से पूरी तरह बाहर निकलें। पूर्वावलोकन पैकेज अहस्ताक्षरित और गैर-नोटरीकृत हो सकते हैं; विकास आर्टिफ़ैक्ट को हस्ताक्षरित सार्वजनिक रिलीज़ समझने की गलती न करें।

Windows को बंडल किए गए Electron संस्करण द्वारा समर्थित एक ऑपरेटिंग सिस्टम और PATH में Git उपलब्ध होना आवश्यक है। मेल खाने वाले आर्किटेक्चर को चुनें। एक अहस्ताक्षरित पूर्वावलोकन में Authenticode प्रमाणन नहीं होता है। एक पोर्टेबल ZIP में केवल निष्पादन योग्य फ़ाइल ही नहीं, बल्कि संपूर्ण एप्लिकेशन निर्देशिका और रनटाइम फ़ाइलें भी सुरक्षित रहनी चाहिए।

Linux को एक संगत ग्राफिकल डेस्कटॉप, Electron द्वारा आवश्यक सिस्टम लाइब्रेरी और Git की आवश्यकता होती है। एन्क्रिप्टेड नियंत्रण क्रेडेंशियल्स के लिए, gnome-libsecret या KWallet जैसी कार्यशील सीक्रेट सर्विस प्रदान करें; असुरक्षित basic_text बैकएंड स्वीकार नहीं किया जाता है। हेडलेस/कंटेनर स्मोक साक्ष्य हर डेस्कटॉप या वितरण को प्रमाणित नहीं करता है।

apt install ./file.deb के साथ DEB इंस्टॉल करें, या अपने वितरण के पैकेज मैनेजर के माध्यम से RPM इंस्टॉल करें। AppImage को निष्पादन योग्य अनुमति और उपयुक्त FUSE समर्थन की आवश्यकता होती है; जहाँ समर्थित हो वहाँ --appimage-extract-and-run एक विकल्प है। tar.gz और ZIP पैकेजों को उनकी सभी रनटाइम फ़ाइलों के साथ निकालें। किसी पैकेज को बदलते समय उपयोगकर्ता डेटा और एप्लिकेशन फ़ाइलों को अलग रखें।

स्रोत से निर्माण करने के लिए, सामान्य Electron इंस्टॉलर सहित Node 24, Git और npm ci का उपयोग करें। मूल पुनर्निर्माण के लिए प्लेटफ़ॉर्म टूल्स की आवश्यकता होती है: macOS पर Xcode कमांड-लाइन टूल्स; Windows पर MSVC C++, Windows SDK और Python; Linux पर कंपाइलर, make, Python, pkg-config और आवश्यक पैकेजिंग टूल्स। सटीक कमांड और वर्तमान प्लेटफ़ॉर्म सीमाओं के लिए PLATFORM_BUILDS.md का पालन करें।

रिलीज़ संस्करण केंद्रीय रूप से आरक्षित हैं और आउटपुट अपरिवर्तनीय हैं। एक CI सत्यापन बिल्ड कोई प्रकाशित इंस्टॉलर नहीं है। स्रोत अभिलेखागार में स्रोत, लॉकफ़ाइल, दस्तावेज़ीकरण और स्क्रिप्ट शामिल हैं; निर्भरताएँ, क्रेडेंशियल्स, उपयोगकर्ता प्रोफ़ाइल और निजी शोध बहिष्कृत हैं। एक सफल x64 बिल्ड से कभी भी मूल ARM या Windows सत्यापन का अनुमान न लगाएं।

संबंधित निर्देश: प्लेटफ़ॉर्म पैकेज, पूर्वापेक्षाएँ और सत्यापन सीमाएँ · बिल्ड पहचान और रिलीज़ जाँचें.

Code: पाँच मार्ग

Auto दायरे का आकलन करता है: एक साधारण प्रश्न एक उत्तर के साथ समाप्त हो सकता है, जबकि एक बड़े कार्य के लिए तैयारी की आवश्यकता होती है। बग ठीक करें एक कारण की जांच करता है और सुधार तैयार करता है। विशिष्टता पहले तकनीकी समाधान के साथ शुरू होता है; आवश्यकताएँ पहले आवश्यकताओं और स्वीकृति मानदंडों के साथ शुरू होता है।

मल्टी-मॉडल अन्वेषण, डिज़ाइन, कार्यान्वयन और समीक्षा के लिए अलग-अलग संदर्भों का उपयोग करता है। मार्ग के नाम के लिए विभिन्न प्रदाताओं की आवश्यकता नहीं होती है: प्रत्येक भूमिका आपके द्वारा चुने गए प्रीसेट या कस्टम कॉन्फ़िगरेशन का उपयोग करती है।

एक वर्क-ट्री कार्य के Git परिवर्तनों को अलग रखता है। शाखा चयनित चेकआउट में काम करती है। शुरू करने से पहले प्रोजेक्ट, शाखा और मॉडल की जाँच करें; कार्य विवरण सामान्य चैट पर भी नहीं भेजा जाता है।

अनसुलझे उत्पाद या तकनीकी विकल्पों वाले विचार के लिए, आवश्यकताएँ पहले का उपयोग करें और चर्चा में आधार तैयार करें। Auto अनुरोध को वर्गीकृत करता है; यह प्रत्येक संक्षिप्त वाक्यांश को तुरंत लागू करने का आदेश नहीं है। ड्राफ़्ट सहेजें किसी मॉडल से संपर्क किए बिना अनुरोध को बनाए रखता है; प्रारंभ करें सहेजता है और प्रबंधित प्रवाह को एक बार लॉन्च करता है। एक से चार कार्य प्रतियों में स्वतंत्र निर्माण आईडी और भूमिका सेटिंग्स होती हैं।

संबंधित निर्देश: Code वर्कफ़्लो अनुबंध · Code प्रॉम्प्ट प्रोफ़ाइल.

Forge चर्चा

प्रारंभ करें केंद्रीय चर्चा खोलता है। स्वाभाविक रूप से उत्तर दें, जवाबी प्रश्न पूछें, बाधाएं जोड़ें और तकनीकी विकल्पों पर चर्चा करें। बातचीत और प्रश्न कार्य के साथ ही रहते हैं।

पाठ भेजने से कोई दस्तावेज़ स्वीकार नहीं होता है या कोई नई कार्यान्वयन योजना अधिकृत नहीं होती है। निष्पादन के दौरान स्पष्टीकरण पहले प्रबंधित टर्न को रोकता है और प्रभावित दायरे पर दोबारा गौर करता है। पहले से स्वीकृत चरण के भीतर किसी प्रश्न का उत्तर उस चरण को जारी रख सकता है।

जानबूझकर आधार पर दोबारा गौर करने के लिए, आवश्यकताएँ, विशिष्टता या योजना का चयन करें। एक नए संस्करण के लिए आश्रित निर्णयों की नई स्वीकृति की आवश्यकता होती है। पूर्ण किए गए चरण और उनके साक्ष्य बने रहते हैं; अधिक्रमित अधूरे चरण इतिहास में रहते हैं।

प्रबंधित चरण सत्र मुफ़्त चैट से भिन्न होते हैं। वर्कफ़्लो-स्वामित्व वाले सत्र में सीधे मैन्युअल प्रॉम्प्ट भेजने के बजाय Forge चर्चा का उपयोग करें।

संबंधित निर्देश: Forge चर्चा अनुबंध.

दस्तावेज़ और निर्णय

एक दस्तावेज़ खोलें, उसके संस्करण का निरीक्षण करें और आवश्यकता पड़ने पर संपादन करें। चर्चा के माध्यम से संपादन सबमिट करने पर एक नया संस्करण बनता है; रिपोर्ट और सत्यापित परिणाम पूर्वव्यापी रूप से दोबारा नहीं लिखे जाते हैं।

प्रस्तावित योजना को स्वीकार करने से पहले, क्रम, निर्देश, स्वीकृति मानदंड और सत्यापन कमांड संपादित करें। उन ठोस कमांडों को अधिकृत करें जिन्हें आप समझते हैं: वे कार्य फ़ोल्डर में चलते हैं। मल्टी-मॉडल अपने दस्तावेज़ों और निर्देशों में विवरण के साथ, एक संपूर्ण-कार्य कार्यान्वयन चरण का प्रस्ताव करता है।

स्वीकृत करें एक अलग सुविचारित निर्णय है। Auto प्रश्नों या आवश्यकताओं, विशिष्टताओं और योजनाओं की स्वीकृति को बायपास नहीं करता है। बाह्य रूप से परिवर्तित दस्तावेज़ पुराने अनुमोदन का पुन: उपयोग नहीं कर सकता है।

तैयारी फ़ाइलें आर्टिफ़ैक्ट के रूप में दिखाई देती हैं। उनका संस्करण, निर्माण चरण और हैश उन्हें एक परिणाम से बांधते हैं। Code दस्तावेज़ वर्क-ट्री के बाहर रखे जाते हैं और स्वचालित रूप से कमिट में दर्ज नहीं होते हैं।

स्वीकार करने से पहले दस्तावेज़ और प्रदर्शित निर्णय दोनों की जाँच करें। स्वीकृति वर्तमान गेट ID, योजना संशोधन और सुरक्षित दस्तावेज़ हैश को बांधती है। दायरा या साक्ष्य गलत होने पर परिवर्तनों का अनुरोध करें। यदि कोई निर्णय पुराना हो गया है, तो नया विकल्प चुनने से पहले सहेजी गई स्थिति को पुनः लोड करें; बदली हुई फ़ाइल को पुराने संस्करण के तहत स्वीकार नहीं किया जा सकता है।

संबंधित निर्देश: वर्कफ़्लो गेट और दस्तावेज़ संस्करण.

कार्यान्वयन और समीक्षा

कार्य-सूची वास्तविक कदम, वर्तमान प्रयास, सत्यापन और समीक्षा परिणाम दिखाती है। किसी एजेंट का "हो गया" कहना किसी चरण को पूरा नहीं करता है: योजना का आवश्यक साक्ष्य मौजूद होना चाहिए।

मैन्युअल मोड पात्र चरणों के बीच रुकता है। Auto सत्यापित चरणों को आगे बढ़ाता है और सीमित पुनः प्रयासों की अनुमति देता है। इसके बाद रोकें हमेशा एक चेकपॉइंट बनाता है। रोकें वर्कफ़्लो के सक्रिय कार्य को रोक देता है; पैनल बंद करने से यह नहीं रुकता है।

एक स्वतंत्र समीक्षक फ़ाइलों और सत्यापन परिणामों के साथ एक अलग संदर्भ का उपयोग करता है। प्रत्येक आवश्यक अवरोधक निष्कर्ष का समाधान किया जाना चाहिए; एकाधिक समीक्षक मतदान द्वारा किसी अवरोधक त्रुटि को दूर नहीं कर सकते।

मल्टी-मॉडल में, निष्कर्षों को सही करने के लिए एक स्पष्ट निर्णय की आवश्यकता होती है। सुधार चुपचाप दूसरी समीक्षा शुरू नहीं करता है: पुनः समीक्षा करें एक नया चक्र खोलता है। समीक्षा टिप्पणियाँ कार्यान्वयन को दोहराए बिना समन्वयक पुनर्विचार का अनुरोध कर सकती हैं।

पूरे किए गए चरणों को चुपचाप संपादित नहीं किया जा सकता है। TDD के साथ, रेड को वास्तव में अपेक्षित कारण से विफल होना चाहिए, फिर ग्रीन को पास होना चाहिए। सीमित प्रयास अंतहीन पुनः प्रयासों को रोकते हैं।

सेटिंग्स → समीक्षा टीमें में स्वतंत्र CLI/API समीक्षकों को सहेजें, फिर Code या Work में टीम का चयन करें। समीक्षक समानांतर में चलते हैं, जिसके बाद टीम का रिपोर्ट आर्किटेक्ट आता है। आप सहेजी गई टीम के बिना भी स्वतंत्र समीक्षकों को कॉन्फ़िगर कर सकते हैं। रिपोर्ट आर्किटेक्ट केवल अज्ञात संरचित रिपोर्ट प्राप्त करता है, जिसमें कोई प्रोजेक्ट फ़ाइलें या टूल्स नहीं होते हैं; इस अलगाव के लिए वर्तमान में Claude Code या API की आवश्यकता होती है।

प्रत्येक कार्यान्वयन चरण के लिए एक निष्पादन योग्य जाँच, आवश्यक स्वतंत्र समीक्षा, या दोनों की आवश्यकता होती है। तैयारी चरण इसके बजाय मान्य परिणाम और आर्टिफ़ैक्ट रसीदें बनाए रखते हैं; ये यह दिखावा नहीं करते कि कार्यान्वयन परीक्षण चले थे। एक कमांड तभी सफल होती है जब उसकी वास्तविक निकास स्थिति और स्वामित्व वाली प्रक्रिया की सफ़ाई की पुष्टि हो जाती है। TDD के लिए एक रेड जाँच कार्यान्वयन और ग्रीन सत्यापन से पहले सामान्य रूप से विफल होनी चाहिए; एक अनुपलब्ध निष्पादन योग्य या टाइमआउट एक मान्य रेड परिणाम नहीं है।

डिफ़ॉल्ट सर्किट ब्रेकर एक चरण पर तीन असफल प्रयासों या कुल मिलाकर पचास प्रयासों के बाद रुक जाते हैं। रुकावट एक प्रयास की खपत करती है लेकिन इसे स्वयं एक असफल प्रयास के रूप में नहीं गिना जाता है। सीमाएँ और पूर्ण साक्ष्य पुनरारंभ के बाद भी बने रहते हैं; पुन: प्रयास करें उन्हें रीसेट नहीं करता है। किसी अन्य प्रयास को अधिकृत करने से पहले सुरक्षित विफलता को पढ़ें।

संबंधित निर्देश: सत्यापन और समीक्षा.

समानांतर समीक्षा टीमें और रिपोर्ट आर्किटेक्ट

सेटिंग्स → समीक्षा टीमें खोलें और एक टीम सहेजें। अपने स्वयं के CLI या API, मॉडल, रीज़निंग प्रयास और विशेषज्ञता के साथ स्वतंत्र समीक्षकों को जोड़ें, फिर एक रिपोर्ट आर्किटेक्ट चुनें। कार्य के समीक्षा कॉन्फ़िगरेशन में टीम का चयन करें। एक समीक्षक द्वारा निष्पादक प्रीसेट का भी उपयोग किया जा सकता है, और कस्टम उपलब्ध रहता है; स्वतंत्र भूमिकाओं के अभी भी अलग संदर्भ होते हैं।

समीक्षक एक ही कार्य साक्ष्य पर समानांतर में चलते हैं। प्रत्येक आवश्यक रिपोर्ट, त्रुटि और निर्णय सुरक्षित रखा जाता है। आर्किटेक्ट समीक्षक के नाम, मॉडल या प्रदाता की पहचान, मूल कार्य सामग्री, रिपॉजिटरी एक्सेस या टूल्स के बिना अज्ञात क्रमांकित रिपोर्ट प्राप्त करता है। यह रिपोर्टों की तुलना करता है और एक संरचित निर्णय लौटाता है; यह कोई नई स्रोत समीक्षा नहीं करता है।

एक अवरोधक निष्कर्ष या आवश्यक समीक्षक की अस्वीकृति को बहुमत के वोट या आर्किटेक्ट की प्राथमिकता से माफ नहीं किया जा सकता है। गुम या विकृत रिपोर्ट अनुमोदन को रोकती हैं। सुधारों को स्वीकार करने या अधिकृत करने से पहले व्यक्तिगत निष्कर्षों और समग्र निर्णय का निरीक्षण करें। एक सहेजी गई टीम रन के लिए निर्धारित और स्थिर (फ़्रोज़न) होती है; इसके प्रीसेट को संपादित करने से पूर्ण साक्ष्य दोबारा नहीं लिखा जाता है।

रिपोर्ट-केवल आर्किटेक्ट वर्तमान में समर्थित Claude या API टूल-मुक्त कॉन्फ़िगरेशन का उपयोग करता है। Codex और Antigravity समीक्षकों के रूप में उपलब्ध रहते हैं लेकिन इस पृथक आर्किटेक्ट भूमिका के लिए तब तक अस्वीकार कर दिए जाते हैं जब तक कि एक सत्यापित टूल-मुक्त अनुबंध मौजूद न हो। अकेले "कोई टूल्स नहीं" कहने वाला प्रॉम्प्ट पर्याप्त नहीं है।

संबंधित निर्देश: टाइप्ड टीम कॉन्फ़िगरेशन · समीक्षा एकत्रीकरण.

एजेंट विशेषज्ञताएं और प्रॉम्प्ट नीति

एक मॉडल निष्पादन इंजन है; एक विशेषज्ञता एक निर्देश प्रोफ़ाइल है। कोई अतिरिक्त विशेषज्ञता न रखने के लिए कोई नहीं, डिफ़ॉल्ट गाइड के लिए मानक, प्रासंगिक अंतर्निहित गाइड के लिए Auto, या चयनित गाइड और अपने स्वयं के सीमित निर्देशों के लिए मैन्युअल चुनें। प्रीसेट चयन को बनाए रख सकते हैं।

मूल कैटलॉग सामान्य कोडिंग, वास्तुकला, सुरक्षा, विश्वसनीयता, प्रदर्शन, परीक्षण और इंटरफ़ेस उपयोगिता को शामिल करता है। Auto एक गाइड का चयन करने के लिए उपलब्ध कार्य/चरण पाठ का उपयोग करता है; यह चुपके से किसी अन्य मॉडल को कॉल नहीं करता है या विशेषज्ञता को प्रमाणित नहीं करता है। कार्यान्वयन योजना को स्वीकार करने से पहले योजना सुझावों का निरीक्षण और परिवर्तन किया जा सकता है।

समीक्षा विशेषज्ञताएं ध्यान आकर्षित करने में मदद करती हैं लेकिन कभी भी स्वतंत्र साक्ष्य, पहुँच सीमाओं या संरचित निर्णय की जगह नहीं लेती हैं। कस्टम निर्देशों को कार्य के दायरे के हिस्से के रूप में देखें: दस्तावेज़ स्वीकृति, टूल नीति, प्रमाणीकरण या समीक्षक विफलताओं को बायपास करने के लिए उनका उपयोग न करें।

संबंधित निर्देश: मूल प्रॉम्प्ट कैटलॉग.

Work: प्रश्न से दस्तावेज़ तक

Work के लिए Git की आवश्यकता नहीं है। डिफ़ॉल्ट एक अलग कार्य फ़ोल्डर बनाता है; कस्टम मूल पिकर के माध्यम से मौजूदा फ़ोल्डर का चयन करता है। ड्राफ़्ट सहेजें बिना निष्कर्ष के सेटिंग्स को संग्रहीत करता है; प्रारंभ करें पहले चरण को चलाता है।

Auto सीधे उत्तर देता है या वास्तविक कार्य-सूचियों के साथ एक उपयुक्त योजना का प्रस्ताव करता है। ब्रेनस्टॉर्म आपके द्वारा अधिक विचारों या मूल्यांकन का चयन करने से पहले ideas.md बनाता है। रिसर्च findings.md, स्रोतों और सीमाओं को बनाए रखता है। लिखें इरादे से और, उपयोगी होने पर, outline.md से एक वर्णनात्मक दस्तावेज़ या draft.md की ओर बढ़ता है; संशोधन पिछले संस्करणों को बनाए रखते हैं।

मूल पिकर के माध्यम से फ़ाइल इनपुट का चयन करें और उन्हें @ के साथ संदर्भित करें। ऐप उन्हें अपरिवर्तनीय कार्य इनपुट के रूप में कॉपी करता है और रन से पहले उनकी पहचान को मान्य करता है। डिफ़ॉल्ट एप्लिकेशन-स्वामित्व वाला कार्य फ़ोल्डर बनाता है; कस्टम फ़ोल्डर एक्सेस एक सहेजा गया स्वामी अनुदान है। एक सहेजा गया, शुरू नहीं किया गया ड्राफ़्ट अपना फ़ोल्डर बदल सकता है।

स्वतंत्र निष्पादक सेटिंग्स के साथ 1–4 प्रतियां बनाएं। परस्पर व्यापी (ओवरलैपिंग) फ़ोल्डरों का उपयोग करने वाले कार्य एक साथ नहीं लिख सकते हैं। यह समन्वय ZIAForge संचालन पर लागू होता है, मनमाने बाहरी प्रोग्रामों पर नहीं।

डीप ब्रेनस्टॉर्म डिफ़ॉल्ट रूप से तीन स्वतंत्र कार्यकर्ताओं पर काम करता है और आठ तक का समर्थन करता है। उनके क्रम और कॉन्फ़िगरेशन का चयन करें, जिसमें अलग-अलग संदर्भों में प्रीसेट का पुन: उपयोग शामिल है। कार्यकर्ता प्रश्न अपने मूल को बनाए रखते हैं; विकृत रिपोर्टों को प्रारूप-मरम्मत का एक प्रयास मिलता है। आंशिक विफलता सर्वसम्मत सफलता के रूप में प्रस्तुत किए जाने के बजाय दृश्यमान रहती है।

डीप सुरक्षित कार्यकर्ता रिपोर्टों को brainstorm_report.md में जोड़ता है और हमेशा उपयोगकर्ता के निर्णय की मांग करता है। एक छोटा अनुवर्ती समन्वयक के माध्यम से रिपोर्ट को संशोधित करता है; एक बड़ा परिवर्तन स्थिर कार्यकर्ताओं का एक और दौर शुरू करता है। आर्टिफ़ैक्ट अपने संस्करण बनाए रखते हैं।

निर्धारित भूमिकाएं कार्य निर्माण या स्पष्ट ड्राफ़्ट सहेजने पर स्थिर हो जाती हैं। पहले आमंत्रण के बाद, केवल स्वचालित/मैन्युअल प्रगति बदल सकती है; भिन्न भूमिका या मॉडल सेटिंग्स के लिए एक नए कार्य का उपयोग करें। वैश्विक प्रीसेट को संपादित करने से बाद के चरण चुपचाप नहीं बदलते हैं।

मैन्युअल मोड पात्र चरणों के बीच रुकता है, जिसमें एक महत्वपूर्ण लेखन रूपरेखा भी शामिल है। Auto उस रूपरेखा के माध्यम से जारी रह सकता है। प्रश्न, प्रस्तावित निष्पादन योग्य योजनाएँ, ब्रेनस्टॉर्म दिशा और डीप रिपोर्ट समीक्षा Auto में भी स्पष्ट निर्णय बने रहते हैं। अकेले उद्धरण यह साबित नहीं करता कि ब्राउज़िंग हुई है, और अकेले सुरक्षित बाइनरी फ़ाइल इसके रेंडरिंग को साबित नहीं करती है।

संबंधित निर्देश: Work मोड और निर्णय.

प्रीसेट, मॉडल और पहुँच

एक प्रीसेट एक CLI/API, मॉडल, रीज़निंग प्रयास और अनुमतियों को सहेजता है। चैट फ़ूटर में प्रीसेट, CLI, मॉडल और विकल्प खंड होते हैं। कस्टम बिना प्रीसेट के काम करता है; प्रीसेट बनाएं वर्तमान चयन को सहेजता है।

कैटलॉग चयनित स्थापित CLI या API से आता है जहाँ समर्थित हो। रीफ़्रेश चयन को बदले बिना सूची को अपडेट करता है। यदि खोज अनुपलब्ध है, तो एक स्पष्ट मॉडल ID दर्ज करें; प्रदाता को अभी भी इसका समर्थन करना चाहिए। रीज़निंग स्तर मॉडल और CLI पर निर्भर करते हैं। प्रदाता डिफ़ॉल्ट स्पष्ट 'none' टोकन से अलग है।

बैकएंड पावती के बाद ही परिवर्तन लागू करें। सक्रिय टर्न या गैर-खाली कतार के दौरान स्विच करना प्रतिबंधित है। ड्राफ़्ट और दृश्यमान इतिहास बने रहते हैं, लेकिन प्रदाताओं को बदलने से उनकी निजी आंतरिक स्थिति स्थानांतरित नहीं होती है।

Forge में, भूमिका का लेबल मायने रखता है: तैयारी के लिए एक अलग योजनाकार (Planner) का उपयोग किया जा सकता है। फ़ूटर प्रदर्शित भूमिका को बदलता है; समीक्षक और सहायक वर्कफ़्लो सेटिंग्स में चुने जाते हैं। पहले से सत्यापित कार्यान्वयन की नीति लॉक हो सकती है।

विभिन्न प्रदाताओं के बीच अनुमतियाँ भिन्न होती हैं। केवल पढ़ें और वर्कस्पेस लिखें उपलब्ध हैं जहाँ एडॉप्टर उनका समर्थन करता है। Antigravity मूल CLI सेटिंग्स या स्पष्ट रूप से चयनित पूर्ण पहुँच का उपयोग करता है। पूर्ण पहुँच कोई सैंडबॉक्स नहीं है।

विशेषज्ञता प्रॉम्प्ट मार्गदर्शन जोड़ती है, कोई अन्य मॉडल या अनुमति नहीं। प्रीसेट और भूमिकाएं कोई नहीं, मानक, Auto और मैन्युअल का समर्थन करते हैं। Auto बिना किसी अतिरिक्त मॉडल कॉल के चरण पाठ से प्रोफ़ाइल का चयन करता है; मैन्युअल चार विशिष्टताओं और कस्टम निर्देशों तक स्वीकार करता है। योजनाकार-प्रस्तावित असाइनमेंट को योजना स्वीकार करने से पहले संपादित किया जा सकता है।

मैन्युअल रूप से दर्ज किया गया मॉडल ID या प्रयास आपकी पसंद रहता है, लेकिन प्रदाता इसे अस्वीकार कर सकता है। वैश्विक प्रीसेट को संपादित करने से चल रही चैट या स्वीकृत योजना पूर्वव्यापी रूप से नहीं बदलती है। किसी निष्क्रिय बातचीत को जानबूझकर बदलने के लिए, उसके स्वयं के कॉन्फ़िगरेशन नियंत्रणों का उपयोग करें और पावती की प्रतीक्षा करें। अक्षम विकल्प को क्षमता या जीवनचक्र सीमा के रूप में पढ़ा जाना चाहिए, सहेजे गए JSON को संपादित करके बायपास नहीं किया जाना चाहिए।

संबंधित निर्देश: प्रदाता क्षमताएं.

चैट, रोकें और कतार

खुले टैब, हाल के और ड्राफ़्ट एक ही कार्य से संबंधित हैं। किसी टैब को बंद करने से वह खुले टैब से हट जाता है लेकिन हाल के में बना रहता है और यह उसके प्रदाता की प्रक्रिया या प्रबंधित वर्कफ़्लो को नहीं रोकता है। इतिहास खोजें, किसी चैट को फिर से खोलें या इतिहास मेनू से सभी अतिरिक्त टैब बंद करें।

रोकें वर्तमान टर्न को बाधित करता है। अगला भेजें दबाने से पहले रुकने की प्रक्रिया पूरी होने तक प्रतीक्षा करें: व्यवधान की पावती प्रक्रिया पूरी होने का प्रमाण नहीं है। इस बीच आप अगला ड्राफ़्ट टाइप कर सकते हैं।

सामान्य चैट में, कतार बाद के अनुरोध को वर्तमान ड्राफ़्ट से अलग सहेजती है। कतार रोकें आगे की डिलीवरी को रोक देता है। रोकें और बाहर निकलें कतार को रोक देते हैं। पुनरारंभ के बाद, पहले फिर से शुरू करें, फिर स्पष्ट रूप से कतार जारी रखें।

अनिश्चित का अर्थ है कि डिलीवरी अज्ञात है। ऐसे संदेश को स्वचालित रूप से दोबारा नहीं भेजा जाता है: इतिहास का निरीक्षण करें, यदि उपयुक्त हो तो पाठ कॉपी करें और कतारबद्ध आइटम को खारिज करें। इसे दोबारा भेजना एक नया सुविचारित अनुरोध है।

प्रबंधित चरण चैट सामान्य कतार के बजाय अपने वर्कफ़्लो का उपयोग करते हैं। फ़ॉलो चरण वर्तमान चरण को दिखाता है; मैन्युअल रूप से किसी अन्य टैब का चयन करने से फ़ॉलो करना बंद हो जाता है। CLI लॉग प्रतिक्रिया से अलग डायग्नोस्टिक्स दिखाते हैं।

मार्कडाउन प्रतिक्रियाएँ शीर्षक, सूचियाँ, तालिकाएँ, लिंक और फ़ेंस्ड कोड रेंडर करती हैं। टूल कार्ड और CLI डायग्नोस्टिक्स उत्तर से अलग रहते हैं। मॉडल द्वारा रिपोर्ट किया गया चिंतन और टोकन मेट्रिक्स केवल तभी दिखाई देते हैं जब प्रदाता वास्तव में उन्हें दिखाता है; एनिमेशन से निजी रीज़निंग या उपयोग का अनुमान न लगाएं।

अनिश्चित भेजने या कतार पावती के बाद, इतिहास का निरीक्षण करें और केवल उसी सुरक्षित अनुरोध को पुनः प्रयास करें जहाँ विकल्प दिया गया हो। एक कतार रसीद का अर्थ है कि स्टोरेज ने आइटम स्वीकार कर लिया है, न कि निष्कर्ष पूरा हो गया है। एक अनिश्चित कतारबद्ध आइटम को केवल एक स्पष्ट बर्खास्तगी के रूप में निकालें; यह पहले से डिलीवर किए जा चुके प्रॉम्प्ट को वापस नहीं ले सकता है।

संबंधित निर्देश: टिकाऊ संदेश कतार.

फ़ाइलें, Git और पूर्णता

फ़ाइलें कार्य फ़ोल्डर दिखाती हैं। परिणामों की आवश्यकताओं के साथ तुलना करें, दस्तावेज़ खोलें और अंतरों (डिफ़) का निरीक्षण करें। बाइनरी फ़ाइल को बनाए रखना उसके लक्षित एप्लिकेशन में सही रेंडरिंग साबित नहीं करता है।

Git रिकॉर्ड किए गए परिणामों के साथ स्थिति, परिवर्तन और संचालन प्रदान करता है। कमिट, मर्ज और पुश डिफ़ॉल्ट रूप से मैन्युअल हैं; स्वचालित संचालन पूरी तरह से सत्यापित योजना के लिए अलग विकल्प हैं।

सत्यापन और प्रकाशन के बीच कार्य फ़ाइलों को न बदलें: अनुमोदन सटीक बाइट्स से बंधा होता है। टकराव, विफल पुश और अज्ञात संचालन परिणाम एक स्पष्ट निर्णय तक प्रगति को रोकते हैं। Auto चुपचाप प्रकाशन को अधिकृत नहीं करता है।

Work कोई Git शाखाएँ नहीं बनाता है और इसमें कोई Git अंतिमीकरण नहीं है। चयनित फ़ोल्डर से आवश्यक दस्तावेज़ रखें, जिसमें संस्करण और स्रोत शामिल हैं।

फ़ाइल संपादक एक्सटेंशन द्वारा सिंटैक्स, खोजें और बदलें, अनडू इतिहास, लाइन रैपिंग और प्रति-टैब ड्राफ़्ट प्रदान करता है। सहेजना समर्थित UTF-8/UTF-16 एन्कोडिंग को सुरक्षित रखता है और बाहरी संशोधन टकरावों को अस्वीकार करता है। अन्य एन्कोडिंग और बाइनरी सामग्री के लिए बाहरी संपादक की आवश्यकता होती है। बिना सहेजे गए ड्राफ़्ट स्वामी द्वारा उन्हें सहेजने या त्यागने तक एप्लिकेशन को बाहर निकलने (Quit) से रोकते हैं।

पूर्ण सिंटैक्स 8 MiB तक सक्षम है। बड़ी टेक्स्ट फ़ाइलें 256 KiB विंडो में खुलती हैं; 8–64 MiB को सिंटैक्स के बिना स्पष्ट रूप से पूरा लोड किया जा सकता है। 64 MiB से ऊपर विंडो संपादन और सीमित अगले-मिलान खोज का उपयोग करें। यह एक सीमित बड़ी-फ़ाइल मोड है, मनमाने ढंग से बड़े दस्तावेज़ों के लिए सबलाइम टेक्स्ट की समानता नहीं।

फ़ोल्डर खोलें चुपचाप केवल मूल रिपॉजिटरी को खोलने के बजाय वर्तमान कार्य या शाखा/वर्क-ट्री संदर्भ का उपयोग करता है। एक फ़ाइल पंक्ति उस फ़ाइल की पैरेंट निर्देशिका को प्रकट कर सकती है। बैकएंड द्वारा पंजीकृत कार्य अनुदानों के विरुद्ध पथों को मान्य किया जाता है। बाइनरी फ़ाइलें सादे पाठ के रूप में संपादन योग्य नहीं हैं; उनके लक्षित व्यूअर का उपयोग करें और मूल बाइट्स बनाए रखें।

वर्क-ट्री हटाना एक अलग सुरक्षित कार्रवाई है। इसे हटाने से पहले संलग्न संरचित सत्रों और टर्मिनलों को समाप्त करें, जिसमें निष्क्रिय सत्र भी शामिल हैं। सहेजे गए Git परिणाम और पुनर्प्राप्ति स्थिति का निरीक्षण करें; किसी कार्य रिकॉर्ड को हटाना असंबद्ध (अनकमिटेड) कार्य को सुरक्षित रूप से संरक्षित करने का विकल्प नहीं है।

संबंधित निर्देश: टाइप्ड एडिटर अनुबंध · Git नीतियां.

API कनेक्शन

कनेक्शन एक स्पष्ट रूप से चयनित OpenAI-संगत एंडपॉइंट जोड़ता है। एक नाम, आधार URL, मॉडल और आवश्यकता पड़ने पर एक कुंजी दर्ज करें। कई सर्वरों को /v1 पर समाप्त होने वाले आधार URL की आवश्यकता होती है; अपने एंडपॉइंट दस्तावेज़ीकरण से परामर्श करें।

लूपबैक HTTP को छोड़कर HTTPS आवश्यक है। URL में एम्बेडेड क्रेडेंशियल्स के बिना एक सामान्य एंडपॉइंट का उपयोग करें। कुंजियाँ समर्थित OS एन्क्रिप्शन का उपयोग करती हैं और UI पर वापस नहीं भेजी जाती हैं। एंडपॉइंट बदलने पर उसकी कुंजी दोबारा दर्ज करनी होगी। कुंजी फ़ील्ड को खाली छोड़ने से सहेजी गई कुंजी सुरक्षित रहती है; सहेजी गई कुंजी निकालें इसे स्पष्ट रूप से हटा देता है।

API कॉल CLI सदस्यता का उपयोग नहीं करते हैं। टूल्स और मॉडल मूल सत्रों से भिन्न होते हैं, और सफल मॉडल खोज निष्कर्ष (इन्फ़रेंस) को प्रमाणित नहीं करती है। टोकन उपयोग केवल तभी दिखाई देता है जब प्रदाता वास्तव में इसे लौटाता है।

क्रेडेंशियल्स को कार्य के विवरण या प्रीसेट निर्देशों के बजाय कनेक्शन में रखें। केवल-पढ़ने वाले समीक्षकों को केवल उनके अनुमत API फ़ाइल टूल्स प्राप्त होते हैं; रिपोर्ट आर्किटेक्ट के पास कोई टूल्स नहीं होते हैं। असमर्थित टूल कॉल्स को चुपचाप निष्पादित करने के बजाय अस्वीकार कर दिया जाता है। सर्वर रीज़निंग मापदंडों, टूल समर्थन और मॉडल सूचियों में भिन्न होते हैं; किसी त्रुटि की तुलना अपने एंडपॉइंट के स्वयं के अनुबंध से करें।

संबंधित निर्देश: API कनेक्शन.

सेटिंग्स, भाषाएं और सुरक्षित रीसेट

सामान्य सेटिंग्स वर्कस्पेस, इंटरफ़ेस भाषा और डिफ़ॉल्ट का चयन करती हैं। कनेक्शन API एंडपॉइंट्स का प्रबंधन करता है। प्रीसेट और समीक्षा टीमें भूमिका कॉन्फ़िगरेशन को बनाए रखती हैं। रिमोट कंट्रोल स्थानीय क्रेडेंशियल्स, सर्वर दायरे और स्वामी अनुमतियों का प्रबंधन करता है; अपडेट रिलीज़ स्रोत/चैनल का प्रबंधन करता है। अबाउट वर्तमान में चल रहे सटीक बिल्ड को दिखाता है।

इंटरफ़ेस भाषा प्रॉम्प्ट भाषा और दस्तावेज़ीकरण समीक्षा स्थिति से अलग है। उत्पाद नाम, आदेश आईडी, फ़ाइल एक्सटेंशन, प्रदाता मॉडल आईडी और उपयोगकर्ता द्वारा बनाए गए नाम पहचानकर्ता बने रहते हैं। सहायता चयनित इंटरफ़ेस भाषा का अनुसरण करती है जब वर्तमान अनुवाद उपलब्ध होता है; मशीन अनुवादों को लेबल किया जाता है और अंग्रेज़ी प्रामाणिक संदर्भ बनी रहती है।

Save प्रदर्शित कॉन्फ़िगरेशन को लागू करता है। डेटाबेस रीसेट या फ़ैक्टरी रीसेट अनुप्रयोग मेटाडेटा को हटा सकता है; जानबूझकर रीसेट का उपयोग करने से पहले फ़ाइलों और एक परीक्षण किए गए बैकअप को सुरक्षित रखें। ये ऑपरेशन स्थानीय-स्वामी की कार्रवाइयां हैं। किसी विफल वर्कफ़्लो या दूषित रिकॉर्ड की जांच के लिए शॉर्टकट के रूप में इनका उपयोग न करें।

संबंधित निर्देश: स्थानीयकरण निर्देश · डेटा पुनर्प्राप्ति.

सहायता सहायक से पूछें

सहायता खोलें, इसके सहायक पैनल में एक सहेजा गया कनेक्टेड प्रीसेट चुनें और ZIAForge के बारे में पूछें। उत्तर वर्तमान प्रामाणिक अंग्रेज़ी गाइड और आपकी चयनित इंटरफ़ेस भाषा का उपयोग करते हैं। अनुभाग-संदर्भ बटन प्रासंगिक गाइड विषयों को खोलते हैं, ताकि आप स्पष्टीकरण की तुलना संदर्भ से कर सकें।

यह सहायक 100 सहेजी गई प्रविष्टियों और 3 MiB तक का एक अलग निजी वार्तालाप रखता है। 12,000 वर्णों तक का एक प्रश्न दर्ज करें; Send इसे पूछता है, Stop आपके प्रश्न को उपलब्ध रखते हुए सक्रिय उत्तर को रद्द करता है, और Clear इस सहायता वार्तालाप को हटा देता है। आपका न भेजा गया ड्राफ़्ट और प्रीसेट चयन उसी ऐप सत्र में सहायता को बंद करने या फिर से खोलने पर भी बना रहता है, लेकिन ड्राफ़्ट डिस्क पर सहेजा नहीं जाता है। सहायक अनुप्रयोग आदेश नहीं भेजता है, वर्कफ़्लो नहीं बदलता है या गेट स्वीकार नहीं करता है। सलाह किसी कार्य, खाते या बाहरी कनेक्शन का लाइव सत्यापन नहीं है।

Claude Code और API सहायता सत्र समर्थित उपकरण-रहित नीति लागू करते हैं। मूल Codex और Antigravity सहायता सत्रों के लिए मौजूदा स्थानीय-स्वामी मूल कंप्यूटर अनुमति की आवश्यकता होती है। यदि यह अक्षम है, तो ऐप एक अलग प्रदाता चुनने के बजाय पूर्वापेक्षा की व्याख्या करता है। केवल स्वामी ही इसे स्थानीय नियंत्रण सेटिंग्स में सक्षम कर सकता है; सहायक इसे स्वयं सक्षम नहीं कर सकता है।

Codex सहायता केवल-पढ़ने योग्य सैंडबॉक्स का उपयोग करती है और उपकरण-अनुमोदन अनुरोधों को अस्वीकार करती है। Antigravity योजना मोड और इसके मूल सैंडबॉक्स फ़्लैग का उपयोग करता है। ये मूल मोड ऑपरेटिंग-सिस्टम कारावास की सार्वभौमिक गारंटी नहीं हैं। स्रोत-गाइड हैश उत्तर के लिए उपयोग किए गए संदर्भ की पहचान करता है; जनरेट किया गया स्पष्टीकरण अभी भी गलत हो सकता है, इसलिए कार्रवाई करने से पहले इसके लिंक किए गए अनुभागों का निरीक्षण करें। पुराने उत्तरों को तब चिह्नित किया जाता है जब उनका स्रोत-गाइड संस्करण वर्तमान गाइड से भिन्न होता है।

संबंधित निर्देश: प्रामाणिक गाइड और अनुवाद रखरखाव · अनुप्रयोग सहायक और अनुमतियाँ.

सहायक और Telegram

सहायक चयनित प्रीसेट और उसी अनुप्रयोग नियंत्रण API का उपयोग करता है। स्थिति का निरीक्षण करने की अनुमति और संचालन करने की अनुमति अलग-अलग हैं। आदेशों और परिणामों का निरीक्षण करें: सहायक का विवरण इस बात का प्रमाण नहीं है कि कोई कार्रवाई पूरी हो गई है।

Telegram केवल स्थानीय स्वामी द्वारा, एक मौजूदा बॉट टोकन और संख्यात्मक स्वामी ID के साथ सक्षम किया जाता है। नियंत्रण उस स्वामी की निजी चैट के लिए है। किसी असंगत या निष्क्रिय बॉट को अनुप्रयोग संदेश प्राप्त नहीं होने चाहिए।

बॉट टोकन को सामान्य चैट में पेस्ट न करें। एकीकरण को कॉन्फ़िगर करना Telegram कनेक्टिविटी को साबित नहीं करता है और स्वचालित रूप से कोई बॉट नहीं बनाता है। स्क्रीनशॉट और प्रतिक्रियाओं में निजी कार्यस्थान डेटा हो सकता है।

सहायक प्रीसेट का चयन करें और निरीक्षण से अलग अनुप्रयोग-संचालन अनुमति प्रदान करें। Codex और Antigravity सहायक निष्पादन के लिए स्वामी की मूल अनुमति की आवश्यकता होती है; वे उपकरण-रहित API या Claude सत्र के लिए चुपचाप प्रतिस्थापित नहीं किए जाते हैं। स्क्रीनशॉट सहायक वार्तालाप में प्रदर्शित किए जा सकते हैं, लेकिन वर्तमान मॉडल इनपुट में छवि विश्लेषण शामिल नहीं है। यह न मानें कि सहायक ने किसी छवि का केवल इसलिए दृश्य रूप से निरीक्षण किया क्योंकि उसने इसे प्रदर्शित किया था।

सहायक टाइप किए गए उपकरणों के माध्यम से सारांश, कार्य, चैट, वर्कफ़्लो स्थिति, प्रक्रिया संदर्भ और अनुप्रयोग विंडो का निरीक्षण कर सकता है। यह अनुमत सामान्य सेटिंग्स को बदल सकता है और अधिकृत अनुप्रयोग संचालन शुरू कर सकता है। यह मूल अधिकार नहीं दे सकता, संग्रहीत क्रेडेंशियल प्रकट नहीं कर सकता, मूल कार्यस्थान अनुमति को दूरस्थ रूप से नहीं बदल सकता या केवल सुविधाजनक होने के कारण किसी Forge गेट को स्वीकृत नहीं कर सकता।

संबंधित निर्देश: अनुप्रयोग नियंत्रण अनुबंध.

अपना निजी Telegram बॉट संचालित करें

अपना स्वयं का बॉट बनाएं या प्राप्त करें, उसकी निजी चैट शुरू करें, और स्थानीय नियंत्रण सेटिंग्स में उसका टोकन और अपना संख्यात्मक Telegram उपयोगकर्ता ID दर्ज करें। एकीकरण को केवल तभी सक्षम करें जब आप चाहते हों कि ऐप कनेक्ट हो। स्वामी ID एक उपयोगकर्ता पहचानकर्ता है, कोई उपयोगकर्ता नाम या बॉट ID नहीं। केवल उसी निजी चैट में उस उपयोगकर्ता के संदेश स्वीकार किए जाते हैं।

चल रहे संस्करण, प्रोजेक्ट/कार्य गणना और कार्य स्थितियों के अवलोकन के लिए /start, /menu या /status का उपयोग करें। बटन Projects, Tasks, Screenshot, Help और Language खोलते हैं। सूचियाँ प्रति पृष्ठ आठ आइटम दिखाती हैं, जिसमें Back, Refresh, Home और Previous/Next नेविगेशन शामिल हैं। प्रोजेक्ट बटन कार्य सूची को फ़िल्टर करते हैं। एक कार्य कार्ड उसकी सहेजी गई वर्कफ़्लो प्रगति, मॉडल/प्रीसेट और मौजूद होने पर लंबित प्रश्न दिखाता है।

खुले/हाल के वार्तालापों और वर्कफ़्लो चरण चैट का पूर्वावलोकन करने के लिए कार्य का Chats खोलें। प्रत्येक पूर्वावलोकन अधिकतम छह नवीनतम उपयोगकर्ता/सहायक संदेश दिखाता है, जो स्पष्ट रूप से प्रत्येक 200 वर्णों तक छोटा किया गया है। निजी तर्क नहीं दिखाया गया है। इतिहास पढ़ने से कोई प्रदाता प्रारंभ नहीं होता है। पूर्वावलोकन केवल-पढ़ने योग्य हैं: सामान्य पाठ और /ask TEXT अभी भी अनुप्रयोग सहायक को संबोधित करते हैं, कभी भी अंतर्निहित रूप से उस कार्य चैट को नहीं जिसे आप देख रहे हैं।

Run / Continue वर्तमान Code या Work वर्कफ़्लो को फिर से पढ़ता है और एक योग्य सहेजे गए वर्कफ़्लो को शुरू करता है। Pause इसे रोकने का अनुरोध करता है। न तो आवश्यकताओं, विनिर्देशों, योजना, समीक्षा निष्कर्षों या प्रश्नों को स्वीकार करता है; एक लंबित निर्णय Run को रोकता है। अनुप्रयोग में निर्णय लें, या इसके सटीक वर्तमान गेट और संशोधन के साथ स्पष्ट रूप से अधिकृत टाइप किए गए आदेश का उपयोग करें।

56 इंटरफ़ेस भाषाओं में से किसी को भी उसके मूल नाम से चुनने के लिए Language या /language का उपयोग करें। यह केवल इस बॉट और स्वामी के लिए प्राथमिकता बनाए रखता है। Use app language उस प्राथमिकता को हटा देता है। यह न तो अनुप्रयोग की भाषा बदलता है और न ही पहुंच अनुमतियां; मौजूदा संदेश स्वचालित रूप से दोबारा नहीं भेजे जाते हैं।

नेविगेशन सामान्यतः उसी प्रकाशित मेनू संदेश को अपडेट करता है। बटनों की अपारदर्शी पहचान होती है जो 15 मिनट के बाद समाप्त हो जाती है और एक बार उपयोग की जा सकती है; कार्ड बदलने से उसके पुराने बटन अमान्य हो जाते हैं। समाप्त, उपभोग किए गए, बेमेल-संदेश और पिछली-प्रक्रिया वाले बटन कोई कार्रवाई नहीं कर सकते। निश्चित रूप से गैर-संपादन योग्य संदेश को एक नए कार्ड से बदला जा सकता है; अज्ञात नेटवर्क त्रुटि को नए संदेश के रूप में पुन: प्रयास नहीं किया जाता है।

सक्रियण पर पोलर पहले के बैकलॉग को छोड़ देता है और प्रेषण से पहले अद्यतन स्वीकृति रिकॉर्ड करता है ताकि पुनरारंभ होने पर बाधित आदेश स्वचालित रूप से फिर से न चलाए जाएं। यह पुनः चलाने से रोकता है; यह पूर्णता की गारंटी नहीं देता है। किसी त्रुटि के बाद जानबूझकर नया काम जारी करने से पहले स्थिति/संदर्भ की जाँच करें। कोई स्वचालित कार्य-स्थिति सूचनाएं नहीं हैं।

स्पष्ट आदेश उपलब्ध रहते हैं: /projects, /tasks, /task TASK_ID, /run TASK_ID, /pause TASK_ID, /screenshot और /ask TEXT। /new {JSON} टाइप किए गए createTask के माध्यम से एक कार्य बनाता है; /command {JSON} एक स्पष्ट कैटलॉग आदेश भेजता है। तर्क आकृतियों के लिए लाइव कैटलॉग पढ़ें। वही बैकएंड प्राधिकरण और फ़ोल्डर अनुमतियाँ लागू होती हैं जो अनुप्रयोग में हैं।

ऐप संग्रहीत बॉट-टोकन मान कभी भी सहायक को नहीं भेजता है। फिर भी स्क्रीनशॉट, सारांश और वार्तालाप पाठ में निजी परियोजना जानकारी हो सकती है। यदि बॉट या स्वामी खाते पर अब भरोसा नहीं है तो एकीकरण को स्थानीय रूप से रोकें। बॉट प्रदाता के साथ लीक हुए टोकन को बदलें, फिर इसके स्थानीय एन्क्रिप्टेड कॉन्फ़िगरेशन को अपडेट करें।

संबंधित निर्देश: निजी बॉट और आदेश.

केवल-स्वामी मूल कंप्यूटर अनुमति

मूल कंप्यूटर पहुंच अक्षम से शुरू होती है। केवल स्वामी ही इसे स्थानीय सेटिंग्स → रिमोट कंट्रोल में सक्षम कर सकता है। सहायक और HTTP/MCP/Telegram आदेश अपने लिए इस फ़्लैग को सक्षम नहीं कर सकते हैं। यदि कोई कार्रवाई अस्वीकार कर दी जाती है, तो सहायक को सेटिंग का वर्णन करना चाहिए और स्वामी को निर्णय लेने देना चाहिए।

स्पष्ट रूप से सक्षम होने पर, computer.run एक निष्पादन योग्य, तर्क सरणी और वैकल्पिक पूर्ण कार्य निर्देशिका स्वीकार करता है। यह किसी शेल इंटरपोलेशन का उपयोग नहीं करता है, इसकी 30-सेकंड की सीमा है और यह आउटपुट को 1 MiB तक सीमित करता है। प्रदान की गई अनुपलब्ध या अमान्य निर्देशिका अस्वीकार कर दी जाती है; cwd को छोड़ने पर ऐप-स्वामित्व वाली सेटिंग्स निर्देशिका का उपयोग किया जाता है, HOME का नहीं। Quit सक्रिय स्वामित्व वाले आदेशों को रद्द करता है और उनकी प्रक्रिया सफ़ाई की प्रतीक्षा करता है।

अनुप्रयोग पढ़ने/संचालित करने का दायरा और मूल पहुंच अलग-अलग निर्णय हैं। एक वर्क-ट्री किसी अप्रतिबंधित प्रदाता की फ़ाइल-सिस्टम पहुंच को सीमित नहीं करता है। यदि कार्य के बाद मूल पहुंच की आवश्यकता नहीं है तो उसे निरस्त करें, और सहायक के विवरण को प्रमाण के रूप में स्वीकार करने के बजाय आदेश प्राप्तियों का निरीक्षण करें।

संबंधित निर्देश: केवल-स्वामी नियंत्रण अनुबंध.

ब्राउज़र और दूरस्थ इंस्टेंस

स्थानीय स्वामी सर्वर को सक्षम करता है और उसका पता, पोर्ट और दायरा चुनता है: निरीक्षण के लिए पढ़ें या कार्यों के लिए संचालित करें। डिफ़ॉल्ट 127.0.0.1 पता केवल इसी कंप्यूटर पर उपलब्ध है। 0.0.0.0 नेटवर्क इंटरफ़ेस पर सुनता है; इसे सक्षम करने से पहले नेटवर्क पहुंच की समीक्षा करें।

ब्राउज़र टोकन लॉगिन के बाद उसी इंटरफ़ेस को खोलता है। सार्वजनिक लिंक या स्क्रीनशॉट में टोकन शामिल न करें। केवल HTTP ट्रैफ़िक को एन्क्रिप्ट नहीं करता है; किसी अविश्वसनीय नेटवर्क पर संरक्षित चैनल का उपयोग करें।

स्वामी URL और टोकन द्वारा अन्य इंस्टेंस को कॉन्फ़िगर करता है। बैकएंड अनुरोधों को प्रॉक्सी करता है; यह उनकी परियोजनाओं को स्थानीय मशीन पर कॉपी नहीं करता है। प्रत्येक कार्रवाई से पहले चयनित इंस्टेंस की जाँच करें।

टाइप किए गए आदेश और ईवेंट अनुप्रयोग नियंत्रण रखते हैं। पढ़ने का दायरा कार्य उत्परिवर्तन को अधिकृत नहीं करता है। मूल कंप्यूटर नियंत्रण एक अलग स्थानीय-स्वामी विकल्प है और अक्षम से शुरू होता है।

ब्राउज़र, Telegram और बाहरी-एजेंट नियंत्रण के लिए ऐप का चलते रहना आवश्यक है। प्रत्येक इंस्टेंस का अपना निजी प्रोफ़ाइल, कार्य स्थिति, टोकन और सर्वर पोर्ट होता है। स्वतंत्र इंस्टेंस के बीच समवर्ती रूप से एक ही प्रोफ़ाइल का पुन: उपयोग न करें। ब्राउज़र ईवेंट और आदेश प्रतिक्रियाएं चयनित इंस्टेंस तक सीमित हैं; UI को बदलने से फ़ाइलें स्थानांतरित नहीं होती हैं या मूल लॉगिन कॉपी नहीं होता है।

संबंधित निर्देश: HTTP और इंस्टेंस नियंत्रण.

OpenClaw, Hermes और अन्य बाहरी एजेंट

प्रमाणित अनुप्रयोग-नियंत्रण API या बंडल किए गए MCP stdio ब्रिज का उपयोग करें। सर्वर को स्थानीय रूप से सक्षम करें, पढ़ें या संचालित करें चुनें और प्रत्येक क्लाइंट को उस इंस्टेंस URL और टोकन के साथ कॉन्फ़िगर करें। स्टैंडअलोन MCP ब्रिज चलाने के लिए Node.js 22 या नए संस्करण की आवश्यकता है; Electron ऐप आपके एजेंट क्लाइंट को स्थापित नहीं करता है। ब्राउज़र URL एक स्ट्रीम करने योग्य HTTP MCP एंडपॉइंट नहीं है: इसे stdio ब्रिज में ZIAFORGE_URL के रूप में प्रदान करें।

ब्रिज ziaforge_status, ziaforge_commands, ziaforge_command और ziaforge_screenshot को उजागर करता है। स्थिति और लाइव आदेश कैटलॉग से शुरुआत करें, फिर चयनित कार्य के लिए system.context पढ़ें। टाइप किए गए आदेश स्थानीय UI के समान संशोधन, गेट, कार्य-फ़ोल्डर और सफ़ाई जांच का पालन करते हैं।

लाइव आदेश कैटलॉग में documentation.guide शामिल है, जो इसके स्रोत पथ और sourceSha256 के साथ प्रामाणिक अंग्रेज़ी सहायता है। आंतरिक अनुप्रयोग वास्तुकार को अपने उपकरणों के माध्यम से समान संदर्भ प्राप्त होता है। यह पुराने नोट्स पर भरोसा किए बिना एजेंटों को संपूर्ण उत्पाद संदर्भ प्रदान करता है; दस्तावेज़ीकरण कभी भी पहुंच प्रदान नहीं करता है या वर्तमान मानवीय निर्णय का विकल्प नहीं बनता है।

एजेंटों को एक संक्षिप्त मानवीय विचार से आवश्यकताओं, तकनीकी निर्णयों और योजना पर चर्चा करनी चाहिए। उन्हें स्पष्ट मानवीय गेट्स, चयनित मॉडल, मैनुअल/Auto नीति और आवश्यक समीक्षा को बनाए रखना होगा। उन्हें अनुमोदन का आविष्कार नहीं करना चाहिए, किसी नए ID के तहत अनिश्चित आदेशों को फिर से नहीं चलाना चाहिए, या स्वामी के इरादे के बिना Git परिवर्तनों को प्रकाशित नहीं करना चाहिए।

कई इंस्टॉलेशन के लिए कई नामित MCP सर्वर कॉन्फ़िगर करें। इंस्टेंस बदलना एक रूटिंग निर्णय है, सिंक्रनाइज़ेशन नहीं। OpenClaw और Hermes कॉन्फ़िगरेशन उदाहरण AGENT_CONTROL.md में हैं; क्लाइंट-विशिष्ट सेटअप और अनुकूलता की जांच स्थापित क्लाइंट संस्करण के लिए की जानी चाहिए।

बाहरी requestId कैश केवल ऐप चलने के दौरान अनुरोधों के एक सीमित सेट को डिडुप्लिकेट करता है। टिकाऊ संचालन अपनी स्वयं की पहचान का उपयोग करते हैं: कार्य निर्माण के लिए createRequestId, वर्कफ़्लो निर्णयों के लिए commandId, संदेशों के लिए clientMessageId और operationId Git परिवर्तनों के लिए। किसी अज्ञात पावती के बाद मूल पहचान और पेलोड को सुरक्षित रखें; जानबूझकर नया काम जारी करने से पहले सहेजी गई स्थिति पढ़ें।

संबंधित निर्देश: MCP क्लाइंट निर्देश.

स्थानीय CLI और स्वचालन सीमाएं

ziaf डिस्पैचर उसी चल रहे ऐप और सहेजे गए वर्कफ़्लो को नियंत्रित करता है। स्रोत से, npm run ziaf -- list, npm run ziaf -- status --task TASK_ID --json, npm run ziaf -- start --task TASK_ID, या npm run ziaf -- pause --task TASK_ID का उपयोग करें। एक सफल प्रारंभ पावती का अर्थ यह नहीं है कि कार्य पूरा हो गया है।

--until-success जानबूझकर सहेजे गए वर्कफ़्लो के लिए Auto को सक्षम करता है, लेकिन प्रश्न, समीक्षा, स्वीकृति गेट, सीमाएं और चेकपॉइंट अभी भी लागू होते हैं। Ctrl+C अवलोकन करने वाले डिस्पैचर से बाहर निकलता है; यह अनुप्रयोग वर्कफ़्लो को अंतर्निहित रूप से नहीं रोकता है। निकास कोड, स्थानीय एंडपॉइंट और प्रोफ़ाइल प्रबंधन के लिए CLI.md देखें।

ऑटोमेशन इंटरफ़ेस वर्तमान में प्रदर्शन परिभाषाओं और स्थानीय रन काउंटरों को संग्रहीत करता है। यह एक प्रमाणित आवर्ती शेड्यूलर नहीं है और यह साबित नहीं करता है कि पृष्ठभूमि मॉडल की बारी चली थी। वास्तविक निष्पादन के लिए सहेजे गए वर्कफ़्लो नियंत्रण, ziaf या प्रमाणित API का उपयोग करें और उनकी रसीदों का निरीक्षण करें। प्रदर्शन पैनल को अप्राप्य शेड्यूलिंग समझने की भूल न करें।

संबंधित निर्देश: डिस्पैचर आदेश.

संस्करण और अद्यतन

About सटीक चल रहा संस्करण दिखाता है। सार्वजनिक अपडेट के लिए एक विश्वसनीय GitHub रिलीज़ रिपॉजिटरी और एक स्थिर या पूर्वावलोकन चैनल की आवश्यकता होती है। जांचने, डाउनलोड करने और स्थापित करने की अलग-अलग स्थितियां होती हैं; किसी त्रुटि का अर्थ यह नहीं है कि कोई अद्यतन स्थापित हो गया।

स्वचालित स्थापना हस्ताक्षरित macOS रिलीज़ के लिए है। अहस्ताक्षरित विकास बिल्ड इस तंत्र के माध्यम से स्वचालित रूप से स्थापित नहीं होते हैं। मैन्युअल प्रतिस्थापन के लिए, वर्तमान ऐप को पूरी तरह से छोड़ दें और एक सत्यापित आर्टिफैक्ट का उपयोग करें।

सक्षम होने पर स्वचालित जाँच तुरंत चलती है, फिर हर छह घंटे में चलती है।

स्थिर पूर्वावलोकन रिलीज़ को बाहर करता है; पूर्वावलोकन विकास रिलीज़ की भी अनुमति देता है। एक सफल जांच केवल उपलब्ध रिलीज़ मेटाडेटा स्थापित करती है। डाउनलोड और स्थापना के लिए प्लेटफ़ॉर्म पैकेज और कॉन्फ़िगर की गई रिलीज़ फ़ीड की आवश्यकता होती है। Linux DEB डिलीवरी एक अलग इंस्टॉलर पथ है; यह न मानें कि एक DEB स्वचालित रूप से macOS अपडेट तंत्र द्वारा अपग्रेड हो जाता है।

संबंधित निर्देश: रिलीज़ तत्परता.

पुनरारंभ और पुनर्प्राप्ति

macOS पर, पूर्ण शटडाउन के लिए Quit / ⌘Q का उपयोग करें। विंडो बंद करने से ऐप चालू रह सकता है। अनुप्रयोग को बदलने से पहले पुराने संस्करण को पूरी तरह से छोड़ दें।

लॉन्च के बाद, वही कार्य चुनें। इतिहास और ड्राफ़्ट वापस आ जाते हैं। Resume एक मूल/स्थानीय संदर्भ को पुनर्स्थापित करता है लेकिन कोई ड्राफ़्ट नहीं भेजता है, कतार को अनपॉज़ नहीं करता है या किसी अज्ञात ऑपरेशन को दोहराने को अधिकृत नहीं करता है।

यदि पुनर्प्राप्ति प्रकट होती है, तो हाथ से JSON को संपादित न करें। प्रभावित दस्तावेज़ प्रकार का निरीक्षण करें, मूल फ़ाइलों को सुरक्षित रखें और एक मान्य बैकअप का चयन करें। पुरानी कतार को पुनर्स्थापित करने से उसके आइटम अनिश्चित चिह्नित हो जाते हैं।

जब वितरण अज्ञात हो, तो प्रबंधित वर्कफ़्लो को नए संदर्भ के लिए स्पष्ट अनुमति की आवश्यकता हो सकती है। पहले का काम और असफल प्रयास बने रहते हैं; मनगढ़ंत सफलता की तुलना में दृश्यमान इनकार अधिक सुरक्षित है।

सभी ऐप इंस्टेंस बंद होने पर कार्य फ़ाइलों और ऐप प्रोफ़ाइल का बैकअप लें। एक कॉपी किया गया फ़ोल्डर परीक्षण किया गया पुनर्स्थापन नहीं है। यदि पुनर्प्राप्ति आपको मान्य बैकअप का चयन करने के लिए कहती है, तो सटीक क्षतिग्रस्त फ़ाइलों को भी बनाए रखें। पुराने वर्कफ़्लो या कतार को पुनर्स्थापित करना अनिश्चित अनुमान या Git संचालन को फिर से चलाने के लिए अधिकृत नहीं करता है।

संबंधित निर्देश: पुनर्प्राप्ति अनुबंध.

समस्या निवारण

CLI नहीं मिला: एक सामान्य टर्मिनल में इसके इंस्टॉलेशन और संस्करण की जांच करें, फिर ZIAForge को पुनरारंभ करें। निष्पादन योग्य फ़ाइल मौजूद होने का अर्थ यह नहीं है कि आपने साइन इन किया हुआ है। प्रदाता के स्वयं के साइन-इन तंत्र का उपयोग करें।

मॉडल अनुपलब्ध या प्राधिकरण विफल: खोज को रीफ़्रेश करें, उपलब्ध ID का चयन करें और अपने खाते और सीमाओं की जाँच करें। किसी अनिश्चित अनुरोध के इतिहास का निरीक्षण करने से पहले उसे न दोहराएं।

वर्कफ़्लो रुक गया: वर्तमान चरण, प्रश्न, सत्यापन रसीद या CLI लॉग खोलें। विशिष्ट कारण का समाधान करें: अनुत्तरित प्रश्न, आदेश, फ़ोल्डर अनुमति या प्रयास सीमा। Continue किसी विफल जांच को सफलता में नहीं बदल सकता।

फ़ोल्डर गुम या बदल दिया गया: मूल फ़ोल्डर तक पहुंच पुनर्स्थापित करें या एक नया कार्य बनाएं। ऐप को HOME से जारी नहीं रहना चाहिए। यदि आप कोई अन्य cwd देखते हैं, तो बारी रोकें और निदान को सुरक्षित रखें।

एक रिपोर्ट के लिए, About संस्करण, मार्ग, CLI/मॉडल, अपेक्षित और वास्तविक व्यवहार, एक स्क्रीनशॉट और एक सुरक्षित लॉग अंश शामिल करें। उन रहस्यों, व्यक्तिगत सामग्री और पथों को हटा दें जिन्हें प्रकाशित नहीं किया जा सकता।

दूरस्थ पृष्ठ अनुपलब्ध: सत्यापित करें कि स्वामी ने सर्वर सक्षम किया है, सुनने वाले पते और पोर्ट की जांच करें, फिर सही इंस्टेंस टोकन के साथ प्रमाणित करें। 401 प्रमाणीकरण को इंगित करता है; अस्वीकृत उत्परिवर्तन पढ़ने का दायरा या केवल-स्वामी नियंत्रण हो सकता है। टोकन बदलने से मौजूदा ब्राउज़र क्लाइंट बंद हो जाते हैं। अलग DevTools निरीक्षण पोर्ट को दूरस्थ अनुप्रयोग नियंत्रण के रूप में उजागर न करें।

संपादक सहेजना अस्वीकृत: ड्राफ़्ट रखें, डिस्क पर वर्तमान फ़ाइल का निरीक्षण करें और बाहरी-परिवर्तन विरोध को हल करें। अनुप्रयोग मेटाडेटा को दोबारा लिखकर तुलना को बायपास न करें। यदि बड़ी फ़ाइल पूरी तरह लोड करने की सुविधा अनुपलब्ध है, तो समर्थित विंडो संपादन/खोज या किसी बाहरी संपादक का उपयोग करें।

Telegram अनुपलब्ध: बॉट टोकन, संख्यात्मक स्वामी, निजी चैट और स्थिति की स्थानीय रूप से पुष्टि करें। एक प्रतिस्पर्धी वेबहुक या पोलर पोलिंग को अवरुद्ध कर सकता है; ZIAForge स्वचालित रूप से किसी वेबहुक को नहीं हटाता है या किसी अन्य पोलर को अपने नियंत्रण में नहीं लेता है। अज्ञात सीमा पर अस्वीकृत या बाधित आदेश स्वचालित रूप से दोबारा नहीं चलाए जाते हैं।

संबंधित निर्देश: परीक्षण और निदान.

समस्याओं की रिपोर्ट करें और साक्ष्यों का निरीक्षण करें

About से सटीक चल रहे बिल्ड, OS/आर्किटेक्चर, कार्य मोड, चयनित प्रदाता/मॉडल और समस्या को पुनः उत्पन्न करने वाले चरणों को रिकॉर्ड करें। अपेक्षित परिणाम और देखे गए परिणाम का वर्णन करें। संपूर्ण निजी प्रोफ़ाइल के बजाय एक सुरक्षित स्क्रीनशॉट और प्रासंगिक बनाए रखा गया आदेश या सत्यापन रसीद शामिल करें।

CLI लॉग, ईवेंट जर्नल, मॉडल प्रतिलेख, ब्राउज़र ट्रेस और स्क्रीनशॉट स्रोत, व्यक्तिगत पथ या टोकन उजागर कर सकते हैं। साझा करने से पहले निरीक्षण करें और संपादित करें। सर्वोत्तम-प्रयास लॉग संपादक किसी स्क्रीनशॉट या संग्रह को प्रकाशित करने योग्य प्रमाणित नहीं करता है।

योगदानकर्ताओं के लिए, qa:doctor परिवेश/बिल्ड पहचान पढ़ता है; qa:inspect प्रदाता स्टब्स के साथ एक पृथक प्रोफ़ाइल खोलता है। एक फ़िक्सचर मॉडल से संपर्क किए बिना परीक्षण किए गए अनुप्रयोग पथ को साबित करता है। लाइव अनुमान, Telegram कनेक्टिविटी, मूल Linux डेस्कटॉप, साइनिंग और पैकेज्ड आर्टिफैक्ट जांच अलग-अलग साक्ष्य हैं। पुनरुत्पादक आदेशों और सफ़ाई के लिए TESTING.md देखें।

संबंधित निर्देश: साक्ष्य आदेश.

स्थानीय डेटा और सीमाएं

परियोजनाओं, इतिहास, योजनाओं, दस्तावेजों और निदानों में निजी पाठ हो सकता है। स्रोत कोड के साथ प्रोफ़ाइल, कच्चा कैप्चर, कुंजी या संपूर्ण लॉग प्रकाशित न करें।

Linux पर, API, नियंत्रण, Telegram और इंस्टेंस क्रेडेंशियल को सहेजने के लिए एक अनलॉक GNOME सीक्रेट सर्विस या KWallet की आवश्यकता होती है; समर्थित सीक्रेट स्टोर के बिना, ZIAForge Electron के basic_text फ़ॉलबैक का उपयोग करने के बजाय इन रहस्यों को सहेजने से इंकार कर देता है।

स्थानीय संग्रहण का अर्थ यह नहीं है कि अनुरोध आपके कंप्यूटर पर ही रहें: चयनित CLI/API उन्हें अपने प्रदाता को भेजता है। एक कार्यशील फ़ोल्डर और प्रक्रिया पर्यवेक्षण OS अलगाव नहीं हैं। चयनित अनुमतियों का निरीक्षण करें।

साक्ष्य प्रकारों में अंतर करें: फ़िक्सचर बिना मॉडल के अनुप्रयोग का परीक्षण करते हैं; मूल लाइव एक वास्तविक CLI/खाते का उपयोग करता है; पैकेज्ड जांच एक विशिष्ट आर्टिफैक्ट को प्रमाणित करती है। एक को पास करने से दूसरों की गारंटी नहीं मिलती।

अनुप्रयोग का दायरा, एक वर्क-ट्री और केवल-पढ़ने योग्य प्रॉम्प्ट ऑपरेटिंग-सिस्टम प्रवर्तन से भिन्न हैं। Antigravity समीक्षक/सहायक नीतियां फ़ाइल-सिस्टम केवल-पढ़ने योग्य पहुंच लागू करने के बजाय एकत्रित कार्यस्थान साक्ष्य में परिवर्तनों का पता लगाती हैं। मूल कंप्यूटर नियंत्रण सामान्य ऐप-टूल सीमा के बाहर स्वामी-अधिकृत प्रोग्राम निष्पादित करता है; जब इसकी आवश्यकता न हो तो इसे बंद कर दें।

संबंधित निर्देश: उत्पत्ति और प्रकाशन.

इस ओपन-सोर्स प्रोजेक्ट को समझें और बदलें

पहले AGENTS.md और CONTRIBUTING.md पढ़ें, फिर वर्तमान स्रोत सीमाओं के लिए PROJECT_MAP.md पढ़ें। कार्यान्वित टाइप किए गए अनुबंध और वर्तमान वर्कफ़्लो/प्रदाता दस्तावेज़ व्यवहार को नियंत्रित करते हैं। CONCEPT.md और ARCHITECTURE.md के टर्मिनल-फ़र्स्ट भाग ऐतिहासिक इरादे को संरक्षित करते हैं और उन्हें वर्तमान रिलीज़ दावों के लिए भ्रमित नहीं किया जाना चाहिए।

अंग्रेज़ी सहायता स्रोत docs/help/en.json है। जनरेट किए गए USER_GUIDE.md या website/guide.html को हाथ से संपादित न करें। प्रामाणिक अनुभाग बदलें, प्रभावित अनुबंध को अपडेट करें और node scripts/help/generate.cjs चलाएं। इन-ऐप सहायता उसी स्रोत को पढ़ती है। सीमाओं, अनुमतियों और असमर्थित पथों सहित वास्तविक कार्यान्वयन के साथ परिवर्धन की समीक्षा करें।

प्रत्येक 56 इंटरफ़ेस लोकेल की docs/help/locales.json में अलग सहायता स्थिति है। अनुपलब्ध या अपूर्ण सहायता वापस अंग्रेज़ी में आ जाती है। पूर्ण मशीन-अनुवादित पाठों को मानव समीक्षा के दावे के बिना, लेबल किया जाता है और अंग्रेज़ी स्रोत हैश से बांधा जाता है। मानव-समीक्षित अनुवाद अतिरिक्त रूप से अपने समीक्षक को रिकॉर्ड करता है। प्रत्येक अनुवाद में अनुभाग आईडी, क्रियाएं, फ़ाइल/आदेश पहचानकर्ता और तकनीकी सीमाएं सुरक्षित रहनी चाहिए, सही दिशा का उपयोग करना चाहिए, और जब इसका अंग्रेज़ी स्रोत बदलता है तो इसे ताज़ा किया जाना चाहिए।

शिपिंग से पहले, पुराने जनरेट किए गए आउटपुट, अमान्य लोकेल स्कैफ़ोल्ड्स या टूटे हुए स्थानीय अनुबंध लिंक का पता लगाने के लिए node scripts/help/generate.cjs --check चलाएं। UI अनुवाद जांच और अनुप्रयोग व्यवहार जांच अलग-अलग रहती हैं। HELP_MAINTENANCE.md योगदानकर्ता और AI अद्यतन प्रक्रिया देता है; दस्तावेज़ीकरण को ऐसे उत्तीर्ण परीक्षण का दावा नहीं करना चाहिए जो चला ही न हो।

संबंधित निर्देश: वर्तमान परियोजना मानचित्र · दस्तावेज़ीकरण रखरखाव · योगदानकर्ता निर्देश · एजेंट निर्देश.