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

@@ -0,0 +1,150 @@
+package devices
+
+import (
+	"context"
+	"xiaomihome/xiaomi"
+)
+
+// Fan 风扇统一控制接口
+type Fan interface {
+	Device
+	TurnOn(ctx context.Context) error
+	TurnOff(ctx context.Context) error
+	IsOn(ctx context.Context) (bool, error)
+
+	SetFanLevel(ctx context.Context, level int) error // 0=off, 1-4 档位
+	GetFanLevel(ctx context.Context) (int, error)
+
+	SetOscillation(ctx context.Context, on bool) error
+	IsOscillating(ctx context.Context) (bool, error)
+
+	SetNaturalWind(ctx context.Context, on bool) error
+	IsNaturalWind(ctx context.Context) (bool, error)
+}
+
+type fanDevice struct {
+	BaseDevice
+	propOn          siidPiid // "on"
+	propFanLevel    siidPiid // "fan-level"
+	propOscillation siidPiid // "horizontal-swing" or "oscillation"
+	propNaturalWind siidPiid // "mode" (natural wind mode)
+}
+
+// NewFan creates a Fan control for the given device.
+func NewFan(client *xiaomi.Client, info *xiaomi.DeviceInfo) (Fan, error) {
+	d := &fanDevice{
+		BaseDevice: NewBaseDevice(client, info),
+	}
+
+	resolver := d.getSpecResolver()
+	if resolver == nil {
+		return nil, xiaomi.ErrNoSPEC
+	}
+
+	siid, piid, ok := resolver.find("on")
+	if !ok {
+		return nil, xiaomi.ErrNotSupported
+	}
+	d.propOn = siidPiid{siid, piid, true}
+
+	if s, p, ok := resolver.find("fan-level"); ok {
+		d.propFanLevel = siidPiid{s, p, true}
+	}
+	if s, p, ok := resolver.find("horizontal-swing"); ok {
+		d.propOscillation = siidPiid{s, p, true}
+	}
+	if s, p, ok := resolver.find("mode"); ok {
+		d.propNaturalWind = siidPiid{s, p, true}
+	}
+
+	return d, nil
+}
+
+func (d *fanDevice) TurnOn(ctx context.Context) error {
+	if !d.propOn.valid {
+		return xiaomi.ErrNotSupported
+	}
+	return d.SetProp(ctx, d.propOn.siid, d.propOn.piid, true)
+}
+
+func (d *fanDevice) TurnOff(ctx context.Context) error {
+	if !d.propOn.valid {
+		return xiaomi.ErrNotSupported
+	}
+	return d.SetProp(ctx, d.propOn.siid, d.propOn.piid, false)
+}
+
+func (d *fanDevice) IsOn(ctx context.Context) (bool, error) {
+	if !d.propOn.valid {
+		return false, xiaomi.ErrNotSupported
+	}
+	prop, err := d.GetProp(ctx, d.propOn.siid, d.propOn.piid)
+	if err != nil {
+		return false, err
+	}
+	if b, ok := prop.Value.(bool); ok {
+		return b, nil
+	}
+	return false, nil
+}
+
+func (d *fanDevice) SetFanLevel(ctx context.Context, level int) error {
+	if !d.propFanLevel.valid {
+		return xiaomi.ErrNotSupported
+	}
+	return d.SetProp(ctx, d.propFanLevel.siid, d.propFanLevel.piid, level)
+}
+
+func (d *fanDevice) GetFanLevel(ctx context.Context) (int, error) {
+	if !d.propFanLevel.valid {
+		return 0, xiaomi.ErrNotSupported
+	}
+	prop, err := d.GetProp(ctx, d.propFanLevel.siid, d.propFanLevel.piid)
+	if err != nil {
+		return 0, err
+	}
+	return toInt(prop.Value), nil
+}
+
+func (d *fanDevice) SetOscillation(ctx context.Context, on bool) error {
+	if !d.propOscillation.valid {
+		return xiaomi.ErrNotSupported
+	}
+	return d.SetProp(ctx, d.propOscillation.siid, d.propOscillation.piid, on)
+}
+
+func (d *fanDevice) IsOscillating(ctx context.Context) (bool, error) {
+	if !d.propOscillation.valid {
+		return false, xiaomi.ErrNotSupported
+	}
+	prop, err := d.GetProp(ctx, d.propOscillation.siid, d.propOscillation.piid)
+	if err != nil {
+		return false, err
+	}
+	if b, ok := prop.Value.(bool); ok {
+		return b, nil
+	}
+	return false, nil
+}
+
+func (d *fanDevice) SetNaturalWind(ctx context.Context, on bool) error {
+	if !d.propNaturalWind.valid {
+		return xiaomi.ErrNotSupported
+	}
+	mode := 0 // normal
+	if on {
+		mode = 1 // natural wind
+	}
+	return d.SetProp(ctx, d.propNaturalWind.siid, d.propNaturalWind.piid, mode)
+}
+
+func (d *fanDevice) IsNaturalWind(ctx context.Context) (bool, error) {
+	if !d.propNaturalWind.valid {
+		return false, xiaomi.ErrNotSupported
+	}
+	prop, err := d.GetProp(ctx, d.propNaturalWind.siid, d.propNaturalWind.piid)
+	if err != nil {
+		return false, err
+	}
+	return toInt(prop.Value) == 1, nil
+}