يعرض Home Assistant عبارة «تم التشغيل بنجاح»، فلماذا لم يضئ المصباح؟

يعرض Home Assistant عبارة «تم التشغيل بنجاح»، فلماذا لم يضئ المصباح؟

أنشأت أتمتة، وضغطت «تشغيل الإجراءات»، فأضاء المصباح. لكن عندما فُتح الباب فعلًا في المساء، لم يحدث شيء.

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

يبدو هذان السيناريوهان الافتراضيان وكأنهما مشكلة في «استقرار الأتمتة»، لكن موضع الفحص يختلف بينهما. ينبغي التمييز، خطوةً خطوة، بين نطاق الاختبار اليدوي، وشروط التشغيل الفعلي، والعناصر التي يستهدفها الإجراء، واستجابة الجهاز الحقيقية.

تستند هذه المقالة إلى وثائق Home Assistant الرسمية التي كان الإصدار المبيّن لها عند المراجعة 2026.11.1، ولا تتضمن اختبارات فعلية على أجهزة منزلية. قد تختلف أسماء القوائم بين الإصدارات؛ المهم هو فهم ما يثبته كل نوع من الاختبارات.

«تشغيل الإجراءات» لا يختبر الأتمتة كاملة

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

عند اختيار «تشغيل الإجراءات» من المحرر، يتجاوز Home Assistant المُشغِّل والشروط الموجودة في المستوى الأعلى للأتمتة، وينفّذ تسلسل الإجراءات مباشرةً. أما الشروط داخل تسلسل الإجراءات، مثل شروط الفروع في choose، فتبقى سارية.[1]

لذلك، فإن إضاءة المصباح عند الضغط اليدوي لا تثبت إلا أن تنفيذ الإجراءات هذه المرة استطاع إضاءته. وهي لا تثبت أن فتح الباب سيُشغِّل الأتمتة، ولا أن شروط التشغيل الفعلي ستتحقق.

توضح الوثائق الرسمية أيضًا أن هذا التشغيل لا يتضمن بيانات مُشغِّل حقيقية ولا معرّف مُشغِّل. فإذا اعتمد فرع من الإجراءات على «أي مُشغِّل بدأ الأتمتة»، فقد يختلف مسار التشغيل اليدوي عن المسار الفعلي.[1]

طريقة الاختبار ما الذي تفحصه أساسًا ما الذي لا تثبته معها
تشغيل إجراء واحد بمفرده هل يمكن تنفيذ هذا الإجراء في الظروف الحالية صحة المتغيرات السابقة وبيانات المُشغِّل
تشغيل جميع الإجراءات تسلسل الإجراءات والشروط الموجودة داخله سلامة المُشغِّل الحقيقي والشروط في المستوى الأعلى
اختبار شرط واحد بمفرده هل يتحقق هذا الشرط الآن هل سيتحقق وقت التشغيل الفعلي
ترك حدث حقيقي يُشغِّل الأتمتة المسار الكامل لتلك المرة وسلوك الجهاز موثوقية جميع الأوقات وسيناريوهات الأعطال

اختيار طريقة الاختبار المناسبة أولًا قد يوفر تعديل الكثير من الإعدادات السليمة أصلًا.

ابحث عن سجل تتبّع تلك المرة، ولا تكتفِ بالحالة الحالية

يسجّل تتبّع Home Assistant المُشغِّلات، ونتائج تقييم الشروط، والإجراءات، والمتغيرات ذات الصلة. وتوصي وثائق استكشاف الأخطاء الرسمية بالبدء من التتبّع.[1][2]

إذا حدثت المشكلة في الثامنة مساءً، فافتح سجل التشغيل الموافق لذلك الوقت، بدلًا من النظر إلى المؤشر الأخضر بجوار الشرط الآن. كون الشمس قد غربت الآن لا يعني أن الشرط تحقق وقت الاختبار.

تحقق أولًا مما إذا كانت الأتمتة قد بدأت. إن لم تجد تشغيلًا موافقًا، فتحقق من تفعيل الأتمتة ومن حدوث التغيّر الذي تراقبه في المدخلات. توضح الوثائق الرسمية أنه يمكن تشغيل الإجراءات يدويًا حتى عندما تكون الأتمتة معطّلة؛ لذا فإن عمل الزر لا يثبت أن الأتمتة مفعّلة.[2]

إذا بدأت الأتمتة، فاتبع المسار في التتبّع لمعرفة أين انتهى. التوقف عند شرط لم يتحقق نتيجةٌ لتقييم منطقي؛ أما التوقف عند خطأ في إجراء فيستدعي فحص الهدف والمعاملات. ولا يصلح «زيادة مدة التأخير» علاجًا موحدًا للحالتين.

انتبه أيضًا إلى الفرق بين ما تعرضه الواجهة والحالة الأصلية. فقد تعرض واجهة مستشعر الباب كلمة «مفتوح»، بينما يقارن مُشغِّل الحالة فعليًا بالقيمة on. وقد لا تحدث مطابقة إذا كتبت النص الصيني المعروض في الواجهة مباشرةً كسلسلة للحالة.[2]

غياب الخطأ قد يعني ببساطة عدم اختيار مصباح قابل للتحكم

افترض أن الإجراء هو «تشغيل مصابيح منطقة غرفة الدراسة»، لكن المنطقة لا تحتوي على كيانات مصابيح يتعرف إليها هذا الإجراء. تشير وثائق استكشاف الأخطاء الرسمية إلى أن الهدف الذي لا يطابق أي كيان قد يُتجاوز من دون الإبلاغ عن خطأ.[2]

