스킬 AC-Nexus
🎮

AC-Nexus

낮은 위험 ⚙️ 외부 명령어🌐 네트워크 접근📁 파일 시스템 액세스🔑 환경 변수

AI 에이전트로 스마트 에어컨 제어하기

여러 에어컨 브랜드를 관리하려면 각각의 앱과 수동 리모컨이 필요합니다. AC-Nexus는 AI 에이전트가 Broadlink IR 및 Xiaomi MIoT 장치를 프로그래밍 방식으로 제어할 수 있는 통합 Python API를 제공하여 자동 스케줄링과 스마트 기후 제어를 가능하게 합니다.

지원: Claude Codex Code(CC)
⚠️ 67 나쁨
1

스킬 ZIP 다운로드

2

Claude에서 업로드

설정 → 기능 → 스킬 → 스킬 업로드로 이동

3

토글을 켜고 사용 시작

테스트해 보기

"AC-Nexus" 사용 중입니다. 내 위치 근처에 폭풍이 있나요?

예상 결과:

가장 가까운 폭풍: 태풍 마와르 85km 거리. 풍속: 45 m/s. 모든 장치에 대해 AC 종료가 트리거되었습니다. 폭풍이 지나갈 때까지 스케줄러가 일시 중지됩니다.

"AC-Nexus" 사용 중입니다. 침실 에어컨을 25°C로 냉방 모드로 켜 주세요

예상 결과:

二楼卧室(Broadlink e870723f41ee)에 명령이 전송되었습니다. AC 전원 켜짐, 모드: 냉방, 온도: 25°C, 팬: 자동. IR 신호가 성공적으로 전송되었습니다.

"AC-Nexus" 사용 중입니다. 구성된 장치는 무엇인가요?

예상 결과:

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

총계: 2개 공급자에 걸쳐 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
사양 준수

만들 수 있는 것

자동 홈 기후 제어

실외 날씨 조건에 따라 자동으로 온도를 조정하면서, 일상 루틴에 따라 에어컨의 켜기/끄기 시간을 예약하세요.

멀티 브랜드 AC 통합

여러 제조사 앱을 따로 사용할 필요 없이 단일 Python API를 통해 서로 다른 브랜드(Gree, Midea, Hisense)의 에어컨을 제어하세요.

폭풍 감지 AC 보호

심각한 폭풍이 접근할 때 에어컨을 자동으로 종료하여 전력 변동으로 인한 손상을 방지하고 에너지 낭비를 줄입니다.

이 프롬프트를 사용해 보세요

AC 제어 초기화 
내 Gree 에어컨을 제어하도록 AC-Nexus를 설정하는 데 도움을 주세요. 네트워크에 Broadlink RM4 mini가 있습니다. 초기화 과정을 안내해 주세요.
Xiaomi MIoT 장치 추가 
Mi Home 앱에 연결된 Xiaomi IR 리모컨 컨트롤러가 있습니다. QR 로그인을 사용하여 AC-Nexus에 추가하고 로컬 네트워크를 통해 제어하는 방법을 보여주세요.
평일 스케줄 생성 
평일(월요일-금요일)에는 오전 8시에 거실 에어컨을 켜고 오후 6시에 끄는 스케줄을 만들고, 주말에는 다른 시간으로 설정해 주세요.
폭풍 보호 자동화 
태풍이 내 위치에서 100km 이내로 접근할 경우 모든 에어컨을 자동으로 종료하고, 폭풍이 지나간 후 정상 작동으로 재개하도록 AC-Nexus를 구성해 주세요.

모범 사례

  • 지속적인 백그라운드 동작을 생성하므로 스케줄 템플릿이나 자동 조정 기능을 활성화하기 전에 항상 사용자의 확인을 받으세요
  • 에이전트 의도 매칭을 더 쉽게 하기 위해 MAC 주소 대신 의미 있는 장치 이름(방/위치)을 사용하세요
  • 백그라운드 실행을 방지하려면 자동화를 비활성화할 때 schedule_enabled=False 및 auto_adjust=False를 설정하세요
  • 장치 토큰을 안전하게 저장하고 민감한 데이터가 있는지 ~/.ac_controller/config.json을 정기적으로 검토하세요

피하기

  • 지속적인 자율 작동에 대한 명시적인 사용자 동의 없이 자동 조정 또는 태풍 자동 종료를 활성화하지 마세요
  • API 키와 장치 토큰이 포함되어 있으므로 ~/.ac_controller/config.json을 버전 관리 시스템에 커밋하지 마세요
  • 에이전트 코드에 장치 토큰이나 API 키를 하드코딩하지 마세요. 대신 설정 시스템을 사용하세요

자주 묻는 질문

AC-Nexus는 어떤 AC 브랜드를 지원하나요?
AC-Nexus는 Gree, Midea, Hisense, Daikin, Mitsubishi, Hitachi, Fujitsu, Ballu, Carrier, Hyundai, Fuego, Haier, AUX, Panasonic 등 14개 이상의 브랜드와 모든 Xiaomi MIoT 호환 IR 리모컨을 지원합니다.
AC-Nexus를 사용하려면 Broadlink 장치가 필요한가요?
아니요, Broadlink 장치 없이도 Xiaomi MIoT 호환 IR 리모컨을 AC-Nexus와 함께 사용할 수 있습니다. Broadlink는 IR 학습 및 내장 프로토콜 라이브러리에 없는 브랜드에만 필요합니다.
폭풍 자동 종료는 어떻게 작동하나요?
AC-Nexus는 중국 NMC 또는 미국 NHC에서 태풍 데이터를 가져와 내 위치까지의 거리를 계산하고 풍속 및 거리 임계값에 따라 종료를 트리거합니다. 스케줄러는 심각한 기상 상황 동안 자동으로 일시 중지됩니다.
내 데이터가 외부 서버로 전송되나요?
AC 제어 명령은 로컬 네트워크의 장치로 로컬에서 전송됩니다. 날씨 및 폭풍 데이터는 문서화된 대로 Baidu/QWeather 및 NMC/NHC API에서 가져옵니다. 장치 토큰과 API 키는 ~/.ac_controller/config.json에 로컬로 저장됩니다.
백그라운드 스케줄러를 비활성화할 수 있나요?
예, 각 장치에 대해 schedule_enabled=False 및 auto_adjust=False를 설정한 다음 _cfg.save_config(_cfg.config)를 호출하세요. 이러한 플래그가 비활성화되면 스케줄러는 자율 작동을 시작하지 않습니다.
어떤 플랫폼이 지원되나요?
AC-Nexus는 macOS, Windows, Linux, Raspberry Pi, NAS 장치, OpenWRT 라우터를 포함한 Python 3.9 이상이 설치된 모든 장치에서 실행됩니다. 데스크톱 플랫폼용 사전 빌드된 GUI 설치 프로그램을 사용할 수 있습니다.

개발자 세부 정보

작성자

oywq00008-cell

라이선스

MIT

리포지토리

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

참조

main

파일 구조

📄 SKILL.md