Навыки AC-Nexus
🎮

AC-Nexus

Низкий риск ⚙️ Внешние команды🌐 Доступ к сети📁 Доступ к файловой системе🔑 Переменные окружения

Управление умными кондиционерами с помощью ИИ-агентов

Управление кондиционерами разных производителей требует отдельных приложений и ручного пульта. AC-Nexus предоставляет единый Python API для ИИ-агентов, позволяющий программно управлять устройствами Broadlink IR и Xiaomi MIoT, обеспечивая автоматическое планирование и интеллектуальный климат-контроль.

Поддерживает: Claude Codex Code(CC)
⚠️ 67 Плохо
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

Протестировать

Использование «AC-Nexus». Есть ли шторм рядом с моим местоположением?

Ожидаемый результат:

Ближайший шторм: Тайфун Мавар на расстоянии 85 км. Скорость ветра: 45 м/с. Сработало отключение кондиционеров для всех устройств. Планировщик приостановлен до окончания шторма.

Использование «AC-Nexus». Включи кондиционер в спальне на 25°C в режиме охлаждения

Ожидаемый результат:

Команда отправлена на 二楼卧室 (Broadlink e870723f41ee). Кондиционер включён, режим: охлаждение, температура: 25°C, вентилятор: авто. ИК-сигнал успешно передан.

Использование «AC-Nexus». Какие устройства настроены?

Ожидаемый результат:

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

Всего: 3 устройства от 2 провайдеров

Аудит безопасности

Низкий риск
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 API вместо использования множества приложений от производителей.

Защита кондиционеров от штормов

Автоматическое отключение кондиционеров при приближении сильных штормов для предотвращения повреждений от перепадов напряжения и снижения расхода электроэнергии.

Попробуйте эти промпты

Инициализация управления кондиционером 
Помогите мне настроить AC-Nexus для управления моим кондиционером Gree. У меня в сети есть Broadlink RM4 mini. Проведите меня через процесс инициализации.
Добавление устройства Xiaomi MIoT 
У меня есть ИК-пульт Xiaomi, подключённый к приложению Mi Home. Покажите, как добавить его в AC-Nexus через QR-авторизацию и начать управлять им по локальной сети.
Создание расписания на будние дни 
Создайте расписание, которое включает кондиционер в гостиной в 8:00 и выключает в 18: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, вычисляет расстояние до вашего местоположения и запускает отключение на основе пороговых значений скорости ветра и расстояния. Планировщик автоматически приостанавливается во время суровой погоды.
Отправляются ли мои данные на внешние серверы?
Команды управления кондиционером отправляются локально вашим устройствам в локальной сети. Данные о погоде и штормах получаются от API 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. Для настольных платформ доступны готовые GUI-установщики.

Сведения для разработчиков

Автор

oywq00008-cell

Лицензия

MIT

Репозиторий

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

Ссылка

main

Структура файлов

📄 SKILL.md