CodeBuddy

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

التثبيت

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

يكتب المحوّل ملفّ قواعد واحدًا بنطاق المشروع من سطح القواعد والحوكمة المشترك لـApothem.

الملفات المكتوبة: <project>/.codebuddy/rules/apothem-rules.md

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

يقرأ المحوّل الملف التعريفي المشترك لـApothem ويصيّر ملفّ قواعد المشروع في كل عملية apothem install أو apothem update. يقرأ CodeBuddy كل ملفّ *.md تحت .codebuddy/rules/ بوصفه Markdown مع بيانات أمامية YAML اختيارية (alwaysApply، وpaths، وenabled) وفق توثيق CodeBuddy Rules؛ ويحمل ملفّ Apothem القيمة alwaysApply: true، لذا يُطبَّق سطح الحوكمة في كل تفاعل. الملف التعريفي المشترك هو مصدر الحقيقة؛ وتُحفَظ نسخة احتياطية من التعديلات المحلية للمشروع على الملف المُولَّد قبل أن تستبدل المزامنة التالية المحتوى المُدار بواسطة Apothem.

ملاحظات التوافق

سطح قواعد CodeBuddy بنطاق المشروع تحت .codebuddy/rules/. يكتب المحوّل ملفًّا مخصّصًا باسم apothem-rules.md يتعايش مع أي ملفات قواعد يكتبها المشغّل في الدليل نفسه. ملفّ ذاكرة المشروع CODEBUDDY.md و .codebuddy/settings.json (الأذونات، وMCP) يملكهما المشغّل؛ ولا يكتبهما Apothem. تُذكَر المهارات والأوامر والوكلاء والخطافات بوصفها انضباطًا داخل ملفّ القواعد — ولا يكشف CodeBuddy أي سطح ملفات يملكه المحوّل لأجلها. اتفاقيات سطح المورّد التي يعتمد عليها المحوّل مثبّتة في src/apothem/harnesses/codebuddy/STANDARD-CONVENTION-PIN.md، ومأخوذة كلقطة مقابل توثيق CodeBuddy الحيّ.

التحقّق

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

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

1. وجود الإعداد الأصلي في المسار المتوقَّع.
2. وجود ملفّ القواعد المُدار وأنّه غير فارغ.
3. إبلاغ روتين التحقّق الخاص بالمحوّل عن النجاح.

التحديث

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

يعيد اشتقاق ملفّ قواعد المشروع من حالة الملف التعريفي المشترك الحالية. install وupdate عمليتان عَدِيمتا الأثر التراكمي — تؤدّي إعادة التشغيل إلى الكتابة فوق الملف المُدار بأحدث محتوى مُصيَّر.

إلغاء التثبيت

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

يزيل ملفات الإعداد الأصلية التي كتبها المحوّل، مع إعادة تسمية ملفّ القواعد المُدار إلى نسخة احتياطية ذات طابع زمني. لا يتأثّر YAML الملف التعريفي المشترك ولا محرّك Apothem.

بوّابة المطابقة

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

استكشاف الأخطاء وإصلاحها

مفاتيح الضبط