feat: Round 5 - Memory Service, Tool Engine, Call Records, Thinking Logs

- Fix: Session history flash (race condition + WS guard) - Fix: Chat background overlay + sidebar transparency - Fix: IoT device control (Chinese action names, status field) - Feat: Independent memory-service (port 8091, 13 endpoints) - Feat: Independent tool-engine service (port 8092, 13 tools) - Feat: Tool call logs with paginated DevTools panel - Feat: Thinking log records with DevTools panel - Feat: Future development roadmap document - Chore: Updated .gitignore, go.work, DevTools config - Chore: 5-service health check, project review docs
2026-05-18 20:05:14 +08:00
parent b6ec36886c
commit 78e3f450c2
54 changed files with 7846 additions and 106 deletions
@@ -0,0 +1,191 @@
+package tools
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"io"
+	"log"
+	"net/http"
+	"sync"
+	"time"
+)
+
+// IoTClient IoT 调试服务 HTTP 客户端
+type IoTClient struct {
+	baseURL string
+	client  *http.Client
+
+	// 缓存控制
+	mu        sync.RWMutex
+	cache     []IoTDevice
+	cacheTime time.Time
+	cacheTTL  time.Duration
+}
+
+// NewIoTClient 创建 IoT 客户端
+func NewIoTClient(baseURL string) *IoTClient {
+	return &IoTClient{
+		baseURL: baseURL,
+		client: &http.Client{
+			Timeout: 5 * time.Second,
+		},
+		cacheTTL: 60 * time.Second,
+	}
+}
+
+// GetAllDevices 获取所有设备列表（带缓存）
+func (c *IoTClient) GetAllDevices() ([]IoTDevice, error) {
+	// 检查缓存
+	c.mu.RLock()
+	if c.cache != nil && time.Since(c.cacheTime) < c.cacheTTL {
+		devices := make([]IoTDevice, len(c.cache))
+		copy(devices, c.cache)
+		c.mu.RUnlock()
+		return devices, nil
+	}
+	c.mu.RUnlock()
+
+	// 请求 API
+	resp, err := c.client.Get(c.baseURL + "/api/v1/devices")
+	if err != nil {
+		log.Printf("[IoT客户端] 请求失败: %v", err)
+		return nil, fmt.Errorf("获取设备列表失败: %w", err)
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode != http.StatusOK {
+		return nil, fmt.Errorf("获取设备列表返回状态码 %d", resp.StatusCode)
+	}
+
+	var result struct {
+		Devices []IoTDevice `json:"devices"`
+		Total   int         `json:"total"`
+	}
+	if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
+		return nil, fmt.Errorf("解析设备列表失败: %w", err)
+	}
+
+	// 更新缓存
+	c.mu.Lock()
+	c.cache = result.Devices
+	c.cacheTime = time.Now()
+	c.mu.Unlock()
+
+	return result.Devices, nil
+}
+
+// GetDevice 获取单个设备详情
+func (c *IoTClient) GetDevice(id string) (*IoTDevice, error) {
+	resp, err := c.client.Get(c.baseURL + "/api/v1/devices/" + id)
+	if err != nil {
+		return nil, fmt.Errorf("获取设备 %s 失败: %w", id, err)
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == http.StatusNotFound {
+		return nil, fmt.Errorf("设备 %s 不存在", id)
+	}
+	if resp.StatusCode != http.StatusOK {
+		return nil, fmt.Errorf("获取设备 %s 返回状态码 %d", id, resp.StatusCode)
+	}
+
+	var result struct {
+		Device IoTDevice `json:"device"`
+	}
+	if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
+		return nil, fmt.Errorf("解析设备信息失败: %w", err)
+	}
+
+	return &result.Device, nil
+}
+
+// ToggleDevice 切换设备开关状态
+func (c *IoTClient) ToggleDevice(id string) error {
+	req, err := http.NewRequest(http.MethodPost, c.baseURL+"/api/v1/devices/"+id+"/toggle", nil)
+	if err != nil {
+		return fmt.Errorf("创建切换请求失败: %w", err)
+	}
+
+	resp, err := c.client.Do(req)
+	if err != nil {
+		return fmt.Errorf("切换设备 %s 失败: %w", id, err)
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == http.StatusNotFound {
+		return fmt.Errorf("设备 %s 不存在", id)
+	}
+	if resp.StatusCode != http.StatusOK {
+		return fmt.Errorf("切换设备 %s 返回状态码 %d", id, resp.StatusCode)
+	}
+
+	// 切换后清除缓存，确保下次查询获取最新状态
+	c.mu.Lock()
+	c.cache = nil
+	c.mu.Unlock()
+
+	return nil
+}
+
+// SetDeviceProperty 设置设备属性（温度、亮度、位置、模式、颜色等）
+func (c *IoTClient) SetDeviceProperty(id string, field string, value interface{}) error {
+	body, err := json.Marshal(map[string]interface{}{
+		"field": field,
+		"value": value,
+	})
+	if err != nil {
+		return fmt.Errorf("序列化请求失败: %w", err)
+	}
+
+	req, err := http.NewRequest(http.MethodPost, c.baseURL+"/api/v1/devices/"+id+"/set", nil)
+	if err != nil {
+		return fmt.Errorf("创建设置请求失败: %w", err)
+	}
+	req.Header.Set("Content-Type", "application/json")
+	req.Body = io.NopCloser(bytes.NewReader(body))
+
+	resp, err := c.client.Do(req)
+	if err != nil {
+		return fmt.Errorf("设置设备 %s 属性失败: %w", id, err)
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == http.StatusNotFound {
+		return fmt.Errorf("设备 %s 不存在", id)
+	}
+	if resp.StatusCode != http.StatusOK {
+		var errResp struct {
+			Error string `json:"error"`
+		}
+		json.NewDecoder(resp.Body).Decode(&errResp)
+		if errResp.Error != "" {
+			return fmt.Errorf("设置设备 %s 属性失败: %s", id, errResp.Error)
+		}
+		return fmt.Errorf("设置设备 %s 属性返回状态码 %d", id, resp.StatusCode)
+	}
+
+	// 修改后清除缓存
+	c.mu.Lock()
+	c.cache = nil
+	c.mu.Unlock()
+
+	return nil
+}
+
+// GetDevicesForContext 获取设备状态摘要（供上下文注入使用，失败不报错）
+func (c *IoTClient) GetDevicesForContext() []IoTDevice {
+	devices, err := c.GetAllDevices()
+	if err != nil {
+		log.Printf("[IoT客户端] 获取设备状态摘要失败: %v", err)
+		return nil
+	}
+	return devices
+}
+
+// InvalidateCache 使缓存失效
+func (c *IoTClient) InvalidateCache() {
+	c.mu.Lock()
+	c.cache = nil
+	c.mu.Unlock()
+}