Zed

विक्रेता: Zed Industries इंस्टॉल नाम: zed स्थिति: GA नेटिव कॉन्फ़िग: <project>/.rules

इंस्टॉलेशनCopy Anchor Link

apothem install --harness zed --project /path/to/project

अडैप्टर साझा Apothem नियमों और शासन सतह से प्रोजेक्ट-स्कोप वाली एक Zed निर्देश फ़ाइल लिखता है। Zed एक प्रोजेक्ट निर्देश फ़ाइल पढ़ता है, जो इस सूची में पहला मिलान होती है:

.rules
.cursorrules
.windsurfrules
.clinerules
.github/copilot-instructions.md
AGENT.md
AGENTS.md
CLAUDE.md
GEMINI.md

प्रति-टूल कोई नियम डायरेक्टरी नहीं है, इसलिए पूरी Apothem सतह उस सूची के शीर्ष पर स्थित सपाट .rules फ़ाइल में उतरती है।

यह Apothem की स्किल, और वे जिन नियमों और टेम्पलेट का हवाला देती हैं, उन्हें भी प्रोजेक्ट को छूने से पहले आपकी होम डायरेक्टरी में लिखता है (प्रोजेक्ट के बाहर की फ़ाइलें देखें)।

लिखी गई फ़ाइलें:

• <project>/.rules, निर्देश फ़ाइल।
• आपकी होम डायरेक्टरी में, हर Apothem स्किल और कमांड के लिए ~/.agents/skills/<name>/SKILL.md।
• आपकी होम डायरेक्टरी में, ~/.config/apothem/rules/ और ~/.config/apothem/templates/।

प्रोजेक्ट के बाहर की फ़ाइलेंCopy Anchor Link

इंस्टॉल प्रोजेक्ट में कुछ भी बदलने से पहले Apothem की स्किल आपकी होम डायरेक्टरी में भी लिखता है:

ये फ़ोल्डर साझा हैं। ये प्रोजेक्ट के निजी नहीं हैं:

• हर वह प्रोजेक्ट जिसमें आप zed इंस्टॉल करते हैं, और फ़ोल्डर का नाम लेने वाला हर अन्य Apothem इंस्टॉल, एक ही प्रति का उपयोग करता है और वही फ़ाइलें लिखता है, इसलिए आप किस क्रम में इंस्टॉल करते हैं इससे फ़र्क नहीं पड़ता। कई अन्य टूल भी ~/.agents/skills/ पढ़ते हैं; हार्नेस रजिस्ट्री उन्हें सूचीबद्ध करती है।
• --project यह चुनता है कि कौन-सी निर्देश फ़ाइल लिखी जाए और इंस्टॉल किस प्रोजेक्ट का है। यह नहीं बदलता कि स्किल कहाँ जाती हैं।
• इंस्टॉल आपकी रिपॉज़िटरी में कोई स्किल या नियम फ़ाइल नहीं जोड़ता। प्रोजेक्ट को निर्देश फ़ाइल मिलती है, साथ ही वह .apothem/ डेटा फ़ोल्डर जो हर प्रोजेक्ट इंस्टॉल बनाता है।
• होम फ़ोल्डर पहले लिखे जाते हैं। यदि यह विफल होता है, उदाहरण के लिए क्योंकि पथ में कोई फ़ोल्डर ऐसा लिंक है जो आपकी होम डायरेक्टरी से बाहर जाता है (जो लिंक उसके भीतर रहता है, उसका अनुसरण किया जाता है) या लिखा नहीं जा सकता, तो इंस्टॉल प्रोजेक्ट में कुछ भी बदलने से पहले त्रुटि के साथ रुक जाता है।
• Apothem स्किल के नाम वाला कोई स्किल फ़ोल्डर जिसे Apothem ने नहीं लिखा, उसे छोड़ दिया जाता है, और इंस्टॉल एक चेतावनी प्रिंट करता है जो उसका नाम बताती है। उसका नाम बदलें या उसे स्थानांतरित करें, फिर apothem update चलाएँ। जब तक वह नाम घिरा रहता है, apothem verify विफल रहता है।
• फ़ाइलें कुल मिलाकर कुछ मेगाबाइट की होती हैं।

