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 Silicon मा arm64 प्याकेज र Intel को लागि x64 प्याकेज प्रयोग गर्नुहोस्। प्रतिस्थापन गर्नु अघि पुरानो अनुप्रयोग पूर्ण रूपमा बन्द गर्नुहोस्। पूर्वावलोकन प्याकेजहरू हस्ताक्षर नगरिएका र नोटराइज नगरिएका हुन सक्छन्; विकास कलाकृतिलाई हस्ताक्षर गरिएको सार्वजनिक विमोचन ठानेर झुक्किनु हुँदैन।

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

Linux लाई उपयुक्त ग्राफिकल डेस्कटप, Electron द्वारा आवश्यक प्रणाली पुस्तकालयहरू, र Git चाहिन्छ। इन्क्रिप्टेड नियन्त्रण प्रमाणपत्रहरूका लागि, gnome-libsecret वा KWallet जस्ता कार्यशील Secret Service प्रदान गर्नुहोस्; असुरक्षित 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 मा, भूमिकाको लेबल महत्त्वपूर्ण हुन्छ: तयारीले छुट्टै योजनाकार प्रयोग गर्न सक्छ। फुटरले प्रदर्शित भूमिका परिवर्तन गर्छ; समीक्षक र सहयोगीहरू कार्यप्रवाह सेटिङहरूमा चयन गरिन्छन्। पहिले नै प्रमाणित कार्यान्वयनको लागि नीति बन्द हुन सक्छ।

अनुमतिहरू प्रदायकहरू बीच फरक हुन्छन्। जहाँ एडाप्टरले समर्थन गर्छ त्यहाँ पढ्न मात्र र कार्यस्थान लेखन उपलब्ध छन्। Antigravity ले नेटिभ CLI सेटिङहरू वा स्पष्ट रूपमा चयन गरिएको पूर्ण पहुँच प्रयोग गर्दछ। पूर्ण पहुँच स्यान्डबक्स होइन।

विशेषज्ञताले प्रम्प्ट निर्देशन थप्छ, अर्को मोडेल वा अनुमति होइन। प्रिसेट र भूमिकाहरूले कुनै पनि होइन, मानक, Auto र म्यानुअल समर्थन गर्छन्। Auto ले अतिरिक्त मोडेल कल बिना चरण पाठबाट प्रोफाइलहरू चयन गर्दछ; म्यानुअल ले चारवटा सम्म विशेषताहरू र आफूखुसी निर्देशनहरू स्वीकार गर्दछ। योजनाकार-प्रस्तावित असाइनमेन्टहरू योजना स्वीकार गर्नु अघि सम्पादन गर्न सकिन्छ।

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

सम्बन्धित निर्देशनहरू: प्रदायक क्षमताहरू.

कुराकानीहरू, रोक्नुहोस् र लाम

खुला ट्याबहरू, हालैका र मस्यौदाहरू एउटै कार्यअन्तर्गत पर्दछन्। कुनै ट्याब बन्द गर्नाले त्यो खुला सूचीबाट हट्छ तर हालैका मा सुरक्षित रहन्छ र यसले यसको प्रदायक प्रक्रिया वा व्यवस्थित कार्यप्रवाह रोक्दैन। इतिहास खोजी गर्नुहोस्, कुराकानी पुन: खोल्नुहोस् वा इतिहास मेनुबाट सबै अतिरिक्त ट्याबहरू बन्द गर्नुहोस्।

रोक्नुहोस् ले हालको मोडलाई अवरोध गर्दछ। अर्को पठाउनुहोस् अघि रोकिने कार्य समाप्त हुन पर्खनुहोस्: अवरोधको स्वीकृति प्रक्रिया पूरा भएको होइन। यसैबीच तपाईं अर्को मस्यौदा टाइप गर्न सक्नुहुन्छ।

साधारण कुराकानीमा, लाम ले पछिल्लो अनुरोधलाई हालको मस्यौदाबाट छुट्टै सुरक्षित गर्दछ। लाम पज गर्नुहोस् ले थप वितरणलाई रोक्छ। रोक्नुहोस् र बन्द गर्नुहोस् ले लामलाई पज गर्दछ। पुन: सुरु गरेपछि, पहिले पुन: सुरु गर्नुहोस्, त्यसपछि स्पष्ट रूपमा लाम जारी राख्नुहोस्।

