Hermes

المورّد: Hermes اسم التثبيت: hermes الحالة: معاينة الإعداد الأصلي: ~/.hermes/config.yaml

التثبيتCopy Anchor Link

apothem install --harness hermes

يترجم المحوّل الملف التعريفي المشترك إلى ملف الإعداد العامّ على مستوى المستخدم لـ Hermes Agent، ويثبّت حزم دعم Apothem تحت جذر إطار العمل.

الملفات المكتوبة: ~/.hermes/config.yaml، ووثيقة الملف التعريفي ~/.hermes/apothem/rules/00-apothem-profile.md، وملفات الدعم تحت ~/.hermes/.apothem/support/

تنتهي وثيقة الملف التعريفي بقسم ملفات دعم Apothem الذي يُسمّي الدليل المطلق الواقع تحت ~/.hermes/.apothem/support/ الذي تُحَلّ نسبةً إليه كل إحالة بأسلوب المستودع (rules/<name>.md، وtemplates/...، وhooks/...).

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

يقرأ المحوّل الملف التعريفي المشترك لـ Apothem ويُجسِّد إعداد YAML الأصلي، بما في ذلك جرد MCP الوارد في الملف التعريفي. وتأتي خوادم MCP من قسم mcp_servers في الملف التعريفي؛ وتُجسَّد في config.yaml عند كل تثبيت وتحديث، ولا تُنسَخ ملفات. ويضيف المحوّل أيضًا ~/.hermes/.apothem/support/skills إلى skills.external_dirs، وهي قائمة أدلّة المهارات الإضافية التي يقرؤها Hermes، وبها يعثر Hermes على المهارات المُثبَّتة. ويأتي المُدخَل بعد أي مُدخَلات تسردها أصلًا، وتبقى مفاتيحك الأخرى كما هي. وتذهب هوية الملف التعريفي وتفضيلاته وقواعده إلى وثيقة الملف التعريفي. وتستقرّ الأوامر المشتركة والمهارات وتعريفات المساعِدات والقواعد والقوالب ومطالبات الخطّافات بوصفها مادة دعم تحت ~/.hermes/.apothem/support/.

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

محوّل في مرحلة المعاينة. يُحمِّل Hermes مهارات Apothem عبر skills.external_dirs، لكنه لا يُحمِّل بقية شجرة الدعم ولا وثيقة الملف التعريفي من تلقاء نفسه: لا شيء آخر في config.yaml ولا أيّ من ملفات السياق التي يقرؤها Hermes يُشير إليهما، لذا يعمل Hermes بعد التثبيت دون قواعد Apothem أو خطّافاته.

تعارض الأسماء. يوثّق Hermes ترتيب الأسبقية التالي للمهارات: مهارات المشروع (<project>/.hermes/skills/ و<project>/.agents/skills/)، ثم ~/.hermes/skills/، ثم skills.create_dir، ثم المجلّدات المُدرَجة تحت skills.external_dirs. ودليل Apothem مُدخَل في external_dirs، لذا يأتي أخيرًا. ولا تذكر وثائق Hermes التي رُوجِعت أيّ نسخة يُحمِّلها Hermes حين يحوي موقعان مهارةً بالاسم نفسه؛ ويقرأ Apothem الترتيب على أن المواقع الأسبق تفوز، لذا توقّع أن المهارة التي تحمل الاسم نفسه وتحتفظ بها في موقع أسبق تسبق نسخة Apothem. ولا يكتب Apothem إلا في config.yaml وتحت ~/.hermes/.apothem/support/، ولا يكتب أبدًا في تلك المواقع الأسبق، لذا لا يستبدل التثبيت والتحديث وإلغاء التثبيت مهارةً تحتفظ بها هناك.

يحتفظ apothem update بالمفاتيح التي تضيفها إلى config.yaml، بما فيها skills.config ومُدخَلات skills.external_dirs الخاصة بك. يكتب المحوّل جرد MCP الوارد في الملف التعريفي تحت المفتاح mcp_servers في المستوى الأعلى، حيث يقرأ Hermes خوادم MCP. كانت إصدارات Apothem السابقة تكتبه تحت auxiliary.mcp، الذي يقرؤه Hermes بوصفه النموذج المساعد لتوزيع أدوات MCP؛ ويُزيل كلٌّ من apothem update وapothem uninstall تلك الكتلة حين لا تزال تطابق ما كان سيكتبه مثل ذلك الإصدار من ملفك التعريفي المشترك الراهن (راجع إلغاء التثبيت لمعرفة متى تبقى). (سلوك Hermes وفق صفحات دليل المستخدم الخاص به عن المهارات، المقروءة في 2026-10-24، وMCP، المقروءة في 2026-10-02.)

