duwi-smart-home（杜维智能家居）

Duwi 迪惟智能家居技能

基于 Duwi 开放平台 API，支持设备控制、场景执行、状态查询等功能。

功能特性

房屋管理

• 多房屋支持
• 楼层管理
• 房间管理

状态查询

• 设备在线状态
• 设备实时数值（温度、湿度、光照度、电压、电流等）
• 传感器历史统计数据
• 用电量统计数据

设备控制

• 电源断路器控制：开关控制等
• 灯光控制：开关、亮度调节 (0-100%)、色温调节 (2700-6200K)、颜色调整（HSV 格式）等
• 窗帘控制：开/关/停、百分比 (0-100%)、角度调节等
• 空调控制：开关、温度设置 (5-35℃)、模式设置、风速设置、风向设置等
• 地暖控制：开关、温度设置 (10-30℃) 等
• 新风控制：开关、湿度设置（0-100%）、风速设置、工作模式设置等
• 热泵控制：开关、温度设置、模式设置等
• 二联供控制：开关、模式设置、温度设置（5-35℃）、湿度设置（0-100%）、风速控制等

场景控制

• 场景列表查询
• 场景执行

快速开始

1. 配置应用凭证

配置前确认：

• ✅ 你已从迪惟开放平台获取了 APPKEY 和 SECRET

方式 1：非交互模式（适合大模型）

python init_config.py --appkey <APPKEY> --secret <SECRET>

方式 2：交互模式

python init_config.py

按提示输入 APPKEY 和 SECRET（输入时 SECRET 会隐藏显示）。

2. 登录账户

方式 1：提供密码

python duwi_cli.py login <手机号> <密码>

方式 2：不输入密码（会提示输入，隐藏显示）

python duwi_cli.py login <手机号>

3. 选择房屋

方式 1：交互选择

python duwi_cli.py choose-house

按提示选择房屋。

方式 2：直接指定房屋编号（推荐，无需交互）

python duwi_cli.py choose-house --house_no <房屋编号>

4. 开始控制

python duwi_cli.py device-operate switch on --room 客厅 --device_name 顶灯

功能参考

账户管理

💡 提示：登录成功后 token 会自动保存，下次使用无需重新登录。Token 过期时会自动刷新。

房屋管理

大模型提示： 通过楼层名称查找房间列表，未找到相应的楼层时，先查找楼层列表，匹配相似的楼层名称，再通过精准楼层名称查找房间列表。

设备查询

大模型提示： 设备列表的查询支持 --floor（楼层）、--room（房间）、--online（是否在线）、--type（设备类型编号）参数来精确定位设备，参数可选，可同时传入多个参数。

设备控制

命令格式： python duwi_cli.py device-operate <动作> <值> [定位参数]

定位参数优先级： --device_no > --floor + --room + --device_name > --room + --device_name > --device_name

颜色 HSV 参考： 红色=0:100:100 | 绿色=120:100:100 | 蓝色=240:100:100 | 白色=0:0:100 | 黄色=60:100:100<br> 空调模式说明： auto (自动)、cold (制冷)、hot (制热)、fan (送风)、wet (除湿)、air (换气)<br> 空调风速说明： auto (自动)、super_strong (超强)、super_high (超高)、high (高)、mid (中)、low (低)、super_low (超低)、super_quiet (超静)<br> 空调风向说明： auto (自动)、stop (停止)、swing (摇摆)、up_down (上下)、left_right (左右)<br> 空调锁定模式说明： lock (全锁)、half_lock (半锁)、unlock (解锁)<br> 地暖锁定模式说明： lock (全锁)、half_lock (半锁)、unlock (解锁)<br> 新风风速和新风排风风速说明： auto (自动)、extreme_strong (极强)、super_high (超高)、high (高)、mid (中)、low (低)、super_low (超低)、super_quiet (超静)<br> 新风工作模式说明： fresh (新风)、wet (除湿)、auto (自动)、manual (手动)、indoor_loop (内循环)、sleep (睡眠)、pass (旁通)、common (普通)、smart (智能)、ventilate (通风)、outdoor_loop (外循环)、smart_auto (智慧自动)、eco_fresh (节能新风)、normal_air (普通换气)、cold_wet (制冷除湿)、hot_humidify (制热加湿)、cold_hot_auto (冷暖自动)、smart_humidify (智慧调湿)、timing (定时)、air (换气)、clean (净化)、program (编程)、exhaust (排风)、heat_exchange (热交换)、powerful (强力)、cold_room (冷房)、hot_room (暖房)、energy_recycle (能量回收)、night (夜间)、holiday (假日)<br> 热泵模式说明： cold (制冷)、hot (制热)<br> 温控模式说明： auto (自动)、cold (制冷)、hot (制热)、ventilate (通风)、floorheat (地暖)、mix (一体)、smart_floorheat (智能地暖)、cold_floorcold (制冷制热)<br> 温控风速说明： auto (自动)、super_strong (超强)、strong (强劲)、super_high (超高)、high (高)、mid (中)、low (低)、super_low (超低)、super_quiet (超静)<br> 温控锁定模式说明： mode (锁定模式)、mode_wind (锁定模式&风速)、mode_wind_temp (锁定模式&风速&温度)、unlock (解锁)、floorheat (地暖)、mix (一体)、lock (锁定)<br>

场景控制

统计数据

传感器类型： 1=温度，2=湿度，3=光照度，4=甲醛，5=PM2.5，6=CO2，7=AQI，8=人体感应 <br>

缓存管理

大模型集成指南

意图识别 → CLI 命令映射

房屋结构

房屋 → 楼层 → 房间 → 设备/场景

房屋 (House)
├── 一楼 (Floor)
│   ├── 客厅 (Room)
│   │   ├── 顶灯 (Device)
│   │   ├── 会客模式 (Scene)
│   │   └── 客厅群组 (Group)
│   └── 厨房 (Room)
└── 二楼 (Floor)
    └── 次卧 (Room)

注意事项

1. Token 管理： 登录后自动缓存，过期自动刷新
2. 房屋选择： 首次使用需选择房屋，配置保存到 config.json
3. 设备在线： 控制前请确认设备在线
4. 参数范围： 亮度 0-100%，色温 2700-6200K，空调温度 5-35℃，地暖温度 10-30℃
5. 缓存刷新： 设备控制后自动刷新缓存，如需手动刷新执行 cache clear
6. 安全： 配置文件仅本地保存，不要分享或提交到 Git
7. 控制反馈：如果控制失败，请反馈给用户相关控制失败原因
8. 设备缓存：设备列表会自动缓存 5 分钟，如需刷新请等待或调用 cache clear
9. 用户反馈处理：如果提出设备状态和实际设备状态不一致，请及时调用 cache clear

错误码

依赖

pip install requests