گزارش اشکال و ویژگی‌ها

کارت جاروبرقی Dreame به عنوان بخشی از یکپارچه‌سازی dreame_vacuum Home Assistant عمل می‌کند و مخزن جداگانه‌ای ندارد. تمام گزارش‌های اشکال، درخواست‌های ویژگی و بحث‌ها به مخزن اصلی یکپارچه‌سازی ارسال می‌شوند.

عناوین مسائل

عناوین مسائل باید به وضوح ارتباط با کارت جاروبرقی Dreame را نشان دهند، مانند [Card] Map is not loading. این موضوع مسائل خاص کارت را از مسائل عمومی یکپارچه‌سازی متمایز می‌کند.

بررسی به‌روزرسانی‌ها

بررسی HACS اطمینان حاصل می‌کند که آخرین نسخه از یکپارچه‌سازی dreame_vacuum قبل از باز کردن یک مسئله در حال اجرا است. یک اشکال گزارش‌شده یا ویژگی درخواستی ممکن است قبلاً در انتشار اخیر موجود باشد.

باز کردن یک مسئله در گیت‌هاب

درخواست ویژگی

ایده‌ها و بهبودهای ویژگی جدید همیشه مورد استقبال هستند.

یک توضیح واضح از ایده، دلایل مفید بودن آن و عملکرد مورد نظر لازم است. نمونه‌سازی‌ها، طرح‌ها یا مثال‌هایی از برنامه‌های دیگر، مانند برنامه رسمی Dreame، درخواست‌های تغییر بصری یا عملکردی را تسهیل می‌کنند.

گزارش باگ

ارائه اطلاعات واضح و دقیق هنگام رخ دادن رفتار غیرمنتظره، فرآیند حل مشکل را تسریع می‌کند.

شواهد بصری

یک تصویر کامل یا ضبط صفحه که مشکل را در داشبورد نشان می‌دهد برای این مؤلفه بصری UI لازم است.

دریافت لاگ‌های Home Assistant

رفع اشکال در رابط کاربری، دکمه‌های خراب یا خطاهای بارگذاری نیازمند بررسی خطاهای فرانت‌اند است که در پشت صحنه رخ می‌دهند. Home Assistant به طور خودکار خطاهای مرورگر و فرانت‌اند را به صورت بومی ضبط و ثبت می‌کند. این لاگ‌ها مستقیماً از سیستم Home Assistant بازیابی می‌شوند.

ضبط لاگ‌های فرانت‌اند از Home Assistant:

1. ابتدا مشکل را بازتولید کردن، مانند کلیک کردن روی دکمه خراب یا تازه‌سازی صفحه اگر کارت بارگذاری نشود، اطمینان می‌دهد که خطا درست قبل از بررسی لاگ‌ها ثبت می‌شود.
2. رفتن به تنظیمات، سپس سیستم و بعد لاگ‌ها در نوار کناری Home Assistant.
3. کلیک کردن روی دکمه دانلود لاگ کامل در پایین صفحه، فایل homeassistant.log را به صورت محلی ذخیره می‌کند.
4. استفاده از گزینه نمایش کامل لاگ‌ها یا منوی overflow (سه نقطه) در بالا سمت راست، لاگ‌های خام را مستقیماً در مرورگر نمایش می‌دهد.
5. فیلتر کردن فایل لاگ دانلود شده یا کپی کردن پیام‌های خطای مربوطه، آن‌ها را برای پیوست به مسأله GitHub آماده می‌کند.

محافظت از داده‌های حساس

فایل کامل homeassistant.log شامل اطلاعات حساسی مانند رمزهای عبور، توکن‌ها یا شناسه‌های شخصی از سایر یکپارچه‌سازی‌ها است. استخراج و اشتراک فقط بخش‌های مربوط به frontend یا dreame_vacuum از این داده‌ها محافظت می‌کند. کل فایل گزارش نباید هرگز بدون بررسی محتویات آن به‌صورت عمومی بارگذاری شود.