Hermes Agent: سطر الأوامر (CLI)

آخر تحديث: 2026-08-31

سطر الأوامر هو أقوى طريقة لتشغيل Hermes Agent — جميع الميزات متاحة عبر CLI، مع دعم تكامل السكربتات والعمليات الدفعية وخطوط الأنابيب الآلية.

💡 نصيحة: CLI هي الطريقة الأكثر كفاءة للمطورين. سطح المكتب والويب يغطيان 80%، CLI يغطي 100%. سيناريوهات الأتمتة تتطلب CLI.

📋 المتطلبات المسبقة: الدرس 2 — التثبيت، الدرس 3 — ملفات الإعداد

1. ما ستتعلمه

# المحتوى
نظرة عامة على أوامر CLI
الأوامر الأساسية بالتفصيل
أوامر المحادثة والتفاعل
أوامر الإدارة والتشغيل
تكامل السكربتات والأتمتة

2. القصة

(1) المشكلة: عملية يدوية في كل مرة

Bob يوميًا: يفتح Hermes → يبدّل النموذج → يبدأ محادثة → يحفظ النتيجة → يرسل إشعارًا. 5 خطوات يدوية، مزعج وسهل النسيان.

(2) الحل: أمر واحد يحل

Alice كتبت سكربتًا يُنفَّذ تلقائيًا يوميًا:

BASH
#!/bin/bash
# daily-workflow.sh
hermes chat --model gpt-4o --skill daily-briefing --output report.md
hermes notify telegram --file report.md
hermes checkpoint save "daily-$(date +%Y%m%d)"

3. نظرة عامة على أوامر CLI

الفئة الأمر الوصف
الأساسية hermes chat محادثة تفاعلية
hermes serve بدء خدمة API
hermes run تنفيذ مهمة واحدة
الإعداد hermes init تهيئة
hermes config إدارة الإعداد
hermes model إدارة النماذج
الذاكرة hermes memory إدارة الذاكرة
المهارات hermes skill إدارة المهارات
الأدوات hermes tool إدارة الأدوات
المنصات hermes platform إدارة المنصات
Cron hermes cron مهام مجدولة
نقاط تفتيش hermes checkpoint إدارة نقاط التفتيش
التفويض hermes delegate تفويض المهام
الإضافات hermes plugin إدارة الإضافات
لوحة المعلومات hermes dashboard لوحة بيانات
Profile hermes profile إعداد المستخدم

4. الأوامر الأساسية بالتفصيل

(1) hermes chat

BASH
hermes chat
hermes chat --model gpt-4o
hermes chat --user alice
hermes chat --skill code-review
hermes chat --message "راجع src/main.py" --no-interactive
cat error.log | hermes chat --message "حلل سجل الأخطاء هذا"
hermes chat --toolset frontend-dev
hermes chat --output report.md

(2) hermes run

BASH
hermes run "ابحث عن ميزات React 19 وأنشئ ملخصًا"
hermes run --model gpt-4o --skill research "ابحث عن تغييرات Vue 4"
hermes run --delegate --max-sub-agents 3 "راجع جودة كود المشروع بالكامل"
hermes run --format json "حلل صيغة استجابة هذا API"

(3) hermes serve

BASH
hermes serve --host 0.0.0.0 --port 8080
hermes serve --daemon
hermes serve --config /path/to/config.yaml
hermes serve --platforms telegram,discord,slack

5. أوامر المحادثة والتفاعل

(1) أوامر داخل المحادثة

في hermes chat الوضع التفاعلي، الأوامر تبدأ بـ /:

الأمر الوظيفة
/learn <محتوى> تعليم مهارة جديدة للوكيل
/remember <محتوى> حفظ ذاكرة
/forget <id> حذف ذاكرة
/skill <اسم> استدعاء مهارة
/model <اسم> تبديل النموذج
/toolset <اسم> تبديل مجموعة الأدوات
/profile <اسم> تبديل المستخدم
/checkpoint save <اسم> حفظ نقطة تفتيش
/checkpoint restore <اسم> استعادة نقطة تفتيش
/delegate status عرض حالة التفويض
/honcho profile عرض ملف المستخدم
/cost عرض تكلفة الجلسة الحالية
/help مساعدة
/exit خروج

(2) اختصارات المحادثة

الاختصار الوظيفة
↑/↓ تصفح سجل الإدخال
Tab إكمال تلقائي
Ctrl+C مقاطعة العملية الحالية
Ctrl+D إنهاء المحادثة
Ctrl+L مسح الشاشة

6. أوامر الإدارة والتشغيل

BASH
hermes config show
hermes config get model.default
hermes config set model.default gpt-4o
hermes config validate

hermes model list
hermes model test gpt-4o

hermes doctor
hermes health
hermes --version

7. تكامل السكربتات والأتمتة

(1) تكامل Shell Script

BASH
#!/bin/bash
# تكامل CI/CD

hermes run --skill code-review --output review.md "راجع PR #$PR_NUMBER"

if grep -q "🔴 حرج" review.md; then
  echo "مشكلة حرجة، منع الدمج"
  exit 1
fi

hermes run --skill test-runner "شغّل مجموعة الاختبارات الكاملة"
hermes run --model gpt-4o --output CHANGELOG.md "أنشئ ملاحظات إطلاق من git log"

(2) تكامل Python

PYTHON
from hermes import HermesClient

client = HermesClient(base_url="http://localhost:8080")

response = client.chat(
    message="راجع جودة كود هذا الملف",
    model="gpt-4o",
    files=["src/main.py"]
)

print(response.text)

results = client.batch_run([
    {"message": "ابحث عن React 19", "model": "gpt-4o-mini"},
    {"message": "ابحث عن Vue 4", "model": "gpt-4o-mini"},
])

for r in results:
    print(f"Task: {r.task}, Cost: ${r.cost:.4f}")

(3) تكامل Makefile

MAKEFILE
.PHONY: review test deploy

review:
	hermes run --skill code-review "راجع جميع الملفات المعدلة"

test:
	hermes run --skill test-runner "شغّل مجموعة الاختبارات"

deploy: review test
	hermes run "انشر لبيئة staging"
	@echo "النشر مكتمل"

❓ أسئلة شائعة

س هل CLI يدعم Windows؟
ج نعم. PowerShell وCMD يعملان. بعض ميزات الأنابيب تعمل بشكل أفضل في WSL2.
س كيف أعرض مساعدة الأوامر؟
ج hermes --help للمساعدة العامة، hermes chat --help للأوامر الفرعية.
س الوضع غير التفاعلي لأي سيناريوهات؟
ج تكامل السكربتات، CI/CD، مهام مجدولة، معالجة دفعية. أتمتة بدون تفاعل بشري.
س كيف أنفذ مهام متعددة بالتوازي؟
ج خلفية Shell hermes run ... & أو Python متعدد الخيوط. CLI يدعم --delegate للتتوازي.
س أين سجلات CLI؟
ج الافتراضي ~/.hermes/logs/. hermes chat --verbose يعرض سجلات مفصلة فوريًا.

📖 ملخص


📝 تمارين

  1. أساسي (⭐): استخدم CLI لتدفق كامل: تهيئة → محادثة → حفظ نقطة تفتيش → عرض التكلفة.
  2. متوسط (⭐⭐): اكتب سكربت Shell يستخدم hermes run لأتمتة مراجعة كود + اختبارات + إنشاء تقرير.
  3. متقدم (⭐⭐⭐): طوّر سير عمل آلي بـ Python HermesClient: سحب يومي لسجلات Git → إنشاء تقرير يومي → إرسال إشعار، مدمج مع cron.
Web-Tutorial.com

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

100%