chore: 提交高层 xiaomi 封装库及示例

- 新增 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 示例（风扇/窗帘/传感器控制）

xiaomi/examples/02_device_list/data/cert/mihome_ca.cert

@@ -0,0 +1,21 @@
+-----BEGIN CERTIFICATE-----
+MIIBazCCAQ+gAwIBAgIEA/UKYDAMBggqhkjOPQQDAgUAMCIxEzARBgNVBAoTCk1p
+amlhIFJvb3QxCzAJBgNVBAYTAkNOMCAXDTE2MTEyMzAxMzk0NVoYDzIwNjYxMTEx
+MDEzOTQ1WjAiMRMwEQYDVQQKEwpNaWppYSBSb290MQswCQYDVQQGEwJDTjBZMBMG
+ByqGSM49AgEGCCqGSM49AwEHA0IABL71iwLa4//4VBqgRI+6xE23xpovqPCxtv96
+2VHbZij61/Ag6jmi7oZ/3Xg/3C+whglcwoUEE6KALGJ9vccV9PmjLzAtMAwGA1Ud
+EwQFMAMBAf8wHQYDVR0OBBYEFJa3onw5sblmM6n40QmyAGDI5sURMAwGCCqGSM49
+BAMCBQADSAAwRQIgchciK9h6tZmfrP8Ka6KziQ4Lv3hKfrHtAZXMHPda4IYCIQCG
+az93ggFcbrG9u2wixjx1HKW4DUA5NXZG0wWQTpJTbQ==
+-----END CERTIFICATE-----
+-----BEGIN CERTIFICATE-----
+MIIBjzCCATWgAwIBAgIBATAKBggqhkjOPQQDAjAiMRMwEQYDVQQKEwpNaWppYSBS
+b290MQswCQYDVQQGEwJDTjAgFw0yMjA2MDkxNDE0MThaGA8yMDcyMDUyNzE0MTQx
+OFowLDELMAkGA1UEBhMCQ04xHTAbBgNVBAoMFE1JT1QgQ0VOVFJBTCBHQVRFV0FZ
+MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEdYrzbnp/0x/cZLZnuEDXTFf8mhj4
+CVpZPwgj9e9Ve5r3K7zvu8Jjj7JF1JjQYvEC6yhp1SzBgglnK4L8xQzdiqNQME4w
+HQYDVR0OBBYEFCf9+YBU7pXDs6K6CAQPRhlGJ+cuMB8GA1UdIwQYMBaAFJa3onw5
+sblmM6n40QmyAGDI5sURMAwGA1UdEwQFMAMBAf8wCgYIKoZIzj0EAwIDSAAwRQIh
+AKUv+c8v98vypkGMTzMwckGjjVqTef8xodsy6PhcSCq+AiA/n9mDs62hAo5zXyJy
+Bs1s7mqXPf1XgieoxIvs1MqyiA==
+-----END CERTIFICATE-----

xiaomi/examples/02_device_list/main.go

@@ -0,0 +1,108 @@
+// Package main demonstrates device list retrieval with various filters.
+// 运行前提：已配置环境变量 XIAOMI_CLIENT_ID / XIAOMI_CLIENT_SECRET / XIAOMI_ACCESS_TOKEN。
+package main
+
+import (
+	"context"
+	"log"
+	"time"
+
+	"xiaomihome/xiaomi"
+	miotconfig "xiaomihome/miot/examples/config"
+)
+
+func main() {
+	ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
+	defer cancel()
+
+	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{
+		ClientSecret: "",
+		AccessToken:  cfg.AuthInfo.AccessToken,
+		UID:          cfg.UID,
+		UUID:         cfg.UUID,
+	})
+	if err != nil {
+		log.Fatal(err)
+	}
+	defer client.Close()
+
+	log.Println("刷新设备列表...")
+	if err := client.RefreshDevices(ctx); err != nil {
+		log.Printf("刷新设备列表失败: %v", err)
+	}
+
+	allDevices, err := client.GetDevices(ctx)
+	if err != nil {
+		log.Fatal("获取设备列表失败:", err)
+	}
+	log.Printf("=== 全部设备 (%d 个) ===", len(allDevices))
+	for _, d := range allDevices {
+		kind := d.DeviceKind()
+		log.Printf("  %-20s | %-25s | 种类=%-18s | 在线=%v", d.Name, d.Model, kind, d.Online)
+	}
+
+	onlineDevices, err := client.GetDevices(ctx, xiaomi.FilterByOnline())
+	if err != nil {
+		log.Printf("过滤在线设备失败: %v", err)
+	} else {
+		log.Printf("=== 在线设备 (%d 个) ===", len(onlineDevices))
+		for _, d := range onlineDevices {
+			log.Printf("  %s (%s)", d.Name, d.Model)
+		}
+	}
+
+	switchDevices, err := client.GetDevices(ctx, xiaomi.FilterByKind(xiaomi.KindSwitch))
+	if err != nil {
+		log.Printf("过滤开关类设备失败: %v", err)
+	} else {
+		log.Printf("=== 开关类设备 (%d 个) ===", len(switchDevices))
+		for _, d := range switchDevices {
+			log.Printf("  %s (%s)", d.Name, d.Model)
+		}
+	}
+
+	lightDevices, err := client.GetDevices(ctx, xiaomi.FilterByKind(xiaomi.KindLight))
+	if err != nil {
+		log.Printf("过滤灯光类设备失败: %v", err)
+	} else {
+		log.Printf("=== 灯光类设备 (%d 个) ===", len(lightDevices))
+		for _, d := range lightDevices {
+			log.Printf("  %s (%s)", d.Name, d.Model)
+		}
+	}
+
+	onlineLights, err := client.GetDevices(ctx,
+		xiaomi.FilterByOnline(),
+		xiaomi.FilterByKind(xiaomi.KindLight),
+	)
+	if err != nil {
+		log.Printf("组合过滤失败: %v", err)
+	} else {
+		log.Printf("=== 在线灯光类设备 (%d 个) ===", len(onlineLights))
+		for _, d := range onlineLights {
+			log.Printf("  %s (%s)", d.Name, d.Model)
+		}
+	}
+
+	if len(allDevices) > 0 {
+		first := allDevices[0]
+		detail, err := client.GetDevice(ctx, first.DID)
+		if err != nil {
+			log.Printf("获取设备详情失败: %v", err)
+		} else {
+			log.Printf("=== 设备详情: %s ===", detail.Name)
+			log.Printf("  DID: %s", detail.DID)
+			log.Printf("  型号: %s", detail.Model)
+			log.Printf("  URN: %s", detail.URN)
+			log.Printf("  固件: %s", detail.FWVersion)
+			log.Printf("  IP: %s (RSSI: %d)", detail.IP, detail.RSSI)
+		}
+	}
+
+	log.Println("设备列表演示完毕")
+}