इंस्टॉल किए गए प्लगइन का रखरखाव करें

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

पहले स्थिति जाँचें

agentplugins list
agentplugins doctor
agentplugins outdated --all

list इंस्टॉलेशन बताता है, doctor प्रबंधित स्थिति का निदान करता है और outdated बिना लागू किए अपडेट विकल्प खोजता है। इनमें से कोई भी दूरस्थ सेवा के स्वस्थ होने या क्लाइंट का प्रमाणीकरण पूरा होने का प्रमाण नहीं है।

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

लोकल मैनेजमेंट API (CLI 0.1.95)

CLI 0.1.95 में इंस्टॉलर को अपने भीतर इस्तेमाल करने वाले ऐप्लिकेशन के लिए agentplugins manage serve और लोकल क्लाइंट व प्रोफ़ाइल की केवल पढ़ने वाली खोज के लिए agentplugins manage discover जोड़े गए हैं। यह खोज क्लाइंट नहीं चलाती, उनके संस्करण नहीं जाँचती, स्रोत नहीं लाती और फ़ाइलें नहीं बदलती।

manage serve ऐसी प्रक्रिया है जिसका जीवनचक्र उसे शुरू करने वाला ऐप्लिकेशन संभालता है। यह स्टार्टअप पर दर्ज संदर्भ और निजी, प्रमाणित IPv4 लूपबैक API इस्तेमाल करती है। इंटीग्रेशन करने वाला होस्ट stdin पर JSON देता है और bootstrap URL तथा bearer capability को निजी रखता है। इंटीग्रेशन से पहले कमांड की मदद देखें:

agentplugins version
agentplugins manage serve --help
agentplugins manage discover --help

स्टार्टअप और जीवनचक्र के नियम मैनेजमेंट प्रोटोकॉल अनुबंध में हैं। TypeScript मैनेजमेंट SDK के संस्करण universal-agent-plugins-management-sdk पैकेज के रूप में स्वतंत्र रूप से प्रबंधित किए जाते हैं। agentplugins इंजन के संगत संस्करणों और पैकेज इंस्टॉल करने के निर्देशों के लिए SDK का README देखें। npm पर प्रकाशित कोई संस्करण चुनें या, अभी तक जारी न हुए बदलावों के साथ काम करने के लिए, स्रोत कोड के किसी पिन किए गए कमिट से पैकेज बनाएँ और उसका परीक्षण करें। SDK और इंजन, दोनों के संस्करण पिन करें।

सोच-समझकर अपडेट करें

agentplugins update context7 --target codex,cursor --dry-run

चुने गए स्रोत, संस्करण और गंतव्य की समीक्षा करें। लागू करने के लिए --dry-run छोड़ दें:

agentplugins update context7 --target codex,cursor

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

दर्ज स्थिति की मरम्मत करें

agentplugins repair context7 --target codex,cursor --dry-run
agentplugins repair context7 --target codex,cursor

पहली कमांड पूर्वावलोकन दिखाती है; दूसरी लागू करती है। रिपेयर स्वामित्व वाली सामग्री बहाल करने के लिए दर्ज स्रोत दोहराता है। वह नया दूरस्थ रिविज़न नहीं चुनता और बाहर से बदली गई नेटिव एंट्री चुपचाप नहीं लिखता। आगे बढ़ने से पहले टकराव और लंबित रिकवरी निर्देश देखें।

चुनी गई इंस्टॉलेशन हटाएँ

agentplugins remove context7 --target codex,cursor --dry-run
agentplugins remove context7 --target codex,cursor

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

सहेजा हुआ निर्भरता परिवेश इस्तेमाल करें

uap.toml इच्छित पैकेज और टार्गेट दर्ज करता है; uap.lock उनके सटीक हल किए गए स्रोत और डाइजेस्ट दर्ज करता है। चुना हुआ परिवेश देखें:

agentplugins deps status
agentplugins deps tree

नए परिवेश के लिए agentplugins deps init चलाएँ, मेनिफ़ेस्ट सोच-समझकर संपादित करें, फिर उसे हल करने के लिए agentplugins deps lock और उस लॉक को लागू करने के लिए agentplugins install --locked --scope user चलाएँ। पुष्टियों की समीक्षा करें और पूर्वावलोकन के लिए --dry-run इस्तेमाल करें। निर्भरता गाइड में मेनिफ़ेस्ट सिंटैक्स, अनिवार्य पैकेज निर्भरताएँ, संस्करण रेंज और अपडेट नियम समझाए गए हैं।

