المهارات AC-Nexus
🎮

AC-Nexus

مخاطر منخفضة ⚙️ الأوامر الخارجية🌐 الوصول إلى الشبكة📁 الوصول إلى نظام الملفات🔑 متغيرات البيئة

التحكم في مكيفات الهواء الذكية باستخدام وكلاء الذكاء الاصطناعي

تتطلب إدارة عدة علامات تجارية لمكيفات الهواء استخدام تطبيقات منفصلة وأجهزة تحكم عن بعد يدوية. يوفر AC-Nexus واجهة Python موحدة لوكلاء الذكاء الاصطناعي للتحكم في أجهزة Broadlink IR وXiaomi MIoT برمجياً، مما يتيح الجدولة الآلية والتحكم الذكي في المناخ.

يدعم: Claude Codex Code(CC)
⚠️ 67 ضعيف
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "AC-Nexus". هل هناك عاصفة بالقرب من موقعي؟

النتيجة المتوقعة:

أقرب عاصفة: Typhoon Mawar على بعد 85 كم. سرعة الرياح: 45 م/ث. تم تشغيل إيقاف المكيفات لجميع الأجهزة. تم إيقاف الجدولة مؤقتاً حتى انقضاء العاصفة.

استخدام "AC-Nexus". قم بتشغيل مكيف غرفة النوم على 25 درجة مئوية في وضع التبريد

النتيجة المتوقعة:

تم إرسال الأمر إلى 二楼卧室 (Broadlink e870723f41ee). تم تشغيل المكيف، الوضع: تبريد، الحرارة: 25 درجة مئوية، المروحة: تلقائي. تم إرسال إشارة الأشعة تحت الحمراء بنجاح.

استخدام "AC-Nexus". ما الأجهزة التي تم تكوينها؟

النتيجة المتوقعة:

[broadlink] 客厅 = e870723f41ee
[xiaomi_cloud] 主卧 = 2003509235
[xiaomi_cloud] 书房 = 2003509236

المجموع: 3 أجهزة عبر مزودين

التدقيق الأمني

مخاطر منخفضة
v1 • 6/23/2026

Static analysis flagged 153 potential issues but evaluation confirms these are false positives. The skill is a legitimate home automation library for controlling air conditioners. The 'shell backtick execution' findings are markdown code blocks in documentation, not actual code execution. Hardcoded IPs are private addresses (192.168.x.x) used as examples. The filesystem and credential references are standard IoT patterns for storing device tokens and config. The risk is rated LOW due to documented persistence behaviors (background scheduler daemon) that warrant user awareness.

1
الملفات التي تم فحصها
386
الأسطر التي تم تحليلها
9
النتائج
1
إجمالي عمليات التدقيق

مشكلات عالية المخاطر (1)

SKILL.md:16
Persistent background scheduler daemon
The skill starts a background scheduler thread during init() that persists beyond agent task completion. Scheduled on/off times, auto-adjust, and storm auto-shutdown will continue running autonomously. This is documented and expected behavior for home automation, but users should be aware that enabling schedules creates persistent autonomous behavior.
مشكلات متوسطة المخاطر (2)
SKILL.md:16SKILL.md:89SKILL.md:228
Configuration writes to user filesystem
The skill writes config files to ~/.ac_controller/ including API keys, device tokens, and schedule templates. Users should review what data is stored in this directory. This is standard for IoT tools but represents credential storage on disk.
SKILL.md:63SKILL.md:66SKILL.md:325
Local network device control
The skill communicates with devices on the local network (192.168.x.x range) including Broadlink IR blasters and Xiaomi MIoT devices. Device tokens are stored and used for network authentication. This is expected for home automation but represents network access patterns.
مشكلات منخفضة المخاطر (2)
SKILL.md:25-377
Documentation contains extensive code examples
The SKILL.md file contains 100+ code blocks showing usage examples. Static analysis flagged these as 'shell backtick execution' patterns, but they are markdown code fences, not actual shell execution. All examples are safe demonstration code.
SKILL.md:26SKILL.md:381
External API dependencies for weather data
The skill uses Baidu Weather API and QWeather API for weather data, and National Hurricane Center / China NMC for storm tracking. These are legitimate third-party APIs documented in the skill description.

عوامل الخطر

⚙️ الأوامر الخارجية (3)
SKILL.md:16 SKILL.md:25-29 SKILL.md:82-85
🌐 الوصول إلى الشبكة (5)
SKILL.md:26 SKILL.md:63 SKILL.md:66 SKILL.md:381 SKILL.md:385
📁 الوصول إلى نظام الملفات (4)
SKILL.md:16 SKILL.md:89-90 SKILL.md:180 SKILL.md:228
🔑 متغيرات البيئة (2)
SKILL.md:89 SKILL.md:343-344
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
66
الأمان
83
الامتثال للمواصفات

ماذا يمكنك بناءه

التحكم الآلي في مناخ المنزل

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

توحيد المكيفات متعددة العلامات التجارية

التحكم في مكيفات الهواء من علامات تجارية مختلفة (Gree وMidea وHisense) من خلال واجهة Python واحدة بدلاً من التنقل بين تطبيقات الشركات المصنعة المتعددة.

حماية المكيفات من العواصف