अनिश्चित को अर्थ वितरण अज्ञात छ भन्ने हो। यस्तो सन्देश स्वचालित रूपमा पुन: पठाइँदैन: इतिहास निरीक्षण गर्नुहोस्, उपयुक्त भए पाठ प्रतिलिपि गर्नुहोस् र लामबद्ध वस्तु खारेज गर्नुहोस्। यसलाई फेरि पठाउनु नयाँ सोचविचार गरिएको अनुरोध हो।

व्यवस्थित चरणका कुराकानीहरूले साधारण लामको सट्टा आफ्नो कार्यप्रवाह प्रयोग गर्छन्। चरण पछ्याउनुहोस् ले हालको चरण देखाउँछ; म्यानुअल रूपमा अर्को ट्याब चयन गर्दा पछ्याउन रोकिन्छ। CLI लगहरूले प्रतिक्रियाभन्दा छुट्टै निदानहरू देखाउँछन्।

मार्कडाउन प्रतिक्रियाहरूले शीर्षक, सूची, तालिका, लिङ्क र कोड ब्लकहरू रेन्डर गर्छन्। उपकरण कार्ड र CLI निदानहरू जवाफबाट छुट्टै रहन्छन्। प्रदायकले वास्तवमै देखाएको अवस्थामा मात्र मोडेल-रिपोर्ट गरिएको सोच र टोकन मेट्रिक्स देखिन्छन्; एनिमेसनबाट भित्री तर्क वा उपयोगको अनुमान नगर्नुहोस्।

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

सम्बन्धित निर्देशनहरू: टिकाउ सन्देश लाम.

फाइलहरू, Git र पूर्णता

फाइलहरू ले कार्य फोल्डर देखाउँछ। आवश्यकताहरूसँग परिणामहरू तुलना गर्नुहोस्, कागजातहरू खोल्नुहोस् र भिन्नताहरू निरीक्षण गर्नुहोस्। बाइनरी फाइल सुरक्षित राख्नुले यसको लक्षित अनुप्रयोगमा सही रेन्डरिङ प्रमाणित गर्दैन।

Git ले स्थिति, परिवर्तनहरू र रेकर्ड गरिएका परिणामहरू सहितका सञ्चालनहरू प्रदान गर्दछ। कमिट, मर्ज र पुश पूर्वनिर्धारित रूपमा म्यानुअल हुन्छन्; स्वचालित सञ्चालनहरू पूर्ण रूपमा प्रमाणित योजनाका लागि छुट्टै विकल्पहरू हुन्।

प्रमाणीकरण र प्रकाशनको बीचमा कार्य फाइलहरू परिवर्तन नगर्नुहोस्: स्वीकृति सही बाइटहरूसँग जोडिएको हुन्छ। द्वन्द्व, असफल पुश र अज्ञात सञ्चालन परिणामहरूले स्पष्ट निर्णय नभएसम्म प्रगति रोक्छन्। Auto ले मौन रूपमा प्रकाशनलाई अधिकार दिँदैन।

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

फाइल सम्पादकले एक्सटेन्सन अनुसार वाक्यविन्यास, खोजी र प्रतिस्थापन, पूर्ववत इतिहास, लाइन र्यापिङ र प्रति-ट्याब मस्यौदा प्रदान गर्दछ। बचतले समर्थित UTF-8/UTF-16 इन्कोडिङ सुरक्षित गर्छ र बाह्य परिमार्जन द्वन्द्वहरूलाई अस्वीकार गर्छ। अन्य इन्कोडिङ र बाइनरी सामग्रीका लागि बाह्य सम्पादक चाहिन्छ। सुरक्षित नगरिएका मस्यौदाहरूले मालिकले बचत वा खारेज नगरेसम्म अनुप्रयोग बन्द गर्नबाट रोक्छन्।

पूर्ण वाक्यविन्यास 8 MiB सम्म सक्षम पारिएको छ। ठूला पाठ फाइलहरू 256 KiB विन्डोहरूमा खुल्छन्; 8–64 MiB वाक्यविन्यास बिना स्पष्ट रूपमा पूर्ण लोड गर्न सकिन्छ। 64 MiB भन्दा माथि विन्डो सम्पादन र सीमित अर्को-मिल्दो खोजी प्रयोग गर्नुहोस्। यो एक सीमित ठूलो-फाइल मोड हो, स्वेच्छाचारी ठूला कागजातहरूको लागि Sublime Text समानता होइन।

