mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-11-06 01:07:35 +00:00
02022bc13d
## 1. internal/kernelupgrade：抽包（避免两份实现漂移）
原来 641 行全在 cmd/homed-upgrade 的 main 包里。内核侧的 kernel_update
工具要复用同一套逻辑，而 main 包不可被 import —— 照抄一份的后果是
"CLI 能升级、agent 调用却把机器搞坏"。
导出：ReadBinVersion / CompareVersions / ParseSemver / CmpSemver /
ProbePluginCompat / ExtractPkg / FindFile / DoUpgrade / WaitHealthy 等。
CLI 变薄壳（只留 flag 解析与 fail 输出）。
★ 顺带修一个真实 bug（判据抓到）：ParseSemver 原来只挡 len<2，
于是 "1.4" 漏过去、缺失的 patch 被零值填成 1.4.0 —— 会让
「1.4 → 1.4.0」被判成完全相同（进而说"无需升级"），而两者内容未必相同。
现在要求恰好三段。
## 2. scripts/migrate-plugins-to-org.sh：插件迁成独立仓库
为什么迁：插件散在 SDK 仓 example/ 下有三个问题 ——
① 插件版本与 SDK 版本绑死（一次 SDK 发版把所有插件都带上）
② 插件作者不能单独为自己的插件发版
③ plugin_update 需要"仓库地址 → 拉源码 → 编译"，而 example/ 是
别人的仓库，不是插件自己的仓库
脚本纪律：
· 默认 --dry-run，不碰 GitHub
· 产物不入库（dist/build/rawfile/node_modules/*.hmap 全排除）——
实测源码 3MB、产物 1.9G，后者进了仓库就再也删不干净
· 幂等：仓库已存在（422）则跳过创建，重跑安全
· 自动给 plg.json 补 repo 字段，使 plugin_update 能定位仓库
· 用 tar 管道而非 rsync：后者在最小化系统里常常没有（本机实测就没有）
执行结果：26 个插件全部迁移（25 Go + 1 Lua），仓库名与插件名同名。
126 lines
4.9 KiB
Go
126 lines
4.9 KiB
Go
// Command homed-upgrade 是**内核**升级闭环的 CLI 入口（默认只探测，不写盘）。
|
||
//
|
||
// 实现全部在 internal/kernelupgrade —— 内核侧的 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 (
|
||
"flag"
|
||
"fmt"
|
||
"os"
|
||
|
||
"github.com/JianFeeeee/HologramAgent/internal/kernelupgrade"
|
||
)
|
||
|
||
// fail 打印错误并以非零退出（CLI 专属；库内部一律返回 error）。
|
||
func fail(format string, a ...interface{}) {
|
||
fmt.Fprintf(os.Stderr, format+"\n", a...)
|
||
os.Exit(1)
|
||
}
|
||
|
||
func main() {
|
||
pkgPath := flag.String("pkg", "", "新安装包（.tar.gz）；给出即做探测")
|
||
binPath := flag.String("bin", "/usr/local/bin/homed", "当前运行的内核二进制路径")
|
||
pluginsDir := flag.String("plugins", "/home/newqqagent/plugins", "外部插件目录（探测兼容性用）")
|
||
apply := flag.Bool("apply", false, "真正执行升级（默认只探测+预检）")
|
||
flag.Parse()
|
||
|
||
if *pkgPath == "" {
|
||
fmt.Fprintln(os.Stderr, "必须提供 -pkg <新安装包.tar.gz>")
|
||
os.Exit(2)
|
||
}
|
||
|
||
tmp, err := os.MkdirTemp("", "homed-upgrade-*")
|
||
if err != nil {
|
||
fail("建临时目录: %v", err)
|
||
}
|
||
defer os.RemoveAll(tmp)
|
||
|
||
fmt.Printf("== 解包 %s ==\n", *pkgPath)
|
||
root, err := kernelupgrade.ExtractPkg(*pkgPath, tmp)
|
||
if err != nil {
|
||
fail("解包: %v", err)
|
||
}
|
||
|
||
// ── 1. 当前版本 ──
|
||
cur, curErr := kernelupgrade.ReadBinVersion(*binPath)
|
||
if curErr != nil {
|
||
fmt.Printf("⚠️ 读当前内核版本失败: %v\n", curErr)
|
||
cur = nil
|
||
} else {
|
||
fmt.Printf("当前内核: %s (commit %s)\n", cur.Version, kernelupgrade.ShortCommit(cur.Commit))
|
||
}
|
||
|
||
// ── 2. 新版本 ──
|
||
newBin := kernelupgrade.FindFile(root, "homed")
|
||
if newBin == "" {
|
||
fail("包内找不到 homed")
|
||
}
|
||
nv, err := kernelupgrade.ReadBinVersion(newBin)
|
||
if err != nil {
|
||
fail("新内核无法自报版本（可能不是本仓构建的二进制）: %v", err)
|
||
}
|
||
fmt.Printf("包内内核: %s (commit %s)\n", nv.Version, kernelupgrade.ShortCommit(nv.Commit))
|
||
|
||
// ── 3. 版本比较 ──
|
||
verdict := kernelupgrade.CompareVersions(cur, nv)
|
||
fmt.Printf("\n== 结论 ==\n%s\n", verdict)
|
||
|
||
// ── 4. depgraph 必须与新二进制同批 ──
|
||
newDG := kernelupgrade.FindFile(root, "depgraph.bin")
|
||
if newDG == "" {
|
||
fmt.Println("⚠️ 包内缺 depgraph.bin —— 内核启动会因依赖图不匹配拒绝启动")
|
||
} else {
|
||
fmt.Printf("depgraph.bin: 包内已带（%d 字节），将与 homed 同批替换\n", kernelupgrade.FileSize(newDG))
|
||
}
|
||
|
||
// ── 5. 插件兼容性预判（OTA 最容易出事的点）──
|
||
incompat := kernelupgrade.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. 真正升级（备份 → 替换 → 重启 → 后置验证 → 失败回滚）──
|
||
if err := kernelupgrade.DoUpgrade(root, *binPath, newDG, *pluginsDir); err != nil {
|
||
fail("升级失败: %v", err)
|
||
}
|
||
}
|
||
|