@midscene/computer 1.7.3 → 1.7.5-beta-20260418223706.0

package/dist/es/cli.mjs

@@ -4,13 +4,15 @@ import { getDebug } from "@midscene/shared/logger";
 import { BaseMidsceneTools } from "@midscene/shared/mcp";
 import { Agent } from "@midscene/core/agent";
 import node_assert from "node:assert";
-import { execFileSync, execSync, spawn } from "node:child_process";
+import { execFileSync, execSync, spawn, spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
+import { dirname, resolve as external_node_path_resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 import { actionHoverParamSchema, defineAction, defineActionClearInput, defineActionDoubleClick, defineActionDragAndDrop, defineActionKeyboardPress, defineActionRightClick, defineActionScroll, defineActionTap } from "@midscene/core/device";
 import { sleep } from "@midscene/core/utils";
 import { createImgBase64ByFormat } from "@midscene/shared/img";
 import screenshot_desktop from "screenshot-desktop";
-import { existsSync } from "node:fs";
 const debugXvfb = getDebug('computer:xvfb');
 function checkXvfbInstalled() {
     try {
@@ -108,6 +110,45 @@ 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 APPROX_VIEWPORT_HEIGHT_PX = 600;
+const EDGE_SCROLL_SPEC = {
+    scrollToTop: {
+        direction: 'up',
+        key: 'home',
+        libnut: [
+            0,
+            10
+        ]
+    },
+    scrollToBottom: {
+        direction: 'down',
+        key: 'end',
+        libnut: [
+            0,
+            -10
+        ]
+    },
+    scrollToLeft: {
+        direction: 'left',
+        key: 'home',
+        libnut: [
+            -10,
+            0
+        ]
+    },
+    scrollToRight: {
+        direction: 'right',
+        key: 'end',
+        libnut: [
+            10,
+            0
+        ]
+    }
+};
 const APPLESCRIPT_KEY_CODE_MAP = {
     return: 36,
     enter: 36,
@@ -186,6 +227,69 @@ async function getLibnut() {
     }
 }
 const debugDevice = getDebug('computer:device');
+let phasedScrollBinaryPath;
+function getPhasedScrollBinary() {
+    if (void 0 !== phasedScrollBinaryPath) return phasedScrollBinaryPath;
+    if ('darwin' !== process.platform) {
+        phasedScrollBinaryPath = null;
+        return null;
+    }
+    const require = createRequire(import.meta.url);
+    let pkgRoot = null;
+    try {
+        pkgRoot = dirname(require.resolve('@midscene/computer/package.json'));
+    } catch  {
+        const hereDir = dirname(fileURLToPath(import.meta.url));
+        for (const candidate of [
+            external_node_path_resolve(hereDir, '..'),
+            external_node_path_resolve(hereDir, '../..')
+        ])if (existsSync(external_node_path_resolve(candidate, 'package.json'))) {
+            pkgRoot = candidate;
+            break;
+        }
+    }
+    if (!pkgRoot) {
+        debugDevice('phased-scroll: cannot locate @midscene/computer package root');
+        phasedScrollBinaryPath = null;
+        return null;
+    }
+    const binPath = external_node_path_resolve(pkgRoot, 'bin/darwin/phased-scroll');
+    if (!existsSync(binPath)) {
+        debugDevice('phased-scroll binary not found at', binPath);
+        phasedScrollBinaryPath = null;
+        return null;
+    }
+    phasedScrollBinaryPath = binPath;
+    return binPath;
+}
+let phasedScrollExecWarned = false;
+function runPhasedScroll(direction, pixels, steps) {
+    const bin = getPhasedScrollBinary();
+    if (!bin) return false;
+    try {
+        const res = spawnSync(bin, [
+            direction,
+            String(Math.max(1, Math.round(pixels))),
+            String(steps)
+        ], {
+            stdio: 'ignore'
+        });
+        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.`);
+        }
+        debugDevice('phased-scroll exited non-zero', res.status, res.error);
+        return false;
+    } catch (err) {
+        if (!phasedScrollExecWarned) {
+            phasedScrollExecWarned = true;
+            console.warn(`[@midscene/computer] phased-scroll helper failed to spawn (${err?.message}); falling back to keyboard/libnut.`);
+        }
+        debugDevice('phased-scroll spawn failed', err);
+        return false;
+    }
+}
 async function smoothMoveMouse(targetX, targetY, steps, stepDelay) {
     node_assert(libnut, 'libnut not initialized');
     const currentPos = libnut.getMousePos();
@@ -305,7 +409,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.7.3");
+        console.log("[HealthCheck] @midscene/computer v1.7.5-beta-20260418223706.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -532,27 +636,15 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
                     libnut.moveMouse(Math.round(x), Math.round(y));
                 }
                 const scrollType = param?.scrollType;
-                const scrollToEdgeActions = {
-                    scrollToTop: [
-                        0,
-                        10
-                    ],
-                    scrollToBottom: [
-                        0,
-                        -10
-                    ],
-                    scrollToLeft: [
-                        -10,
-                        0
-                    ],
-                    scrollToRight: [
-                        10,
-                        0
-                    ]
-                };
-                const edgeAction = scrollToEdgeActions[scrollType || ''];
-                if (edgeAction) {
-                    const [dx, dy] = edgeAction;
+                const edgeSpec = scrollType && scrollType in EDGE_SCROLL_SPEC ? EDGE_SCROLL_SPEC[scrollType] : null;
+                if (edgeSpec) {
+                    if (runPhasedScroll(edgeSpec.direction, EDGE_SCROLL_TOTAL_PX, EDGE_SCROLL_STEPS)) return void await sleep(SCROLL_COMPLETE_DELAY);
+                    if (this.useAppleScript) {
+                        sendKeyViaAppleScript(edgeSpec.key);
+                        await sleep(SCROLL_COMPLETE_DELAY);
+                        return;
+                    }
+                    const [dx, dy] = edgeSpec.libnut;
                     for(let i = 0; i < SCROLL_REPEAT_COUNT; i++){
                         libnut.scrollMouse(dx, dy);
                         await sleep(SCROLL_STEP_DELAY);
@@ -561,8 +653,23 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
                 }
                 if ('singleAction' === scrollType || !scrollType) {
                     const distance = param?.distance || 500;
-                    const ticks = Math.ceil(distance / 100);
                     const direction = param?.direction || 'down';
+                    const isKnownDirection = 'up' === direction || 'down' === direction || 'left' === direction || 'right' === direction;
+                    if (isKnownDirection) {
+                        const steps = Math.max(PHASED_MIN_STEPS, Math.round(distance / PHASED_PIXELS_PER_STEP));
+                        if (runPhasedScroll(direction, distance, steps)) return void await sleep(SCROLL_COMPLETE_DELAY);
+                    }
+                    if (this.useAppleScript && ('up' === direction || 'down' === direction)) {
+                        const pages = Math.max(1, Math.round(distance / APPROX_VIEWPORT_HEIGHT_PX));
+                        const key = 'up' === direction ? 'pageup' : 'pagedown';
+                        for(let i = 0; i < pages; i++){
+                            sendKeyViaAppleScript(key);
+                            await sleep(SCROLL_STEP_DELAY);
+                        }
+                        await sleep(SCROLL_COMPLETE_DELAY);
+                        return;
+                    }
+                    const ticks = Math.ceil(distance / 100);
                     const directionMap = {
                         up: [
                             0,
@@ -787,7 +894,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
 const tools = new ComputerMidsceneTools();
 runToolsCLI(tools, 'midscene-computer', {
     stripPrefix: 'computer_',
-    version: "1.7.3",
+    version: "1.7.5-beta-20260418223706.0",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     if (!(e instanceof CLIError)) console.error(e);

package/dist/es/index.mjs

@@ -1,13 +1,15 @@
 import node_assert from "node:assert";
-import { execFileSync, execSync, spawn } from "node:child_process";
+import { execFileSync, execSync, spawn, spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
+import { dirname, resolve as external_node_path_resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 import { getMidsceneLocationSchema, z } from "@midscene/core";
 import { actionHoverParamSchema, defineAction, defineActionClearInput, defineActionDoubleClick, defineActionDragAndDrop, defineActionKeyboardPress, defineActionRightClick, defineActionScroll, defineActionTap } from "@midscene/core/device";
 import { sleep } from "@midscene/core/utils";
 import { createImgBase64ByFormat } from "@midscene/shared/img";
 import { getDebug } from "@midscene/shared/logger";
 import screenshot_desktop from "screenshot-desktop";
-import { existsSync } from "node:fs";
 import { Agent } from "@midscene/core/agent";
 import { BaseMidsceneTools } from "@midscene/shared/mcp";
 import { overrideAIConfig } from "@midscene/shared/env";
@@ -108,6 +110,45 @@ 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 APPROX_VIEWPORT_HEIGHT_PX = 600;
+const EDGE_SCROLL_SPEC = {
+    scrollToTop: {
+        direction: 'up',
+        key: 'home',
+        libnut: [
+            0,
+            10
+        ]
+    },
+    scrollToBottom: {
+        direction: 'down',
+        key: 'end',
+        libnut: [
+            0,
+            -10
+        ]
+    },
+    scrollToLeft: {
+        direction: 'left',
+        key: 'home',
+        libnut: [
+            -10,
+            0
+        ]
+    },
+    scrollToRight: {
+        direction: 'right',
+        key: 'end',
+        libnut: [
+            10,
+            0
+        ]
+    }
+};
 const APPLESCRIPT_KEY_CODE_MAP = {
     return: 36,
     enter: 36,
@@ -186,6 +227,69 @@ async function getLibnut() {
     }
 }
 const debugDevice = getDebug('computer:device');
+let phasedScrollBinaryPath;
+function getPhasedScrollBinary() {
+    if (void 0 !== phasedScrollBinaryPath) return phasedScrollBinaryPath;
+    if ('darwin' !== process.platform) {
+        phasedScrollBinaryPath = null;
+        return null;
+    }
+    const require = createRequire(import.meta.url);
+    let pkgRoot = null;
+    try {
+        pkgRoot = dirname(require.resolve('@midscene/computer/package.json'));
+    } catch  {
+        const hereDir = dirname(fileURLToPath(import.meta.url));
+        for (const candidate of [
+            external_node_path_resolve(hereDir, '..'),
+            external_node_path_resolve(hereDir, '../..')
+        ])if (existsSync(external_node_path_resolve(candidate, 'package.json'))) {
+            pkgRoot = candidate;
+            break;
+        }
+    }
+    if (!pkgRoot) {
+        debugDevice('phased-scroll: cannot locate @midscene/computer package root');
+        phasedScrollBinaryPath = null;
+        return null;
+    }
+    const binPath = external_node_path_resolve(pkgRoot, 'bin/darwin/phased-scroll');
+    if (!existsSync(binPath)) {
+        debugDevice('phased-scroll binary not found at', binPath);
+        phasedScrollBinaryPath = null;
+        return null;
+    }
+    phasedScrollBinaryPath = binPath;
+    return binPath;
+}
+let phasedScrollExecWarned = false;
+function runPhasedScroll(direction, pixels, steps) {
+    const bin = getPhasedScrollBinary();
+    if (!bin) return false;
+    try {
+        const res = spawnSync(bin, [
+            direction,
+            String(Math.max(1, Math.round(pixels))),
+            String(steps)
+        ], {
+            stdio: 'ignore'
+        });
+        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.`);
+        }
+        debugDevice('phased-scroll exited non-zero', res.status, res.error);
+        return false;
+    } catch (err) {
+        if (!phasedScrollExecWarned) {
+            phasedScrollExecWarned = true;
+            console.warn(`[@midscene/computer] phased-scroll helper failed to spawn (${err?.message}); falling back to keyboard/libnut.`);
+        }
+        debugDevice('phased-scroll spawn failed', err);
+        return false;
+    }
+}
 async function smoothMoveMouse(targetX, targetY, steps, stepDelay) {
     node_assert(device_libnut, 'libnut not initialized');
     const currentPos = device_libnut.getMousePos();
@@ -305,7 +409,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.7.3");
+        console.log("[HealthCheck] @midscene/computer v1.7.5-beta-20260418223706.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -532,27 +636,15 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
                     device_libnut.moveMouse(Math.round(x), Math.round(y));
                 }
                 const scrollType = param?.scrollType;
-                const scrollToEdgeActions = {
-                    scrollToTop: [
-                        0,
-                        10
-                    ],
-                    scrollToBottom: [
-                        0,
-                        -10
-                    ],
-                    scrollToLeft: [
-                        -10,
-                        0
-                    ],
-                    scrollToRight: [
-                        10,
-                        0
-                    ]
-                };
-                const edgeAction = scrollToEdgeActions[scrollType || ''];
-                if (edgeAction) {
-                    const [dx, dy] = edgeAction;
+                const edgeSpec = scrollType && scrollType in EDGE_SCROLL_SPEC ? EDGE_SCROLL_SPEC[scrollType] : null;
+                if (edgeSpec) {
+                    if (runPhasedScroll(edgeSpec.direction, EDGE_SCROLL_TOTAL_PX, EDGE_SCROLL_STEPS)) return void await sleep(SCROLL_COMPLETE_DELAY);
+                    if (this.useAppleScript) {
+                        sendKeyViaAppleScript(edgeSpec.key);
+                        await sleep(SCROLL_COMPLETE_DELAY);
+                        return;
+                    }
+                    const [dx, dy] = edgeSpec.libnut;
                     for(let i = 0; i < SCROLL_REPEAT_COUNT; i++){
                         device_libnut.scrollMouse(dx, dy);
                         await sleep(SCROLL_STEP_DELAY);
@@ -561,8 +653,23 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
                 }
                 if ('singleAction' === scrollType || !scrollType) {
                     const distance = param?.distance || 500;
-                    const ticks = Math.ceil(distance / 100);
                     const direction = param?.direction || 'down';
+                    const isKnownDirection = 'up' === direction || 'down' === direction || 'left' === direction || 'right' === direction;
+                    if (isKnownDirection) {
+                        const steps = Math.max(PHASED_MIN_STEPS, Math.round(distance / PHASED_PIXELS_PER_STEP));
+                        if (runPhasedScroll(direction, distance, steps)) return void await sleep(SCROLL_COMPLETE_DELAY);
+                    }
+                    if (this.useAppleScript && ('up' === direction || 'down' === direction)) {
+                        const pages = Math.max(1, Math.round(distance / APPROX_VIEWPORT_HEIGHT_PX));
+                        const key = 'up' === direction ? 'pageup' : 'pagedown';
+                        for(let i = 0; i < pages; i++){
+                            sendKeyViaAppleScript(key);
+                            await sleep(SCROLL_STEP_DELAY);
+                        }
+                        await sleep(SCROLL_COMPLETE_DELAY);
+                        return;
+                    }
+                    const ticks = Math.ceil(distance / 100);
                     const directionMap = {
                         up: [
                             0,
@@ -785,7 +892,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
     }
 }
 function version() {
-    const currentVersion = "1.7.3";
+    const currentVersion = "1.7.5-beta-20260418223706.0";
     console.log(`@midscene/computer v${currentVersion}`);
     return currentVersion;
 }

package/dist/es/mcp-server.mjs

@@ -1,15 +1,17 @@
 import { BaseMCPServer, BaseMidsceneTools, createMCPServerLauncher } from "@midscene/shared/mcp";
 import { Agent } from "@midscene/core/agent";
 import node_assert from "node:assert";
-import { execFileSync, execSync, spawn } from "node:child_process";
+import { execFileSync, execSync, spawn, spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
+import { dirname, resolve as external_node_path_resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 import { getMidsceneLocationSchema, z } from "@midscene/core";
 import { actionHoverParamSchema, defineAction, defineActionClearInput, defineActionDoubleClick, defineActionDragAndDrop, defineActionKeyboardPress, defineActionRightClick, defineActionScroll, defineActionTap } from "@midscene/core/device";
 import { sleep } from "@midscene/core/utils";
 import { createImgBase64ByFormat } from "@midscene/shared/img";
 import { getDebug } from "@midscene/shared/logger";
 import screenshot_desktop from "screenshot-desktop";
-import { existsSync } from "node:fs";
 const debugXvfb = getDebug('computer:xvfb');
 function checkXvfbInstalled() {
     try {
@@ -107,6 +109,45 @@ 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 APPROX_VIEWPORT_HEIGHT_PX = 600;
+const EDGE_SCROLL_SPEC = {
+    scrollToTop: {
+        direction: 'up',
+        key: 'home',
+        libnut: [
+            0,
+            10
+        ]
+    },
+    scrollToBottom: {
+        direction: 'down',
+        key: 'end',
+        libnut: [
+            0,
+            -10
+        ]
+    },
+    scrollToLeft: {
+        direction: 'left',
+        key: 'home',
+        libnut: [
+            -10,
+            0
+        ]
+    },
+    scrollToRight: {
+        direction: 'right',
+        key: 'end',
+        libnut: [
+            10,
+            0
+        ]
+    }
+};
 const APPLESCRIPT_KEY_CODE_MAP = {
     return: 36,
     enter: 36,
@@ -185,6 +226,69 @@ async function getLibnut() {
     }
 }
 const debugDevice = getDebug('computer:device');
+let phasedScrollBinaryPath;
+function getPhasedScrollBinary() {
+    if (void 0 !== phasedScrollBinaryPath) return phasedScrollBinaryPath;
+    if ('darwin' !== process.platform) {
+        phasedScrollBinaryPath = null;
+        return null;
+    }
+    const require = createRequire(import.meta.url);
+    let pkgRoot = null;
+    try {
+        pkgRoot = dirname(require.resolve('@midscene/computer/package.json'));
+    } catch  {
+        const hereDir = dirname(fileURLToPath(import.meta.url));
+        for (const candidate of [
+            external_node_path_resolve(hereDir, '..'),
+            external_node_path_resolve(hereDir, '../..')
+        ])if (existsSync(external_node_path_resolve(candidate, 'package.json'))) {
+            pkgRoot = candidate;
+            break;
+        }
+    }
+    if (!pkgRoot) {
+        debugDevice('phased-scroll: cannot locate @midscene/computer package root');
+        phasedScrollBinaryPath = null;
+        return null;
+    }
+    const binPath = external_node_path_resolve(pkgRoot, 'bin/darwin/phased-scroll');
+    if (!existsSync(binPath)) {
+        debugDevice('phased-scroll binary not found at', binPath);
+        phasedScrollBinaryPath = null;
+        return null;
+    }
+    phasedScrollBinaryPath = binPath;
+    return binPath;
+}
+let phasedScrollExecWarned = false;
+function runPhasedScroll(direction, pixels, steps) {
+    const bin = getPhasedScrollBinary();
+    if (!bin) return false;
+    try {
+        const res = spawnSync(bin, [
+            direction,
+            String(Math.max(1, Math.round(pixels))),
+            String(steps)
+        ], {
+            stdio: 'ignore'
+        });
+        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.`);
+        }
+        debugDevice('phased-scroll exited non-zero', res.status, res.error);
+        return false;
+    } catch (err) {
+        if (!phasedScrollExecWarned) {
+            phasedScrollExecWarned = true;
+            console.warn(`[@midscene/computer] phased-scroll helper failed to spawn (${err?.message}); falling back to keyboard/libnut.`);
+        }
+        debugDevice('phased-scroll spawn failed', err);
+        return false;
+    }
+}
 async function smoothMoveMouse(targetX, targetY, steps, stepDelay) {
     node_assert(libnut, 'libnut not initialized');
     const currentPos = libnut.getMousePos();
@@ -304,7 +408,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.7.3");
+        console.log("[HealthCheck] @midscene/computer v1.7.5-beta-20260418223706.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -531,27 +635,15 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
                     libnut.moveMouse(Math.round(x), Math.round(y));
                 }
                 const scrollType = param?.scrollType;
-                const scrollToEdgeActions = {
-                    scrollToTop: [
-                        0,
-                        10
-                    ],
-                    scrollToBottom: [
-                        0,
-                        -10
-                    ],
-                    scrollToLeft: [
-                        -10,
-                        0
-                    ],
-                    scrollToRight: [
-                        10,
-                        0
-                    ]
-                };
-                const edgeAction = scrollToEdgeActions[scrollType || ''];
-                if (edgeAction) {
-                    const [dx, dy] = edgeAction;
+                const edgeSpec = scrollType && scrollType in EDGE_SCROLL_SPEC ? EDGE_SCROLL_SPEC[scrollType] : null;
+                if (edgeSpec) {
+                    if (runPhasedScroll(edgeSpec.direction, EDGE_SCROLL_TOTAL_PX, EDGE_SCROLL_STEPS)) return void await sleep(SCROLL_COMPLETE_DELAY);
+                    if (this.useAppleScript) {
+                        sendKeyViaAppleScript(edgeSpec.key);
+                        await sleep(SCROLL_COMPLETE_DELAY);
+                        return;
+                    }
+                    const [dx, dy] = edgeSpec.libnut;
                     for(let i = 0; i < SCROLL_REPEAT_COUNT; i++){
                         libnut.scrollMouse(dx, dy);
                         await sleep(SCROLL_STEP_DELAY);
@@ -560,8 +652,23 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
                 }
                 if ('singleAction' === scrollType || !scrollType) {
                     const distance = param?.distance || 500;
-                    const ticks = Math.ceil(distance / 100);
                     const direction = param?.direction || 'down';
+                    const isKnownDirection = 'up' === direction || 'down' === direction || 'left' === direction || 'right' === direction;
+                    if (isKnownDirection) {
+                        const steps = Math.max(PHASED_MIN_STEPS, Math.round(distance / PHASED_PIXELS_PER_STEP));
+                        if (runPhasedScroll(direction, distance, steps)) return void await sleep(SCROLL_COMPLETE_DELAY);
+                    }
+                    if (this.useAppleScript && ('up' === direction || 'down' === direction)) {
+                        const pages = Math.max(1, Math.round(distance / APPROX_VIEWPORT_HEIGHT_PX));
+                        const key = 'up' === direction ? 'pageup' : 'pagedown';
+                        for(let i = 0; i < pages; i++){
+                            sendKeyViaAppleScript(key);
+                            await sleep(SCROLL_STEP_DELAY);
+                        }
+                        await sleep(SCROLL_COMPLETE_DELAY);
+                        return;
+                    }
+                    const ticks = Math.ceil(distance / 100);
                     const directionMap = {
                         up: [
                             0,
@@ -790,7 +897,7 @@ class ComputerMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/computer-mcp',
-            version: "1.7.3",
+            version: "1.7.5-beta-20260418223706.0",
             description: 'Control the computer desktop using natural language commands'
         }, toolsManager);
     }

package/dist/lib/cli.js

@@ -32,13 +32,15 @@ const agent_namespaceObject = require("@midscene/core/agent");
 const external_node_assert_namespaceObject = require("node:assert");
 var external_node_assert_default = /*#__PURE__*/ __webpack_require__.n(external_node_assert_namespaceObject);
 const external_node_child_process_namespaceObject = require("node:child_process");
+const external_node_fs_namespaceObject = require("node:fs");
 const external_node_module_namespaceObject = require("node:module");
+const external_node_path_namespaceObject = require("node:path");
+const external_node_url_namespaceObject = require("node:url");
 const device_namespaceObject = require("@midscene/core/device");
 const utils_namespaceObject = require("@midscene/core/utils");
 const img_namespaceObject = require("@midscene/shared/img");
 const external_screenshot_desktop_namespaceObject = require("screenshot-desktop");
 var external_screenshot_desktop_default = /*#__PURE__*/ __webpack_require__.n(external_screenshot_desktop_namespaceObject);
-const external_node_fs_namespaceObject = require("node:fs");
 const debugXvfb = (0, logger_namespaceObject.getDebug)('computer:xvfb');
 function checkXvfbInstalled() {
     try {
@@ -136,6 +138,45 @@ 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 APPROX_VIEWPORT_HEIGHT_PX = 600;
+const EDGE_SCROLL_SPEC = {
+    scrollToTop: {
+        direction: 'up',
+        key: 'home',
+        libnut: [
+            0,
+            10
+        ]
+    },
+    scrollToBottom: {
+        direction: 'down',
+        key: 'end',
+        libnut: [
+            0,
+            -10
+        ]
+    },
+    scrollToLeft: {
+        direction: 'left',
+        key: 'home',
+        libnut: [
+            -10,
+            0
+        ]
+    },
+    scrollToRight: {
+        direction: 'right',
+        key: 'end',
+        libnut: [
+            10,
+            0
+        ]
+    }
+};
 const APPLESCRIPT_KEY_CODE_MAP = {
     return: 36,
     enter: 36,
@@ -214,6 +255,69 @@ async function getLibnut() {
     }
 }
 const debugDevice = (0, logger_namespaceObject.getDebug)('computer:device');
+let phasedScrollBinaryPath;
+function getPhasedScrollBinary() {
+    if (void 0 !== phasedScrollBinaryPath) return phasedScrollBinaryPath;
+    if ('darwin' !== process.platform) {
+        phasedScrollBinaryPath = null;
+        return null;
+    }
+    const require1 = (0, external_node_module_namespaceObject.createRequire)(__rslib_import_meta_url__);
+    let pkgRoot = null;
+    try {
+        pkgRoot = (0, external_node_path_namespaceObject.dirname)(require1.resolve('@midscene/computer/package.json'));
+    } catch  {
+        const hereDir = (0, external_node_path_namespaceObject.dirname)((0, external_node_url_namespaceObject.fileURLToPath)(__rslib_import_meta_url__));
+        for (const candidate of [
+            (0, external_node_path_namespaceObject.resolve)(hereDir, '..'),
+            (0, external_node_path_namespaceObject.resolve)(hereDir, '../..')
+        ])if ((0, external_node_fs_namespaceObject.existsSync)((0, external_node_path_namespaceObject.resolve)(candidate, 'package.json'))) {
+            pkgRoot = candidate;
+            break;
+        }
+    }
+    if (!pkgRoot) {
+        debugDevice('phased-scroll: cannot locate @midscene/computer package root');
+        phasedScrollBinaryPath = null;
+        return null;
+    }
+    const binPath = (0, external_node_path_namespaceObject.resolve)(pkgRoot, 'bin/darwin/phased-scroll');
+    if (!(0, external_node_fs_namespaceObject.existsSync)(binPath)) {
+        debugDevice('phased-scroll binary not found at', binPath);
+        phasedScrollBinaryPath = null;
+        return null;
+    }
+    phasedScrollBinaryPath = binPath;
+    return binPath;
+}
+let phasedScrollExecWarned = false;
+function runPhasedScroll(direction, pixels, steps) {
+    const bin = getPhasedScrollBinary();
+    if (!bin) return false;
+    try {
+        const res = (0, external_node_child_process_namespaceObject.spawnSync)(bin, [
+            direction,
+            String(Math.max(1, Math.round(pixels))),
+            String(steps)
+        ], {
+            stdio: 'ignore'
+        });
+        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.`);
+        }
+        debugDevice('phased-scroll exited non-zero', res.status, res.error);
+        return false;
+    } catch (err) {
+        if (!phasedScrollExecWarned) {
+            phasedScrollExecWarned = true;
+            console.warn(`[@midscene/computer] phased-scroll helper failed to spawn (${err?.message}); falling back to keyboard/libnut.`);
+        }
+        debugDevice('phased-scroll spawn failed', err);
+        return false;
+    }
+}
 async function smoothMoveMouse(targetX, targetY, steps, stepDelay) {
     external_node_assert_default()(libnut, 'libnut not initialized');
     const currentPos = libnut.getMousePos();
@@ -333,7 +437,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.7.3");
+        console.log("[HealthCheck] @midscene/computer v1.7.5-beta-20260418223706.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -560,27 +664,15 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
                     libnut.moveMouse(Math.round(x), Math.round(y));
                 }
                 const scrollType = param?.scrollType;
-                const scrollToEdgeActions = {
-                    scrollToTop: [
-                        0,
-                        10
-                    ],
-                    scrollToBottom: [
-                        0,
-                        -10
-                    ],
-                    scrollToLeft: [
-                        -10,
-                        0
-                    ],
-                    scrollToRight: [
-                        10,
-                        0
-                    ]
-                };
-                const edgeAction = scrollToEdgeActions[scrollType || ''];
-                if (edgeAction) {
-                    const [dx, dy] = edgeAction;
+                const edgeSpec = scrollType && scrollType in EDGE_SCROLL_SPEC ? EDGE_SCROLL_SPEC[scrollType] : null;
+                if (edgeSpec) {
+                    if (runPhasedScroll(edgeSpec.direction, EDGE_SCROLL_TOTAL_PX, EDGE_SCROLL_STEPS)) return void await (0, utils_namespaceObject.sleep)(SCROLL_COMPLETE_DELAY);
+                    if (this.useAppleScript) {
+                        sendKeyViaAppleScript(edgeSpec.key);
+                        await (0, utils_namespaceObject.sleep)(SCROLL_COMPLETE_DELAY);
+                        return;
+                    }
+                    const [dx, dy] = edgeSpec.libnut;
                     for(let i = 0; i < SCROLL_REPEAT_COUNT; i++){
                         libnut.scrollMouse(dx, dy);
                         await (0, utils_namespaceObject.sleep)(SCROLL_STEP_DELAY);
@@ -589,8 +681,23 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
                 }
                 if ('singleAction' === scrollType || !scrollType) {
                     const distance = param?.distance || 500;
-                    const ticks = Math.ceil(distance / 100);
                     const direction = param?.direction || 'down';
+                    const isKnownDirection = 'up' === direction || 'down' === direction || 'left' === direction || 'right' === direction;
+                    if (isKnownDirection) {
+                        const steps = Math.max(PHASED_MIN_STEPS, Math.round(distance / PHASED_PIXELS_PER_STEP));
+                        if (runPhasedScroll(direction, distance, steps)) return void await (0, utils_namespaceObject.sleep)(SCROLL_COMPLETE_DELAY);
+                    }
+                    if (this.useAppleScript && ('up' === direction || 'down' === direction)) {
+                        const pages = Math.max(1, Math.round(distance / APPROX_VIEWPORT_HEIGHT_PX));
+                        const key = 'up' === direction ? 'pageup' : 'pagedown';
+                        for(let i = 0; i < pages; i++){
+                            sendKeyViaAppleScript(key);
+                            await (0, utils_namespaceObject.sleep)(SCROLL_STEP_DELAY);
+                        }
+                        await (0, utils_namespaceObject.sleep)(SCROLL_COMPLETE_DELAY);
+                        return;
+                    }
+                    const ticks = Math.ceil(distance / 100);
                     const directionMap = {
                         up: [
                             0,
@@ -815,7 +922,7 @@ class ComputerMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
 const tools = new ComputerMidsceneTools();
 (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-computer', {
     stripPrefix: 'computer_',
-    version: "1.7.3",
+    version: "1.7.5-beta-20260418223706.0",
     extraCommands: (0, core_namespaceObject.createReportCliCommands)()
 }).catch((e)=>{
     if (!(e instanceof cli_namespaceObject.CLIError)) console.error(e);

package/dist/lib/index.js

@@ -51,7 +51,10 @@ __webpack_require__.d(__webpack_exports__, {
 const external_node_assert_namespaceObject = require("node:assert");
 var external_node_assert_default = /*#__PURE__*/ __webpack_require__.n(external_node_assert_namespaceObject);
 const external_node_child_process_namespaceObject = require("node:child_process");
+const external_node_fs_namespaceObject = require("node:fs");
 const external_node_module_namespaceObject = require("node:module");
+const external_node_path_namespaceObject = require("node:path");
+const external_node_url_namespaceObject = require("node:url");
 const core_namespaceObject = require("@midscene/core");
 const device_namespaceObject = require("@midscene/core/device");
 const utils_namespaceObject = require("@midscene/core/utils");
@@ -59,7 +62,6 @@ const img_namespaceObject = require("@midscene/shared/img");
 const logger_namespaceObject = require("@midscene/shared/logger");
 const external_screenshot_desktop_namespaceObject = require("screenshot-desktop");
 var external_screenshot_desktop_default = /*#__PURE__*/ __webpack_require__.n(external_screenshot_desktop_namespaceObject);
-const external_node_fs_namespaceObject = require("node:fs");
 const debugXvfb = (0, logger_namespaceObject.getDebug)('computer:xvfb');
 function checkXvfbInstalled() {
     try {
@@ -157,6 +159,45 @@ 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 APPROX_VIEWPORT_HEIGHT_PX = 600;
+const EDGE_SCROLL_SPEC = {
+    scrollToTop: {
+        direction: 'up',
+        key: 'home',
+        libnut: [
+            0,
+            10
+        ]
+    },
+    scrollToBottom: {
+        direction: 'down',
+        key: 'end',
+        libnut: [
+            0,
+            -10
+        ]
+    },
+    scrollToLeft: {
+        direction: 'left',
+        key: 'home',
+        libnut: [
+            -10,
+            0
+        ]
+    },
+    scrollToRight: {
+        direction: 'right',
+        key: 'end',
+        libnut: [
+            10,
+            0
+        ]
+    }
+};
 const APPLESCRIPT_KEY_CODE_MAP = {
     return: 36,
     enter: 36,
@@ -235,6 +276,69 @@ async function getLibnut() {
     }
 }
 const debugDevice = (0, logger_namespaceObject.getDebug)('computer:device');
+let phasedScrollBinaryPath;
+function getPhasedScrollBinary() {
+    if (void 0 !== phasedScrollBinaryPath) return phasedScrollBinaryPath;
+    if ('darwin' !== process.platform) {
+        phasedScrollBinaryPath = null;
+        return null;
+    }
+    const require1 = (0, external_node_module_namespaceObject.createRequire)(__rslib_import_meta_url__);
+    let pkgRoot = null;
+    try {
+        pkgRoot = (0, external_node_path_namespaceObject.dirname)(require1.resolve('@midscene/computer/package.json'));
+    } catch  {
+        const hereDir = (0, external_node_path_namespaceObject.dirname)((0, external_node_url_namespaceObject.fileURLToPath)(__rslib_import_meta_url__));
+        for (const candidate of [
+            (0, external_node_path_namespaceObject.resolve)(hereDir, '..'),
+            (0, external_node_path_namespaceObject.resolve)(hereDir, '../..')
+        ])if ((0, external_node_fs_namespaceObject.existsSync)((0, external_node_path_namespaceObject.resolve)(candidate, 'package.json'))) {
+            pkgRoot = candidate;
+            break;
+        }
+    }
+    if (!pkgRoot) {
+        debugDevice('phased-scroll: cannot locate @midscene/computer package root');
+        phasedScrollBinaryPath = null;
+        return null;
+    }
+    const binPath = (0, external_node_path_namespaceObject.resolve)(pkgRoot, 'bin/darwin/phased-scroll');
+    if (!(0, external_node_fs_namespaceObject.existsSync)(binPath)) {
+        debugDevice('phased-scroll binary not found at', binPath);
+        phasedScrollBinaryPath = null;
+        return null;
+    }
+    phasedScrollBinaryPath = binPath;
+    return binPath;
+}
+let phasedScrollExecWarned = false;
+function runPhasedScroll(direction, pixels, steps) {
+    const bin = getPhasedScrollBinary();
+    if (!bin) return false;
+    try {
+        const res = (0, external_node_child_process_namespaceObject.spawnSync)(bin, [
+            direction,
+            String(Math.max(1, Math.round(pixels))),
+            String(steps)
+        ], {
+            stdio: 'ignore'
+        });
+        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.`);
+        }
+        debugDevice('phased-scroll exited non-zero', res.status, res.error);
+        return false;
+    } catch (err) {
+        if (!phasedScrollExecWarned) {
+            phasedScrollExecWarned = true;
+            console.warn(`[@midscene/computer] phased-scroll helper failed to spawn (${err?.message}); falling back to keyboard/libnut.`);
+        }
+        debugDevice('phased-scroll spawn failed', err);
+        return false;
+    }
+}
 async function smoothMoveMouse(targetX, targetY, steps, stepDelay) {
     external_node_assert_default()(device_libnut, 'libnut not initialized');
     const currentPos = device_libnut.getMousePos();
@@ -354,7 +458,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.7.3");
+        console.log("[HealthCheck] @midscene/computer v1.7.5-beta-20260418223706.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -581,27 +685,15 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
                     device_libnut.moveMouse(Math.round(x), Math.round(y));
                 }
                 const scrollType = param?.scrollType;
-                const scrollToEdgeActions = {
-                    scrollToTop: [
-                        0,
-                        10
-                    ],
-                    scrollToBottom: [
-                        0,
-                        -10
-                    ],
-                    scrollToLeft: [
-                        -10,
-                        0
-                    ],
-                    scrollToRight: [
-                        10,
-                        0
-                    ]
-                };
-                const edgeAction = scrollToEdgeActions[scrollType || ''];
-                if (edgeAction) {
-                    const [dx, dy] = edgeAction;
+                const edgeSpec = scrollType && scrollType in EDGE_SCROLL_SPEC ? EDGE_SCROLL_SPEC[scrollType] : null;
+                if (edgeSpec) {
+                    if (runPhasedScroll(edgeSpec.direction, EDGE_SCROLL_TOTAL_PX, EDGE_SCROLL_STEPS)) return void await (0, utils_namespaceObject.sleep)(SCROLL_COMPLETE_DELAY);
+                    if (this.useAppleScript) {
+                        sendKeyViaAppleScript(edgeSpec.key);
+                        await (0, utils_namespaceObject.sleep)(SCROLL_COMPLETE_DELAY);
+                        return;
+                    }
+                    const [dx, dy] = edgeSpec.libnut;
                     for(let i = 0; i < SCROLL_REPEAT_COUNT; i++){
                         device_libnut.scrollMouse(dx, dy);
                         await (0, utils_namespaceObject.sleep)(SCROLL_STEP_DELAY);
@@ -610,8 +702,23 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
                 }
                 if ('singleAction' === scrollType || !scrollType) {
                     const distance = param?.distance || 500;
-                    const ticks = Math.ceil(distance / 100);
                     const direction = param?.direction || 'down';
+                    const isKnownDirection = 'up' === direction || 'down' === direction || 'left' === direction || 'right' === direction;
+                    if (isKnownDirection) {
+                        const steps = Math.max(PHASED_MIN_STEPS, Math.round(distance / PHASED_PIXELS_PER_STEP));
+                        if (runPhasedScroll(direction, distance, steps)) return void await (0, utils_namespaceObject.sleep)(SCROLL_COMPLETE_DELAY);
+                    }
+                    if (this.useAppleScript && ('up' === direction || 'down' === direction)) {
+                        const pages = Math.max(1, Math.round(distance / APPROX_VIEWPORT_HEIGHT_PX));
+                        const key = 'up' === direction ? 'pageup' : 'pagedown';
+                        for(let i = 0; i < pages; i++){
+                            sendKeyViaAppleScript(key);
+                            await (0, utils_namespaceObject.sleep)(SCROLL_STEP_DELAY);
+                        }
+                        await (0, utils_namespaceObject.sleep)(SCROLL_COMPLETE_DELAY);
+                        return;
+                    }
+                    const ticks = Math.ceil(distance / 100);
                     const directionMap = {
                         up: [
                             0,
@@ -837,7 +944,7 @@ class ComputerMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
 }
 const env_namespaceObject = require("@midscene/shared/env");
 function version() {
-    const currentVersion = "1.7.3";
+    const currentVersion = "1.7.5-beta-20260418223706.0";
     console.log(`@midscene/computer v${currentVersion}`);
     return currentVersion;
 }

package/dist/lib/mcp-server.js

@@ -45,7 +45,10 @@ const agent_namespaceObject = require("@midscene/core/agent");
 const external_node_assert_namespaceObject = require("node:assert");
 var external_node_assert_default = /*#__PURE__*/ __webpack_require__.n(external_node_assert_namespaceObject);
 const external_node_child_process_namespaceObject = require("node:child_process");
+const external_node_fs_namespaceObject = require("node:fs");
 const external_node_module_namespaceObject = require("node:module");
+const external_node_path_namespaceObject = require("node:path");
+const external_node_url_namespaceObject = require("node:url");
 const core_namespaceObject = require("@midscene/core");
 const device_namespaceObject = require("@midscene/core/device");
 const utils_namespaceObject = require("@midscene/core/utils");
@@ -53,7 +56,6 @@ const img_namespaceObject = require("@midscene/shared/img");
 const logger_namespaceObject = require("@midscene/shared/logger");
 const external_screenshot_desktop_namespaceObject = require("screenshot-desktop");
 var external_screenshot_desktop_default = /*#__PURE__*/ __webpack_require__.n(external_screenshot_desktop_namespaceObject);
-const external_node_fs_namespaceObject = require("node:fs");
 const debugXvfb = (0, logger_namespaceObject.getDebug)('computer:xvfb');
 function checkXvfbInstalled() {
     try {
@@ -151,6 +153,45 @@ 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 APPROX_VIEWPORT_HEIGHT_PX = 600;
+const EDGE_SCROLL_SPEC = {
+    scrollToTop: {
+        direction: 'up',
+        key: 'home',
+        libnut: [
+            0,
+            10
+        ]
+    },
+    scrollToBottom: {
+        direction: 'down',
+        key: 'end',
+        libnut: [
+            0,
+            -10
+        ]
+    },
+    scrollToLeft: {
+        direction: 'left',
+        key: 'home',
+        libnut: [
+            -10,
+            0
+        ]
+    },
+    scrollToRight: {
+        direction: 'right',
+        key: 'end',
+        libnut: [
+            10,
+            0
+        ]
+    }
+};
 const APPLESCRIPT_KEY_CODE_MAP = {
     return: 36,
     enter: 36,
@@ -229,6 +270,69 @@ async function getLibnut() {
     }
 }
 const debugDevice = (0, logger_namespaceObject.getDebug)('computer:device');
+let phasedScrollBinaryPath;
+function getPhasedScrollBinary() {
+    if (void 0 !== phasedScrollBinaryPath) return phasedScrollBinaryPath;
+    if ('darwin' !== process.platform) {
+        phasedScrollBinaryPath = null;
+        return null;
+    }
+    const require1 = (0, external_node_module_namespaceObject.createRequire)(__rslib_import_meta_url__);
+    let pkgRoot = null;
+    try {
+        pkgRoot = (0, external_node_path_namespaceObject.dirname)(require1.resolve('@midscene/computer/package.json'));
+    } catch  {
+        const hereDir = (0, external_node_path_namespaceObject.dirname)((0, external_node_url_namespaceObject.fileURLToPath)(__rslib_import_meta_url__));
+        for (const candidate of [
+            (0, external_node_path_namespaceObject.resolve)(hereDir, '..'),
+            (0, external_node_path_namespaceObject.resolve)(hereDir, '../..')
+        ])if ((0, external_node_fs_namespaceObject.existsSync)((0, external_node_path_namespaceObject.resolve)(candidate, 'package.json'))) {
+            pkgRoot = candidate;
+            break;
+        }
+    }
+    if (!pkgRoot) {
+        debugDevice('phased-scroll: cannot locate @midscene/computer package root');
+        phasedScrollBinaryPath = null;
+        return null;
+    }
+    const binPath = (0, external_node_path_namespaceObject.resolve)(pkgRoot, 'bin/darwin/phased-scroll');
+    if (!(0, external_node_fs_namespaceObject.existsSync)(binPath)) {
+        debugDevice('phased-scroll binary not found at', binPath);
+        phasedScrollBinaryPath = null;
+        return null;
+    }
+    phasedScrollBinaryPath = binPath;
+    return binPath;
+}
+let phasedScrollExecWarned = false;
+function runPhasedScroll(direction, pixels, steps) {
+    const bin = getPhasedScrollBinary();
+    if (!bin) return false;
+    try {
+        const res = (0, external_node_child_process_namespaceObject.spawnSync)(bin, [
+            direction,
+            String(Math.max(1, Math.round(pixels))),
+            String(steps)
+        ], {
+            stdio: 'ignore'
+        });
+        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.`);
+        }
+        debugDevice('phased-scroll exited non-zero', res.status, res.error);
+        return false;
+    } catch (err) {
+        if (!phasedScrollExecWarned) {
+            phasedScrollExecWarned = true;
+            console.warn(`[@midscene/computer] phased-scroll helper failed to spawn (${err?.message}); falling back to keyboard/libnut.`);
+        }
+        debugDevice('phased-scroll spawn failed', err);
+        return false;
+    }
+}
 async function smoothMoveMouse(targetX, targetY, steps, stepDelay) {
     external_node_assert_default()(libnut, 'libnut not initialized');
     const currentPos = libnut.getMousePos();
@@ -348,7 +452,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.7.3");
+        console.log("[HealthCheck] @midscene/computer v1.7.5-beta-20260418223706.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -575,27 +679,15 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
                     libnut.moveMouse(Math.round(x), Math.round(y));
                 }
                 const scrollType = param?.scrollType;
-                const scrollToEdgeActions = {
-                    scrollToTop: [
-                        0,
-                        10
-                    ],
-                    scrollToBottom: [
-                        0,
-                        -10
-                    ],
-                    scrollToLeft: [
-                        -10,
-                        0
-                    ],
-                    scrollToRight: [
-                        10,
-                        0
-                    ]
-                };
-                const edgeAction = scrollToEdgeActions[scrollType || ''];
-                if (edgeAction) {
-                    const [dx, dy] = edgeAction;
+                const edgeSpec = scrollType && scrollType in EDGE_SCROLL_SPEC ? EDGE_SCROLL_SPEC[scrollType] : null;
+                if (edgeSpec) {
+                    if (runPhasedScroll(edgeSpec.direction, EDGE_SCROLL_TOTAL_PX, EDGE_SCROLL_STEPS)) return void await (0, utils_namespaceObject.sleep)(SCROLL_COMPLETE_DELAY);
+                    if (this.useAppleScript) {
+                        sendKeyViaAppleScript(edgeSpec.key);
+                        await (0, utils_namespaceObject.sleep)(SCROLL_COMPLETE_DELAY);
+                        return;
+                    }
+                    const [dx, dy] = edgeSpec.libnut;
                     for(let i = 0; i < SCROLL_REPEAT_COUNT; i++){
                         libnut.scrollMouse(dx, dy);
                         await (0, utils_namespaceObject.sleep)(SCROLL_STEP_DELAY);
@@ -604,8 +696,23 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
                 }
                 if ('singleAction' === scrollType || !scrollType) {
                     const distance = param?.distance || 500;
-                    const ticks = Math.ceil(distance / 100);
                     const direction = param?.direction || 'down';
+                    const isKnownDirection = 'up' === direction || 'down' === direction || 'left' === direction || 'right' === direction;
+                    if (isKnownDirection) {
+                        const steps = Math.max(PHASED_MIN_STEPS, Math.round(distance / PHASED_PIXELS_PER_STEP));
+                        if (runPhasedScroll(direction, distance, steps)) return void await (0, utils_namespaceObject.sleep)(SCROLL_COMPLETE_DELAY);
+                    }
+                    if (this.useAppleScript && ('up' === direction || 'down' === direction)) {
+                        const pages = Math.max(1, Math.round(distance / APPROX_VIEWPORT_HEIGHT_PX));
+                        const key = 'up' === direction ? 'pageup' : 'pagedown';
+                        for(let i = 0; i < pages; i++){
+                            sendKeyViaAppleScript(key);
+                            await (0, utils_namespaceObject.sleep)(SCROLL_STEP_DELAY);
+                        }
+                        await (0, utils_namespaceObject.sleep)(SCROLL_COMPLETE_DELAY);
+                        return;
+                    }
+                    const ticks = Math.ceil(distance / 100);
                     const directionMap = {
                         up: [
                             0,
@@ -834,7 +941,7 @@ class ComputerMCPServer extends mcp_namespaceObject.BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/computer-mcp',
-            version: "1.7.3",
+            version: "1.7.5-beta-20260418223706.0",
             description: 'Control the computer desktop using natural language commands'
         }, toolsManager);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/computer",
-  "version": "1.7.3",
+  "version": "1.7.5-beta-20260418223706.0",
   "description": "Midscene.js Computer Desktop Automation",
   "license": "MIT",
   "repository": {
@@ -36,8 +36,8 @@
     "@computer-use/libnut": "^4.2.0",
     "clipboardy": "^4.0.0",
     "screenshot-desktop": "^1.15.3",
-    "@midscene/core": "1.7.3",
-    "@midscene/shared": "1.7.3"
+    "@midscene/core": "1.7.5-beta-20260418223706.0",
+    "@midscene/shared": "1.7.5-beta-20260418223706.0"
   },
   "optionalDependencies": {
     "node-mac-permissions": "2.5.0"
@@ -53,6 +53,7 @@
   },
   "scripts": {
     "build": "rslib build",
+    "build:native": "mkdir -p bin/darwin && clang -O2 -arch arm64 -arch x86_64 -framework ApplicationServices -o bin/darwin/phased-scroll native/phased-scroll.m",
     "dev": "rslib build --watch",
     "test": "vitest run",
     "test:ai": "AI_TEST_TYPE=computer vitest run"