फोल्डर खोल्नुहोस् ले केवल मूल भण्डारलाई मौन रूपमा खोल्नुको सट्टा हालको कार्य वा शाखा/वर्कट्री सन्दर्भ प्रयोग गर्दछ। फाइल पङ्क्तिले त्यो फाइलको मूल डाइरेक्टरी देखाउन सक्छ। दर्ता गरिएका कार्य अनुदानहरू विरुद्ध ब्याकइन्डद्वारा मार्गहरू प्रमाणित हुन्छन्। बाइनरी फाइलहरू सादा पाठको रूपमा सम्पादन योग्य छैनन्; तिनीहरूको लक्षित दर्शक प्रयोग गर्नुहोस् र मूल बाइटहरू सुरक्षित राख्नुहोस्।

वर्कट्री हटाउनु एक छुट्टै सुरक्षित कार्य हो। यसलाई हटाउनु अघि संलग्न संरचित सत्रहरू र टर्मिनलहरू समाप्त गर्नुहोस्, जसमा निष्क्रिय सत्रहरू पनि समावेश छन्। सुरक्षित गरिएको Git परिणाम र पुन: प्राप्ति स्थिति निरीक्षण गर्नुहोस्; कार्य रेकर्ड मेटाउनु कमिट नगरिएका कामहरू सुरक्षित रूपमा राख्ने विकल्प होइन।

सम्बन्धित निर्देशनहरू: टाइप गरिएको सम्पादक सम्झौता · Git नीतिहरू.

API जडानहरू

जडानहरूले स्पष्ट रूपमा चयन गरिएको OpenAI-मिल्दो अन्तिम बिन्दु थप्छ। एउटा नाम, आधार URL, मोडेल र आवश्यक परेमा कुञ्जी प्रविष्ट गर्नुहोस्। धेरै सर्भरहरूलाई /v1 मा समाप्त हुने आधार URL चाहिन्छ; आफ्नो अन्तिम बिन्दुको कागजात हेर्नुहोस्।

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

API कलहरूले CLI सदस्यता प्रयोग गर्दैनन्। उपकरण र मोडेलहरू नेटिभ सत्रहरू भन्दा फरक हुन्छन्, र सफल मोडेल खोजीले निष्कर्ष प्रमाणित गर्दैन। प्रदायकले वास्तवमा फिर्ता पठाउँदा मात्र टोकन उपयोग देखिन्छ।

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

सम्बन्धित निर्देशनहरू: API जडानहरू.

सेटिङहरू, भाषाहरू र सुरक्षित रिसेट

सामान्य सेटिङहरूले कार्यक्षेत्र, इन्टरफेस भाषा र पूर्वनिर्धारितहरू चयन गर्दछ। जडानहरू ले API अन्तिम बिन्दुहरू व्यवस्थापन गर्छ। प्रिसेटहरू र समीक्षा टोलीहरू ले भूमिका कन्फिगरेसनहरू कायम राख्छन्। रिमोट कन्ट्रोलले स्थानीय प्रमाणपत्र, सर्भर दायरा र मालिक अनुमतिहरू व्यवस्थापन गर्दछ; अपडेटहरू ले विमोचन स्रोत/च्यानल व्यवस्थापन गर्छ। बारेमा ले ठ्याक्कै चलिरहेको बिल्ड देखाउँछ।

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

Save ले प्रदर्शित कन्फिगरेसन लागू गर्दछ। डाटाबेस रिसेट वा फ्याक्ट्री रिसेटले अनुप्रयोग मेटाडेटा हटाउन सक्छ; जानाजानी रिसेट प्रयोग गर्नुअघि फाइलहरू र परीक्षण गरिएको ब्याकअप सुरक्षित गर्नुहोस्। यी सञ्चालनहरू स्थानीय-मालिक कार्यहरू हुन्। असफल कार्यप्रवाह वा भ्रष्ट रेकर्ड अनुसन्धान गर्न सर्टकटको रूपमा तिनीहरूलाई प्रयोग नगर्नुहोस्।

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

Help सहायकलाई सोध्नुहोस्

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

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

Claude Code र API Help सत्रहरूले समर्थित कुनै-उपकरण-नभएको (no-tools) नीति लागू गर्छन्। नेटिभ Codex र Antigravity Help सत्रहरूका लागि अवस्थित स्थानीय-मालिक नेटिभ कम्प्युटर अनुमति आवश्यक पर्दछ। यदि यो असक्षम छ भने, एपले फरक प्रदायक छनोट गर्नुको सट्टा पूर्वशर्तको व्याख्या गर्दछ। स्थानीय नियन्त्रण सेटिङहरूमा मालिकले मात्र यसलाई सक्षम पार्न सक्छ; सहायकले यसलाई आफैं सक्षम पार्न सक्दैन।

