refactor: 重大架构升级 — HomeID/RoomID int64化 + 设备驱动重构 + 结构化日志

主要变更:

**类型系统重构**
- HomeInfo.ID/RoomInfo.ID/HomeID 从 string 改为 int64,json tag 使用 ,string
- GetHome/GetRooms/GetRoomDevices 接口同步修改
- 新增 int64FromStr 工具函数,更新 parseHomeInfo 解析逻辑

**新增 Speaker 设备**
- 新增 KindSpeaker 类型
- classify 映射覆盖 speaker/bluetooth-speaker/alarm-clock/media-player/playback/music

**设备驱动重构**
- AC 驱动彻底重写:从硬编码常量改为基于 SPEC ValueList 的动态 valMapper
- 所有设备(Fan/Humidifier/Light/OccupancySensor/Switch/TempHumiditySensor/Thermostat/Vacuum/WaterHeater/Cover)新增 GetState() 和 FetchState(ctx) 接口
- base.go 新增 specResolver.format() 方法

**MIoT 模块增强**
- MIoTClient 新增 homeIDs 字段,支持按家庭过滤设备
- RefreshDevices 支持 homeIDs 参数
- SpecStdLib 引入 logger.Logger,log.Printf 全部迁移为结构化日志

**其他**
- Config 新增 RedirectURL 和 HomeIDs 字段
- AuthInfo.ExpiresIn 类型从 int 改为 int32
- UUID 生成简化为 hex.EncodeToString
- 新增 github.com/sirupsen/logrus 依赖
- .gitignore 新增 examples/*/data/ 忽略规则
- 删除已提交的 config.json 敏感配置
This commit is contained in:
2026-07-13 10:40:20 +08:00
parent 8ffc9e4e44
commit b808e51b3e
68 changed files with 2506 additions and 688 deletions
+11 -7
View File
@@ -1,6 +1,9 @@
package xiaomi
import "context"
import (
"context"
"strconv"
)
// GetHomeList 获取所有家庭列表
// 合并自有家庭 (home_list) 和共享家庭 (share_home_list)
@@ -34,7 +37,7 @@ func (c *Client) GetHomeList(ctx context.Context) ([]*HomeInfo, error) {
}
// GetHome 获取指定家庭详情(含房间)
func (c *Client) GetHome(ctx context.Context, homeID string) (*HomeInfo, error) {
func (c *Client) GetHome(ctx context.Context, homeID int64) (*HomeInfo, error) {
homes, err := c.GetHomeList(ctx)
if err != nil {
return nil, err
@@ -50,7 +53,7 @@ func (c *Client) GetHome(ctx context.Context, homeID string) (*HomeInfo, error)
}
// GetRooms 获取指定家庭的所有房间
func (c *Client) GetRooms(ctx context.Context, homeID string) ([]*RoomInfo, error) {
func (c *Client) GetRooms(ctx context.Context, homeID int64) ([]*RoomInfo, error) {
home, err := c.GetHome(ctx, homeID)
if err != nil {
return nil, err
@@ -64,7 +67,7 @@ func (c *Client) GetRooms(ctx context.Context, homeID string) ([]*RoomInfo, erro
// GetRoomDevices 获取指定房间的设备 DID 列表。
// 优先使用 homeroom API 返回的 dids,为空时从设备列表按 room_id 过滤。
func (c *Client) GetRoomDevices(ctx context.Context, homeID, roomID string) ([]string, error) {
func (c *Client) GetRoomDevices(ctx context.Context, homeID, roomID int64) ([]string, error) {
rooms, err := c.GetRooms(ctx, homeID)
if err != nil {
return nil, err
@@ -80,7 +83,7 @@ func (c *Client) GetRoomDevices(ctx context.Context, homeID, roomID string) ([]s
}
// 退化:从设备列表按 room_id 过滤
devices, err := c.GetDevices(ctx, FilterByRoom(roomID))
devices, err := c.GetDevices(ctx, FilterByRoom(strconv.FormatInt(roomID, 10)))
if err != nil {
return nil, err
}
@@ -94,7 +97,7 @@ func (c *Client) GetRoomDevices(ctx context.Context, homeID, roomID string) ([]s
// parseHomeInfo 从 miot 返回的 map 解析 HomeInfo(含房间列表)
func parseHomeInfo(m map[string]interface{}, shared bool) *HomeInfo {
h := &HomeInfo{
ID: strVal(m, "home_id"),
ID: int64FromStr(strVal(m, "home_id")),
Name: strVal(m, "home_name"),
UID: strVal(m, "uid"),
GroupID: strVal(m, "group_id"),
@@ -118,8 +121,9 @@ func parseHomeInfo(m map[string]interface{}, shared bool) *HomeInfo {
if roomMap, ok := m["room_info"].(map[string]interface{}); ok {
for _, v := range roomMap {
if rm, ok := v.(map[string]interface{}); ok {
roomID := int64FromStr(strVal(rm, "room_id"))
h.Rooms = append(h.Rooms, RoomInfo{
ID: strVal(rm, "room_id"),
ID: roomID,
Name: strVal(rm, "room_name"),
HomeID: h.ID,
DidList: strSliceVal(rm, "dids"),