گزارش باگ و ویژگی‌ها

تمام گزارش‌های باگ، درخواست‌های ویژگی و بحث‌ها به مخزن گیت‌هاب یکپارچه‌سازی.

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

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

ابتدا سوالات متداول را بررسی کنید

دستگاه‌های پشتیبانی نشده، عدم موفقیت در ورود/اتصال، و کرش یا تمام شدن حافظه Home Assistant قبلاً در صفحه پرسش‌های متداول پوشش داده شده‌اند و باگ نیستند.

باز کردن یک Issue در گیت‌هاب

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

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

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

درخواست پشتیبانی از مدل جدید اختیاری

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

هنگام درخواست پشتیبانی برای یک دستگاه جدید، اطلاعات زیر لازم است:

• نسخه Home Assistant
• شماره مدل دستگاه
• گزارش دستگاه پشتیبانی‌نشده (این باید از لاگ‌های Home Assistant استخراج و در مسئله ارائه شود)

قبل از باز کردن درخواست، اطمینان حاصل کنید که آخرین نسخه یکپارچه‌سازی نصب شده است، Home Assistant مجدداً راه‌اندازی شده است و فهرست دستگاه‌های پشتیبانی‌شده/پشتیبانی‌نشده مستندات بررسی شده است.

پرسیدن یک سؤال

برای پرسش‌ها یا بحث‌های عمومی که مربوط به باگ یا درخواست ویژگی نیستند، می‌توان یک مسئله سؤال باز کرد تا کمک یا توضیح بیشتری درباره پروژه درخواست شود.

گزارش یک باگ

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

• نام مدل (برای مثال، dreame.vacuum.p2028)
• نسخه فریم‌ویر (برای مثال، 1156)
• نسخه Home Assistant
• نوع پیکربندی
• خطاها یا هشدارها از لاگ‌های Home Assistant (در صورت موجود بودن)

دریافت لاگ‌های اشکال‌زدایی

رفع مشکلات اتصال، موجودیت‌های گمشده یا حالت‌های غیرمنتظره نیاز به بررسی آنچه واقعاً توسط یکپارچگی لاگ شده است دارد. فعال کردن لاگ‌گیری اشکال‌زدایی جزئیات بسیار بیشتری نسبت به سطح لاگ پیش‌فرض ثبت می‌کند.

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

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

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