HomeAgent/internal/plugins/webui/kernel_update.go

package webui

// 内核更新的 HTTP 端点（GET 检查 / POST 升级）。
//
// ## 三端共享同一底层（架构约束）
//
// agent 的 kernel_update 工具、本端点、CLI（homed-upgrade）三者共享
// internal/update 的 CheckRelease / Apply —— 三份实现必然漂移，会出现
// "WebUI 说有新版、agent 说没有"的分裂状态。
// 本文件只做 HTTP 形状转换，不含业务逻辑。
//
// ## 包来源二选一
//
//	{"release": true}                  → 从仓库最新 GitHub Release 自动下载
//	{"pkg": "/path/to/pkg.tar.gz"}     → 用本机已有的安装包（优先）
//
// ## 升级 = 换产物 + 重启，两件事**分开做**
//
//	Apply（本进程内，同步）  ：校验 → 备份 → pending → 原子替换
//	重启（交给内核控制通道）  ：kernelCtl.RequestKernelRestart → exit 42
//	                           → guard 用新二进制重拉（不计失败轮次）
//
// ★ 为什么 Apply 必须同步返回：替换是**可失败**的动作（空间不足、权限、
// 包损坏）。异步的话这些错误全被吞掉，用户只看到"已受理"然后毫无变化。
// 而重启可以异步 —— 它让本进程消失，本来就没法回给它结果。
//
// ★ 为什么不用 systemctl restart：见 cmd/homed/kernel_control.go ——
// worker 是被守护方，只有 guard 知道这次退出该不该重拉。

import (
	"encoding/json"
	"log"
	"net/http"
	"os"

	"github.com/JianFeeeee/HologramAgent/internal/events"
	"github.com/JianFeeeee/HologramAgent/internal/update"
)

// handleKernelUpdate 是 /api/v1/kernel/update 的统一入口（GET 检查 / POST 升级）。
func (h *Handler) handleKernelUpdate(w http.ResponseWriter, r *http.Request) {
	switch r.Method {
	case http.MethodGet:
		h.handleKernelUpdateCheck(w, r)
	case http.MethodPost:
		h.handleKernelUpdateApply(w, r)
	default:
		writeJSONError(w, http.StatusMethodNotAllowed, "只接受 GET（检查）或 POST（升级）")
	}
}

// handleKernelUpdateCheck 处理 GET —— 只检查不改动。
func (h *Handler) handleKernelUpdateCheck(w http.ResponseWriter, r *http.Request) {
	writeJSON(w, http.StatusOK, update.CheckRelease(currentKernelVersion()))
}

// handleKernelUpdateApply 处理 POST /api/v1/kernel/update —— 执行升级。
func (h *Handler) handleKernelUpdateApply(w http.ResponseWriter, r *http.Request) {
	var body struct {
		Pkg     string `json:"pkg"`
		Release bool   `json:"release"`
	}
	// body 可为空（不合法就在下面报"必须指定来源"），所以解码失败不单独报错。
	_ = json.NewDecoder(r.Body).Decode(&body)

	src, err := update.ParseSource(body.Pkg, body.Release)
	if err != nil {
		writeJSONError(w, http.StatusBadRequest, err.Error())
		return
	}

	binPath := update.KernelBinaryPath()

	tmp, err := os.MkdirTemp("", "kernel-upgrade-*")
	if err != nil {
		writeJSONError(w, http.StatusInternalServerError, "建临时目录失败: "+err.Error())
		return
	}
	defer os.RemoveAll(tmp)

	root, rel, err := src.Resolve(tmp)
	if err != nil {
		writeJSONError(w, http.StatusBadGateway, "取包失败: "+err.Error())
		return
	}
	newDG := update.FindFile(root, "depgraph.bin")

	// WebUI 侧天然有总线（它就是 SSE 的上游）：升级每一步都让界面看得到
	var bus *events.Bus
	if h.sdk != nil {
		bus = h.sdk.EventBus()
	}

	out, err := update.Apply(root, binPath, newDG, dataDirOf(binPath), bus)
	if err != nil {
		writeJSONError(w, http.StatusInternalServerError, err.Error())
		return
	}

	res := map[string]interface{}{
		"applied": true,
		"from":    out.From.Version,
		"to":      out.To.Version,
		"backup":  out.BackupDir,
		"message": "新内核已就位，正在重启。新版本启动后由第 0 层 update 模块确认；无法启动会自动回滚。",
	}
	if rel != nil {
		res["release"] = rel.Latest
		res["asset"] = rel.Asset
	}

	// 先把响应写回，再让内核消失（同 kernel/restart 的教训：不 Flush 会
	// 变成 connection reset，用户以为出错了）。
	writeJSON(w, http.StatusOK, res)
	if f, ok := w.(http.Flusher); ok {
		f.Flush()
	}

	// 重启走**既有**内核控制通道（restartCh → exit 42 → guard 用新二进制重拉）。
	// 不自己 systemctl，也不另开通道。
	if h.kernelCtl == nil {
		log.Printf("[webui] 新内核已就位，但内核控制通道不可用（kernelControlAllowed 未授予 webui），无法请求重启")
		return
	}
	if err := h.kernelCtl.RequestKernelRestart("kernel_update apply"); err != nil {
		log.Printf("[webui] kernel restart request failed (新内核已就位，需手动重启): %v", err)
	}
}

// currentKernelVersion 读本机 homed 的版本（尽力而为）。
func currentKernelVersion() *update.BinVersion {
	bin := update.KernelBinaryPath()
	if _, err := os.Stat(bin); err != nil {
		return nil
	}
	v, err := update.ReadBinVersion(bin)
	if err != nil {
		return nil
	}
	return v
}

// dataDirOf 返回内核**真实**的数据目录（ks.DataDir，来自 `-data`）。
//
// ★ 取注入值，不做任何推导：pending 标记落在哪，第 0 层 update 模块就从
// 哪读；两边一漂移，升级失败时就**静默不回滚**。而“猜一个看起来合理的
// 路径”（曾用过 env → exe 同级 data）会让 Apply 的空值守卫变成死代码——
// 实测生产是 `--data /var/lib/hologram`，而 exe 推导得 /usr/bin/data
// （只读目录，建备份必 EROFS）。
//
// 拿不到就返回空串，由 Apply 拒绝升级并报错。
func dataDirOf(binPath string) string {
	return update.KernelDataDir()
}