@midscene/harmony 1.6.0 → 1.6.1-beta-20260327104111.0

package/dist/es/bin.mjs

@@ -261,11 +261,12 @@ const harmonyInputParamSchema = z.object({
     locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
 });
 const defaultScrollUntilTimes = 10;
-const defaultSwipeSpeed = 600;
 const defaultFastSwipeSpeed = 2000;
 const maxScrollDistance = 9999999;
 const scrollQuadrantDivisions = 4;
+const screenEdgeMargin = 50;
 const debugDevice = getDebug('harmony:device');
+let screenshotResizeScaleWarned = false;
 const harmonyKeyCodeMap = {
     Enter: '2054',
     Backspace: '2055',
@@ -484,12 +485,9 @@ class device_HarmonyDevice {
     }
     async size() {
         const screenInfo = await this.getScreenSize();
-        const scale = this.options?.screenshotResizeScale ?? 1;
-        const logicalWidth = Math.round(screenInfo.width * scale);
-        const logicalHeight = Math.round(screenInfo.height * scale);
         return {
-            width: logicalWidth,
-            height: logicalHeight
+            width: screenInfo.width,
+            height: screenInfo.height
         };
     }
     async screenshotBase64() {
@@ -587,10 +585,10 @@ class device_HarmonyDevice {
         const maxNegativeDeltaY = height - startY;
         deltaX = Math.max(-maxNegativeDeltaX, Math.min(deltaX, maxPositiveDeltaX));
         deltaY = Math.max(-maxNegativeDeltaY, Math.min(deltaY, maxPositiveDeltaY));
-        const endX = Math.round(startX - deltaX);
-        const endY = Math.round(startY - deltaY);
+        const endX = Math.round(Math.max(screenEdgeMargin, Math.min(width - screenEdgeMargin, startX - deltaX)));
+        const endY = Math.round(Math.max(screenEdgeMargin, Math.min(height - screenEdgeMargin, startY - deltaY)));
         const hdc = await this.getHdc();
-        await hdc.swipe(startX, startY, endX, endY, speed ?? defaultSwipeSpeed);
+        await hdc.fling(startX, startY, endX, endY, speed ?? defaultFastSwipeSpeed);
     }
     async scrollInDirection(direction, distance, startPoint) {
         const { width, height } = await this.size();
@@ -603,23 +601,23 @@ class device_HarmonyDevice {
             const endPoints = {
                 down: {
                     x: sx,
-                    y: Math.max(0, sy - scrollDistance)
+                    y: Math.max(screenEdgeMargin, sy - scrollDistance)
                 },
                 up: {
                     x: sx,
-                    y: Math.min(height, sy + scrollDistance)
+                    y: Math.min(height - screenEdgeMargin, sy + scrollDistance)
                 },
                 left: {
-                    x: Math.min(width, sx + scrollDistance),
+                    x: Math.min(width - screenEdgeMargin, sx + scrollDistance),
                     y: sy
                 },
                 right: {
-                    x: Math.max(0, sx - scrollDistance),
+                    x: Math.max(screenEdgeMargin, sx - scrollDistance),
                     y: sy
                 }
             };
             const end = endPoints[direction];
-            await hdc.swipe(sx, sy, end.x, end.y);
+            await hdc.fling(sx, sy, end.x, end.y, defaultFastSwipeSpeed);
             return;
         }
         const deltas = {
@@ -664,18 +662,18 @@ class device_HarmonyDevice {
             const flingTargets = {
                 up: {
                     x: sx,
-                    y: Math.round(height)
+                    y: Math.round(height) - screenEdgeMargin
                 },
                 down: {
                     x: sx,
-                    y: 0
+                    y: screenEdgeMargin
                 },
                 left: {
-                    x: Math.round(width),
+                    x: Math.round(width) - screenEdgeMargin,
                     y: sy
                 },
                 right: {
-                    x: 0,
+                    x: screenEdgeMargin,
                     y: sy
                 }
             };
@@ -773,6 +771,10 @@ class device_HarmonyDevice {
         this.deviceId = deviceId;
         this.options = options;
         this.customActions = options?.customActions;
+        if (options?.screenshotResizeScale !== void 0 && !screenshotResizeScaleWarned) {
+            screenshotResizeScaleWarned = true;
+            console.warn('[midscene] screenshotResizeScale is deprecated. Use screenshotShrinkFactor in AgentOpt instead.');
+        }
     }
 }
 const runHdcShellParamSchema = z.object({

package/dist/es/cli.mjs

@@ -258,11 +258,12 @@ const harmonyInputParamSchema = z.object({
     locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
 });
 const defaultScrollUntilTimes = 10;
-const defaultSwipeSpeed = 600;
 const defaultFastSwipeSpeed = 2000;
 const maxScrollDistance = 9999999;
 const scrollQuadrantDivisions = 4;
+const screenEdgeMargin = 50;
 const debugDevice = getDebug('harmony:device');
+let screenshotResizeScaleWarned = false;
 const harmonyKeyCodeMap = {
     Enter: '2054',
     Backspace: '2055',
@@ -481,12 +482,9 @@ class HarmonyDevice {
     }
     async size() {
         const screenInfo = await this.getScreenSize();
-        const scale = this.options?.screenshotResizeScale ?? 1;
-        const logicalWidth = Math.round(screenInfo.width * scale);
-        const logicalHeight = Math.round(screenInfo.height * scale);
         return {
-            width: logicalWidth,
-            height: logicalHeight
+            width: screenInfo.width,
+            height: screenInfo.height
         };
     }
     async screenshotBase64() {
@@ -584,10 +582,10 @@ class HarmonyDevice {
         const maxNegativeDeltaY = height - startY;
         deltaX = Math.max(-maxNegativeDeltaX, Math.min(deltaX, maxPositiveDeltaX));
         deltaY = Math.max(-maxNegativeDeltaY, Math.min(deltaY, maxPositiveDeltaY));
-        const endX = Math.round(startX - deltaX);
-        const endY = Math.round(startY - deltaY);
+        const endX = Math.round(Math.max(screenEdgeMargin, Math.min(width - screenEdgeMargin, startX - deltaX)));
+        const endY = Math.round(Math.max(screenEdgeMargin, Math.min(height - screenEdgeMargin, startY - deltaY)));
         const hdc = await this.getHdc();
-        await hdc.swipe(startX, startY, endX, endY, speed ?? defaultSwipeSpeed);
+        await hdc.fling(startX, startY, endX, endY, speed ?? defaultFastSwipeSpeed);
     }
     async scrollInDirection(direction, distance, startPoint) {
         const { width, height } = await this.size();
@@ -600,23 +598,23 @@ class HarmonyDevice {
             const endPoints = {
                 down: {
                     x: sx,
-                    y: Math.max(0, sy - scrollDistance)
+                    y: Math.max(screenEdgeMargin, sy - scrollDistance)
                 },
                 up: {
                     x: sx,
-                    y: Math.min(height, sy + scrollDistance)
+                    y: Math.min(height - screenEdgeMargin, sy + scrollDistance)
                 },
                 left: {
-                    x: Math.min(width, sx + scrollDistance),
+                    x: Math.min(width - screenEdgeMargin, sx + scrollDistance),
                     y: sy
                 },
                 right: {
-                    x: Math.max(0, sx - scrollDistance),
+                    x: Math.max(screenEdgeMargin, sx - scrollDistance),
                     y: sy
                 }
             };
             const end = endPoints[direction];
-            await hdc.swipe(sx, sy, end.x, end.y);
+            await hdc.fling(sx, sy, end.x, end.y, defaultFastSwipeSpeed);
             return;
         }
         const deltas = {
@@ -661,18 +659,18 @@ class HarmonyDevice {
             const flingTargets = {
                 up: {
                     x: sx,
-                    y: Math.round(height)
+                    y: Math.round(height) - screenEdgeMargin
                 },
                 down: {
                     x: sx,
-                    y: 0
+                    y: screenEdgeMargin
                 },
                 left: {
-                    x: Math.round(width),
+                    x: Math.round(width) - screenEdgeMargin,
                     y: sy
                 },
                 right: {
-                    x: 0,
+                    x: screenEdgeMargin,
                     y: sy
                 }
             };
@@ -770,6 +768,10 @@ class HarmonyDevice {
         this.deviceId = deviceId;
         this.options = options;
         this.customActions = options?.customActions;
+        if (options?.screenshotResizeScale !== void 0 && !screenshotResizeScaleWarned) {
+            screenshotResizeScaleWarned = true;
+            console.warn('[midscene] screenshotResizeScale is deprecated. Use screenshotShrinkFactor in AgentOpt instead.');
+        }
     }
 }
 const runHdcShellParamSchema = z.object({
@@ -952,7 +954,7 @@ class HarmonyMidsceneTools extends BaseMidsceneTools {
 const tools = new HarmonyMidsceneTools();
 runToolsCLI(tools, 'midscene-harmony', {
     stripPrefix: 'harmony_',
-    version: "1.6.0"
+    version: "1.6.1-beta-20260327104111.0"
 }).catch((e)=>{
     if (!(e instanceof CLIError)) console.error(e);
     process.exit(e instanceof CLIError ? e.exitCode : 1);

package/dist/es/index.mjs

@@ -230,11 +230,12 @@ const harmonyInputParamSchema = z.object({
     locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
 });
 const defaultScrollUntilTimes = 10;
-const defaultSwipeSpeed = 600;
 const defaultFastSwipeSpeed = 2000;
 const maxScrollDistance = 9999999;
 const scrollQuadrantDivisions = 4;
+const screenEdgeMargin = 50;
 const debugDevice = getDebug('harmony:device');
+let screenshotResizeScaleWarned = false;
 const harmonyKeyCodeMap = {
     Enter: '2054',
     Backspace: '2055',
@@ -453,12 +454,9 @@ class HarmonyDevice {
     }
     async size() {
         const screenInfo = await this.getScreenSize();
-        const scale = this.options?.screenshotResizeScale ?? 1;
-        const logicalWidth = Math.round(screenInfo.width * scale);
-        const logicalHeight = Math.round(screenInfo.height * scale);
         return {
-            width: logicalWidth,
-            height: logicalHeight
+            width: screenInfo.width,
+            height: screenInfo.height
         };
     }
     async screenshotBase64() {
@@ -556,10 +554,10 @@ class HarmonyDevice {
         const maxNegativeDeltaY = height - startY;
         deltaX = Math.max(-maxNegativeDeltaX, Math.min(deltaX, maxPositiveDeltaX));
         deltaY = Math.max(-maxNegativeDeltaY, Math.min(deltaY, maxPositiveDeltaY));
-        const endX = Math.round(startX - deltaX);
-        const endY = Math.round(startY - deltaY);
+        const endX = Math.round(Math.max(screenEdgeMargin, Math.min(width - screenEdgeMargin, startX - deltaX)));
+        const endY = Math.round(Math.max(screenEdgeMargin, Math.min(height - screenEdgeMargin, startY - deltaY)));
         const hdc = await this.getHdc();
-        await hdc.swipe(startX, startY, endX, endY, speed ?? defaultSwipeSpeed);
+        await hdc.fling(startX, startY, endX, endY, speed ?? defaultFastSwipeSpeed);
     }
     async scrollInDirection(direction, distance, startPoint) {
         const { width, height } = await this.size();
@@ -572,23 +570,23 @@ class HarmonyDevice {
             const endPoints = {
                 down: {
                     x: sx,
-                    y: Math.max(0, sy - scrollDistance)
+                    y: Math.max(screenEdgeMargin, sy - scrollDistance)
                 },
                 up: {
                     x: sx,
-                    y: Math.min(height, sy + scrollDistance)
+                    y: Math.min(height - screenEdgeMargin, sy + scrollDistance)
                 },
                 left: {
-                    x: Math.min(width, sx + scrollDistance),
+                    x: Math.min(width - screenEdgeMargin, sx + scrollDistance),
                     y: sy
                 },
                 right: {
-                    x: Math.max(0, sx - scrollDistance),
+                    x: Math.max(screenEdgeMargin, sx - scrollDistance),
                     y: sy
                 }
             };
             const end = endPoints[direction];
-            await hdc.swipe(sx, sy, end.x, end.y);
+            await hdc.fling(sx, sy, end.x, end.y, defaultFastSwipeSpeed);
             return;
         }
         const deltas = {
@@ -633,18 +631,18 @@ class HarmonyDevice {
             const flingTargets = {
                 up: {
                     x: sx,
-                    y: Math.round(height)
+                    y: Math.round(height) - screenEdgeMargin
                 },
                 down: {
                     x: sx,
-                    y: 0
+                    y: screenEdgeMargin
                 },
                 left: {
-                    x: Math.round(width),
+                    x: Math.round(width) - screenEdgeMargin,
                     y: sy
                 },
                 right: {
-                    x: 0,
+                    x: screenEdgeMargin,
                     y: sy
                 }
             };
@@ -742,6 +740,10 @@ class HarmonyDevice {
         this.deviceId = deviceId;
         this.options = options;
         this.customActions = options?.customActions;
+        if (options?.screenshotResizeScale !== void 0 && !screenshotResizeScaleWarned) {
+            screenshotResizeScaleWarned = true;
+            console.warn('[midscene] screenshotResizeScale is deprecated. Use screenshotShrinkFactor in AgentOpt instead.');
+        }
     }
 }
 const runHdcShellParamSchema = z.object({

package/dist/es/mcp-server.mjs

@@ -257,11 +257,12 @@ const harmonyInputParamSchema = z.object({
     locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
 });
 const defaultScrollUntilTimes = 10;
-const defaultSwipeSpeed = 600;
 const defaultFastSwipeSpeed = 2000;
 const maxScrollDistance = 9999999;
 const scrollQuadrantDivisions = 4;
+const screenEdgeMargin = 50;
 const debugDevice = getDebug('harmony:device');
+let screenshotResizeScaleWarned = false;
 const harmonyKeyCodeMap = {
     Enter: '2054',
     Backspace: '2055',
@@ -480,12 +481,9 @@ class HarmonyDevice {
     }
     async size() {
         const screenInfo = await this.getScreenSize();
-        const scale = this.options?.screenshotResizeScale ?? 1;
-        const logicalWidth = Math.round(screenInfo.width * scale);
-        const logicalHeight = Math.round(screenInfo.height * scale);
         return {
-            width: logicalWidth,
-            height: logicalHeight
+            width: screenInfo.width,
+            height: screenInfo.height
         };
     }
     async screenshotBase64() {
@@ -583,10 +581,10 @@ class HarmonyDevice {
         const maxNegativeDeltaY = height - startY;
         deltaX = Math.max(-maxNegativeDeltaX, Math.min(deltaX, maxPositiveDeltaX));
         deltaY = Math.max(-maxNegativeDeltaY, Math.min(deltaY, maxPositiveDeltaY));
-        const endX = Math.round(startX - deltaX);
-        const endY = Math.round(startY - deltaY);
+        const endX = Math.round(Math.max(screenEdgeMargin, Math.min(width - screenEdgeMargin, startX - deltaX)));
+        const endY = Math.round(Math.max(screenEdgeMargin, Math.min(height - screenEdgeMargin, startY - deltaY)));
         const hdc = await this.getHdc();
-        await hdc.swipe(startX, startY, endX, endY, speed ?? defaultSwipeSpeed);
+        await hdc.fling(startX, startY, endX, endY, speed ?? defaultFastSwipeSpeed);
     }
     async scrollInDirection(direction, distance, startPoint) {
         const { width, height } = await this.size();
@@ -599,23 +597,23 @@ class HarmonyDevice {
             const endPoints = {
                 down: {
                     x: sx,
-                    y: Math.max(0, sy - scrollDistance)
+                    y: Math.max(screenEdgeMargin, sy - scrollDistance)
                 },
                 up: {
                     x: sx,
-                    y: Math.min(height, sy + scrollDistance)
+                    y: Math.min(height - screenEdgeMargin, sy + scrollDistance)
                 },
                 left: {
-                    x: Math.min(width, sx + scrollDistance),
+                    x: Math.min(width - screenEdgeMargin, sx + scrollDistance),
                     y: sy
                 },
                 right: {
-                    x: Math.max(0, sx - scrollDistance),
+                    x: Math.max(screenEdgeMargin, sx - scrollDistance),
                     y: sy
                 }
             };
             const end = endPoints[direction];
-            await hdc.swipe(sx, sy, end.x, end.y);
+            await hdc.fling(sx, sy, end.x, end.y, defaultFastSwipeSpeed);
             return;
         }
         const deltas = {
@@ -660,18 +658,18 @@ class HarmonyDevice {
             const flingTargets = {
                 up: {
                     x: sx,
-                    y: Math.round(height)
+                    y: Math.round(height) - screenEdgeMargin
                 },
                 down: {
                     x: sx,
-                    y: 0
+                    y: screenEdgeMargin
                 },
                 left: {
-                    x: Math.round(width),
+                    x: Math.round(width) - screenEdgeMargin,
                     y: sy
                 },
                 right: {
-                    x: 0,
+                    x: screenEdgeMargin,
                     y: sy
                 }
             };
@@ -769,6 +767,10 @@ class HarmonyDevice {
         this.deviceId = deviceId;
         this.options = options;
         this.customActions = options?.customActions;
+        if (options?.screenshotResizeScale !== void 0 && !screenshotResizeScaleWarned) {
+            screenshotResizeScaleWarned = true;
+            console.warn('[midscene] screenshotResizeScale is deprecated. Use screenshotShrinkFactor in AgentOpt instead.');
+        }
     }
 }
 const runHdcShellParamSchema = z.object({
@@ -955,7 +957,7 @@ class HarmonyMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/harmony-mcp',
-            version: "1.6.0",
+            version: "1.6.1-beta-20260327104111.0",
             description: 'Control the HarmonyOS device using natural language commands'
         }, toolsManager);
     }

package/dist/lib/bin.js

@@ -287,11 +287,12 @@ const harmonyInputParamSchema = core_namespaceObject.z.object({
     locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
 });
 const defaultScrollUntilTimes = 10;
-const defaultSwipeSpeed = 600;
 const defaultFastSwipeSpeed = 2000;
 const maxScrollDistance = 9999999;
 const scrollQuadrantDivisions = 4;
+const screenEdgeMargin = 50;
 const debugDevice = (0, logger_namespaceObject.getDebug)('harmony:device');
+let screenshotResizeScaleWarned = false;
 const harmonyKeyCodeMap = {
     Enter: '2054',
     Backspace: '2055',
@@ -510,12 +511,9 @@ class device_HarmonyDevice {
     }
     async size() {
         const screenInfo = await this.getScreenSize();
-        const scale = this.options?.screenshotResizeScale ?? 1;
-        const logicalWidth = Math.round(screenInfo.width * scale);
-        const logicalHeight = Math.round(screenInfo.height * scale);
         return {
-            width: logicalWidth,
-            height: logicalHeight
+            width: screenInfo.width,
+            height: screenInfo.height
         };
     }
     async screenshotBase64() {
@@ -613,10 +611,10 @@ class device_HarmonyDevice {
         const maxNegativeDeltaY = height - startY;
         deltaX = Math.max(-maxNegativeDeltaX, Math.min(deltaX, maxPositiveDeltaX));
         deltaY = Math.max(-maxNegativeDeltaY, Math.min(deltaY, maxPositiveDeltaY));
-        const endX = Math.round(startX - deltaX);
-        const endY = Math.round(startY - deltaY);
+        const endX = Math.round(Math.max(screenEdgeMargin, Math.min(width - screenEdgeMargin, startX - deltaX)));
+        const endY = Math.round(Math.max(screenEdgeMargin, Math.min(height - screenEdgeMargin, startY - deltaY)));
         const hdc = await this.getHdc();
-        await hdc.swipe(startX, startY, endX, endY, speed ?? defaultSwipeSpeed);
+        await hdc.fling(startX, startY, endX, endY, speed ?? defaultFastSwipeSpeed);
     }
     async scrollInDirection(direction, distance, startPoint) {
         const { width, height } = await this.size();
@@ -629,23 +627,23 @@ class device_HarmonyDevice {
             const endPoints = {
                 down: {
                     x: sx,
-                    y: Math.max(0, sy - scrollDistance)
+                    y: Math.max(screenEdgeMargin, sy - scrollDistance)
                 },
                 up: {
                     x: sx,
-                    y: Math.min(height, sy + scrollDistance)
+                    y: Math.min(height - screenEdgeMargin, sy + scrollDistance)
                 },
                 left: {
-                    x: Math.min(width, sx + scrollDistance),
+                    x: Math.min(width - screenEdgeMargin, sx + scrollDistance),
                     y: sy
                 },
                 right: {
-                    x: Math.max(0, sx - scrollDistance),
+                    x: Math.max(screenEdgeMargin, sx - scrollDistance),
                     y: sy
                 }
             };
             const end = endPoints[direction];
-            await hdc.swipe(sx, sy, end.x, end.y);
+            await hdc.fling(sx, sy, end.x, end.y, defaultFastSwipeSpeed);
             return;
         }
         const deltas = {
@@ -690,18 +688,18 @@ class device_HarmonyDevice {
             const flingTargets = {
                 up: {
                     x: sx,
-                    y: Math.round(height)
+                    y: Math.round(height) - screenEdgeMargin
                 },
                 down: {
                     x: sx,
-                    y: 0
+                    y: screenEdgeMargin
                 },
                 left: {
-                    x: Math.round(width),
+                    x: Math.round(width) - screenEdgeMargin,
                     y: sy
                 },
                 right: {
-                    x: 0,
+                    x: screenEdgeMargin,
                     y: sy
                 }
             };
@@ -799,6 +797,10 @@ class device_HarmonyDevice {
         this.deviceId = deviceId;
         this.options = options;
         this.customActions = options?.customActions;
+        if (options?.screenshotResizeScale !== void 0 && !screenshotResizeScaleWarned) {
+            screenshotResizeScaleWarned = true;
+            console.warn('[midscene] screenshotResizeScale is deprecated. Use screenshotShrinkFactor in AgentOpt instead.');
+        }
     }
 }
 const runHdcShellParamSchema = core_namespaceObject.z.object({

package/dist/lib/cli.js

@@ -283,11 +283,12 @@ const harmonyInputParamSchema = core_namespaceObject.z.object({
     locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
 });
 const defaultScrollUntilTimes = 10;
-const defaultSwipeSpeed = 600;
 const defaultFastSwipeSpeed = 2000;
 const maxScrollDistance = 9999999;
 const scrollQuadrantDivisions = 4;
+const screenEdgeMargin = 50;
 const debugDevice = (0, logger_namespaceObject.getDebug)('harmony:device');
+let screenshotResizeScaleWarned = false;
 const harmonyKeyCodeMap = {
     Enter: '2054',
     Backspace: '2055',
@@ -506,12 +507,9 @@ class HarmonyDevice {
     }
     async size() {
         const screenInfo = await this.getScreenSize();
-        const scale = this.options?.screenshotResizeScale ?? 1;
-        const logicalWidth = Math.round(screenInfo.width * scale);
-        const logicalHeight = Math.round(screenInfo.height * scale);
         return {
-            width: logicalWidth,
-            height: logicalHeight
+            width: screenInfo.width,
+            height: screenInfo.height
         };
     }
     async screenshotBase64() {
@@ -609,10 +607,10 @@ class HarmonyDevice {
         const maxNegativeDeltaY = height - startY;
         deltaX = Math.max(-maxNegativeDeltaX, Math.min(deltaX, maxPositiveDeltaX));
         deltaY = Math.max(-maxNegativeDeltaY, Math.min(deltaY, maxPositiveDeltaY));
-        const endX = Math.round(startX - deltaX);
-        const endY = Math.round(startY - deltaY);
+        const endX = Math.round(Math.max(screenEdgeMargin, Math.min(width - screenEdgeMargin, startX - deltaX)));
+        const endY = Math.round(Math.max(screenEdgeMargin, Math.min(height - screenEdgeMargin, startY - deltaY)));
         const hdc = await this.getHdc();
-        await hdc.swipe(startX, startY, endX, endY, speed ?? defaultSwipeSpeed);
+        await hdc.fling(startX, startY, endX, endY, speed ?? defaultFastSwipeSpeed);
     }
     async scrollInDirection(direction, distance, startPoint) {
         const { width, height } = await this.size();
@@ -625,23 +623,23 @@ class HarmonyDevice {
             const endPoints = {
                 down: {
                     x: sx,
-                    y: Math.max(0, sy - scrollDistance)
+                    y: Math.max(screenEdgeMargin, sy - scrollDistance)
                 },
                 up: {
                     x: sx,
-                    y: Math.min(height, sy + scrollDistance)
+                    y: Math.min(height - screenEdgeMargin, sy + scrollDistance)
                 },
                 left: {
-                    x: Math.min(width, sx + scrollDistance),
+                    x: Math.min(width - screenEdgeMargin, sx + scrollDistance),
                     y: sy
                 },
                 right: {
-                    x: Math.max(0, sx - scrollDistance),
+                    x: Math.max(screenEdgeMargin, sx - scrollDistance),
                     y: sy
                 }
             };
             const end = endPoints[direction];
-            await hdc.swipe(sx, sy, end.x, end.y);
+            await hdc.fling(sx, sy, end.x, end.y, defaultFastSwipeSpeed);
             return;
         }
         const deltas = {
@@ -686,18 +684,18 @@ class HarmonyDevice {
             const flingTargets = {
                 up: {
                     x: sx,
-                    y: Math.round(height)
+                    y: Math.round(height) - screenEdgeMargin
                 },
                 down: {
                     x: sx,
-                    y: 0
+                    y: screenEdgeMargin
                 },
                 left: {
-                    x: Math.round(width),
+                    x: Math.round(width) - screenEdgeMargin,
                     y: sy
                 },
                 right: {
-                    x: 0,
+                    x: screenEdgeMargin,
                     y: sy
                 }
             };
@@ -795,6 +793,10 @@ class HarmonyDevice {
         this.deviceId = deviceId;
         this.options = options;
         this.customActions = options?.customActions;
+        if (options?.screenshotResizeScale !== void 0 && !screenshotResizeScaleWarned) {
+            screenshotResizeScaleWarned = true;
+            console.warn('[midscene] screenshotResizeScale is deprecated. Use screenshotShrinkFactor in AgentOpt instead.');
+        }
     }
 }
 const runHdcShellParamSchema = core_namespaceObject.z.object({
@@ -977,7 +979,7 @@ class HarmonyMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
 const tools = new HarmonyMidsceneTools();
 (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-harmony', {
     stripPrefix: 'harmony_',
-    version: "1.6.0"
+    version: "1.6.1-beta-20260327104111.0"
 }).catch((e)=>{
     if (!(e instanceof cli_namespaceObject.CLIError)) console.error(e);
     process.exit(e instanceof cli_namespaceObject.CLIError ? e.exitCode : 1);