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/devices.go

@@ -0,0 +1,140 @@
+package xiaomi
+
+import (
+	"context"
+
+	"xiaomihome/miot"
+)
+
+// DeviceFilter 设备过滤器函数类型
+type DeviceFilter func(*DeviceInfo) bool
+
+// FilterByHome 按家庭过滤
+func FilterByHome(homeID string) DeviceFilter {
+	return func(d *DeviceInfo) bool { return d.HomeID == homeID }
+}
+
+// FilterByRoom 按房间过滤
+func FilterByRoom(roomID string) DeviceFilter {
+	return func(d *DeviceInfo) bool { return d.RoomID == roomID }
+}
+
+// FilterByOnline 只返回在线设备
+func FilterByOnline() DeviceFilter {
+	return func(d *DeviceInfo) bool { return d.Online }
+}
+
+// FilterByModel 按型号过滤
+func FilterByModel(model string) DeviceFilter {
+	return func(d *DeviceInfo) bool { return d.Model == model }
+}
+
+// GetDevices 获取所有设备信息（强类型返回），可选过滤器
+func (c *Client) GetDevices(ctx context.Context, opts ...DeviceFilter) ([]*DeviceInfo, error) {
+	rawList := c.inner.DeviceList()
+	if rawList == nil {
+		return nil, nil
+	}
+
+	devices := make([]*DeviceInfo, 0, len(rawList))
+	for did, raw := range rawList {
+		info := parseDeviceInfo(did, raw)
+		devices = append(devices, info)
+	}
+
+	// 应用过滤器
+	if len(opts) > 0 {
+		filtered := make([]*DeviceInfo, 0, len(devices))
+		for _, d := range devices {
+			ok := true
+			for _, f := range opts {
+				if !f(d) {
+					ok = false
+					break
+				}
+			}
+			if ok {
+				filtered = append(filtered, d)
+			}
+		}
+		return filtered, nil
+	}
+
+	return devices, nil
+}
+
+// GetDevice 获取单个设备信息
+func (c *Client) GetDevice(ctx context.Context, did string) (*DeviceInfo, error) {
+	raw := c.inner.GetDeviceInfo(did)
+	if raw == nil {
+		// 尝试从 cached DeviceList 中获取
+		rawList := c.inner.DeviceList()
+		if rawList != nil {
+			if info, ok := rawList[did]; ok {
+				raw = info
+			}
+		}
+	}
+
+	if raw == nil || len(raw) == 0 {
+		return nil, ErrDeviceNotFound
+	}
+
+	return parseDeviceInfo(did, raw), nil
+}
+
+// RefreshDevices 刷新设备列表
+func (c *Client) RefreshDevices(ctx context.Context) error {
+	return c.inner.RefreshDevices()
+}
+
+// GetMIoTDevice 获取底层 MIoTDevice 实例（供设备控制抽象使用）
+func (c *Client) GetMIoTDevice(did string) *miot.MIoTDevice {
+	// 先尝试缓存
+	if dev := c.getDevice(did); dev != nil {
+		return dev
+	}
+
+	// 从 DeviceList 获取 info 创建
+	raw := c.inner.GetDeviceInfo(did)
+	if raw == nil {
+		rawList := c.inner.DeviceList()
+		if rawList != nil {
+			raw = rawList[did]
+		}
+	}
+
+	if raw == nil {
+		return nil
+	}
+
+	return c.getOrCreateDevice(did, raw)
+}
+
+// parseDeviceInfo 从 map 解析 DeviceInfo
+func parseDeviceInfo(did string, m map[string]interface{}) *DeviceInfo {
+	return &DeviceInfo{
+		DID:          did,
+		Name:         strVal(m, "name"),
+		Model:        strVal(m, "model"),
+		Manufacturer: strVal(m, "manufacturer"),
+		FWVersion:    strVal(m, "fw_version"),
+		Icon:         strVal(m, "icon"),
+		URN:          strVal(m, "urn"),
+		Token:        strVal(m, "token"),
+		IP:           strVal(m, "local_ip"),
+		RSSI:         intVal(m, "rssi"),
+		SSID:         strVal(m, "ssid"),
+		BSSID:        strVal(m, "bssid"),
+		Online:       boolVal(m, "online"),
+		HomeID:       strVal(m, "home_id"),
+		HomeName:     strVal(m, "home_name"),
+		RoomID:       strVal(m, "room_id"),
+		RoomName:     strVal(m, "room_name"),
+		OwnerID:      strVal(m, "owner_id"),
+		ParentID:     strVal(m, "parent_id"),
+		ParentModel:  strVal(m, "parent_model"),
+		GroupID:      strVal(m, "group_id"),
+		ConnectType:  intVal(m, "connect_type"),
+	}
+}