@midscene/computer 1.9.6 → 1.9.7

package/dist/es/cli.mjs

@@ -40,6 +40,33 @@ class ComputerInputDriver {
     moveMouse(x, y) {
         this.getLibnutOrThrow('moveMouse').moveMouse(x, y);
     }
+    focusActiveWindow() {
+        const lib = this.getLibnutOrThrow('focusActiveWindow');
+        if ('function' != typeof lib.getActiveWindow || 'function' != typeof lib.focusWindow) return false;
+        try {
+            const handle = lib.getActiveWindow();
+            if (!handle) return false;
+            lib.focusWindow(handle);
+            return true;
+        } catch (error) {
+            this.options.debug(`focusActiveWindow failed: ${error}`);
+            return false;
+        }
+    }
+    getActiveWindowRect() {
+        const lib = this.getLibnutOrThrow('getActiveWindowRect');
+        if ('function' != typeof lib.getActiveWindow || 'function' != typeof lib.getWindowRect) return null;
+        try {
+            const handle = lib.getActiveWindow();
+            if (!handle) return null;
+            const rect = lib.getWindowRect(handle);
+            if (!Number.isFinite(rect.x) || !Number.isFinite(rect.y) || !Number.isFinite(rect.width) || !Number.isFinite(rect.height) || rect.width <= 0 || rect.height <= 0) return null;
+            return rect;
+        } catch (error) {
+            this.options.debug(`getActiveWindowRect failed: ${error}`);
+            return null;
+        }
+    }
     mouseClick(button, double) {
         const lib = this.getLibnutOrThrow('mouseClick');
         if (void 0 !== double) lib.mouseClick(button, double);
@@ -52,6 +79,13 @@ class ComputerInputDriver {
     scrollMouse(x, y) {
         this.getLibnutOrThrow('scrollMouse').scrollMouse(x, y);
     }
+    async emitScrollDetents(dx, dy, detents, delayMs) {
+        this.assertActive('emitScrollDetents');
+        for(let i = 0; i < detents; i++){
+            this.scrollMouse(dx, dy);
+            if (i < detents - 1) await this.delay(delayMs);
+        }
+    }
     keyTap(key, modifiers) {
         const lib = this.getLibnutOrThrow('keyTap');
         if (void 0 !== modifiers) lib.keyTap(key, modifiers);
@@ -230,13 +264,17 @@ const CLICK_HOLD_DURATION = 100;
 const CLICK_FOCUS_SETTLE_DELAY = 120;
 const INPUT_FOCUS_DELAY = 300;
 const INPUT_CLEAR_DELAY = 150;
-const SCROLL_REPEAT_COUNT = 10;
 const SCROLL_STEP_DELAY = 100;
 const SCROLL_COMPLETE_DELAY = 500;
 const EDGE_SCROLL_TOTAL_PX = 50000;
 const EDGE_SCROLL_STEPS = 400;
 const PHASED_PIXELS_PER_STEP = 30;
 const PHASED_MIN_STEPS = 10;
+const LIBNUT_FALLBACK_PIXELS_PER_DETENT = 100;
+const LIBNUT_FALLBACK_TICK_DELAY_MS = 30;
+const LIBNUT_FALLBACK_MAX_DETENTS = 200;
+const LIBNUT_FALLBACK_DETENT_AMOUNT = 'win32' === process.platform ? 120 : 1;
+const LIBNUT_FALLBACK_EDGE_DETENTS = Math.min(LIBNUT_FALLBACK_MAX_DETENTS, Math.max(1, Math.ceil(EDGE_SCROLL_TOTAL_PX / LIBNUT_FALLBACK_PIXELS_PER_DETENT)));
 const DEFAULT_SCROLL_VIEWPORT_RATIO = 0.7;
 const EDGE_SCROLL_SPEC = {
     scrollToTop: {
@@ -244,7 +282,7 @@ const EDGE_SCROLL_SPEC = {
         key: 'home',
         libnut: [
             0,
-            10
+            1
         ]
     },
     scrollToBottom: {
@@ -252,14 +290,14 @@ const EDGE_SCROLL_SPEC = {
         key: 'end',
         libnut: [
             0,
-            -10
+            -1
         ]
     },
     scrollToLeft: {
         direction: 'left',
         key: 'home',
         libnut: [
-            -10,
+            -1,
             0
         ]
     },
@@ -267,7 +305,7 @@ const EDGE_SCROLL_SPEC = {
         direction: 'right',
         key: 'end',
         libnut: [
-            10,
+            1,
             0
         ]
     }
@@ -656,7 +694,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.6");
+        console.log("[HealthCheck] @midscene/computer v1.9.7");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -834,7 +872,20 @@ Original error: ${lastRawMessage}`);
         });
         this.inputDriver.sendKey(key, modifiers);
     }
-    async performScroll(param) {
+    resolveUntargetedScrollPoint(screenSize) {
+        if ('win32' === process.platform) {
+            const activeWindowRect = this.inputDriver.getActiveWindowRect();
+            if (activeWindowRect) return {
+                x: activeWindowRect.x + activeWindowRect.width / 2,
+                y: activeWindowRect.y + activeWindowRect.height / 2
+            };
+        }
+        return this.toGlobalPoint({
+            x: screenSize.width / 2,
+            y: screenSize.height / 2
+        });
+    }
+    async moveMouseToScrollTarget(param) {
         if (param.locate) {
             const element = param.locate;
             const [x, y] = element.center;
@@ -843,7 +894,17 @@ Original error: ${lastRawMessage}`);
                 y
             });
             this.inputDriver.moveMouse(Math.round(point.x), Math.round(point.y));
+            return;
         }
+        const screenSize = await this.size();
+        if ('win32' === process.platform && this.inputDriver.focusActiveWindow()) await this.inputDriver.delay(CLICK_FOCUS_SETTLE_DELAY);
+        const point = this.resolveUntargetedScrollPoint(screenSize);
+        this.inputDriver.moveMouse(Math.round(point.x), Math.round(point.y));
+        await this.inputDriver.delay(MOUSE_MOVE_EFFECT_WAIT);
+        return screenSize;
+    }
+    async performScroll(param) {
+        let screenSize = await this.moveMouseToScrollTarget(param);
         const scrollType = param?.scrollType;
         const edgeSpec = scrollType && scrollType in EDGE_SCROLL_SPEC ? EDGE_SCROLL_SPEC[scrollType] : null;
         if (edgeSpec) {
@@ -853,11 +914,8 @@ Original error: ${lastRawMessage}`);
                 await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
                 return;
             }
-            const [dx, dy] = edgeSpec.libnut;
-            for(let i = 0; i < SCROLL_REPEAT_COUNT; i++){
-                this.inputDriver.scrollMouse(dx, dy);
-                await this.inputDriver.delay(SCROLL_STEP_DELAY);
-            }
+            const [ux, uy] = edgeSpec.libnut;
+            await this.inputDriver.emitScrollDetents(ux * LIBNUT_FALLBACK_DETENT_AMOUNT, uy * LIBNUT_FALLBACK_DETENT_AMOUNT, LIBNUT_FALLBACK_EDGE_DETENTS, LIBNUT_FALLBACK_TICK_DELAY_MS);
             return;
         }
         if ('singleAction' === scrollType || !scrollType) {
@@ -865,9 +923,8 @@ Original error: ${lastRawMessage}`);
             const isKnownDirection = 'up' === direction || 'down' === direction || 'left' === direction || 'right' === direction;
             const isHorizontal = 'left' === direction || 'right' === direction;
             let distance = param?.distance ?? void 0;
-            let screenSize;
             if (!distance) {
-                screenSize = await this.size();
+                screenSize ??= await this.size();
                 const base = isHorizontal ? screenSize.width : screenSize.height;
                 distance = Math.max(1, Math.round(base * DEFAULT_SCROLL_VIEWPORT_RATIO));
             }
@@ -886,30 +943,30 @@ Original error: ${lastRawMessage}`);
                 await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
                 return;
             }
-            const ticks = Math.ceil(distance / 100);
-            const directionMap = {
+            const detents = Math.min(LIBNUT_FALLBACK_MAX_DETENTS, Math.max(1, Math.ceil(distance / LIBNUT_FALLBACK_PIXELS_PER_DETENT)));
+            const directionUnit = {
                 up: [
                     0,
-                    ticks
+                    1
                 ],
                 down: [
                     0,
-                    -ticks
+                    -1
                 ],
                 left: [
-                    -ticks,
+                    -1,
                     0
                 ],
                 right: [
-                    ticks,
+                    1,
                     0
                 ]
             };
-            const [dx, dy] = directionMap[direction] || [
+            const [ux, uy] = directionUnit[direction] || [
                 0,
-                -ticks
+                -1
             ];
-            this.inputDriver.scrollMouse(dx, dy);
+            await this.inputDriver.emitScrollDetents(ux * LIBNUT_FALLBACK_DETENT_AMOUNT, uy * LIBNUT_FALLBACK_DETENT_AMOUNT, detents, LIBNUT_FALLBACK_TICK_DELAY_MS);
             await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
             return;
         }
@@ -1998,7 +2055,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
 const tools = new ComputerMidsceneTools();
 runToolsCLI(tools, 'midscene-computer', {
     stripPrefix: 'computer_',
-    version: "1.9.6",
+    version: "1.9.7",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -40,6 +40,33 @@ class ComputerInputDriver {
     moveMouse(x, y) {
         this.getLibnutOrThrow('moveMouse').moveMouse(x, y);
     }
+    focusActiveWindow() {
+        const lib = this.getLibnutOrThrow('focusActiveWindow');
+        if ('function' != typeof lib.getActiveWindow || 'function' != typeof lib.focusWindow) return false;
+        try {
+            const handle = lib.getActiveWindow();
+            if (!handle) return false;
+            lib.focusWindow(handle);
+            return true;
+        } catch (error) {
+            this.options.debug(`focusActiveWindow failed: ${error}`);
+            return false;
+        }
+    }
+    getActiveWindowRect() {
+        const lib = this.getLibnutOrThrow('getActiveWindowRect');
+        if ('function' != typeof lib.getActiveWindow || 'function' != typeof lib.getWindowRect) return null;
+        try {
+            const handle = lib.getActiveWindow();
+            if (!handle) return null;
+            const rect = lib.getWindowRect(handle);
+            if (!Number.isFinite(rect.x) || !Number.isFinite(rect.y) || !Number.isFinite(rect.width) || !Number.isFinite(rect.height) || rect.width <= 0 || rect.height <= 0) return null;
+            return rect;
+        } catch (error) {
+            this.options.debug(`getActiveWindowRect failed: ${error}`);
+            return null;
+        }
+    }
     mouseClick(button, double) {
         const lib = this.getLibnutOrThrow('mouseClick');
         if (void 0 !== double) lib.mouseClick(button, double);
@@ -52,6 +79,13 @@ class ComputerInputDriver {
     scrollMouse(x, y) {
         this.getLibnutOrThrow('scrollMouse').scrollMouse(x, y);
     }
+    async emitScrollDetents(dx, dy, detents, delayMs) {
+        this.assertActive('emitScrollDetents');
+        for(let i = 0; i < detents; i++){
+            this.scrollMouse(dx, dy);
+            if (i < detents - 1) await this.delay(delayMs);
+        }
+    }
     keyTap(key, modifiers) {
         const lib = this.getLibnutOrThrow('keyTap');
         if (void 0 !== modifiers) lib.keyTap(key, modifiers);
@@ -230,13 +264,17 @@ const CLICK_HOLD_DURATION = 100;
 const CLICK_FOCUS_SETTLE_DELAY = 120;
 const INPUT_FOCUS_DELAY = 300;
 const INPUT_CLEAR_DELAY = 150;
-const SCROLL_REPEAT_COUNT = 10;
 const SCROLL_STEP_DELAY = 100;
 const SCROLL_COMPLETE_DELAY = 500;
 const EDGE_SCROLL_TOTAL_PX = 50000;
 const EDGE_SCROLL_STEPS = 400;
 const PHASED_PIXELS_PER_STEP = 30;
 const PHASED_MIN_STEPS = 10;
+const LIBNUT_FALLBACK_PIXELS_PER_DETENT = 100;
+const LIBNUT_FALLBACK_TICK_DELAY_MS = 30;
+const LIBNUT_FALLBACK_MAX_DETENTS = 200;
+const LIBNUT_FALLBACK_DETENT_AMOUNT = 'win32' === process.platform ? 120 : 1;
+const LIBNUT_FALLBACK_EDGE_DETENTS = Math.min(LIBNUT_FALLBACK_MAX_DETENTS, Math.max(1, Math.ceil(EDGE_SCROLL_TOTAL_PX / LIBNUT_FALLBACK_PIXELS_PER_DETENT)));
 const DEFAULT_SCROLL_VIEWPORT_RATIO = 0.7;
 const EDGE_SCROLL_SPEC = {
     scrollToTop: {
@@ -244,7 +282,7 @@ const EDGE_SCROLL_SPEC = {
         key: 'home',
         libnut: [
             0,
-            10
+            1
         ]
     },
     scrollToBottom: {
@@ -252,14 +290,14 @@ const EDGE_SCROLL_SPEC = {
         key: 'end',
         libnut: [
             0,
-            -10
+            -1
         ]
     },
     scrollToLeft: {
         direction: 'left',
         key: 'home',
         libnut: [
-            -10,
+            -1,
             0
         ]
     },
@@ -267,7 +305,7 @@ const EDGE_SCROLL_SPEC = {
         direction: 'right',
         key: 'end',
         libnut: [
-            10,
+            1,
             0
         ]
     }
@@ -656,7 +694,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.6");
+        console.log("[HealthCheck] @midscene/computer v1.9.7");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -834,7 +872,20 @@ Original error: ${lastRawMessage}`);
         });
         this.inputDriver.sendKey(key, modifiers);
     }