Codex Help ले केवल-पढ्ने (read-only) स्यान्डबक्स प्रयोग गर्दछ र उपकरण-स्वीकृति अनुरोधहरू अस्वीकार गर्दछ। Antigravity ले plan मोड र यसको नेटिभ स्यान्डबक्स फ्ल्याग प्रयोग गर्दछ। यी नेटिभ मोडहरू अपरेटिङ-सिस्टम रोकथामको विश्वव्यापी ग्यारेन्टी होइनन्। स्रोत-गाइड ह्यासले उत्तरका लागि प्रयोग गरिएको सन्दर्भ पहिचान गर्दछ; उत्पन्न गरिएको व्याख्या अझै पनि गलत हुन सक्छ, त्यसैले कदम चाल्नु अघि यसको लिङ्क गरिएका खण्डहरू निरीक्षण गर्नुहोस्। पुराना उत्तरहरूको स्रोत-गाइड संस्करण हालको गाइडभन्दा फरक हुँदा तिनीहरूलाई चिन्ह लगाइन्छ।

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

सहायक र Telegram

सहायकले चयन गरिएको प्रिसेट र उही अनुप्रयोग नियन्त्रण API प्रयोग गर्छ। स्थिति निरीक्षण गर्ने अनुमति र सञ्चालनहरू गर्ने अनुमति छुट्टाछुट्टै हुन्छन्। आदेश र परिणामहरू निरीक्षण गर्नुहोस्: कुनै कार्य पूरा भएको प्रमाण सहायकको पाठ मात्र हुन सक्दैन।

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

बट टोकनलाई सामान्य च्याटमा पेस्ट नगर्नुहोस्। एकीकरण कन्फिगर गर्दैमा Telegram जडान प्रमाणित हुँदैन र स्वचालित रूपमा बट सिर्जना पनि हुँदैन। स्क्रिनसट र प्रतिक्रियाहरूमा निजी कार्यस्थान (workspace) डेटा हुन सक्छ।

सहायक प्रिसेट चयन गर्नुहोस् र निरीक्षणभन्दा छुट्टै अनुप्रयोग-सञ्चालन अनुमति प्रदान गर्नुहोस्। Codex र Antigravity सहायक कार्यान्वयनका लागि मालिकको नेटिभ अनुमति आवश्यक पर्छ; तिनीहरू उपकरण-रहित API वा Claude सत्रसँग मौन रूपमा प्रतिस्थापन हुँदैनन्। स्क्रिनसटहरू सहायक कुराकानीमा देखाउन सकिन्छ, तर हालको मोडेल इनपुटमा छवि विश्लेषण समावेश छैन। सहायकले केवल प्रदर्शन गरेकै भरमा छवि दृश्यात्मक रूपमा निरीक्षण गर्‍यो भनी नसम्झनुहोस्।

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

सम्बन्धित निर्देशनहरू: अनुप्रयोग नियन्त्रण सम्झौता.

तपाईंको निजी Telegram बट सञ्चालन गर्नुहोस्

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

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

खुला/हालका कुराकानीहरू र कार्यप्रवाह चरण च्याटहरू पूर्वावलोकन गर्न कार्यको Chats खोल्नुहोस्। प्रत्येक पूर्वावलोकनले छ वटा सम्म नवीनतम प्रयोगकर्ता/सहायक सन्देशहरू देखाउँछ, जुन दृश्यात्मक रूपमा प्रत्येक 200 क्यारेक्टरमा छोट्याइएका हुन्छन्। निजी तर्क (reasoning) देखाइँदैन। इतिहास पढ्दा प्रदायक सुरु हुँदैन। पूर्वावलोकनहरू केवल-पढ्ने हुन्: सामान्य पाठ र /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} ले स्पष्ट क्याटलग आदेश पठाउँछ। तर्क आकारहरूका लागि प्रत्यक्ष क्याटलग पढ्नुहोस्। अनुप्रयोगमा जस्तै समान ब्याकइन्ड प्रमाणीकरण र फोल्डर अनुदानहरू लागू हुन्छन्।

एपले भण्डारण गरिएका बट-टोकन मानहरू सहायकलाई कहिल्यै पठाउँदैन। स्क्रिनसट, सारांश र कुराकानी पाठमा अझै पनि निजी परियोजना जानकारी हुन सक्छ। यदि बट वा मालिक खाता अब विश्वसनीय छैन भने स्थानीय रूपमा एकीकरण बन्द गर्नुहोस्। बट प्रदायकसँग लिक भएको टोकन घुमाउनुहोस् (rotate गर्नुहोस्), त्यसपछि यसको स्थानीय इन्क्रिप्टेड कन्फिगरेसन अद्यावधिक गर्नुहोस्।