التعليقات في config.yaml. يُعيد Apothem كتابة الملف بمكتبة YAML تُسقِط التعليقات. وحين يحمل الملف تعليقات خاصة بك ويكون المُدخَل مفقودًا، يترك Apothem الملف دون مساس ويتوقّف التثبيت برسالة تسمّي المفتاح. أضِف المُدخَل بنفسك، ثم شغّل التثبيت مجدّدًا:

skills:
  external_dirs:
    - ~/.hermes/.apothem/support/skills

المُدخَل الذي تضيفه بنفسك يُعَدّ مُدخَلك: فإن كنت تسرد هذا الدليل أصلًا، يُبقي Apothem مُدخَلك كما هو ويتركه إلغاء التثبيت في مكانه.

التحقّقCopy Anchor Link

apothem verify --harness hermes

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

1. الإعداد الأصلي موجود في المسار المتوقَّع.
2. كل هدف مُدار موجود؛ والملفات المُدارة غير فارغة، وتُحلَّل إعدادات JSON أو YAML. أضِف --profile PATH لتتحقّق كذلك من أن الملفات المثبّتة تطابق ذلك الملف التعريفي.
3. يسرد skills.external_dirs في الإعداد الأصلي ~/.hermes/.apothem/support/skills. فمن دون ذلك المُدخَل لا يُحمِّل Hermes المهارات المُثبَّتة؛ ويُعيد apothem update إضافته.
4. روتين التحقّق الخاص بالمحوّل يُبلِغ عن النجاح.

التحديثCopy Anchor Link

apothem update --harness hermes

يُعيد اشتقاق الإعداد الأصلي من الحالة الراهنة للملف التعريفي المشترك؛ ويبقى مُدخَل Apothem في skills.external_dirs مسرودًا مرة واحدة مهما تكرّر التحديث. شغّله بعد تحرير ~/.config/apothem/profile.yaml أو ترقية حزمة Apothem المُثبَّتة.

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

apothem uninstall --harness hermes

يُزيل ما أضافه المحوّل: مدخلات mcp_servers ومُدخَل skills.external_dirs اللذين سجّلهما تثبيته في config.yaml (تبقى مفاتيحك الخاصة، بما فيها مُدخَلات external_dirs الخاصة بك وskills.config، ولا يُحذَف الملف إلا حين يكون Apothem قد أنشأه ولم يتبقَّ فيه شيء يخصّك)، ووثيقة الملف التعريفي، وشجرة الدعم. لا يتأثّر ملف YAML الخاص بالملف التعريفي المشترك ولا محرّك Apothem.

التثبيت الذي أجراه إصدار سابق، وكان يكتب خوادم الملف التعريفي تحت auxiliary.mcp، تُزال منه تلك الكتلة أيضًا حين لا تزال تطابق ما كان ذلك الإصدار سيكتبه من ملفك التعريفي المشترك الراهن في ~/.config/apothem/profile.yaml. هذه هي القاعدة نفسها التي يطبّقها apothem update، لذا لا يُخلِّف إلغاء التثبيت دون تحديث مسبق أي كتلة متقادمة ما دامت خوادم MCP الواردة في الملف التعريفي لم تتغيّر. أما الكتلة التي عدّلتها، أو التي لم تعد تطابق خوادم MCP في ملفك التعريفي الراهن، أو التي لا يوجد ملف تعريفي مشترك قابل للقراءة لمقارنتها به، فتبقى في مكانها، وتبقى بقية إعدادات auxiliary الخاصة بك دائمًا.

بوابة المطابقةCopy Anchor Link

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

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

مفاتيح الضبطCopy Anchor Link

انظر أيضًاCopy Anchor Link

• كل أُطُر العمل — الفهرس الكامل للأدوات المدعومة
• دليل التثبيت — ثبّت Apothem في إطار العمل هذا
• مرجع apothem harnesses — اسرد المحوّلات وافحصها من واجهة سطر الأوامر