-    async performScroll(param) {
+    resolveUntargetedScrollPoint(screenSize) {
+        if ('win32' === process.platform) {
+            const activeWindowRect = this.inputDriver.getActiveWindowRect();
+            if (activeWindowRect) return {
+                x: activeWindowRect.x + activeWindowRect.width / 2,
+                y: activeWindowRect.y + activeWindowRect.height / 2
+            };
+        }
+        return this.toGlobalPoint({
+            x: screenSize.width / 2,
+            y: screenSize.height / 2
+        });
+    }
+    async moveMouseToScrollTarget(param) {
         if (param.locate) {
             const element = param.locate;
             const [x, y] = element.center;
@@ -843,7 +894,17 @@ Original error: ${lastRawMessage}`);
                 y
             });
             this.inputDriver.moveMouse(Math.round(point.x), Math.round(point.y));
+            return;
         }
+        const screenSize = await this.size();
+        if ('win32' === process.platform && this.inputDriver.focusActiveWindow()) await this.inputDriver.delay(CLICK_FOCUS_SETTLE_DELAY);
+        const point = this.resolveUntargetedScrollPoint(screenSize);
+        this.inputDriver.moveMouse(Math.round(point.x), Math.round(point.y));
+        await this.inputDriver.delay(MOUSE_MOVE_EFFECT_WAIT);
+        return screenSize;
+    }
+    async performScroll(param) {
+        let screenSize = await this.moveMouseToScrollTarget(param);
         const scrollType = param?.scrollType;
         const edgeSpec = scrollType && scrollType in EDGE_SCROLL_SPEC ? EDGE_SCROLL_SPEC[scrollType] : null;
         if (edgeSpec) {
@@ -853,11 +914,8 @@ Original error: ${lastRawMessage}`);
                 await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
                 return;
             }
-            const [dx, dy] = edgeSpec.libnut;
-            for(let i = 0; i < SCROLL_REPEAT_COUNT; i++){
-                this.inputDriver.scrollMouse(dx, dy);
-                await this.inputDriver.delay(SCROLL_STEP_DELAY);
-            }
+            const [ux, uy] = edgeSpec.libnut;
+            await this.inputDriver.emitScrollDetents(ux * LIBNUT_FALLBACK_DETENT_AMOUNT, uy * LIBNUT_FALLBACK_DETENT_AMOUNT, LIBNUT_FALLBACK_EDGE_DETENTS, LIBNUT_FALLBACK_TICK_DELAY_MS);
             return;
         }
         if ('singleAction' === scrollType || !scrollType) {
@@ -865,9 +923,8 @@ Original error: ${lastRawMessage}`);
             const isKnownDirection = 'up' === direction || 'down' === direction || 'left' === direction || 'right' === direction;
             const isHorizontal = 'left' === direction || 'right' === direction;
             let distance = param?.distance ?? void 0;
-            let screenSize;
             if (!distance) {
-                screenSize = await this.size();
+                screenSize ??= await this.size();
                 const base = isHorizontal ? screenSize.width : screenSize.height;
                 distance = Math.max(1, Math.round(base * DEFAULT_SCROLL_VIEWPORT_RATIO));
             }
@@ -886,30 +943,30 @@ Original error: ${lastRawMessage}`);
                 await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
                 return;
             }
