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 يعرض سجلات مفصلة فوريًا.📖 ملخص
- CLI يغطي 100% من الميزات، الطريقة الأكثر كفاءة للمطورين
hermes chatللمحادثة،hermes runلمهمة واحدة،hermes serveلخدمة API- أوامر
/في المحادثة: مهارات، ذاكرة، نموذج، نقاط تفتيش - أوامر إدارة: config، model، health، doctor
- تكامل سكربتات: Shell، Python، Makefile لخطوط أنابيب آلية
📝 تمارين
- أساسي (⭐): استخدم CLI لتدفق كامل: تهيئة → محادثة → حفظ نقطة تفتيش → عرض التكلفة.
- متوسط (⭐⭐): اكتب سكربت Shell يستخدم
hermes runلأتمتة مراجعة كود + اختبارات + إنشاء تقرير. - متقدم (⭐⭐⭐): طوّر سير عمل آلي بـ Python HermesClient: سحب يومي لسجلات Git → إنشاء تقرير يومي → إرسال إشعار، مدمج مع cron.