सम्बन्धित निर्देशनहरू: निजी बट र आदेशहरू.

मालिक-मात्र नेटिभ कम्प्युटर अनुमति

नेटिभ कम्प्युटर पहुँच असक्षम अवस्थाबाट सुरु हुन्छ। मालिकले मात्र यसलाई स्थानीय Settings → Remote control मा सक्षम पार्न सक्छ। सहायक र HTTP/MCP/Telegram आदेशहरूले आफ्ना लागि यो फ्ल्याग सक्षम पार्न सक्दैनन्। यदि कुनै सञ्चालन अस्वीकार गरियो भने, सहायकले सेटिङको वर्णन गर्नुपर्छ र मालिकलाई निर्णय गर्न दिनुपर्छ।

स्पष्ट रूपमा सक्षम पारिएपछि, computer.run ले कार्यान्वयनयोग्य (executable), तर्क एरे र वैकल्पिक निरपेक्ष कार्य डाइरेक्टरी स्वीकार गर्छ। यसले कुनै शेल इन्टरपोलेसन प्रयोग गर्दैन, यसको 30-सेकेन्डको सीमा हुन्छ र आउटपुटलाई 1 MiB मा सीमित गर्दछ। आपूर्ति गरिएको हराएको वा अमान्य डाइरेक्टरी अस्वीकार गरिन्छ; cwd नराख्दा एपको स्वामित्वमा रहेको सेटिङ डाइरेक्टरी प्रयोग हुन्छ, HOME होइन। Quit ले स्वामित्वमा रहेका सक्रिय आदेशहरू रद्द गर्दछ र तिनीहरूको प्रक्रिया सरसफाइको प्रतीक्षा गर्दछ।

अनुप्रयोग पढ्ने/सञ्चालन गर्ने दायरा र नेटिभ पहुँच छुट्टाछुट्टै निर्णयहरू हुन्। एउटा वर्कस्ट्रीले प्रतिबन्धविहीन प्रदायकको फाइलप्रणाली पहुँचलाई रोक्दैन। कार्य सकिएपछि यदि नेटिभ पहुँच आवश्यक छैन भने यसलाई रद्द गर्नुहोस्, र सहायकको पाठलाई प्रमाणको रूपमा स्वीकार गर्नुको सट्टा आदेश रसिदहरू निरीक्षण गर्नुहोस्।

सम्बन्धित निर्देशनहरू: मालिक-मात्र नियन्त्रण सम्झौता.

ब्राउजर र टाढाका इन्स्टन्सहरू

स्थानीय मालिकले सर्भर सक्षम गर्दछ र यसको ठेगाना, पोर्ट र दायरा छनोट गर्दछ: निरीक्षणका लागि read वा कार्यहरूका लागि operate। पूर्वनिर्धारित 127.0.0.1 ठेगाना यो कम्प्युटरमा मात्र उपलब्ध छ। 0.0.0.0 ले नेटवर्क इन्टरफेसहरूमा सुन्छ; यसलाई सक्षम गर्नुअघि नेटवर्क पहुँचको समीक्षा गर्नुहोस्।

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

मालिकले URL र टोकनद्वारा अन्य इन्स्टन्सहरू कन्फिगर गर्दछ। ब्याकइन्डले अनुरोधहरू प्रोक्सी गर्छ; यसले तिनीहरूका परियोजनाहरूलाई स्थानीय मेसिनमा प्रतिलिपि गर्दैन। प्रत्येक कार्य अघि चयन गरिएको इन्स्टन्स जाँच गर्नुहोस्।

टाइप गरिएका आदेश र घटनाहरूले अनुप्रयोग नियन्त्रण बोक्छन्। Read दायराले कार्य उत्परिवर्तनहरू (mutations) लाई अधिकृत गर्दैन। नेटिभ कम्प्युटर नियन्त्रण एक छुट्टै स्थानीय-मालिक छनौट हो र यो असक्षमबाट सुरु हुन्छ।

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

सम्बन्धित निर्देशनहरू: HTTP र इन्स्टन्स नियन्त्रण.

OpenClaw, Hermes र अन्य बाह्य एजेन्टहरू

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

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

