Home Commander — 环境控制

通过 Home Assistant 控制智能家居与计算环境。管理场景模式、设备操作及基于人员在场状态的自动化动作。

数据文件：data/home-config.json

{
  "scenes": {
    "study": { "lights": { "desk_lamp": { "on": true, "brightness": 100, "color_temp": "cool" } }, "music": { "playlist": "lofi-focus", "volume": 25 }, "other": { "dnd": true } },
    "chill": { "lights": { "desk_lamp": { "on": true, "brightness": 40, "color_temp": "warm" } }, "music": { "playlist": "chill-vibes", "volume": 35 }, "other": {} },
    "sleep": { "lights": {}, "music": { "playlist": "white-noise", "volume": 15 }, "other": {} }
  },
  "devices": {
    "desk_lamp": { "entity_id": "light.desk_lamp", "type": "light" },
    "speaker": { "entity_id": "media_player.room_speaker", "type": "media_player" }
  },
  "home_assistant": { "url": "http://homeassistant.local:8123", "token_env": "HA_TOKEN" }
}

场景激活

当用户说出“study mode”、“chill mode”等指令时：

1. 从 data/home-config.json 中读取对应场景定义
2. 通过 Home Assistant API 执行各项设备指令
3. 以简洁方式确认执行结果：“Study mode ✓ — desk lamp bright, lo-fi on, DND”

Home Assistant API

# 灯光控制
curl -s -X POST "$HA_URL/api/services/light/turn_on" 
  -H "Authorization: Bearer $HA_TOKEN" 
  -H "Content-Type: application/json" 
  -d '{"entity_id": "light.desk_lamp", "brightness_pct": 100}'

# 媒体播放
curl -s -X POST "$HA_URL/api/services/media_player/play_media" 
  -H "Authorization: Bearer $HA_TOKEN" 
  -d '{"entity_id": "media_player.speaker", "media_content_id": "spotify:playlist:xxx", "media_content_type": "playlist"}'

# Wake-on-LAN
curl -s -X POST "$HA_URL/api/services/wake_on_lan/send_magic_packet" 
  -H "Authorization: Bearer $HA_TOKEN" 
  -d '{"mac": "XX:XX:XX:XX:XX:XX"}'

快捷指令

• “lights off” → 关闭所有灯光
• “dim the lights” → 所有灯光亮度调至 20%
• “play some music” → 播放默认 chill 歌单
• “it's cold” → 恒温器升温 2°F
• “turn on my PC” → 发送 WOL 数据包
• “goodnight” → 启用 sleep 模式
• “I'm heading out” → 关闭灯光并启用节能模式（eco mode）
• “I'm home” → 根据当前时间自动选择相应场景

操作说明

1. 读取 data/home-config.json 获取设备映射关系与场景配置
2. 仅使用一条简短消息确认全部操作
3. 若某设备执行失败，明确指出该设备并建议修复方法
4. 严禁在未经确认的情况下执行“turn off all devices”类指令
5. 若无法连接 Home Assistant，应报告错误并建议检查网络连接
6. 设备的 entity_id 必须由用户预先配置；如缺失，需主动提示