CLI 0.1.93 में योग्य दूरस्थ add कार्रवाइयाँ डिफ़ॉल्ट रूप से पोर्टेबल निर्भरता का आशय सहेजती हैं। स्पष्ट लोकल पाथ, discovery स्रोत, केवल ChatGPT के लिए तैयारी और --no-save इसके बजाय सीधे कार्रवाई वाला तरीका इस्तेमाल करते हैं। यह न मानें कि पुरानी सीधे की गई इंस्टॉलेशन निर्भरता अनुबंध में शामिल है: फ़ाइलें स्थानांतरित करने से पहले deps status और वास्तविक फ़ाइलें जाँचें।

दूसरी मशीन पर बहाल करें

सहेजे हुए उपयोगकर्ता परिवेश को एक आदान-प्रदान फ़ोल्डर के ज़रिए स्थानांतरित करें। स्रोत मशीन पर उस फ़ोल्डर से चलाएँ:

agentplugins deps export

फ़ोल्डर गंतव्य पर कॉपी करें, टार्गेट क्लाइंट इंस्टॉल करें और वहाँ चलाएँ:

agentplugins deps import
agentplugins install --locked --scope user

या इम्पोर्ट और बहाली साथ करें:

agentplugins deps import --install

वैकल्पिक डायरेक्टरी आर्ग्युमेंट कोई दूसरा आदान-प्रदान फ़ोल्डर चुनता है। एक्सपोर्ट उपयोगकर्ता परिवेश पढ़ता है और इम्पोर्ट उसमें लिखता है; AGENTPLUGINS_HOME से विशिष्ट परिवेश चुन सकते हैं। स्थानांतरित फ़ोल्डर स्वयं क्लाइंट प्रोफ़ाइल का विकल्प नहीं है। स्पष्ट --scope user बहाली को उपयोगकर्ता परिवेश में रखता है।

केवल अपरिवर्तित और सख्ती से वैलिडेट की गई uap.toml और uap.lock फ़ाइलें स्थानांतरित होती हैं। वास्तविक कॉपी से पहले पूर्वावलोकन दिखता है और पुष्टि या --yes आवश्यक है; --dry-run पूर्वावलोकन देता है। इम्पोर्ट वैलिडेशन ऑफ़लाइन है, लेकिन इंस्टॉलेशन को दर्ज स्रोत या सत्यापित कैश किए पैकेज चाहिए। बिना कैश की बहाली सटीक पिन प्राप्त करके डाइजेस्ट जाँचती है; नए संस्करण नहीं चुनती।

क्लाइंट प्रोफ़ाइल, सेटिंग, क्रेडेंशियल, रसीदें और PLUGIN_DATA स्थानांतरण में शामिल नहीं हैं। नई मशीन पर प्रमाणीकरण सेट करें और डेटा का अलग बैकअप लें। इम्पोर्ट में फ़ाइलों की जोड़ी सहेजने के बाद इंस्टॉलेशन असफल हो तो बताई गई वजह ठीक करें और install --locked --scope user दोहराएँ। लंबित रिकवरी बताए जाने पर पहले deps recover --scope user चलाएँ। स्थानांतरित पिन deps lock से दोबारा न बनाएँ, क्योंकि बदलने वाला चयनकर्ता अलग परिणाम दे सकता है।

प्रोजेक्ट बहाल करें और रखरखाव करें

स्वचालित प्रोजेक्ट इंस्टॉलेशन CLI 0.1.94 और उसके बाद उपलब्ध है। प्रोजेक्ट की uap.toml और uap.lock कमिट करें। किसी अन्य मौजूदा चेकआउट में आवश्यक क्लाइंट इंस्टॉल करें और ठीक प्रोजेक्ट डायरेक्टरी से चलाएँ:

agentplugins install

मौजूदा लॉक सख्ती से वैलिडेट होता है। --locked के साथ उसका मौजूद होना भी अनिवार्य है, जो CI में उपयोगी है। लॉक न हो तो पहली इंस्टॉलेशन उसे बना सकती है। दूसरी डायरेक्टरी से कमांड चलाते समय मौजूदा प्रोजेक्ट स्पष्ट रूप से चुनें:

agentplugins install --locked --scope project --project-root /path/to/project

रखरखाव के लिए वही स्कोप और रूट चुनें:

agentplugins list --scope project --project-root /path/to/project
agentplugins deps status --scope project --project-root /path/to/project
agentplugins repair review --target cursor --scope project --project-root /path/to/project
agentplugins deps recover --scope project --project-root /path/to/project

नाम अस्पष्ट हो तो list से मिली इंस्टॉलेशन पहचान इस्तेमाल करें। रखरखाव कमांड डिफ़ॉल्ट रूप से उपयोगकर्ता स्कोप चुनती हैं, इसलिए प्रोजेक्ट स्कोप स्पष्ट दें। स्रोत आर्ग्युमेंट के बिना install के लिए नीचे दिया 0.1.94 चयन नियम लागू होता है। --project-root के बिना स्पष्ट --scope project केवल कमांड चलाने वाली डायरेक्टरी इस्तेमाल करता है।

.uap/ की रसीदें, रिकवरी जर्नल और सहेजा डेटा लोकल रखें। पोर्टेबल अनुबंध से नेटिव घटक बहाल करें और क्लाइंट के ट्रस्ट या सक्रियण निर्देश पूरे करें। स्रोत और निजी स्रोतों तक पहुँच उपलब्ध रहनी चाहिए। प्रोजेक्ट इंस्टॉलेशन और हर क्लाइंट की सीमाएँ देखें।

CLI 0.1.94 में डिफ़ॉल्ट इंस्टॉलेशन चयन

पहले agentplugins version जाँचें। इस व्यवहार के लिए 0.1.94 चाहिए। आपका पैकेज मैनेजर चैनल पुराना हो तो नेटिव इंस्टॉलर या Homebrew इस्तेमाल करें। ऊपर की स्पष्ट प्रोजेक्ट स्कोप कमांड 0.1.93 के साथ भी संगत हैं।

CLI 0.1.94 में प्रकाशित: स्रोत आर्ग्युमेंट या स्पष्ट स्कोप के बिना agentplugins install प्रोजेक्ट स्कोप तभी चुनता है जब ठीक वर्तमान डायरेक्टरी में नियमित uap.toml फ़ाइल मौजूद हो। वह पैरेंट नहीं खोजता। स्वचालित चयन के दौरान इस नाम की डायरेक्टरी या सिमलिंक अस्वीकार किया जाता है; अस्पष्टता दूर करने के लिए स्कोप स्पष्ट चुनें। लोकल मेनिफ़ेस्ट न हो तो इंस्टॉलेशन उपयोगकर्ता परिवेश चुनती है। स्पष्ट --scope user या --scope project हमेशा प्राथमिक होता है। अन्य कमांड का डिफ़ॉल्ट उपयोगकर्ता स्कोप रहता है।

मौजूदा uap.lock बदलावों से पहले सख्ती से वैलिडेट होता है, भले ही --locked न दिया हो। मेल न खाने पर कार्रवाई रुक जाती है। पिन आगे बढ़ाने के लिए update इस्तेमाल करें; install से उन्हें ताज़ा करने की अपेक्षा न करें। केवल लॉक न होने पर पहली इंस्टॉलेशन निर्भरताएँ हल करके लॉक बना सकती है। --locked मौजूदा लॉक भी अनिवार्य करता है। पूर्वानुमेय ऑटोमेशन और प्रोजेक्ट बहाली के लिए ऊपर दिए स्पष्ट स्कोप और --locked वाले उदाहरण उपयुक्त हैं।

समस्या स्पष्ट रूप से बताएँ

CLI संस्करण, कार्रवाई, स्कोप, पैकेज स्रोत, टार्गेट क्लाइंट और बाकी सक्रियण निर्देश दर्ज करें। बताएँ कि विफलता स्रोत प्राप्त करने, योजना बनाने, फ़ाइलें लागू करने, रिकवरी, क्लाइंट पहचान, प्रमाणीकरण या रनटाइम उपयोग में हुई। निदान साझा करने से पहले क्रेडेंशियल हटाएँ। पैकेज निर्माण का doctor ./my-plugin स्रोत पैकेज जाँचता है; इंस्टॉलर का doctor प्रबंधित इंस्टॉलेशन स्थिति का निदान करता है।