الإبلاغ عن الأخطاء والميزات

جميع تقارير الأخطاء، طلبات الميزات والمناقشات تذهب إلى مستودع GitHub للتكامل.

التحقق من التحديثات

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

تحقق من الأسئلة الشائعة أولاً

الأجهزة غير المدعومة، فشل تسجيل الدخول/الاتصال، وتعطل Home Assistant أو نفاد الذاكرة مغطاة بالفعل في صفحة الأسئلة الشائعة وليست أخطاء.

افتح مشكلة على GitHub

طلب ميزة

دائمًا ما تكون أفكار الميزات الجديدة والتحسينات مرحب بها.

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

طلب دعم لنموذج جديد اختياري

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

عند طلب دعم لجهاز جديد، تتطلب المعلومات التالية:

• نسخة Home Assistant
• رقم طراز الجهاز
• سجل الجهاز غير المدعوم (يجب استخراج هذا من سجلات Home Assistant وتقديمه في المشكلة)

قبل فتح الطلب، تأكد من تثبيت أحدث إصدار من التكامل، وإعادة تشغيل Home Assistant، والتحقق من قوائم الأجهزة المدعومة/غير المدعومة في الوثائق.

طرح سؤال

للاستفسارات العامة أو المناقشات التي ليست أخطاء أو طلبات ميزات، يمكن فتح مشكلة سؤال لطلب المساعدة أو التوضيح حول المشروع.

الإبلاغ عن خطأ

تقديم معلومات واضحة ومفصلة عند حدوث سلوك غير متوقع يسرع عملية الحل. عند فتح تقرير عن مشكلة، المعلومات التالية مطلوبة:

• اسم الطراز (مثلًا، dreame.vacuum.p2028)
• إصدار البرنامج الثابت (مثلًا، 1156)
• نسخة Home Assistant
• نوع التكوين
• الأخطاء أو التحذيرات من سجلات Home Assistant (إذا كان ذلك قابلًا للتطبيق)

الحصول على سجلات التصحيح

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

يمكن الآن تمكين سجلات التصحيح بسهولة مباشرة من واجهة مستخدم Home Assistant بدون الحاجة إلى تعديل ملفات التكوين. لمزيد من التعليمات حول كيفية تمكينها وتنزيل السجلات، يرجى الرجوع إلى الوثائق الرسمية وثائق حل مشكلات Home Assistant.

حماية البيانات الحساسة

ملف homeassistant.log الكامل يحتوي على معلومات حساسة، مثل كلمات المرور، الرموز، أو المعرفات الشخصية من تكاملات أخرى. استخراج ومشاركة الأجزاء المتعلقة فقط بـ dreame_vacuum يحمي هذه البيانات. يجب ألا يتم تحميل سجل الملف بالكامل أبدًا بشكل عام دون مراجعة محتوياته.