-            const ticks = Math.ceil(distance / 100);
-            const directionMap = {
+            const detents = Math.min(LIBNUT_FALLBACK_MAX_DETENTS, Math.max(1, Math.ceil(distance / LIBNUT_FALLBACK_PIXELS_PER_DETENT)));
+            const directionUnit = {
                 up: [
                     0,
-                    ticks
+                    1
                 ],
                 down: [
                     0,
-                    -ticks
+                    -1
                 ],
                 left: [
-                    -ticks,
+                    -1,
                     0
                 ],
                 right: [
-                    ticks,
+                    1,
                     0
                 ]
             };
-            const [dx, dy] = directionMap[direction] || [
+            const [ux, uy] = directionUnit[direction] || [
                 0,
-                -ticks
+                -1
             ];
-            this.inputDriver.scrollMouse(dx, dy);
+            await this.inputDriver.emitScrollDetents(ux * LIBNUT_FALLBACK_DETENT_AMOUNT, uy * LIBNUT_FALLBACK_DETENT_AMOUNT, detents, LIBNUT_FALLBACK_TICK_DELAY_MS);
             await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
             return;
         }
@@ -2039,7 +2096,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
     }
 }
 function version() {
-    const currentVersion = "1.9.6";
+    const currentVersion = "1.9.7";
     console.log(`@midscene/computer v${currentVersion}`);
     return currentVersion;
 }

