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

@@ -0,0 +1,88 @@
+package devices
+
+import (
+	"context"
+	"fmt"
+
+	"xiaomihome/xiaomi"
+)
+
+// OccupancySensor 人在传感器读取接口（只读）。
+type OccupancySensor interface {
+	Device
+
+	// IsOccupied 是否有人。
+	IsOccupied(ctx context.Context) (bool, error)
+
+	// GetIlluminance 环境光照度（lux），部分传感器支持。
+	GetIlluminance(ctx context.Context) (float64, error)
+}
+
+// NewOccupancySensor 创建人在传感器。失败返回错误（含无 SPEC / 无相关属性）。
+func NewOccupancySensor(client *xiaomi.Client, info *xiaomi.DeviceInfo) (OccupancySensor, error) {
+	if info == nil {
+		return nil, xiaomi.ErrDeviceNotFound
+	}
+
+	miotDev := client.GetMIoTDevice(info.DID)
+	if miotDev == nil {
+		return nil, fmt.Errorf("%w: device not initialized", xiaomi.ErrDeviceNotFound)
+	}
+	spec := miotDev.SpecInstance()
+	if spec == nil {
+		return nil, fmt.Errorf("%w: device has no SPEC information", xiaomi.ErrNotSupported)
+	}
+
+	d := &occupancyDevice{
+		BaseDevice: BaseDevice{client: client, info: info},
+	}
+
+	for _, svc := range spec.Services {
+		for _, prop := range svc.Properties {
+			switch propertyShortName(prop.Type) {
+			case "occupancy":
+				if !d.propOccupancy.valid {
+					d.propOccupancy = siidPiid{svc.IID, prop.PIID, true}
+				}
+			case "illumination":
+				if !d.propIlluminance.valid {
+					d.propIlluminance = siidPiid{svc.IID, prop.PIID, true}
+				}
+			}
+		}
+	}
+
+	if !d.propOccupancy.valid {
+		return nil, fmt.Errorf("%w: no occupancy property in SPEC", xiaomi.ErrNotSupported)
+	}
+
+	return d, nil
+}
+
+type occupancyDevice struct {
+	BaseDevice
+	propOccupancy   siidPiid
+	propIlluminance siidPiid
+}
+
+func (d *occupancyDevice) IsOccupied(ctx context.Context) (bool, error) {
+	prop, err := d.GetProp(ctx, d.propOccupancy.siid, d.propOccupancy.piid)
+	if err != nil {
+		return false, err
+	}
+	if b, ok := prop.Value.(bool); ok {
+		return b, nil
+	}
+	return false, nil
+}
+
+func (d *occupancyDevice) GetIlluminance(ctx context.Context) (float64, error) {
+	if !d.propIlluminance.valid {
+		return 0, xiaomi.ErrNotSupported
+	}
+	prop, err := d.GetProp(ctx, d.propIlluminance.siid, d.propIlluminance.piid)
+	if err != nil {
+		return 0, err
+	}
+	return toFloat(prop.Value), nil
+}