Fähigkeiten AC-Nexus
🎮

AC-Nexus

Niedriges Risiko ⚙️ Externe Befehle🌐 Netzwerkzugriff📁 Dateisystemzugriff🔑 Umgebungsvariablen

Intelligente Klimaanlagen mit KI-Agenten steuern

Die Verwaltung mehrerer Klimaanlagenmarken erfordert separate Apps und manuelle Fernbedienungen. AC-Nexus bietet eine einheitliche Python-API für KI-Agenten, um Broadlink IR- und Xiaomi MIoT-Geräte programmatisch zu steuern, und ermöglicht so automatisierte Zeitplanung und intelligente Klimatisierung.

Unterstützt: Claude Codex Code(CC)
⚠️ 67 Schlecht
1

Die Skill-ZIP herunterladen

2

In Claude hochladen

Gehe zu Einstellungen → Fähigkeiten → Skills → Skill hochladen

3

Einschalten und loslegen

Teste es

Verwendung von "AC-Nexus". Gibt es einen Sturm in der Nähe meines Standorts?

Erwartetes Ergebnis:

Nächster Sturm: Taifun Mawar in 85 km. Windgeschwindigkeit: 45 m/s. Klimaanlagenabschaltung für alle Geräte ausgelöst. Scheduler pausiert bis zum Ende des Sturms.

Verwendung von "AC-Nexus". Schalte die Schlafzimmer-Klimaanlage auf 25°C im Kühlmodus ein

Erwartetes Ergebnis:

Befehl an 二楼卧室 (Broadlink e870723f41ee) gesendet. Klimaanlage eingeschaltet, Modus: Kühlen, Temperatur: 25°C, Lüfter: automatisch. IR-Signal erfolgreich übertragen.

Verwendung von "AC-Nexus". Welche Geräte sind konfiguriert?

Erwartetes Ergebnis:

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

Gesamt: 3 Geräte über 2 Anbieter

Sicherheitsaudit

Niedriges Risiko
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
Gescannte Dateien
386
Analysierte Zeilen
9
befunde
1
Gesamtzahl Audits