package/dist/es/mcp-server.mjs

@@ -40,6 +40,33 @@ class ComputerInputDriver {
     moveMouse(x, y) {
         this.getLibnutOrThrow('moveMouse').moveMouse(x, y);
     }
+    focusActiveWindow() {
+        const lib = this.getLibnutOrThrow('focusActiveWindow');
+        if ('function' != typeof lib.getActiveWindow || 'function' != typeof lib.focusWindow) return false;
+        try {
+            const handle = lib.getActiveWindow();
+            if (!handle) return false;
+            lib.focusWindow(handle);
+            return true;
+        } catch (error) {
+            this.options.debug(`focusActiveWindow failed: ${error}`);
+            return false;
+        }
+    }
+    getActiveWindowRect() {
+        const lib = this.getLibnutOrThrow('getActiveWindowRect');
+        if ('function' != typeof lib.getActiveWindow || 'function' != typeof lib.getWindowRect) return null;
+        try {
+            const handle = lib.getActiveWindow();
+            if (!handle) return null;
+            const rect = lib.getWindowRect(handle);
+            if (!Number.isFinite(rect.x) || !Number.isFinite(rect.y) || !Number.isFinite(rect.width) || !Number.isFinite(rect.height) || rect.width <= 0 || rect.height <= 0) return null;
+            return rect;
+        } catch (error) {
+            this.options.debug(`getActiveWindowRect failed: ${error}`);
+            return null;
+        }
+    }
     mouseClick(button, double) {
         const lib = this.getLibnutOrThrow('mouseClick');
         if (void 0 !== double) lib.mouseClick(button, double);
@@ -52,6 +79,13 @@ class ComputerInputDriver {
     scrollMouse(x, y) {
         this.getLibnutOrThrow('scrollMouse').scrollMouse(x, y);
     }
+    async emitScrollDetents(dx, dy, detents, delayMs) {
+        this.assertActive('emitScrollDetents');
+        for(let i = 0; i < detents; i++){
+            this.scrollMouse(dx, dy);
+            if (i < detents - 1) await this.delay(delayMs);
+        }
+    }
     keyTap(key, modifiers) {
         const lib = this.getLibnutOrThrow('keyTap');
         if (void 0 !== modifiers) lib.keyTap(key, modifiers);
@@ -230,13 +264,17 @@ const CLICK_HOLD_DURATION = 100;
 const CLICK_FOCUS_SETTLE_DELAY = 120;
 const INPUT_FOCUS_DELAY = 300;
 const INPUT_CLEAR_DELAY = 150;
-const SCROLL_REPEAT_COUNT = 10;
 const SCROLL_STEP_DELAY = 100;
 const SCROLL_COMPLETE_DELAY = 500;
 const EDGE_SCROLL_TOTAL_PX = 50000;
 const EDGE_SCROLL_STEPS = 400;
 const PHASED_PIXELS_PER_STEP = 30;
 const PHASED_MIN_STEPS = 10;
+const LIBNUT_FALLBACK_PIXELS_PER_DETENT = 100;
+const LIBNUT_FALLBACK_TICK_DELAY_MS = 30;
+const LIBNUT_FALLBACK_MAX_DETENTS = 200;
+const LIBNUT_FALLBACK_DETENT_AMOUNT = 'win32' === process.platform ? 120 : 1;
+const LIBNUT_FALLBACK_EDGE_DETENTS = Math.min(LIBNUT_FALLBACK_MAX_DETENTS, Math.max(1, Math.ceil(EDGE_SCROLL_TOTAL_PX / LIBNUT_FALLBACK_PIXELS_PER_DETENT)));
 const DEFAULT_SCROLL_VIEWPORT_RATIO = 0.7;
 const EDGE_SCROLL_SPEC = {
     scrollToTop: {
@@ -244,7 +282,7 @@ const EDGE_SCROLL_SPEC = {
         key: 'home',
         libnut: [
             0,
-            10
+            1
         ]
     },
     scrollToBottom: {
@@ -252,14 +290,14 @@ const EDGE_SCROLL_SPEC = {
         key: 'end',
         libnut: [
             0,
-            -10
+            -1
         ]
     },
     scrollToLeft: {
         direction: 'left',
         key: 'home',
         libnut: [
-            -10,
+            -1,
             0
         ]
     },
@@ -267,7 +305,7 @@ const EDGE_SCROLL_SPEC = {
         direction: 'right',
         key: 'end',
         libnut: [
-            10,
+            1,
             0
         ]
     }
@@ -656,7 +694,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.6");
+        console.log("[HealthCheck] @midscene/computer v1.9.7");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -834,7 +872,20 @@ Original error: ${lastRawMessage}`);
         });
         this.inputDriver.sendKey(key, modifiers);
     }
-    async performScroll(param) {
+    resolveUntargetedScrollPoint(screenSize) {
+        if ('win32' === process.platform) {
+            const activeWindowRect = this.inputDriver.getActiveWindowRect();
+            if (activeWindowRect) return {
+                x: activeWindowRect.x + activeWindowRect.width / 2,
+                y: activeWindowRect.y + activeWindowRect.height / 2
+            };
+        }
+        return this.toGlobalPoint({
+            x: screenSize.width / 2,
+            y: screenSize.height / 2
+        });
+    }
+    async moveMouseToScrollTarget(param) {
         if (param.locate) {
             const element = param.locate;
             const [x, y] = element.center;
@@ -843,7 +894,17 @@ Original error: ${lastRawMessage}`);
                 y
             });
             this.inputDriver.moveMouse(Math.round(point.x), Math.round(point.y));
+            return;
         }
+        const screenSize = await this.size();
+        if ('win32' === process.platform && this.inputDriver.focusActiveWindow()) await this.inputDriver.delay(CLICK_FOCUS_SETTLE_DELAY);
+        const point = this.resolveUntargetedScrollPoint(screenSize);
+        this.inputDriver.moveMouse(Math.round(point.x), Math.round(point.y));
+        await this.inputDriver.delay(MOUSE_MOVE_EFFECT_WAIT);
+        return screenSize;
+    }
+    async performScroll(param) {
+        let screenSize = await this.moveMouseToScrollTarget(param);
         const scrollType = param?.scrollType;
         const edgeSpec = scrollType && scrollType in EDGE_SCROLL_SPEC ? EDGE_SCROLL_SPEC[scrollType] : null;
         if (edgeSpec) {
@@ -853,11 +914,8 @@ Original error: ${lastRawMessage}`);
                 await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
                 return;
             }
-            const [dx, dy] = edgeSpec.libnut;
-            for(let i = 0; i < SCROLL_REPEAT_COUNT; i++){
-                this.inputDriver.scrollMouse(dx, dy);
-                await this.inputDriver.delay(SCROLL_STEP_DELAY);
-            }
+            const [ux, uy] = edgeSpec.libnut;
+            await this.inputDriver.emitScrollDetents(ux * LIBNUT_FALLBACK_DETENT_AMOUNT, uy * LIBNUT_FALLBACK_DETENT_AMOUNT, LIBNUT_FALLBACK_EDGE_DETENTS, LIBNUT_FALLBACK_TICK_DELAY_MS);
             return;
         }
         if ('singleAction' === scrollType || !scrollType) {
@@ -865,9 +923,8 @@ Original error: ${lastRawMessage}`);
             const isKnownDirection = 'up' === direction || 'down' === direction || 'left' === direction || 'right' === direction;
             const isHorizontal = 'left' === direction || 'right' === direction;
             let distance = param?.distance ?? void 0;
-            let screenSize;
             if (!distance) {
-                screenSize = await this.size();
+                screenSize ??= await this.size();
                 const base = isHorizontal ? screenSize.width : screenSize.height;
                 distance = Math.max(1, Math.round(base * DEFAULT_SCROLL_VIEWPORT_RATIO));
             }
@@ -886,30 +943,30 @@ Original error: ${lastRawMessage}`);
                 await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
                 return;
             }
-            const ticks = Math.ceil(distance / 100);
-            const directionMap = {
+            const detents = Math.min(LIBNUT_FALLBACK_MAX_DETENTS, Math.max(1, Math.ceil(distance / LIBNUT_FALLBACK_PIXELS_PER_DETENT)));
+            const directionUnit = {
                 up: [
                     0,
-                    ticks
+                    1
                 ],
                 down: [
                     0,
-                    -ticks
+                    -1
                 ],
                 left: [
-                    -ticks,
+                    -1,
                     0
                 ],
                 right: [
-                    ticks,
+                    1,
                     0
                 ]
             };
-            const [dx, dy] = directionMap[direction] || [
+            const [ux, uy] = directionUnit[direction] || [
                 0,
-                -ticks
+                -1
             ];
-            this.inputDriver.scrollMouse(dx, dy);
+            await this.inputDriver.emitScrollDetents(ux * LIBNUT_FALLBACK_DETENT_AMOUNT, uy * LIBNUT_FALLBACK_DETENT_AMOUNT, detents, LIBNUT_FALLBACK_TICK_DELAY_MS);
             await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
             return;
         }
@@ -2002,7 +2059,7 @@ class ComputerMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/computer-mcp',
-            version: "1.9.6",
+            version: "1.9.7",
             description: 'Control the computer desktop using natural language commands'
         }, toolsManager);
     }