Trae
Trae (GA) के लिए Apothem हार्नेस अडैप्टर।
विक्रेता: ByteDance
इंस्टॉल नाम: trae
स्थिति: GA
नेटिव कॉन्फ़िग: <project>/.trae/rules/apothem-rules.md
इंस्टॉलेशन
apothem install --harness trae --project /path/to/projectअडैप्टर साझा Apothem नियमों और शासन सतह से प्रोजेक्ट-स्कोप वाली एक Trae नियम फ़ाइल लिखता है, और प्रोजेक्ट में Apothem के सहायकों को Trae सबएजेंट के रूप में लिखता है (सबएजेंट देखें)।
यह Apothem की स्किल, और वे जिन नियमों और टेम्पलेट का हवाला देती हैं, उन्हें भी प्रोजेक्ट को छूने से पहले आपकी होम डायरेक्टरी में लिखता है (प्रोजेक्ट के बाहर की फ़ाइलें देखें)।
लिखी गई फ़ाइलें:
<project>/.trae/rules/apothem-rules.md, नियम फ़ाइल।- प्रोजेक्ट में, हर Apothem सहायक के लिए
<project>/.trae/agents/<name>.md। - आपकी होम डायरेक्टरी में, हर Apothem स्किल और कमांड के लिए
~/.trae/skills/<name>/SKILL.md। - आपकी होम डायरेक्टरी में,
~/.config/apothem/rules/और~/.config/apothem/templates/।
प्रोजेक्ट के बाहर की फ़ाइलें
इंस्टॉल प्रोजेक्ट में कुछ भी बदलने से पहले Apothem की स्किल आपकी होम डायरेक्टरी में भी लिखता है:
| फ़ोल्डर | Apothem वहाँ क्या लिखता है |
|---|---|
~/.trae/skills/ | हर Apothem स्किल के लिए एक SKILL.md वाला एक फ़ोल्डर, और हर Apothem कमांड के लिए एक (कमांड उसी नाम की स्किल बन जाता है)। |
~/.config/apothem/rules/, ~/.config/apothem/templates/ | वे नियम और टेम्पलेट जिनका स्किल और नियम फ़ाइल उल्लेख करती हैं। |
ये फ़ोल्डर साझा हैं। ये प्रोजेक्ट के निजी नहीं हैं:
- हर वह प्रोजेक्ट जिसमें आप
traeइंस्टॉल करते हैं,~/.trae/skills/की एक ही प्रति का उपयोग करता है, और इंस्टॉल हर बार उसमें वही फ़ाइलें लिखता है। उस फ़ोल्डर को केवल Trae पढ़ता है।~/.config/apothem/के अंतर्गत नियम और टेम्पलेट अन्य टूल्स के इंस्टॉल भी उन्हीं फ़ाइलों के साथ लिखते हैं। --projectयह चुनता है कि कौन-सी नियम फ़ाइल लिखी जाए और इंस्टॉल किस प्रोजेक्ट का है। यह नहीं बदलता कि स्किल कहाँ जाती हैं।- इंस्टॉल आपकी रिपॉज़िटरी में कोई स्किल या नियम फ़ाइल नहीं जोड़ता। प्रोजेक्ट को
नियम फ़ाइल और
.trae/agents/में सबएजेंट फ़ाइलें मिलती हैं, साथ ही वह.apothem/डेटा फ़ोल्डर जो हर प्रोजेक्ट इंस्टॉल बनाता है। - होम फ़ोल्डर पहले लिखे जाते हैं। यदि यह विफल होता है, उदाहरण के लिए क्योंकि पथ में कोई फ़ोल्डर ऐसा लिंक है जो आपकी होम डायरेक्टरी से बाहर जाता है (जो लिंक उसके भीतर रहता है, उसका अनुसरण किया जाता है) या लिखा नहीं जा सकता, तो इंस्टॉल प्रोजेक्ट में कुछ भी बदलने से पहले त्रुटि के साथ रुक जाता है।
- Apothem स्किल के नाम वाला कोई स्किल फ़ोल्डर जिसे Apothem ने नहीं लिखा, उसे
छोड़ दिया जाता है, और इंस्टॉल एक चेतावनी प्रिंट करता है जो उसका नाम बताती है।
उसका नाम बदलें या उसे स्थानांतरित करें, फिर
apothem updateचलाएँ। जब तक वह नाम घिरा रहता है,apothem verifyविफल रहता है। - फ़ाइलें कुल मिलाकर कुछ मेगाबाइट की होती हैं।
इंस्टॉल एक नोट प्रिंट करता है जो उन फ़ोल्डरों के नाम बताता है जिन्हें वह --project
के बाहर लिखता है, और --dry-run उन्हें सूचीबद्ध करता है।
सबएजेंट
Trae सबएजेंट दस्तावेज़ के अनुसार, Trae
<project>/.trae/agents/ में एक Markdown फ़ाइल से सबएजेंट पढ़ता है। इंस्टॉल उस
फ़ोल्डर में हर Apothem सहायक के लिए एक फ़ाइल लिखता है। यह केवल प्रोजेक्ट के लिए
इंस्टॉल करता है: दस्तावेज़ उपयोगकर्ता-स्तर का फ़ोल्डर ~/.trae-cn/agents/ बताते
हैं जबकि Trae का हर अन्य उपयोगकर्ता फ़ोल्डर ~/.trae/ के अंतर्गत है, और Apothem ने
पुष्टि नहीं की है कि अंतरराष्ट्रीय इंस्टॉल इनमें से कौन-सा पढ़ता है, इसलिए यह दोनों
में से कोई भी नहीं लिखता।
हर फ़ाइल सहायक के निर्देशों को अपरिवर्तित रखती है और ये फ़्रंट मैटर कुंजियाँ रखती है:
| कुंजी | Apothem क्या लिखता है |
|---|---|
name, description | सहायक का नाम और विवरण। Trae को दोनों की आवश्यकता है। |
tools | सहायक के अनुमत टूल, एक अल्पविराम-पृथक स्ट्रिंग के रूप में। |
disallowedTools | वे टूल जो सहायक के लिए वर्जित हैं, एक अल्पविराम-पृथक स्ट्रिंग के रूप में। Trae इसे tools के ऊपर लागू करता है। जब सहायक के पास कोई नहीं होता, तो छोड़ दिया जाता है। |
केवल Trae के सबएजेंट पृष्ठ पर दिए गए टूल नाम लिखे जाते हैं:
Bash, Edit, Glob, Grep, Read, Skill, TodoWrite, WebFetch, WebSearch, Write, LSPस्रोत द्वारा नामित कोई टूल जो उस सूची में नहीं है (उदाहरण के लिए MultiEdit या
PowerShell), दोनों फ़ील्ड से बाहर रखा जाता है। पैटर्न वाले किसी टूल, जैसे
Bash(rm *), का अल्पविराम सूची में कोई रूप नहीं है: अनुमत टूल के रूप में उसे बाहर
रखा जाता है, और वर्जित टूल के रूप में वह पूरे टूल को वर्जित करता है। जो सहायक
फ़ाइलें संपादित नहीं कर सकता, वह यह सीमा बनाए रखता है: वह अपने टूल में कोई Write
या Edit सूचीबद्ध नहीं करता और दोनों को वर्जित करता है। Trae कोई टर्न सीमा
प्रलेखित नहीं करता, इसलिए सहायक का maxTurns नहीं लिखा जाता। इंस्टॉल कोई model
कुंजी नहीं लिखता, इसलिए सहायक चैट बॉक्स में चुने गए मॉडल का उपयोग करता है, और कोई
mcpServers कुंजी नहीं लिखता।
जानने योग्य बातें:
- Trae के अंग्रेज़ी दस्तावेज़ कहते हैं कि
.trae/agents/लोड करने से पहले Settings > Beta > Subagents > Enable Subagents Directory चालू करें। इसका चीनी पृष्ठ, जो बाद में अपडेट हुआ, कहता है कि यह सुविधा आमतौर पर डिफ़ॉल्ट रूप से चालू रहती है। यदि Trae कोई भी सहायक सूचीबद्ध नहीं करता, तो वह स्विच जाँचें। - सबएजेंट फ़ाइलें सामान्य प्रोजेक्ट फ़ाइलें हैं। उन्हें प्रोजेक्ट के साथ कमिट करें या
.gitignoreमें.trae/agents/सूचीबद्ध करें; Apothem आपके लिए यह नहीं चुनता। - Apothem सहायक के नाम वाली आपकी कोई फ़ाइल
~/.apothem/backups/के अंतर्गत सहेजी जाती है और फिर बदल दी जाती है। अनइंस्टॉल उसे वापस नहीं रखता। अन्य नामों वाली फ़ाइलों को कभी नहीं छुआ जाता। - Trae के दस्तावेज़ यह नहीं बताते कि वह किसी ऐसी फ़्रंट मैटर कुंजी के साथ कैसा
व्यवहार करता है जिसे वह सूचीबद्ध नहीं करता, या क्या
.trae/agents/विलय किए गए "all-new TRAE" की दूसरी विंडो में वैसे ही लागू होता है जैसे IDE विंडो में।
प्रोफ़ाइल-से-नेटिव-कॉन्फ़िग मैपिंग
अडैप्टर Apothem की साझा प्रोफ़ाइल पढ़ता है और हर apothem install या
apothem update रन पर प्रोजेक्ट नियम फ़ाइल रेंडर करता है। साझा प्रोफ़ाइल सत्य
का स्रोत है; जनित फ़ाइल में किए गए प्रोजेक्ट-स्थानीय संपादनों का बैकअप अगली
सिंक द्वारा Apothem-प्रबंधित सामग्री को बदलने से पहले ले लिया जाता है।
फ़ाइल YAML फ़्रंट मैटर से शुरू होती है, जो alwaysApply: true और एक
description सेट करता है; Trae नियम दस्तावेज़
के अनुसार यह Trae का Always Apply मोड है। Apothem-प्रबंधित ब्लॉक उसके बाद आता है;
ब्लॉक के बाद आप जो टेक्स्ट जोड़ते हैं, वह हर सिंक पर बना रहता है।
संगतता टिप्पणियाँ
Trae की वर्तमान नियम सतह .trae/rules/ के अंतर्गत प्रोजेक्ट-स्कोप वाली है;
वैश्विक नियम ~/.trae/user_rules के अंतर्गत रहते हैं। अडैप्टर एक समर्पित
apothem-rules.md फ़ाइल लिखता है और उस डायरेक्टरी की अन्य नियम फ़ाइलों या आपके
वैश्विक नियमों को कभी अधिलेखित नहीं करता। .trae/mcp.json टूल-सर्वर सतह और
प्रोजेक्ट की .trae/skills/ स्किल सतह ऑपरेटर-स्वामित्व वाली हैं; Apothem उन्हें
नहीं लिखता।
Trae वैश्विक स्किल के लिए ~/.trae/skills/ प्रलेखित करता है। यह क्रॉस-टूल
.agents/skills/ फ़ोल्डर केवल तभी पढ़ता है जब सेटिंग Enable .agents Skills Directory चालू की गई हो, इसलिए इंस्टॉल Trae फ़ोल्डर लिखता है। चीन संस्करण
(TRAE CN) इसके बजाय ~/.trae-cn/skills/ प्रलेखित करता है; इसका चेंजलॉग कहता है
कि TRAE CN और अंतरराष्ट्रीय संस्करण की वैश्विक स्किल डायरेक्टरियाँ संगत हैं, केवल
व्यक्तिगत संस्करण के लिए। इंस्टॉल केवल ~/.trae/skills/ लिखता है, और Apothem ने
पुष्टि नहीं की है कि अन्य TRAE CN संस्करण उसे पढ़ते हैं या नहीं। Apothem ने यह भी
पुष्टि नहीं की है कि Trae किसी ऐसी SKILL.md हेडर कुंजी के साथ कैसा व्यवहार करता है
जिसे वह सूचीबद्ध नहीं करता।
सत्यापन
apothem verify --harness trae --project /path/to/projectverify कमांड पुष्टि करता है कि:
- नेटिव कॉन्फ़िग अपेक्षित पथ पर मौजूद है।
- हर प्रबंधित टारगेट मौजूद है,
.trae/agents/फ़ोल्डर सहित; प्रबंधित फ़ाइलें खाली नहीं हैं, और JSON या YAML कॉन्फ़िग पार्स होते हैं।--profile PATHजोड़ने पर यह भी पुष्टि होती है कि इंस्टॉल की गई फ़ाइलें उस प्रोफ़ाइल से मेल खाती हैं।.trae/agents/के लिए जाँच यह है कि फ़ोल्डर मौजूद है, यह नहीं कि हर सहायक फ़ाइल उसमें है; कमांडapothem diff --harness trae --project /path/to/projectउन सहायक फ़ाइलों को सूचीबद्ध करता है जो अनुपस्थित या पुरानी हैं। - हर Apothem स्किल फ़ोल्डर एक
SKILL.mdके साथ अपनी जगह पर है, चाहे उसे किसी भी इंस्टॉल ने लिखा हो, और Apothem नाम वाला कोई स्किल फ़ोल्डर ऐसी किसी चीज़ का नहीं है जिसे Apothem ने नहीं लिखा। विफल जाँच अनुपस्थित या बाहरी फ़ोल्डरों के नाम बताती है। - अडैप्टर-विशिष्ट सत्यापन रूटीन सफलता की रिपोर्ट करता है।
अपडेट करना
apothem update --harness trae --project /path/to/projectवर्तमान साझा प्रोफ़ाइल स्थिति से प्रोजेक्ट नियम फ़ाइल को पुनः व्युत्पन्न करता है।
अपडेट ऐसे किसी भी स्किल फ़ोल्डर को भी फिर से लिखता है जिसकी फ़ाइलें वर्तमान फ़ाइलों से भिन्न हैं। यदि आपने किसी पुराने रिलीज़ से इंस्टॉल किया था जिसने कोई स्किल नहीं लिखी, तो अपडेट उन्हें जोड़ता है। यह उन सबएजेंट फ़ाइलों को फिर से लिखता है जो वर्तमान फ़ाइलों से भिन्न हैं, और जो अनुपस्थित हैं उन्हें जोड़ता है।
अनइंस्टॉल करना
apothem uninstall --harness trae --project /path/to/project<project>/.trae/rules/apothem-rules.md से Apothem ब्लॉक, और उसके ऊपर Apothem
द्वारा लिखा गया फ़्रंट मैटर, हटाता है और उसमें मौजूद अन्य सारा पाठ रखता है। फ़ाइल
केवल तभी हटाई जाती है जब उसमें और कुछ शेष न रहे। बदलाव से पहले फ़ाइल की एक
समय-मुद्रित प्रति ~/.apothem/backups/ के अंतर्गत सहेजी जाती है; प्रोजेक्ट में कोई
बैकअप फ़ाइल नहीं छोड़ी जाती। साझा प्रोफ़ाइल YAML और Apothem इंजन अप्रभावित रहते
हैं।
अनइंस्टॉल <project>/.trae/agents/ में अपने द्वारा लिखी गई सबएजेंट फ़ाइलें भी
हटाता है और वहाँ की किसी भी अन्य फ़ाइल को रखता है; खाली रह जाने पर फ़ोल्डर हटा
दिया जाता है। यह ~/.trae/skills/ में अपने द्वारा लिखे गए स्किल फ़ोल्डर और
~/.config/apothem/ में नियम और टेम्पलेट हटाता है, लेकिन केवल तभी जब कोई अन्य
Apothem इंस्टॉल अब भी उनका उपयोग न कर रहा हो। कोई अन्य प्रोजेक्ट, या फ़ोल्डर साझा
करने वाला कोई अन्य टूल, ऐसा कर सकता है। उस स्थिति में अनइंस्टॉल फ़ोल्डर रखता है,
प्रिंट करता है कि कौन-सा इंस्टॉल उनका उपयोग करता है, और अंतिम अनइंस्टॉल उन्हें हटाता
है। उन फ़ोल्डरों में आपके द्वारा जोड़ी गई फ़ाइलें बनी रहती हैं, और खाली रह गया
फ़ोल्डर हटा दिया जाता है। हर फ़ोल्डर को हटाए जाने से पहले ~/.apothem/backups/
के अंतर्गत उसका बैकअप लिया जाता है।
अनुरूपता गेट
python -m apothem.conformity.gate --all .समस्या निवारण
| लक्षण | समाधान |
|---|---|
| कॉन्फ़िग फ़ाइल नहीं मिली | apothem install --harness trae --project /path/to/project फिर से चलाएँ |
| सत्यापन विफल रहा | apothem update --harness trae --project /path/to/project चलाएँ, फिर दोबारा सत्यापित करें |
| Trae कोई भी Apothem सहायक सूचीबद्ध नहीं करता | Settings > Beta > Subagents > Enable Subagents Directory चालू करें, फिर एक नई चैट शुरू करें |
apothem verify किसी अनुपस्थित स्किल फ़ोल्डर का नाम बताता है | apothem install --harness trae --project /path/to/project चलाएँ; यह फ़ोल्डर को पुनर्स्थापित करता है |
| कोई इंस्टॉल या अपडेट चेतावनी देता है कि उसने एक स्किल फ़ोल्डर छोड़ दिया | Apothem स्किल के नाम वाला एक फ़ोल्डर स्किल फ़ोल्डर में पहले से मौजूद है और उसे Apothem ने नहीं लिखा। उसका नाम बदलें या उसे स्थानांतरित करें, फिर apothem update चलाएँ |
| कोई इंस्टॉल प्रोजेक्ट बदलने से पहले रुक जाता है | आपकी होम डायरेक्टरी में कोई लेखन विफल रहा। त्रुटि पढ़ें, उसमें नामित फ़ोल्डर ठीक करें (ऐसा लिंक जो आपकी होम डायरेक्टरी से बाहर जाता है, फ़ोल्डर की जगह कोई फ़ाइल, या केवल-पठन फ़ोल्डर), और फिर से इंस्टॉल करें |
| अप्रत्याशित कॉन्फ़िग सामग्री | ~/.config/apothem/profile.yaml या --profile PATH जाँचें, फिर apothem update --harness trae --project /path/to/project फिर से चलाएँ |
कॉन्फ़िगरेशन नॉब
| फ़्लैग | डिफ़ॉल्ट | विवरण |
|---|---|---|
--dry-run | false | फ़ाइलें लिखे बिना इंस्टॉल का पूर्वावलोकन करें। |
यह भी देखें
- सभी हार्नेस — समर्थित टूल्स का पूरा कैटलॉग
- इंस्टॉल गाइड — इस हार्नेस में Apothem इंस्टॉल करें
apothem harnessesसंदर्भ — CLI से अडैप्टरों को सूचीबद्ध करें और उनका निरीक्षण करें