इंस्टॉल एक नोट प्रिंट करता है जो उन फ़ोल्डरों के नाम बताता है जिन्हें वह --project के बाहर लिखता है, और --dry-run उन्हें सूचीबद्ध करता है।

प्रोफ़ाइल-से-नेटिव-कॉन्फ़िग मैपिंगCopy Anchor Link

अडैप्टर Apothem की साझा प्रोफ़ाइल पढ़ता है और हर apothem install या apothem update रन पर प्रोजेक्ट .rules फ़ाइल रेंडर करता है। साझा प्रोफ़ाइल सत्य का स्रोत है; किसी भी पूर्व-मौजूद .rules (या जनित फ़ाइल में किए गए प्रोजेक्ट-स्थानीय संपादनों) का बैकअप अगली सिंक द्वारा Apothem-प्रबंधित सामग्री को बदलने से पहले ले लिया जाता है।

संगतता टिप्पणियाँCopy Anchor Link

Zed AGENTS.md को अपनी प्राथमिक निर्देश फ़ाइल बताता है और प्रोजेक्ट .rules को एक समर्थित संगतता फ़ाइल के रूप में रखता है (Zed निर्देश)। चूँकि Zed केवल पहला मिलान पढ़ता है, इसलिए एक नई .rules फ़ाइल किसी AGENTS.md, किसी CLAUDE.md, या सूची में नीचे की किसी भी अन्य ऐसी फ़ाइल को छिपा देती है जिस पर प्रोजेक्ट पहले से निर्भर है। इंस्टॉल उन फ़ाइलों को कभी संपादित नहीं करता। जब .rules में केवल Apothem ब्लॉक हो और कोई कम-प्राथमिकता वाली फ़ाइल आपका टेक्स्ट रखती हो, तब इंस्टॉल और अपडेट एक चेतावनी प्रिंट करते हैं जो छिपी हुई फ़ाइल का नाम बताती है; जिन निर्देशों की आपको आवश्यकता है, उन्हें Zed में बनाए रखने के लिए Apothem ब्लॉक के बाहर .rules में कॉपी करें।

वैश्विक ~/.config/zed/AGENTS.md निर्देश फ़ाइल और MCP कॉन्टेक्स्ट-सर्वर ब्लॉक (.zed/settings.json में context_servers) ऑपरेटर-स्वामित्व वाले हैं; Apothem उन्हें नहीं लिखता।

Zed वैश्विक स्किल केवल ~/.agents/skills/ से लोड करता है, हर स्किल के लिए एक फ़ोल्डर वाले सपाट लेआउट में, और इंस्टॉल यही लेआउट लिखता है। Zed प्रोजेक्ट-स्थानीय स्किल को एक विश्वसनीय वर्कट्री पर निर्भर रखता है, और उसका दस्तावेज़ीकरण ऐसी कोई शर्त वैश्विक फ़ोल्डर से नहीं जोड़ता। एक रिपोर्ट ने उस स्किल कैटलॉग पर आकार-सीमा बताई जिसे Zed मॉडल को भेजता है; Apothem ने इसकी पुष्टि नहीं की है, और न ही इसकी कि मॉडल इनवोकेशन बंद करने वाली स्किल उस सीमा में गिनी जाती है या नहीं। Apothem की स्किल के नाम और विवरण कुल मिलाकर लगभग 20 KB होते हैं। Apothem ने यह भी पुष्टि नहीं की है कि Zed किसी ऐसी SKILL.md हेडर कुंजी के साथ कैसा व्यवहार करता है जिसे वह सूचीबद्ध नहीं करता।

सत्यापनCopy Anchor Link

apothem verify --harness zed --project /path/to/project

verify कमांड पुष्टि करता है कि:

