Trae

المورّد: ByteDance اسم التثبيت: trae الحالة: إصدار عام الإعداد الأصلي: <project>/.trae/rules/apothem-rules.md

التثبيتCopy Anchor Link

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

يكتب المحوّل ملف قواعد واحدًا لـ Trae على نطاق المشروع انطلاقًا من القواعد المشتركة لـ Apothem وسطح الحوكمة، ويكتب مساعِدات Apothem بوصفها عوامل فرعية لـ Trae في المشروع (راجع العوامل الفرعية).

ويكتب أيضًا مهارات Apothem، والقواعد والقوالب التي تستشهد بها، في دليلك المنزلي، قبل أن يمسّ المشروع (راجع الملفات خارج المشروع).

الملفات المكتوبة:

• <project>/.trae/rules/apothem-rules.md، ملف القواعد.
• <project>/.trae/agents/<name>.md لكل مساعِد من مساعِدات Apothem، في المشروع.
• ~/.trae/skills/<name>/SKILL.md لكل مهارة وأمر من Apothem، في دليلك المنزلي.
• ~/.config/apothem/rules/ و~/.config/apothem/templates/، في دليلك المنزلي.

الملفات خارج المشروعCopy Anchor Link

يكتب التثبيت أيضًا مهارات Apothem في دليلك المنزلي، قبل أن يغيّر أي شيء في المشروع:

هذه المجلّدات مشتركة، وليست خاصة بالمشروع:

• كل مشروع تثبّت فيه trae يستخدم النسخة نفسها من ~/.trae/skills/، ويكتب التثبيت فيها الملفات نفسها في كل مرة. وTrae هي الأداة الوحيدة التي تقرأ ذلك المجلّد. أما القواعد والقوالب تحت ~/.config/apothem/ فتكتبها تثبيتات الأدوات الأخرى أيضًا، بالملفات نفسها.
• يختار --project ملف القواعد الذي يُكتَب والمشروعَ الذي ينتمي إليه التثبيت. ولا يغيّر المكان الذي تذهب إليه المهارات.
• لا يضيف التثبيت أي ملف مهارة أو قاعدة إلى مستودعك. ويحصل المشروع على ملف القواعد وملفات العوامل الفرعية في .trae/agents/، إضافةً إلى مجلّد البيانات .apothem/ الذي يُنشئه كل تثبيت على مستوى المشروع.
• تُكتَب المجلّدات المنزلية أولًا. فإن فشل ذلك، مثلًا لأن مجلّدًا في المسار رابطٌ يخرج من دليلك المنزلي (أما الرابط الذي يبقى داخله فيُتَّبَع) أو لا يمكن الكتابة فيه، يتوقّف التثبيت مع الخطأ قبل أن يتغيّر أي شيء في المشروع.
• مجلّد المهارة الذي يحمل اسم مهارة من Apothem ولم يكتبه Apothem يُترَك كما هو، ويطبع التثبيت تحذيرًا يسمّيه. أعد تسميته أو انقله، ثم شغّل apothem update. ويفشل apothem verify ما دام ذلك الاسم محجوزًا.
• يبلغ مجموع الملفات بضعة ميغابايتات.

يطبع التثبيت ملاحظة تسمّي المجلّدات التي يكتبها خارج --project، ويسردها --dry-run.

العوامل الفرعيةCopy Anchor Link

تقرأ Trae العامل الفرعي من ملف Markdown في <project>/.trae/agents/، وفق وثائق العوامل الفرعية في Trae. ويكتب التثبيت ملفًا واحدًا لكل مساعِد من مساعِدات Apothem في ذلك المجلّد. وهو يثبّت للمشروع فقط: فالوثائق تذكر المجلّد على مستوى المستخدم بوصفه ~/.trae-cn/agents/ بينما يقع كل مجلّد مستخدم آخر لـ Trae تحت ~/.trae/، ولم يتحقّق Apothem من أيّهما يقرؤه التثبيت الدولي، فلا يكتب أيًّا منهما.

يُبقي كل ملف تعليمات المساعِد دون تغيير ويحمل مفاتيح البيانات الأمامية التالية:

لا تُكتَب إلا أسماء الأدوات الواردة في صفحة العوامل الفرعية في Trae:

Bash, Edit, Glob, Grep, Read, Skill, TodoWrite, WebFetch, WebSearch, Write, LSP

الأداة التي يسمّيها المصدر وليست في تلك القائمة (مثل MultiEdit أو PowerShell) تُستبعَد من كلا الحقلين. والأداة ذات النمط، مثل Bash(rm *)، ليس لها شكل في قائمة مفصولة بفواصل: فبوصفها أداة مسموحًا بها تُستبعَد، وبوصفها أداة محظورة تحظر الأداة كلها. والمساعِد الذي لا يستطيع تعديل الملفات يحتفظ بذلك القيد: فلا يسرد Write أو Edit بين أدواته ويحظرهما كليهما. ولا توثّق Trae أي حدّ للأدوار، لذا لا يُكتَب maxTurns الخاص بالمساعِد. ولا يكتب التثبيت أي مفتاح model، فيستخدم المساعِد النموذج المختار في مربع الدردشة، ولا أي مفتاح mcpServers.

