magic-agent 1.0.111 → 2.1.5

package/cmd/magic-client/main.go

@@ -88,6 +88,7 @@ func main() {
 		UIRoot:     *uiDir,
 		MobileRoot: *mobileDir,
 		Token:      tok,
+		Lan:        *lan,
 		BrowseUA:   *browseUA,
 	})
 	if err != nil {

package/internal/client/apk.go

@@ -0,0 +1,135 @@
+package client
+
+import (
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"os"
+	"path/filepath"
+	"strings"
+)
+
+// 移动端 APK 的分发（2026-10-22，用户：「移动端版本跟着 npm 走」+「在版本号的地方
+// 可以显示版本也可检测最新版本号并触发升级」）。
+//
+// 版本号只有一个来源：npm 包里的 package.json。构建时 magic-test 的
+// tools/build-mobile-apk.cjs 把同一个版本写进 APK 的 versionName，并把 release 包放到
+// npm/apk/ 下随包发布。本插件负责把它通过局域网递给手机：
+//
+//	GET /desk/app     -> {version, size, url}（手机「我的」→「版本」点一下先问这个）
+//	GET /desk/app.apk -> 真正的安装包（浏览器/系统下载器用 ?token= 过鉴权）
+//
+// 为什么由桌面端发：手机和桌面已经配对、这条路一定通；不依赖 GitHub Release / 应用市场，
+// 也不需要把 7MB 的 APK 塞进每个平台的 npm 二进制目录。
+
+// apkManifest 与 npm/apk/version.json 对应，由 magic-test 的打包脚本生成。
+type apkManifest struct {
+	Version     string `json:"version"`
+	VersionCode int    `json:"versionCode"`
+}
+
+// findBundledAPK 从可执行文件所在目录向上找 npm/apk/magic-agent-mobile-release.apk。
+//
+// 两种布局都要能命中：
+//   - 开发态：<repo>/bin/magic-client          → <repo>/npm/apk/...
+//   - npm 全局：<pkg>/npm/dist/<os>-<arch>/magic-client → <pkg>/npm/apk/...
+//
+// 不写死层级：向上最多找 6 层，遇到根就停。cwd 也找一遍 —— 开发时从别的目录启动、
+// 但包目录在 cwd 下面时仍能命中。
+func findBundledAPK() string {
+	const rel = "npm/apk/magic-agent-mobile-release.apk"
+	var roots []string
+	addAncestors := func(start string) {
+		dir, err := filepath.Abs(start)
+		if err != nil {
+			return
+		}
+		for i := 0; i < 6; i++ {
+			roots = append(roots, dir)
+			parent := filepath.Dir(dir)
+			if parent == dir {
+				break
+			}
+			dir = parent
+		}
+	}
+	if exe, err := os.Executable(); err == nil {
+		if real, err := filepath.EvalSymlinks(exe); err == nil {
+			exe = real
+		}
+		addAncestors(filepath.Dir(exe))
+	}
+	if wd, err := os.Getwd(); err == nil {
+		addAncestors(wd)
+	}
+	for _, root := range roots {
+		p := filepath.Join(root, filepath.FromSlash(rel))
+		if st, err := os.Stat(p); err == nil && st.Mode().IsRegular() {
+			return p
+		}
+	}
+	return ""
+}
+
+// apkVersion 读 version.json；缺失时从文件名兜底（magic-agent-mobile-<ver>-release.apk）。
+func apkVersion(path string) string {
+	b, err := os.ReadFile(filepath.Join(filepath.Dir(path), "version.json"))
+	if err == nil {
+		var m apkManifest
+		if json.Unmarshal(b, &m) == nil && strings.TrimSpace(m.Version) != "" {
+			return strings.TrimSpace(m.Version)
+		}
+	}
+	name := filepath.Base(path)
+	name = strings.TrimSuffix(name, ".apk")
+	name = strings.TrimPrefix(name, "magic-agent-mobile-")
+	name = strings.TrimSuffix(name, "-release")
+	if name != "" && name != filepath.Base(path) {
+		return name
+	}
+	return ""
+}
+
+func (s *Service) apkAvailable() bool {
+	if s.apkPath == "" {
+		return false
+	}
+	st, err := os.Stat(s.apkPath)
+	return err == nil && st.Mode().IsRegular()
+}
+
+// handleAppInfo GET /desk/app：告诉手机「桌面端这份 npm 包里带的 APK 是哪一版」。
+// 没带 APK 时也回 200 + 空 version —— 手机据此说「暂无可安装包」，而不是把 404 当网络错误。
+func (s *Service) handleAppInfo(w http.ResponseWriter, r *http.Request) {
+	out := struct {
+		Version string `json:"version"`
+		Size    int64  `json:"size"`
+		URL     string `json:"url"`
+	}{}
+	if s.apkAvailable() {
+		if st, err := os.Stat(s.apkPath); err == nil {
+			out.Version = apkVersion(s.apkPath)
+			out.Size = st.Size()
+			out.URL = "/desk/app.apk"
+		}
+	}
+	writeJSON(w, http.StatusOK, out)
+}
+
+// handleAppAPK GET /desk/app.apk：把包里的 APK 原样送出去。
+// token 可以走查询参数 —— 系统浏览器/下载器带不了 X-Magic-Token，guard 已经支持 ?token=。
+func (s *Service) handleAppAPK(w http.ResponseWriter, r *http.Request) {
+	if !s.apkAvailable() {
+		writeErr(w, http.StatusNotFound, "这个 magic-client 包里没有 APK（npm/apk/ 为空）")
+		return
+	}
+	ver := apkVersion(s.apkPath)
+	name := "magic-agent-mobile.apk"
+	if ver != "" {
+		name = "magic-agent-mobile-" + ver + ".apk"
+	}
+	w.Header().Set("Content-Type", "application/vnd.android.package-archive")
+	w.Header().Set("Content-Disposition", fmt.Sprintf("attachment; filename=%q", name))
+	w.Header().Set("Cache-Control", "no-store")
+	http.ServeFile(w, r, s.apkPath)
+}

package/internal/client/apk_test.go

@@ -0,0 +1,99 @@
+package client
+
+import (
+	"encoding/json"
+	"net/http"
+	"net/http/httptest"
+	"os"
+	"path/filepath"
+	"testing"
+)
+
+// 2026-10-22：移动端「我的」→「版本」点一下要能问桌面端「包里带的 APK 是哪一版」，
+// 再决定是否触发下载。这里钉住两个接口的形状与空包时的行为。
+
+func writeTestAPK(t *testing.T, dir, version string) string {
+	t.Helper()
+	apk := filepath.Join(dir, "magic-agent-mobile-release.apk")
+	body := []byte("fake-apk-" + version)
+	if err := os.WriteFile(apk, body, 0o644); err != nil {
+		t.Fatal(err)
+	}
+	m := apkManifest{Version: version, VersionCode: 20102}
+	b, _ := json.Marshal(m)
+	if err := os.WriteFile(filepath.Join(dir, "version.json"), b, 0o644); err != nil {
+		t.Fatal(err)
+	}
+	return apk
+}
+
+func TestAppInfoAndAPK(t *testing.T) {
+	dir := t.TempDir()
+	apk := writeTestAPK(t, dir, "2.1.2")
+	s := &Service{apkPath: apk}
+
+	rec := httptest.NewRecorder()
+	s.handleAppInfo(rec, httptest.NewRequest(http.MethodGet, "/desk/app", nil))
+	if rec.Code != http.StatusOK {
+		t.Fatalf("app info code = %d, want 200", rec.Code)
+	}
+	var got struct {
+		Version string `json:"version"`
+		Size    int64  `json:"size"`
+		URL     string `json:"url"`
+	}
+	if err := json.Unmarshal(rec.Body.Bytes(), &got); err != nil {
+		t.Fatal(err)
+	}
+	if got.Version != "2.1.2" || got.URL != "/desk/app.apk" || got.Size != int64(len("fake-apk-2.1.2")) {
+		t.Fatalf("app info = %+v", got)
+	}
+
+	rec = httptest.NewRecorder()
+	s.handleAppAPK(rec, httptest.NewRequest(http.MethodGet, "/desk/app.apk", nil))
+	if rec.Code != http.StatusOK {
+		t.Fatalf("apk code = %d, want 200", rec.Code)
+	}
+	if rec.Body.String() != "fake-apk-2.1.2" {
+		t.Fatalf("apk body = %q", rec.Body.String())
+	}
+	if ct := rec.Header().Get("Content-Type"); ct != "application/vnd.android.package-archive" {
+		t.Fatalf("content-type = %q", ct)
+	}
+	if cd := rec.Header().Get("Content-Disposition"); cd == "" {
+		t.Fatal("缺少 Content-Disposition，浏览器会拿不到 .apk 文件名")
+	}
+}
+
+func TestAppInfoWithoutAPK(t *testing.T) {
+	s := &Service{}
+	rec := httptest.NewRecorder()
+	s.handleAppInfo(rec, httptest.NewRequest(http.MethodGet, "/desk/app", nil))
+	if rec.Code != http.StatusOK {
+		t.Fatalf("code = %d, want 200（没包也要让手机能说「暂无」）", rec.Code)
+	}
+	var got map[string]any
+	if err := json.Unmarshal(rec.Body.Bytes(), &got); err != nil {
+		t.Fatal(err)
+	}
+	if got["version"] != "" || got["url"] != "" {
+		t.Fatalf("空包 info = %+v", got)
+	}
+
+	rec = httptest.NewRecorder()
+	s.handleAppAPK(rec, httptest.NewRequest(http.MethodGet, "/desk/app.apk", nil))
+	if rec.Code != http.StatusNotFound {
+		t.Fatalf("空包 apk code = %d, want 404", rec.Code)
+	}
+}
+
+func TestAPKVersionFallsBackToFilename(t *testing.T) {
+	dir := t.TempDir()
+	apk := filepath.Join(dir, "magic-agent-mobile-3.2.1-release.apk")
+	if err := os.WriteFile(apk, []byte("x"), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	if got := apkVersion(apk); got != "3.2.1" {
+		t.Fatalf("apkVersion = %q, want 3.2.1", got)
+	}
+}

package/internal/client/prefs.go

@@ -0,0 +1,99 @@
+package client
+
+import (
+	"encoding/json"
+	"io"
+	"net/http"
+	"os"
+	"path/filepath"
+)
+
+/* 移动端「环境配置」的远端存储（2026-10-22 用户：
+ * 「环境的配置应该在远程上 不是浏览器缓存 否则同一个环境多个客户端配置还不一致」）。
+ *
+ * 为什么放在桌面端：默认引擎/模型、团队配置、空间选择这些描述的是**这台桌面怎么干活**，
+ * 不是某台手机的屏幕习惯。存在浏览器 localStorage 里，手机 A 改了手机 B 不知道；
+ * 换一台手机连同一台桌面，看到的还是另一套配置。
+ *
+ *   GET  /desk/prefs -> 这台桌面当前的配置 JSON（没有就是 {}）
+ *   PUT  /desk/prefs -> 整份覆盖（移动端改完推上来）
+ *
+ * 只存一个 JSON 文件，字段由移动端定义、桌面端不解释 —— 这样加一个配置项不用改这里。
+ * 落在 ~/.magic-agent/mobile-prefs.json，与 core 的其它数据同层次。
+ *
+ * 不做版本/合并：多端同时改就是「后写覆盖」。这些是偏好而不是业务数据，
+ * 冲突代价低；真需要并发控制时再加 version 字段也不迟。
+ */
+
+const mobilePrefsMaxBytes = 256 << 10
+
+func mobilePrefsPath() string {
+	home, err := os.UserHomeDir()
+	if err != nil || home == "" {
+		return ""
+	}
+	return filepath.Join(home, ".magic-agent", "mobile-prefs.json")
+}
+
+func (s *Service) handlePrefs(w http.ResponseWriter, r *http.Request) {
+	switch r.Method {
+	case http.MethodGet:
+		w.Header().Set("Cache-Control", "no-store")
+		p := mobilePrefsPath()
+		if p == "" {
+			writeJSON(w, http.StatusOK, map[string]any{})
+			return
+		}
+		b, err := os.ReadFile(p)
+		if err != nil || len(b) == 0 {
+			// 没存过 = 空配置，不把「文件不存在」当成错误。
+			writeJSON(w, http.StatusOK, map[string]any{})
+			return
+		}
+		if !json.Valid(b) {
+			writeJSON(w, http.StatusOK, map[string]any{})
+			return
+		}
+		w.Header().Set("Content-Type", "application/json; charset=utf-8")
+		_, _ = w.Write(b)
+
+	case http.MethodPut:
+		body, err := io.ReadAll(io.LimitReader(r.Body, mobilePrefsMaxBytes+1))
+		if err != nil {
+			writeErr(w, http.StatusBadRequest, "读请求体失败："+err.Error())
+			return
+		}
+		if len(body) > mobilePrefsMaxBytes {
+			writeErr(w, http.StatusRequestEntityTooLarge, "配置超过 256KB")
+			return
+		}
+		var v map[string]any
+		if err := json.Unmarshal(body, &v); err != nil {
+			writeErr(w, http.StatusBadRequest, "不是合法的 JSON 对象")
+			return
+		}
+		p := mobilePrefsPath()
+		if p == "" {
+			writeErr(w, http.StatusInternalServerError, "找不到用户目录")
+			return
+		}
+		if err := os.MkdirAll(filepath.Dir(p), 0o755); err != nil {
+			writeErr(w, http.StatusInternalServerError, "建目录失败："+err.Error())
+			return
+		}
+		// 先写临时文件再 rename：多端同时推的时候不会读到写了一半的 JSON。
+		tmp := p + ".tmp"
+		if err := os.WriteFile(tmp, body, 0o600); err != nil {
+			writeErr(w, http.StatusInternalServerError, "写配置失败："+err.Error())
+			return
+		}
+		if err := os.Rename(tmp, p); err != nil {
+			writeErr(w, http.StatusInternalServerError, "落盘失败："+err.Error())
+			return
+		}
+		writeJSON(w, http.StatusOK, map[string]any{"ok": true})
+
+	default:
+		writeErr(w, http.StatusMethodNotAllowed, "只支持 GET / PUT")
+	}
+}

package/internal/client/service.go

@@ -15,6 +15,7 @@ import (
 	"io"
 	"log"
 	"math"
+	"net"
 	"net/http"
 	"net/http/httputil"
 	"net/url"
@@ -62,6 +63,12 @@ type Options struct {
 	// Token 访问令牌；空 = 启动时随机生成。
 	Token  string
 	Logger *log.Logger
+	// APKPath 可选：要分发给移动端的 APK 路径。空 = 自动在包内 npm/apk/ 下找
+	// （见 apk.go）。显式给路径主要给测试与特殊布局用。
+	APKPath string
+	// Lan 是否绑到了局域网（--lan）。移动端「环境」菜单要靠它拿到手机可用的入口，
+	// 否则用户只能手抄 IP。绑回环时不报（报了也连不上）。
+	Lan bool
 	// BrowseUA 内置浏览器中转使用的 User-Agent；空 = 用内置的 Android Chrome。
 	// 为什么可配：UA 会决定站点给哪一版页面。中国大陆出口 + 移动 UA 时，Google 会跳到
 	// http://www.google.cn/m（该路径本身就是 404）；换成桌面 UA 则走香港跳转、可正常打开。
@@ -88,6 +95,16 @@ type Service struct {
 
 	// 需求自动归纳的调度状态（每工作区一个防抖计时器，见 requirements.go）。
 	reqAuto reqAuto
+
+	// 随包发布的移动端 APK（空 = 这个包里没带）。见 apk.go。
+	apkPath string
+
+	/* 公网入口探测（2026-10-22）：隧道是**壳**起的，插件不知道它的域名，而 quick tunnel
+	   每次启动都换域名。这里缓存 probePublicURL 的结果，让 /desk/health 不必每次都扫端口。 */
+	pubMu   sync.Mutex
+	pubURL  string
+	pubExp  time.Time
+	pubBusy bool
 }
 
 // Contract core `--contract` 里本插件关心的部分。
@@ -134,6 +151,14 @@ func New(opts Options) (*Service, error) {
 		opts.MagicAgent = "magic-agent"
 	}
 	s := &Service{opts: opts, log: opts.Logger, runs: map[string]*askRun{}}
+	// 移动端 APK：显式路径优先；否则在包内 npm/apk/ 找（随 npm 包发布，见 apk.go）。
+	s.apkPath = strings.TrimSpace(opts.APKPath)
+	if s.apkPath == "" {
+		s.apkPath = findBundledAPK()
+	}
+	if s.apkPath != "" {
+		s.log.Printf("移动端 APK：%s（v%s）", s.apkPath, apkVersion(s.apkPath))
+	}
 
 	// 项目后端的反代一次建好：profile 合法就给代理，非法就启动即失败
 	//（地址写错比运行时 502 更容易查——启动日志里说清楚）。
@@ -178,6 +203,10 @@ func (s *Service) Handler() http.Handler {
 	mux := http.NewServeMux()
 	mux.HandleFunc("/desk/health", s.guard(s.handleHealth))
 	mux.HandleFunc("/desk/contract", s.guard(s.handleContract))
+	// 移动端 APK：版本信息 + 安装包本身（版本号跟 npm 包走，见 apk.go）。
+	mux.HandleFunc("/desk/app", s.guard(s.handleAppInfo))
+	// 系统浏览器/下载器带不了自定义头，这个接口靠 guard 支持的 ?token= 过鉴权。
+	mux.HandleFunc("/desk/app.apk", s.guard(s.handleAppAPK))
 	mux.HandleFunc("/desk/engines", s.guard(s.handleEngines))
 	mux.HandleFunc("/desk/profile", s.guard(s.handleProfile))
 	mux.HandleFunc("/desk/modules", s.guard(s.handleModules))
@@ -192,6 +221,9 @@ func (s *Service) Handler() http.Handler {
 	// 按**绝对路径**读文本文件（Markdown / 日志 / 源码）：移动端产物卡「查看」在浮层里阅读。
 	mux.HandleFunc("/desk/path-read", s.guard(s.handlePathRead))
 	mux.HandleFunc("/desk/titles", s.guard(s.handleTitles))
+	// 移动端「环境配置」（引擎/模型/团队/空间选择）的远端存储：多客户端连同一台桌面时共用一份，
+	// 不再各存各的 localStorage（见 prefs.go）。
+	mux.HandleFunc("/desk/prefs", s.guard(s.handlePrefs))
 	// 需求聚合（2026-10-22，见 requirements.go）：读清单 / 手动整理一轮。
 	// 自动归纳不在这里 —— 它是每轮 /desk/ask 收尾后的防抖动作。
 	mux.HandleFunc("/desk/requirements", s.guard(s.handleRequirements))
@@ -362,12 +394,171 @@ func (s *Service) handleHealth(w http.ResponseWriter, r *http.Request) {
 		// 而且 HEAD 请求在 WebView 里常被记成 ERR_ABORTED 的失败请求（导航抢跑），
 		// 排查时是纯噪音。探活本来就要打这一枪，顺手带一句最省。
 		"remoteUI": s.hasMobileUI(),
+		// 手机可用的局域网入口（2026-10-22，只增字段，不升 contractVersion）。
+		// 移动端「环境」菜单据此自动给出「公司远程」那条，用户不必手抄 IP。
+		// 只给地址、不带令牌：页面自己握着令牌，别把门锁写进响应体里。
+		// 没绑局域网 / 拿不到网卡地址 → null。
+		"lanUrls": s.lanURLs(r.Host),
+		// 公网入口（2026-10-22）：本机 cloudflared quick tunnel 的域名，空 = 没开公网。
+		// 移动端「公司远程」优先用这条（不在同一个 Wi-Fi 也能连）；拿不到才退回 lanUrls。
+		"publicUrl": s.publicURL(),
 		// 团队角色清单（2026-10-22）：移动端「团队模式」页要按角色配路由，
 		// 角色名不能由客户端硬编码。老 core 没有 teamRoles → null，客户端回落内置清单。
 		"teamRoles": s.contract.TeamRoles,
 	})
 }
 
+// lanURLs 服务端自己上报的手机可用入口（形如 http://10.0.0.5:58849/）。
+//
+// 端口从请求的 Host 里取：服务可能绑 0 端口由系统分配，这里不必再存一份。
+// 只返回地址、不带令牌 —— 页面已经握着令牌，别把门锁写进响应体。
+func (s *Service) lanURLs(hostport string) []string {
+	if !s.opts.Lan {
+		return nil
+	}
+	_, portStr, err := net.SplitHostPort(hostport)
+	if err != nil {
+		return nil
+	}
+	port, err := strconv.Atoi(portStr)
+	if err != nil || port <= 0 {
+		return nil
+	}
+	addrs := LanAddresses(port)
+	out := make([]string, 0, len(addrs))
+	for _, a := range addrs {
+		out = append(out, "http://"+a+"/")
+	}
+	return out
+}
+
+// publicTTL 公网入口探测结果的缓存时长。quick tunnel 换域名只发生在重启/开关时，
+// 两分钟足够新；过期后是**后台**刷新，请求路径上不阻塞。
+const publicTTL = 2 * time.Minute
+
+// quickTunnelPortLo/Hi cloudflared 的本地 metrics 端口范围。
+// 端口由 cloudflared 自己从 20241 起顺延分配（实测 20241–20244），这里留足余量。
+const (
+	quickTunnelPortLo = 20240
+	quickTunnelPortHi = 20280
+)
+
+// publicURL 返回本服务对外的 Cloudflare quick tunnel 地址（形如 https://xxx.trycloudflare.com）。
+//
+// 为什么要探测而不是配置：隧道是**壳（掌天瓶）**起的，插件不知道它的域名；quick tunnel
+// 每次启动都换域名，写死或让用户手抄都不成立。cloudflared 把域名放在本地 metrics 的
+// /quicktunnel 里，扫一小段端口就能拿到候选，再用**本服务自己的令牌**回打一次
+// /desk/health 确认「这条隧道确实指向我」（别人的隧道令牌不同 → 401）。
+//
+// 空返回 = 没开公网 / 还没扫到；调用方（移动端）退回局域网地址，不假装有。
+func (s *Service) publicURL() string {
+	s.pubMu.Lock()
+	cur, exp, busy := s.pubURL, s.pubExp, s.pubBusy
+	s.pubMu.Unlock()
+	if busy || time.Now().Before(exp) {
+		return cur
+	}
+	s.pubMu.Lock()
+	if s.pubBusy {
+		s.pubMu.Unlock()
+		return s.pubURL
+	}
+	s.pubBusy = true
+	s.pubMu.Unlock()
+
+	go func() {
+		u := s.probePublicURL()
+		s.pubMu.Lock()
+		changed := u != s.pubURL
+		s.pubURL = u
+		s.pubExp = time.Now().Add(publicTTL)
+		s.pubBusy = false
+		s.pubMu.Unlock()
+		if changed && s.log != nil {
+			if u == "" {
+				s.log.Printf("公网入口：未发现（本机没有指向本服务的 cloudflared quick tunnel）")
+			} else {
+				s.log.Printf("公网入口：%s", u)
+			}
+		}
+	}()
+	return cur
+}
+
+// probePublicURL 扫 cloudflared 的 metrics 端口，找出指向本服务的那条 quick tunnel。
+func (s *Service) probePublicURL() string {
+	tok := strings.TrimSpace(s.opts.Token)
+	if tok == "" {
+		return ""
+	}
+	hosts := make(chan string, quickTunnelPortHi-quickTunnelPortLo+1)
+	for p := quickTunnelPortLo; p <= quickTunnelPortHi; p++ {
+		go func(port int) {
+			cl := &http.Client{Timeout: 400 * time.Millisecond}
+			resp, err := cl.Get(fmt.Sprintf("http://127.0.0.1:%d/quicktunnel", port))
+			if err != nil {
+				hosts <- ""
+				return
+			}
+			defer resp.Body.Close()
+			var v struct {
+				Hostname string `json:"hostname"`
+			}
+			if resp.StatusCode != http.StatusOK || json.NewDecoder(resp.Body).Decode(&v) != nil {
+				hosts <- ""
+				return
+			}
+			hosts <- strings.TrimSpace(v.Hostname)
+		}(p)
+	}
+	var cands []string
+	for i := 0; i <= quickTunnelPortHi-quickTunnelPortLo; i++ {
+		if h := <-hosts; h != "" {
+			cands = append(cands, h)
+		}
+	}
+	if len(cands) == 0 {
+		return ""
+	}
+
+	// 用本服务的令牌回打一次：只有真正指向本服务的隧道才认这个令牌。
+	var (
+		mu    sync.Mutex
+		found string
+		wg    sync.WaitGroup
+	)
+	for _, h := range cands {
+		wg.Add(1)
+		go func(host string) {
+			defer wg.Done()
+			req, err := http.NewRequest(http.MethodGet, "https://"+host+"/desk/health", nil)
+			if err != nil {
+				return
+			}
+			req.Header.Set("X-Magic-Token", tok)
+			resp, err := (&http.Client{Timeout: 3 * time.Second}).Do(req)
+			if err != nil {
+				return
+			}
+			defer resp.Body.Close()
+			if resp.StatusCode != http.StatusOK {
+				return
+			}
+			var v map[string]any
+			if json.NewDecoder(resp.Body).Decode(&v) != nil || v["ok"] != true {
+				return
+			}
+			mu.Lock()
+			if found == "" {
+				found = "https://" + host
+			}
+			mu.Unlock()
+		}(h)
+	}
+	wg.Wait()
+	return found
+}
+
 // handleContract 原样转发 core 的契约（客户端拿它做能力降级，不需要经过插件再解释一遍）。
 func (s *Service) handleContract(w http.ResponseWriter, r *http.Request) {
 	s.proxyCore(w, r, "--contract")

package/npm/apk/version.json

@@ -0,0 +1,5 @@
+{
+  "version": "2.1.3",
+  "versionCode": 20103,
+  "builtAt": "2026-10-22T11:18:59.511Z"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "magic-agent",
-  "version": "1.0.111",
+  "version": "2.1.5",
   "description": "专业的 agent CLI 代理工具 - 统一 claude / codebuddy / trae / llm / codex / openclaw 引擎",
   "license": "MIT",
   "bin": {
@@ -22,6 +22,7 @@
     "npm/bin/",
     "npm/lib/",
     "npm/dist/",
+    "npm/apk/",
     "npm/install.js",
     "cmd/",
     "internal/",