mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-11-01 14:57:38 +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>
400 lines
10 KiB
Go
400 lines
10 KiB
Go
package main
|
||
|
||
import (
|
||
"bufio"
|
||
"fmt"
|
||
"log"
|
||
"net"
|
||
"os"
|
||
"os/signal"
|
||
"path/filepath"
|
||
"runtime"
|
||
"strings"
|
||
"sync"
|
||
"syscall"
|
||
"time"
|
||
|
||
"github.com/JianFeeeee/HomeAgent/internal/devicebridge/client"
|
||
safeclose "github.com/JianFeeeee/HomeAgent/internal/safeclose"
|
||
)
|
||
|
||
// ---------------------------------------------------------------------------
|
||
// Daemon 模式:后台驻留,维持 homed 连接 + 设备桥 + 消息缓冲
|
||
//
|
||
// 工作原理:
|
||
// - daemon 保持一个到 homed 的持久连接
|
||
// - TUI 实例通过 Unix socket 连接到 daemon
|
||
// - daemon 为每个 TUI 客户端分配独立的 homed 响应(通过 homeMu 序列化)
|
||
// - 新客户端连入时回放缓冲的历史消息(方便重连后看到上下文)
|
||
// ---------------------------------------------------------------------------
|
||
|
||
const (
|
||
daemonSocketName = "waiter.sock"
|
||
msgBufCap = 256 // 环形缓冲最近 N 行 homed 输出
|
||
)
|
||
|
||
type msgEntry struct {
|
||
line string
|
||
seq uint64
|
||
}
|
||
|
||
type daemonHandler struct {
|
||
stopOnce sync.Once
|
||
// homed 连接
|
||
homeMu sync.Mutex
|
||
homeConn net.Conn
|
||
homeR *bufio.Reader
|
||
homeCfg *Config
|
||
|
||
// 消息缓冲(新客户端连入时回放)
|
||
bufMu sync.Mutex
|
||
buf []msgEntry
|
||
bufSeq uint64
|
||
bufCap int
|
||
|
||
// 生命周期
|
||
stopCh chan struct{}
|
||
}
|
||
|
||
func newDaemonHandler() *daemonHandler {
|
||
return &daemonHandler{
|
||
bufCap: msgBufCap,
|
||
stopCh: make(chan struct{}),
|
||
}
|
||
}
|
||
|
||
// ===== 消息缓冲 =====
|
||
|
||
func (h *daemonHandler) appendBuf(line string) {
|
||
h.bufMu.Lock()
|
||
defer h.bufMu.Unlock()
|
||
h.bufSeq++
|
||
h.buf = append(h.buf, msgEntry{line: line, seq: h.bufSeq})
|
||
if len(h.buf) > h.bufCap {
|
||
h.buf = h.buf[len(h.buf)-h.bufCap:]
|
||
}
|
||
}
|
||
|
||
func (h *daemonHandler) replayBuffer() []string {
|
||
h.bufMu.Lock()
|
||
defer h.bufMu.Unlock()
|
||
lines := make([]string, 0, len(h.buf))
|
||
for _, e := range h.buf {
|
||
lines = append(lines, e.line)
|
||
}
|
||
return lines
|
||
}
|
||
|
||
// ===== homed 连接 =====
|
||
|
||
func (h *daemonHandler) connectHome(cfg *Config) error {
|
||
h.homeCfg = cfg
|
||
if cfg.Remote != "" {
|
||
return fmt.Errorf("daemon: remote mode not supported")
|
||
}
|
||
if cfg.Socket == "" {
|
||
cfg.Socket = discoverSocket("")
|
||
}
|
||
c, err := net.DialTimeout("unix", cfg.Socket, 5*time.Second)
|
||
if err != nil {
|
||
return fmt.Errorf("daemon: connect home: %w", err)
|
||
}
|
||
h.homeConn = c
|
||
h.homeR = bufio.NewReader(c)
|
||
log.Printf("[daemon] connected to home %s", cfg.Socket)
|
||
return nil
|
||
}
|
||
|
||
func (h *daemonHandler) closeHome() {
|
||
if h.homeConn != nil {
|
||
h.homeConn.Close()
|
||
h.homeConn = nil
|
||
}
|
||
}
|
||
|
||
func (h *daemonHandler) reconnectHome() {
|
||
cfg := h.homeCfg
|
||
if cfg == nil {
|
||
cfg = discoverConfig("")
|
||
}
|
||
if cfg.Socket == "" && cfg.Remote == "" {
|
||
cfg.Socket = discoverSocket("")
|
||
}
|
||
for i := 0; i < 30; i++ {
|
||
select {
|
||
case <-h.stopCh:
|
||
return
|
||
default:
|
||
}
|
||
h.closeHome()
|
||
time.Sleep(2 * time.Second)
|
||
if err := h.connectHome(cfg); err != nil {
|
||
log.Printf("[daemon] reconnect home (%d/30): %v", i+1, err)
|
||
continue
|
||
}
|
||
log.Printf("[daemon] reconnected to home")
|
||
return
|
||
}
|
||
log.Printf("[daemon] gave up reconnecting to home")
|
||
}
|
||
|
||
// handleClient 处理单个 TUI 客户端:
|
||
// 1. 回放缓冲历史
|
||
// 2. 读客户端输入 → 转发到 homed
|
||
// 3. 读 homed 响应 → 回写给该客户端(独占响应,不广播)
|
||
func (h *daemonHandler) handleClient(c net.Conn) {
|
||
defer c.Close()
|
||
|
||
cid := fmt.Sprintf("%s", c.RemoteAddr())
|
||
log.Printf("[daemon] client %s connected", cid)
|
||
defer log.Printf("[daemon] client %s disconnected", cid)
|
||
|
||
// 1) 回放缓冲(新客户端看到最近对话上下文)
|
||
for _, line := range h.replayBuffer() {
|
||
fmt.Fprintf(c, "%s\n", line)
|
||
}
|
||
|
||
// 2) 循环:读客户端 → 转发 homed → 读 homed 响应 → 回写客户端
|
||
reader := bufio.NewReader(c)
|
||
for {
|
||
c.SetReadDeadline(time.Now().Add(5 * time.Minute))
|
||
line, err := reader.ReadString('\n')
|
||
if err != nil {
|
||
if netErr, ok := err.(net.Error); ok && netErr.Timeout() {
|
||
continue
|
||
}
|
||
return
|
||
}
|
||
line = strings.TrimSuffix(line, "\n")
|
||
if line == "" {
|
||
continue
|
||
}
|
||
|
||
// 转发到 homed(加锁保证请求-响应配对)
|
||
h.homeMu.Lock()
|
||
if h.homeConn == nil {
|
||
h.homeMu.Unlock()
|
||
fmt.Fprintf(c, `{"type":"error","error":"not connected to home"}`+"\n")
|
||
continue
|
||
}
|
||
_, sendErr := fmt.Fprintf(h.homeConn, "%s\n", line)
|
||
if sendErr != nil {
|
||
h.homeMu.Unlock()
|
||
fmt.Fprintf(c, `{"type":"error","error":"send failed"}`+"\n")
|
||
continue
|
||
}
|
||
|
||
// 读 homed 响应(所有帧:reasoning_delta / content_delta / tool_call / response / error)
|
||
for {
|
||
h.homeConn.SetReadDeadline(time.Now().Add(60 * time.Second))
|
||
respLine, readErr := h.homeR.ReadString('\n')
|
||
if readErr != nil {
|
||
h.homeMu.Unlock()
|
||
log.Printf("[daemon] home read error during client %s: %v", cid, readErr)
|
||
h.reconnectHome()
|
||
// 回写错误给客户端
|
||
fmt.Fprintf(c, `{"type":"error","error":"home disconnected"}`+"\n")
|
||
goto nextMessage
|
||
}
|
||
respLine = strings.TrimSuffix(respLine, "\n")
|
||
if respLine == "" {
|
||
continue
|
||
}
|
||
// 写入缓冲 + 回写给发起请求的客户端
|
||
h.appendBuf(respLine)
|
||
fmt.Fprintf(c, "%s\n", respLine)
|
||
|
||
// 检查是否是终结帧
|
||
if strings.Contains(respLine, `"type":"response"`) || strings.Contains(respLine, `"type":"error"`) {
|
||
break
|
||
}
|
||
}
|
||
h.homeMu.Unlock()
|
||
|
||
nextMessage:
|
||
}
|
||
}
|
||
|
||
// ===== 启动入口 =====
|
||
|
||
func runDaemon(cfg *Config) {
|
||
dh := newDaemonHandler()
|
||
|
||
// 连接 homed(设备桥场景下可失败——被控主机无需 homed)
|
||
if cfg.Socket != "" || cfg.Remote != "" {
|
||
if err := dh.connectHome(cfg); err != nil {
|
||
log.Printf("[daemon] home connect failed: %v (continue with device bridge only)", err)
|
||
dh.homeConn = nil
|
||
}
|
||
} else {
|
||
log.Printf("[daemon] no home socket configured, running device bridge only")
|
||
}
|
||
defer dh.closeHome()
|
||
|
||
// 启动设备桥(设备网关场景下为核心职责)
|
||
startDaemonDeviceBridge(cfg)
|
||
|
||
// 监听 Unix socket
|
||
sockPath := daemonSocketPath()
|
||
os.Remove(sockPath)
|
||
os.MkdirAll(filepath.Dir(sockPath), 0755)
|
||
|
||
ln, err := net.Listen("unix", sockPath)
|
||
if err != nil {
|
||
fmt.Fprintf(os.Stderr, "daemon: listen %s: %v\n", sockPath, err)
|
||
os.Exit(1)
|
||
}
|
||
defer func() {
|
||
ln.Close()
|
||
os.Remove(sockPath)
|
||
}()
|
||
|
||
log.Printf("[daemon] listening on %s", sockPath)
|
||
fmt.Printf("waiter daemon started\n socket: %s\n press Ctrl+C to stop\n", sockPath)
|
||
|
||
sigCh := make(chan os.Signal, 1)
|
||
signal.Notify(sigCh, syscall.SIGINT, syscall.SIGTERM)
|
||
go func() {
|
||
<-sigCh
|
||
log.Printf("[daemon] shutting down")
|
||
safeclose.Safe(&dh.stopOnce, dh.stopCh)
|
||
dh.closeHome()
|
||
ln.Close()
|
||
}()
|
||
|
||
// 单客户端模式:串行处理(同一时刻只有一个 TUI 连接)
|
||
// 这与 homed CLI 插件的行为一致——一个连接对应一个活跃会话。
|
||
for {
|
||
conn, err := ln.Accept()
|
||
if err != nil {
|
||
select {
|
||
case <-dh.stopCh:
|
||
log.Printf("[daemon] stopped")
|
||
return
|
||
default:
|
||
log.Printf("[daemon] accept error: %v", err)
|
||
continue
|
||
}
|
||
}
|
||
dh.handleClient(conn)
|
||
}
|
||
}
|
||
|
||
// ===== Socket 工具 =====
|
||
|
||
func daemonSocketPath() string {
|
||
home, _ := os.UserHomeDir()
|
||
if home == "" {
|
||
home = "/tmp"
|
||
}
|
||
return filepath.Join(home, ".homeagent", daemonSocketName)
|
||
}
|
||
|
||
func daemonIsRunning() bool {
|
||
sock := daemonSocketPath()
|
||
c, err := net.DialTimeout("unix", sock, 500*time.Millisecond)
|
||
if err != nil {
|
||
return false
|
||
}
|
||
c.Close()
|
||
return true
|
||
}
|
||
|
||
func startDaemonDeviceBridge(cfg *Config) {
|
||
dg := cfg.DeviceGateway
|
||
dt := cfg.DeviceToken
|
||
if dg == "" || dt == "" {
|
||
return
|
||
}
|
||
// ★ 命令白名单必须在**这里**也赋值一次。
|
||
//
|
||
// 原因:daemon 模式(waiter --daemon,生产两台都这么跑)走的是本函数,
|
||
// 不经过 main.go 里那处赋值。只改 main.go 的话,配置在 daemon 下**完全不生效**
|
||
// —— 而症状是"配置写了、启动日志也打了招呼、命令照样被拒",极难定位。
|
||
//
|
||
// 赋值放在 goroutine 之前:白名单在收到第一帧命令时就要就绪。
|
||
if len(cfg.DeviceCmdAllowlist) > 0 {
|
||
deviceCmdAllowed = buildCmdMatcher(cfg.DeviceCmdAllowlist)
|
||
printlnC(colorGreen, fmt.Sprintf("device cmd allowlist: %d 条(来自 waiter.yaml)",
|
||
len(cfg.DeviceCmdAllowlist)))
|
||
} else {
|
||
printlnC(colorGreen, fmt.Sprintf("device cmd allowlist: 默认 %d 条(waiter.yaml 未配置 device_cmd_allowlist)",
|
||
len(defaultCmdAllowlist)))
|
||
}
|
||
|
||
// 设备桥重连循环:WS 断开时自动重连,并保留配置中的本地授权状态。
|
||
go runDeviceBridgeLoop(dg, dt, cfg.DeviceAuthorized)
|
||
}
|
||
|
||
// runDeviceBridgeLoop 无限重连循环:建立设备桥 → 等待断开 → 重连。
|
||
func runDeviceBridgeLoop(gateway, token string, authorized bool) {
|
||
for {
|
||
bridge, err := connectDeviceBridge(gateway, token, authorized)
|
||
if err != nil {
|
||
log.Printf("[daemon] device bridge connect failed: %v, retrying in 5s", err)
|
||
time.Sleep(5 * time.Second)
|
||
continue
|
||
}
|
||
log.Printf("[daemon] device bridge connected, waiting...")
|
||
bridge.Wait() // 阻塞直到断开
|
||
log.Printf("[daemon] device bridge disconnected, reconnecting in 3s")
|
||
time.Sleep(3 * time.Second)
|
||
}
|
||
}
|
||
|
||
// connectDeviceBridge 创建并启动一次设备桥,返回 bridge 实例供 Wait()。
|
||
func connectDeviceBridge(gateway, token string, authorized bool) (*client.Bridge, error) {
|
||
hostname, _ := os.Hostname()
|
||
if hostname == "" {
|
||
hostname = "local"
|
||
}
|
||
deviceID := "waiter-" + sanitizeID(hostname)
|
||
|
||
caps := []string{
|
||
"status", "cmdrun", "deviceinfo", "cmdresult",
|
||
"computeruse", "screensee", "clipboardsee", "clipboardsue",
|
||
"camerasue", "speakeruse", "screensue",
|
||
}
|
||
|
||
info := map[string]interface{}{
|
||
"hostname": hostname,
|
||
"platform": runtime.GOOS,
|
||
"arch": runtime.GOARCH,
|
||
"cpus": runtime.NumCPU(),
|
||
}
|
||
|
||
// 确保 gateway URL 格式正确
|
||
gw := gateway
|
||
if !strings.HasPrefix(gw, "ws://") && !strings.HasPrefix(gw, "wss://") {
|
||
gw = "ws://" + gw
|
||
}
|
||
if !strings.Contains(gw, "/api/v1/device/ws") {
|
||
gw = gw + "/api/v1/device/ws"
|
||
}
|
||
|
||
bridge := client.New(gw, token, deviceID, hostname, caps, info)
|
||
bridge.SetAuthorized(authorized)
|
||
|
||
// 注册命令处理器:cmd_type 是主信号,同时兼容旧版 homeagent-* 文本前缀。
|
||
cr := client.NewCmdRouter()
|
||
cr.Handle("homeagent-", handleHomeagentCmd)
|
||
cr.HandleDefault(handleShellCmd)
|
||
bridge.OnCmd(func(reqID, command, cmdType string) {
|
||
if cmdType == "homeagent" {
|
||
handleHomeagentCmd(reqID, command)
|
||
return
|
||
}
|
||
cr.Dispatch(reqID, command)
|
||
})
|
||
|
||
if err := bridge.Start(); err != nil {
|
||
return nil, err
|
||
}
|
||
|
||
// 设置全局变量供 sendBridgeResult 使用
|
||
deviceBridge = bridge
|
||
deviceBridgeID = deviceID
|
||
|
||
return bridge, nil
|
||
}
|