@midscene/computer 1.9.2-beta-20260608084200.0 → 1.9.2

package/dist/es/cli.mjs

@@ -4,7 +4,7 @@ import { getDebug } from "@midscene/shared/logger";
 import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
 import { Agent } from "@midscene/core/agent";
 import { execFileSync, execSync, spawn, spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
+import { chmodSync, existsSync, statSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname, resolve as external_node_path_resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -350,9 +350,13 @@ async function getLibnut() {
     }
 }
 const debugDevice = getDebug('computer:device');
+const warnDevice = getDebug('computer:device', {
+    console: true
+});
 const debugComputerInput = getDebug('computer:input', {
     console: true
 });
+const WINDOWS_UIPI_DOC_URL = 'https://midscenejs.com/computer-getting-started#windows-clicks-have-no-effect-on-some-apps';
 function resolvePackageRoot(helperName) {
     const require = createRequire(import.meta.url);
     let pkgRoot = null;
@@ -392,6 +396,15 @@ function getPhasedScrollBinary() {
         phasedScrollBinaryPath = null;
         return null;
     }
+    try {
+        const st = statSync(binPath);
+        if ((73 & st.mode) === 0) {
+            chmodSync(binPath, 493);
+            debugDevice('phased-scroll: restored executable bit on', binPath);
+        }
+    } catch (err) {
+        debugDevice('phased-scroll: chmod self-heal failed', err);
+    }
     phasedScrollBinaryPath = binPath;
     return binPath;
 }
@@ -519,9 +532,10 @@ function runPhasedScroll(direction, pixels, steps) {
         if (0 === res.status) return true;
         if (!phasedScrollExecWarned) {
             phasedScrollExecWarned = true;
-            console.warn(`[@midscene/computer] phased-scroll helper exited with status ${res.status}; falling back to keyboard/libnut. This usually means Accessibility permission has not been granted to the host process.`);
+            const hint = null === res.status ? `signal ${res.signal ?? 'unknown'}; the binary may not be executable (npm tarball extraction can drop the +x bit) or may be blocked by quarantine. Try: chmod +x "${bin}"` : 'this usually means Accessibility permission has not been granted to the host process (System Settings → Privacy & Security → Accessibility)';
+            console.warn(`[@midscene/computer] phased-scroll helper failed (exit=${res.status}, signal=${res.signal ?? 'none'}); falling back to keyboard/libnut. ${hint}`);
         }
-        debugDevice('phased-scroll exited non-zero', res.status, res.error);
+        debugDevice('phased-scroll exited non-zero', res.status, res.signal, res.error);
         return false;
     } catch (err) {
         if (!phasedScrollExecWarned) {
@@ -642,7 +656,7 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     async healthCheck() {
         console.log('[HealthCheck] Starting health check...');
-        console.log("[HealthCheck] @midscene/computer v1.9.2-beta-20260608084200.0");
+        console.log("[HealthCheck] @midscene/computer v1.9.2");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -670,13 +684,15 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
         const deltaY = Math.abs(movedPos.y - targetY);
         if (deltaX > 5 || deltaY > 5) {
             const msg = `[HealthCheck] WARNING: Mouse control may not be working. Expected (${targetX}, ${targetY}), got (${movedPos.x}, ${movedPos.y}), delta=(${deltaX}, ${deltaY})`;
-            console.warn(msg);
-            debugDevice(msg);
-            if ('win32' === process.platform && !this.isRunningAsAdmin()) {
-                const hint = "Midscene is NOT running as Administrator. Windows blocks mouse/keyboard input to elevated (admin) applications from non-admin processes (UIPI). Please run your terminal or Node.js as Administrator and try again.";
-                console.error(`\n[HealthCheck] ${hint}\n`);
-                debugDevice(hint);
-            }
+            warnDevice(msg);
+        }
+        if ('win32' === process.platform && !this.isRunningAsAdmin()) {
+            const hint = [
+                'Heads-up: Midscene is not running as Administrator.',
+                'If clicks or key presses have no effect while the cursor still moves to the right position,',
+                `see the Windows permission troubleshooting guide: ${WINDOWS_UIPI_DOC_URL}`
+            ].join(' ');
+            warnDevice(`[HealthCheck] ${hint}`);
         }
         this.inputDriver.moveMouse(startPos.x, startPos.y);
         console.log(`[HealthCheck] Mouse restored to (${startPos.x}, ${startPos.y})`);
@@ -693,14 +709,16 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     isRunningAsAdmin() {
         if ('win32' !== process.platform) return false;
+        if (void 0 !== this.adminCheckCache) return this.adminCheckCache;
         try {
             execSync('net session', {
                 stdio: 'pipe'
             });
-            return true;
+            this.adminCheckCache = true;
         } catch  {
-            return false;
+            this.adminCheckCache = false;
         }
+        return this.adminCheckCache;
     }
     async screenshotBase64() {
         if (this.destroyed) throw new Error('ComputerDevice has been destroyed');
@@ -945,6 +963,7 @@ Original error: ${lastRawMessage}`);
             debug: (message)=>debugDevice(message)
         }));
         device_define_property(this, "useAppleScript", void 0);
+        device_define_property(this, "adminCheckCache", void 0);
         device_define_property(this, "uri", void 0);
         device_define_property(this, "inputPrimitives", {
             pointer: {
@@ -1095,24 +1114,6 @@ function createPlatformActions() {
         })
     };
 }
-function normalizeRdpHost(host) {
-    const trimmed = host.trim();
-    if (trimmed.length >= 2 && trimmed.startsWith('[') && trimmed.endsWith(']') && trimmed.includes(':')) return trimmed.slice(1, -1);
-    return trimmed;
-}
-function formatRdpHost(host) {
-    const normalizedHost = normalizeRdpHost(host);
-    return normalizedHost.includes(':') ? `[${normalizedHost}]` : normalizedHost;
-}
-function formatRdpServerAddress(host, port) {
-    return `${formatRdpHost(host)}:${port}`;
-}
-function normalizeRdpConnectionConfig(config) {
-    return {
-        ...config,
-        host: normalizeRdpHost(config.host)
-    };
-}
 const platformBinaryMap = {
     darwin: {
         directory: 'darwin',
@@ -1167,7 +1168,7 @@ class HelperProcessRDPBackendClient {
         await this.ensureHelperStarted();
         const response = await this.send({
             type: 'connect',
-            config: normalizeRdpConnectionConfig(config)
+            config
         });
         if ('connected' !== response.type) throw new Error(`Expected connected response, got ${response.type}`);
         this.connected = true;
@@ -1441,10 +1442,9 @@ const DEFAULT_SCROLL_STEP_AMOUNT = 120;
 class RDPDevice {
     describe() {
         const port = this.options.port || 3389;
-        const server = formatRdpServerAddress(this.options.host, port);
         const username = this.options.username ? ` as ${this.options.username}` : '';
         const session = this.connectionInfo?.sessionId ? ` [session ${this.connectionInfo.sessionId}]` : '';
-        return `RDP Device ${server}${username}${session}`;
+        return `RDP Device ${this.options.host}:${port}${username}${session}`;
     }
     async connect() {
         this.throwIfDestroyed();
@@ -1484,11 +1484,10 @@ class RDPDevice {
                 call: async ()=>{
                     this.assertConnected();
                     const size = await this.size();
-                    const server = this.connectionInfo?.server || formatRdpServerAddress(this.options.host, this.options.port || 3389);
                     return [
                         {
                             id: this.connectionInfo?.sessionId || this.options.host,
-                            name: `RDP ${server} (${size.width}x${size.height})`,
+                            name: `RDP ${this.connectionInfo?.server || this.options.host} (${size.width}x${size.height})`,
                             primary: true
                         }
                     ];
@@ -1686,12 +1685,11 @@ class RDPDevice {
                 }
             }
         });
-        const normalizedOptions = normalizeRdpConnectionConfig(options);
         this.options = {
             port: 3389,
             securityProtocol: 'auto',
             ignoreCertificate: false,
-            ...normalizedOptions
+            ...options
         };
         this.backend = options.backend || createDefaultRDPBackendClient();
     }
@@ -1769,11 +1767,10 @@ function adaptComputerInitArgs(extracted) {
     if (!extracted || 0 === Object.keys(extracted).length) return;
     if (extracted.host) {
         const { displayId: _d, headless: _h, ...rdpFields } = extracted;
-        const host = normalizeRdpHost(extracted.host);
         return {
             mode: 'rdp',
             ...rdpFields,
-            host
+            host: extracted.host
         };
     }
     return {
@@ -1789,15 +1786,15 @@ function shouldRetargetAgent(opts) {
 }
 function describeConnectTarget(opts) {
     if (opts?.mode === 'rdp') {
-        const target = opts.port ? formatRdpServerAddress(opts.host, opts.port) : formatRdpHost(opts.host);
+        const portSuffix = opts.port ? `:${opts.port}` : '';
         const userSuffix = opts.username ? ` as ${opts.username}` : '';
-        return ` via RDP (${target}${userSuffix})`;
+        return ` via RDP (${opts.host}${portSuffix}${userSuffix})`;
     }
     if (opts?.mode === 'local' && opts.displayId) return ` (Display: ${opts.displayId})`;
     return ' (Primary display)';
 }
 function getCliReportSessionTarget(opts) {
-    if (opts?.mode === 'rdp') return `rdp:${formatRdpHost(opts.host)}`;
+    if (opts?.mode === 'rdp') return `rdp:${opts.host}`;
     if (opts?.mode === 'local' && opts.displayId) return opts.displayId;
     return 'primary';
 }
@@ -1915,7 +1912,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
 const tools = new ComputerMidsceneTools();
 runToolsCLI(tools, 'midscene-computer', {
     stripPrefix: 'computer_',
-    version: "1.9.2-beta-20260608084200.0",
+    version: "1.9.2",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -1,5 +1,5 @@
 import { execFileSync, execSync, spawn, spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
+import { chmodSync, existsSync, statSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname, resolve as external_node_path_resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -350,9 +350,13 @@ async function getLibnut() {
     }
 }
 const debugDevice = getDebug('computer:device');
+const warnDevice = getDebug('computer:device', {
+    console: true
+});
 const debugComputerInput = getDebug('computer:input', {
     console: true
 });
+const WINDOWS_UIPI_DOC_URL = 'https://midscenejs.com/computer-getting-started#windows-clicks-have-no-effect-on-some-apps';
 function resolvePackageRoot(helperName) {
     const require = createRequire(import.meta.url);
     let pkgRoot = null;
@@ -392,6 +396,15 @@ function getPhasedScrollBinary() {
         phasedScrollBinaryPath = null;
         return null;
     }
+    try {
+        const st = statSync(binPath);
+        if ((73 & st.mode) === 0) {
+            chmodSync(binPath, 493);
+            debugDevice('phased-scroll: restored executable bit on', binPath);
+        }
+    } catch (err) {
+        debugDevice('phased-scroll: chmod self-heal failed', err);
+    }
     phasedScrollBinaryPath = binPath;
     return binPath;
 }
@@ -519,9 +532,10 @@ function runPhasedScroll(direction, pixels, steps) {
         if (0 === res.status) return true;
         if (!phasedScrollExecWarned) {
             phasedScrollExecWarned = true;
-            console.warn(`[@midscene/computer] phased-scroll helper exited with status ${res.status}; falling back to keyboard/libnut. This usually means Accessibility permission has not been granted to the host process.`);
+            const hint = null === res.status ? `signal ${res.signal ?? 'unknown'}; the binary may not be executable (npm tarball extraction can drop the +x bit) or may be blocked by quarantine. Try: chmod +x "${bin}"` : 'this usually means Accessibility permission has not been granted to the host process (System Settings → Privacy & Security → Accessibility)';
+            console.warn(`[@midscene/computer] phased-scroll helper failed (exit=${res.status}, signal=${res.signal ?? 'none'}); falling back to keyboard/libnut. ${hint}`);
         }
-        debugDevice('phased-scroll exited non-zero', res.status, res.error);
+        debugDevice('phased-scroll exited non-zero', res.status, res.signal, res.error);
         return false;
     } catch (err) {
         if (!phasedScrollExecWarned) {
@@ -642,7 +656,7 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     async healthCheck() {
         console.log('[HealthCheck] Starting health check...');
-        console.log("[HealthCheck] @midscene/computer v1.9.2-beta-20260608084200.0");
+        console.log("[HealthCheck] @midscene/computer v1.9.2");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -670,13 +684,15 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
         const deltaY = Math.abs(movedPos.y - targetY);
         if (deltaX > 5 || deltaY > 5) {
             const msg = `[HealthCheck] WARNING: Mouse control may not be working. Expected (${targetX}, ${targetY}), got (${movedPos.x}, ${movedPos.y}), delta=(${deltaX}, ${deltaY})`;
-            console.warn(msg);
-            debugDevice(msg);
-            if ('win32' === process.platform && !this.isRunningAsAdmin()) {
-                const hint = "Midscene is NOT running as Administrator. Windows blocks mouse/keyboard input to elevated (admin) applications from non-admin processes (UIPI). Please run your terminal or Node.js as Administrator and try again.";
-                console.error(`\n[HealthCheck] ${hint}\n`);
-                debugDevice(hint);
-            }
+            warnDevice(msg);
+        }
+        if ('win32' === process.platform && !this.isRunningAsAdmin()) {
+            const hint = [
+                'Heads-up: Midscene is not running as Administrator.',
+                'If clicks or key presses have no effect while the cursor still moves to the right position,',
+                `see the Windows permission troubleshooting guide: ${WINDOWS_UIPI_DOC_URL}`
+            ].join(' ');
+            warnDevice(`[HealthCheck] ${hint}`);
         }
         this.inputDriver.moveMouse(startPos.x, startPos.y);
         console.log(`[HealthCheck] Mouse restored to (${startPos.x}, ${startPos.y})`);
@@ -693,14 +709,16 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     isRunningAsAdmin() {
         if ('win32' !== process.platform) return false;
+        if (void 0 !== this.adminCheckCache) return this.adminCheckCache;
         try {
             execSync('net session', {
                 stdio: 'pipe'
             });
-            return true;
+            this.adminCheckCache = true;
         } catch  {
-            return false;
+            this.adminCheckCache = false;
         }
+        return this.adminCheckCache;
     }
     async screenshotBase64() {
         if (this.destroyed) throw new Error('ComputerDevice has been destroyed');
@@ -945,6 +963,7 @@ Original error: ${lastRawMessage}`);
             debug: (message)=>debugDevice(message)
         }));
         device_define_property(this, "useAppleScript", void 0);
+        device_define_property(this, "adminCheckCache", void 0);
         device_define_property(this, "uri", void 0);
         device_define_property(this, "inputPrimitives", {
             pointer: {
@@ -1095,24 +1114,6 @@ function createPlatformActions() {
         })
     };
 }
-function normalizeRdpHost(host) {
-    const trimmed = host.trim();
-    if (trimmed.length >= 2 && trimmed.startsWith('[') && trimmed.endsWith(']') && trimmed.includes(':')) return trimmed.slice(1, -1);
-    return trimmed;
-}
-function formatRdpHost(host) {
-    const normalizedHost = normalizeRdpHost(host);
-    return normalizedHost.includes(':') ? `[${normalizedHost}]` : normalizedHost;
-}
-function formatRdpServerAddress(host, port) {
-    return `${formatRdpHost(host)}:${port}`;
-}
-function normalizeRdpConnectionConfig(config) {
-    return {
-        ...config,
-        host: normalizeRdpHost(config.host)
-    };
-}
 const platformBinaryMap = {
     darwin: {
         directory: 'darwin',
@@ -1210,7 +1211,7 @@ class HelperProcessRDPBackendClient {
         await this.ensureHelperStarted();
         const response = await this.send({
             type: 'connect',
-            config: normalizeRdpConnectionConfig(config)
+            config
         });
         if ('connected' !== response.type) throw new Error(`Expected connected response, got ${response.type}`);
         this.connected = true;
@@ -1484,10 +1485,9 @@ const DEFAULT_SCROLL_STEP_AMOUNT = 120;
 class RDPDevice {
     describe() {
         const port = this.options.port || 3389;
-        const server = formatRdpServerAddress(this.options.host, port);
         const username = this.options.username ? ` as ${this.options.username}` : '';
         const session = this.connectionInfo?.sessionId ? ` [session ${this.connectionInfo.sessionId}]` : '';
-        return `RDP Device ${server}${username}${session}`;
+        return `RDP Device ${this.options.host}:${port}${username}${session}`;
     }
     async connect() {
         this.throwIfDestroyed();
@@ -1527,11 +1527,10 @@ class RDPDevice {
                 call: async ()=>{
                     this.assertConnected();
                     const size = await this.size();
-                    const server = this.connectionInfo?.server || formatRdpServerAddress(this.options.host, this.options.port || 3389);
                     return [
                         {
                             id: this.connectionInfo?.sessionId || this.options.host,
-                            name: `RDP ${server} (${size.width}x${size.height})`,
+                            name: `RDP ${this.connectionInfo?.server || this.options.host} (${size.width}x${size.height})`,
                             primary: true
                         }
                     ];
@@ -1729,12 +1728,11 @@ class RDPDevice {
                 }
             }
         });
-        const normalizedOptions = normalizeRdpConnectionConfig(options);
         this.options = {
             port: 3389,
             securityProtocol: 'auto',
             ignoreCertificate: false,
-            ...normalizedOptions
+            ...options
         };
         this.backend = options.backend || createDefaultRDPBackendClient();
     }
@@ -1812,11 +1810,10 @@ function adaptComputerInitArgs(extracted) {
     if (!extracted || 0 === Object.keys(extracted).length) return;
     if (extracted.host) {
         const { displayId: _d, headless: _h, ...rdpFields } = extracted;
-        const host = normalizeRdpHost(extracted.host);
         return {
             mode: 'rdp',
             ...rdpFields,
-            host
+            host: extracted.host
         };
     }
     return {
@@ -1832,15 +1829,15 @@ function shouldRetargetAgent(opts) {
 }
 function describeConnectTarget(opts) {
     if (opts?.mode === 'rdp') {
-        const target = opts.port ? formatRdpServerAddress(opts.host, opts.port) : formatRdpHost(opts.host);
+        const portSuffix = opts.port ? `:${opts.port}` : '';
         const userSuffix = opts.username ? ` as ${opts.username}` : '';
-        return ` via RDP (${target}${userSuffix})`;
+        return ` via RDP (${opts.host}${portSuffix}${userSuffix})`;
     }
     if (opts?.mode === 'local' && opts.displayId) return ` (Display: ${opts.displayId})`;
     return ' (Primary display)';
 }
 function getCliReportSessionTarget(opts) {
-    if (opts?.mode === 'rdp') return `rdp:${formatRdpHost(opts.host)}`;
+    if (opts?.mode === 'rdp') return `rdp:${opts.host}`;
     if (opts?.mode === 'local' && opts.displayId) return opts.displayId;
     return 'primary';
 }
@@ -1956,7 +1953,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
     }
 }
 function version() {
-    const currentVersion = "1.9.2-beta-20260608084200.0";
+    const currentVersion = "1.9.2";
     console.log(`@midscene/computer v${currentVersion}`);
     return currentVersion;
 }

package/dist/es/mcp-server.mjs

@@ -1,7 +1,7 @@
 import { BaseMCPServer, createMCPServerLauncher } from "@midscene/shared/mcp";
 import { Agent } from "@midscene/core/agent";
 import { execFileSync, execSync, spawn, spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
+import { chmodSync, existsSync, statSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname, resolve as external_node_path_resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -350,9 +350,13 @@ async function getLibnut() {
     }
 }
 const debugDevice = getDebug('computer:device');
+const warnDevice = getDebug('computer:device', {
+    console: true
+});
 const debugComputerInput = getDebug('computer:input', {
     console: true
 });
+const WINDOWS_UIPI_DOC_URL = 'https://midscenejs.com/computer-getting-started#windows-clicks-have-no-effect-on-some-apps';
 function resolvePackageRoot(helperName) {
     const require = createRequire(import.meta.url);
     let pkgRoot = null;
@@ -392,6 +396,15 @@ function getPhasedScrollBinary() {
         phasedScrollBinaryPath = null;
         return null;
     }
+    try {
+        const st = statSync(binPath);
+        if ((73 & st.mode) === 0) {
+            chmodSync(binPath, 493);
+            debugDevice('phased-scroll: restored executable bit on', binPath);
+        }
+    } catch (err) {
+        debugDevice('phased-scroll: chmod self-heal failed', err);
+    }
     phasedScrollBinaryPath = binPath;
     return binPath;
 }
@@ -519,9 +532,10 @@ function runPhasedScroll(direction, pixels, steps) {
         if (0 === res.status) return true;
         if (!phasedScrollExecWarned) {
             phasedScrollExecWarned = true;
-            console.warn(`[@midscene/computer] phased-scroll helper exited with status ${res.status}; falling back to keyboard/libnut. This usually means Accessibility permission has not been granted to the host process.`);
+            const hint = null === res.status ? `signal ${res.signal ?? 'unknown'}; the binary may not be executable (npm tarball extraction can drop the +x bit) or may be blocked by quarantine. Try: chmod +x "${bin}"` : 'this usually means Accessibility permission has not been granted to the host process (System Settings → Privacy & Security → Accessibility)';
+            console.warn(`[@midscene/computer] phased-scroll helper failed (exit=${res.status}, signal=${res.signal ?? 'none'}); falling back to keyboard/libnut. ${hint}`);
         }
-        debugDevice('phased-scroll exited non-zero', res.status, res.error);
+        debugDevice('phased-scroll exited non-zero', res.status, res.signal, res.error);
         return false;
     } catch (err) {
         if (!phasedScrollExecWarned) {
@@ -642,7 +656,7 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     async healthCheck() {
         console.log('[HealthCheck] Starting health check...');
-        console.log("[HealthCheck] @midscene/computer v1.9.2-beta-20260608084200.0");
+        console.log("[HealthCheck] @midscene/computer v1.9.2");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -670,13 +684,15 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
         const deltaY = Math.abs(movedPos.y - targetY);
         if (deltaX > 5 || deltaY > 5) {
             const msg = `[HealthCheck] WARNING: Mouse control may not be working. Expected (${targetX}, ${targetY}), got (${movedPos.x}, ${movedPos.y}), delta=(${deltaX}, ${deltaY})`;
-            console.warn(msg);
-            debugDevice(msg);
-            if ('win32' === process.platform && !this.isRunningAsAdmin()) {
-                const hint = "Midscene is NOT running as Administrator. Windows blocks mouse/keyboard input to elevated (admin) applications from non-admin processes (UIPI). Please run your terminal or Node.js as Administrator and try again.";
-                console.error(`\n[HealthCheck] ${hint}\n`);
-                debugDevice(hint);
-            }
+            warnDevice(msg);
+        }
+        if ('win32' === process.platform && !this.isRunningAsAdmin()) {
+            const hint = [
+                'Heads-up: Midscene is not running as Administrator.',
+                'If clicks or key presses have no effect while the cursor still moves to the right position,',
+                `see the Windows permission troubleshooting guide: ${WINDOWS_UIPI_DOC_URL}`
+            ].join(' ');
+            warnDevice(`[HealthCheck] ${hint}`);
         }
         this.inputDriver.moveMouse(startPos.x, startPos.y);
         console.log(`[HealthCheck] Mouse restored to (${startPos.x}, ${startPos.y})`);
@@ -693,14 +709,16 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     isRunningAsAdmin() {
         if ('win32' !== process.platform) return false;
+        if (void 0 !== this.adminCheckCache) return this.adminCheckCache;
         try {
             execSync('net session', {
                 stdio: 'pipe'
             });
-            return true;
+            this.adminCheckCache = true;
         } catch  {
-            return false;
+            this.adminCheckCache = false;
         }
+        return this.adminCheckCache;
     }
     async screenshotBase64() {
         if (this.destroyed) throw new Error('ComputerDevice has been destroyed');
@@ -945,6 +963,7 @@ Original error: ${lastRawMessage}`);
             debug: (message)=>debugDevice(message)
         }));
         device_define_property(this, "useAppleScript", void 0);
+        device_define_property(this, "adminCheckCache", void 0);
         device_define_property(this, "uri", void 0);
         device_define_property(this, "inputPrimitives", {
             pointer: {
@@ -1095,24 +1114,6 @@ function createPlatformActions() {
         })
     };
 }
-function normalizeRdpHost(host) {
-    const trimmed = host.trim();
-    if (trimmed.length >= 2 && trimmed.startsWith('[') && trimmed.endsWith(']') && trimmed.includes(':')) return trimmed.slice(1, -1);
-    return trimmed;
-}
-function formatRdpHost(host) {
-    const normalizedHost = normalizeRdpHost(host);
-    return normalizedHost.includes(':') ? `[${normalizedHost}]` : normalizedHost;
-}
-function formatRdpServerAddress(host, port) {
-    return `${formatRdpHost(host)}:${port}`;
-}
-function normalizeRdpConnectionConfig(config) {
-    return {
-        ...config,
-        host: normalizeRdpHost(config.host)
-    };
-}
 const platformBinaryMap = {
     darwin: {
         directory: 'darwin',
@@ -1167,7 +1168,7 @@ class HelperProcessRDPBackendClient {
         await this.ensureHelperStarted();
         const response = await this.send({
             type: 'connect',
-            config: normalizeRdpConnectionConfig(config)
+            config
         });
         if ('connected' !== response.type) throw new Error(`Expected connected response, got ${response.type}`);
         this.connected = true;
@@ -1441,10 +1442,9 @@ const DEFAULT_SCROLL_STEP_AMOUNT = 120;
 class RDPDevice {
     describe() {
         const port = this.options.port || 3389;
-        const server = formatRdpServerAddress(this.options.host, port);
         const username = this.options.username ? ` as ${this.options.username}` : '';
         const session = this.connectionInfo?.sessionId ? ` [session ${this.connectionInfo.sessionId}]` : '';
-        return `RDP Device ${server}${username}${session}`;
+        return `RDP Device ${this.options.host}:${port}${username}${session}`;
     }
     async connect() {
         this.throwIfDestroyed();
@@ -1484,11 +1484,10 @@ class RDPDevice {
                 call: async ()=>{
                     this.assertConnected();
                     const size = await this.size();
-                    const server = this.connectionInfo?.server || formatRdpServerAddress(this.options.host, this.options.port || 3389);
                     return [
                         {
                             id: this.connectionInfo?.sessionId || this.options.host,
-                            name: `RDP ${server} (${size.width}x${size.height})`,
+                            name: `RDP ${this.connectionInfo?.server || this.options.host} (${size.width}x${size.height})`,
                             primary: true
                         }
                     ];
@@ -1686,12 +1685,11 @@ class RDPDevice {
                 }
             }
         });
-        const normalizedOptions = normalizeRdpConnectionConfig(options);
         this.options = {
             port: 3389,
             securityProtocol: 'auto',
             ignoreCertificate: false,
-            ...normalizedOptions
+            ...options
         };
         this.backend = options.backend || createDefaultRDPBackendClient();
     }
@@ -1769,11 +1767,10 @@ function adaptComputerInitArgs(extracted) {
     if (!extracted || 0 === Object.keys(extracted).length) return;
     if (extracted.host) {
         const { displayId: _d, headless: _h, ...rdpFields } = extracted;
-        const host = normalizeRdpHost(extracted.host);
         return {
             mode: 'rdp',
             ...rdpFields,
-            host
+            host: extracted.host
         };
     }
     return {
@@ -1789,15 +1786,15 @@ function shouldRetargetAgent(opts) {
 }
 function describeConnectTarget(opts) {
     if (opts?.mode === 'rdp') {
-        const target = opts.port ? formatRdpServerAddress(opts.host, opts.port) : formatRdpHost(opts.host);
+        const portSuffix = opts.port ? `:${opts.port}` : '';
         const userSuffix = opts.username ? ` as ${opts.username}` : '';
-        return ` via RDP (${target}${userSuffix})`;
+        return ` via RDP (${opts.host}${portSuffix}${userSuffix})`;
     }
     if (opts?.mode === 'local' && opts.displayId) return ` (Display: ${opts.displayId})`;
     return ' (Primary display)';
 }
 function getCliReportSessionTarget(opts) {
-    if (opts?.mode === 'rdp') return `rdp:${formatRdpHost(opts.host)}`;
+    if (opts?.mode === 'rdp') return `rdp:${opts.host}`;
     if (opts?.mode === 'local' && opts.displayId) return opts.displayId;
     return 'primary';
 }
@@ -1919,7 +1916,7 @@ class ComputerMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/computer-mcp',
-            version: "1.9.2-beta-20260608084200.0",
+            version: "1.9.2",
             description: 'Control the computer desktop using natural language commands'
         }, toolsManager);
     }