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 保留。
278 lines
6.7 KiB
Go
278 lines
6.7 KiB
Go
package supervisor
|
||
|
||
import (
|
||
"context"
|
||
"fmt"
|
||
"log"
|
||
"sync"
|
||
"time"
|
||
|
||
"github.com/JianFeeeee/HomeAgent/internal/network"
|
||
sdk "github.com/JianFeeeee/HomeAgent/internal/sdk"
|
||
"github.com/JianFeeeee/HomeAgent/internal/tracker"
|
||
"github.com/JianFeeeee/HomeAgent/pkg/types"
|
||
)
|
||
|
||
const directAgentID types.AgentID = "main"
|
||
|
||
type Daemon struct {
|
||
cfg *types.Config
|
||
nm *network.Monitor
|
||
trk *tracker.Tracker
|
||
agents map[types.AgentID]*agentInstance
|
||
mu sync.RWMutex
|
||
ctx context.Context
|
||
cancel context.CancelFunc
|
||
heartbeatSource func(id types.AgentID) (time.Time, types.HealthStatus, error)
|
||
restartHandler func(id types.AgentID)
|
||
}
|
||
|
||
type agentInstance struct {
|
||
cfg *types.AgentConfig
|
||
state types.AgentState
|
||
health types.HealthStatus
|
||
lastHB time.Time
|
||
failCount int
|
||
useTracker bool
|
||
}
|
||
|
||
func New(cfg *types.Config) *Daemon {
|
||
ctx, cancel := context.WithCancel(context.Background())
|
||
nm := network.NewMonitor(cfg.Daemon.CheckInterval)
|
||
|
||
return &Daemon{
|
||
cfg: cfg,
|
||
nm: nm,
|
||
agents: make(map[types.AgentID]*agentInstance),
|
||
ctx: ctx,
|
||
cancel: cancel,
|
||
}
|
||
}
|
||
|
||
func (d *Daemon) SetTracker(trk *tracker.Tracker) {
|
||
d.trk = trk
|
||
}
|
||
|
||
// SetHeartbeatSource 接入 agent 真实存活探测源(direct 模式下为同进程 agent core 状态)。
|
||
// 成功返回时 lastHB 才更新;无源时 agent 健康保持未知。
|
||
func (d *Daemon) SetHeartbeatSource(fn func(id types.AgentID) (time.Time, types.HealthStatus, error)) {
|
||
d.mu.Lock()
|
||
defer d.mu.Unlock()
|
||
d.heartbeatSource = fn
|
||
}
|
||
|
||
// SetRestartHandler 接入真实重启动作(direct 模式下由 homed 注册"清理后以特殊码退出",交给 guard/systemd 重建)。
|
||
func (d *Daemon) SetRestartHandler(fn func(id types.AgentID)) {
|
||
d.mu.Lock()
|
||
defer d.mu.Unlock()
|
||
d.restartHandler = fn
|
||
}
|
||
|
||
func (d *Daemon) Start() error {
|
||
log.Println("[homed] starting HomeAgent daemon")
|
||
|
||
go d.nm.Start(d.ctx, d.cfg.Defaults.LLMEndpoints)
|
||
|
||
go d.healthLoop()
|
||
|
||
log.Println("[homed] daemon started successfully")
|
||
return nil
|
||
}
|
||
|
||
func (d *Daemon) Shutdown() {
|
||
log.Println("[homed] shutting down...")
|
||
d.cancel()
|
||
|
||
d.mu.Lock()
|
||
defer d.mu.Unlock()
|
||
|
||
for id, agent := range d.agents {
|
||
if agent.state == types.AgentStateRunning {
|
||
log.Printf("[homed] stopping agent %s", id)
|
||
agent.state = types.AgentStateStopped
|
||
}
|
||
}
|
||
}
|
||
|
||
func (d *Daemon) RegisterAgent(id types.AgentID) {
|
||
d.mu.Lock()
|
||
defer d.mu.Unlock()
|
||
|
||
useTrk := d.trk != nil
|
||
maxRetries := d.cfg.Defaults.RollbackPolicy.MaxRetries
|
||
if maxRetries <= 0 {
|
||
maxRetries = 3
|
||
}
|
||
cfg := &types.AgentConfig{ID: id}
|
||
cfg.RollbackPolicy.MaxRetries = maxRetries
|
||
|
||
d.agents[id] = &agentInstance{
|
||
cfg: cfg,
|
||
state: types.AgentStateRunning,
|
||
health: types.HealthHealthy,
|
||
lastHB: time.Now(),
|
||
useTracker: useTrk,
|
||
}
|
||
log.Printf("[homed] agent %s registered (tracker=%v, maxRetries=%d)", id, useTrk, maxRetries)
|
||
}
|
||
|
||
func (d *Daemon) healthLoop() {
|
||
interval := d.cfg.Daemon.HeartbeatInterval
|
||
if interval <= 0 {
|
||
interval = 30 * time.Second
|
||
}
|
||
ticker := time.NewTicker(interval)
|
||
defer ticker.Stop()
|
||
|
||
for {
|
||
select {
|
||
case <-ticker.C:
|
||
d.checkAllAgents()
|
||
case <-d.ctx.Done():
|
||
return
|
||
}
|
||
}
|
||
}
|
||
|
||
func (d *Daemon) checkAllAgents() {
|
||
d.mu.RLock()
|
||
agents := make(map[types.AgentID]*agentInstance)
|
||
for id, a := range d.agents {
|
||
agents[id] = a
|
||
}
|
||
d.mu.RUnlock()
|
||
|
||
for id, agent := range agents {
|
||
d.checkAgent(id, agent)
|
||
}
|
||
}
|
||
|
||
func (d *Daemon) checkAgent(id types.AgentID, agent *agentInstance) {
|
||
// 1) agent 存活源:只有确认存活才更新 lastHB
|
||
d.mu.RLock()
|
||
hbSrc := d.heartbeatSource
|
||
d.mu.RUnlock()
|
||
|
||
if hbSrc != nil {
|
||
hbTime, hbHealth, err := hbSrc(id)
|
||
if err != nil || hbTime.IsZero() {
|
||
agent.health = types.HealthDown
|
||
log.Printf("[homed] agent %s heartbeat lost: %v", id, err)
|
||
} else {
|
||
agent.lastHB = hbTime
|
||
agent.health = hbHealth
|
||
}
|
||
} else {
|
||
agent.health = types.HealthUnknown
|
||
}
|
||
|
||
// 2) 网络:仅在配置了探活端点时才据此判定降级
|
||
netStatus := d.nm.AggregateResult()
|
||
if netStatus.EndpointsConfigured && !netStatus.LLMAPIReachable {
|
||
if agent.health != types.HealthDown {
|
||
agent.health = types.HealthDegraded
|
||
}
|
||
agent.failCount++
|
||
log.Printf("[homed] agent %s: LLM API unreachable (fail %d)", id, agent.failCount)
|
||
} else if agent.health == types.HealthHealthy {
|
||
agent.failCount = 0
|
||
}
|
||
|
||
if agent.failCount >= agent.cfg.RollbackPolicy.MaxRetries {
|
||
d.handleFailure(id, agent)
|
||
}
|
||
}
|
||
|
||
func (d *Daemon) handleFailure(id types.AgentID, agent *agentInstance) {
|
||
log.Printf("[homed] agent %s failed %d times, initiating recovery", id, agent.failCount)
|
||
|
||
if agent.useTracker && d.trk != nil {
|
||
log.Printf("[homed] rolling back agent %s via change tracker", id)
|
||
if err := d.trk.Rollback(); err != nil {
|
||
log.Printf("[homed] tracker rollback failed: %v — restarting agent", err)
|
||
d.restartAgent(id, agent)
|
||
return
|
||
}
|
||
log.Printf("[homed] agent %s tracker rollback complete", id)
|
||
agent.failCount = 0
|
||
return
|
||
}
|
||
|
||
d.restartAgent(id, agent)
|
||
}
|
||
|
||
func (d *Daemon) restartAgent(id types.AgentID, agent *agentInstance) {
|
||
agent.state = types.AgentStateStopped
|
||
agent.failCount = 0
|
||
|
||
d.mu.RLock()
|
||
handler := d.restartHandler
|
||
d.mu.RUnlock()
|
||
|
||
if handler != nil {
|
||
log.Printf("[homed] agent %s restart handler invoked", id)
|
||
handler(id)
|
||
return
|
||
}
|
||
|
||
// 无真实重启通道:退回内存态复位(记录,不再假装成功)
|
||
d.RegisterAgent(id)
|
||
agent.failCount = 0
|
||
log.Printf("[homed] agent %s reset in-memory only (no restart handler registered)", id)
|
||
}
|
||
|
||
func (d *Daemon) GetAgentStatus(id types.AgentID) (*AgentStatus, error) {
|
||
d.mu.RLock()
|
||
agent, ok := d.agents[id]
|
||
d.mu.RUnlock()
|
||
|
||
if !ok {
|
||
return nil, fmt.Errorf("agent %s not found", id)
|
||
}
|
||
|
||
netStatus := d.nm.AggregateResult()
|
||
|
||
trackerStats := map[string]interface{}{"active": false}
|
||
if d.trk != nil {
|
||
trackerStats = d.trk.Stats()
|
||
}
|
||
|
||
return &AgentStatus{
|
||
ID: id,
|
||
State: agent.state,
|
||
Health: agent.health,
|
||
Uptime: time.Since(agent.lastHB),
|
||
Network: netStatus,
|
||
TrackerStats: trackerStats,
|
||
}, nil
|
||
}
|
||
|
||
func (d *Daemon) ListAgents() []AgentStatus {
|
||
d.mu.RLock()
|
||
defer d.mu.RUnlock()
|
||
|
||
var statuses []AgentStatus
|
||
for id, agent := range d.agents {
|
||
statuses = append(statuses, AgentStatus{
|
||
ID: id,
|
||
State: agent.state,
|
||
Health: agent.health,
|
||
})
|
||
}
|
||
return statuses
|
||
}
|
||
|
||
func (d *Daemon) PreActionSnapshot(id types.AgentID) (*types.Snapshot, error) {
|
||
return nil, fmt.Errorf("snapshot not supported in direct mode — use tracker instead")
|
||
}
|
||
|
||
func (d *Daemon) RollbackAgent(id types.AgentID, snapID types.SnapshotID) error {
|
||
if d.trk != nil {
|
||
return d.trk.Rollback()
|
||
}
|
||
return fmt.Errorf("no tracker available for rollback")
|
||
}
|
||
|
||
// AgentStatus 已迁入内置 SDK,此处保留别名以兼容现有调用方。
|
||
type AgentStatus = sdk.AgentStatus
|