64 lines
2.1 KiB
Go
64 lines
2.1 KiB
Go
package protocol
|
||
|
||
// ============================================================
|
||
// [协议] 版本化消息结构（JSON-RPC 风格）
|
||
// 前端 / Go / Python 三方应对齐同一套字段名
|
||
// 真正接线时：Go 做路由，Python 实现 method 业务
|
||
// ============================================================
|
||
|
||
// Request 通用请求信封
|
||
type Request struct {
|
||
ProtocolVersion string `json:"protocolVersion"` // 必须 = protocol.Version
|
||
ID string `json:"id"`
|
||
Method string `json:"method"` // 例: "agent.plan_next" / "device.tap"
|
||
Params any `json:"params,omitempty"`
|
||
}
|
||
|
||
// Response 通用响应信封
|
||
type Response struct {
|
||
ProtocolVersion string `json:"protocolVersion"`
|
||
ID string `json:"id"`
|
||
Result any `json:"result,omitempty"`
|
||
Error *Error `json:"error,omitempty"`
|
||
}
|
||
|
||
// Error 结构化错误
|
||
type Error struct {
|
||
Code int `json:"code"`
|
||
Message string `json:"message"`
|
||
}
|
||
|
||
// ---- 常用 method 常量（避免魔法字符串）----
|
||
|
||
const (
|
||
MethodAgentHealth = "agent.health"
|
||
MethodAgentPlanNext = "agent.plan_next" // 看图+对话 → 下一步操作
|
||
MethodAgentChat = "agent.chat" // 纯对话（可先接云端 API）
|
||
)
|
||
|
||
// PlanNextParams agent.plan_next 入参（骨架，后续扩展）
|
||
type PlanNextParams struct {
|
||
SessionID string `json:"sessionId"`
|
||
DeviceID string `json:"deviceId"`
|
||
FrameBase64 string `json:"frameBase64,omitempty"` // 当前帧；空则由 Core 现截
|
||
UserMessage string `json:"userMessage,omitempty"`
|
||
}
|
||
|
||
// PlanNextResult 模型规划出的下一步（骨架）
|
||
type PlanNextResult struct {
|
||
Thought string `json:"thought"`
|
||
Actions []DeviceAction `json:"actions"`
|
||
}
|
||
|
||
// DeviceAction 设备动作（由 Device Core 执行）
|
||
type DeviceAction struct {
|
||
Type string `json:"type"` // tap | swipe | key | text | wait
|
||
X float64 `json:"x,omitempty"`
|
||
Y float64 `json:"y,omitempty"`
|
||
X2 float64 `json:"x2,omitempty"`
|
||
Y2 float64 `json:"y2,omitempty"`
|
||
Text string `json:"text,omitempty"`
|
||
Key string `json:"key,omitempty"`
|
||
MS int `json:"ms,omitempty"`
|
||
}
|