تحرير الملف التعريفي

الهدف: غيّر قيمة في الملف التعريفي المشترك وادفعها إلى كل إطار عمل ثبّتّه.

المتطلّبات المسبقةCopy Anchor Link

• واجهة apothem على PATH لديك (أو الصورة القائمة بذاتها: صدّر بـ PYTHONPATH="$HOME/.apothem/src" وشغّل python -m apothem، أو استخدم npx @ahmed-g-gad/apothem).
• ملف تعريفي في ~/.config/apothem/profile.yaml. أنشئ واحدًا عبر apothem profile init إن كان مفقودًا.

شكل الملف التعريفيCopy Anchor Link

الملف التعريفي مستند YAML واحد. مفاتيحه عالية المستوى:

• identity (مطلوب) — name، بالإضافة إلى اختيارية role، email، website، github.
• preferences — language، style (concise / verbose / balanced), formatter، test_framework.
• rules — قائمة بسلاسل قواعد إضافية تُشارَك مع أُطُر العمل القادرة.
• seriousness — واحد من EXPLORING، PERSONAL_USE، SHARED, PUBLIC_LAUNCH.
• enforcement — مفاتيح تشغيل اختيارية (sprints، agent_teams، multitasking, continuous_execution، learning_loop)، وكل راية معطّلة افتراضيًا.
• harnesses — تجاوزات لكل إطار عمل مفهرسة بمُعرّف إطار العمل.
• exclude_harnesses — مُعرّفات أُطُر عمل تتخطّاها الأوامر الدفعية (--harness all).
• mcp_servers — تعريفات خوادم MCP مفهرسة باسم الخادم.
• agent_mcp_servers — لكل اسم مساعِد، خوادم MCP التي يجوز لذلك المساعِد استدعاؤها (انظر منح مساعِد الوصول إلى خوادم MCP). فارغ افتراضيًا، لذا لا يصل أيّ مساعِد إلى أداة MCP.
• workspace — المكان الذي يحفظ فيه Apothem دليل العمل المشترك الخاص به (directory_name، scope).
• schema_version — إصدار اختياري لمخطط الملف التعريفي؛ والملف التعريفي الذي يخلو منه يُقرأ على أنه الإصدار 1.

كل حقل مُدرَج في حقول الملف التعريفي.

الخطواتCopy Anchor Link

1. افحص الملف التعريفي الحالي:

   Copy Text

   apothem profile show

2. حرّره. افتحه في محرّر نظامك:

   Copy Text

   apothem profile edit

   أو عيّن مفتاحًا منقّطًا واحدًا من سطر الأوامر. تُخزَّن القيمة حرفيًا (باستثناء true/false والإدخال الصريح [..]/{..}، فهذه تُحلَّل) ويُتحقّق من الملف التعريفي مقابل المخطط قبل الكتابة — يُرفض التعيين غير الصالح ويبقى الملف التعريفي على القرص دون تغيير:

   Copy Text

   apothem profile set seriousness SHARED
   apothem profile set identity.name "Ada Lovelace"

3. أعد تجسيد أُطُر العمل لكي يصل التغيير إلى تهيئتها الأصلية. لإطار عمل بنطاق المستخدم:

   Copy Text

   apothem update --harness claude-code

   لإطار عمل بنطاق المشروع، مرّر جذر المشروع؛ استخدم all لتحديث كل إطار عمل مثبَّت:

   Copy Text

   apothem update --harness cursor --project /path/to/project
   apothem update --harness all --project /path/to/project

التحققCopy Anchor Link

apothem profile show
apothem verify --harness all

يعكس profile show تحريرك.

يتحقّق apothem verify --harness all من كل إطار عمل مُسجَّل، عدا ما يُدرجه exclude_harnesses من الملف التعريفي، فيخرج برمز غير صفري ما لم تكن كل الأُطُر الأخرى مثبّتة. وأُطُر العمل ذات نطاق المشروع تحتاج أيضًا إلى --project PATH؛ ومن دونه تتوقّف الدُفعة بخطأ project.required. وللتحقّق من إطار العمل الذي حدّثته وحده، شغّل الأمر نفسه مع اسم ذلك الإطار:

apothem verify --harness <name>

وللحصول على نظرة شاملة للنظام تتسامح مع أُطُر العمل غير المثبّتة، شغّل apothem doctor.

ذات صلةCopy Anchor Link

• أضف إطار عمل لإخضاع إطار عمل جديد لتحكّم الملف التعريفي قبل إعادة التجسيد.
• يغطّي التحديث ترقية المحرّك جنبًا إلى جنب مع خطوة إعادة التجسيد.