Probleme mit hohem Risiko (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.
Probleme mit mittlerem Risiko (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.
Probleme mit niedrigem Risiko (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.

Risikofaktoren

⚙️ Externe Befehle (3)
SKILL.md:16 SKILL.md:25-29 SKILL.md:82-85
🌐 Netzwerkzugriff (5)
SKILL.md:26 SKILL.md:63 SKILL.md:66 SKILL.md:381 SKILL.md:385
📁 Dateisystemzugriff (4)
SKILL.md:16 SKILL.md:89-90 SKILL.md:180 SKILL.md:228
🔑 Umgebungsvariablen (2)
SKILL.md:89 SKILL.md:343-344
Auditiert von: claude

Qualitätsbewertung

38
Architektur
100
Wartbarkeit
87
Inhalt
50
Community
66
Sicherheit
83
Spezifikationskonformität

Was du bauen kannst

Automatisierte Heimklimatisierung

Richten Sie geplante Ein-/Aus-Zeiten für Klimaanlagen basierend auf täglichen Routinen ein, mit automatischer Temperaturanpassung basierend auf den Außenwetterbedingungen.

Markenübergreifende Klimaanlagen-Vereinheitlichung

Steuern Sie Klimaanlagen verschiedener Marken (Gree, Midea, Hisense) über eine einzige Python-API, anstatt mit mehreren Hersteller-Apps zu jonglieren.

Sturmbasierter Klimaanlagenschutz

Automatische Abschaltung von Klimaanlagen, wenn schwere Stürme näher kommen, um Schäden durch Stromschwankungen zu verhindern und Energieverschwendung zu reduzieren.

Probiere diese Prompts

Klimaanlagensteuerung initialisieren 
Helfen Sie mir, AC-Nexus zur Steuerung meiner Gree-Klimaanlage einzurichten. Ich habe einen Broadlink RM4 mini in meinem Netzwerk. Führen Sie mich durch den Initialisierungsprozess.
Xiaomi MIoT-Gerät hinzufügen 
Ich habe eine Xiaomi IR-Fernbedienung, die mit meiner Mi Home-App verbunden ist. Zeigen Sie mir, wie ich sie mit QR-Login zu AC-Nexus hinzufüge und über das lokale Netzwerk steuern kann.
Wochentags-Zeitplan erstellen 
Erstellen Sie einen Zeitplan, der meine Wohnzimmer-Klimaanlage an Wochentagen (Montag-Freitag) um 8:00 Uhr einschaltet und um 18:00 Uhr ausschaltet, mit unterschiedlichen Zeiten am Wochenende.
Sturmschutz-Automatisierung 
Konfigurieren Sie AC-Nexus so, dass alle Klimaanlagen automatisch abgeschaltet werden, wenn sich ein Taifun innerhalb von 100 km meines Standorts befindet, und den normalen Betrieb wieder aufnehmen, nachdem der Sturm vorüber ist.

Bewährte Verfahren

  • Bestätigen Sie immer mit dem Benutzer, bevor Sie Zeitplanvorlagen oder Auto-Adjust-Funktionen aktivieren, da diese dauerhaftes Hintergrundverhalten erzeugen
  • Verwenden Sie aussagekräftige Gerätenamen (Raum/Standort) anstelle von MAC-Adressen, um die Intent-Erkennung des Agenten zu erleichtern
  • Setzen Sie schedule_enabled=False und auto_adjust=False, wenn Sie die Automatisierung deaktivieren, um Hintergrundausführung zu verhindern
  • Speichern Sie Gerätetoken sicher und überprüfen Sie ~/.ac_controller/config.json regelmäßig auf sensible Daten

Vermeiden

  • Aktivieren Sie Auto-Adjust oder Taifun-Auto-Shutdown nicht ohne ausdrückliche Benutzereinwilligung für dauerhaften autonomen Betrieb
  • Committen Sie ~/.ac_controller/config.json nicht in die Versionskontrolle, da es API-Schlüssel und Gerätetoken enthält
  • Hardcodieren Sie keine Gerätetoken oder API-Schlüssel im Agenten-Code; verwenden Sie stattdessen das Konfigurationssystem

Häufig gestellte Fragen

Welche Klimaanlagenmarken unterstützt AC-Nexus?
AC-Nexus unterstützt 17+ Marken, darunter Gree, Midea, Hisense, Daikin, Mitsubishi, Hitachi, Fujitsu, Ballu, Carrier, Hyundai, Fuego, Haier, AUX und Panasonic, sowie alle Xiaomi MIoT-kompatiblen IR-Fernbedienungen.
Brauche ich ein Broadlink-Gerät, um AC-Nexus zu verwenden?
Nein, Sie können Xiaomi MIoT-kompatible IR-Fernbedienungen mit AC-Nexus ohne ein Broadlink-Gerät verwenden. Broadlink wird nur für IR-Lernen und Marken benötigt, die nicht in der integrierten Protokollbibliothek enthalten sind.
Wie funktioniert die automatische Sturmabschaltung?
AC-Nexus ruft Taifun-Daten vom China NMC oder US NHC ab, berechnet die Entfernung zu Ihrem Standort und löst die Abschaltung basierend auf Windgeschwindigkeits- und Entfernungsschwellen aus. Der Scheduler wird bei schwerem Wetter automatisch pausiert.
Werden meine Daten an externe Server gesendet?
Klimaanlagensteuerungsbefehle werden lokal an Ihre Geräte im lokalen Netzwerk gesendet. Wetter- und Sturm-Daten werden von Baidu/QWeather- und NMC/NHC-APIs wie dokumentiert abgerufen. Gerätetoken und API-Schlüssel werden lokal in ~/.ac_controller/config.json gespeichert.
Kann ich den Hintergrund-Scheduler deaktivieren?
Ja, setzen Sie schedule_enabled=False und auto_adjust=False für jedes Gerät und rufen Sie dann _cfg.save_config(_cfg.config) auf. Der Scheduler startet keine autonomen Aktionen, wenn diese Flags deaktiviert sind.
Welche Plattformen werden unterstützt?
AC-Nexus läuft auf jedem Gerät mit Python 3.9 oder höher, einschließlich macOS, Windows, Linux, Raspberry Pi, NAS-Geräten und OpenWRT-Routern. Vorgefertigte GUI-Installer sind für Desktop-Plattformen verfügbar.

Entwicklerdetails

Lizenz

MIT

Repository

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

Ref

main

Dateistruktur

📄 SKILL.md