1. नेटिव कॉन्फ़िग अपेक्षित पथ पर मौजूद है।
2. हर प्रबंधित टारगेट मौजूद है; प्रबंधित फ़ाइलें खाली नहीं हैं, और JSON या YAML कॉन्फ़िग पार्स होते हैं। --profile PATH जोड़ने पर यह भी पुष्टि होती है कि इंस्टॉल की गई फ़ाइलें उस प्रोफ़ाइल से मेल खाती हैं।
3. हर Apothem स्किल फ़ोल्डर एक SKILL.md के साथ अपनी जगह पर है, चाहे उसे किसी भी इंस्टॉल ने लिखा हो, और Apothem नाम वाला कोई स्किल फ़ोल्डर ऐसी किसी चीज़ का नहीं है जिसे Apothem ने नहीं लिखा। विफल जाँच अनुपस्थित या बाहरी फ़ोल्डरों के नाम बताती है।
4. अडैप्टर-विशिष्ट सत्यापन रूटीन सफलता की रिपोर्ट करता है।

अपडेट करनाCopy Anchor Link

apothem update --harness zed --project /path/to/project

वर्तमान साझा प्रोफ़ाइल स्थिति से प्रोजेक्ट .rules फ़ाइल को पुनः व्युत्पन्न करता है।

अपडेट ऐसे किसी भी स्किल फ़ोल्डर को भी फिर से लिखता है जिसकी फ़ाइलें वर्तमान फ़ाइलों से भिन्न हैं। यदि आपने किसी पुराने रिलीज़ से इंस्टॉल किया था जिसने कोई स्किल नहीं लिखी, तो अपडेट उन्हें जोड़ता है।

अनइंस्टॉल करनाCopy Anchor Link

apothem uninstall --harness zed --project /path/to/project

नेटिव कॉन्फ़िग फ़ाइल .rules से Apothem का प्रबंधित ब्लॉक हटाता है और आपका अपना टेक्स्ट रखता है। फ़ाइल तभी हटाई जाती है जब उसमें कुछ और न बचे। बदलाव से पहले फ़ाइल की एक टाइमस्टैम्प-युक्त प्रति ~/.apothem/backups/ के अंतर्गत सहेजी जाती है; प्रोजेक्ट में कोई बैकअप फ़ाइल नहीं छोड़ी जाती। साझा प्रोफ़ाइल YAML और Apothem इंजन अप्रभावित रहते हैं।

अनइंस्टॉल ~/.agents/skills/ में अपने द्वारा लिखे गए स्किल फ़ोल्डर और ~/.config/apothem/ में नियम और टेम्पलेट भी हटाता है, लेकिन केवल तभी जब कोई अन्य Apothem इंस्टॉल अब भी उनका उपयोग न कर रहा हो। कोई अन्य प्रोजेक्ट, या फ़ोल्डर साझा करने वाला कोई अन्य टूल, ऐसा कर सकता है। उस स्थिति में अनइंस्टॉल फ़ोल्डर रखता है, प्रिंट करता है कि कौन-सा इंस्टॉल उनका उपयोग करता है, और अंतिम अनइंस्टॉल उन्हें हटाता है। उन फ़ोल्डरों में आपके द्वारा जोड़ी गई फ़ाइलें बनी रहती हैं, और खाली रह गया फ़ोल्डर हटा दिया जाता है। हर फ़ोल्डर को हटाए जाने से पहले ~/.apothem/backups/ के अंतर्गत उसका बैकअप लिया जाता है।

अनुरूपता गेटCopy Anchor Link

python -m apothem.conformity.gate --all .

समस्या निवारणCopy Anchor Link

कॉन्फ़िगरेशन नॉबCopy Anchor Link

यह भी देखेंCopy Anchor Link

• सभी हार्नेस — समर्थित टूल्स का पूरा कैटलॉग
• इंस्टॉल गाइड — इस हार्नेस में Apothem इंस्टॉल करें
• apothem harnesses संदर्भ — CLI से अडैप्टरों को सूचीबद्ध करें और उनका निरीक्षण करें