mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-10-15 12:15:16 +00:00
## 背景 仓库早已迁移到 GitHub(`github.com/JianFeeeee/HomeAgent`,CI/CD 都在那边跑), gitcode 保留为**国内只读镜像**(`ci.yml` 的 sync-gitcode-main 快进推送)。 但 go.mod 的 module 路径一直是 `gitcode.com/JianFeeeee/...` —— 既与权威源 不符,`meta.SourceURL`(AGPL §13 的源码提供入口)也指向镜像而非实际运行的代码。 ## 关键区分(这是本次改动安全的前提) 两个 module 是**不同**的,影响面差一个数量级: | module | 谁依赖 | 改它的后果 | |---|---|---| | `.../HomeAgent`(主仓) | **只有主仓自己** | 内部重构,零外部影响 | | `.../homeagent-sdk`(SDK 仓) | 主仓 49 文件 + 所有外部插件 | 需重编插件 | ★ 实测确认:**插件不 import 主仓 module**(`strings qq/plugin.bin | grep HomeAgent` = 0), 只依赖 SDK 仓。而插件与内核的边界是 **RPC 方法名字符串** (`plugin.init` / `tool.invoke`…,见 proc/protocol.go),**与 Go module 名无关**。 ⇒ module 改名**不改变任何 wire 协议**,现网已装的插件照常运行。 SDK 的 GitHub 仓名是 `homeagentsdk`(无连字符),module 路径必须与之精确匹配, 否则 `go get` 会因路径不符失败,故取 `github.com/JianFeeeee/homeagentsdk`。 ## 改动 - `go.mod` / `go.sum`:两个 module 路径 + require/replace - 277 个 Go 文件 + Makefile + 打包脚本的 import 与 ldflags 路径 - SDK 仓 `meta.CoreModule`、`tools/hmapdev` 的 module 声明与工程模板 - 对外文档/链接的仓库地址(README、PLUGIN_DEV、OVERVIEW 等) ## 明确**保留** gitcode 的地方(镜像机制,不能动) - `GITCODE_TOKEN`、`GC_URL="…@gitcode.com"`(CI 同步 job) - `gitcode.com/api/v5/...`(release 附件上传) - git remote `gitcode`(镜像拉取/推送) - `docs/zh/ci-cd-runbook.md`(整篇讲镜像运维) ## 验证 - `go build ./...` / `go vet ./...` 绿 - `go test ./... -count=1` → 48 包 ok / 0 FAIL - hmapdev 工具链编译通过(`third_party/homeagent-sdk/tools/hmapdev`) - 全仓残留检查:module 形态的 `gitcode.com/JianFeeeee` = 0 - 镜像机制抽验:GC_URL / @gitcode / api/v5 / remote 均完好 ## 顺带修正 `hmapdev/templates.go` 的注释此前写「gitcode 的模块不在 proxy.golang.org 上」—— module 已迁 GitHub,该论断不再成立。改为如实说明**为何仍默认 replace 到本机 SDK**: 离线可构建、避免版本漂移、内网可用。理由与托管地无关,故 replace 保留。
271 lines
6.1 KiB
Go
271 lines
6.1 KiB
Go
package supervisor
|
||
|
||
import (
|
||
"testing"
|
||
"time"
|
||
|
||
"github.com/JianFeeeee/HomeAgent/internal/tracker"
|
||
"github.com/JianFeeeee/HomeAgent/pkg/types"
|
||
)
|
||
|
||
func TestNew(t *testing.T) {
|
||
cfg := &types.Config{
|
||
Daemon: types.DaemonConfig{
|
||
CheckInterval: time.Minute,
|
||
HeartbeatInterval: 30 * time.Second,
|
||
},
|
||
}
|
||
d := New(cfg)
|
||
if d == nil {
|
||
t.Fatal("Daemon should not be nil")
|
||
}
|
||
}
|
||
|
||
func TestStartAndShutdown(t *testing.T) {
|
||
cfg := &types.Config{
|
||
Daemon: types.DaemonConfig{
|
||
CheckInterval: time.Minute,
|
||
HeartbeatInterval: 30 * time.Second,
|
||
},
|
||
}
|
||
d := New(cfg)
|
||
if err := d.Start(); err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
d.Shutdown()
|
||
}
|
||
|
||
func TestRegisterAgent(t *testing.T) {
|
||
cfg := &types.Config{
|
||
Daemon: types.DaemonConfig{
|
||
CheckInterval: time.Minute,
|
||
HeartbeatInterval: 30 * time.Second,
|
||
},
|
||
}
|
||
d := New(cfg)
|
||
d.RegisterAgent("test_agent")
|
||
|
||
agents := d.ListAgents()
|
||
if len(agents) != 1 {
|
||
t.Fatalf("expected 1 agent, got %d", len(agents))
|
||
}
|
||
if agents[0].ID != "test_agent" {
|
||
t.Errorf("expected 'test_agent', got %q", agents[0].ID)
|
||
}
|
||
if agents[0].State != types.AgentStateRunning {
|
||
t.Errorf("expected Running state, got %v", agents[0].State)
|
||
}
|
||
}
|
||
|
||
func TestGetAgentStatus(t *testing.T) {
|
||
cfg := &types.Config{
|
||
Defaults: types.AgentConfig{
|
||
RollbackPolicy: types.RollbackPolicy{MaxRetries: 5},
|
||
},
|
||
Daemon: types.DaemonConfig{
|
||
CheckInterval: time.Minute,
|
||
HeartbeatInterval: 30 * time.Second,
|
||
},
|
||
}
|
||
d := New(cfg)
|
||
d.RegisterAgent("agent1")
|
||
|
||
status, err := d.GetAgentStatus("agent1")
|
||
if err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
if status.ID != "agent1" {
|
||
t.Errorf("expected 'agent1', got %q", status.ID)
|
||
}
|
||
}
|
||
|
||
func TestGetAgentStatusNotFound(t *testing.T) {
|
||
cfg := &types.Config{
|
||
Daemon: types.DaemonConfig{
|
||
CheckInterval: time.Minute,
|
||
HeartbeatInterval: 30 * time.Second,
|
||
},
|
||
}
|
||
d := New(cfg)
|
||
_, err := d.GetAgentStatus("nonexistent")
|
||
if err == nil {
|
||
t.Error("expected error for nonexistent agent")
|
||
}
|
||
}
|
||
|
||
func TestListAgents(t *testing.T) {
|
||
cfg := &types.Config{
|
||
Daemon: types.DaemonConfig{
|
||
CheckInterval: time.Minute,
|
||
HeartbeatInterval: 30 * time.Second,
|
||
},
|
||
}
|
||
d := New(cfg)
|
||
d.RegisterAgent("a")
|
||
d.RegisterAgent("b")
|
||
|
||
agents := d.ListAgents()
|
||
if len(agents) != 2 {
|
||
t.Errorf("expected 2 agents, got %d", len(agents))
|
||
}
|
||
}
|
||
|
||
func TestSetTracker(t *testing.T) {
|
||
cfg := &types.Config{
|
||
Daemon: types.DaemonConfig{
|
||
CheckInterval: time.Minute,
|
||
HeartbeatInterval: 30 * time.Second,
|
||
},
|
||
}
|
||
d := New(cfg)
|
||
tr := tracker.NewTracker("/tmp/test_tracker_data", "/tmp/test_tracker_work")
|
||
d.SetTracker(tr)
|
||
|
||
// RegisterAgent should use tracker
|
||
d.RegisterAgent("tracked_agent")
|
||
status, _ := d.GetAgentStatus("tracked_agent")
|
||
if status.TrackerStats == nil {
|
||
t.Error("expected tracker stats")
|
||
}
|
||
}
|
||
|
||
func TestRollbackAgent(t *testing.T) {
|
||
cfg := &types.Config{
|
||
Daemon: types.DaemonConfig{
|
||
CheckInterval: time.Minute,
|
||
HeartbeatInterval: 30 * time.Second,
|
||
},
|
||
}
|
||
d := New(cfg)
|
||
tr := tracker.NewTracker("/tmp/test_rb_data", "/tmp/test_rb_work")
|
||
d.SetTracker(tr)
|
||
|
||
err := d.RollbackAgent("any", "snap1")
|
||
if err == nil {
|
||
t.Log("rollback succeeded (tracker may be unmounted)")
|
||
}
|
||
}
|
||
|
||
func TestRollbackAgentNoTracker(t *testing.T) {
|
||
cfg := &types.Config{
|
||
Daemon: types.DaemonConfig{
|
||
CheckInterval: time.Minute,
|
||
HeartbeatInterval: 30 * time.Second,
|
||
},
|
||
}
|
||
d := New(cfg)
|
||
err := d.RollbackAgent("main", "snap1")
|
||
if err == nil {
|
||
t.Error("expected error when no tracker")
|
||
}
|
||
}
|
||
|
||
func TestPreActionSnapshot(t *testing.T) {
|
||
cfg := &types.Config{
|
||
Daemon: types.DaemonConfig{
|
||
CheckInterval: time.Minute,
|
||
HeartbeatInterval: 30 * time.Second,
|
||
},
|
||
}
|
||
d := New(cfg)
|
||
_, err := d.PreActionSnapshot("main")
|
||
if err == nil {
|
||
t.Error("expected error (snapshot not supported)")
|
||
}
|
||
}
|
||
|
||
func TestRegisterAgentMultiple(t *testing.T) {
|
||
cfg := &types.Config{
|
||
Daemon: types.DaemonConfig{
|
||
CheckInterval: time.Minute,
|
||
HeartbeatInterval: 30 * time.Second,
|
||
},
|
||
}
|
||
d := New(cfg)
|
||
|
||
for i := 0; i < 5; i++ {
|
||
d.RegisterAgent(types.AgentID(string(rune('a' + i))))
|
||
}
|
||
|
||
agents := d.ListAgents()
|
||
if len(agents) != 5 {
|
||
t.Errorf("expected 5 agents, got %d", len(agents))
|
||
}
|
||
}
|
||
|
||
func TestConcurrentAccess(t *testing.T) {
|
||
cfg := &types.Config{
|
||
Daemon: types.DaemonConfig{
|
||
CheckInterval: time.Minute,
|
||
HeartbeatInterval: 30 * time.Second,
|
||
},
|
||
}
|
||
d := New(cfg)
|
||
|
||
// Register from multiple goroutines
|
||
for i := 0; i < 10; i++ {
|
||
go d.RegisterAgent(types.AgentID(string(rune('a' + i))))
|
||
}
|
||
}
|
||
|
||
func TestCheckAgentHeartbeatSource(t *testing.T) {
|
||
cfg := &types.Config{
|
||
Daemon: types.DaemonConfig{CheckInterval: time.Minute, HeartbeatInterval: 30 * time.Second},
|
||
}
|
||
cfg.Defaults.RollbackPolicy.MaxRetries = 3
|
||
d := New(cfg)
|
||
d.RegisterAgent("main")
|
||
a := d.agents["main"]
|
||
|
||
d.SetHeartbeatSource(func(id types.AgentID) (time.Time, types.HealthStatus, error) {
|
||
return time.Now(), types.HealthHealthy, nil
|
||
})
|
||
|
||
regHB := a.lastHB
|
||
if regHB.IsZero() {
|
||
t.Fatal("lastHB should be set at register")
|
||
}
|
||
|
||
d.checkAgent("main", a)
|
||
if a.lastHB.Before(regHB) {
|
||
t.Fatal("lastHB should update after a successful heartbeat poll")
|
||
}
|
||
if a.health != types.HealthHealthy {
|
||
t.Fatalf("expected healthy, got %v", a.health)
|
||
}
|
||
|
||
// 健康源丢失:lastHB 不应再更新,状态置 Down
|
||
lastHB := a.lastHB
|
||
time.Sleep(2 * time.Millisecond)
|
||
d.SetHeartbeatSource(func(id types.AgentID) (time.Time, types.HealthStatus, error) {
|
||
return time.Time{}, types.HealthDown, nil
|
||
})
|
||
d.checkAgent("main", a)
|
||
if a.health != types.HealthDown {
|
||
t.Fatalf("expected down, got %v", a.health)
|
||
}
|
||
if !a.lastHB.Equal(lastHB) {
|
||
t.Fatal("lastHB must NOT update when the agent does not respond")
|
||
}
|
||
}
|
||
|
||
func TestRestartHandlerInvoked(t *testing.T) {
|
||
cfg := &types.Config{
|
||
Daemon: types.DaemonConfig{CheckInterval: time.Minute, HeartbeatInterval: 30 * time.Second},
|
||
}
|
||
cfg.Defaults.RollbackPolicy.MaxRetries = 3
|
||
d := New(cfg)
|
||
d.RegisterAgent("main")
|
||
a := d.agents["main"]
|
||
|
||
called := false
|
||
d.SetRestartHandler(func(id types.AgentID) { called = true })
|
||
d.restartAgent("main", a)
|
||
if !called {
|
||
t.Fatal("restart handler should be invoked")
|
||
}
|
||
if a.failCount != 0 {
|
||
t.Fatalf("failCount should reset, got %d", a.failCount)
|
||
}
|
||
}
|