dsh-plugin-vrmpet3d 0.1.1 → 0.1.3

package/lib/desktop-page.js

@@ -164,6 +164,7 @@
        */
       '.vrmpet3d-desktop-status[data-tone="gold"]{color:#ffc94d}',
       '.vrmpet3d-desktop-status[data-tone="gold"][data-bold="1"]{font-weight:700}',
+      '.vrmpet3d-desktop-status[data-attention="1"]{pointer-events:auto;cursor:pointer;text-shadow:0 0 4px currentColor,0 0 10px currentColor,0 0 18px currentColor}',
       '.vrmpet3d-desktop-status[data-tone="danger"]{color:#ff6b6b}',
       /**
        * 碎碎念: the pet's own short remark, above the prompt.
@@ -222,6 +223,7 @@
       '.vrmpet3d-desktop-status-content{display:flex;align-items:center;min-width:0}',
       /* `nowrap`, always: the operator's "提示文字永不换行". One line, however long the line is. */
       '.vrmpet3d-desktop-status-text{color:inherit;font-variant-numeric:tabular-nums;white-space:nowrap}',
+      '.vrmpet3d-desktop-status-dot{pointer-events:auto;cursor:pointer}',
       '.vrmpet3d-desktop-status-text[data-shimmer-text]::after{content:attr(data-shimmer-text)}',
       '.vrmpet3d-desktop-status-decoration{position:absolute;inset:0;overflow:clip;pointer-events:none;user-select:none}',
       '.vrmpet3d-desktop-status-decoration[hidden]{display:none}',
@@ -690,6 +692,7 @@
       if (id === 'globalSettings') { openSettingsWindow('global'); return; }
       // 切换模型: the model picker's page, the same one the guide's 偏好模型 step is built from.
       if (id === 'switchModel') { openSettingsWindow('picker'); return; }
+      if (id === 'miniGame') { openSettingsWindow('game'); return; }
       /**
        * 重载模型 — the same row the app pet's menu grew, with the same meaning (operator, 2026-10-14: 「给内置和外置宠物的右键
        * 菜单新增“重载模型”的选项，用来刷新模型」): re-read the model FILE and rebuild this window's scene. Nothing about the
@@ -715,10 +718,9 @@
          * 旧的 `client.menu.js`，而那个 chunk 里这一行还在。这时它必须照旧工作，而不是掉出函数末尾什么都不做 ——
          * 一个点了没反应的菜单项，比一个不显示的行难查得多。
          *
-         * 动作本身没变：宠物回到 DSH 里，而这个窗由 APP 关掉（一个写者；见 `applySurface`/`adoptSurface`）。
+         * 宠物回到 DSH 里；本页持久化选择后直接请宿主关闭浮窗，不依赖 DSH 页面在前台。
          */
-        preferences.petSurface = 'app';
-        writePreferences(store, core, preferences);
+        returnToApp();
         return;
       }
       /**
@@ -738,13 +740,12 @@
         /**
          * 关闭独立宠物: the pet goes back INSIDE the app, which is the only thing closing this window can mean.
          *
-         * It is the same write as 切换回窗口内 — this window is the pet's box, so a window with no pet in it is
-         * nothing at all, and the app is what stops this window (one writer; see the `surface` branch above).
+         * Persist the same choice as 切换回窗口内, then ask the host to stop this window.
+         * The app renderer may be paused in the background; it reads that choice when it wakes.
          * The row was 关闭宠物 until 2026-10-12 and used to HIDE the pet as well; the operator split the two
          * meanings then, keeping hiding for the app's pet (隐藏宠物) and this one for handing the pet back.
          */
-        preferences.petSurface = 'app';
-        writePreferences(store, core, preferences);
+        returnToApp();
         return;
       }
       if (id === 'restartHarness' || id === 'quitHarness') {
@@ -755,6 +756,26 @@
       }
     }
 
