स्थापित करें और अपडेट

GET  /v1/admin/modules
POST /v1/admin/modules/install

{ "slug": "einstein", "version": "" }

download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active

AiHummer में एक प्लगइन इंस्टॉल करना एडमिन UI में एक क्लिक का काम है, लेकिन उस क्लिक के पीछे एक निर्धारित, होस्ट-नेटिव जीवनचक्र होता है। प्लेटफ़ॉर्म प्लगइन को डाउनलोड करता है, उसके घोषित इंस्टॉल स्टेप्स चलाता है, और एक रेंडर करता है **सैंडबॉक्स्ड सिस्टमड यूनिट**, और केवल तभी प्लगइन को स्वस्थ माना जाता है जब यह हेल्थ चेक का उत्तर देता है। प्रत्येक इंस्टॉलेशन फिर अपने आप को अपडेट रखता है। ## एडमिन यूआई से एक-क्लिक इंस्टॉल आप प्लगइन्स को एडमिन यूआई से इंस्टॉल और मैनेज करते हैं, जिसे एडमिन मॉड्यूल एपीआई द्वारा समर्थित किया गया है: ```http GET /v1/admin/modules POST /v1/admin/modules/install ``` मॉड्यूल स्लग JSON अनुरोध शरीर में जाता है, पथ में नहीं: ```json { "slug": "einstein", "version": "" } ``` हाथ से वायर करने के लिए कुछ भी नहीं है: सूची में से कोई प्लगइन चुनें, इंस्टॉल पर क्लिक करें, और डिप्लॉयर काम संभाल लेता है। > [!NOTE] > कोर सेट के बाहर एक चैनल कनेक्टर स्थापित करना (केवल टेलीग्राम) > एक सक्रिय की आवश्यकता होती है **स्टार्टर**, **व्यवसाय** या **उद्यम** लाइसेंस। > कम्युनिटी योजना पर ऐसा अनुरोध लौटता है **HTTP 402 "अपग्रेड आवश्यक"** > (कोड `plan_limit`) — देखें [लाइसेंसिंग](/hi/v1.0/commercial/licensing). > [!NOTE] > द **आइंस्टीन** मेमोरी प्लगइन है **इन-बिल्ट**: यह स्वचालित रूप से इंस्टॉल हो जाता है, > एक "बिल्ट-इन" बैज है और इसे हटाया या रोका नहीं जा सकता। ## सिस्टमड डिप्लॉयर फ्लो हूड के नीचे **सिस्टमडीडिप्लॉयर** ये कदम करता है: 1. **एक टारबॉल डाउनलोड करें** चयनित प्लगइन के लिए। 2. **मैनिफेस्ट चलाएँ `install[]` कदम** प्लगइन द्वारा घोषित किया गया। 3. **सैंडबॉक्स किए गए systemd यूनिट को प्रस्तुत करें** प्लगइन के लिए। 4. **मतदान `/healthz`** जब तक सेवा स्वस्थ होने की रिपोर्ट नहीं करती। ```text download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active ``` सिर्फ तब जब `/healthz` सफल होने पर स्थापना को सक्रिय के रूप में चिह्नित किया जाता है — एक प्लगइन जो लॉन्च नहीं होता, उसे चुपचाप स्थापित के रूप में गिना नहीं जाता। ## होस्ट-नेटिव, सैंडबॉक्स्ड सिस्टमडी — डॉकर नहीं हर प्लगइन के रूप में चलता है **अपना स्वयं का सैंडबॉक्स्ड systemd सेवा**कोई कंटेनर नहीं हैं, कोई Docker नहीं, कोई orchestrator नहीं: एक प्लगइन एक प्रबंधित Linux सेवा है जिसमें अपनी यूनिट, पोर्ट और सैंडबॉक्स प्रतिबंध होते हैं, जिसे systemd द्वारा बाकी इंस्टॉल की तरह निगरानी किया जाता है। > [!WARNING] > AiHummer होस्ट-नेटिव है। प्लगइन्स सैंडबॉक्स किए गए systemd सेवाओं के रूप में तैनात किए जाते हैं > एक रिलीज़ टारबॉल से — **कभी भी Docker कंटेनरों के रूप में नहीं।** यदि कोई गाइड आपको बताता है > प्लगइन कंटेनर को चलाने के लिए, यह AiHummer का वर्णन नहीं करता। ## /healthz के साथ स्वास्थ्य गेटिंग डिप्लॉयर प्लगइन का पोल करता है `/healthz` सफलता घोषित करने से पहले एंडपॉइंट। यह हेल्थ गेट ही है जो वन-क्लिक इंस्टॉल को सुरक्षित बनाता है: एक टूटा हुआ या गलत तरीके से कॉन्फ़िगर किया गया प्लगइन इंस्टॉल के समय पकड़ा जाता है, न कि बाद में प्रोडक्शन में खोजा जाता है। ## प्रति-स्थापना स्वतः-अपडेट अपडेट्स को संभाला जाता है **प्रति स्थापना**प्रत्येक स्थापित प्लगइन अपने शेड्यूल पर अपने आप अपडेट हो सकता है, इसलिए प्लगइन्स को अपडेट रखना हर बार नया संस्करण कैटलॉग में आने पर मैन्युअल रूप से पुनः स्थापित करने की आवश्यकता नहीं है। वही डाउनलोड → इंस्टॉल स्टेप्स → रेंडर यूनिट → हेल्थ-चेक फ़्लो अपडेट के लिए भी चलता है जैसे कि पहली स्थापना के लिए। > [!TIP] > क्योंकि ऑटो-अपडेट प्रति इंस्टॉलेशन होता है, आप कुछ प्लगइन्स को पिन करके रख सकते हैं जबकि > अन्यों को नवीनतम का पता लगाने देना — प्रत्येक स्थापना अपनी स्वयं की जीवनचक्र का प्रबंधन करती है। ## मल्टी-सोर्स कैटलॉग कॅटलॉग अब किसी एक URL से जुड़ा नहीं है। **सामुदायिक सूची** तृतीय-पक्ष प्लगइनों का एक बिल्ट-इन के रूप में शामिल होना **डिफ़ॉल्ट स्रोत** (इंस्टॉल पर बीजित) — आप इसे स्वयं नहीं जोड़ते। में **प्लगइन्स → स्रोत** (एडमिन यूआई, या `POST /v1/admin/modules/catalog/sources`) आप अपने खुद के अतिरिक्त स्रोत जोड़ सकते हैं। गेटवे हर सक्षम स्रोत को स्टार्टअप पर और ऑटो-अपडेट अंतराल पर सिंक करता है। - द **आधिकारिक स्रोत** (पहली-पक्षीय मॉड्यूल) डिफ़ॉल्ट रूप से पिन और भरोसेमंद हैं — एक अलग वस्तु जो है **ओवरराइट नहीं किया गया** अन्य स्रोतों द्वारा। - द **सामुदायिक सूची** एक बीजयुक्त डिफ़ॉल्ट स्रोत है; **निजी स्रोत** हैं ऑपरेटर द्वारा जोड़ा गया। हर सूची प्रविष्टि में एक `origin`और वह `origin` निर्णय करता है कि हस्ताक्षर किस एंकर द्वारा सत्यापित किया गया है के खिलाफ (आधिकारिक → पिन्ड की, निजी → ट्रस्ट स्टोर)। समुदाय कैटलॉग में प्रकाशित करने के लिए, देखें [एक प्लगइन प्रकाशित करना](/hi/v1.0/marketplace/publishing). ## विश्वास मॉडल और पिन की गई कुंजी इंस्टॉलेशन स्रोत द्वारा प्लगइन के हस्ताक्षर को सत्यापित करता है: - **आधिकारिक** → के खिलाफ सत्यापित **कोर में पिन किया गया रजिस्ट्री कुंजी**. पर भरोसा किया गया डिफ़ॉल्ट, कोई ऑपरेटर कार्रवाई नहीं। - **निजी** (साइड-लोड) → के खिलाफ सत्यापित **इंस्टेंस ट्रस्ट स्टोर**; यह लेखक कुंजी अपलोड पर ऑपरेटर द्वारा स्वीकृत की जाती है (एक क्लिक में)। - **असाइन किया हुआ नहीं** → अस्वीकृत, केवल डेवलपमेंट मोड में (`AIHUMMER_PLUGIN_DEV_UNSIGNED=1`, केवल स्थानीय विकास के लिए)। > [!WARNING] > **समुदाय के प्लगइन अभी इंस्टॉल नहीं किए जा सकते — यह कनेक्शन की गड़बड़ी नहीं है।** > जिस कुंजी से समुदाय कैटलॉग पर हस्ताक्षर होते थे, वह वापस ले ली गई है; नई कुंजी आने तक > हस्ताक्षर जाँच ऐसी प्रविष्टियाँ अस्वीकार कर देती है। इससे अलग, तीसरे पक्ष का कोड अभी > आपके सर्वर पर सेवा के रूप में नहीं चलाया जाता: पृथक रनटाइम आने तक केवल वे एकीकरण > अनुमत हैं जो अपनी ओर चलते हैं और नेटवर्क से जुड़ते हैं। > > **आप क्या देखेंगे:** «इंस्टॉल» दबाने के बाद सामान्य «इंस्टॉल हो रहा है» संदेश दिखेगा, > पर प्लगइन इंस्टॉल की सूची में **कभी नहीं आएगा**। अस्वीकृति का कारण गेटवे लॉग में जाता > है — प्रबंधन पैनल में **लॉग** खोलें। > > **आज क्या काम करता है:** > > - आधिकारिक कैटलॉग के **AiHummer के प्लगइन** — सामान्य रूप से इंस्टॉल होते हैं, उन पर > दूसरा, वैध हस्ताक्षर है; > - **HTTP पर MCP सर्वर** — बिना विकास के उपकरण-स्रोत के रूप में जुड़ता है, कोड आपकी ओर > ही रहता है; > - **OpenAPI विनिर्देश द्वारा एकीकरण** — वही बात, कोई सेवा इंस्टॉल किए बिना। > > अपना प्लगइन साइड-लोड करने पर हस्ताक्षर जाँच पास हो जाती है, पर वह केवल **HTTP पर > दूरस्थ MCP** या OpenAPI एकीकरण के रूप में चलेगा; ऐसा बिल्ड जिसे इसी सर्वर पर सेवा के > रूप में चलाना पड़े, अस्वीकार कर दिया जाता है। ## साइन किए गए अपडेट एक अपडेट **एक ही सिग्नेचर गेट को दोबारा चलाता है** पहली स्थापना के रूप में: जब किसी नए संस्करण में बदलते हैं तो सिग्नेचर को उसी ट्रस्ट एंकर के खिलाफ फिर से सत्यापित किया जाता है। एक अपडेट **बायपास नहीं कर सकता** जाँच — आप अद्यतन के माध्यम से विश्वास को बढ़ा नहीं सकते। ## आधिकारिक बैज और रैंकिंग वेब UI कैटलॉग में, AiHummer के प्लगइन्स एक ले जाते हैं **आधिकारिक** बैज और रैंक पहले। थर्ड-पार्टी प्लगइन्स बिना बैज के दिखाए जाते हैं और क्रमबद्ध होते हैं **डाउनलोड संख्या द्वारा**. आधिकारिक ध्वज किसी प्रविष्टि से लिया गया है `origin` (आधिकारिक) — इसे मैनिफ़ेस्ट में हाथ से सेट नहीं किया जा सकता। ## अगला कहाँ - [मार्केटप्लेस अवलोकन और स्तर](/hi/v1.0/marketplace/overview-tiers) — क्या तीन प्लगइन स्तर हैं। - [प्लगइन एसडीके](/hi/v1.0/marketplace/sdk) — इसमें `manifest.json` है, जिसका `install[]` इस जीवनचक्र के चरण चलते हैं। - [एक प्लगइन प्रकाशित करना](/hi/v1.0/marketplace/publishing) — निजी साइड-लोड और व्यक्तिगत कैबिनेट के माध्यम से सामुदायिक प्रकाशन। - [ज़ीरो-कोड इंटीग्रेशन](/hi/v1.0/marketplace/zero-code) — OpenAPI/MCP उपकरण जोड़ें कोई सेवा स्थापित करने के लिए नहीं है।