प्रत्यक्ष आदेश क्याटलगमा यसको स्रोत मार्ग र sourceSha256 सहितको प्रामाणिक अङ्ग्रेजी मद्दत, documentation.guide, समावेश छ। आन्तरिक अनुप्रयोग वास्तुकारले आफ्ना उपकरणहरू मार्फत उही सन्दर्भ प्राप्त गर्दछ। यसले एजेन्टहरूलाई पुराना नोटहरूमा भर नपरी सम्पूर्ण उत्पादन सन्दर्भ दिन्छ; कागजातले कहिल्यै पहुँच प्रदान गर्दैन वा हालको मानवीय निर्णयको विकल्प बन्दैन।

एजेन्टहरूले संक्षिप्त मानवीय विचारबाट आवश्यकताहरू, प्राविधिक निर्णयहरू र योजनाबारे छलफल गर्नुपर्छ। तिनीहरूले स्पष्ट मानवीय गेटहरू, चयन गरिएका मोडेलहरू, म्यानुअल/Auto नीति र आवश्यक समीक्षा सुरक्षित गर्नुपर्छ। तिनीहरूले स्वीकृति आफैं सिर्जना गर्नु हुँदैन, नयाँ ID अन्तर्गत अनिश्चित आदेशहरू पुन: चलाउनु हुँदैन, वा मालिकको मनसाय बिना Git परिवर्तनहरू प्रकाशित गर्नु हुँदैन।

धेरै स्थापनाहरूका लागि धेरै नामाकरण गरिएका MCP सर्भरहरू कन्फिगर गर्नुहोस्। इन्स्टन्स स्विच गर्नु एक मार्ग (routing) निर्णय हो, सिङ्क्रोनाइजेसन होइन। OpenClaw र Hermes कन्फिगरेसन उदाहरणहरू AGENT_CONTROL.md मा छन्; स्थापित क्लाइन्ट संस्करणका लागि क्लाइन्ट-विशिष्ट सेटअप र अनुकूलता जाँच गरिनुपर्छ।

बाहिरी requestId क्यासले अनुप्रयोग चलिरहेको बेला अनुरोधहरूको सीमित सेटलाई मात्र डिड्युप्लिकेट (deduplicate) गर्छ। दिगो सञ्चालनहरूले आफ्नै पहिचानहरू प्रयोग गर्दछन्: कार्य सिर्जनाका लागि createRequestId, कार्यप्रवाह निर्णयहरूका लागि commandId, सन्देशहरूका लागि clientMessageId र operationId Git उत्परिवर्तनहरू (mutations) का लागि। अज्ञात स्वीकृत पश्चात् मूल पहिचान र पेलोड सुरक्षित राख्नुहोस्; जानीजानी नयाँ कार्य जारी गर्नुअघि सुरक्षित गरिएको स्थिति पढ्नुहोस्।

सम्बन्धित निर्देशनहरू: 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 प्रयोग गर्नुहोस्। सफल Start स्वीकृतिको अर्थ कार्य पूरा भयो भन्ने होइन।

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

Automations इन्टरफेसले हाल प्रदर्शन परिभाषाहरू र स्थानीय रन काउन्टरहरू भण्डारण गर्दछ। यो प्रमाणित आवर्ती अनुसूचक (recurring scheduler) होइन र यसले पृष्ठभूमि मोडेल पालो चलेको प्रमाणित गर्दैन। वास्तविक कार्यान्वयनका लागि सुरक्षित कार्यप्रवाह नियन्त्रणहरू, ziaf वा प्रमाणीकृत API प्रयोग गर्नुहोस् र तिनीहरूका रसिदहरू निरीक्षण गर्नुहोस्। प्रदर्शन प्यानललाई मानवरहित अनुसूचीको रूपमा नबुझ्नुहोस्।

सम्बन्धित निर्देशनहरू: डिस्प्याचर आदेशहरू.

संस्करण र अद्यावधिकहरू

About ले चलिरहेको ठ्याक्कै संस्करण देखाउँछ। सार्वजनिक अद्यावधिकहरूका लागि विश्वसनीय GitHub रिलीज भण्डार (repository) र स्थिर वा पूर्वावलोकन च्यानल आवश्यक पर्दछ। जाँच, डाउनलोड र स्थापनाका छुट्टाछुट्टै स्थितिहरू हुन्छन्; त्रुटिको अर्थ अद्यावधिक स्थापना भयो भन्ने होइन।

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

स्वचालित जाँच सक्षम भएपछि तुरुन्तै चल्छ, त्यसपछि प्रत्येक छ घण्टामा चल्छ।

