// Command homed-upgrade 是**内核**升级闭环的 CLI 入口(默认只探测,不写盘)。 // // 实现全部在 internal/update —— 内核侧的 kernel_update 工具走同一套 // 代码,避免"CLI 能升级、agent 调用却把机器搞坏"这类两份实现的漂移。 // // ## 范围:只面向内核 // // 只处理 homed / depgraph.bin / waiter 三个文件。**不碰插件**——插件有独立的 // 升级通道(pluginmgr),且插件与内核的兼容性由"自动禁用不兼容插件"处理 // (见 internal/plugin/registry.go 的 maybeAutoDisableIncompatible): // 换内核后旧 SDK 编的插件会握手失败,内核把它持久禁用并写明原因, // 用户在界面上直接看到"为什么没了",而不是翻日志。 // // ## 为什么默认只探测 // // 替换二进制不可逆,且内核是这个机器上唯一常驻的关键服务。默认只做 // 探测与预检、把"会发生什么"完整报出来;`-apply` 才真动手。 // 沿同仓 homed-kb-migrate / homed-predicate-migrate 的惯例。 // // ## 探测什么(-probe) // // 1. 当前运行的内核版本(从 /proc 找进程,读它自己的 --version 输出) // 2. 新包里的内核版本 // 3. 两者比较:能否升级、是不是降级、commit 是否真的变了 // 4. depgraph.bin 与新二进制是否匹配(包内自带,必须同批替换) // 5. 现有插件与**新**内核的兼容性预判(SDK 主版本) // // 第 5 条是 OTA 里最容易出事的地方:内核换了、插件没换。这里提前算出来, // 好让用户在动手前就知道"升完会有 N 个插件被自动禁用"。 package main import ( "database/sql" "flag" "fmt" "os" "os/exec" "path/filepath" "strings" "time" _ "github.com/mattn/go-sqlite3" "github.com/JianFeeeee/HologramAgent/internal/update" ) // fail 打印错误并以非零退出(CLI 专属;库内部一律返回 error)。 // upgradeDataDir 返回内核**真实**的数据目录(升级确认标记与备份的落点)。 // // ## ★ 不猜路径,只认两个显式来源 // // ① `-data `(人工直接给,最高优先) // ② `config.db` 里的 `core.daemon.data_dir` // // 都拿不到就返回**空串**:调用方会因此拒绝 `-apply` 并说明怎么修。 // 不许"用一个看起来合理的路径顶上"(曾用 `/home/newqqagent` 硬编码, // 也曾用 `/data` 兜底): // // · 硬编码在目录/用户迁移后指向**不存在的路径** // · exe 兜底实测得出 /usr/bin/data,而生产实际是 // ExecStart=/usr/bin/homed --role=guard --data /var/lib/hologram // ⇒ 建备份目录 EROFS(/usr/bin 只读)⇒ 升级必挂; // ⇒ 标记落到内核读不到的位置 ⇒ 升级失败静默不回滚 // // 返回空比返回一个错的值安全得多:前者被守卫拦住,后者要等出事才知道。 func upgradeDataDir(explicit string) string { if d := strings.TrimSpace(explicit); d != "" { return d } return dataDirFromConfigDB() } // dataDirFromConfigDB 从内核配置库读 core.daemon.data_dir。 // // ## 为什么要猜 config.db 的位置(而 dataDir 本身不猜) // // 循环依赖:data_dir 就在 config.db 里,而 config.db 就在 data_dir 里。 // 所以只能按“部署惯例”去找它:二进制同级的 ../newqqagent/config.db // (本仓默认部署形态)+ 几个常见位置。这是找**线索**,不是拿它当结论: // 读到的 core.daemon.data_dir 是内核自己写下的值,而非我们的推测。 // // 只读打开(PRAGMA query_only=1),不建表、不迁移 —— 升级 CLI 绝不能 // 因为查询配置而改动内核的库(WAL 模式下写入还会与运行中的内核抢锁)。 func dataDirFromConfigDB() string { bin, err := os.Executable() if err != nil { bin = "homed-upgrade" } // 候选顺序:安装形态(/bin/homed-upgrade → /newqqagent) // 在前,其它常见布局在后。找到第一个能读的即止。 prefixes := []string{filepath.Dir(filepath.Dir(bin))} if home, herr := os.UserHomeDir(); herr == nil && home != "" { prefixes = append(prefixes, home) } var candidates []string for _, p := range prefixes { candidates = append(candidates, filepath.Join(p, "newqqagent", "config.db")) } candidates = append(candidates, "/var/lib/hologram/config.db", "/home/newqqagent/config.db") for _, dbPath := range candidates { if !update.FileExists(dbPath) { continue } if d := readDataDirFromConfigDB(dbPath); d != "" { fmt.Printf("数据目录来源: %s 的 core.daemon.data_dir = %s\n", dbPath, d) return d } } return "" } // readDataDirFromConfigDB 只读地取一个 config.db 里的 core.daemon.data_dir。 func readDataDirFromConfigDB(dbPath string) string { // 不 import internal/config:那会连带注册表的建表/播种逻辑, // 对一个只读查询来说太重且会写盘。直接一个只读连接。 db, err := sql.Open("sqlite3", dbPath) if err != nil { return "" } defer db.Close() // query_only:结构性地堵死写入(不依赖调用方自觉)。 if _, err := db.Exec("PRAGMA query_only=1"); err != nil { return "" } var v string if err := db.QueryRow(`SELECT value FROM config WHERE key = 'core.daemon.data_dir'`).Scan(&v); err != nil { return "" } return strings.TrimSpace(v) } func fail(format string, a ...interface{}) { fmt.Fprintf(os.Stderr, format+"\n", a...) os.Exit(1) } func main() { pkgPath := flag.String("pkg", "", "本地安装包(.tar.gz);与 -release 二选一") release := flag.Bool("release", false, "从 GitHub 最新 Release 下载 OTA 包(默认仅探测;配合 -apply 执行)") binPath := flag.String("bin", "/usr/local/bin/homed", "当前运行的内核二进制路径") pluginsDir := flag.String("plugins", "/home/newqqagent/plugins", "外部插件目录(探测兼容性用)") apply := flag.Bool("apply", false, "真正执行升级(默认只探测+预检)") // ★ 显式的 --data 优先;不给则从 config.db 的 core.daemon.data_dir 读。 // 两者都拿不到时 -apply 直接拒绝(而不是猜一个路径)。 dataDirFlag := flag.String("data", "", "内核数据目录(= 内核的 --data;不填则从 config.db 的 core.daemon.data_dir 读)") unit := flag.String("unit", "homeagent", "重启用的 systemd 单元名(仅 -apply 时使用)") flag.Parse() if *pkgPath == "" && !*release { fmt.Fprintln(os.Stderr, "必须提供 -pkg <安装包.tar.gz> 或 -release") os.Exit(2) } tmp, err := os.MkdirTemp("", "homed-upgrade-*") if err != nil { fail("建临时目录: %v", err) } defer os.RemoveAll(tmp) if *release { path := filepath.Join(tmp, "release.tar.gz") info, downloadErr := update.DownloadLatestRelease(path) if downloadErr != nil { fail("下载最新 GitHub Release: %v", downloadErr) } *pkgPath = path fmt.Printf("最新 Release: %s (%s)\n", info.Latest, info.Asset) } fmt.Printf("== 解包 %s ==\n", *pkgPath) root, err := update.ExtractPkg(*pkgPath, tmp) if err != nil { fail("解包: %v", err) } // ── 1. 当前版本 ── cur, curErr := update.ReadBinVersion(*binPath) if curErr != nil { fmt.Printf("⚠️ 读当前内核版本失败: %v\n", curErr) cur = nil } else { fmt.Printf("当前内核: %s (commit %s)\n", cur.Version, update.ShortCommit(cur.Commit)) } // ── 2. 新版本 ── newBin := update.FindFile(root, "homed") if newBin == "" { fail("包内找不到 homed") } nv, err := update.ReadBinVersion(newBin) if err != nil { fail("新内核无法自报版本(可能不是本仓构建的二进制): %v", err) } fmt.Printf("包内内核: %s (commit %s)\n", nv.Version, update.ShortCommit(nv.Commit)) // ── 3. 版本比较 ── verdict := update.CompareVersions(cur, nv) fmt.Printf("\n== 结论 ==\n%s\n", verdict) // ── 4. depgraph 必须与新二进制同批 ── newDG := update.FindFile(root, "depgraph.bin") if newDG == "" { fmt.Println("⚠️ 包内缺 depgraph.bin —— 内核启动会因依赖图不匹配拒绝启动") } else { fmt.Printf("depgraph.bin: 包内已带(%d 字节),将与 homed 同批替换\n", update.FileSize(newDG)) } // ── 5. 插件兼容性预判(OTA 最容易出事的点)── incompat := update.ProbePluginCompat(*pluginsDir, nv.SDKVersion) if len(incompat) > 0 { fmt.Printf("\n== 插件兼容性警告(%d 个)==\n", len(incompat)) fmt.Println("换内核后这些插件会握手失败并被**自动禁用**(写入禁用配置 + 原因):") for _, p := range incompat { fmt.Printf(" · %-16s SDK %s(新内核要求主版本 %s)\n", p.Name, p.SDKVersion, p.WantMajor) } fmt.Println("它们在界面上会显示为「已禁用」并带原因,重编插件或手动启用即可恢复。") } else { fmt.Println("\n== 插件兼容性 ==\n现有插件与新内核 SDK 主版本一致,无需重编。") } if !*apply { fmt.Println("\n(探测模式:未改动任何文件。确认无误后加 -apply)") return } // ── 6. 真正升级:预检 → 备份 → pending → 原子替换(**不含重启**)── // // ★ dataDir 必须在**动手之前**解析失败就退出:它是备份、pending 标记、 // 回滚坏二进制的共同落点。拿不到就拒绝升级,而不是猜一个。 dataDir := upgradeDataDir(*dataDirFlag) if dataDir == "" { fail("无法确定内核数据目录(升级确认标记与备份无处可放 ⇒ 无回滚能力)\n"+ "请显式指定:-data (与内核 unit 的 --data 一致,如 systemctl show %s -p ExecStart)\n"+ "或确认 %s 存在且含 core.daemon.data_dir", *unit, "/home/newqqagent/config.db") } fmt.Printf("数据目录: %s\n", dataDir) out, err := update.Apply(root, *binPath, newDG, dataDir, nil) if err != nil { fail("升级失败: %v", err) } fmt.Printf("\n新内核已就位:%s → %s\n备份保留在 %s\n", out.From.Version, out.To.Version, out.BackupDir) // ── 7. 重启服务并核对版本 ── // // ★ 为什么 CLI 可以停下服务:它**不在**被守护的 cgroup 里,是外部管理命令, // 与"worker 自己 systemctl restart 自杀"是两件事。 // 服务在跑时优先让它走既有重启通道(guard 重拉、不计失败轮次)—— // 那需要 WebAPI 的 api_key,这里只做最朴素的外部重启,并如实报告结果。 fmt.Printf("\n== 重启服务(unit %s)==\n", *unit) if rerr := restartUnit(*unit); rerr != nil { fmt.Printf("⚠️ 重启失败: %v\n", rerr) fmt.Printf(" 新内核已在磁盘上就位,pending 标记也已写入:\n") fmt.Printf(" · 服务下次启动时会自动确认新版本;若新版本起不来,第 0 层 update 模块会自动回滚\n") fail("需要手动重启服务才能生效") } // 版本复核:等二进制自报版本变成期望值(最多 60s)。 // 用版本而不是进程状态:只有版本能证明"跑起来的确实是新的"。 deadline := time.Now().Add(60 * time.Second) for time.Now().Before(deadline) { if v, verr := update.ReadBinVersion(*binPath); verr == nil && v.Version == nv.Version && v.Commit == nv.Commit { fmt.Printf("\n✅ 升级完成:%s (commit %s)\n", v.Version, update.ShortCommit(v.Commit)) return } time.Sleep(time.Second) } if v, verr := update.ReadBinVersion(*binPath); verr == nil { fmt.Printf("⚠️ 版本复核未通过:期望 %s/%s,实际 %s/%s\n", nv.Version, update.ShortCommit(nv.Commit), v.Version, update.ShortCommit(v.Commit)) } fail("重启后未能确认新版本已生效(若服务起不来,下次启动会自动回滚)") } // restartUnit 重启 systemd 单元(外部管理动作)。 func restartUnit(unit string) error { out, err := exec.Command("systemctl", "restart", unit).CombinedOutput() if err != nil { return fmt.Errorf("%v (%s)", err, strings.TrimSpace(string(out))) } return nil }