+    function returnToApp() {
+      preferences.petSurface = 'app';
+      // Persist first, then stop this window through the host. A background DSH
+      // renderer may not run its settings callback until it becomes foreground.
+      return fetch('/vrmpet3d/settings', {
+        method: 'POST', headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ preferences: { petSurface: 'app' } }),
+      }).then(function (response) { return response.ok ? response.json() : null; })
+        .then(function (snapshot) {
+          if (!snapshot || !snapshot.preferences || snapshot.preferences.petSurface !== 'app') return null;
+          preferences.petSurface = 'app';
+          try { if (store) store.setItem(core.STORAGE_KEY, JSON.stringify(preferences)); } catch (_error) { /* host is authoritative */ }
+          return fetch('/vrmpet3d/desktop', {
+            method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ action: 'disable' }),
+          }).then(function (response) {
+            if (!response.ok && bridge && typeof bridge.quit === 'function') bridge.quit();
+          }, function () { if (bridge && typeof bridge.quit === 'function') bridge.quit(); });
+        }).catch(function () { return null; });
+    }
+
     /**
      * Push this surface's 重力 (`windowGravity`) into the placement.
      *
@@ -832,6 +853,7 @@
      */
     function openMenuAt(frameX, frameY) {
       if (!menu) return false;
+      prepareDance();
       /**
        * 非debug模式生效, read at OPEN time.
        *
@@ -853,6 +875,7 @@
       if (typeof menu.setChecked === 'function') {
         menu.setChecked('gravity', preferences.windowGravity === true);
       }
+      if (menu.setDanceState) menu.setDanceState(hostState);
       var size = menu.open();
       var width = Math.min(size.width, Math.max(80, placement.viewportWidth - MENU_MARGIN * 2));
       var height = Math.min(size.height, Math.max(80, placement.viewportHeight - MENU_MARGIN * 2));
@@ -987,6 +1010,24 @@
     var speechNode = null;
     var speechBox = null;
     var hostSpeech = null;
+    var hostSpeechUntil = 0;
+    var hostSpeechTimer = null;
+
+    function receiveHostSpeech(line) {
+      var next = typeof line === 'string' && line ? line : null;
+      if (next === hostSpeech) return;
+      if (hostSpeechTimer) clearTimeout(hostSpeechTimer);
+      hostSpeechTimer = null;
+      hostSpeech = next;
+      var hold = preferences && preferences.speech && Number(preferences.speech.holdSeconds);
+      hostSpeechUntil = next ? Date.now() + (hold > 0 ? hold : 8) * 1000 : 0;
+      if (next) hostSpeechTimer = setTimeout(function () {
+        hostSpeechTimer = null;
+        renderSpeech();
+        reportRect();
+        publish();
+      }, Math.max(0, hostSpeechUntil - Date.now()));
+    }
     var speechShown = null;
     /**
      * A line THIS page said, because its own pet was touched, and until when.
@@ -1108,6 +1149,17 @@
       statusNode.appendChild(statusIconNode);
       statusNode.appendChild(shimmer);
       doc.body.appendChild(statusNode);
+      statusDotNode.title = language === 'en' ? 'Open completed conversation' : '打开已完成的会话';
+      statusNode.addEventListener('click', function (event) {
+        var completed = event.target === statusDotNode && ['working', 'waiting'].indexOf(hostState) !== -1 && Number(hostUnread) > 0;
+        if (!completed && ['done', 'waiting', 'error'].indexOf(hostState) === -1) return;
+        fetch('/vrmpet3d/desktop', {
+          method: 'POST', headers: { 'content-type': 'application/json' },
+          body: JSON.stringify({ action: completed ? 'open-completed-session' : 'open-status-session' }),
+        }).then(function (response) { return response.ok ? response.json() : null; }).then(function (body) {
+          if (body && body.ok && globalThis.vrmpet3dDesktop && globalThis.vrmpet3dDesktop.focusHost) globalThis.vrmpet3dDesktop.focusHost();
+        }).catch(function () {});
+      });
     }
 
     /**
@@ -1223,7 +1275,7 @@
       if (scene.THREE && typeof scene.projectToCanvas === 'function') {
         top = scene.projectToCanvas(new scene.THREE.Vector3(0, modelHeight, 0));
       }
-      var centreX = top ? box.left + top.x : box.left + box.width / 2;
+      var centreX = box.left + box.width / 2;
       var width = speechNode.offsetWidth || 0;
       var height = speechNode.offsetHeight || 0;
       var promptHeight = statusBox && statusBox.width > 0 ? statusBox.height : 0;
@@ -1259,7 +1311,7 @@
       // A line THIS page said takes precedence while it lasts: the pet was touched here, and the next state poll
       // must not wipe the answer before it has been read.
       var localUp = localSpeech && Date.now() < localSpeech.until ? localSpeech : null;
-      var line = localUp ? localUp.text : hostSpeech;
+      var line = hostState === 'dancing' ? null : (localUp ? localUp.text : (Date.now() < hostSpeechUntil ? hostSpeech : null));
       if (!line) {
         speechShown = null;
         speechNode.hidden = true;
@@ -1290,6 +1342,7 @@
 
     /** Put a line up for `holdSeconds`, then hand the bubble back to whatever the app is publishing. */
     function showLocalSpeech(text, holdSeconds) {
+      if (hostState === 'dancing') return;
       var hold = Number.isFinite(Number(holdSeconds)) ? Math.max(1, Number(holdSeconds)) : 4;
       localSpeech = { text: text, until: Date.now() + hold * 1000 };
       if (localSpeechTimer) clearTimeout(localSpeechTimer);
@@ -1410,8 +1463,10 @@
     function applyHostState(state, at, line, error, stale, clock) {
       var known = typeof state === 'string' && Array.isArray(core.STATES) && core.STATES.indexOf(state) !== -1;
       hostState = known ? state : null;
+      if (menu && menu.setDanceState) menu.setDanceState(hostState);
+      if (hostState === 'dancing') localSpeech = null;
       hostStateAt = Number(at) > 0 ? Number(at) : Date.now();
-      hostSpeech = typeof line === 'string' && line ? line : null;
+      receiveHostSpeech(line);
       hostStateError = typeof error === 'string' && error ? error : null;
       hostStateClock = clock === 'state'
         // The sentinel from a deployment with no turn frames: the duration is measured on this page's own state age.
@@ -1515,7 +1570,7 @@
       if (!statusNode) return;
       // The TURN clock the app sent with the state, not this page's own age for it: 用时 is a claim about DSH's turn,
       // and with no turn to report the token is dropped (DSH's own token-free 「深度求索中」). See `PetMachine.statusClock`.
-      var line = core.statusFor(preferences, hostState, hostStateAt, Date.now(), hostStateClock, language);
+      var line = core.statusFor(preferences, hostState, hostStateAt, Date.now(), hostStateClock, language, hostUnread);
       if (!line) {
         statusKey = null;
         statusShown = null;
@@ -1531,7 +1586,7 @@
        * 「用时 14分46秒」 — so the clock ticks by re-keying, exactly as the app's own label counts.
        */
       var key = line.animation + '\u0000' + (line.icon ? '1' : '0') + '\u0000'
-        + (line.state === 'working' && Number(hostUnread) > 0 ? 'dot' : '') + '\u0000' + shown;
+        + (['working', 'waiting'].indexOf(line.state) !== -1 && Number(hostUnread) > 0 ? 'dot' : '') + '\u0000' + shown;
       /**
        * The tone — 任务达成 gold and bold, 任务失败/出错 red — written every frame rather than on a re-key.
        *
@@ -1539,6 +1594,8 @@
        * about which state is gold; only the shades below are the window's own, because it draws on a
        * transparent desktop instead of DSH's theme tokens.
        */
+      if (['done', 'waiting', 'error'].indexOf(hostState) !== -1) statusNode.setAttribute('data-attention', '1');
+      else statusNode.removeAttribute('data-attention');
       if (line.tone) statusNode.setAttribute('data-tone', line.tone);
       else statusNode.removeAttribute('data-tone');
       if (line.bold) statusNode.setAttribute('data-bold', '1');
@@ -1558,7 +1615,7 @@
         if (statusIconNode) statusIconNode.hidden = line.icon !== true;
         // And the green dot, when another session's completion is still unread (DSH's own marker for it).
         if (statusDotNode) {
-          statusDotNode.hidden = !(line.state === 'working' && Number(hostUnread) > 0);
+          statusDotNode.hidden = !(['working', 'waiting'].indexOf(line.state) !== -1 && Number(hostUnread) > 0);
         }
         // A line that just appeared has no measured box yet: laying it out on this same frame keeps the
         // window from lagging a frame behind the text.
@@ -1732,7 +1789,7 @@
      * whose `state` is `dancing` into a real dance, and a preview of anything else interrupts one — which is what 「预览动作的
      * 时候，也应该打断跳舞」 asks for, with no second channel.
      */
-    function requestDance() {
+    function danceClipIds() {
       var all = motionCatalog && Array.isArray(motionCatalog.motions) ? motionCatalog.motions : [];
       var folders = motionCatalog && motionCatalog.stateFolders && Array.isArray(motionCatalog.stateFolders.dancing)
         ? motionCatalog.stateFolders.dancing
@@ -1742,19 +1799,49 @@
         return entry && typeof entry.id === 'string'
           && prefixes.some(function (prefix) { return String(entry.name || '').indexOf(prefix) === 0; });
       }).map(function (entry) { return entry.id; });
-      if (!ids.length) {
+      return ids;
+    }
+
+    // Prepare one random candidate while the menu is open, without changing state.
+    function prepareDance() {
+      var ids = danceClipIds();
+      var current = dancePreview && dancePreview.motionId;
+      var alternatives = ids.filter(function (id) { return id !== current; });
+      if (alternatives.length) ids = alternatives;
+      if (!ids.length) return null;
+      if (!preparedDance || ids.indexOf(preparedDance) === -1) preparedDance = ids[Math.floor(Math.random() * ids.length)];
+      ensureMotion(preparedDance, false);
+      return preparedDance;
+    }
+
+    function requestDance() {
+      if (['resting', 'offline', 'dancing'].indexOf(hostState) === -1) return Promise.resolve(null);
+      var picked = prepareDance();
+      if (!picked) {
         // The same sentence the app's pet shows in its badge for its own 跳支舞 row.
         showLocalSpeech(word(language, 'danceEmpty'), 3);
         return Promise.resolve(null);
       }
-      var current = dancePreview && dancePreview.motionId;
-      var alternatives = ids.filter(function (id) { return id !== current; });
-      if (alternatives.length) ids = alternatives;
-      var picked = ids[Math.floor(Math.random() * ids.length)];
+      var request = ++danceRequest;
+      preparedDance = null;
       return fetch('/vrmpet3d/preview', {
         method: 'POST',
         headers: { 'content-type': 'application/json' },
         body: JSON.stringify({ preview: { state: 'dancing', motionId: picked } }),
+      }).then(function (response) {
+        if (!response.ok) return null;
+        if (previewLink && typeof previewLink.load === 'function') previewLink.load();
+        // The app still owns the state. Only while this request is pending do we
+        // ask for its answer faster than the normal one-second background poll.
+        var deadline = Date.now() + 3000;
+        function follow() {
+          if (request !== danceRequest || !stateLink || typeof stateLink.load !== 'function') return;
+          stateLink.load().then(function () {
+            if (request === danceRequest && hostState !== 'dancing' && Date.now() < deadline) setTimeout(follow, 100);
+          });
+        }
+        follow();
+        return response;
       }).catch(function () { return null; });
     }
 
@@ -1782,6 +1869,14 @@
      * query parameter this build no longer reads.
      */
     function openSettingsWindow(page) {
+      if (page === 'game') {
+        fetch('/vrmpet3d/desktop', { method: 'POST', credentials: 'omit',
+          headers: { 'content-type': 'application/json' },
+          body: JSON.stringify({ action: 'game', modelId: resolvedModelId(preferences.modelId || loadedModel) })
+        }).then(function (response) { if (!response.ok) throw new Error('小游戏窗口打开失败'); })
+          .catch(function (error) { console.warn(error.message); });
+        return;
+      }
       var which = page === 'global' ? 'settings' : (page === 'picker' ? 'picker' : 'config');
       var url = which === 'settings'
         ? '/vrmpet3d/global'
@@ -1887,8 +1982,9 @@
        * guard against sub-pixel `setBounds` churn absorbs.
        */
       if (statusBox && statusBox.width > 0) {
-        x = Math.min(x, statusBox.left);
-        y = Math.min(y, statusBox.top);
+        var glowPadding = ['done', 'waiting', 'error'].indexOf(hostState) !== -1 ? 18 : 0;
+        x = Math.min(x, statusBox.left - glowPadding);
+        y = Math.min(y, statusBox.top - glowPadding);
       }
       /**
        * AND THE 碎碎念 BAND — because it is REPORTED, and this function's one job is to predict the window the launcher
@@ -2327,7 +2423,11 @@
        * no prompt up, the pet's box is.
        */
       var anchor = statusBox && statusBox.width > 0 && statusBox.top < box.top ? statusBox.top : box.top;
-      return { left: box.left, top: anchor - height, width: box.width, height: height };
+      // The text stays the same size when the pet shrinks. Reserve its fixed wrap width too,
+      // otherwise layoutSpeech paints a 220px plate into a window narrower than that plate.
+      var wrapPx = core.SPEECH_LIMITS && core.SPEECH_LIMITS.wrapPx ? core.SPEECH_LIMITS.wrapPx : 220;
+      var width = Math.max(box.width, wrapPx);
+      return { left: box.left - (width - box.width) / 2, top: anchor - height, width: width, height: height };
     }
 
     function reportRect() {
@@ -2355,10 +2455,10 @@
          */
         status: statusBox && statusBox.width > 0
           ? {
-            left: screenBox.x + statusBox.left,
-            top: screenBox.y + statusBox.top,
-            width: statusBox.width,
-            height: statusBox.height,
+            left: screenBox.x + statusBox.left - (['done', 'waiting', 'error'].indexOf(hostState) !== -1 ? 18 : 0),
+            top: screenBox.y + statusBox.top - (['done', 'waiting', 'error'].indexOf(hostState) !== -1 ? 18 : 0),
+            width: statusBox.width + (['done', 'waiting', 'error'].indexOf(hostState) !== -1 ? 36 : 0),
+            height: statusBox.height + (['done', 'waiting', 'error'].indexOf(hostState) !== -1 ? 36 : 0),
           }
           : null,
         /**
@@ -2414,7 +2514,7 @@
     /**
      * The gaze, from the launcher's cursor rather than from an event.
      *
-     * Aim is measured against the PET's centre (`core.pointerAim`, the same function the in-app
+     * Aim is measured against the projected eye midpoint (`core.pointerAim`, the same function the in-app
      * overlay uses), so the pet looks at the cursor wherever it is on the desktop ?including
      * outside the pet, which is the whole point of a desktop pet.
      */
@@ -2425,17 +2525,25 @@
         return;
       }
       var pixels = boxPixels();
+      var eye = typeof scene.gazeOrigin === 'function' ? scene.gazeOrigin() : null;
+      var canvasPixels = canvasBox();
+      var gazeScreenWidth = Number(globalThis.screen && globalThis.screen.width) || screenBox.width;
       var aim = core.pointerAim({
         pointerX: cursor.x - screenBox.x,
         pointerY: cursor.y - screenBox.y,
-        centreX: pixels.left + placement.width / 2,
-        centreY: pixels.top + placement.height / 2,
+        centreX: eye ? canvasPixels.left + eye.x * canvasPixels.width / scene.width : pixels.left + placement.width / 2,
+        centreY: eye ? canvasPixels.top + eye.y * canvasPixels.height / scene.height : pixels.top + placement.height / 2,
         // Both of these are SETTINGS (the 模型参数 window's 视线 section) with an "auto" default: a span of
-        // 0 means one frame width, which on the floating pet is the screen's horizontal resolution, and the
+        // 0 means half the screen width for both axes, and the
         // curve defaults to the shipped notch between "sluggish near, twitchy far" and "straight line".
-        spanX: core.resolveGazeSpan(preferences.gazeSpanX, screenBox.width),
-        spanY: core.resolveGazeSpan(preferences.gazeSpanY, core.GAZE_SPAN.y),
+        spanX: core.resolveGazeSpan(preferences.gazeSpanX, gazeScreenWidth),
+        spanY: core.resolveGazeSpan(preferences.gazeSpanY, gazeScreenWidth),
         curve: preferences.gazeCurve,
+        curveY: preferences.gazeCurveY,
+        curveRadial: preferences.gazeCurveRadial,
+        curveSpatial: preferences.gazeCurveSpatial,
+        distance: preferences.gazeDistance,
+        mode: preferences.gazeCurveMode,
       });
       lastAim = aim;
       scene.motion.setGaze(scene.gazeFromAim(aim));
@@ -2532,7 +2640,8 @@
          * `setMotionMap` refuses them, and a clip assigned to 空闲 is the right thing to show during a nap.
          */
         var drawn = 'resting';
-        if (placement.dragging && drag && drag.moved) drawn = 'held';
+        if (hostState === 'waiting') drawn = 'waiting';
+        else if (placement.dragging && drag && drag.moved) drawn = 'held';
         else if (placement.isAirborne()) drawn = 'falling';
         else if (motionStates.indexOf(hostState) !== -1) drawn = hostState;
         scene.setState(drawn);
@@ -2619,6 +2728,10 @@
     /** Set once a 跳舞 clip has been reported as finished, so one dance posts one "it is over" (see the frame loop). */
     var danceEndedReported = false;
     var dancePreview = null;
+    var preparedDance = null;
+    var danceRequest = 0;
+    var previewLink = null;
+    var stateLink = null;
 
     /** One line of text for anything throwable, the way the rest of this page reports failures. */
     function errorText(error) {
@@ -2888,9 +3001,14 @@
         // Published so a launcher-side probe can tell "the setting reached the renderer" from "the slider
         // did nothing" — the two are indistinguishable from outside otherwise.
         gaze: {
-          curve: preferences.gazeCurve,
-          spanX: core.resolveGazeSpan(preferences.gazeSpanX, screenBox.width),
-          spanY: core.resolveGazeSpan(preferences.gazeSpanY, core.GAZE_SPAN.y),
+          curve: preferences.gazeCurveMode === 'spatial' ? preferences.gazeCurveSpatial
+            : preferences.gazeCurveMode === 'radial' ? preferences.gazeCurveRadial : preferences.gazeCurve,
+          distance: preferences.gazeDistance,
+          autoSpan: core.resolveGazeSpan(0, Number(globalThis.screen && globalThis.screen.width) || screenBox.width),
+          curveY: preferences.gazeCurveY,
+          mode: preferences.gazeCurveMode,
+          spanX: core.resolveGazeSpan(preferences.gazeSpanX, Number(globalThis.screen && globalThis.screen.width) || screenBox.width),
+          spanY: core.resolveGazeSpan(preferences.gazeSpanY, Number(globalThis.screen && globalThis.screen.width) || screenBox.width),
           aim: lastAim,
           /**
            * What the RENDERER applied, which is not the same thing as the aim.
@@ -3158,7 +3276,8 @@
         core.VIEW_LIMITS.pitchMax,
       );
       scene.applyPreferences(preferences);
-      writePreferences(store, core, preferences);
+      // finishViewDrag persists once. Posting on every move echoed partial angles
+      // back into the active gesture and repeatedly laid out the transparent canvas.
     }
 
     /**
@@ -3660,6 +3779,10 @@
      * the model the renderer resolves overrides for.
      */
     function applyExternalPreferences(next, shownModel) {
+      if (viewDrag && viewDrag.moved) {
+        next.viewYaw = preferences.viewYaw;
+        next.viewPitch = preferences.viewPitch;
+      }
       // Empty rather than a built-in id: with no avatar installed there is nothing to compare against, and a
       // stand-in name here is what used to make the page describe a pet that was not on screen.
       var current = scene.currentModelId || '';
@@ -3757,7 +3880,7 @@
      * on demand before it is handed to the scene, exactly as a mapped clip is.
      */
     if (core.watchHostPreview) {
-      core.watchHostPreview({
+      previewLink = core.watchHostPreview({
         onPreview: function (preview) {
           dancePreview = preview && preview.state === 'dancing' ? preview : null;
           if (dancePreview) {
@@ -3796,7 +3919,7 @@
      * and this page draws whatever it is told. One clock for the feature, not two that can disagree.
      */
     if (core.watchHostState) {
-      core.watchHostState({
+      stateLink = core.watchHostState({
         onState: function (state, body) {
           // The unread count first: `renderStatus` reads it when it decides whether the dot is drawn, and it runs
           // inside `applyHostState`.
@@ -4031,7 +4154,7 @@
        */
       speech: function () { return speechBox; },
       setSpeech: function (line) {
-        hostSpeech = typeof line === 'string' && line ? line : null;
+        receiveHostSpeech(line);
         renderSpeech();
         layout();
         reportRect();
@@ -4039,7 +4162,11 @@
         return speechShown;
       },
       destroy: function () {
+        if (hostSpeechTimer) clearTimeout(hostSpeechTimer);
         running = false;
+        danceRequest += 1;
+        if (previewLink && typeof previewLink.stop === 'function') previewLink.stop();
+        if (stateLink && typeof stateLink.stop === 'function') stateLink.stop();
         canvas.removeEventListener('pointerdown', onPointerDown);
         canvas.removeEventListener('pointermove', onPointerMove);
         canvas.removeEventListener('pointerup', onPointerUp);

package/lib/desktop.js

@@ -526,7 +526,24 @@ export class DesktopWindow {
   }
 
   describe() {
-    return { ...this.status, running: Boolean(this.child) };
+    return { ...this.status, running: Boolean(this.child), electronAvailable: this.hasElectronRuntime() };
+  }
+
+  /** Probe the runtime sources without creating links, copying files or starting Electron. */
+  hasElectronRuntime() {
+    if (this.child) return true;
+    try {
+      const supplied = this.options.runtime || resolveStandaloneRuntime(envVar('DESKTOP_RUNTIME'));
+      const installed = this.options.installRoot || findInstallRoot(dirname(process.execPath)) || findInstallRoot(process.cwd());
+      const cached = this.options.runtimeDir || this.status.runtimeDir;
+      const candidates = [supplied, cached && resolveStandaloneRuntime(cached),
+        installed && { dir: installed, exe: findExecutable(installed) }];
+      return candidates.some((runtime) => runtime && runtime.exe && existsSync(runtime.exe)
+        && ['icudtl.dat', 'resources.pak', 'v8_context_snapshot.bin'].every((name) => existsSync(join(runtime.dir, name)))
+        && existsSync(join(runtime.dir, RUNTIME_SUPPORT.locales)));
+    } catch (_error) {
+      return false;
+    }
   }
 }
 

package/lib/global-page.html

@@ -98,10 +98,31 @@
     <div class="row"><label class="k" for="pref-look" data-i18n="lookAtPointer">看向光标</label><label class="inline"><input type="checkbox" id="pref-look"> <span data-i18n="on">开启</span></label></div>
 
     <div class="row">
-      <label class="k" for="pref-gaze-curve" data-i18n="curve">曲率</label>
-      <input type="range" id="pref-gaze-curve" min="5" max="100" step="5">
-      <span class="value" id="pref-gaze-curve-value">0.10</span>
-      <button id="pref-gaze-curve-reset" class="ghost" data-i18n="reset">复位</button>
+      <label class="k" for="pref-gaze-mode" data-i18n="gazeCurveMode">曲线模式</label>
+      <select id="pref-gaze-mode"><option value="spatial" data-i18n="gazeSpatial">空间角度</option><option value="radial" data-i18n="gazeRadial">二维距离曲线</option></select>
+    </div>
+    <div id="gaze-curves-radial" hidden>
+    <div class="row">
+      <label class="k" for="pref-gaze-curve-radial" data-i18n="gazeCurveRadial">二维距离曲率</label>
+      <input type="range" id="pref-gaze-curve-radial" min="5" max="100" step="5">
+      <span class="value" id="pref-gaze-curve-radial-value">0.10</span>
+      <button id="pref-gaze-curve-radial-reset" class="ghost" data-i18n="reset">复位</button>
+    </div>
+    </div>
+    <p class="hint" data-i18n="gazeCurveHint">数值越小，中心附近越灵敏；1 为线性。二维距离模式按满偏距离归一化后计算方向与强度，可减少远处光标上下穿过视线水平线时的俯仰跳变。各模式的参数分别保存。</p>
+    <div id="gaze-curves-spatial">
+    <div class="row">
+      <label class="k" for="pref-gaze-curve-spatial" data-i18n="gazeCurveSpatial">空间角度曲率</label>
+      <input type="range" id="pref-gaze-curve-spatial" min="5" max="100" step="5">
+      <span class="value" id="pref-gaze-curve-spatial-value">1.00</span>
+      <button id="pref-gaze-curve-spatial-reset" class="ghost" data-i18n="reset">复位</button>
+    </div>
+    <div class="row">
+      <label class="k" for="pref-gaze-distance" data-i18n="gazeDistance">注视距离</label>
+      <input type="number" id="pref-gaze-distance" min="0.1" max="5" step="0.1"> ×
+      <button id="pref-gaze-distance-reset" class="ghost" data-i18n="reset">复位</button>
+    </div>
+    <p class="hint" data-i18n="gazeSpatialHint">距离以满偏距离为单位，越大转头越缓。同高时，鼠标越偏向左右，俯仰越小；与双眼同高时俯仰为零。默认曲率 1、注视距离 0.1。</p>
     </div>
     <div class="row">
       <label class="k" for="pref-gaze-span-x" data-i18n="span">满偏距离</label>
@@ -114,6 +135,15 @@
       <input type="number" id="pref-gaze-idle" step="1" min="0" max="600"> <span data-i18n="secondsUnit">秒</span>
       <button id="pref-gaze-idle-reset" class="ghost" data-i18n="reset">复位</button>
     </div>
+    <div class="row">
+      <label class="k" for="pref-gaze-pitch-up" data-i18n="gazePitchUp">最大抬头角度</label>
+      <input type="number" id="pref-gaze-pitch-up" min="0" max="60" step="0.1"> °
+      <label class="k sub" for="pref-gaze-pitch-down" data-i18n="gazePitchDown">最大低头角度</label>
+      <input type="number" id="pref-gaze-pitch-down" min="0" max="60" step="0.1"> °
+      <button id="pref-gaze-pitch-reset" class="ghost" data-i18n="auto">自动</button>
+    </div>
+    <p class="hint" data-i18n="gazePitchHint">自动为抬头、低头各 60°。范围 0–60°；0 表示不向该方向转头。这是视线跟踪的附加角度，动作本身的头部姿势仍会保留。</p>
+    <p class="hint" data-i18n="gazeSpanHint">满偏距离填 0 为自动：水平和垂直均使用屏幕宽度的一半。</p>
     <p class="hint" id="pref-gaze-span-auto"></p>
     <p class="hint applied" id="pref-gaze-applied" data-i18n="readingWindow">（正在读取悬浮窗…）</p>
   </div>