issue-18 优化代码(只保证编译通过没检查)

internal/app/service/device/proto/device.proto

@@ -6,32 +6,50 @@ import "google/protobuf/any.proto";
 
 option go_package = "internal/app/service/device/proto";
 
+// --- 通用指令结构 ---
+
 // 指令类型
-enum MethodType{
-  SWITCH = 0; // 启停
+enum MethodType {
+  SWITCH = 0;  // 启停
   COLLECT = 1; // 采集
 }
 
-// 指令
-message Instruction{
+// 指令 (所有空中数据都会被包装在这里面)
+message Instruction {
   MethodType method = 1;
   google.protobuf.Any data = 2;
 }
 
-message Switch{
+// Switch 指令的载荷
+message Switch {
   string device_action = 1; // 指令
-  int32 bus_number = 2; // 总线号
+  int32 bus_number = 2;     // 总线号
+  int32 bus_address = 3;    // 总线地址
+  int32 relay_channel = 4;  // 继电器通道号
+}
+
+
+// --- 批量采集相关结构 ---
+
+// BatchCollectCommand
+// 用于在平台内部构建一个完整的、包含所有元数据的批量采集任务。
+// 这个消息本身不会被发送到设备。
+message BatchCollectCommand {
+  string correlation_id = 1; // 用于关联请求和响应的唯一ID
+  repeated CollectTask tasks = 2;   // 采集任务列表
+}
+
+// CollectTask
+// 定义了单个采集任务的“意图”。
+message CollectTask {
+  string device_action = 1; // 指令
+  int32 bus_number = 2;  // 总线号
   int32 bus_address = 3; // 总线地址
-  int32 relay_channel = 4; // 继电器通道号
 }
 
-message Collect{
-  int32 bus_number = 1; // 总线号
-  int32 bus_address = 2; // 总线地址
-  float value = 3; // 采集值
-}
-
-// 用于批量上报的顶层消息
-message UplinkPayload {
-  repeated Collect readings = 1;
+// CollectResult
+// 这是设备响应的、极致精简的数据包。
+message CollectResult {
+  string correlation_id = 1; // 从下行指令中原样返回的关联ID
+  repeated float values = 2;   // 按预定顺序排列的采集值
 }