Windsurf
Windsurf (GA) के लिए Apothem हार्नेस अडैप्टर।
विक्रेता: Devin Desktop (पूर्व में Codeium Windsurf)
इंस्टॉल नाम: windsurf
स्थिति: GA
नेटिव कॉन्फ़िग: <project>/.devin/rules/apothem-rules.md
Windsurf अब Devin Desktop है, और .devin/rules/ पसंदीदा वर्कस्पेस-नियम स्थान है
(यह .windsurf/rules/ पर प्राथमिकता लेता है)।
इंस्टॉलेशन
apothem install --harness windsurf --project /path/to/projectअडैप्टर साझा Apothem नियमों और शासन सतह से प्रोजेक्ट-स्कोप वाली एक Windsurf नियम फ़ाइल लिखता है, प्रोजेक्ट में Apothem के ग्यारह सहायकों को Devin Local सबएजेंट के रूप में लिखता है (सबएजेंट देखें), और दो Devin Local हुक पंजीकृत करता है (हुक देखें)।
यह Apothem की स्किल, और वे जिन नियमों और टेम्पलेट का हवाला देती हैं, उन्हें भी प्रोजेक्ट को छूने से पहले आपकी होम डायरेक्टरी में लिखता है (प्रोजेक्ट के बाहर की फ़ाइलें देखें)।
लिखी गई फ़ाइलें:
<project>/.devin/rules/apothem-rules.md, नियम फ़ाइल।- प्रोजेक्ट में, ग्यारह Apothem सहायकों के लिए
<project>/.devin/agents/<name>.md। - प्रोजेक्ट में,
<project>/.devin/config.local.json, हुक पंजीकरण। उसमें आपकी अपनी प्रविष्टियाँ बनी रहती हैं। - प्रोजेक्ट में,
<project>/.apothem/support/windsurf/hooks/, हुक स्क्रिप्ट। - आपकी होम डायरेक्टरी में, हर Apothem स्किल और कमांड के लिए
~/.agents/skills/<name>/SKILL.md। - आपकी होम डायरेक्टरी में,
~/.config/apothem/rules/और~/.config/apothem/templates/।
प्रोजेक्ट के बाहर की फ़ाइलें
इंस्टॉल प्रोजेक्ट में कुछ भी बदलने से पहले Apothem की स्किल आपकी होम डायरेक्टरी में भी लिखता है:
| फ़ोल्डर | Apothem वहाँ क्या लिखता है |
|---|---|
~/.agents/skills/ | हर Apothem स्किल के लिए एक SKILL.md वाला एक फ़ोल्डर, और हर Apothem कमांड के लिए एक (कमांड उसी नाम की स्किल बन जाता है)। |
~/.config/apothem/rules/, ~/.config/apothem/templates/ | वे नियम और टेम्पलेट जिनका स्किल और नियम फ़ाइल उल्लेख करती हैं। |
ये फ़ोल्डर साझा हैं। ये प्रोजेक्ट के निजी नहीं हैं:
- हर वह प्रोजेक्ट जिसमें आप
windsurfइंस्टॉल करते हैं, और फ़ोल्डर का नाम लेने वाला हर अन्य Apothem इंस्टॉल, एक ही प्रति का उपयोग करता है और वही फ़ाइलें लिखता है, इसलिए आप किस क्रम में इंस्टॉल करते हैं इससे फ़र्क नहीं पड़ता। कई अन्य टूल भी~/.agents/skills/पढ़ते हैं; हार्नेस रजिस्ट्री उन्हें सूचीबद्ध करती है। --projectयह चुनता है कि कौन-सी नियम फ़ाइल लिखी जाए और इंस्टॉल किस प्रोजेक्ट का है। यह नहीं बदलता कि स्किल कहाँ जाती हैं।- इंस्टॉल आपकी रिपॉज़िटरी में कोई स्किल या नियम फ़ाइल नहीं जोड़ता। प्रोजेक्ट को
नियम फ़ाइल,
.devin/agents/में सबएजेंट फ़ाइलें,.devin/config.local.jsonमें हुक पंजीकरण मिलते हैं, साथ ही वह.apothem/फ़ोल्डर जो हर प्रोजेक्ट इंस्टॉल बनाता है, जिसमें हुक स्क्रिप्ट भी रहती हैं। - होम फ़ोल्डर पहले लिखे जाते हैं। यदि यह विफल होता है, उदाहरण के लिए क्योंकि पथ में कोई फ़ोल्डर ऐसा लिंक है जो आपकी होम डायरेक्टरी से बाहर जाता है (जो लिंक उसके भीतर रहता है, उसका अनुसरण किया जाता है) या लिखा नहीं जा सकता, तो इंस्टॉल प्रोजेक्ट में कुछ भी बदलने से पहले त्रुटि के साथ रुक जाता है।
- Apothem स्किल के नाम वाला कोई स्किल फ़ोल्डर जिसे Apothem ने नहीं लिखा, उसे
छोड़ दिया जाता है, और इंस्टॉल एक चेतावनी प्रिंट करता है जो उसका नाम बताती है।
उसका नाम बदलें या उसे स्थानांतरित करें, फिर
apothem updateचलाएँ। जब तक वह नाम घिरा रहता है,apothem verifyविफल रहता है। - फ़ाइलें कुल मिलाकर कुछ मेगाबाइट की होती हैं।
इंस्टॉल एक नोट प्रिंट करता है जो उन फ़ोल्डरों के नाम बताता है जिन्हें वह --project
के बाहर लिखता है, और --dry-run उन्हें सूचीबद्ध करता है।
सबएजेंट
Devin Local, जिस पर नए Devin Desktop टैब शुरू होते हैं,
Devin सबएजेंट दस्तावेज़ के अनुसार
<project>/.devin/agents/ में एक Markdown फ़ाइल से सबएजेंट पढ़ता है। पुराने मोड
Cascade में कोई सबएजेंट नहीं होते। इंस्टॉल उस फ़ोल्डर में Apothem के चौदह सहायकों
में से ग्यारह लिखता है। यह केवल प्रोजेक्ट के लिए इंस्टॉल करता है और कोई
उपयोगकर्ता-स्तर का सबएजेंट फ़ोल्डर नहीं लिखता (Linux और macOS पर
~/.config/devin/agents/, Windows पर %APPDATA%\devin\agents\)।
हर फ़ाइल सहायक के निर्देशों को अपरिवर्तित रखती है और ये फ़्रंट मैटर कुंजियाँ रखती है:
| कुंजी | Apothem क्या लिखता है |
|---|---|
name, description | सहायक का नाम और विवरण। |
allowed-tools | वे टूल जिनका सहायक उपयोग कर सकता है, Devin टूल नामों की सूची के रूप में: read, edit, grep, glob, exec (सहायक का Bash) और write। |
Devin में ऐसी कोई कुंजी नहीं है जो किसी टूल को वर्जित करे, इसलिए सहायक के अनुमत
टूल में से उसके वर्जित टूल घटाकर एक allowed-tools सूची बनती है। सहायक का Bash
Devin में exec है, और जिस टूल के लिए Devin का कोई सूचीबद्ध नाम नहीं है, उसे छोड़
दिया जाता है। केवल-पठन सहायकों को read, glob और grep मिलते हैं, साथ ही कमांड
चलाने वाले सहायकों को exec, और कभी write या edit नहीं।
तीन सहायक इंस्टॉल नहीं किए जाते: citation-auditor, fact-checker और
research-scout। उन्हें वेब खोज और वेब फ़ेच की आवश्यकता होती है, और Devin दोनों में
से किसी के लिए कोई allowed-tools नाम प्रलेखित नहीं करता, इसलिए इंस्टॉल ऐसा
संस्करण लिखने के बजाय जो शोध नहीं कर सकता, या ऐसा जिसके पास हर टूल हो, उन्हें रोक
लेता है। .devin/agents/ में उन नामों में से किसी नाम वाली आपकी फ़ाइल को कभी नहीं
छुआ जाता।
इंस्टॉल कोई model कुंजी नहीं लिखता। Devin सबएजेंट को अपने डिफ़ॉल्ट सबएजेंट मॉडल
पर चलाता है, जो उसे शुरू करने वाले सत्र का मॉडल नहीं है। यह कोई max-nesting भी
नहीं लिखता, और Apothem की maxTurns, version, updated और portability
कुंजियों में से कोई भी नहीं।
जानने योग्य बातें:
- कस्टम सबएजेंट प्रायोगिक हैं। Devin प्रारूप और विकल्पों को परिवर्तन के अधीन बताता
है, और Devin Desktop में Devin Settings में एक Subagents (Preview) स्विच है
(Devin CLI सेटिंग
subagents_enabledडिफ़ॉल्ट रूप से चालू है)। - सबएजेंट फ़ाइलें सामान्य प्रोजेक्ट फ़ाइलें हैं। उन्हें प्रोजेक्ट के साथ कमिट करें या
.gitignoreमें.devin/agents/सूचीबद्ध करें; Apothem आपके लिए यह नहीं चुनता। - Apothem सहायक के नाम वाली आपकी कोई फ़ाइल
~/.apothem/backups/के अंतर्गत सहेजी जाती है और फिर बदल दी जाती है। अनइंस्टॉल उसे वापस नहीं रखता। अन्य नामों वाली फ़ाइलों को कभी नहीं छुआ जाता। - Devin साझा
.agents/agents/फ़ोल्डर भी पढ़ता है, जिसे Apothem कभी नहीं लिखता, और Devin CLI पथ बताए बिना एक.claude/फ़ोल्डर से सबएजेंट का आयात प्रलेखित करता है। Devin Local अपनी फ़ाइलें उसी तरह ढूँढता है जैसे Devin CLI, इसलिए वह आयात वहाँ भी लागू होता है। - Apothem ने वेब टूल के लिए
allowed-toolsनामों की,modelकौन-से मान स्वीकार करता है इसकी, या खालीallowed-toolsसूची कैसे पढ़ी जाती है इसकी पुष्टि नहीं की है।
हुक
Devin Local Devin हुक दस्तावेज़
के अनुसार अपनी कॉन्फ़िग फ़ाइलों की hooks कुंजी से हुक चलाता है। इंस्टॉल दो हुक
पंजीकृत करता है:
| इवेंट | क्या चलता है |
|---|---|
SessionStart | सत्र बूटस्ट्रैप: सत्र मेटाडेटा, स्किल इंडेक्स, मेमोरी और प्लान सारांश और स्थायी मुद्रा, मॉडल के संदर्भ में जोड़े जाते हैं। |
PostToolUse (हर टूल) | सक्रिय-कॉम्पैक्शन ट्रैकर। यह गतिविधि गिनता है और, हर कॉम्पैक्शन चक्र में अधिकतम दो बार, मॉडल से अपनी स्थिति सहेजने या कॉम्पैक्ट करने को कहता है। अन्यथा यह मौन रहता है। |
दोनों मॉडल के लिए संदर्भ जोड़ते हैं। कोई भी किसी टूल कॉल या सत्र को अवरुद्ध नहीं करता।
Apothem Devin पर कोई PreToolUse गार्ड पंजीकृत नहीं करता। Devin के दस्तावेज़
additionalContext (वह फ़ील्ड जिसके माध्यम से Apothem के गार्ड बोलते हैं) को
UserPromptSubmit, SessionStart और PostToolUse के लिए सूचीबद्ध करते हैं, और
PreToolUse के लिए केवल एक निर्णय और एक इनपुट पुनर्लेखन सूचीबद्ध करते हैं। वहाँ
पंजीकृत गार्ड हर टूल कॉल पर एक प्रोसेस आरंभ की लागत लेगा और शायद कुछ भी न पहुँचाए,
इसलिए write, edit और shell गार्ड, AskUserQuestion जाँच और सत्र-समाप्ति
प्रोटोकॉल उन टूल्स पर रहते हैं जो उन्हें पहुँचाते हैं। Apothem किसी Devin इवेंट पर
गार्ड तब पंजीकृत करेगा जब दस्तावेज़, या कोई प्रोब, दिखाए कि वह मॉडल तक पहुँचता है।
ये Devin Local हुक हैं। पुराना Cascade मोड एक अलग हुक प्रारूप
(.devin/hooks.json) पढ़ता है, जिसे इंस्टॉल नहीं लिखता।
फ़ाइलें कहाँ जाती हैं
| फ़ाइल | उसमें क्या है |
|---|---|
<project>/.devin/config.local.json | दो हुक पंजीकरण, फ़ाइल की hooks कुंजी में विलय किए गए। Devin इस फ़ाइल को स्थानीय ओवरराइड और gitignored के रूप में प्रलेखित करता है, और .git/info/exclude के माध्यम से स्थानीय कॉन्फ़िग फ़ाइलों को स्वयं git से बाहर रखता है। |
<project>/.apothem/support/windsurf/hooks/ | डिस्पैचर स्क्रिप्ट, उसके हेल्पर और उसकी संदेश फ़ाइलें। |
हर पंजीकृत कमांड उस इंटरप्रेटर का नाम बताता है जो Apothem को चलते समय मिला, और
प्रोजेक्ट का पूर्ण पथ, इसलिए यह मशीन-विशिष्ट है। इसीलिए इंस्टॉल स्थानीय फ़ाइल
लिखता है और कभी साझा <project>/.devin/config.json, स्टैंडअलोन
.devin/hooks.v1.json या .claude/ सेटिंग्स नहीं लिखता। इंस्टॉल .gitignore
संपादित नहीं करता। Devin अपनी स्थानीय कॉन्फ़िग फ़ाइलों को स्वयं git से बाहर रखता है
(.git/info/exclude के माध्यम से), इसलिए किसी साथी के चेकआउट को ऐसे कमांड नहीं
मिलते जो आपकी मशीन की ओर इशारा करते हैं; जाँचें कि आपकी .gitignore में
.apothem/ सूचीबद्ध है।
पथ जिन्हें शेल गलत पढ़ेगा। $, बैकटिक, दोहरा उद्धरण चिह्न या बैकस्लैश वाला
कोई प्रोजेक्ट या इंटरप्रेटर पथ कुछ भी लिखे जाने से पहले अस्वीकार कर दिया जाता है:
उद्धृत कमांड के भीतर वह कोई अलग फ़ाइल चलाएगा, या उस JSON को तोड़ देगा जिसमें
कमांड लिखा जाता है। त्रुटि पथ का नाम बताती है; प्रोजेक्ट को स्थानांतरित करें या
उसका नाम बदलें और इंस्टॉल फिर से चलाएँ। पथ में स्पेस या अपॉस्ट्रॉफ़ी ठीक है।
कमांड ऐसा दिखता है, दोनों पथों की जगह आपके इंटरप्रेटर और प्रोजेक्ट पथ के साथ:
"/path/to/python" "/path/to/project/.apothem/support/windsurf/hooks/dispatch.py" --contract devin SessionStart--contract devin Devin के लोअरकेस टूल नामों (exec, write, edit,
read, grep, glob) को उन नामों पर मैप करता है जिनकी Apothem के हैंडलर जाँच
करते हैं, और आउटपुट को उसी एनवेलप के रूप में छोड़ता है जिसे Claude Code पढ़ता है।
कोई मैचर नहीं लिखा जाता: Devin का मैचर एक रेगुलर एक्सप्रेशन है, छोड़ा गया मैचर हर
टूल से मेल खाता है, और SessionStart के पास मिलान करने के लिए कोई टूल नहीं है।
इंस्टॉल के बाद जाँचने योग्य बातें
- जब वर्कस्पेस Restricted Mode में होता है, तब Devin कोई हुक नहीं चलाता। पहले वर्कस्पेस को विश्वसनीय (trust) करें।
- यह देखने के लिए कि हुक लोड हुए या नहीं, Devin Local के Customizations में Hooks
टैब खोलें, या Devin CLI में
/hooksचलाएँ। दोनों हर हुक को उसकी स्रोत फ़ाइल के साथ सूचीबद्ध करते हैं। - Devin के दस्तावेज़ Windows पर हुक कमांड के लिए कोई शेल नहीं बताते। कमांड
shउद्धरण-शैली का उपयोग करते हैं, जिसे PowerShell कॉल ऑपरेटर के बिना पार्स नहीं करेगा। Apothem ने पुष्टि नहीं की है कि Devin Local Windows पर क्या चलाता है; यदि हुक वहाँ लोड नहीं होते, तो किसी issue में बताएँ।
Devin वे हुक भी चलाता है जो Claude Code ने लिखे। जब तक
read_config_from.claude चालू है, Devin ~/.claude/settings.json,
.claude/settings.json और .claude/settings.local.json के हुक लोड करता है, और
यही इसका डिफ़ॉल्ट है: Devin Local अपनी फ़ाइलें उसी तरह ढूँढता है जैसे Devin CLI।
यदि आपने Claude Code के लिए भी Apothem इंस्टॉल किया है,
तो हुक के दोनों सेट चल सकते हैं। यहाँ का SessionStart कमांड और उसकी Claude Code
प्रति Apothem के हुक स्थिति फ़ोल्डर में प्रति सत्र एक मार्कर साझा करते हैं, इसलिए जो
भी दूसरे क्रम पर चलता है वह मौन रहता है और बूटस्ट्रैप मॉडल तक एक बार पहुँचता है;
Apothem Devin को उस DEVIN_PROJECT_DIR वेरिएबल से पहचानता है जिसे Devin अपने हुक
के लिए सेट करता है। मार्कर दस सेकंड तक लागू रहता है, इसलिए उसी सत्र का बाद का
आरंभ फिर भी पहुँचाता है। संदर्भ-आकार काउंटर दोनों जगह चलता है, इसलिए उसकी सीमाएँ
जल्दी पहुँच जाती हैं, और Apothem काउंटरों का दोहराव नहीं हटाता। केवल ये हुक लोड
करने के लिए, अपनी उपयोगकर्ता कॉन्फ़िग (~/.config/devin/config.json, या Windows पर
%APPDATA%\devin\config.json) में या प्रोजेक्ट की .devin/config.json में
"read_config_from" के अंतर्गत "claude": false सेट करें; इससे Devin का Claude
Code के नियम, स्किल, कमांड और MCP सर्वर आयात करना भी रुक जाता है। इंस्टॉल इसे एक
नोट के रूप में प्रिंट करता है।
आपके अपने हुक। पंजीकरण आपकी फ़ाइल में कुंजी के अनुसार विलय किया जाता है। आपके
लिखे हुक और अन्य कुंजियाँ जैसी थीं वैसी रहती हैं, उसी इवेंट के अंतर्गत आपका कोई
हैंडलर Apothem के हैंडलर के साथ बना रहता है, और अपडेट केवल उन हैंडलरों को बदलता है
जिनका कमांड Apothem डिस्पैचर चलाता है (--contract devin के साथ
.apothem/support/windsurf/hooks/dispatch.py, चाहे वह किसी भी प्रोजेक्ट पथ के
अंतर्गत लिखा गया हो)। आपका कोई हुक जो केवल नाम साझा करता है, या जो
python -m apothem.conformity.gate चलाता है, उसे कभी Apothem का नहीं समझा जाता।
टिप्पणियों या अन्य JSON5 सिंटैक्स वाली फ़ाइल को उन्हें खोए बिना फिर से नहीं लिखा जा
सकता, इसलिए इंस्टॉल उस फ़ाइल के लिए config.unparseable त्रुटि रिपोर्ट करता है,
उसे अछूता छोड़ता है और रुक जाता है, और जिन अन्य फ़ाइलों को उसने लिखना शुरू किया था
उन्हें फिर से हटा देता है: टिप्पणियाँ हटाएँ, या दोनों प्रविष्टियाँ स्वयं जोड़ें।
हुक बंद करना। Apothem हुक को मौन करने के लिए Devin के परिवेश में
APOTHEM_HOOKS_DISABLE=1 सेट करें।
प्रोफ़ाइल-से-नेटिव-कॉन्फ़िग मैपिंग
अडैप्टर Apothem की साझा प्रोफ़ाइल पढ़ता है और हर apothem install या
apothem update रन पर प्रोजेक्ट नियम फ़ाइल रेंडर करता है। साझा प्रोफ़ाइल सत्य
का स्रोत है; जनित फ़ाइल में किए गए प्रोजेक्ट-स्थानीय संपादनों का बैकअप अगली
सिंक द्वारा Apothem-प्रबंधित सामग्री को बदलने से पहले ले लिया जाता है।
फ़ाइल अपने trigger: always_on फ़्रंट मैटर से शुरू होती है, जो नियम का सक्रियण
मोड सेट करता है। Apothem-प्रबंधित ब्लॉक उसके बाद आता है; ब्लॉक के बाद आप जो
टेक्स्ट जोड़ते हैं, वह हर सिंक पर बना रहता है।
संगतता टिप्पणियाँ
Windsurf की वर्तमान नियम सतह .devin/rules/ के अंतर्गत प्रोजेक्ट-स्कोप वाली है
(पसंदीदा स्थान, जो .windsurf/rules/ पश्च-संगतता फ़ॉलबैक पर प्राथमिकता लेता
है)। वर्कफ़्लो और मशीन-स्थानीय मेमोरी ऑपरेटर-स्वामित्व वाली हैं; Apothem उन्हें
नहीं लिखता, और न ही Cascade हुक फ़ाइल और न ही साझा Devin कॉन्फ़िग। एकल-फ़ाइल
.windsurfrules रूप जानबूझकर नहीं लिखा जाता।
Devin Desktop (Windsurf) ~/.agents/skills/ खोजता है, इसलिए इंस्टॉल द्वारा लिखी
गई स्किल बिना किसी अतिरिक्त सेटअप के दिखाई देती हैं। इसका Claude Code आयात, जो
डिफ़ॉल्ट रूप से चालू है, स्किल केवल प्रोजेक्ट के .claude/skills/ फ़ोल्डर से पढ़ता
है, इसलिए यह प्रलेखित नहीं है कि Claude Code के लिए किया गया Apothem इंस्टॉल
~/.claude/skills/ में जो स्किल लिखता है, वे वहाँ भी दिखाई देती हैं। Apothem ने पुष्टि नहीं की है कि
Windsurf किसी ऐसी SKILL.md हेडर कुंजी के साथ कैसा व्यवहार करता है जिसे वह
सूचीबद्ध नहीं करता; स्किल user-invocable, disable-model-invocation,
allowed-tools, argument-hint, और एक metadata मैप रखती हैं।
सत्यापन
apothem verify --harness windsurf --project /path/to/projectverify कमांड पुष्टि करता है कि:
- नेटिव कॉन्फ़िग अपेक्षित पथ पर मौजूद है।
- हर प्रबंधित टारगेट मौजूद है,
.devin/agents/फ़ोल्डर और हुक पंजीकरण.devin/config.local.jsonसहित; प्रबंधित फ़ाइलें खाली नहीं हैं, और JSON या YAML कॉन्फ़िग पार्स होते हैं। हुक फ़ाइल में एक ऐसा हैंडलर होना चाहिए जो Apothem डिस्पैचर चलाता है (जाँच उसे चलाती नहीं), इसलिए जो फ़ाइल पहले जैसी लौटा दी गई या खाली कर दी गई, वह अब सत्यापित नहीं होती।--profile PATHजोड़ने पर यह भी पुष्टि होती है कि इंस्टॉल की गई फ़ाइलें उस प्रोफ़ाइल से मेल खाती हैं।.devin/agents/के लिए जाँच यह है कि फ़ोल्डर मौजूद है, यह नहीं कि हर सहायक फ़ाइल उसमें है; कमांडapothem diff --harness windsurf --project /path/to/projectउन सहायक फ़ाइलों को सूचीबद्ध करता है जो अनुपस्थित या पुरानी हैं। - हर Apothem स्किल फ़ोल्डर एक
SKILL.mdके साथ अपनी जगह पर है, चाहे उसे किसी भी इंस्टॉल ने लिखा हो, और Apothem नाम वाला कोई स्किल फ़ोल्डर ऐसी किसी चीज़ का नहीं है जिसे Apothem ने नहीं लिखा। विफल जाँच अनुपस्थित या बाहरी फ़ोल्डरों के नाम बताती है। - अडैप्टर-विशिष्ट सत्यापन रूटीन सफलता की रिपोर्ट करता है।
अपडेट करना
apothem update --harness windsurf --project /path/to/projectवर्तमान साझा प्रोफ़ाइल स्थिति से प्रोजेक्ट नियम फ़ाइल को पुनः व्युत्पन्न करता है।
अपडेट ऐसे किसी भी स्किल फ़ोल्डर को भी फिर से लिखता है जिसकी फ़ाइलें वर्तमान फ़ाइलों से भिन्न हैं।
यदि आपने किसी पुराने रिलीज़ से इंस्टॉल किया था जिसने कोई स्किल नहीं लिखी, तो अपडेट उन्हें जोड़ता है।
यह उन सबएजेंट फ़ाइलों को फिर से लिखता है जो वर्तमान फ़ाइलों से भिन्न हैं, और जो अनुपस्थित हैं उन्हें जोड़ता है।
यह हुक स्क्रिप्ट और .devin/config.local.json में Apothem हैंडलरों को भी ताज़ा करता
है, आपकी अपनी प्रविष्टियों को अछूता छोड़ते हुए।
अनइंस्टॉल करना
apothem uninstall --harness windsurf --project /path/to/project<project>/.devin/rules/apothem-rules.md से Apothem ब्लॉक, और उसके ऊपर Apothem
द्वारा लिखा गया फ़्रंट मैटर, हटाता है और उसमें मौजूद अन्य सारा पाठ रखता है। फ़ाइल
केवल तभी हटाई जाती है जब उसमें और कुछ शेष न रहे। बदलाव से पहले फ़ाइल की एक
समय-मुद्रित प्रति ~/.apothem/backups/ के अंतर्गत सहेजी जाती है; प्रोजेक्ट में कोई
बैकअप फ़ाइल नहीं छोड़ी जाती। साझा प्रोफ़ाइल YAML और Apothem इंजन अप्रभावित रहते
हैं।
अनइंस्टॉल <project>/.devin/agents/ में अपने द्वारा लिखी गई सबएजेंट फ़ाइलें भी
हटाता है और वहाँ की किसी भी अन्य फ़ाइल को रखता है; खाली रह जाने पर फ़ोल्डर हटा
दिया जाता है। यह <project>/.devin/config.local.json से Apothem हुक हैंडलर हटाता
है, उन्हें उनके कमांड में डिस्पैचर पथ से पहचानते हुए, और आपके अपने हुक और कुंजियाँ
रखता है। फ़ाइल केवल तभी हटाई जाती है जब उसे Apothem ने बनाया हो और उसमें और कुछ
शेष न रहे। <project>/.apothem/support/windsurf/hooks/ में हुक स्क्रिप्ट भी हटा दी
जाती हैं। यह ~/.agents/skills/ में अपने द्वारा लिखे गए स्किल फ़ोल्डर और
~/.config/apothem/ में नियम और टेम्पलेट हटाता है, लेकिन केवल तभी जब कोई अन्य
Apothem इंस्टॉल अब भी उनका उपयोग न कर रहा हो। कोई अन्य प्रोजेक्ट, या फ़ोल्डर साझा
करने वाला कोई अन्य टूल, ऐसा कर सकता है। उस स्थिति में अनइंस्टॉल फ़ोल्डर रखता है,
प्रिंट करता है कि कौन-सा इंस्टॉल उनका उपयोग करता है, और अंतिम अनइंस्टॉल उन्हें हटाता
है। उन फ़ोल्डरों में आपके द्वारा जोड़ी गई फ़ाइलें बनी रहती हैं, और खाली रह गया
फ़ोल्डर हटा दिया जाता है। हर फ़ोल्डर को हटाए जाने से पहले ~/.apothem/backups/
के अंतर्गत उसका बैकअप लिया जाता है।
अनुरूपता गेट
python -m apothem.conformity.gate --all .समस्या निवारण
| लक्षण | समाधान |
|---|---|
| कॉन्फ़िग फ़ाइल नहीं मिली | apothem install --harness windsurf --project /path/to/project फिर से चलाएँ |
| सत्यापन विफल रहा | apothem update --harness windsurf --project /path/to/project चलाएँ, फिर दोबारा सत्यापित करें |
| Devin Local कोई भी Apothem सहायक सूचीबद्ध नहीं करता | apothem diff --harness windsurf --project /path/to/project चलाएँ। .devin/agents फ़ोल्डर के लिए कोई लंबित पंक्ति का अर्थ है कि सहायक फ़ाइलें अनुपस्थित या पुरानी हैं, इसलिए apothem update --harness windsurf --project /path/to/project चलाएँ। apothem verify इसकी जाँच नहीं है: यह तब पास होता है जब .devin/agents/ मौजूद हो, भले ही उसमें कोई सहायक फ़ाइल न हो। यदि diff कोई लंबित परिवर्तन रिपोर्ट नहीं करता, तो जाँचें कि Subagents (Preview) सेटिंग चालू है और प्रोजेक्ट Devin Desktop के Local मोड में खुला है, फिर एक नया टैब शुरू करें |
| Apothem हुक नहीं चलते | Restricted Mode वाले वर्कस्पेस में Devin कोई हुक नहीं चलाता: वर्कस्पेस को विश्वसनीय (trust) करें। यह देखने के लिए कि Apothem प्रविष्टियाँ लोड हुईं या नहीं, Devin Local के Customizations में Hooks टैब खोलें, या Devin CLI में /hooks चलाएँ। Windows पर Apothem ने पुष्टि नहीं की है कि Devin हुक कमांड किस शेल में चलाता है |
कोई इंस्टॉल config.local.json के लिए config.unparseable रिपोर्ट करता है | फ़ाइल में टिप्पणियाँ या अन्य सिंटैक्स है जो पुनर्लेखन में खो जाएगा। टिप्पणियाँ हटाएँ और फिर से इंस्टॉल करें, या दोनों Apothem हुक प्रविष्टियाँ स्वयं जोड़ें |
| Apothem संदर्भ दो बार दिखाई देता है, या संदर्भ-आकार अनुस्मारक जल्दी आता है | Devin वे हुक भी चलाता है जो Claude Code इंस्टॉल ने लिखे। केवल .devin/config.local.json के हुक लोड करने के लिए अपनी Devin कॉन्फ़िग में "read_config_from" के अंतर्गत "claude": false सेट करें |
apothem verify किसी अनुपस्थित स्किल फ़ोल्डर का नाम बताता है | apothem install --harness windsurf --project /path/to/project चलाएँ; यह फ़ोल्डर को पुनर्स्थापित करता है |
| कोई इंस्टॉल या अपडेट चेतावनी देता है कि उसने एक स्किल फ़ोल्डर छोड़ दिया | Apothem स्किल के नाम वाला एक फ़ोल्डर स्किल फ़ोल्डर में पहले से मौजूद है और उसे Apothem ने नहीं लिखा। उसका नाम बदलें या उसे स्थानांतरित करें, फिर apothem update चलाएँ |
| कोई इंस्टॉल प्रोजेक्ट बदलने से पहले रुक जाता है | आपकी होम डायरेक्टरी में कोई लेखन विफल रहा। त्रुटि पढ़ें, उसमें नामित फ़ोल्डर ठीक करें (ऐसा लिंक जो आपकी होम डायरेक्टरी से बाहर जाता है, फ़ोल्डर की जगह कोई फ़ाइल, या केवल-पठन फ़ोल्डर), और फिर से इंस्टॉल करें |
| अप्रत्याशित कॉन्फ़िग सामग्री | ~/.config/apothem/profile.yaml या --profile PATH जाँचें, फिर apothem update --harness windsurf --project /path/to/project फिर से चलाएँ |
कॉन्फ़िगरेशन नॉब
| फ़्लैग | डिफ़ॉल्ट | विवरण |
|---|---|---|
--dry-run | false | फ़ाइलें लिखे बिना इंस्टॉल का पूर्वावलोकन करें। |
यह भी देखें
- सभी हार्नेस — समर्थित टूल्स का पूरा कैटलॉग
- इंस्टॉल गाइड — इस हार्नेस में Apothem इंस्टॉल करें
apothem harnessesसंदर्भ — CLI से अडैप्टरों को सूचीबद्ध करें और उनका निरीक्षण करें