4566704
a3d94c4b9f
- 新增 xiaomi/examples/ 下 8 个示例程序（用户/家庭查询、设备列表、开关/灯光/空调控制、属性订阅、高级过滤分类、SPEC 解析） - miot_client_sub.go: 重构 SubProp/SubEvent，使用 buildPropTopic/buildEventTopic 支持通配符订阅（siid/piid=0 → +），并修复锁顺序问题（将 RequestRefreshProp 移到 Lock 外） - spec_parser.go: 新增 downloadSpecFile 方法，本地 SPEC 文件缺失时自动从 miot-spec.org 下载 - ARCH_PLAN.md: 架构设计从 Proposed 更新为 Accepted（v1.0→v1.1），补充设备分类/工厂/SPEC 映射等模块设计 - xiaomi/: 新增 miot 上层强类型封装模块，包含 Client 主入口、用户/家庭/设备 API、属性读写、动作调用、订阅通知，以及 devices/ 设备控制抽象（Switch/Light/AirConditioner/Fan/Cover/Humidifier/Vacuum/WaterHeater/Thermostat）和 specs/ SPEC 查询辅助 - 更多 xiaomi 示例（风扇/窗帘/传感器控制）
1.7 KiB
1.7 KiB
修复方案 v2
2026-06-29
xiaomi.Config 最终形态
type Config struct {
ClientID string // 默认 miot.OAUTH2_CLIENT_ID（"2882303761520251711"）
AccessToken string
}
删掉的字段及原因：
| 字段 | 原因 |
|---|---|
| CountryCode | 全项目无任何地方读取 |
| ClientSecret | miot API 不需要，从未使用 |
| CloudServer | 国内恒为 "cn"，NewClient 内部硬编码 |
修改清单
1. 删除 xiaomi/examples/config/ 整个目录
示例程序复用 miot/examples/config 包。
2. 9 个示例文件统一替换
xiaomi/examples/01_user_home/main.go
xiaomi/examples/02_device_list/main.go
xiaomi/examples/03_switch_control/main.go
xiaomi/examples/04_light_control/main.go
xiaomi/examples/05_ac_control/main.go
xiaomi/examples/06_fan_cover/main.go
xiaomi/examples/07_prop_subscribe/main.go
xiaomi/examples/08_adv_filter_classify/main.go
xiaomi/examples/09_spec_parser/main.go
替换模板：
import miotconfig "xiaomihome/miot/examples/config"
func main() {
cfg, err := miotconfig.LoadConfig("miot/examples/config.json")
if err != nil {
log.Fatal("请先运行 miot/examples/cloud_oauth 获取 token:", err)
}
client, err := xiaomi.NewClient(ctx, xiaomi.Config{
AccessToken: cfg.AuthInfo.AccessToken,
})
if err != nil {
log.Fatal(err)
}
defer client.Close()
// ...
}
删除的内容：entryData、miot.NewMIoTClient、Init/Deinit、NewMIoTHttpClient、import "xiaomihome/miot"。
3. miot/miot_client.go — 去掉 country_code
NewMIoTClient 中 entryData 如有 "country_code" 字段，删掉该行。