لذلك، حتى إن اكتمل الإجراء، ينبغي فحص ما اختاره فعليًا. ومن الأمور الجديرة بالمراجعة تغيير المنطقة التي ينتمي إليها الجهاز، أو استخدام وسم جديد، أو اعتبار مفتاح كهربائي مصباحًا بالخطأ.

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

إذا كان الكيان في حالة unavailable، فانتقل إلى فحص الطاقة والاتصال وحالة التكامل. قد تختلف طريقة التعامل باختلاف التكامل: فبعضها يتجاوز الكيان غير المتاح ويسجّل تحذيرًا، وبعضها يرسل الأمر رغم ذلك ثم يبلغ عن خطأ.[2]

وفي النهاية، لا بد من ملاحظة التغيّر الفعلي في المصباح. اكتمال استدعاء إجراء واحد لا يثبت وحده أن المصباح الحقيقي وصل إلى الحالة المتوقعة.

اكتمال التشغيل ككل لا يعني خلوّ خطواته من الفشل

يدعم Home Assistant متابعة التشغيل بعد حدوث خطأ في أحد الإجراءات. وتوضح الوثائق الرسمية أنه عند تفعيل Continue on error، قد يستمر تنفيذ الإجراءات التالية رغم فشل إجراء في الوسط، وقد ينتهي التشغيل ككل.[2]

على سبيل المثال، تخيّل تسلسلًا توضيحيًا يشغّل المصباح أولًا ثم يرسل إشعارًا. إذا فشل تشغيل المصباح واستمر التنفيذ، فقد يجعلك تلقي إشعار «انتهى التسلسل» تظن بسهولة أن المصباح قد أُضيء أيضًا.

في هذه الحالة، افحص رسالة الخطأ في خطوة تشغيل المصباح، ولا تكتفِ بالإشعار الأخير. وفي التسلسلات التي تتطلب تأكيد النتيجة، ينبغي التمييز بين «أُرسل الطلب» و«لوحظت الحالة المطلوبة».

يتوقف قرار متابعة التنفيذ على علاقة الاعتماد بين الإجراءات. إرسال إشعار بعطل بعد فشل تشغيل المصباح مفيد؛ أما إرسال إشعار يقول «أُضيئت الأنوار» رغم فشل التشغيل، فيضلل المستخدم.

محاكاة الحالة ليست اختبارًا على الورق فحسب

توفّر الوثائق الرسمية طرقًا لاختبار تغيّرات الحالة والأحداث بالمحاكاة. ويمكن لهذه الطرق تزويد الأتمتة ببيانات مُشغِّل، ما يجعلها مناسبة لفحص الفروع التي تعتمد عليه.[1]

لكن ثمة تفصيل مهم: تعديل حالة كيان في أداة الحالات لا يغيّر حالة الجهاز المادي بذاته؛ إلا أن تغيّر الحالة الناتج قد يُشغِّل أتمتة حقيقية تتحكم بعد ذلك في أجهزة حقيقية.[1]

لذلك، قبل محاكاة فتح مستشعر الباب، اعرف القواعد الأخرى التي تراقبه. لا تجعل اختبار مصباح المدخل يُشغِّل، من غير قصد، منظومة المغادرة أو الإنذار أو أي ترابط آلي آخر. يمكن البدء بكيان اختباري وقاعدة اختبارية معزولين، ثم التحقق من المسار الحقيقي بعد التأكد من نطاق التأثير.

بعد انتهاء المحاكاة، قد تظل الحالة المعروضة في الواجهة مختلفة مؤقتًا عن حالة الجهاز الفعلية، إلى أن يرسل الجهاز حالته من جديد. وينبغي توضيح أن البيانات ناتجة عن محاكاة في سجل الاختبار، حتى لا تُفسَّر لاحقًا على أنها قراءة حقيقية للمستشعر.

اختتم استكشاف الخطأ بسجل كامل لواقعة واحدة

قد يكون السجل المفيد بسيطًا: متى نُفِّذ الإجراء وما هو، وماذا أبلغ كيان الإدخال، وأي أتمتة بدأت، وأي شرط تحقق أو فشل، وأي كيان استُهدف بالتحكم في النهاية، وهل استجاب الجهاز.

تحقق أولًا من إجراء منفرد، ثم من الشروط والفروع، وأخيرًا نفّذ المسار مرةً بحدث حقيقي. إذا أمكن تحديد هدف خاطئ، فأصلح الهدف أولًا؛ وإذا تأكدت من عدم حدوث تشغيل، فارجع إلى فحص المدخلات، ولا حاجة إلى تغيير المستشعر والشبكة في الوقت نفسه.

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

تستحق عبارة «تم التشغيل بنجاح» أن تؤخذ في الحسبان، لكن اكتمال استكشاف الخطأ يعني القدرة على تفسير سبب إضاءة المصباح أو عدم إضاءته في تلك المرة تحديدًا.

المراجع

تاريخ المراجعة: 11 نوفمبر 2026.

  1. Home Assistant: Testing automations، اختبار الخطوات منفردةً، وتشغيل الإجراءات، وبيانات المُشغِّل، ومحاكاة المدخلات، والتتبّع.
  2. Home Assistant: Troubleshooting automations، حالة التعطيل، والحالة الأصلية، والأهداف التي لا تطابق كيانات، وعدم توفر الأجهزة، ومتابعة التنفيذ بعد الخطأ.

رسم مفاهيمي مولّد بالذكاء الاصطناعي، وليس صورة اختبار أو مخططاً لطوبولوجيا الشبكة.

Discussion

Share a question or your experience. Comments appear after moderation. Your email is never displayed publicly. Comment privacy

Loading comments…