نبضات الجلسة — المهام الطويلة تبقى نشطة
نبضات الجلسة — المهام الطويلة تبقى نشطة — دليل سهل الفهم بناءً على الوثائق الرسمية
تخيّل أنك تعمل مع مساعدٍ مجتهد لا يقف خلفك طوال الوقت، لكنه بين الحين والآخر، يلقي نظرة خاطفة بهدوء على الشيء الذي طلبتَ منه مراقبته — ولا يتكلم إلا عندما يتغيّر شيء فعليًا. هذا هو الواقع اليومي لأمر /heartbeat: فهو يتيح للذكاء الاصطناعي “إلقاء نظرة رجعية” على مهمة ما وفقًا لجدول زمني، وكل ذلك ضمن نفس المحادثة.
ما هو؟
/heartbeat يضبط تذكيرًا متكررًا لجلسة العمل الحالية. عندما تكون المحادثة خاملة وينتهي الوقت المحدد، يرسل الذكاء الاصطناعي رسالة إلى نفسه — تمامًا كما لو كان مستخدمًا عاديًا. النقطة الأساسية: إنه لا يقاطع أبدًا مهمة قيد التنفيذ. بل يتسلل فقط خلال “لحظة تنفس”، باستخدام رسالة مستخدم عادية، ولا يغيّر أي إعدادات في النظام.
ما الفرق بينه وبين Cron؟
/heartbeat |
hermes cron |
|
|---|---|---|
| السياق | المحادثة الحالية — ذاكرة وسياق كاملان | جلسة جديدة ومعزولة في كل مرة |
| بعد إعادة التشغيل | الحالة محفوظة في قاعدة البيانات، وتُستأنف لاحقًا | ثابتة بشكل كامل |
| العدد | واحد لكل جلسة | غير محدود |
| الأنسب لـ | “راقب هذا الموضوع” | مهام مستقلة، تقارير مجدولة |
قاعدة سريعة للتذكير: إذا كان التذكير يعتمد على خلفية المحادثة، استخدم /heartbeat. أما إذا كانت المهمة مستقلة تمامًا، فاستخدم cron.
الأوامر الأساسية
# ضبط نبضة (فحص النشر كل 10 دقائق)
/heartbeat every 10m Check the deployment and report meaningful changes
# عرض الحالة الحالية
/heartbeat status
# إيقاف مؤقت (بدون حذف)
/heartbeat pause
# استئناف (يعاد ضبط المؤقت، ولن يعمل فورًا)
/heartbeat resume
# إزالة نهائيًا
/heartbeat clear
/hb هو اختصار مفيد. الفترات المدعومة: 90s، 10m، 2h، 1d (الحد الأدنى 60 ثانية).
تفاصيل صغيرة مدروسة
- يعمل فقط عندما تكون خاملًا — إذا كان الذكاء الاصطناعي مشغولًا، تنتظر النبضة بصبر. لا قفز في الطابور.
- لا تراكم — إذا مرّت عدة دورات دون تفعيل، يتم إرسال رسالة واحدة فقط. لا تكدس.
- رسائل المستخدم لها الأولوية — رسائلك دائمًا تتفوق على النبضة.
- لا عمل زائد — رسائل النبضة تحمل تعليمات مدمجة: “إذا لم يتغير شيء، ردّ باختصار.” لا حاجة لتزييف النشاط.
مثال من الواقع
You: /heartbeat every 15m Check whether the CI run for PR #1234 finished; summarize the result when it does
♥ Heartbeat set (every 15m): check CI for PR #1234; summarize when done
[15 minutes later, you’re busy with something else]
Hermes: [heartbeat triggered]
💻 gh pr checks 1234 (1.2s)
CI passed ✅ All tests green
الخلاصة ونصائح عملية
/heartbeat يشبه منبهًا ذكيًا لمحادثتك — يتذكر السياق، ويحترم إيقاعك، ولا ينبّهك إلا عندما يكون الأمر مهمًا. أفضل حالة استخدام: سيناريوهات “راقب بينما أعمل” — انتظار نشر، مراقبة شذوذ في السجلات، أو متابعة مستجدات نقاش. فقط تذكر: إذا كانت المهمة مستقلة تمامًا عن المحادثة الحالية، فإن cron هو الخيار الأأمن. أما إذا كان الأمر يتعلق بـ“البقاء على اطلاع بهذا الموضوع”، فإن النبضة هي شريكك المثالي.
📖 التوثيق الرسمي
この記事は Hermes Agent のالتوثيق الرسميに基づいています:التوثيق الرسمي › user-guide/features/heartbeat