Compétences AC-Nexus
🎮

AC-Nexus

Risque faible ⚙️ Commandes externes🌐 Accès réseau📁 Accès au système de fichiers🔑 Variables d’environnement

Contrôler les climatiseurs intelligents avec des agents IA

La gestion de plusieurs marques de climatiseurs nécessite des applications distinctes et une télécommande manuelle. AC-Nexus fournit une API Python unifiée permettant aux agents IA de contrôler les appareils Broadlink IR et Xiaomi MIoT par programmation, pour une planification automatisée et un contrôle climatique intelligent.

Prend en charge: Claude Codex Code(CC)
⚠️ 67 Médiocre
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "AC-Nexus". Y a-t-il une tempête près de ma position ?

Résultat attendu:

Tempête la plus proche : Typhon Mawar à 85 km. Vitesse du vent : 45 m/s. Arrêt des climatiseurs déclenché pour tous les appareils. Planificateur en pause jusqu'au passage de la tempête.

Utilisation de "AC-Nexus". Allume le climatiseur de la chambre à 25°C en mode froid

Résultat attendu:

Commande envoyée à 二楼卧室 (Broadlink e870723f41ee). Climatiseur allumé, mode : froid, température : 25°C, ventilateur : auto. Signal IR transmis avec succès.

Utilisation de "AC-Nexus". Quels appareils sont configurés ?

Résultat attendu:

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

Total : 3 appareils répartis sur 2 fournisseurs

Audit de sécurité

Risque faible
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
Fichiers analysés
386
Lignes analysées
9
résultats
1
Total des audits

Problèmes à risque élevé (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.
Problèmes à risque moyen (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.
Problèmes à risque faible (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.

Facteurs de risque

⚙️ Commandes externes (3)
SKILL.md:16 SKILL.md:25-29 SKILL.md:82-85
🌐 Accès réseau (5)
SKILL.md:26 SKILL.md:63 SKILL.md:66 SKILL.md:381 SKILL.md:385
📁 Accès au système de fichiers (4)
SKILL.md:16 SKILL.md:89-90 SKILL.md:180 SKILL.md:228
🔑 Variables d’environnement (2)
SKILL.md:89 SKILL.md:343-344
Audité par: claude

Score de qualité

38
Architecture
100
Maintenabilité
87
Contenu
50
Communauté
66
Sécurité
83
Conformité aux spécifications

Ce que vous pouvez construire

Contrôle climatique domestique automatisé

Configurez des horaires de marche/arrêt pour les climatiseurs en fonction des routines quotidiennes, avec réglage automatique de la température selon les conditions météorologiques extérieures.

Unification de climatiseurs multi-marques

Contrôlez les climatiseurs de différentes marques (Gree, Midea, Hisense) via une seule API Python au lieu de jongler avec plusieurs applications de fabricants.

Protection des climatiseurs en cas de tempête

Arrêtez automatiquement les climatiseurs à l'approche de tempêtes violentes, évitant les dommages liés aux fluctuations de courant et réduisant le gaspillage d'énergie.

Essayez ces prompts

Initialiser le contrôle du climatiseur 
Aidez-moi à configurer AC-Nexus pour contrôler mon climatiseur Gree. J'ai un Broadlink RM4 mini sur mon réseau. Guidez-moi à travers le processus d'initialisation.
Ajouter un appareil Xiaomi MIoT 
J'ai une télécommande IR Xiaomi connectée à mon application Mi Home. Montrez-moi comment l'ajouter à AC-Nexus via la connexion QR et commencer à la contrôler via le réseau local.
Créer un planning en semaine 
Créez un planning qui allume le climatiseur du salon à 8h00 et l'éteint à 18h00 en semaine (lundi-vendredi), avec des horaires différents le week-end.
Automatisation de la protection contre les tempêtes 
Configurez AC-Nexus pour éteindre automatiquement tous les climatiseurs si un typhon s'approche à moins de 100 km de ma position, et reprendre le fonctionnement normal après le passage de la tempête.

Bonnes pratiques

  • Confirmez toujours avec l'utilisateur avant d'activer les modèles de planification ou les fonctions d'ajustement automatique, car ceux-ci créent un comportement persistant en arrière-plan
  • Utilisez des noms d'appareils significatifs (pièce/emplacement) au lieu des adresses MAC pour faciliter la correspondance d'intention par l'agent
  • Définissez schedule_enabled=False et auto_adjust=False lors de la désactivation de l'automatisation pour empêcher l'exécution en arrière-plan
  • Stockez les jetons d'appareil en toute sécurité et examinez périodiquement ~/.ac_controller/config.json pour repérer les données sensibles

Éviter

  • N'activez pas l'ajustement automatique ou l'arrêt automatique en cas de typhon sans consentement explicite de l'utilisateur pour un fonctionnement autonome persistant
  • Ne validez pas ~/.ac_controller/config.json dans le contrôle de version car il contient des clés API et des jetons d'appareil
  • Ne codez pas en dur les jetons d'appareil ou les clés API dans le code de l'agent ; utilisez plutôt le système de configuration

Foire aux questions

Quelles marques de climatiseurs AC-Nexus prend-il en charge ?
AC-Nexus prend en charge plus de 17 marques, dont Gree, Midea, Hisense, Daikin, Mitsubishi, Hitachi, Fujitsu, Ballu, Carrier, Hyundai, Fuego, Haier, AUX et Panasonic, ainsi que toutes les télécommandes IR compatibles Xiaomi MIoT.
Ai-je besoin d'un appareil Broadlink pour utiliser AC-Nexus ?
Non, vous pouvez utiliser les télécommandes IR compatibles Xiaomi MIoT avec AC-Nexus sans appareil Broadlink. Broadlink n'est requis que pour l'apprentissage IR et les marques non présentes dans la bibliothèque de protocoles intégrée.
Comment fonctionne l'arrêt automatique en cas de tempête ?
AC-Nexus récupère les données sur les typhons auprès du NMC chinois ou du NHC américain, calcule la distance par rapport à votre position et déclenche l'arrêt en fonction de seuils de vitesse du vent et de distance. Le planificateur est automatiquement mis en pause lors de conditions météorologiques sévères.
Mes données sont-elles envoyées à des serveurs externes ?
Les commandes de contrôle du climatiseur sont envoyées localement à vos appareils sur le réseau local. Les données météorologiques et de tempête sont récupérées auprès des API Baidu/QWeather et NMC/NHC comme documenté. Les jetons d'appareil et les clés API sont stockés localement dans ~/.ac_controller/config.json.
Puis-je désactiver le planificateur en arrière-plan ?
Oui, définissez schedule_enabled=False et auto_adjust=False pour chaque appareil, puis appelez _cfg.save_config(_cfg.config). Le planificateur ne lancera pas d'actions autonomes lorsque ces indicateurs sont désactivés.
Quelles plateformes sont prises en charge ?
AC-Nexus fonctionne sur tout appareil doté de Python 3.9 ou version ultérieure, y compris macOS, Windows, Linux, Raspberry Pi, appareils NAS et routeurs OpenWRT. Des installateurs GUI pré-compilés sont disponibles pour les plateformes de bureau.

Détails du développeur

Licence

MIT

Dépôt

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

Réf

main

Structure de fichiers

📄 SKILL.md