技能 AC-Nexus
🎮

AC-Nexus

低风险 ⚙️ 外部命令🌐 网络访问📁 文件系统访问🔑 环境变量

使用 AI 代理控制智能空调

管理多个空调品牌需要使用不同的应用程序和手动遥控器。AC-Nexus 提供统一的 Python API，让 AI 代理可以通过编程方式控制 Broadlink IR 和 Xiaomi MIoT 设备，实现自动化调度和智能气候控制。

支持: Claude Codex Code(CC)
⚠️ 67 差
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“AC-Nexus”。 我所在位置附近有风暴吗？

预期结果:

最近的风暴：台风 Mawar，距离 85 公里。风速：45 m/s。已触发所有设备关机。调度器已暂停直至风暴过去。

正在使用“AC-Nexus”。 将卧室空调打开，制冷模式 25°C

预期结果:

命令已发送到 二楼卧室 (Broadlink e870723f41ee)。空调已开启，模式：制冷，温度：25°C，风速：自动。红外信号发送成功。

正在使用“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
规范符合性

你能构建什么

自动化家庭气候控制

根据日常作息设定空调的自动开关时间，并根据室外天气条件自动调节温度。

多品牌空调统一管理

通过单一 Python API 控制不同品牌的空调（格力、美的、海信），无需在多个厂商应用之间切换。

风暴感知空调保护

在强风暴接近时自动关闭空调，防止电压波动造成损坏并减少能源浪费。

试试这些提示

初始化空调控制 
帮我设置 AC-Nexus 来控制我的格力空调。我网络上有一台 Broadlink RM4 mini。请引导我完成初始化过程。
添加 Xiaomi MIoT 设备 
我有一台连接到米家 App 的小米红外遥控器。请演示如何通过二维码登录将其添加到 AC-Nexus，并开始通过局域网进行控制。
创建工作日定时任务 
创建一个定时任务，在工作日（周一至周五）早上 8:00 打开客厅空调，下午 6:00 关闭，周末使用不同的时间段。
风暴保护自动化 
配置 AC-Nexus 在台风进入我所在位置 100 公里范围内时自动关闭所有空调，并在风暴过后恢复正常运行。

最佳实践

  • 在启用定时模板或自动调节功能之前务必与用户确认，因为这些操作会创建持续的后台行为
  • 使用有意义的设备名称（房间/位置）而非 MAC 地址，以便代理更好地匹配意图
  • 禁用自动化时设置 schedule_enabled=False 和 auto_adjust=False，以防止后台执行
  • 安全存储设备令牌，并定期检查 ~/.ac_controller/config.json 中的敏感数据

避免

  • 未经用户明确同意，不得为持续自主运行启用 auto-adjust 或台风自动关机功能
  • 不得将 ~/.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 兼容的红外遥控器。
使用 AC-Nexus 需要 Broadlink 设备吗？
不需要，您可以在没有 Broadlink 设备的情况下将 Xiaomi MIoT 兼容的红外遥控器与 AC-Nexus 配合使用。仅在红外学习和内置协议库中没有的品牌时才需要 Broadlink。
风暴自动关机功能是如何工作的？
AC-Nexus 从中国气象局或美国国家飓风中心获取台风数据，计算到您所在位置的距离，并根据风速和距离阈值触发关机。调度器在恶劣天气期间会自动暂停。
我的数据会被发送到外部服务器吗？
空调控制命令在局域网上本地发送到您的设备。天气和风暴数据按文档说明从百度/和风天气和气象局/国家飓风中心 API 获取。设备令牌和 API 密钥本地存储在 ~/.ac_controller/config.json 中。
我可以禁用后台调度器吗？
可以，为每台设备设置 schedule_enabled=False 和 auto_adjust=False，然后调用 _cfg.save_config(_cfg.config)。当这些标志被禁用时，调度器将不会启动自主操作。
AC-Nexus 支持哪些平台？
AC-Nexus 可在运行 Python 3.9 或更高版本的任何设备上运行，包括 macOS、Windows、Linux、Raspberry Pi、NAS 设备和 OpenWRT 路由器。桌面平台提供预构建的 GUI 安装程序。

开发者详情

许可证

MIT

仓库

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

引用

main

文件结构

📄 SKILL.md