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

@@ -0,0 +1,55 @@
+package xiaomi
+
+import (
+	"context"
+	"crypto/rand"
+	"encoding/hex"
+	"fmt"
+
+	"xiaomihome/miot"
+)
+
+// TokenResult OAuth token 交换结果
+type TokenResult struct {
+	AccessToken  string `json:"access_token"`
+	RefreshToken string `json:"refresh_token"`
+	ExpiresIn    int    `json:"expires_in"`
+	UID          string `json:"uid"`
+}
+
+// AuthURL 生成小米 OAuth 授权页面 URL。
+func AuthURL(cfg Config) string {
+	oa := miot.NewMIoTOauthClient(miot.OAUTH2_CLIENT_ID, "", "cn", generateUUID())
+	return oa.GenAuthURL("", "", nil, false)
+}
+
+// ExchangeCode 用 authorization code 交换 access token。
+func ExchangeCode(ctx context.Context, cfg Config, code string) (*TokenResult, error) {
+	oa := miot.NewMIoTOauthClient(miot.OAUTH2_CLIENT_ID, "", "cn", generateUUID())
+	result, err := oa.GetAccessToken(code)
+	if err != nil {
+		return nil, fmt.Errorf("xiaomi: exchange token: %w", err)
+	}
+	return &TokenResult{
+		AccessToken:  strVal(result, "access_token"),
+		RefreshToken: strVal(result, "refresh_token"),
+		ExpiresIn:    intVal(result, "expires_in"),
+		UID:          strVal(result, "uid"),
+	}, nil
+}
+
+func generateUUID() string {
+	b := make([]byte, 16)
+	rand.Read(b)
+	buf := make([]byte, 36)
+	hex.Encode(buf[:8], b[:4])
+	buf[8] = '-'
+	hex.Encode(buf[9:13], b[4:6])
+	buf[13] = '-'
+	hex.Encode(buf[14:18], b[6:8])
+	buf[18] = '-'
+	hex.Encode(buf[19:23], b[8:10])
+	buf[23] = '-'
+	hex.Encode(buf[24:], b[10:16])
+	return string(buf)
+}