dsh-plugin-vrmpet3d 0.1.2 → 0.1.3

package/desktop/game-visibility.cjs

@@ -0,0 +1,50 @@
+// A focused game temporarily hides only a pet window that was visible beforehand.
+const http = require('node:http');
+const https = require('node:https');
+// A transparent window can paint and report pixel hits after showInactive while
+// Chromium still uses the pre-hide input surface. A real bounds transition (the
+// same transition wheel zoom causes) rebuilds that surface without changing the pet.
+function refreshInputRegion(win, schedule = setTimeout) {
+  if (win.isDestroyed() || !win.isVisible()) return;
+  const original = win.getBounds();
+  const temporary = { ...original, width: original.width + 1 };
+  win.setBounds(temporary, false);
+  schedule(() => {
+    if (win.isDestroyed()) return;
+    const current = win.getBounds();
+    // A drag or another layout update owns its new bounds; never move it back.
+    if (['x', 'y', 'width', 'height'].every(key => current[key] === temporary[key])) win.setBounds(original, false);
+  }, 32);
+}
+function createVisibilityController(win, hooks = {}) {
+  let hiddenByGame = false;
+  return function apply(active) {
+    if (win.isDestroyed()) return;
+    if (active && !hiddenByGame && win.isVisible()) { hiddenByGame = true; hooks.suspend?.(); win.hide(); }
+    else if (!active && hiddenByGame) { hiddenByGame = false; win.showInactive(); hooks.resume?.(); }
+  };
+}
+function watchGameVisibility(win, pageURL, interval = 500, hooks = {}) {
+  const apply = createVisibilityController(win, hooks);
+  const url = new URL('/vrmpet3d/desktop', pageURL);
+  const transport = url.protocol === 'https:' ? https : http;
+  let request = null, stopped = false;
+  function poll() {
+    if (stopped || request || win.isDestroyed()) return;
+    request = transport.get(url, { timeout: 1500 }, response => {
+      let body = '', failed = response.statusCode !== 200;
+      response.on('data', chunk => { body += chunk; if (body.length > 16384) { failed = true; response.destroy(); } });
+      response.on('end', () => {
+        if (stopped) return;
+        try { apply(!failed && JSON.parse(body).gameFocused === true); } catch (_) { apply(false); }
+      });
+      response.on('error', () => { if (!stopped) apply(false); });
+    });
+    request.on('timeout', () => request.destroy());
+    request.on('error', () => { if (!stopped) apply(false); });
+    request.on('close', () => { request = null; });
+  }
+  const timer = setInterval(poll, interval); timer.unref(); poll();
+  return function stop() { stopped = true; clearInterval(timer); if (request) request.destroy(); apply(false); };
+}
+module.exports = { createVisibilityController, watchGameVisibility, refreshInputRegion };

package/desktop/main.js

@@ -11,6 +11,7 @@
 const { app, BrowserWindow, dialog, ipcMain, screen, shell } = require('electron');
 const fs = require('node:fs');
 const path = require('node:path');
+const { watchGameVisibility, refreshInputRegion } = require('./game-visibility.cjs');
 
 /** Cursor polling rate. The gaze is smoothed by the idle, so this is about drag latency. */
 const CURSOR_HZ = 60;
@@ -251,6 +252,19 @@ function writeSelfTest(code) {
   app.exit(code);
 }
 
+// A second game launch focuses the existing game instead of opening another process on its profile.
+const gameMode = options.config === true && new URL(options.url).pathname === '/vrmpet3d/game';
+let activeGameWindow = null;
+function focusGameWindow() {
+  if (!activeGameWindow || activeGameWindow.isDestroyed()) return;
+  if (activeGameWindow.isMinimized()) activeGameWindow.restore();
+  activeGameWindow.show(); activeGameWindow.focus();
+}
+if (gameMode) {
+  if (!app.requestSingleInstanceLock()) app.exit(0);
+  else app.on('second-instance', focusGameWindow);
+}
+
 /** The pet's rectangle on screen, as last reported by the page; null until it mounts. */
 let petRect = null;
 /** The right-click menu's rectangle in screen coordinates, while it is open. DOM, so the window holds it. */
@@ -269,6 +283,7 @@ let speechRect = null;
 let lastCursor = null;
 /** Whether the cursor is on a pixel the page actually painted — the page's own verdict. */
 let overPet = false;