Stable ले पूर्वावलोकन रिलीजहरू बहिष्कार गर्दछ; preview ले विकास रिलीजहरूलाई पनि अनुमति दिन्छ। सफल जाँचले उपलब्ध रिलीज मेटाडेटा मात्र स्थापित गर्दछ। डाउनलोड र स्थापनाका लागि प्लेटफर्म प्याकेज र कन्फिगर गरिएको रिलीज फिड चाहिन्छ। Linux DEB डेलिभरी एक छुट्टै स्थापनाकर्ता मार्ग हो; DEB लाई macOS अद्यावधिक संयन्त्रद्वारा स्वचालित रूपमा स्तरोन्नति गरिन्छ भनी नसम्झनुहोस्।

सम्बन्धित निर्देशनहरू: रिलीज तत्परता.

पुन: सुरु र पुनर्प्राप्ति

macOS मा, पूर्ण बन्दका लागि Quit / ⌘Q प्रयोग गर्नुहोस्। विन्डो बन्द गर्दा एप चलिरहन सक्छ। अनुप्रयोग प्रतिस्थापन गर्नुअघि पुरानो संस्करण पूर्ण रूपमा बन्द गर्नुहोस्।

सुरु भएपछि, उही कार्य चयन गर्नुहोस्। इतिहास र ड्राफ्टहरू फर्किन्छन्। Resume ले नेटिभ/स्थानीय सन्दर्भ पुनर्स्थापित गर्दछ तर ड्राफ्ट पठाउँदैन, लामलाई अनपज गर्दैन वा अज्ञात सञ्चालन दोहोर्‍याउने अधिकार दिँदैन।

यदि Recovery देखा पर्‍यो भने, हातले JSON सम्पादन नगर्नुहोस्। प्रभावित कागजात प्रकार निरीक्षण गर्नुहोस्, मूल फाइलहरू सुरक्षित गर्नुहोस् र प्रमाणित ब्याकअप चयन गर्नुहोस्। पुरानो लाम पुनर्स्थापित गर्दा यसका वस्तुहरूलाई अनिश्चित चिन्ह लगाइन्छ।

जब डेलिभरी अज्ञात हुन्छ, व्यवस्थित कार्यप्रवाहलाई नयाँ सन्दर्भका लागि स्पष्ट अनुमति आवश्यक पर्न सक्छ। पहिलेको काम र असफल प्रयासहरू बाँकी रहन्छन्; बनावटी सफलता भन्दा देखिने अस्वीकार सुरक्षित हुन्छ।

सबै एप इन्स्टन्सहरू बन्द गरेर कार्य फाइलहरू र एप प्रोफाइल ब्याकअप गर्नुहोस्। प्रतिलिपि गरिएको फोल्डर परीक्षण गरिएको पुनर्स्थापना होइन। यदि पुनर्प्राप्तिले तपाईंलाई प्रमाणित ब्याकअप चयन गर्न सोध्छ भने, ठ्याक्कै क्षतिग्रस्त फाइलहरू पनि राख्नुहोस्। पुरानो कार्यप्रवाह वा लाम पुनर्स्थापना गर्नाले अनिश्चित अनुमान वा Git सञ्चालनहरू पुन: चलाउन अधिकार दिँदैन।

सम्बन्धित निर्देशनहरू: पुनर्प्राप्ति सम्झौता.

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

CLI फेला परेन: सामान्य टर्मिनलमा यसको स्थापना र संस्करण जाँच गर्नुहोस्, त्यसपछि ZIAForge पुन: सुरु गर्नुहोस्। कार्यान्वयनयोग्य फाइल उपस्थित हुनुको अर्थ तपाईं साइन इन हुनुहुन्छ भन्ने होइन। प्रदायकको आफ्नै साइन-इन संयन्त्र प्रयोग गर्नुहोस्।

मोडेल उपलब्ध छैन वा प्रमाणीकरण असफल भयो: खोज (discovery) रिफ्रेस गर्नुहोस्, उपलब्ध ID चयन गर्नुहोस् र आफ्नो खाता र सीमाहरू जाँच गर्नुहोस्। यसको इतिहास निरीक्षण गर्नुअघि अनिश्चित अनुरोध नदोहोर्‍याउनुहोस्।

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

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

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

