Habilidades AC-Nexus
🎮

AC-Nexus

Riesgo bajo ⚙️ Comandos externos🌐 Acceso a red📁 Acceso al sistema de archivos🔑 Variables de entorno

Controla aires acondicionados inteligentes con agentes de IA

Gestionar múltiples marcas de aires acondicionados requiere aplicaciones separadas y control remoto manual. AC-Nexus proporciona una API unificada en Python para que los agentes de IA controlen dispositivos Broadlink IR y Xiaomi MIoT de forma programática, permitiendo programación automatizada y control climático inteligente.

Soporta: Claude Codex Code(CC)
⚠️ 67 Deficiente
1

Descargar el ZIP de la skill

2

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

3

Activa y empieza a usar

Pruébalo

Usando "AC-Nexus". ¿Hay una tormenta cerca de mi ubicación?

Resultado esperado:

Tormenta más cercana: Tifón Mawar a 85 km. Velocidad del viento: 45 m/s. Apagado del aire acondicionado activado para todos los dispositivos. Programador en pausa hasta que pase la tormenta.

Usando "AC-Nexus". Enciende el aire acondicionado de la habitación a 25°C en modo frío

Resultado esperado:

Comando enviado a 二楼卧室 (Broadlink e870723f41ee). Aire acondicionado encendido, modo: frío, temperatura: 25°C, ventilador: automático. Señal IR transmitida con éxito.

Usando "AC-Nexus". ¿Qué dispositivos están configurados?

Resultado esperado:

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

Total: 3 dispositivos en 2 proveedores

Auditoría de seguridad

Riesgo bajo
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
Archivos escaneados
386
Líneas analizadas
9
hallazgos
1
Auditorías totales

Problemas de riesgo alto (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.
Problemas de riesgo medio (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.
Problemas de riesgo bajo (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.

Factores de riesgo

⚙️ Comandos externos (3)
SKILL.md:16 SKILL.md:25-29 SKILL.md:82-85
🌐 Acceso a red (5)
SKILL.md:26 SKILL.md:63 SKILL.md:66 SKILL.md:381 SKILL.md:385
📁 Acceso al sistema de archivos (4)
SKILL.md:16 SKILL.md:89-90 SKILL.md:180 SKILL.md:228
🔑 Variables de entorno (2)
SKILL.md:89 SKILL.md:343-344
Auditado por: claude

Puntuación de calidad

38
Arquitectura
100
Mantenibilidad
87
Contenido
50
Comunidad
66
Seguridad
83
Cumplimiento de la especificación

Lo que puedes crear

Control climático automatizado del hogar

Configura horarios de encendido y apagado para los aires acondicionados según las rutinas diarias, con ajuste automático de temperatura basado en las condiciones climáticas exteriores.

Unificación de aires acondicionados de múltiples marcas

Controla aires acondicionados de diferentes marcas (Gree, Midea, Hisense) a través de una sola API en Python, en lugar de manejar múltiples aplicaciones de fabricantes.

Protección del aire acondicionado ante tormentas

Apaga automáticamente los aires acondicionados cuando se aproximan tormentas severas, previniendo daños por fluctuaciones eléctricas y reduciendo el desperdicio de energía.

Prueba estos prompts

Inicializar el control del aire acondicionado 
Ayúdame a configurar AC-Nexus para controlar mi aire acondicionado Gree. Tengo un Broadlink RM4 mini en mi red. Guíame a través del proceso de inicialización.
Agregar dispositivo Xiaomi MIoT 
Tengo un controlador remoto IR Xiaomi conectado a mi aplicación Mi Home. Muéstrame cómo agregarlo a AC-Nexus usando el inicio de sesión por QR y comenzar a controlarlo a través de la red local.
Crear horario entre semana 
Crea un horario que encienda el aire acondicionado de la sala a las 8:00 AM y lo apague a las 6:00 PM entre semana (lunes a viernes), con horarios diferentes para los fines de semana.
Automatización de protección contra tormentas 
Configura AC-Nexus para apagar automáticamente todos los aires acondicionados si un tifón se acerca a menos de 100 km de mi ubicación, y reanuda el funcionamiento normal después de que pase la tormenta.

Mejores prácticas

  • Confirma siempre con el usuario antes de habilitar plantillas de horarios o funciones de autoajuste, ya que crean comportamiento persistente en segundo plano
  • Usa nombres de dispositivos significativos (habitación/ubicación) en lugar de direcciones MAC para facilitar la coincidencia de intención del agente
  • Establece schedule_enabled=False y auto_adjust=False al deshabilitar la automatización para evitar la ejecución en segundo plano
  • Almacena los tokens de dispositivo de forma segura y revisa periódicamente ~/.ac_controller/config.json para detectar datos sensibles

Evitar

  • No habilites el autoajuste ni el apagado automático por tifones sin el consentimiento explícito del usuario para operación autónoma persistente
  • No commitees ~/.ac_controller/config.json al control de versiones, ya que contiene claves API y tokens de dispositivo
  • No hardcodees tokens de dispositivo ni claves API en el código del agente; usa el sistema de configuración en su lugar

Preguntas frecuentes

¿Qué marcas de aires acondicionados soporta AC-Nexus?
AC-Nexus soporta más de 17 marcas, incluidas Gree, Midea, Hisense, Daikin, Mitsubishi, Hitachi, Fujitsu, Ballu, Carrier, Hyundai, Fuego, Haier, AUX y Panasonic, además de todos los controladores remotos IR compatibles con Xiaomi MIoT.
¿Necesito un dispositivo Broadlink para usar AC-Nexus?
No, puedes usar controladores remotos IR compatibles con Xiaomi MIoT con AC-Nexus sin un dispositivo Broadlink. Broadlink solo es necesario para el aprendizaje IR y para marcas que no están en la biblioteca de protocolos integrada.
¿Cómo funciona el apagado automático por tormentas?
AC-Nexus obtiene datos de tifones del NMC de China o del NHC de EE. UU., calcula la distancia a tu ubicación y activa el apagado según los umbrales de velocidad del viento y distancia. El programador se pausa automáticamente durante condiciones climáticas severas.
¿Se envían mis datos a servidores externos?
Los comandos de control del aire acondicionado se envían localmente a tus dispositivos en la red local. Los datos meteorológicos y de tormentas se obtienen de las APIs de Baidu/QWeather y NMC/NHC según la documentación. Los tokens de dispositivo y las claves API se almacenan localmente en ~/.ac_controller/config.json.
¿Puedo deshabilitar el programador en segundo plano?
Sí, establece schedule_enabled=False y auto_adjust=False para cada dispositivo, luego llama a _cfg.save_config(_cfg.config). El programador no iniciará acciones autónomas cuando estos flags estén deshabilitados.
¿Qué plataformas son compatibles?
AC-Nexus se ejecuta en cualquier dispositivo con Python 3.9 o posterior, incluidos macOS, Windows, Linux, Raspberry Pi, dispositivos NAS y routers OpenWRT. Hay instaladores GUI precompilados disponibles para plataformas de escritorio.

Detalles del desarrollador

Licencia

MIT

Repositorio

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

Ref.

main

Estructura de archivos

📄 SKILL.md