mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-11-01 06:47:29 +00:00
* feat(kernel): 模块化内核 + 编译期依赖图定序
把单体 init 序列拆成「模块自声明依赖 + 编译期生成依赖图 + 运行期只读图」。
## 为什么
原 cmd/homed/main.go 里 17 步 init 是**手写顺序**,依赖关系只存在于
注释和人脑里。实测踩到的坑(见 docs/zh/kernel-modularization-design.md):
· nlp.defaultParser 被 initONNXParser 写、被 distiller 读,两者相距 60 行,
只靠 ticker 10min 才没炸(隐式依赖,无声明)
· 加一个模块要人肉找"该插在哪",插错的表现是运行期 nil 解引用
· 关停是 defer ks.CloseAll(),而热更新路径 os.Exit(42) **跳过 defer**
⇒ docStore/distiller/textMem 的 flush 全部丢失(每次热更新都发生)
## 怎么改
- internal/kernelboot/:KernelState(一个结构体收全部包级共享变量,字段
nil 安全)、Module 接口、graphfile(依赖图编解码 + 与二进制 hash 对账)、
scheduler(按 BFS 层并行 Init)、syncbus(层边界写通知)、
lifecycle(Quiesce/Resume 可逆伪关机,区别于一次性 CloseAll)
- internal/kernelmod/<name>/:每个模块一个文件夹,Requires/Provides 自声明;
all/all.go 是唯一的 import 清单(Go 循环导入约束)
- cmd/homed-depgraph:编译期生成依赖图,Makefile 注入 digest
- 运行期只**读**图,不计算顺序(顺序是编译期决定的,源码里没有中央清单)
## 判据
kernelboot 8 条 + 图失败模式 7 条(全部拒绝并给准确错误)+ 模块目录数
与注册表一致性。变异测试 15/15 咬住,含:
· 删掉 AddCloser 的锁 → -race 报数据竞争
· Scheduler 同批跑去重 → 203 vs 200
· 图 hash 不匹配 → 拒绝启动
## 顺带修的缺陷
热更新路径漏调模块关闭 ⇒ 显式 stopKernelModules(),并用 AST 判据钉住
"必须在 os.Exit 之前"(字符串检查在本仓已骗过我三次)。
实测:冷启动 1630ms(5 层/17 模块,原 17 步串行);生产 22 插件全部建链。
* feat(security): 密钥防火墙 + 配置加密 + close 纪律
## 密钥防火墙
模型只见别名、不见明文;插件工具调用入口(StageHost.ExecuteTool)做入向
回填。三维能力:
· 出向:工具输出里的密钥被替换成 [[secret:name]] 别名后才进上下文
· 入向:模型传别名,入口处填回真值(插件完全无感知)
· 存储:config.db 里不存明文(0644 的库可读),敏感值独立 0600 文件
模式库「宁漏勿误伤」:宁可漏掉一次替换,也不把正常文本误当密钥。
## 配置加密
- internal/security/{codec,key,keyring,store,global}.go:AES-256-GCM,
enc:v1: 前缀,密钥轮换(OldKeys 解码 + 新钥加密)
- harden.go:数据目录权限收紧
- embedded.go:支持内嵌主密钥(可选,仍保留外部 key 文件路径)
- EncryptExistingSecrets / AuditSecrets:启动时幂等迁移 + 审计
## close 纪律(用户明确要求:只要调 close 就要有前置检查)
internal/safeclose:Safe / SafeFunc。全仓 37 处裸 close(chan) → 0。
关键教训(都写进注释和判据):
· `select { case <-ch: default: close(ch) }` **不是**并发安全的
(两个 goroutine 可同时命中 default)—— healthcheck 原先是这种写法
· `sync.Once` **不可重入**:X.Do(func(){ Safe(&X, ...) }) 会自锁,
症状是 go test 直接挂住(3 个包 600s 超时),栈里只有嵌套的 Once.Do
· map 里按请求持有的 channel(mcp/stdio.go、clawhubadapter/sidecar.go)
改成 *pendingRPC 包装,每通道一个 once
## 判据
security 全量 + TestNoBareCloseOutsideSafeclose(AST 级扫描,含注释剥离)
+ TestNoNestedSelfOnceDeadlock(正则修正:\w+ 不匹配点号,捕获组要含 '.')。
变异 2/2 咬住。全量 52 包 ok。
* feat(plugin+deploy): 插件三态生命周期、数据目录迁移、发行包修复
## 插件三态生命周期(用户要求:自动启动 / 启用但不自动启动 / 禁用)
- Manifest 新增 requires_facilities / auto_start(*bool,用于区分
"未声明"与"显式 false")
- plugin-host 模块(internal/kernelmod/pluginhost):用 kernelboot.Scheduler
按依赖时机拉起,**不再手写两阶段**
- 运行态停启 StopPlugin/StartPlugin **可逆**:不写 disabled_plugins
(不改用户决定)、不置 shuttingDown(之后还能加载)、会摘掉注册面
- 与 StopAll 的区别写进注释 —— StopAll 置 shuttingDown 后**永久无法加载**,
那是进程退出用的,误用于"暂停"就是关了就死
## 数据目录迁移(伪关机 → 迁移 → 唤醒)
- kernelboot/lifecycle.go:Quiesce/Resume(可逆,区别于一次性 CloseAll),
逆序暂停、逆序恢复、Pause 失败回滚
- kernelboot/migrate.go:BeginMigration/End 编排(先停插件 → 再停内核写者
→ 等在途归零)
- distiller/textmem 增 Pause/Resume 门(不是 cancel —— cancel 不可逆,
恢复要重建整个对象)
- 模块 migration:体检 + 生成可执行迁移脚本
★ 迁移脚本的三个实测教训(都写成了判据):
1. 无条件改 /etc/systemd/system ⇒ 演练把**生产** -data 改成了演练目录。
加 --dry-run(零改动)+ 强制校验 systemd 当前 -data == OLD
2. 本机没装 rsync,脚本在"服务已停、数据未搬"处硬失败 ⇒ cp -a 回退,
并明确警告不保硬链接/ACL(生产 plugindev 有大量 git 硬链接)
## 发行包修复(全部经实测确认)
1. package-linux.sh **完全漏打 depgraph.bin** ⇒ 内核 exit 1
("生产构建(内嵌 hash 非空)但读不到依赖图")
2. build_homed 不走 Makefile ⇒ 单独修 Makefile 无效,必须同时生成图+注入
3. build.sh 的 LDFLAGS 用**历史模块路径 gitcode.com** ⇒ -X 静默 no-op
⇒ --version 显示 unknown
4. Makefile -ldflags 用**单引号** ⇒ 注入了字面 $GRAPH_HASH
## ★ build.sh 的版本号必须校验(真实事故)
原 `VERSION="$(git describe --tags --dirty)"`。无 tag 分支上它返回**分支名**
`backup/pre-identity-rewrite-20261005-51-g03d87a4e-dirty`,被注入 meta.Version
⇒ 插件握手判据 MajorVersion() 把整串当主版本 ⇒ **22 个子进程插件全部
握手失败**("主版本不匹配")。内核活着、systemd active、日志每条都像
插件的问题 —— 实际是发行包带着非法版本号。
修法:git describe 只在形如 vX.Y.Z 时采用,否则回退 meta.Version(权威源),
并对最终值做形态守卫。deploy/packaging/version_guard_test.go 3 条判据,
变异 2/2 咬住。
## deb 的 systemd unit 改为 guard 模式
ExecStart=/usr/bin/homed --role=guard --data /var/lib/homeagent
(worker exit 42 → guard 重拉,不经过 systemd、不计失败)
含 RestartSteps/RestartMaxDelaySec/TimeoutStopSec + 硬化
(NoNewPrivileges/ProtectSystem/ProtectHome/DevicePolicy/ReadWritePaths)。
## 其他
- internal/plugin/proc:非法 JSON 帧的报错**可定位**(内容摘要 + 可能原因 +
修法)。生产实测 1038 条非法帧(插件往 stdout 打日志 = 污染协议通道)
- 示例插件 4 个 14 处 fmt.Printf → log.Printf
- hmapdev 模板同步修复;scaffold 判据剥离注释(模板注释里就含 fmt.Printf)
* chore: 收尾(主密钥轮换命令、IPC/知识库加固、SDK 对齐)
- cmd/homed-key-rotate:把 security 里的 RotateKey/RotateKeyFile/RekeySecrets
串成一条**可执行**的运维路径。没有它,E-1 就只是库里的能力而不是
"出事时能做的事",而轮换的价值恰恰在于能执行。
- cmd/homed:kmod_runtime(模块装配入口)、plugins_scheduled(failback
白名单)、memcandidate、bootstrap_order_test / shutdown_flush_test
- internal/ipc、internal/devicebridge、internal/knowledge:配套加固
- third_party/homeagent-sdk/sdk:PluginMgrAPI 增三态能力(mgrStop/mgrStart/
mgrIsRuntimeStopped)+ settings 对齐
判据:bootstrap_order_test(启动顺序不依赖手写序列)、
shutdown_flush_test(停机的两条路径必须对称 —— exit 42 会跳过 defer,
热更新路径下模块关闭/flush 曾全部丢失)。
* test(security): 测试夹具改用不可误认的占位值(修 push protection 拦截)
GitHub secret scanning 拦住了推送:三处测试夹具用了"看起来像真密钥"的
字面量:
internal/security/prefilter_test.go:39
internal/security/store_test.go:177
internal/security/survey_test.go:20
它们全是**假密钥**(`AKIAIOSFODNN7EXAMPLE` 是 AWS 官方文档的标准示例,
其余是 `abcdefghij...` 这类可读占位符),但扫描器无法区分 —— 它只看形态。
★ 不绕过(不用 unblock URL、不加 allowlist):直接改夹具。
原因:一旦允许"假密钥可以通过",真密钥混进来时就没有最后一道门了。
改法:保留**模式库匹配所需的结构**,把可识别内容换成 FAKE:
glpat-abcdefghijklmnopqrst → glpat-FAKE-TEST-TOKEN-NOT-REAL
sk-abcdefghij...012345 → sk-FAKE-TEST-KEY-NOT-REAL-0000000
AKIAIOSFODNN7EXAMPLE → AKIA0000FAKE0000TEST (保持 20 字符)
ASIAIOSFODNN7EXAMPLE → ASIA0000FAKE0000TEST
xoxb-123456789012-abcdefghijklmnop → xoxb-FAKE-TEST-TOKEN-NOT-REAL
★ 中途踩到一次:AWS 键的模式是 `\b(AKIA|ASIA)[0-9A-Z]{16}\b`(共 20 字符),
我第一次替换成 19 字符的 `AKIAFAKETESTKEY0000` ⇒ 模式匹配不上 ⇒
TestSurvey_WhatIsCaught / TestRecognizesCommonShapes /
TestPrefilterNeverBlocksRealMatches 三条当场变红。
判据正确地拒绝了"为了过扫描器而削弱覆盖"。
顺带核实:全仓 grep 无任何真实密钥泄漏。
* fix(packaging): package-linux.sh 的版本解析与 build.sh 统一
上一版只修了 build.sh,漏了 package-linux.sh —— 它仍只看 git describe:
VERSION="${VERSION:-$(git describe --tags --dirty)}"
无 tag 分支上 git describe 返回**分支名**
(backup/pre-identity-rewrite-20261005-56-g98850e1),守卫会正确拒绝,
但要求人**手动传 VERSION** 才能打包。而 build.sh 早已能自动回退 meta.Version
⇒ 同一个版本,走 build.sh 打得出来、走 package-linux.sh 打不出来。
危害不只是"要手动传参":运维为了跑通会去掉守卫,而分支名一旦进
meta.Version 就是**插件协议主版本**的来源 ⇒ 22 个子进程插件全部握手失败
(这是真实发生过的事故,见 3efa4e5)。
修法:两个脚本用同一套规则(git describe 仅在 vX.Y.Z 形态时采用,
否则回退 meta.Version),并对最终值做形态守卫。
判据:TestBothPackagingScriptsShareVersionRules —— 逐个读两个脚本,
要求都能从 meta/meta.go 取权威版本、都校验 git describe 形态。
变异(把 package-linux.sh 改回旧规则)咬住并准确指出是哪个脚本。
实测:不传 VERSION 跑 package-linux.sh,输出
[PKG] warn: git describe 给出非版本串(...),改用 meta.Version=1.4.0
Version: 1.4.0
* fix(test): 跨仓判据在 CI 上应 skip 而非 fail(修 PR 双红)
CI 上 "Go build / vet / test" 与 "Build linux/amd64" 双红:
--- FAIL: TestHmapdevTemplateImplementsAllPluginMgrMethods
bridge_sync_test.go:170: 读模板: open
../../../third_party/homeagent-sdk/tools/hmapdev/templates/proc_main.go.tmpl:
no such file or directory
## 根因:判据依赖了一个**被 gitignore 的路径**
`.gitignore:33` 有 `third_party/homeagent-sdk/tools/`(SDK 仓自治,本仓不跟踪)。
于是:
· 本机(完整 SDK 检出)有该文件 ⇒ 判据通过
· CI(只 checkout 本仓)没有该文件 ⇒ Fatalf ⇒ **必红**
我提交时只在本机跑测试、没看 CI,所以这个问题拖到 PR 才暴露。
## 修法
文件缺失时 `t.Skipf` 而不是 `t.Fatalf`。
★ 这不是"放弃检查":
· 跨仓一致性由 **SDK 仓自己的判据**守着
(tools/hmapdev/scaffold_stdout_test.go 等),那里才是模板的真实归属地
· 本判据在本机开发时**仍然生效**(已验证:有文件时 PASS,缺文件时 SKIP)
## 验证
· 本机(有文件) → PASS(判据真跑)
· 模拟 CI(移走 tools/)→ SKIP(不再 fail)
· 全量 53 包 ok / 0 fail
## 顺带
同目录还有 e2e_template_test.go 也读 tools/,但它是 `//go:build` 门控的
e2e 判据,CI 默认不跑,无需处理。
---------
Co-authored-by: JianFeeeee <JianFeeeee@users.noreply.gitcode.com>
473 lines
12 KiB
Go
473 lines
12 KiB
Go
package main
|
||
|
||
import (
|
||
"bufio"
|
||
"crypto/rand"
|
||
"crypto/sha256"
|
||
"encoding/base64"
|
||
"encoding/binary"
|
||
"encoding/json"
|
||
"fmt"
|
||
"io"
|
||
"log"
|
||
"net"
|
||
"net/http"
|
||
"sync"
|
||
"time"
|
||
|
||
"github.com/JianFeeeee/HomeAgent/internal/devicebridge/client"
|
||
)
|
||
|
||
// ===== WebSocket 帧编码/解码(RFC 6455) =====
|
||
|
||
const wsGUID = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11"
|
||
|
||
type WSConn struct {
|
||
conn net.Conn
|
||
rw *bufio.ReadWriter
|
||
mu sync.Mutex
|
||
}
|
||
|
||
func upgradeWS(w http.ResponseWriter, r *http.Request) (*WSConn, error) {
|
||
if r.Header.Get("Upgrade") != "websocket" {
|
||
http.Error(w, "not websocket", 400)
|
||
return nil, fmt.Errorf("not websocket upgrade")
|
||
}
|
||
key := r.Header.Get("Sec-WebSocket-Key")
|
||
if key == "" {
|
||
http.Error(w, "missing key", 400)
|
||
return nil, fmt.Errorf("missing Sec-WebSocket-Key")
|
||
}
|
||
|
||
h := sha256.Sum256([]byte(key + wsGUID))
|
||
accept := base64.StdEncoding.EncodeToString(h[:])
|
||
|
||
hijacker, ok := w.(http.Hijacker)
|
||
if !ok {
|
||
http.Error(w, "hijack not supported", 500)
|
||
return nil, fmt.Errorf("hijack not supported")
|
||
}
|
||
|
||
conn, bufrw, err := hijacker.Hijack()
|
||
if err != nil {
|
||
http.Error(w, "hijack failed", 500)
|
||
return nil, err
|
||
}
|
||
|
||
resp := "HTTP/1.1 101 Switching Protocols\r\n" +
|
||
"Upgrade: websocket\r\n" +
|
||
"Connection: Upgrade\r\n" +
|
||
"Sec-WebSocket-Accept: " + accept + "\r\n\r\n"
|
||
if _, err := bufrw.WriteString(resp); err != nil {
|
||
conn.Close()
|
||
return nil, err
|
||
}
|
||
if err := bufrw.Flush(); err != nil {
|
||
conn.Close()
|
||
return nil, err
|
||
}
|
||
|
||
return &WSConn{conn: conn, rw: bufrw}, nil
|
||
}
|
||
|
||
func (ws *WSConn) ReadFrame() (opcode byte, payload []byte, err error) {
|
||
for {
|
||
b0, err := ws.rw.ReadByte()
|
||
if err != nil {
|
||
return 0, nil, err
|
||
}
|
||
opcode = b0 & 0x0F
|
||
|
||
b1, err := ws.rw.ReadByte()
|
||
if err != nil {
|
||
return 0, nil, err
|
||
}
|
||
masked := b1&0x80 != 0
|
||
length := int64(b1 & 0x7F)
|
||
|
||
switch {
|
||
case length == 126:
|
||
var b [2]byte
|
||
if _, err := io.ReadFull(ws.rw, b[:]); err != nil {
|
||
return 0, nil, err
|
||
}
|
||
length = int64(binary.BigEndian.Uint16(b[:]))
|
||
case length == 127:
|
||
var b [8]byte
|
||
if _, err := io.ReadFull(ws.rw, b[:]); err != nil {
|
||
return 0, nil, err
|
||
}
|
||
length = int64(binary.BigEndian.Uint64(b[:]))
|
||
}
|
||
|
||
var maskKey [4]byte
|
||
if masked {
|
||
if _, err := io.ReadFull(ws.rw, maskKey[:]); err != nil {
|
||
return 0, nil, err
|
||
}
|
||
}
|
||
|
||
payload = make([]byte, length)
|
||
if _, err := io.ReadFull(ws.rw, payload); err != nil {
|
||
return 0, nil, err
|
||
}
|
||
if masked {
|
||
for i := range payload {
|
||
payload[i] ^= maskKey[i%4]
|
||
}
|
||
}
|
||
|
||
if opcode == 0x8 { // Close
|
||
ws.sendFrame(0x8, nil, false)
|
||
return opcode, payload, fmt.Errorf("ws closed")
|
||
}
|
||
if opcode == 0x9 { // Ping
|
||
ws.sendFrame(0xA, payload, false) // Pong
|
||
continue
|
||
}
|
||
if opcode == 0xA { // Pong
|
||
continue
|
||
}
|
||
|
||
return opcode, payload, nil
|
||
}
|
||
}
|
||
|
||
func (ws *WSConn) sendFrame(opcode byte, payload []byte, masked bool) error {
|
||
ws.mu.Lock()
|
||
defer ws.mu.Unlock()
|
||
|
||
buf := []byte{0x80 | opcode} // FIN + opcode
|
||
length := len(payload)
|
||
|
||
switch {
|
||
case length <= 125:
|
||
if masked {
|
||
buf = append(buf, byte(length)|0x80)
|
||
} else {
|
||
buf = append(buf, byte(length))
|
||
}
|
||
case length <= 65535:
|
||
if masked {
|
||
buf = append(buf, 126|0x80)
|
||
} else {
|
||
buf = append(buf, 126)
|
||
}
|
||
b := make([]byte, 2)
|
||
binary.BigEndian.PutUint16(b, uint16(length))
|
||
buf = append(buf, b...)
|
||
default:
|
||
if masked {
|
||
buf = append(buf, 127|0x80)
|
||
} else {
|
||
buf = append(buf, 127)
|
||
}
|
||
b := make([]byte, 8)
|
||
binary.BigEndian.PutUint64(b, uint64(length))
|
||
buf = append(buf, b...)
|
||
}
|
||
|
||
var maskKey [4]byte
|
||
if masked {
|
||
rand.Read(maskKey[:])
|
||
buf = append(buf, maskKey[:]...)
|
||
maskedPayload := make([]byte, length)
|
||
copy(maskedPayload, payload)
|
||
for i := range maskedPayload {
|
||
maskedPayload[i] ^= maskKey[i%4]
|
||
}
|
||
buf = append(buf, maskedPayload...)
|
||
} else {
|
||
buf = append(buf, payload...)
|
||
}
|
||
|
||
_, err := ws.conn.Write(buf)
|
||
return err
|
||
}
|
||
|
||
func (ws *WSConn) WriteJSON(v interface{}) error {
|
||
b, err := json.Marshal(v)
|
||
if err != nil {
|
||
return err
|
||
}
|
||
return ws.sendFrame(0x1, b, false) // Text frame
|
||
}
|
||
|
||
func (ws *WSConn) ReadJSON(v interface{}) error {
|
||
_, payload, err := ws.ReadFrame()
|
||
if err != nil {
|
||
return err
|
||
}
|
||
return json.Unmarshal(payload, v)
|
||
}
|
||
|
||
func (ws *WSConn) Close() {
|
||
ws.sendFrame(0x8, nil, false)
|
||
ws.conn.Close()
|
||
}
|
||
|
||
// ===== Mock Remotedevice 设备桥 =====
|
||
|
||
type MockDevice struct {
|
||
DeviceID string
|
||
Name string
|
||
Caps []string
|
||
Conn *WSConn
|
||
Online bool
|
||
}
|
||
|
||
type MockRemoteDevice struct {
|
||
mu sync.Mutex
|
||
devices map[string]*MockDevice
|
||
}
|
||
|
||
func NewMockRemoteDevice() *MockRemoteDevice {
|
||
return &MockRemoteDevice{
|
||
devices: make(map[string]*MockDevice),
|
||
}
|
||
}
|
||
|
||
func (s *MockServer) handleDeviceWS(w http.ResponseWriter, r *http.Request) {
|
||
ws, err := upgradeWS(w, r)
|
||
if err != nil {
|
||
log.Printf("[ws] upgrade failed: %v", err)
|
||
return
|
||
}
|
||
defer ws.Close()
|
||
|
||
log.Printf("[ws] 新设备连接")
|
||
|
||
// 处理 hello/bind/cmd 协议
|
||
var device *MockDevice
|
||
for {
|
||
var msg struct {
|
||
Op string `json:"op"`
|
||
DeviceID string `json:"device_id"`
|
||
Token string `json:"token"`
|
||
ReqID string `json:"req_id"`
|
||
Command string `json:"command"`
|
||
CmdType string `json:"cmd_type"`
|
||
Status string `json:"status"`
|
||
Output string `json:"output"`
|
||
Error string `json:"error"`
|
||
Device json.RawMessage `json:"device"`
|
||
Payload json.RawMessage `json:"payload"`
|
||
}
|
||
|
||
if err := ws.ReadJSON(&msg); err != nil {
|
||
log.Printf("[ws] read error: %v", err)
|
||
break
|
||
}
|
||
|
||
switch msg.Op {
|
||
case "hello":
|
||
var devMeta struct {
|
||
DeviceID string `json:"device_id"`
|
||
Name string `json:"name"`
|
||
Kind string `json:"kind"`
|
||
Caps []string `json:"caps"`
|
||
}
|
||
json.Unmarshal(msg.Device, &devMeta)
|
||
|
||
device = &MockDevice{
|
||
DeviceID: devMeta.DeviceID,
|
||
Name: devMeta.Name,
|
||
Caps: devMeta.Caps,
|
||
Conn: ws,
|
||
Online: true,
|
||
}
|
||
|
||
s.mu.Lock()
|
||
// 更新设备列表
|
||
found := false
|
||
for i := range s.devices {
|
||
if s.devices[i].DeviceID == devMeta.DeviceID {
|
||
s.devices[i].Online = true
|
||
s.devices[i].Caps = devMeta.Caps
|
||
found = true
|
||
break
|
||
}
|
||
}
|
||
if !found {
|
||
s.devices = append(s.devices, Device{
|
||
DeviceID: devMeta.DeviceID,
|
||
Name: devMeta.Name,
|
||
Authorized: false,
|
||
Online: true,
|
||
Caps: devMeta.Caps,
|
||
})
|
||
}
|
||
s.mu.Unlock()
|
||
|
||
ws.WriteJSON(map[string]interface{}{
|
||
"op": "hello_ack",
|
||
"code": 0,
|
||
})
|
||
log.Printf("[ws] 设备登记: %s (%s) caps=%v", devMeta.DeviceID, devMeta.Name, devMeta.Caps)
|
||
|
||
case "bind":
|
||
if msg.DeviceID == "" || msg.Token == "" {
|
||
ws.WriteJSON(map[string]interface{}{
|
||
"op": "bind_ack",
|
||
"code": 1,
|
||
"error": "missing device_id or token",
|
||
})
|
||
break
|
||
}
|
||
|
||
s.mu.Lock()
|
||
for i := range s.devices {
|
||
if s.devices[i].DeviceID == msg.DeviceID {
|
||
s.devices[i].Authorized = true
|
||
}
|
||
}
|
||
s.mu.Unlock()
|
||
|
||
ws.WriteJSON(map[string]interface{}{
|
||
"op": "bind_ack",
|
||
"code": 0,
|
||
})
|
||
log.Printf("[ws] 设备授权: %s", msg.DeviceID)
|
||
|
||
// 绑定成功后,发送全量能力测试命令序列
|
||
go func() {
|
||
time.Sleep(500 * time.Millisecond)
|
||
|
||
// 测试 1: screensee 截图
|
||
log.Printf("[ws] 发命令 1/7: homeagent-screensee")
|
||
ws.WriteJSON(client.CmdMsg{
|
||
Op: "cmd",
|
||
ReqID: "test_1_screensee_" + fmt.Sprintf("%d", time.Now().UnixMilli()),
|
||
Command: "homeagent-screensee",
|
||
CmdType: "homeagent",
|
||
})
|
||
|
||
time.Sleep(800 * time.Millisecond)
|
||
|
||
// 测试 2: clipboardsue 写入剪贴板
|
||
log.Printf("[ws] 发命令 2/7: homeagent-clipboardsue")
|
||
ws.WriteJSON(client.CmdMsg{
|
||
Op: "cmd",
|
||
ReqID: "test_2_clipboardsue_" + fmt.Sprintf("%d", time.Now().UnixMilli()),
|
||
Command: "homeagent-clipboardsue HomeAgent远程测试_" + fmt.Sprintf("%d", time.Now().UnixMilli()),
|
||
CmdType: "homeagent",
|
||
})
|
||
|
||
time.Sleep(800 * time.Millisecond)
|
||
|
||
// 测试 3: clipboardsee 读取剪贴板
|
||
log.Printf("[ws] 发命令 3/7: homeagent-clipboardsee")
|
||
ws.WriteJSON(client.CmdMsg{
|
||
Op: "cmd",
|
||
ReqID: "test_3_clipboardsee_" + fmt.Sprintf("%d", time.Now().UnixMilli()),
|
||
Command: "homeagent-clipboardsee",
|
||
CmdType: "homeagent",
|
||
})
|
||
|
||
time.Sleep(800 * time.Millisecond)
|
||
|
||
// 测试 4: computeruse 鼠标移动(使用非标准 JSON 格式测试兼容性)
|
||
log.Printf("[ws] 发命令 4/7: homeagent-computeruse move")
|
||
ws.WriteJSON(client.CmdMsg{
|
||
Op: "cmd",
|
||
ReqID: "test_4_computeruse_" + fmt.Sprintf("%d", time.Now().UnixMilli()),
|
||
Command: `homeagent-computeruse move {x:500,y:300}`,
|
||
CmdType: "homeagent",
|
||
})
|
||
|
||
time.Sleep(800 * time.Millisecond)
|
||
|
||
// 测试 4b: computeruse 鼠标点击(标准 JSON 格式)
|
||
log.Printf("[ws] 发命令 4b/7: homeagent-computeruse click")
|
||
ws.WriteJSON(client.CmdMsg{
|
||
Op: "cmd",
|
||
ReqID: "test_4b_click_" + fmt.Sprintf("%d", time.Now().UnixMilli()),
|
||
Command: `homeagent-computeruse {"x":800,"y":500,"action":"click","button":"left"}`,
|
||
CmdType: "homeagent",
|
||
})
|
||
|
||
time.Sleep(800 * time.Millisecond)
|
||
|
||
// 测试 5: speakeruse TTS 播报
|
||
log.Printf("[ws] 发命令 5/7: homeagent-speakeruse")
|
||
ws.WriteJSON(client.CmdMsg{
|
||
Op: "cmd",
|
||
ReqID: "test_5_speakeruse_" + fmt.Sprintf("%d", time.Now().UnixMilli()),
|
||
Command: "homeagent-speakeruse 你好,这是来自远程Mock服务器的测试播报",
|
||
CmdType: "homeagent",
|
||
})
|
||
|
||
time.Sleep(800 * time.Millisecond)
|
||
|
||
// 测试 6: screensue 弹窗显示
|
||
log.Printf("[ws] 发命令 6/7: homeagent-screensue(HTML)")
|
||
ws.WriteJSON(client.CmdMsg{
|
||
Op: "cmd",
|
||
ReqID: "test_6_screensue_" + fmt.Sprintf("%d", time.Now().UnixMilli()),
|
||
Command: `homeagent-screensue 10 <!DOCTYPE html><html><head><meta charset="utf-8"><style>body{background:linear-gradient(135deg,#667eea,#764ba2);color:white;font-family:sans-serif;padding:30px;margin:0}h1{font-size:32px;text-shadow:0 2px 8px rgba(0,0,0,0.3)}.card{background:rgba(255,255,255,0.15);border-radius:12px;padding:20px;margin:12px 0;backdrop-filter:blur(8px)}.badge{display:inline-block;background:#4ade80;color:#000;padding:3px 10px;border-radius:16px;font-weight:bold}</style></head><body><h1>HomeAgent GUI 全量测试</h1><div class="card"><h2>能力测试结果</h2><table border="1" cellpadding="6" style="border-collapse:collapse;width:100%"><tr><th>能力</th><th>结果</th></tr><tr><td>screensee 截图</td><td><span class="badge">通过</span></td></tr><tr><td>clipboard 读写</td><td><span class="badge">通过</span></td></tr><tr><td>computeruse 操控</td><td><span class="badge">通过</span></td></tr><tr><td>speakeruse TTS</td><td><span class="badge">通过</span></td></tr><tr><td>screensue 渲染</td><td><span class="badge">通过</span></td></tr></table></div><p style="text-align:center;color:rgba(255,255,255,0.7)">2026-08-23 19:50</p></body></html>`,
|
||
CmdType: "homeagent",
|
||
})
|
||
|
||
time.Sleep(800 * time.Millisecond)
|
||
|
||
// 测试 7: omniparse 解析当前窗口 UI 元素
|
||
log.Printf("[ws] 发命令 7/7: homeagent-omniparse")
|
||
ws.WriteJSON(client.CmdMsg{
|
||
Op: "cmd",
|
||
ReqID: "test_7_omniparse_" + fmt.Sprintf("%d", time.Now().UnixMilli()),
|
||
Command: "homeagent-omniparse",
|
||
CmdType: "homeagent",
|
||
})
|
||
}()
|
||
|
||
case "cmd_result":
|
||
log.Printf("[ws] 命令结果: req=%s status=%s", msg.ReqID, msg.Status)
|
||
if msg.Output != "" {
|
||
output := msg.Output
|
||
if len(output) > 100 {
|
||
output = output[:100] + "..."
|
||
}
|
||
log.Printf("[ws] 输出: %s", output)
|
||
}
|
||
if msg.Error != "" {
|
||
log.Printf("[ws] 错误: %s", msg.Error)
|
||
}
|
||
|
||
case "data_start":
|
||
var ds client.DataStart
|
||
json.Unmarshal(msg.Payload, &ds)
|
||
log.Printf("[ws] 二进制数据开始: req=%s kind=%s mime=%s total=%d", ds.ReqID, ds.Kind, ds.MIME, ds.Total)
|
||
|
||
case "data_end":
|
||
log.Printf("[ws] 二进制数据结束: req=%s status=%s", msg.ReqID, msg.Status)
|
||
|
||
case "speech_start":
|
||
log.Printf("[ws] TTS 音频开始: req=%s", msg.ReqID)
|
||
|
||
case "speech_end":
|
||
log.Printf("[ws] TTS 音频结束: req=%s", msg.ReqID)
|
||
|
||
case "status":
|
||
log.Printf("[ws] 状态上报: %s -> %s", msg.DeviceID, msg.Status)
|
||
|
||
case "event":
|
||
log.Printf("[ws] 事件上报: %s type=%s", msg.DeviceID, string(msg.Payload))
|
||
|
||
default:
|
||
log.Printf("[ws] 未知消息类型: %s", msg.Op)
|
||
}
|
||
}
|
||
|
||
if device != nil {
|
||
device.Online = false
|
||
s.mu.Lock()
|
||
for i := range s.devices {
|
||
if s.devices[i].DeviceID == device.DeviceID {
|
||
s.devices[i].Online = false
|
||
}
|
||
}
|
||
s.mu.Unlock()
|
||
}
|
||
log.Printf("[ws] 设备断开")
|
||
}
|