रिमोट पृष्ठ अनुपलब्ध: मालिकले सर्भर सक्षम गरेको प्रमाणित गर्नुहोस्, सुन्दै गरेको ठेगाना र पोर्ट जाँच गर्नुहोस्, त्यसपछि सही इन्स्टन्स टोकनको साथ प्रमाणीकरण गर्नुहोस्। 401 ले प्रमाणीकरणलाई संकेत गर्दछ; अस्वीकार गरिएको उत्परिवर्तन read दायरा वा मालिक-मात्र नियन्त्रण हुन सक्छ। टोकन परिवर्तन गर्दा अवस्थित ब्राउजर क्लाइन्टहरू बन्द हुन्छन्। छुट्टै DevTools निरीक्षण पोर्टलाई रिमोट अनुप्रयोग नियन्त्रणको रूपमा खुला नगर्नुहोस्।

सम्पादक बचत अस्वीकार गरियो: ड्राफ्ट राख्नुहोस्, डिस्कमा रहेको हालको फाइल निरीक्षण गर्नुहोस् र बाह्य-परिवर्तन द्वन्द्व समाधान गर्नुहोस्। अनुप्रयोग मेटाडेटा पुन: लेखेर तुलनालाई बाइपास नगर्नुहोस्। यदि ठूलो-फाइल पूर्ण लोडिङ अनुपलब्ध छ भने, समर्थित विन्डो सम्पादन/खोज वा बाह्य सम्पादक प्रयोग गर्नुहोस्।

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

सम्बन्धित निर्देशनहरू: परीक्षण र निदान.

समस्याहरू रिपोर्ट गर्नुहोस् र प्रमाण निरीक्षण गर्नुहोस्

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

CLI लगहरू, घटना पत्रिकाहरू (event journals), मोडेल ट्रान्सक्रिप्टहरू, ब्राउजर ट्रेसहरू र स्क्रिनसटहरूले स्रोत, व्यक्तिगत मार्गहरू वा टोकनहरू उजागर गर्न सक्छन्। साझा गर्नुअघि निरीक्षण र सम्पादन (redact) गर्नुहोस्। यथासम्भव प्रयास गर्ने लग सम्पादकले स्क्रिनसट वा अभिलेखलाई प्रकाशन योग्य भनी प्रमाणित गर्दैन।

योगदानकर्ताहरूका लागि, qa:doctor ले वातावरण/बिल्ड पहिचान पढ्छ; qa:inspect ले प्रदायक स्टबहरूसहितको छुट्ट्याइएको प्रोफाइल खोल्छ। फिक्स्चरले मोडेललाई सम्पर्क नगरी परीक्षण गरिएको अनुप्रयोग मार्ग प्रमाणित गर्दछ। प्रत्यक्ष अनुमान (live inference), Telegram जडान, नेटिभ Linux डेस्कटप, हस्ताक्षर र प्याकेज गरिएका आर्टिफ्याक्ट जाँचहरू छुट्टाछुट्टै प्रमाण हुन्। पुन: उत्पादन योग्य आदेश र सरसफाइका लागि TESTING.md हेर्नुहोस्।

सम्बन्धित निर्देशनहरू: प्रमाण आदेशहरू.

स्थानीय डेटा र सीमाहरू

परियोजनाहरू, इतिहास, योजनाहरू, कागजातहरू र निदानहरूमा निजी पाठ समावेश हुन सक्छ। प्रोफाइलहरू, कच्चा क्याप्चरहरू, कुञ्जीहरू वा स्रोत कोडसहितका पूरा लगहरू प्रकाशित नगर्नुहोस्।

Linux मा, API, नियन्त्रण, Telegram र इन्स्टन्स प्रमाणहरू बचत गर्न अनलक गरिएको GNOME Secret Service वा 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 चलाउनुहोस्। इन-एप Help ले उही स्रोत पढ्छ। सीमाहरू, अनुमतिहरू र असमर्थित मार्गहरूसहित वास्तविक कार्यान्वयनसँग थपहरू समीक्षा गर्नुहोस्।

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

पठाउनु (shipping) अघि, पुरानो उत्पन्न आउटपुट, अमान्य लोकेल ढाँचाहरू वा टुटेका स्थानीय सम्झौता लिङ्कहरू पत्ता लगाउन node scripts/help/generate.cjs --check चलाउनुहोस्। UI अनुवाद जाँच र अनुप्रयोग व्यवहार जाँचहरू छुट्टाछुट्टै रहन्छन्। HELP_MAINTENANCE.md ले योगदानकर्ता र AI अद्यावधिक प्रक्रिया दिन्छ; कागजातले नचलेको परीक्षण पास भएको दाबी गर्नु हुँदैन।

सम्बन्धित निर्देशनहरू: हालको परियोजना नक्सा · कागजात मर्मतसम्भार · योगदानकर्ता निर्देशनहरू · एजेन्ट निर्देशनहरू.