التحدي الحقيقي في إطفاء الأنوار المجدول عبر Home Assistant: لماذا قد يُنفَّذ التعويض بعد إعادة التشغيل مرتين؟

تجربة قابلة للتشغيل باستخدام SQLite ومصباح محاكى تشرح استعادة المهام وتكرار الأوامر وحداثة الملاحظات وإشعارات الإكمال القديمة.

آخر تحديث

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

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

قد تؤدي إعادة المحاولة إلى تكرار التنفيذ، وقد يؤدي عدمها إلى تفويت مهمة لم تُنفَّذ أصلًا. ولا يزول هذا التعارض تلقائيًا بمجرد كتابة الوقت في عنصر مساعد.

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

أولًا: ميّز بين قاعدتين تبدوان متماثلتين

قد تعبّر عبارة «أطفئ الضوء بعد عشر دقائق» عن معنيين مختلفين:

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

لا يمكن استخدام إحدى القاعدتين بدلًا من الأخرى.

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

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

لماذا لا يكفي عنصر مساعد واحد لتخزين الوقت؟

يستطيع input_datetime في Home Assistant تخزين التاريخ والوقت. وتوضح الوثائق الرسمية أنه يبدأ من قيمة initial إذا ضُبطت على قيمة صالحة، وإلا فإنه يستعيد حالته قبل التوقف.[1]

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

لذلك، يلزم التعبير عن ثلاثة أمور على الأقل: هوية المهمة، وموعد استحقاقها، وحالتها. مثلًا:

id=42
due=وقت استحقاق محدد بوضوح
state=pending

يُميّز id المهام القديمة من الجديدة، ويحدد due متى يمكن محاولة التنفيذ، وتُميّز state بين الانتظار والاكتمال والإلغاء.

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

نافذة انقطاع لا يمكن تجاهلها

افترض أن موعد الاستحقاق قد حلّ، وأن سير التنفيذ هو:

قراءة المهمة التي حالتها pending
فحص الشروط الحالية
إرسال أمر إطفاء الضوء
تسجيل حالة المهمة على أنها done

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

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

ترتيب التسجيل نافذة الانقطاع خطر الاستعادة
تسجيل الاكتمال قبل التنفيذ بعد كتابة سجل الاكتمال وقبل الإجراء تفويت التنفيذ
التنفيذ قبل تسجيل الاكتمال بعد الإجراء وقبل كتابة سجل الاكتمال تكرار التنفيذ

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

التجربة: إعادة المحاولة مرتين تعطي نتيجتين متعاكستين مع off وtoggle

أعددنا مصباحًا مُحاكى مضاءً في البداية، وأنشأنا مهمة موعد استحقاقها 600، ثم حاولنا تنفيذها عند الوقت المُحاكى 700.

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

بعد الاستعادة، تظل المهمة بانتظار التنفيذ، فتجري محاولة أخرى.

نتيجة هذا التشغيل:

crash_after_action_off     calls=2  lamp_on=false
crash_after_action_toggle  calls=2  lamp_on=true

عند تنفيذ أمر الإطفاء مرتين متتاليتين، يظل المصباح المُحاكى مطفأً في النهاية. أما عند تنفيذ أمر تبديل الحالة مرتين، فيعود المصباح المُحاكى إلى الإضاءة.

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

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

لماذا قد تكون قراءة «لا أحد موجود» بعد الاستعادة قديمة؟

إذا كانت حالة المستشعر المقروءة عند بدء التشغيل هي off، فلا يزال علينا أن نسأل: هل هي رصد جديد وصل بعد بدء التشغيل، أم حالة قديمة استُعيدت؟

تشترط التجربة أن يستوفي الرصد ثلاثة شروط:

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

استخدم السكربت 30 وحدة زمنية مُحاكاة بوصفها نافذة للحداثة، لاختبار الحدود فحسب؛ وليست هذه توصية باعتماد 30 ثانية موحدة للأجهزة الحقيقية. وينبغي تحديد الحد الحقيقي وفق دورة إرسال الجهاز وعواقب القرار.

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

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

لا يجوز اعتبار unknown أو unavailable دلالةً على خلو المكان لمجرد أنهما «ليسا on».

يجب ألا يمحو إقرار المهمة القديمة مهمةً جديدة

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

خصصت التجربة معرّفات مختلفة للمهام، واستخدمت تحديثًا مشروطًا:

UPDATE job
SET state = 'done'
WHERE id = ? AND state = 'pending';

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

في التجربة، كان معرّف المهمة القديمة 1 وموعد استحقاقها 600؛ وكان معرّف الجديدة 2 وموعد استحقاقها 900. بعد وصول استدعاء اكتمال المهمة القديمة، لم توجد مهمة قابلة للتنفيذ عند الوقت 700، وظل بالإمكان العثور على المهمة 2 عند الوقت 901.

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

ما نقاط الفحص اللازمة عند الربط مع Home Assistant؟

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

توضح وثائق Timer الرسمية صراحةً أن تفعيل restore يتيح استعادة المؤقتات النشطة أو المتوقفة مؤقتًا، لكن المؤقتات التي انتهت أثناء توقف النظام لا يُعاد إصدار حدث timer.finished لها عند بدء التشغيل.[2] وتوضح وثائق مُشغّل الحالة أيضًا أن for يُعاد ضبطه عند إعادة التشغيل أو إعادة تحميل الأتمتة.[3]

تُبيّن هذه الحقائق الحاجة إلى فحص عند الاستعادة، لكنها لا تجعل الحكم التالي آمنًا بطبيعته:

الوقت الحالي تجاوز موعد استحقاق قديم ← أطفئ الضوء بلا شروط

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

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

ما النتائج التي يمكنك إعادة إنتاجها؟

الملف المرفق بالمقال: deadline_lab.py. يستخدم مكتبة Python 3 القياسية، وتُحذف قاعدة بيانات SQLite المؤقتة بعد انتهاء التشغيل. ولا يحتاج إلى رمز وصول Home Assistant، ولا يتصل بأجهزة حقيقية.

python deadline_lab.py

اجتازت تأكيدات السيناريوهات الأربع في هذا التشغيل، وحُفظت النتائج في deadline_results.json:

السيناريو ما تم التحقق منه
إغلاق قاعدة البيانات وإعادة فتحها، ثم فحص الشروط تبقى المهمة قيد الانتظار؛ وتُمنع عمليات التنفيذ مع القراءات القديمة والمجهولة والتي تفيد بوجود أحد والمتجاوزة للنافذة؛ ويؤدي الرصد الجديد الصالح إلى إجراء واحد
الانقطاع بعد الإجراء وقبل كتابة الاكتمال، ثم إعادة محاولة off حدث استدعاءان فعليًا، وانطفأ المصباح المُحاكى في النهاية
الانقطاع نفسه، ثم إعادة محاولة toggle حدث استدعاءان فعليًا، وأضاء المصباح المُحاكى في النهاية
استبدال مهمة قديمة بجديدة، ثم وصول إقرار القديمة لا يؤدي إقرار القديمة إلى إكمال الجديدة

لا تثبت هذه النتائج الأربع استمرارية البيانات عند انقطاع الكهرباء، ولا تثبت أن العناصر المساعدة في Home Assistant تملك دلالات معاملات SQLite، ولا تثبت صحة السلوك مع عدة منفّذين متزامنين. بل أبقت التجربة عمدًا فجوة «نُفِّذ الإجراء لكن لم تُعتمد الحالة»، لتوضيح سبب عجز التسجيل المحلي وحده عن ضمان التنفيذ مرة واحدة بالضبط.

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

عند تصميم مهمة مجدولة، لا بد من توضيح السؤال الحقيقي: في اللحظة التي يفقد فيها النظام نتيجة الإجراء، أيهما أقل قبولًا لديك: تفويت التنفيذ أم تكراره؟ لا يصبح لمنطق الاستعادة هدف قابل للتحقق إلا بعد توضيح ذلك.

المراجع

تاريخ التحقق: 2026-11-14. تعرض الصفحة الرسمية إصدار Home Assistant 2026.11.1؛ ولم تُثبّت التجربة هذا الإصدار.

  1. Input Datetime: استعادة الحالة.
  2. Timer: الاستعادة وحدود انتهاء المؤقت أثناء توقف النظام.
  3. State changed: سلوك for عند إعادة التشغيل.
  4. سكربت التجربة والنتائج الأصلية: النموذج البرمجي الذي شُغِّل فعليًا في هذه التجربة ومخرجاته.

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

تنزيل حزمة التجربة الكاملة، بما فيها السكربت والنتائج وسجل التشغيل

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

Discussion

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

Loading comments…