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 保留。
139 lines
4.5 KiB
Go
139 lines
4.5 KiB
Go
//go:build linux
|
||
|
||
// L1 failback 恢复 worker(Linux 专属):在受限 boot 下执行恢复梯子,
|
||
// 依赖 DNS/代理网络基线、LLM 配置快照与 reload 等 Linux 语义。
|
||
// 非 Linux 平台不编译,由 guard_windows.go 提供桩。
|
||
package main
|
||
|
||
import (
|
||
"context"
|
||
"fmt"
|
||
"log"
|
||
"os"
|
||
"path/filepath"
|
||
"time"
|
||
|
||
agentAPI "github.com/JianFeeeee/HomeAgent/internal/agent/api"
|
||
internalConfig "github.com/JianFeeeee/HomeAgent/internal/config"
|
||
luaVM "github.com/JianFeeeee/HomeAgent/internal/lua"
|
||
"github.com/JianFeeeee/HomeAgent/internal/recovery"
|
||
sdk "github.com/JianFeeeee/HomeAgent/internal/sdk"
|
||
"github.com/JianFeeeee/HomeAgent/internal/system"
|
||
)
|
||
|
||
// runFailbackRecovery 在 failback worker 内执行 L1 恢复梯子:
|
||
// probe(rescue 源) → 还原 DNS/proxy → probe → 还原 LLM 配置快照+ReloadFromConfig → probe
|
||
// 成功后写 recovery_result.json 并以 exitRecovered 退出;失败以 exitRecoveryFailed 退出。
|
||
// 全程确定性、无 token 消耗(除 rescue 源 QuickChat 复检外)。
|
||
func runFailbackRecovery(dataDir string, cfgReg *internalConfig.ConfigRegistry, lua *luaVM.VM, providerMgr *agentAPI.ProviderManager, baseAPIKey string) {
|
||
applySystemConfig(loadGuardConfig(dataDir)) // 发行版/部署路径适配:guard.yaml system.*
|
||
task, err := recovery.LoadTask(recovery.TaskPath(dataDir))
|
||
if err != nil {
|
||
log.Printf("[failback] no recovery task, skipping: %v", err)
|
||
os.Exit(exitRecoveryFailed)
|
||
}
|
||
if task.RescueSource.Name == "" || task.RescueSource.BaseURL == "" {
|
||
log.Printf("[failback] rescue source missing in task, cannot recover")
|
||
os.Exit(exitRecoveryFailed)
|
||
}
|
||
log.Printf("[failback] recovery task: attempt %d/%d rescue=%s", task.Attempt, task.MaxAttempts, task.RescueSource.Name)
|
||
|
||
timeout := 120 * time.Second
|
||
if d, err := time.ParseDuration(task.AttemptTimeout); err == nil && d > 0 {
|
||
timeout = d
|
||
}
|
||
|
||
// 注册 rescue 源并设为默认(锚定 IP 直连,绕开被破坏的 DNS/代理)
|
||
key := task.RescueSource.APIKey
|
||
if key == "" {
|
||
key = baseAPIKey
|
||
}
|
||
rescueProvider := agentAPI.NewLuaAdaptedProvider(agentAPI.BaseConfig{
|
||
Model: task.RescueSource.Model,
|
||
BaseURL: task.RescueSource.BaseURL,
|
||
APIKey: key,
|
||
Temperature: 0.7,
|
||
MaxTokens: 512,
|
||
ContextWindow: 8192,
|
||
}, lua, task.RescueSource.Name, task.RescueSource.Adapter)
|
||
providerMgr.Register("rescue", rescueProvider)
|
||
if err := providerMgr.SetDefault("rescue"); err != nil {
|
||
log.Printf("[failback] set rescue default: %v", err)
|
||
}
|
||
|
||
probe := func(ctx context.Context, label string) (bool, error) {
|
||
ctx, cancel := context.WithTimeout(ctx, timeout)
|
||
defer cancel()
|
||
resp, err := providerMgr.QuickChat(ctx, "回复 OK")
|
||
if err != nil {
|
||
log.Printf("[failback] probe(%s): %v", label, err)
|
||
return false, nil
|
||
}
|
||
log.Printf("[failback] probe(%s): reachable, reply=%q", label, truncateStr(resp.Content, 60))
|
||
return true, nil
|
||
}
|
||
|
||
restoreNet := func() ([]string, error) {
|
||
base, err := system.LoadNetworkBaseline(dataDir)
|
||
if err != nil {
|
||
return nil, fmt.Errorf("load network baseline: %w", err)
|
||
}
|
||
changed, err := base.RestoreFiles()
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
if len(changed) > 0 {
|
||
log.Printf("[failback] restored network files: %v", changed)
|
||
}
|
||
return changed, nil
|
||
}
|
||
|
||
restoreCfg := func() (int, error) {
|
||
snapPath := filepath.Join(dataDir, "llm_snapshot.json")
|
||
snap, err := internalConfig.LoadLLMSnapshot(snapPath)
|
||
if err != nil {
|
||
return 0, fmt.Errorf("load llm snapshot: %w", err)
|
||
}
|
||
if err := cfgReg.RestoreCoreLLM(snap); err != nil {
|
||
return 0, err
|
||
}
|
||
if err := sdk.NewLLM(providerMgr, cfgReg, lua, baseAPIKey).ReloadFromConfig(); err != nil {
|
||
return 0, err
|
||
}
|
||
log.Printf("[failback] restored %d llm keys and reloaded from config", len(snap))
|
||
return len(snap), nil
|
||
}
|
||
|
||
ladder := &recovery.Ladder{
|
||
ResultFile: recovery.ResultPath(dataDir),
|
||
Attempt: task.Attempt,
|
||
Probe: probe,
|
||
RestoreNetwork: restoreNet,
|
||
RestoreConfig: restoreCfg,
|
||
Log: log.Printf,
|
||
}
|
||
res := ladder.Run(context.Background())
|
||
log.Printf("[failback] recovery round result: %s", res.Quote())
|
||
|
||
if res.Success {
|
||
os.Exit(exitRecovered)
|
||
}
|
||
os.Exit(exitRecoveryFailed)
|
||
}
|
||
|
||
func truncateStr(s string, n int) string {
|
||
if len(s) <= n {
|
||
return s
|
||
}
|
||
return s[:n] + "..."
|
||
}
|
||
|
||
// lastDiagSummary 读取最近一次 recovery_result 生成一行自诊断摘要(worker IPC ACK 上报)。
|
||
func lastDiagSummary(dataDir string) string {
|
||
res, err := recovery.LoadResult(recovery.ResultPath(dataDir))
|
||
if err != nil {
|
||
return ""
|
||
}
|
||
return res.Quote()
|
||
}
|