magic-agent 2.4.3 → 2.6.0

package/internal/client/browse_test.go

@@ -43,18 +43,25 @@ func TestRemapBrowseHost(t *testing.T) {
 
 func TestBrowseURL(t *testing.T) {
 	cases := []struct {
-		in, want string
+		in, want, tok string
 	}{
-		{"https://example.com/", "http://p/b/https/example.com/"},
-		{"https://example.com/a/b?x=1", "http://p/b/https/example.com/a/b?x=1"},
-		{"http://192.168.1.5:8080/x", "http://p/b/http/192.168.1.5:8080/x"},
-		{"mailto:a@b.c", "mailto:a@b.c"},
+		{"https://example.com/", "http://p/b/https/example.com/", ""},
+		{"https://example.com/a/b?x=1", "http://p/b/https/example.com/a/b?x=1", ""},
+		{"http://192.168.1.5:8080/x", "http://p/b/http/192.168.1.5:8080/x", ""},
+		{"mailto:a@b.c", "mailto:a@b.c", ""},
+		// 令牌拼进查询串：无 query 用 ?，有 query 用 &（APK 跨站 iframe 下
+		// SameSite=Lax cookie 不随子资源发送，令牌必须走在 URL 里）。
+		{"https://example.com/", "http://p/b/https/example.com/?magicToken=T", "T"},
+		{"https://example.com/a/b?x=1", "http://p/b/https/example.com/a/b?x=1&magicToken=T", "T"},
 	}
 	for _, c := range cases {
-		if got := browseURL(mustURL(t, c.in), testProxyBase); got != c.want {
-			t.Errorf("browseURL(%q) = %q，期望 %q", c.in, got, c.want)
+		if got := browseURL(mustURL(t, c.in), testProxyBase, c.tok); got != c.want {
+			t.Errorf("browseURL(%q, tok=%q) = %q，期望 %q", c.in, c.tok, got, c.want)
 		}
 	}
+	if got := browseURL(nil, testProxyBase, "T"); got != "" {
+		t.Errorf("browseURL(nil) 应为空串，实际 %q", got)
+	}
 }
 
 func TestStripMagicToken(t *testing.T) {
@@ -86,7 +93,7 @@ func TestRewriteBrowseHTML(t *testing.T) {
 		`<img srcset="/1.png 1x, /2.png 2x">` +
 		`<script>var s="/y";</script>` +
 		`</body></html>`
-	out := string(rewriteBrowseHTML([]byte(in), page, testProxyBase))
+	out := string(rewriteBrowseHTML([]byte(in), page, testProxyBase, ""))
 
 	wants := []string{
 		`href="http://p/b/https/example.com/x"`,
@@ -131,7 +138,7 @@ func TestRewriteCSS(t *testing.T) {
 	page := mustURL(t, "https://example.com/css/style.css")
 	in := `.a{background:url('/img/a.png')} .b{background:url(../img/b.png)}` +
 		`@import "sub.css"; @import url('/other.css');`
-	out := rewriteCSS(in, page, testProxyBase)
+	out := rewriteCSS(in, page, testProxyBase, "")
 	wants := []string{
 		`url(http://p/b/https/example.com/img/a.png)`,
 		`url(http://p/b/https/example.com/img/b.png)`,
@@ -145,6 +152,60 @@ func TestRewriteCSS(t *testing.T) {
 	}
 }
 
+// TestRewriteBrowseHTMLScriptSrc <script> 的**开标签属性**必须改写（src 等），
+// 内容原样保留。不改的后果：//cdn.example.com/a.js 这类协议相对地址绕过中转
+// 直连手机网络 —— 桌面端才能访问的内网站点照样裂（百度首页就挂着两个这种脚本）。
+func TestRewriteBrowseHTMLScriptSrc(t *testing.T) {
+	page := mustURL(t, "https://example.com/a/b")
+	in := `<script src="//cdn.example.com/a.js"></script>` +
+		`<script src="/local.js" defer></script>` +
+		`<script>var s="/y"; var u="https://keep.example.com/z";</script>` +
+		`<script type="application/json">{"src":"/not-a-url"}</script>`
+	out := string(rewriteBrowseHTML([]byte(in), page, testProxyBase, ""))
+
+	wants := []string{
+		`<script src="http://p/b/https/cdn.example.com/a.js"></script>`,
+		`<script src="http://p/b/https/example.com/local.js" defer></script>`,
+	}
+	for _, w := range wants {
+		if !strings.Contains(out, w) {
+			t.Errorf("script 开标签应被改写，缺少 %q\n实际：%s", w, out)
+		}
+	}
+	notWants := []string{
+		`/b/https/example.com/y`,         // 脚本内字符串不许动
+		`/b/https/keep.example.com/z`,    // 脚本内的绝对 URL 字符串也不许动
+		`/b/https/example.com/not-a-url`, // JSON 脚本块内容不许动
+	}
+	for _, nw := range notWants {
+		if strings.Contains(out, nw) {
+			t.Errorf("脚本内容不应被改写，却包含 %q\n实际：%s", nw, out)
+		}
+	}
+	if !strings.Contains(out, `var s="/y";`) || !strings.Contains(out, `var u="https://keep.example.com/z";`) {
+		t.Errorf("脚本内容应原样保留，实际：%s", out)
+	}
+}
+
+// TestRewriteBrowseHTMLToken 令牌要拼进每条改写出的 URL —— 跨站 iframe（APK 壳）下
+// SameSite=Lax cookie 不随子资源请求发送，URL 里的令牌是唯一凭据。
+func TestRewriteBrowseHTMLToken(t *testing.T) {
+	page := mustURL(t, "https://example.com/a/b")
+	in := `<img src="pic.png"><a href="/x?q=1">l</a>` +
+		`<div style="background:url('/bg.png')"></div>`
+	out := string(rewriteBrowseHTML([]byte(in), page, testProxyBase, "T"))
+	wants := []string{
+		`src="http://p/b/https/example.com/a/pic.png?magicToken=T"`,
+		`href="http://p/b/https/example.com/x?q=1&magicToken=T"`,
+		`url(http://p/b/https/example.com/bg.png?magicToken=T)`,
+	}
+	for _, w := range wants {
+		if !strings.Contains(out, w) {
+			t.Errorf("改写 URL 应带令牌，缺少 %q\n实际：%s", w, out)
+		}
+	}
+}
+
 // TestHandleBrowseE2E 端到端：起一个「拒绝内嵌」的上游站点，经中转取回，
 // 断言 (1) X-Frame-Options 被剥掉、(2) 页内链接被改写到本中转。
 func TestHandleBrowseE2E(t *testing.T) {
@@ -197,3 +258,40 @@ func TestHandleBrowseAuth(t *testing.T) {
 		t.Errorf("缺令牌应 401，实际 %d", resp.StatusCode)
 	}
 }
+
+// TestHandleBrowseTokenInURL 开了令牌时：改写出的 URL 必须带 ?magicToken=，
+// 且这个参数**不准透传给上游**（stripMagicToken 剥掉）。
+func TestHandleBrowseTokenInURL(t *testing.T) {
+	var gotQuery string
+	upstream := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		gotQuery = r.URL.RawQuery
+		w.Header().Set("Content-Type", "text/html; charset=utf-8")
+		_, _ = io.WriteString(w, `<html><head></head><body><img src="/pic.png"></body></html>`)
+	}))
+	defer upstream.Close()
+
+	up, err := url.Parse(upstream.URL)
+	if err != nil {
+		t.Fatal(err)
+	}
+	s := &Service{opts: Options{Token: "sekret"}}
+	proxy := httptest.NewServer(http.HandlerFunc(s.handleBrowse))
+	defer proxy.Close()
+
+	resp, err := http.Get(proxy.URL + browsePrefix + "http/" + up.Host + "/?magicToken=sekret")
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer resp.Body.Close()
+	body, _ := io.ReadAll(resp.Body)
+	if resp.StatusCode != http.StatusOK {
+		t.Fatalf("带正确令牌应 200，实际 %d", resp.StatusCode)
+	}
+	want := `src="` + proxy.URL + browsePrefix + "http/" + up.Host + "/pic.png?magicToken=sekret" + `"`
+	if !strings.Contains(string(body), want) {
+		t.Errorf("改写出的子资源 URL 应带令牌，期望包含 %q\n实际：%s", want, body)
+	}
+	if strings.Contains(gotQuery, "magicToken") {
+		t.Errorf("magicToken 不准透传给上游，实际上游收到 query=%q", gotQuery)
+	}
+}

package/internal/client/browseinput.go

@@ -0,0 +1,481 @@
+package client
+
+import (
+	"net/http"
+	"strings"
+	"sync"
+	"time"
+
+	"github.com/gorilla/websocket"
+)
+
+/* 内置浏览器的**输入中继**（手机端远程触控）。
+ *
+ * ── 分工（2026-10-25 内置浏览器 MCP 改基 agent-browser 后）──
+ * 驱动/截图面（`magic-client browse …`、需求截图）走 **agent-browser**
+ * （真实 Chromium/CDP，见 ab.go）——真实事件、CDP 级截图。
+ * 本中继只承担手机端「远程触控」：页面跑在手机的 WebView iframe 里，
+ * agent-browser 的浏览器在服务端，两者是两个上下文 —— 手机用户触屏操控
+ * iframe 里的页面仍走这里。
+ *
+ * ── 形状 ──
+ *   viewer（页面内 relay 脚本，同一时刻至多一个，后连顶掉前连）
+ *     → server：hello / state / ack
+ *     ← server：input / ping
+ *   driver（手机 UI，可多个）
+ *     → server：input（server 重编 seq 后转发给 viewer）
+ *     ← server：state / ack / viewer 上下线通知
+ *
+ * 坐标系 = 被代理页面自身的 CSS 像素；viewer 在 hello/state 里上报页面宽高，
+ * driver 需要换算时用它。VPN 开启或未配对时页面不走中转、脚本不注入，
+ * 鼠标中继自然不可用 —— 与浏览中转同边界。
+ *
+ * 已知边界：合成事件 isTrusted=false，个别反自动化站点会忽略 —— 如实记录，不假装是 CDP。
+ */
+
+const browseWSPath = "/browse-input"
+
+// BrowseWSPath 导出给驱动端 CLI（cmd/magic-client）拼连接地址用。
+const BrowseWSPath = browseWSPath
+
+// 输入动作白名单：白名单外的 action 直接回 ack 失败，不往页面派。
+//
+// （2026-10-25）shot 已退役：截图改走服务端 agent-browser（internal/client/ab.go，
+// POST /desk/requirements/shot-remote）。relay 只承担「远程鼠标」——
+// 真实事件、CDP 级截图交给 agent-browser，页面内栅格化的路子（html2canvas）
+// 有跨域污染 / iframe 抓不到 / 慢页超时三个硬伤，不再保留。
+var browseInputActions = map[string]bool{
+	"move": true, "down": true, "up": true, "click": true, "dblclick": true,
+	"scroll": true, "type": true, "key": true,
+}
+
+// browseMsg 中继线上的统一信封。字段全部可选，按 type 取用。
+type browseMsg struct {
+	Type string `json:"type"`
+	// input 帧
+	Seq    int      `json:"seq,omitempty"`
+	Action string   `json:"action,omitempty"`
+	X      float64  `json:"x,omitempty"`
+	Y      float64  `json:"y,omitempty"`
+	DX     float64  `json:"dx,omitempty"`
+	DY     float64  `json:"dy,omitempty"`
+	Text   string   `json:"text,omitempty"`
+	Key    string   `json:"key,omitempty"`
+	Mods   []string `json:"modifiers,omitempty"`
+	// state / hello 帧
+	Title string `json:"title,omitempty"`
+	URL   string `json:"url,omitempty"`
+	W     int    `json:"w,omitempty"`
+	H     int    `json:"h,omitempty"`
+	// ack 帧（OK 用指针：false 不能被 omitempty 吞掉，又不想让 input 帧带 ok 字段）
+	OK     *bool  `json:"ok,omitempty"`
+	Reason string `json:"reason,omitempty"`
+	// viewer 帧
+	Online bool `json:"online,omitempty"`
+	// Data 截图帧带回的数据（当前只有 shot 用：staging 上传后的 URL）。
+	Data string `json:"data,omitempty"`
+}
+
+// boolPtr ack 帧的小工具。
+func boolPtr(v bool) *bool { return &v }
+
+// browsePeer 一条已升级的连接：写互斥（gorilla 的 WriteJSON 并发不安全）。
+type browsePeer struct {
+	conn *websocket.Conn
+	wmu  sync.Mutex
+}
+
+func (p *browsePeer) write(msg *browseMsg) error {
+	p.wmu.Lock()
+	defer p.wmu.Unlock()
+	return p.conn.WriteJSON(msg)
+}
+
+// browseInputHub 中继枢纽。零值不可用，用 Service.inputHub() 惰性建。
+type browseInputHub struct {
+	mu      sync.Mutex
+	viewer  *browsePeer
+	drivers map[*browsePeer]bool
+	seq     int
+}
+
+func (s *Service) inputHub() *browseInputHub {
+	s.inputHubOnce.Do(func() { s.inputHubRef = &browseInputHub{drivers: map[*browsePeer]bool{}} })
+	return s.inputHubRef
+}
+
+func (h *browseInputHub) setViewer(p *browsePeer) (old *browsePeer) {
+	h.mu.Lock()
+	defer h.mu.Unlock()
+	old = h.viewer
+	h.viewer = p
+	return old
+}
+
+func (h *browseInputHub) clearViewer(p *browsePeer) {
+	h.mu.Lock()
+	defer h.mu.Unlock()
+	if h.viewer == p {
+		h.viewer = nil
+	}
+}
+
+func (h *browseInputHub) addDriver(p *browsePeer) {
+	h.mu.Lock()
+	defer h.mu.Unlock()
+	h.drivers[p] = true
+}
+
+func (h *browseInputHub) removeDriver(p *browsePeer) {
+	h.mu.Lock()
+	defer h.mu.Unlock()
+	delete(h.drivers, p)
+}
+
+// toDrivers 把一帧广播给所有 driver（state / ack / viewer 上下线）。
+func (h *browseInputHub) toDrivers(msg *browseMsg) {
+	h.mu.Lock()
+	defer h.mu.Unlock()
+	for d := range h.drivers {
+		_ = d.write(msg) // 单条失败留给读循环发现并清理
+	}
+}
+
+// dispatch driver 的 input 帧：重编 seq（保证全局有序且 ack 能对上），转给 viewer。
+func (h *browseInputHub) dispatch(action string, in *browseMsg) *browseMsg {
+	if !browseInputActions[action] {
+		return &browseMsg{Type: "ack", OK: boolPtr(false), Reason: "未知动作：" + action}
+	}
+	h.mu.Lock()
+	defer h.mu.Unlock()
+	if h.viewer == nil {
+		return &browseMsg{Type: "ack", OK: boolPtr(false), Reason: "页面未连接（viewer 离线）"}
+	}
+	h.seq++
+	in.Seq = h.seq
+	if err := h.viewer.write(in); err != nil {
+		return &browseMsg{Type: "ack", OK: boolPtr(false), Reason: "派发失败：" + err.Error()}
+	}
+	return nil // ack 由 viewer 回
+}
+
+func (s *Service) handleBrowseInput(w http.ResponseWriter, r *http.Request) {
+	// 鉴权：与 /b/、/proxy-ws 同口径 —— 查询令牌或 cookie。
+	if want := strings.TrimSpace(s.opts.Token); want != "" {
+		got := strings.TrimSpace(r.URL.Query().Get("token"))
+		if got == "" {
+			if c, err := r.Cookie(browseCookie); err == nil {
+				got = c.Value
+			}
+		}
+		if got != want {
+			http.Error(w, "缺少或错误的访问令牌", http.StatusUnauthorized)
+			return
+		}
+	}
+
+	role := r.URL.Query().Get("role")
+	if role != "viewer" && role != "driver" {
+		role = "driver"
+	}
+
+	c, err := wsUpgrader.Upgrade(w, r, nil)
+	if err != nil {
+		return // Upgrade 已写过响应
+	}
+	peer := &browsePeer{conn: c}
+	hub := s.inputHub()
+
+	defer func() {
+		_ = c.WriteControl(websocket.CloseMessage,
+			websocket.FormatCloseMessage(websocket.CloseNormalClosure, ""),
+			time.Now().Add(time.Second))
+		_ = c.Close()
+	}()
+
+	switch role {
+	case "viewer":
+		old := hub.setViewer(peer)
+		if old != nil {
+			_ = old.conn.Close() // 后连顶前连：旧 viewer 的读循环随即退出
+		}
+		hub.toDrivers(&browseMsg{Type: "viewer", Online: true})
+		defer func() {
+			hub.clearViewer(peer)
+			hub.toDrivers(&browseMsg{Type: "viewer", Online: false})
+		}()
+		s.browseViewerLoop(hub, peer)
+	default: // driver
+		hub.addDriver(peer)
+		defer hub.removeDriver(peer)
+		// 新 driver 上线：把当前 viewer 在线状态与最后一次页面状态同步给它。
+		hub.mu.Lock()
+		online := hub.viewer != nil
+		hub.mu.Unlock()
+		_ = peer.write(&browseMsg{Type: "viewer", Online: online})
+		s.browseDriverLoop(hub, peer)
+	}
+}
+
+// browseViewerLoop 读 viewer 的帧：hello/state 转给 drivers，其余忽略。
+func (s *Service) browseViewerLoop(hub *browseInputHub, peer *browsePeer) {
+	s.log.Printf("browse-input: viewer 已连接 (%s)", peer.conn.RemoteAddr())
+	defer s.log.Printf("browse-input: viewer 已断开")
+	for {
+		var m browseMsg
+		if err := peer.conn.ReadJSON(&m); err != nil {
+			return
+		}
+		switch m.Type {
+		case "hello", "state", "ack":
+			// hello/state 广播给所有 driver；ack 按 seq 归属，典型只有一个 driver，
+			// 这里同样广播，由 driver 自己按 seq 认领。
+			hub.toDrivers(&m)
+		default:
+			// ping 等 server 主动发；viewer 发来的其它类型不认识就不转发。
+		}
+	}
+}
+
+// browseDriverLoop 读 driver 的帧：只认 input，派发给 viewer；其余回 ack 失败。
+func (s *Service) browseDriverLoop(hub *browseInputHub, peer *browsePeer) {
+	for {
+		var m browseMsg
+		if err := peer.conn.ReadJSON(&m); err != nil {
+			return
+		}
+		switch m.Type {
+		case "input":
+			if ack := hub.dispatch(m.Action, &m); ack != nil {
+				_ = peer.write(ack)
+			}
+		case "ping":
+			// 让 viewer 报一次当前状态（CLI 的 `browse state` 靠它）。
+			hub.mu.Lock()
+			v := hub.viewer
+			hub.mu.Unlock()
+			if v != nil {
+				_ = v.write(&browseMsg{Type: "ping"})
+			} else {
+				_ = peer.write(&browseMsg{Type: "ack", OK: boolPtr(false), Reason: "页面未连接（viewer 离线）"})
+			}
+		default:
+			_ = peer.write(&browseMsg{Type: "ack", OK: boolPtr(false), Reason: "driver 只能发 input/ping 帧"})
+		}
+	}
+}
+
+/* browseRelayJS 注入到中转页面里的 relay 脚本。
+ *
+ * 职责：
+ *   - 连回 /browse-input?role=viewer（cookie 鉴权由浏览器自动带上；断线重连）
+ *   - 收 input 帧在被代理页面里派发合成事件（页面自身 CSS 像素坐标）
+ *   - 叠加一只虚拟鼠标：对称导航箭头（绿色），跟随 driver 的移动/点击，点击有双涟漪反馈
+ *   - 页面加载完成 / 标题变化时上报 state；每条 input 回 ack
+ *
+ * 刻意不做的：不拦截页面自身事件、不做 DOM 摘要 —— 只当一只「远程鼠标」。
+ */
+const browseRelayJS = `(function () {
+  'use strict';
+  var SENTINEL = '__magicBrowseRelay';
+  if (window[SENTINEL]) return;            // 防 SPA 反复执行
+  window[SENTINEL] = true;
+
+  var ws = null, seqSeen = 0, titleTimer = null;
+  var curEl = null, curSvg = null, curDot = null, curPressed = false, curX = -100, curY = -100;
+
+  // ---- 虚拟鼠标：对称导航箭头（绿填充+白描边），热点=顶部尖端；按压点+点击双涟漪。
+  //      pointer-events:none，不干扰页面事件。 ----
+  function ensureCursor() {
+    if (curEl) return;
+    var doc = document;
+    curEl = doc.createElement('div');
+    curEl.id = '__magic_vmouse';
+    curEl.setAttribute('style',
+      'position:fixed;left:0;top:0;z-index:2147483647;pointer-events:none;will-change:transform;');
+    curEl.innerHTML =
+      '<svg width="50" height="50" viewBox="0 0 32 32" style="display:block;transition:transform .1s;' +
+      'filter:drop-shadow(0 2px 6px rgba(46,160,100,.5))">' +
+      '<path d="M16 1.5 L30 28.5 L16 21.8 L2 28.5 Z" ' +
+      'fill="#2fbf71" stroke="#fff" stroke-width="1.6" stroke-linejoin="round"/></svg>';
+    curSvg = curEl.firstChild;
+    curDot = doc.createElement('div');
+    curDot.setAttribute('style',
+      'position:fixed;left:0;top:0;z-index:2147483647;pointer-events:none;width:16px;height:16px;margin:-8px;' +
+      'border-radius:50%;background:rgba(47,191,113,.4);border:3px solid #fff;' +
+      'box-shadow:0 0 10px rgba(47,191,113,.9);transition:transform .1s;');
+    doc.body.appendChild(curEl);
+    doc.body.appendChild(curDot);
+    curEl.style.transform = 'translate(' + (curX - 25) + 'px,' + (curY - 2.3) + 'px)';
+    curDot.style.transform = 'translate(' + curX + 'px,' + curY + 'px) scale(0)';
+  }
+
+  function moveCursor(x, y) {
+    if (typeof x !== 'number' || typeof y !== 'number') return;
+    curX = x; curY = y;
+    ensureCursor();
+    // viewBox 0 0 32 32 → 50px：尖端在 (25, 2.3)，把它对齐到坐标点
+    curEl.style.transform = 'translate(' + (x - 25) + 'px,' + (y - 2.3) + 'px)';
+    curDot.style.transform = 'translate(' + x + 'px,' + y + 'px) scale(' + (curPressed ? 1 : 0) + ')';
+  }
+
+  function pressCursor(down) {
+    curPressed = down;
+    if (curSvg) curSvg.style.transform = down ? 'scale(.9)' : 'scale(1)';
+    if (curDot) curDot.style.transform =
+      'translate(' + curX + 'px,' + curY + 'px) scale(' + (down ? 1 : 0) + ')';
+  }
+
+  function rippleCursor(x, y) {
+    ensureCursor();
+    var mk = function (scale, opacity) {
+      var d = document.createElement('div');
+      var size = 60;
+      d.setAttribute('style',
+        'position:fixed;left:' + (x - size / 2) + 'px;top:' + (y - size / 2) + 'px;width:' + size + 'px;height:' + size + 'px;' +
+        'margin:0;border-radius:50%;border:3px solid rgba(47,191,113,.85);pointer-events:none;z-index:2147483646;' +
+        'box-shadow:0 0 14px rgba(47,191,113,.45);transform:scale(' + scale + ');opacity:' + opacity + ';' +
+        'transition:transform .45s ease-out,opacity .45s ease-out;');
+      document.body.appendChild(d);
+      requestAnimationFrame(function () {
+        d.style.transform = 'scale(' + (scale + 0.35) + ')';
+        d.style.opacity = '0';
+      });
+      setTimeout(function () { if (d.parentNode) d.parentNode.removeChild(d); }, 520);
+    };
+    mk(0.45, 0.95);   // 快环
+    mk(0.85, 0.5);    // 慢环
+  }
+
+  function pageState(type) {
+    return { type: type || 'state', title: document.title || '',
+             url: location.href, w: window.innerWidth, h: window.innerHeight };
+  }
+
+  function send(m) {
+    try { if (ws && ws.readyState === 1) ws.send(JSON.stringify(m)); } catch (e) {}
+  }
+
+  function fireMouse(action, m) {
+    var x = m.x || 0, y = m.y || 0;
+    var opts = { bubbles: true, cancelable: true, view: window,
+                 clientX: x, clientY: y, button: 0, buttons: 0 };
+    var tgt = document.elementFromPoint(x, y) || document.body;
+    if (!tgt) return;
+    function ev(Type, extra) {
+      var o = {}; for (var k in opts) o[k] = opts[k];
+      if (extra) for (var k2 in extra) o[k2] = extra[k2];
+      return typeof PointerEvent === 'function' ? new PointerEvent(Type, o) : new MouseEvent(Type, o);
+    }
+    if (action === 'move') { tgt.dispatchEvent(ev('pointermove', { pointerType: 'mouse' })); tgt.dispatchEvent(new MouseEvent('mousemove', opts)); return; }
+    if (action === 'scroll') {
+      tgt.dispatchEvent(new WheelEvent('wheel', { bubbles: true, cancelable: true, view: window,
+        clientX: x, clientY: y, deltaX: m.dx || 0, deltaY: m.dy || 0 }));
+      window.scrollBy(m.dx || 0, m.dy || 0);
+      return;
+    }
+    var down = (action === 'down' || action === 'click' || action === 'dblclick');
+    var up = (action === 'up' || action === 'click' || action === 'dblclick');
+    if (down) { tgt.dispatchEvent(ev('pointerdown', { pointerType: 'mouse', isPrimary: true, buttons: 1 })); tgt.dispatchEvent(new MouseEvent('mousedown', Object.assign({}, opts, { buttons: 1 }))); }
+    if (up) {
+      tgt.dispatchEvent(ev('pointerup', { pointerType: 'mouse', isPrimary: true }));
+      tgt.dispatchEvent(new MouseEvent('mouseup', opts));
+      tgt.dispatchEvent(new MouseEvent('click', opts));
+      if (action === 'dblclick') tgt.dispatchEvent(new MouseEvent('dblclick', opts));
+    }
+  }
+
+  function fireKey(m) {
+    var tgt = document.activeElement || document.body;
+    var base = { bubbles: true, cancelable: true, view: window, key: m.key || '', code: m.key || '' };
+    tgt.dispatchEvent(new KeyboardEvent('keydown', base));
+    tgt.dispatchEvent(new KeyboardEvent('keyup', base));
+  }
+
+  function fireType(m) {
+    var x = m.x, y = m.y, tgt = null;
+    if (typeof x === 'number' && typeof y === 'number') tgt = document.elementFromPoint(x, y);
+    tgt = tgt || document.activeElement || document.body;
+    if (tgt.focus) { try { tgt.focus(); } catch (e) {} }
+    var text = m.text || '';
+    if (tgt && (tgt.tagName === 'INPUT' || tgt.tagName === 'TEXTAREA' || tgt.isContentEditable)) {
+      var v = tgt.value !== undefined ? tgt.value : tgt.textContent;
+      var merged = (v || '') + text;
+      if (tgt.value !== undefined) { tgt.value = merged; } else { tgt.textContent = merged; }
+      tgt.dispatchEvent(new Event('input', { bubbles: true }));
+      tgt.dispatchEvent(new Event('change', { bubbles: true }));
+      return;
+    }
+    fireKey({ key: text });
+  }
+
+  function handle(m) {
+    if (!m || m.type !== 'input' || !m.action) return;
+    try {
+      switch (m.action) {
+        case 'move': case 'down': case 'up': case 'click': case 'dblclick': case 'scroll': case 'type':
+          if (typeof m.x === 'number' && typeof m.y === 'number') {
+            moveCursor(m.x, m.y);
+            if (m.action === 'down') pressCursor(true);
+            if (m.action === 'up') pressCursor(false);
+            if (m.action === 'click' || m.action === 'dblclick') rippleCursor(m.x, m.y);
+          }
+          break;
+        default: break;
+      }
+      switch (m.action) {
+        case 'move': case 'down': case 'up': case 'click': case 'dblclick': case 'scroll':
+          fireMouse(m.action, m); break;
+        case 'type': fireType(m); break;
+        case 'key': fireKey(m); break;
+        default: send({ type: 'ack', seq: m.seq, ok: false, reason: '未知动作' }); return;
+      }
+      seqSeen = m.seq;
+      send({ type: 'ack', seq: m.seq, ok: true });
+    } catch (e) {
+      send({ type: 'ack', seq: m.seq, ok: false, reason: String(e && e.message || e) });
+    }
+  }
+
+  /* 连接用的令牌：中转 URL 上的 magicToken 就是访问令牌（browse.go 的鉴权口径）。
+     APK 壳的 iframe 与桌面端**跨站**，SameSite=Lax 的 cookie 不随 WebSocket
+     握手发送 —— 只靠 cookie 会连不上 viewer。 */
+  function pageToken(fallback) {
+    try {
+      var q = new URLSearchParams(location.search);
+      var t = q.get('magicToken');
+      if (t) return t;
+    } catch (e) {}
+    return fallback || '';
+  }
+
+  function connect() {
+    var proto = location.protocol === 'https:' ? 'wss:' : 'ws:';
+    /* 令牌：优先取页面地址里的 magicToken（每条改写出的 URL 都带它）。
+       没有就退回 cookie（同源场景能过）—— 但 APK 壳的跨站 iframe 两者都可能没有，
+       那时连不上 viewer：如实表现为「页面未连接」，不假装能驱动。 */
+    var wsUrl = proto + '//' + location.host + '/browse-input?role=viewer';
+    var tok = pageToken();
+    if (tok) wsUrl += '&token=' + encodeURIComponent(tok);
+    try { ws = new WebSocket(wsUrl); }
+    catch (e) { setTimeout(connect, 4000); return; }
+    ws.onopen = function () { send(pageState('hello')); };
+    ws.onmessage = function (e) {
+      var m; try { m = JSON.parse(e.data); } catch (err) { return; }
+      if (m.type === 'ping') { send(pageState('state')); return; }
+      handle(m);
+    };
+    ws.onclose = function () { setTimeout(connect, 2000); };
+    ws.onerror = function () { try { ws.close(); } catch (e2) {} };
+  }
+
+  connect();
+  // 标题/地址变化探测：轻量轮询足够（SPA 改标题不派事件）。
+  var lastTitle = document.title, lastHref = location.href;
+  titleTimer = setInterval(function () {
+    if (document.title !== lastTitle || location.href !== lastHref) {
+      lastTitle = document.title; lastHref = location.href;
+      send(pageState('state'));
+    }
+  }, 1500);
+})();`