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

OpenCode SubAgent Magazine, OpenCode TUI के लिए एक प्लगइन है, जिसका उद्देश्य रीयल-टाइम सबएजेंट निगरानी और साइडबार विज़ुअलाइज़ेशन प्रदान करना है। यह मैगज़ीन की तरह सबएजेंट जानकारी को भरता और फायर करता है, जिससे उपयोगकर्ता प्रत्येक सबएजेंट की रन स्थिति, Token खपत, लागत, समय, मॉडल और प्रगति जैसे प्रमुख डेटा को सहजता से ट्रैक कर सकते हैं। प्लगइन की मुख्य विशेषताएँ: - **रीयल-टाइम स्थिति प्रदर्शन**: रंगीन बिंदुओं (हरा पूर्ण, पीला चल रहा है ब्रीदिंग एनिमेशन के साथ, लाल त्रुटि) के माध्यम से प्रत्येक सबएजेंट की स्थिति एक नज़र में दिखाई जाती है। - **Token और लागत ट्रैकिंग**: प्रत्येक सबएजेंट की Token खपत और लागत को सारांशित करता है, और शीर्षक बार में वैश्विक रूप से प्रदर्शित करता है। - **विस्तार से विवरण**: आइटम पर क्लिक करके agent प्रकार, स्थिति, समय, Token, लागत, मॉडल, प्रगति आदि विस्तृत जानकारी देखी जा सकती है, फ़ील्ड मान दाएँ-संरेखित होते हैं, जिससे पढ़ना आसान होता है। - **एक क्लिक में सत्र में प्रवेश**: विस्तार के बाद "→ सत्र में प्रवेश" पर क्लिक करके सीधे उस सबएजेंट की पूरी बातचीत पर जा सकते हैं। - **सत्र ID प्रदर्शन**: विस्तृत विवरण में सबएजेंट का Session ID दिखाई देता है, क्लिक करके पूरा ID पॉपअप में देखा और कॉपी किया जा सकता है। - **मैन्युअल रूप से पूर्ण चिह्नित करें**: अटके हुए ज़ॉम्बी आइटम के लिए, विस्तार क्षेत्र के दाईं ओर "- पूर्ण चिह्नित करें" बटन से मैन्युअल रूप से समाप्त किया जा सकता है, या `/subagent-clear-running` से बैच में साफ़ किया जा सकता है। - **संकुचित पैनल**: शीर्षक बार पर क्लिक करके पैनल को संकुचित/विस्तारित किया जा सकता है, स्थिति स्थायी रहती है, पुनः आरंभ के बाद भी बनी रहती है। - **शीर्ष/तल पर स्क्रॉल**: सूची के नीचे "↑ शीर्ष पर" और "↓ तल पर" बटन उपलब्ध हैं, दिशा क्रम के अनुसार स्वतः अनुकूलित होती है। - **कॉन्फ़िगर करने योग्य क्रम**: `/subagent-order` के माध्यम से अवरोही (नवीनतम पहले) या आरोही (सबसे पुराना पहले) क्रम का समर्थन करता है। - **पेजिंग मोड स्विच**: `/subagent-scroll` से "स्क्रॉल व्हील पेजिंग" या "more पर क्लिक करके पेजिंग" चुना जा सकता है, जिससे साइडबार और वैश्विक स्क्रॉल के टकराव का समाधान होता है। - **TTL स्वतः सफ़ाई**: डेटा प्रतिधारण अवधि (3/7/14/30 दिन या अनिश्चितकाल) कॉन्फ़िगर की जा सकती है, प्रत्येक पहुँच पर स्वतः नवीनीकरण, समाप्त होने पर स्वतः सफ़ाई। - **मैन्युअल रूप से आइटम साफ़ करें**: `/subagent-clear-entries` वर्तमान सत्र के सभी रिकॉर्ड साफ़ करता है, जिससे ऐतिहासिक आइटम स्कैन और पुनर्निर्माण को रोका जा सके। - **भाषा अनुकूलन**: `/subagent-lang` के माध्यम से रनटाइम पर चीनी/अंग्रेज़ी स्विच का समर्थन करता है, प्राथमिकता स्थायी रहती है। - **स्विच करने योग्य बॉर्डर**: `/subagent-border` पैनल के बाहरी बॉर्डर की दृश्यता को नियंत्रित करता है (डिफ़ॉल्ट रूप से छिपा हुआ), सक्षम करने पर कैश सांख्यिकी पैनल की शैली के साथ एकरूप हो जाता है। - **स्लैश कमांड**: `/subagent-lang`, `/subagent-max`, `/subagent-order`, `/subagent-scroll`, `/subagent-ttl`, `/subagent-clear-entries`, `/subagent-session`, `/subagent-version`, `/subagent-clear-running`, `/subagent-border` आदि गतिशील कॉन्फ़िगरेशन कमांड उपलब्ध हैं। इंस्टॉलेशन के संबंध में, प्लगइन opencode 1.x और 2.x दोनों का समर्थन करता है। 2.x के लिए, `~/.config/opencode/cli.json` के `plugins` ऐरे में प्रविष्टि जोड़नी होती है; 1.x के लिए, कमांड पैलेट से इंस्टॉल किया जा सकता है या मैन्युअल रूप से `tui.jsonc` कॉन्फ़िगर किया जा सकता है। ध्यान दें कि `opencode plugin add` से इंस्टॉल न करें, क्योंकि यह कमांड server प्लगइन कॉन्फ़िगरेशन में लिखता है जिससे त्रुटि होती है। उपयोग गाइड में स्लैश कमांड के उपयोग, कीबोर्ड और माउस संचालन (जैसे शीर्षक बार पर क्लिक करके संकुचित करना, आइटम पर क्लिक करके विस्तार करना, स्क्रॉल व्हील पेजिंग आदि), और स्थिति रंगों के अर्थ का विस्तार से वर्णन किया गया है। अपडेट करते समय प्लगइन कैश साफ़ करके पुनः इंस्टॉल करना आवश्यक है, क्योंकि OpenCode में एक ज्ञात समस्या के कारण प्लगइन संस्करण लॉक हो जाता है। प्लगइन पूरी तरह से मॉडल-स्वतंत्र है, सभी OpenCode-संगत AI मॉडल (जैसे DeepSeek, Claude, GPT आदि) का समर्थन करता है, डेटा OpenCode SDK मानक इंटरफ़ेस के माध्यम से प्राप्त किया जाता है। MIT लाइसेंस के अंतर्गत।