إيقاف مكيفات الهواء تلقائياً عند اقتراب العواصف الشديدة، مما يمنع التلف الناتج عن تقلبات الطاقة ويقلل من هدر الطاقة.

جرّب هذه الموجهات

تهيئة التحكم في المكيف 
ساعدني في إعداد AC-Nexus للتحكم في مكيف Gree الخاص بي. لدي Broadlink RM4 mini على شبكتي. أرشدني خلال عملية التهيئة.
إضافة جهاز Xiaomi MIoT 
لدي وحدة تحكم عن بعد بالأشعة تحت الحمراء من Xiaomi متصلة بتطبيق Mi Home. أرني كيفية إضافتها إلى AC-Nexus باستخدام تسجيل الدخول بـ QR وبدء التحكم بها عبر الشبكة المحلية.
إنشاء جدول أيام الأسبوع 
أنشئ جدولاً يقوم بتشغيل مكيف غرفة المعيشة في الساعة 8:00 صباحاً وإيقافه في الساعة 6:00 مساءً أيام الأسبوع (الإثنين-الجمعة)، مع ساعات مختلفة لعطلة نهاية الأسبوع.
أتمتة الحماية من العواصف 
قم بتكوين AC-Nexus لإيقاف جميع مكيفات الهواء تلقائياً إذا اقترب إعصار ضمن 100 كم من موقعي، واستئناف التشغيل الطبيعي بعد انقضاء العاصفة.

أفضل الممارسات

  • تأكد دائماً من المستخدم قبل تفعيل قوالب الجدولة أو ميزات التعديل التلقائي، لأنها تخلق سلوكاً مستمراً في الخلفية
  • استخدم أسماء أجهزة ذات معنى (الغرفة/الموقع) بدلاً من عناوين MAC لتسهيل مطابقة نوايا الوكيل
  • اضبط schedule_enabled=False وauto_adjust=False عند تعطيل الأتمتة لمنع التنفيذ في الخلفية
  • خزن رموز الأجهزة بشكل آمن وراجع ~/.ac_controller/config.json بشكل دوري للتحقق من البيانات الحساسة

تجنب

  • لا تقم بتمكين التعديل التلقائي أو الإيقاف التلقائي عند الإعصار دون موافقة صريحة من المستخدم للتشغيل المستقل المستمر
  • لا تقم بحفظ ~/.ac_controller/config.json في نظام التحكم بالإصدارات لأنه يحتوي على مفاتيح API ورموز الأجهزة
  • لا تقم بتضمين رموز الأجهزة أو مفاتيح API بشكل ثابت في كود الوكيل؛ استخدم نظام التكوين بدلاً من ذلك

الأسئلة المتكررة

ما العلامات التجارية للمكيفات التي يدعمها AC-Nexus؟
يدعم AC-Nexus أكثر من 17 علامة تجارية بما في ذلك Gree وMidea وHisense وDaikin وMitsubishi وHitachi وFujitsu وBallu وCarrier وHyundai وFuego وHaier وAUX وPanasonic، بالإضافة إلى جميع وحدات التحكم عن بعد بالأشعة تحت الحمراء المتوافقة مع Xiaomi MIoT.
هل أحتاج إلى جهاز Broadlink لاستخدام AC-Nexus؟
لا، يمكنك استخدام وحدات التحكم عن بعد بالأشعة تحت الحمراء المتوافقة مع Xiaomi MIoT مع AC-Nexus بدون جهاز Broadlink. Broadlink مطلوب فقط لتعلم الأشعة تحت الحمراء والعلامات التجارية غير الموجودة في مكتبة البروتوكولات المدمجة.
كيف يعمل الإيقاف التلقائي عند العواصف؟
يجلب AC-Nexus بيانات الأعاصير من China NMC أو US NHC، ويحسب المسافة إلى موقعك، ويطلق الإيقاف بناءً على عتبات سرعة الرياح والمسافة. يتم إيقاف الجدولة مؤقتاً تلقائياً أثناء الطقس الشديد.
هل يتم إرسال بياناتي إلى خوادم خارجية؟
يتم إرسال أوامر التحكم في المكيفات محلياً إلى أجهزتك على الشبكة المحلية. يتم جلب بيانات الطقس والعواصف من واجهات برمجة Baidu/QWeather وNMC/NHC كما هو موثق. يتم تخزين رموز الأجهزة ومفاتيح API محلياً في ~/.ac_controller/config.json.
هل يمكنني تعطيل جدولة الخلفية؟
نعم، اضبط schedule_enabled=False وauto_adjust=False لكل جهاز، ثم استدعِ _cfg.save_config(_cfg.config). لن تبدأ الجدولة في اتخاذ إجراءات مستقلة عند تعطيل هذه العلامات.
ما المنصات المدعومة؟
يعمل AC-Nexus على أي جهاز يحتوي على Python 3.9 أو أحدث، بما في ذلك macOS وWindows وLinux وRaspberry Pi وأجهزة NAS وأجهزة توجيه OpenWRT. تتوفر مثبتات واجهة المستخدم الرسومية الجاهزة لأنظمة سطح المكتب.

تفاصيل المطور

المؤلف

oywq00008-cell

الترخيص

MIT

المستودع

https://github.com/oywq00008-cell/AC-Nexus/tree/main/skills/acnexus

مرجع

main

بنية الملفات

📄 SKILL.md