feat: 初始化小米 IoT (MIoT) 智能家居 Go 库

- 实现 MIoT 客户端核心功能（MQTT 连接、设备管理、属性读写）
- 支持云端 API 调用与局域网设备发现（mDNS）
- 集成国际化（i18n）多语言支持
- 添加 MIoT 设备规约解析器（spec_parser）
- 包含单元测试与使用示例

miot/miot_client_api.go

@@ -0,0 +1,121 @@
+// Package miot provides MIoT core client for Xiaomi Home devices.
+// It's a Golang port of MIoTClient from xiaomihome-py/miot/.
+package miot
+
+import (
+	"fmt"
+)
+
+// ============================================================================
+// Cloud API calls (aligned with Python miot_client.py)
+// ============================================================================
+
+// SetProp sets a device property via cloud API.
+// Aligns with Python: set_prop_async.
+// did: device ID
+// siid: service IID
+// piid: property IID
+// value: property value
+// Returns: error if failed.
+func (c *MIoTClient) SetProp(did string, siid, piid int, value interface{}) error {
+	if c.http == nil {
+		return fmt.Errorf("HTTP client not available")
+	}
+
+	params := []PropParam{
+		{DID: did, Siid: siid, Piid: piid, Value: value},
+	}
+
+	results, err := c.http.SetProp(params)
+	if err != nil {
+		return err
+	}
+
+	if len(results) > 0 && results[0].Code != 0 {
+		return fmt.Errorf("set property failed, code=%d", results[0].Code)
+	}
+
+	fmt.Printf("[MIoTClient] SetProp: %s/%d/%d = %v\n", did, siid, piid, value)
+	return nil
+}
+
+// GetProp gets a device property via cloud API.
+// Aligns with Python: get_prop_async.
+// did: device ID
+// siid: service IID
+// piid: property IID
+// Returns: property value and error.
+func (c *MIoTClient) GetProp(did string, siid, piid int) (interface{}, error) {
+	if c.http == nil {
+		return nil, fmt.Errorf("HTTP client not available")
+	}
+
+	params := []PropParam{
+		{DID: did, Siid: siid, Piid: piid},
+	}
+
+	results, err := c.http.GetProps(params)
+	if err != nil {
+		return nil, err
+	}
+
+	if len(results) == 0 {
+		return nil, fmt.Errorf("no result for property %d.%d", siid, piid)
+	}
+
+	if results[0].Code != 0 {
+		return nil, fmt.Errorf("get property failed, code=%d", results[0].Code)
+	}
+
+	fmt.Printf("[MIoTClient] GetProp: %s/%d/%d = %v\n", did, siid, piid, results[0].Value)
+	return results[0].Value, nil
+}
+
+// Action executes a device action via cloud API.
+// Aligns with Python: action_async.
+// did: device ID
+// siid: service IID
+// aiid: action IID
+// inList: input parameters
+// Returns: action result and error.
+func (c *MIoTClient) Action(did string, siid, aiid int, inList []interface{}) (map[string]interface{}, error) {
+	if c.http == nil {
+		return nil, fmt.Errorf("HTTP client not available")
+	}
+
+	result, err := c.http.DoAction(did, siid, aiid, inList)
+	if err != nil {
+		return nil, err
+	}
+
+	fmt.Printf("[MIoTClient] Action: %s/%d/%d, result=%v\n", did, siid, aiid, result)
+	return result, nil
+}
+
+// ============================================================================
+// Batch operations (aligned with Python miot_client.py)
+// ============================================================================
+
+// SetProps sets multiple device properties in batch.
+// Aligns with Python: set_props_async.
+// params: slice of PropParam
+// Returns: slice of PropResult and error.
+func (c *MIoTClient) SetProps(params []PropParam) ([]PropResult, error) {
+	if c.http == nil {
+		return nil, fmt.Errorf("HTTP client not available")
+	}
+
+	return c.http.SetProp(params)
+}
+
+// GetProps gets multiple device properties in batch.
+// Aligns with Python: get_props_async.
+// params: slice of PropParam
+// Returns: slice of PropResult and error.
+func (c *MIoTClient) GetProps(params []PropParam) ([]PropResult, error) {
+	if c.http == nil {
+		return nil, fmt.Errorf("HTTP client not available")
+	}
+
+	return c.http.GetProps(params)
+}