أمور ينبغي معرفتها:

• تقول وثائق Trae الإنجليزية بتفعيل Settings > Beta > Subagents > Enable Subagents Directory قبل أن تُحمِّل .trae/agents/. وتقول صفحتها الصينية، المُحدَّثة لاحقًا، إن الميزة مفعّلة افتراضيًا في العادة. فإن لم تسرد Trae أيًّا من المساعِدات، فافحص ذلك المفتاح.
• ملفات العوامل الفرعية ملفات مشروع عادية. أودِعها مع المشروع أو أدرِج .trae/agents/ في .gitignore؛ ولا يختار Apothem نيابةً عنك.
• الملف الخاص بك الذي يحمل اسم مساعِد من Apothem يُحفَظ تحت ~/.apothem/backups/ ثم يُستبدَل. ولا يُعيده إلغاء التثبيت. ولا تُمَسّ الملفات ذات الأسماء الأخرى أبدًا.
• لا تذكر وثائق Trae كيف تتعامل مع مفتاح بيانات أمامية لا تسرده، ولا ما إذا كان .trae/agents/ يسري في النافذة الثانية من «all-new TRAE» المدمجة كما يسري في نافذة بيئة التطوير.

تعيين الملف التعريفي إلى الإعداد الأصليCopy Anchor Link

يقرأ المحوّل الملف التعريفي المشترك لـ Apothem ويُجسِّد ملف قواعد المشروع في كل تشغيل لـ apothem install أو apothem update. الملف التعريفي المشترك هو مصدر الحقيقة؛ وتُنسَخ التعديلات المحلّية للمشروع على الملف المُولَّد احتياطيًا قبل أن تستبدل المزامنة التالية المحتوى الذي يديره Apothem.

يبدأ الملف ببيانات أمامية بصيغة YAML تضبط alwaysApply: true وحقلًا description، وهو وضع Always Apply في Trae وفق وثائق قواعد Trae. وتليها الكتلة التي يديرها Apothem؛ ويُحتفَظ بالنص الذي تضيفه بعد الكتلة في كل مزامنة.

ملاحظات التوافقCopy Anchor Link

سطح القواعد الحالي في 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 لا تسرده.

التحقّقCopy Anchor Link

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

يؤكّد أمر التحقّق ما يلي:

1. الإعداد الأصلي موجود في المسار المتوقَّع.
2. كل هدف مُدار موجود، بما في ذلك المجلّد .trae/agents/؛ والملفات المُدارة غير فارغة، وتُحلَّل إعدادات JSON أو YAML. أضِف --profile PATH لتتحقّق كذلك من أن الملفات المثبّتة تطابق ذلك الملف التعريفي. وبالنسبة إلى .trae/agents/ يتحقّق الفحص من وجود المجلّد، لا من وجود كل ملف مساعِد فيه؛ ويسرد الأمر apothem diff --harness trae --project /path/to/project ملفات المساعِدات المفقودة أو القديمة.
3. كل مجلّد مهارة من Apothem في مكانه ومعه SKILL.md، أيًّا كان التثبيت الذي كتبه، ولا يوجد مجلّد مهارة يحمل اسمًا من Apothem ويعود إلى شيء لم يكتبه Apothem. ويسمّي الفحص الفاشل المجلّدات المفقودة أو الدخيلة.
4. روتين التحقّق الخاص بالمحوّل يُبلِغ عن النجاح.

التحديثCopy Anchor Link

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

يُعيد اشتقاق ملف قواعد المشروع من الحالة الراهنة للملف التعريفي المشترك.

ويُعيد التحديث أيضًا كتابة أي مجلّد مهارة تختلف ملفاته عن الملفات الحالية. وإن كنت قد ثبّتّ بإصدار سابق لم يكتب أي مهارات، فإن التحديث يضيفها. ويُعيد كتابة ملفات العوامل الفرعية التي تختلف عن الحالية، ويضيف أي ملفات مفقودة منها.

إلغاء التثبيتCopy Anchor Link

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

يُزيل كتلة Apothem، والبيانات الأمامية التي كتبها Apothem فوقها، من <project>/.trae/rules/apothem-rules.md ويُبقي أي نص آخر فيه. ولا يُحذَف الملف إلا حين لا يتبقى فيه شيء آخر. قبل التغيير تُحفَظ نسخة مختومة بالوقت من الملف تحت ~/.apothem/backups/؛ ولا يُترَك أي ملف نسخة احتياطية في المشروع. لا يتأثّر ملف YAML الخاص بالملف التعريفي المشترك ولا محرّك Apothem.

ويُزيل إلغاء التثبيت أيضًا ملفات العوامل الفرعية التي كتبها في <project>/.trae/agents/ ويُبقي أي ملف آخر هناك؛ ويُزال المجلّد حين يبقى فارغًا. ويُزيل مجلّدات المهارات التي كتبها في ~/.trae/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 — اسرد المحوّلات وافحصها من واجهة سطر الأوامر