+const inputDiagnostics = { through: true, recoveries: 0, regions: 0, events: {}, lastEvent: null };
 let interacting = false;
 /** True while the self-test drives the page with synthetic cursors. */
 let probing = false;
@@ -300,6 +315,7 @@ app.whenReady().then(async () => {
     // settings form. Read from the argument rather than from a separate entry point, because the rest of
     // the launcher (the borrowed runtime, the watchdog, the parent-pid handshake) is identical for both.
     const isConfig = options.config === true;
+    const isGame = isConfig && new URL(options.url).pathname === '/vrmpet3d/game';
 
     /**
      * Arm the self-test's own deadline before anything can hang.
@@ -329,7 +345,8 @@ app.whenReady().then(async () => {
       height: 860,
       minWidth: 560,
       minHeight: 420,
-      title: 'vrmpet3d - model settings',
+      title: isGame ? '吃白饭 · 桌宠弹球' : 'vrmpet3d - model settings',
+      fullscreen: isGame,
       backgroundColor: '#16171c',
       show: true,
       webPreferences: {
@@ -428,7 +445,7 @@ app.whenReady().then(async () => {
 
     const setClickThrough = (through) => {
       if (win.isDestroyed() || mouseThrough === through) return;
-      mouseThrough = through;
+      mouseThrough = through; inputDiagnostics.through = through;
       if (through) win.setIgnoreMouseEvents(true, { forward: true });
       else win.setIgnoreMouseEvents(false);
       keepOnTop();
@@ -651,6 +668,12 @@ app.whenReady().then(async () => {
         return null;
       }
     });
+    ipcMain.on('vrmpet3d:input-event', (event, value) => {
+      if (event.sender !== win.webContents || !value || !['pointerdown','pointerup','mousedown','mouseup','wheel'].includes(value.type)) return;
+      inputDiagnostics.events[value.type] = (inputDiagnostics.events[value.type] || 0) + 1;
+      inputDiagnostics.lastEvent = {type:value.type,button:Number.isInteger(value.button) ? value.button : null,
+        target:typeof value.target === 'string' ? value.target.slice(0,32) : '',trusted:value.trusted === true};
+    });
     ipcMain.on('vrmpet3d:rect', (_event, rect) => {
       if (!rect || typeof rect !== 'object') return;
       petRect = {
@@ -795,6 +818,31 @@ app.whenReady().then(async () => {
     });
     ipcMain.on('vrmpet3d:quit', () => app.quit());
     win.on('closed', () => app.quit());
+    if (!isConfig) {
+      const resetPetInput = () => {
+        interacting = false; overPet = false; zoomHoldUntil = 0; orbitFocus = false;
+        win.setFocusable(false); releaseOrbitLock();
+        // Recreate Electron's native forwarding hook; repeating `true` alone can reuse the stale hook after hide/show.
+        win.setIgnoreMouseEvents(false);
+        mouseThrough = false;
+        setClickThrough(true);
+        inputDiagnostics.recoveries++;
+        sendCursor(screen.getCursorScreenPoint());
+      };
+      const stopGameVisibility = watchGameVisibility(win, options.url, 500, {
+        suspend: resetPetInput,
+        resume: () => {
+          resetPetInput();
+          refreshInputRegion(win); inputDiagnostics.regions++;
+        },
+      });
+      win.once('closed', stopGameVisibility);
+    }
+
+    if (isGame) {
+      activeGameWindow = win;
+      win.once('closed', () => { activeGameWindow = null; });
+    }
 
     // The cursor is read from the OS rather than from page events: a click-through window
     // receives no pointer events at all outside the pet, so events cannot drive the gaze,
@@ -1624,6 +1672,14 @@ function announce(info) {
      * from the page state, so a page that never published reports `null` rather than a stale number.
      */
     frames: lastPageState && typeof lastPageState.frames === 'number' ? lastPageState.frames : null,
+    input: {
+      through: inputDiagnostics.through, recoveries: inputDiagnostics.recoveries,
+      regions: inputDiagnostics.regions, events: inputDiagnostics.events, lastEvent: inputDiagnostics.lastEvent,
+      cursor: lastCursor, pageCursor: lastPageState && lastPageState.cursor || null,
+      lastHit: lastPageState && lastPageState.lastHit || null,
+      hitReads: lastPageState && lastPageState.hitReads || 0,
+      hit: lastPageState && lastPageState.hit || null,
+    },
     over: overPet,
     interacting: interacting,
     rect: petRect,

package/desktop/preload.js

@@ -7,6 +7,16 @@
 // process, or any other window.
 const { contextBridge, ipcRenderer } = require('electron');
 
+// Read-only counters distinguish pixel hits from actual button delivery after hide/show.
+for (const type of ['pointerdown', 'pointerup', 'mousedown', 'mouseup', 'wheel']) {
+  document.addEventListener(type, event => {
+    ipcRenderer.send('vrmpet3d:input-event', {
+      type, button: event.button, trusted: event.isTrusted === true,
+      target: event.target && event.target.tagName || '',
+    });
+  }, true);
+}
+
 contextBridge.exposeInMainWorld('vrmpet3dDesktop', {
   /**
    * Ask for the launch configuration: which model to show, where the asset route lives.

package/lib/client.js

@@ -1667,6 +1667,19 @@
    */
   VrmPet3DWidget.prototype.openSettingsWindow = function (page) {
     var self = this;
+    if (page === 'game') {
+      var gameUrl = '/vrmpet3d/game?model=' + encodeURIComponent(self.currentModelId() || '');
+      if ((!globalThis.dshDesktop && !/Electron\//i.test(globalThis.navigator.userAgent)) || !self.canUseIndependentPet()) {
+        globalThis.open(gameUrl, '_blank', 'noopener'); return;
+      }
+      fetch('/vrmpet3d/desktop', { method: 'POST', credentials: 'omit',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ action: 'game', modelId: self.currentModelId() })
+      }).then(function (response) {
+        if (!response.ok) self.showStatus('小游戏窗口打开失败，请重试。');
+      }).catch(function () { self.showStatus('小游戏窗口打开失败，请重试。'); });
+      return;
+    }
     /**
      * Which window, and the host action that opens it.
      *
@@ -1875,6 +1888,7 @@
     // 切换模型: the model picker's own page. It decides WHICH model every other page is about, so it is a
     // window of its own rather than a row inside 当前模型参数设置 (see ITEMS in lib/menu.js).
     if (id === 'switchModel') { this.openSettingsWindow('picker'); return; }
+    if (id === 'miniGame') { this.openSettingsWindow('game'); return; }
     /**
      * 重载模型 — re-read the model file and rebuild the scene (operator, 2026-10-14: 「给内置和外置宠物的右键菜单新增“重载模型”
      * 的选项，用来刷新模型」).
@@ -5151,8 +5165,9 @@
                     var entries = ctx.slots.entries('sidebar.workspaces');
                     for (var i = 0; i < entries.length; i += 1) {
                       var injected = typeof entries[i].inject === 'function' ? entries[i].inject() : entries[i].inject;
-                      if (injected && typeof injected.open === 'function') { injected.open(id); return; }
+                      if (injected && typeof injected.open === 'function') { injected.open(id); return true; }
                     }
+                    return false;
                   },
                   onScopeChange: function (scope) { if (changeScope.current) changeScope.current(scope); },
                   /**
@@ -5171,6 +5186,21 @@
                   }
                 });
                 widgetRef.current = widget;
+                // A browser game opens this explicit query contract in a NEW DSH tab.
+                // Retry until the workspace slot is ready; consume the query only on success.
+                var gameTarget = new URL(globalThis.location.href).searchParams.get('vrmpet3d-session');
+                if (gameTarget && gameTarget.length <= 64) {
+                  var gameAttempts = 0;
+                  var gameNavigation = setInterval(function () {
+                    if (disposed || ++gameAttempts > 60) { clearInterval(gameNavigation); return; }
+                    if (widget.openSession(gameTarget)) {
+                      clearInterval(gameNavigation);
+                      var cleanUrl = new URL(globalThis.location.href);
+                      cleanUrl.searchParams.delete('vrmpet3d-session');
+                      globalThis.history.replaceState(globalThis.history.state, '', cleanUrl.href);
+                    }
+                  }, 250);
+                }
                 widgets.add(widget);
                 setStatus('ready');
               } catch (error) {

package/lib/client.menu.js

@@ -68,6 +68,7 @@
      * whose effect ends by itself (the clip finishes, or the user double-clicks the pet, or work starts).
      */
     'dance',
+    'miniGame',
     /**
      * 重载模型 — refresh the model on screen without touching anything else (operator, 2026-10-14: 「给内置和外置宠物的右键菜单
      * 新增“重载模型”的选项，用来刷新模型」).
@@ -110,6 +111,7 @@
       resetSize: 'Reset size',
       globalSettings: 'General settings',
       switchModel: 'Switch model',
+      miniGame: 'Pet breakout',
     reloadModel: 'Reload model',
     dance: 'Dance for me',
       modelSettings: "This model's parameters",
@@ -138,6 +140,7 @@
       resetSize: '重置大小',
       globalSettings: '通用设置',
       switchModel: '切换模型',
+      miniGame: '小游戏 · 吃白饭',
     reloadModel: '重载模型',
     dance: '跳支舞',
       modelSettings: '当前模型参数设置',

package/lib/desktop-page.js

@@ -692,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
@@ -1868,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'

package/lib/index.js

@@ -25,6 +25,7 @@ import { fileURLToPath } from 'node:url';
 import { SettingsStore, settingsFileFor } from './settings.js';
 // `VRMPET3D_*` with the pre-rename `PET3D_*` names as a fallback — see the module's own note.
 import { envVar } from './env.js';
+import { createLevelStore } from './mini-game-level-store.js';
 
 // `lib/core.js` is a classic script that publishes itself on the global — that is
 // how the client half reads it too, so importing it here is what keeps ONE list
@@ -208,6 +209,7 @@ export const ROUTES = {
    * guide's 偏好模型 step — one page plus one shared component, instead of two hand-kept copies of a grid.
    */
   picker: '/vrmpet3d/picker',
+  game: '/vrmpet3d/game',
   /**
    * The pet's live state, reported by the in-app pet and read by the floating window.
    *
@@ -267,6 +269,7 @@ export const WINDOW_SOURCES = new Set([
   // grid of thumbnails is exactly how the two would drift (and the operator asked for them to be identical).
   'model-picker.js',
   'picker-page.js',
+  'mini-game-core.js', 'mini-game-page.js', 'mini-game.css',
   // The stylesheet the TWO settings pages share. One file rather than a copy in each page's `<head>`: the two
   // render the same rows, tables and status lines, and a copy is how the two drift apart.
   'pages.css',
@@ -2278,6 +2281,8 @@ function sendBuffer(req, res, bytes, name) {
  * routes, the service and the stream listeners in one step.
  */
 export function apply(ctx, config = {}) {
+  const gameLevelStore = createLevelStore();
+  void gameLevelStore.start();
   const agents = ctx.get('agents');
   const hub = new VrmPet3DBoundaryHub({ agents });
 
@@ -3877,6 +3882,11 @@ export function apply(ctx, config = {}) {
     let html = null;
     try {
       html = readFileSync(join(PLUGIN_ROOT, 'lib', file));
+      if (file === 'mini-game.html') {
+        const data = JSON.stringify(gameLevelStore.snapshot()).replaceAll('<', '\\u003c');
+        html = Buffer.from(html.toString('utf8').replace('<script id="game-level-data" type="application/json">null</script>',
+          '<script id="game-level-data" type="application/json">' + data + '</script>'));
+      }
     } catch (error) {
       sendStatus(res, 500, `cannot read the ${label}: ${error.message}`);
       return;
@@ -3910,6 +3920,7 @@ export function apply(ctx, config = {}) {
    * mounts is the only version of that which cannot drift.
    */
   const pickerPageHandler = settingsPageHandler('picker-page.html', 'model-picker page');
+  const gamePageHandler = settingsPageHandler('mini-game.html', 'mini-game page');
 
   /**
    * The page's own sources, by NAME — the module-level `WINDOW_SOURCES`, so the verification suite reads the
@@ -4009,6 +4020,12 @@ export function apply(ctx, config = {}) {
    * way: numbers and short CSS lengths only, sanitised here the way every other report is.
    */
   let desktopPageMetrics = null;
+  const gameFocusLeases = new Map();
+  function gameHasFocus() {
+    const now = Date.now();
+    for (const [client, deadline] of gameFocusLeases) if (deadline <= now) gameFocusLeases.delete(client);
+    return gameFocusLeases.size > 0;
+  }
   function cleanPageMetrics(raw) {
     if (!raw || typeof raw !== 'object') return null;
     const out = {};
@@ -4043,6 +4060,7 @@ export function apply(ctx, config = {}) {
     if (req.method === 'GET' || req.method === 'HEAD') {
       sendJson(req, res, {
         ...desktopWindow.describe(),
+        gameFocused: gameHasFocus(),
         /**
          * The WINDOW's OWN bubble measurements, posted by its page (action metrics below).
          *
@@ -4062,6 +4080,35 @@ export function apply(ctx, config = {}) {
     }
     readJsonBody(req, res, 16 * 1024, (body) => {
       const action = typeof body?.action === 'string' ? body.action : '';
+      if (action === 'game-focus') {
+        const clientId = body?.clientId;
+        if (typeof clientId !== 'string' || !/^[a-zA-Z0-9-]{8,96}$/.test(clientId) || typeof body.active !== 'boolean') {
+          sendStatus(res, 400, 'invalid game focus report'); return;
+        }
+        gameHasFocus();
+        if (body.active && (gameFocusLeases.has(clientId) || gameFocusLeases.size < 64)) gameFocusLeases.set(clientId, Date.now() + 3500);
+        else if (!body.active) gameFocusLeases.delete(clientId);
+        sendJson(req, res, { ok: true, gameFocused: gameHasFocus() }); return;
+      }
+      if (action === 'game-session') {
+        const sessionId = typeof body?.sessionId === 'string' ? body.sessionId : '';
+        const allowed = petStateStale ? [] : [petStateWhy?.statusSessionId,
+          ...(petStateWhy?.waitingSessionIds || []), ...(petStateWhy?.completedSessionIds || [])];
+        if (!sessionId || !allowed.includes(sessionId)) { sendJson(req, res, { ok: false }); return; }
+        navigation = { seq: navigation.seq + 1, sessionId };
+        sendJson(req, res, { ok: true });
+        return;
+      }
+      if (action === 'game') {
+        const gameUrl = pageUrlFor(req, ROUTES.game);
+        if (!gameUrl) { sendStatus(res, 400, 'no host header'); return; }
+        const url = new URL(gameUrl);
+        if (typeof body.modelId === 'string') url.searchParams.set('model', body.modelId.slice(0, 256));
+        const opened = desktopWindow.openConfig({ url: url.href });
+        if (!opened.ok) { sendStatus(res, 500, opened.error || 'game could not be opened'); return; }
+        sendJson(req, res, { state: 'game-open', pid: opened.pid || null, url: url.href });
+        return;
+      }
       if (action === 'open-status-session' || action === 'open-completed-session') {
         let sessionId = petStateStale ? null : action === 'open-completed-session'
           ? (['working', 'waiting'].includes(petStateValue) && petStateUnread > 0 ? petStateWhy?.completedSessionId : null)
@@ -4256,6 +4303,7 @@ export function apply(ctx, config = {}) {
       disposers.push(webServer.register({ kind: 'exact', path: ROUTES.config, handler: configPageHandler }));
       disposers.push(webServer.register({ kind: 'exact', path: ROUTES.global, handler: globalPageHandler }));
       disposers.push(webServer.register({ kind: 'exact', path: ROUTES.picker, handler: pickerPageHandler }));
+      disposers.push(webServer.register({ kind: 'exact', path: ROUTES.game, handler: gamePageHandler }));
       disposers.push(webServer.register({ kind: 'exact', path: ROUTES.settings, handler: settingsHandler }));
       disposers.push(webServer.register({ kind: 'exact', path: ROUTES.preview, handler: previewHandler }));
       disposers.push(webServer.register({ kind: 'exact', path: ROUTES.setup, handler: setupPageHandler }));

package/lib/menu.js

@@ -60,6 +60,7 @@
      * whose effect ends by itself (the clip finishes, or the user double-clicks the pet, or work starts).
      */
     'dance',
+    'miniGame',
     /**
      * 重载模型 — refresh the model on screen without touching anything else (operator, 2026-10-14: 「给内置和外置宠物的右键菜单
      * 新增“重载模型”的选项，用来刷新模型」).
@@ -102,6 +103,7 @@
       resetSize: 'Reset size',
       globalSettings: 'General settings',
       switchModel: 'Switch model',
+      miniGame: 'Pet breakout',
     reloadModel: 'Reload model',
     dance: 'Dance for me',
       modelSettings: "This model's parameters",
@@ -130,6 +132,7 @@
       resetSize: '重置大小',
       globalSettings: '通用设置',
       switchModel: '切换模型',
+      miniGame: '小游戏 · 吃白饭',
     reloadModel: '重载模型',
     dance: '跳支舞',
       modelSettings: '当前模型参数设置',