ms-vite-plugin 1.3.3 → 1.3.4

package/docs/api/hid.md

@@ -775,7 +775,6 @@ function pressButton(
     | "brightnessup"
     | "brightnessdown"
     | "power"
-    | "menu"
     | "snapshot",
 ): boolean;
 ```
@@ -784,7 +783,7 @@ function pressButton(
 
 | 参数名   | 类型   | 是否必填 | 默认值 | 描述                                                                                                                     |
 | -------- | ------ | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
-| `button` | string | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"mute"` 静音键 <br>- `"playpause"` 播放/暂停键 <br>- `"next"` 下一首/下一章节 <br>- `"prev"` 上一首/上一章节 <br>- `"eject"` 显示/隐藏键盘 <br>- `"globe"` Globe 键 <br>- `"search"` 搜索键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 <br>- `"power"` 电源/锁屏键 <br>- `"menu"` Home/Menu 键 <br>- `"snapshot"` 系统截图键 |
+| `button` | string | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"mute"` 静音键 <br>- `"playpause"` 播放/暂停键 <br>- `"next"` 下一首/下一章节 <br>- `"prev"` 上一首/上一章节 <br>- `"eject"` 显示/隐藏键盘 <br>- `"globe"` Globe 键 <br>- `"search"` 搜索键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 <br>- `"power"` 电源/锁屏键 <br>- `"snapshot"` 系统截图键 |
 
 **返回值：**
 
@@ -908,7 +907,7 @@ hid.back();
 
 ### recent - 最近应用
 
-显示 APP 切换器
+双击 Home 显示 APP 切换器。
 
 ```typescript
 function recent(): boolean;

package/docs/apicn/hid.md

@@ -775,7 +775,6 @@ function 按键(
     | "brightnessup"
     | "brightnessdown"
     | "power"
-    | "menu"
     | "snapshot",
 ): 布尔值;
 ```
@@ -784,7 +783,7 @@ function 按键(
 
 | 参数名 | 类型   | 是否必填 | 默认值 | 描述                                                                                                                     |
 | ------ | ------ | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
-| `按键` | 字符串 | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"mute"` 静音键 <br>- `"playpause"` 播放/暂停键 <br>- `"next"` 下一首/下一章节 <br>- `"prev"` 上一首/上一章节 <br>- `"eject"` 显示/隐藏键盘 <br>- `"globe"` Globe 键 <br>- `"search"` 搜索键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 <br>- `"power"` 电源/锁屏键 <br>- `"menu"` Home/Menu 键 <br>- `"snapshot"` 系统截图键 |
+| `按键` | 字符串 | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"mute"` 静音键 <br>- `"playpause"` 播放/暂停键 <br>- `"next"` 下一首/下一章节 <br>- `"prev"` 上一首/上一章节 <br>- `"eject"` 显示/隐藏键盘 <br>- `"globe"` Globe 键 <br>- `"search"` 搜索键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 <br>- `"power"` 电源/锁屏键 <br>- `"snapshot"` 系统截图键 |
 
 **返回值：**
 
@@ -911,7 +910,7 @@ $HID.返回();
 
 ### 最近应用
 
-显示 APP 切换器
+双击 Home 显示 APP 切换器。
 
 ```typescript
 function 最近应用(): 布尔值;

package/docs/apipython/hid.md

@@ -800,7 +800,6 @@ def pressButton(
         "brightnessup",
         "brightnessdown",
         "power",
-        "menu",
         "snapshot",
     ],
 ) -> bool
@@ -810,7 +809,7 @@ def pressButton(
 
 | 参数名   | 类型    | 是否必填 | 默认值 | 描述                                                                                                                     |
 | -------- | ------- | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
-| `button` | Literal | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"mute"` 静音键 <br>- `"playpause"` 播放/暂停键 <br>- `"next"` 下一首/下一章节 <br>- `"prev"` 上一首/上一章节 <br>- `"eject"` 显示/隐藏键盘 <br>- `"globe"` Globe 键 <br>- `"search"` 搜索键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 <br>- `"power"` 电源/锁屏键 <br>- `"menu"` Home/Menu 键 <br>- `"snapshot"` 系统截图键 |
+| `button` | Literal | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"mute"` 静音键 <br>- `"playpause"` 播放/暂停键 <br>- `"next"` 下一首/下一章节 <br>- `"prev"` 上一首/上一章节 <br>- `"eject"` 显示/隐藏键盘 <br>- `"globe"` Globe 键 <br>- `"search"` 搜索键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 <br>- `"power"` 电源/锁屏键 <br>- `"snapshot"` 系统截图键 |
 
 **返回值：**
 
@@ -932,7 +931,7 @@ hid.back()
 
 ### recent - 最近应用
 
-显示 APP 切换器
+双击 Home 显示 APP 切换器。
 
 ```python
 def recent() -> bool

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-vite-plugin",
-  "version": "1.3.3",
+  "version": "1.3.4",
   "type": "commonjs",
   "license": "MIT",
   "publishConfig": {

package/dist/device.d.ts

@@ -1,32 +0,0 @@
-/**
- * 设备命令选项
- */
-export interface DeviceCliOptions {
-    ip: string;
-    port?: string;
-    path?: string;
-}
-/**
- * 在设备上运行项目（先同步后运行）
- * @param options 命令选项
- * @returns 执行完成后返回 Promise<void>
- * @example
- * await runOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
- */
-export declare function runOnDevice(options: DeviceCliOptions): Promise<void>;
-/**
- * 在设备上预览 UI（先同步后调用 runUI）
- * @param options 命令选项
- * @returns 执行完成后返回 Promise<void>
- * @example
- * await runUIOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
- */
-export declare function runUIOnDevice(options: DeviceCliOptions): Promise<void>;
-/**
- * 停止设备上的项目
- * @param options 命令选项
- * @returns 执行完成后返回 Promise<void>
- * @example
- * await stopOnDevice({ ip: "192.168.1.10", port: "9800" })
- */
-export declare function stopOnDevice(options: DeviceCliOptions): Promise<void>;

package/dist/device.js

@@ -1,325 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runOnDevice = runOnDevice;
-exports.runUIOnDevice = runUIOnDevice;
-exports.stopOnDevice = stopOnDevice;
-const fsExtra = __importStar(require("fs-extra"));
-const path = __importStar(require("path"));
-const build_js_1 = require("./build.js");
-/**
- * 读取并校验设备连接参数
- * @param options 命令选项
- * @returns 返回标准化后的设备地址信息
- * @example
- * parseDeviceOptions({ ip: "192.168.1.10", port: "9800" })
- */
-function parseDeviceOptions(options) {
-    const ip = options.ip?.trim();
-    const portText = (options.port ?? "9800").trim();
-    const port = Number.parseInt(portText, 10);
-    if (!ip) {
-        throw new Error("请通过 --ip 指定设备 IP 地址");
-    }
-    if (!Number.isInteger(port) || port < 1 || port > 65535) {
-        throw new Error(`无效端口: ${portText}`);
-    }
-    return { ip, port };
-}
-/**
- * 计算 Buffer 的 CRC32 值
- * @param input 二进制输入数据
- * @returns CRC32 十六进制字符串（8位）
- * @example
- * calculateCrc32FromBuffer(Buffer.from("hello"))
- */
-function calculateCrc32FromBuffer(input) {
-    let crc = 0xffffffff;
-    for (let i = 0; i < input.length; i += 1) {
-        crc ^= input[i];
-        for (let j = 0; j < 8; j += 1) {
-            if ((crc & 1) === 1) {
-                crc = (crc >>> 1) ^ 0xedb88320;
-            }
-            else {
-                crc >>>= 1;
-            }
-        }
-    }
-    const finalValue = (crc ^ 0xffffffff) >>> 0;
-    return finalValue.toString(16).padStart(8, "0");
-}
-/**
- * 计算文件的 CRC32 值
- * @param filePath 文件路径
- * @returns CRC32 十六进制字符串（8位）
- * @example
- * await calculateCrc32("/tmp/a.txt")
- */
-async function calculateCrc32(filePath) {
-    const fileBuffer = await fsExtra.readFile(filePath);
-    return calculateCrc32FromBuffer(fileBuffer);
-}
-/**
- * 递归收集目录中的所有文件
- * @param rootDir 需要遍历的根目录
- * @param bundlePrefix 输出到设备时的目录前缀
- * @returns 返回可同步文件列表（含 size 与 crc32）
- * @example
- * await collectFilesInDir("/tmp/project/ui", "ui")
- */
-async function collectFilesInDir(rootDir, bundlePrefix) {
-    const files = [];
-    async function walk(dir) {
-        const entries = await fsExtra.readdir(dir, { withFileTypes: true });
-        for (const entry of entries) {
-            const fullPath = path.join(dir, entry.name);
-            if (entry.isDirectory()) {
-                await walk(fullPath);
-            }
-            else if (entry.isFile()) {
-                const relPath = path.relative(rootDir, fullPath).replace(/\\/g, "/");
-                const stat = await fsExtra.stat(fullPath);
-                files.push({
-                    path: fullPath,
-                    bundlePath: `${bundlePrefix}/${relPath}`,
-                    size: stat.size,
-                    crc32: await calculateCrc32(fullPath),
-                });
-            }
-        }
-    }
-    if (await fsExtra.pathExists(rootDir)) {
-        await walk(rootDir);
-    }
-    return files;
-}
-/**
- * 读取项目运行所需的元信息
- * @param workspacePath 项目根目录
- * @returns 返回 projectName、appVersion 与 packageJsonPath
- * @example
- * await getProjectMeta("/Users/demo/project")
- */
-async function getProjectMeta(workspacePath) {
-    const packageJsonPath = path.join(workspacePath, "package.json");
-    const packageJson = await fsExtra.readJSON(packageJsonPath);
-    const projectName = packageJson.name;
-    const appVersion = packageJson.appVersion;
-    if (!projectName) {
-        throw new Error("请在 package.json 中添加 name 字段");
-    }
-    if (!appVersion) {
-        throw new Error("请在 package.json 中添加 appVersion 字段");
-    }
-    return { projectName, appVersion, packageJsonPath };
-}
-/**
- * 收集运行前需要同步的文件
- * @param workspacePath 项目根目录
- * @returns 返回项目文件清单（含 size 与 crc32）
- * @example
- * await collectProjectFiles("/Users/demo/project")
- */
-async function collectProjectFiles(workspacePath) {
-    const scriptDistPath = path.join(workspacePath, "dist", "scripts");
-    const scriptSrcPath = path.join(workspacePath, "scripts");
-    const uiPath = path.join(workspacePath, "ui");
-    const resPath = path.join(workspacePath, "res");
-    const packageJsonPath = path.join(workspacePath, "package.json");
-    const useDistScripts = await fsExtra.pathExists(scriptDistPath);
-    const scriptPath = useDistScripts ? scriptDistPath : scriptSrcPath;
-    const files = [
-        {
-            path: packageJsonPath,
-            bundlePath: "package.json",
-            size: (await fsExtra.stat(packageJsonPath)).size,
-            crc32: await calculateCrc32(packageJsonPath),
-        },
-    ];
-    const [scriptFiles, uiFiles, resFiles] = await Promise.all([
-        collectFilesInDir(scriptPath, "scripts"),
-        collectFilesInDir(uiPath, "ui"),
-        collectFilesInDir(resPath, "res"),
-    ]);
-    files.push(...scriptFiles, ...uiFiles, ...resFiles);
-    return files;
-}
-/**
- * 获取设备上的文件列表
- * @param ip 设备 IP 地址
- * @param port 设备端口
- * @param projectName 项目名称
- * @returns 设备当前文件信息列表
- * @example
- * await listDeviceFiles("192.168.1.10", 9800, "demo")
- */
-async function listDeviceFiles(ip, port, projectName) {
-    const url = new URL(`http://${ip}:${port}/api/files`);
-    url.searchParams.set("projectName", projectName);
-    const response = await fetch(url.toString(), { method: "GET" });
-    if (!response.ok) {
-        throw new Error(`文件列表请求失败: ${response.statusText}`);
-    }
-    const data = (await response.json());
-    return Array.isArray(data) ? data : [];
-}
-/**
- * 将项目文件增量同步到设备
- * @param workspacePath 项目根目录
- * @param ip 设备 IP 地址
- * @param port 设备端口
- * @returns 同步完成后返回 Promise<void>
- * @example
- * await syncProjectToDevice("/Users/demo/project", "192.168.1.10", 9800)
- */
-async function syncProjectToDevice(workspacePath, ip, port) {
-    const { projectName, appVersion } = await getProjectMeta(workspacePath);
-    console.log("🔎 正在获取设备文件列表...");
-    const deviceFiles = await listDeviceFiles(ip, port, projectName);
-    const deviceFileMap = new Map(deviceFiles.map((file) => [file.path, file]));
-    console.log("📂 正在分析项目文件...");
-    const files = await collectProjectFiles(workspacePath);
-    const filesToSync = [];
-    for (const file of files) {
-        const deviceFile = deviceFileMap.get(file.bundlePath);
-        const requireSyncFile = file.bundlePath.includes("main.js") ||
-            file.bundlePath.includes("main.py");
-        if (!deviceFile) {
-            filesToSync.push(file);
-            continue;
-        }
-        const changed = deviceFile.size !== file.size ||
-            deviceFile.crc32.toLowerCase() !== file.crc32.toLowerCase();
-        if (requireSyncFile || changed) {
-            filesToSync.push(file);
-        }
-    }
-    console.log(`📦 发现 ${filesToSync.length} 个文件需要同步`);
-    if (filesToSync.length === 0) {
-        console.log("✅ 无需同步文件");
-        return;
-    }
-    let syncedCount = 0;
-    for (const file of filesToSync) {
-        syncedCount += 1;
-        console.log(`⬆️  [${syncedCount}/${filesToSync.length}] 同步 ${file.bundlePath}`);
-        const binary = await fsExtra.readFile(file.path);
-        const url = new URL(`http://${ip}:${port}/debug/patchSync`);
-        url.searchParams.set("path", file.bundlePath);
-        url.searchParams.set("projectName", projectName);
-        url.searchParams.set("appVersion", appVersion);
-        const response = await fetch(url.toString(), {
-            method: "POST",
-            headers: {
-                "Content-Type": "application/octet-stream",
-            },
-            body: binary,
-        });
-        if (!response.ok) {
-            throw new Error(`同步失败: ${file.bundlePath} (状态码: ${response.status})`);
-        }
-    }
-    console.log(`✅ 同步完成，共 ${filesToSync.length} 个文件`);
-}
-/**
- * 发送设备动作请求
- * @param action 动作名称，支持 run 与 stop
- * @param ip 设备 IP 地址
- * @param port 设备端口
- * @returns 请求成功时返回 Promise<void>
- * @example
- * await requestDeviceAction("stop", "192.168.1.10", 9800)
- */
-async function requestDeviceAction(action, ip, port) {
-    const url = `http://${ip}:${port}/api/${action}`;
-    const response = await fetch(url, { method: "GET" });
-    if (!response.ok) {
-        throw new Error(`${action} 失败，状态码: ${response.status}`);
-    }
-}
-/**
- * 在设备上运行项目（先同步后运行）
- * @param options 命令选项
- * @returns 执行完成后返回 Promise<void>
- * @example
- * await runOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
- */
-async function runOnDevice(options) {
-    const workspacePath = options.path
-        ? path.resolve(options.path)
-        : process.cwd();
-    const { ip, port } = parseDeviceOptions(options);
-    console.log(`🔧 开始构建项目: ${workspacePath}`);
-    await (0, build_js_1.buildAll)(true, workspacePath);
-    console.log(`📦 开始同步项目到设备: ${ip}:${port}`);
-    await syncProjectToDevice(workspacePath, ip, port);
-    console.log(`🚀 开始运行项目: ${ip}:${port}`);
-    await requestDeviceAction("run", ip, port);
-    console.log("✅ 运行请求已发送");
-}
-/**
- * 在设备上预览 UI（先同步后调用 runUI）
- * @param options 命令选项
- * @returns 执行完成后返回 Promise<void>
- * @example
- * await runUIOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
- */
-async function runUIOnDevice(options) {
-    const workspacePath = options.path
-        ? path.resolve(options.path)
-        : process.cwd();
-    const { ip, port } = parseDeviceOptions(options);
-    console.log(`🔧 开始构建项目: ${workspacePath}`);
-    await (0, build_js_1.buildAll)(true, workspacePath);
-    console.log(`📦 开始同步项目到设备: ${ip}:${port}`);
-    await syncProjectToDevice(workspacePath, ip, port);
-    console.log(`🖼️ 开始预览 UI: ${ip}:${port}`);
-    await requestDeviceAction("runUI", ip, port);
-    console.log("✅ UI 预览请求已发送");
-}
-/**
- * 停止设备上的项目
- * @param options 命令选项
- * @returns 执行完成后返回 Promise<void>
- * @example
- * await stopOnDevice({ ip: "192.168.1.10", port: "9800" })
- */
-async function stopOnDevice(options) {
-    const { ip, port } = parseDeviceOptions(options);
-    console.log(`🛑 开始停止项目: ${ip}:${port}`);
-    await requestDeviceAction("stop", ip, port);
-    console.log("✅ 停止请求已发送");
-}

package/dist/mcp/control-tools.d.ts

@@ -1,9 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-/**
- * 注册 Control API 对应 MCP 工具
- * @param server MCP 服务实例
- * @returns 无返回值
- * @example
- * registerControlTools(server)
- */
-export declare function registerControlTools(server: McpServer): void;

package/dist/mcp/control-tools.js

@@ -1,201 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerControlTools = registerControlTools;
-const z = __importStar(require("zod/v4"));
-const tool_utils_1 = require("./tool-utils");
-/**
- * 请求控制路由
- * @param endpoint 控制 API 名称
- * @param query 可选查询参数
- * @returns 返回设备端 JSON 响应
- * @example
- * const payload = await requestControlApi("home")
- */
-async function requestControlApi(endpoint, query) {
-    const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-    return (0, tool_utils_1.requestRuntimePathJson)(target, `/api/control/${endpoint}`, query);
-}
-/**
- * 将控制类 API 响应格式化为 MCP 文本
- * @param actionName 操作名称
- * @param payload 设备端响应
- * @returns 返回标准文本工具响应
- * @example
- * formatControlResult("返回桌面", { success: true })
- */
-function formatControlResult(actionName, payload) {
-    const success = payload.success === true;
-    if ("data" in payload) {
-        return (0, tool_utils_1.createTextToolResult)(`${actionName}${success ? "成功" : "失败"}:\n${(0, tool_utils_1.formatRuntimeJsonText)(payload.data)}`, !success);
-    }
-    return (0, tool_utils_1.createTextToolResult)(`${actionName}${success ? "成功" : "失败"}`, !success);
-}
-/**
- * 注册 Control API 对应 MCP 工具
- * @param server MCP 服务实例
- * @returns 无返回值
- * @example
- * registerControlTools(server)
- */
-function registerControlTools(server) {
-    server.registerTool("control_home", {
-        title: "Control Home",
-        description: "返回桌面。",
-        inputSchema: {},
-    }, async () => formatControlResult("返回桌面", await requestControlApi("home")));
-    server.registerTool("control_click", {
-        title: "Control Click",
-        description: "点击指定坐标。",
-        inputSchema: {
-            x: z.number().int().min(0).describe("点击坐标 x"),
-            y: z.number().int().min(0).describe("点击坐标 y"),
-            duration: z
-                .number()
-                .int()
-                .min(0)
-                .optional()
-                .describe("按压时长，默认 20"),
-            jitter: z.boolean().optional().describe("是否启用抖动，默认 false"),
-        },
-    }, async ({ x, y, duration, jitter }) => formatControlResult("点击", await requestControlApi("click", { x, y, duration, jitter })));
-    server.registerTool("control_double_click", {
-        title: "Control Double Click",
-        description: "双击指定坐标。",
-        inputSchema: {
-            x: z.number().int().min(0).describe("双击坐标 x"),
-            y: z.number().int().min(0).describe("双击坐标 y"),
-            duration: z
-                .number()
-                .int()
-                .min(0)
-                .optional()
-                .describe("单次按压时长，默认 20"),
-            interval: z
-                .number()
-                .int()
-                .min(0)
-                .optional()
-                .describe("两次点击间隔，默认 20"),
-            jitter: z.boolean().optional().describe("是否启用抖动，默认 false"),
-        },
-    }, async ({ x, y, duration, interval, jitter }) => formatControlResult("双击", await requestControlApi("doubleClick", {
-        x,
-        y,
-        duration,
-        interval,
-        jitter,
-    })));
-    server.registerTool("control_swipe", {
-        title: "Control Swipe",
-        description: "从起点滑动到终点。",
-        inputSchema: {
-            startX: z.number().int().min(0).describe("起点 x"),
-            startY: z.number().int().min(0).describe("起点 y"),
-            endX: z.number().int().min(0).describe("终点 x"),
-            endY: z.number().int().min(0).describe("终点 y"),
-            duration: z
-                .number()
-                .int()
-                .min(0)
-                .optional()
-                .describe("滑动时长，默认 100"),
-            jitter: z.boolean().optional().describe("是否启用抖动，默认 false"),
-            steps: z.number().int().min(1).optional().describe("分段步数，默认 6"),
-        },
-    }, async ({ startX, startY, endX, endY, duration, jitter, steps }) => formatControlResult("滑动", await requestControlApi("swipe", {
-        startX,
-        startY,
-        endX,
-        endY,
-        duration,
-        jitter,
-        steps,
-    })));
-    server.registerTool("control_press_button", {
-        title: "Control Press Button",
-        description: "按下指定系统按键。",
-        inputSchema: {
-            button: z.string().min(1).describe("按钮名称"),
-        },
-    }, async ({ button }) => formatControlResult("按键", await requestControlApi("pressButton", { button })));
-    server.registerTool("control_input", {
-        title: "Control Input",
-        description: "输入文本。",
-        inputSchema: {
-            text: z.string().min(1).describe("待输入文本"),
-        },
-    }, async ({ text }) => formatControlResult("输入", await requestControlApi("input", { text })));
-    server.registerTool("control_backspace", {
-        title: "Control Backspace",
-        description: "执行退格操作。",
-        inputSchema: {
-            count: z.number().int().min(1).optional().describe("退格次数，默认 1"),
-        },
-    }, async ({ count }) => formatControlResult("退格", await requestControlApi("backspace", { count })));
-    server.registerTool("control_enter", {
-        title: "Control Enter",
-        description: "执行回车操作。",
-        inputSchema: {},
-    }, async () => formatControlResult("回车", await requestControlApi("enter")));
-    server.registerTool("control_start_app", {
-        title: "Control Start App",
-        description: "启动指定应用。",
-        inputSchema: {
-            bundleId: z.string().min(1).describe("应用 bundleId"),
-        },
-    }, async ({ bundleId }) => formatControlResult("启动应用", await requestControlApi("startApp", { bundleId })));
-    server.registerTool("control_activate_app", {
-        title: "Control Activate App",
-        description: "激活指定应用。",
-        inputSchema: {
-            bundleId: z.string().min(1).describe("应用 bundleId"),
-        },
-    }, async ({ bundleId }) => formatControlResult("激活应用", await requestControlApi("activateApp", { bundleId })));
-    server.registerTool("control_stop_app", {
-        title: "Control Stop App",
-        description: "停止指定应用。",
-        inputSchema: {
-            bundleId: z.string().min(1).describe("应用 bundleId"),
-        },
-    }, async ({ bundleId }) => formatControlResult("停止应用", await requestControlApi("stopApp", { bundleId })));
-    server.registerTool("control_open_url", {
-        title: "Control Open URL",
-        description: "打开指定 URL。",
-        inputSchema: {
-            url: z.string().min(1).describe("目标 URL"),
-        },
-    }, async ({ url }) => formatControlResult("打开 URL", await requestControlApi("openURL", { url })));
-}

package/dist/mcp/hid-tools.d.ts

@@ -1,9 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-/**
- * 注册 HID API 对应 MCP 工具
- * @param server MCP 服务实例
- * @returns 无返回值
- * @example
- * registerHidTools(server)
- */
-export declare function registerHidTools(server: McpServer): void;

package/dist/mcp/hid-tools.js

@@ -1,254 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerHidTools = registerHidTools;
-const fsExtra = __importStar(require("fs-extra"));
-const os = __importStar(require("os"));
-const path = __importStar(require("path"));
-const z = __importStar(require("zod/v4"));
-const tool_utils_1 = require("./tool-utils");
-/**
- * 请求 HID 路由
- * @param endpoint HID API 名称
- * @param query 可选查询参数
- * @returns 返回设备端 JSON 响应
- * @example
- * const payload = await requestHidApi("home")
- */
-async function requestHidApi(endpoint, query) {
-    const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-    return (0, tool_utils_1.requestRuntimePathJson)(target, `/api/hid/${endpoint}`, query);
-}
-/**
- * 格式化 HID 类 JSON 响应
- * @param actionName 操作名称
- * @param payload 设备端响应
- * @returns 返回标准文本工具响应
- * @example
- * formatHidResult("打开录屏", { success: true })
- */
-function formatHidResult(actionName, payload) {
-    const success = payload.success === true;
-    if ("data" in payload) {
-        return (0, tool_utils_1.createTextToolResult)(`${actionName}${success ? "成功" : "失败"}:\n${(0, tool_utils_1.formatRuntimeJsonText)(payload.data)}`, !success);
-    }
-    return (0, tool_utils_1.createTextToolResult)(`${actionName}${success ? "成功" : "失败"}`, !success);
-}
-/**
- * 注册 HID API 对应 MCP 工具
- * @param server MCP 服务实例
- * @returns 无返回值
- * @example
- * registerHidTools(server)
- */
-function registerHidTools(server) {
-    server.registerTool("hid_shortcut_screenshot", {
-        title: "HID Shortcut Screenshot",
-        description: "获取快捷指令截图。可返回 base64，或落地到文件后返回文件路径（默认写入系统临时目录）。",
-        inputSchema: {
-            format: z
-                .enum(["file", "base64"])
-                .optional()
-                .default("file")
-                .describe("截图返回格式：file=文件路径，base64=图片 base64"),
-            outputPath: z
-                .string()
-                .min(1)
-                .optional()
-                .describe("当 format=file 时可指定输出路径，不传则写入系统临时目录"),
-        },
-    }, async ({ format, outputPath }) => {
-        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-        const payload = await requestHidApi("shortcutScreenshotBase64");
-        const success = payload.success === true;
-        const base64 = typeof payload.data === "string" && payload.data ? payload.data : null;
-        if (!success || !base64) {
-            return (0, tool_utils_1.createTextToolResult)("快捷指令截图失败", true);
-        }
-        if (format === "base64") {
-            return (0, tool_utils_1.createTextToolResult)(`快捷指令截图成功: ${target.label}\nformat: base64\n${base64}`);
-        }
-        const buffer = Buffer.from(base64, "base64");
-        const targetPath = outputPath && outputPath.trim()
-            ? path.resolve(outputPath.trim())
-            : path.join(os.tmpdir(), `ms-mcp-hid-shortcut-screenshot-${Date.now()}-${Math.random()
-                .toString(36)
-                .slice(2, 8)}.jpg`);
-        await fsExtra.ensureDir(path.dirname(targetPath));
-        await fsExtra.writeFile(targetPath, buffer);
-        return (0, tool_utils_1.createTextToolResult)(`快捷指令截图成功: ${target.label}\nformat: file\npath: ${targetPath}\nsize: ${buffer.length} bytes`);
-    });
-    server.registerTool("hid_open_record_screen", {
-        title: "HID Open Record Screen",
-        description: "打开录屏界面。",
-        inputSchema: {},
-    }, async () => formatHidResult("打开录屏界面", await requestHidApi("openRecordScreen")));
-    server.registerTool("hid_is_recording", {
-        title: "HID Is Recording",
-        description: "检查是否正在录屏。",
-        inputSchema: {},
-    }, async () => formatHidResult("查询录屏状态", await requestHidApi("isRecording")));
-    server.registerTool("hid_move", {
-        title: "HID Move",
-        description: "移动指针。",
-        inputSchema: {
-            x: z.number().int().describe("目标坐标 x"),
-            y: z.number().int().describe("目标坐标 y"),
-        },
-    }, async ({ x, y }) => formatHidResult("移动指针", await requestHidApi("move", { x, y })));
-    server.registerTool("hid_click", {
-        title: "HID Click",
-        description: "点击指针。",
-        inputSchema: {
-            x: z.number().int().describe("点击坐标 x"),
-            y: z.number().int().describe("点击坐标 y"),
-            duration: z
-                .number()
-                .int()
-                .min(0)
-                .optional()
-                .describe("按压时长，默认 20"),
-            jitter: z.boolean().optional().describe("是否启用抖动，默认 false"),
-        },
-    }, async ({ x, y, duration, jitter }) => formatHidResult("点击指针", await requestHidApi("click", { x, y, duration, jitter })));
-    server.registerTool("hid_double_click", {
-        title: "HID Double Click",
-        description: "双击指针。",
-        inputSchema: {
-            x: z.number().int().describe("双击坐标 x"),
-            y: z.number().int().describe("双击坐标 y"),
-            duration: z
-                .number()
-                .int()
-                .min(0)
-                .optional()
-                .describe("单次按压时长，默认 20"),
-            interval: z
-                .number()
-                .int()
-                .min(0)
-                .optional()
-                .describe("两次点击间隔，默认 100"),
-            jitter: z.boolean().optional().describe("是否启用抖动，默认 false"),
-        },
-    }, async ({ x, y, duration, interval, jitter }) => formatHidResult("双击指针", await requestHidApi("doubleClick", {
-        x,
-        y,
-        duration,
-        interval,
-        jitter,
-    })));
-    server.registerTool("hid_swipe", {
-        title: "HID Swipe",
-        description: "滑动指针。",
-        inputSchema: {
-            startX: z.number().int().describe("起点 x"),
-            startY: z.number().int().describe("起点 y"),
-            endX: z.number().int().describe("终点 x"),
-            endY: z.number().int().describe("终点 y"),
-            jitter: z.boolean().optional().describe("是否启用抖动，默认 true"),
-            steps: z.number().int().min(1).optional().describe("分段步数，默认 10"),
-        },
-    }, async ({ startX, startY, endX, endY, jitter, steps }) => formatHidResult("滑动指针", await requestHidApi("swipe", {
-        startX,
-        startY,
-        endX,
-        endY,
-        jitter,
-        steps,
-    })));
-    server.registerTool("hid_home", {
-        title: "HID Home",
-        description: "返回桌面。",
-        inputSchema: {},
-    }, async () => formatHidResult("返回桌面", await requestHidApi("home")));
-    server.registerTool("hid_recent", {
-        title: "HID Recent",
-        description: "打开 App 切换器。",
-        inputSchema: {},
-    }, async () => formatHidResult("打开最近任务", await requestHidApi("recent")));
-    server.registerTool("hid_open_url", {
-        title: "HID Open URL",
-        description: "通过 HID 打开 URL。",
-        inputSchema: {
-            url: z.string().min(1).describe("目标 URL"),
-        },
-    }, async ({ url }) => formatHidResult("打开 URL", await requestHidApi("openURL", { url })));
-    server.registerTool("hid_open_app", {
-        title: "HID Open App",
-        description: "打开应用。",
-        inputSchema: {
-            name: z.string().min(1).describe("应用名称或标识"),
-        },
-    }, async ({ name }) => formatHidResult("打开应用", await requestHidApi("openApp", { name })));
-    server.registerTool("hid_close_app", {
-        title: "HID Close App",
-        description: "关闭应用。",
-        inputSchema: {
-            name: z.string().min(1).describe("应用名称或标识"),
-        },
-    }, async ({ name }) => formatHidResult("关闭应用", await requestHidApi("closeApp", { name })));
-    server.registerTool("hid_current_app_info", {
-        title: "HID Current App Info",
-        description: "获取当前应用信息。",
-        inputSchema: {},
-    }, async () => formatHidResult("获取当前应用信息", await requestHidApi("currentAppInfo")));
-    server.registerTool("hid_input", {
-        title: "HID Input",
-        description: "执行输入。",
-        inputSchema: {
-            text: z.string().min(1).describe("待输入文本"),
-        },
-    }, async ({ text }) => formatHidResult("输入文本", await requestHidApi("input", { text })));
-    server.registerTool("hid_input_simple", {
-        title: "HID Input Simple",
-        description: "执行简单输入。",
-        inputSchema: {
-            text: z.string().min(1).describe("待输入文本"),
-        },
-    }, async ({ text }) => formatHidResult("简单输入", await requestHidApi("inputSimple", { text })));
-    server.registerTool("hid_backspace", {
-        title: "HID Backspace",
-        description: "执行退格。",
-        inputSchema: {
-            count: z.number().int().min(1).optional().describe("退格次数，默认 1"),
-        },
-    }, async ({ count }) => formatHidResult("退格", await requestHidApi("backspace", { count })));
-    server.registerTool("hid_enter", {
-        title: "HID Enter",
-        description: "执行回车。",
-        inputSchema: {},
-    }, async () => formatHidResult("回车", await requestHidApi("enter")));
-}

package/dist/mcp/ime-tools.d.ts

@@ -1,9 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-/**
- * 注册 IME API 对应 MCP 工具
- * @param server MCP 服务实例
- * @returns 无返回值
- * @example
- * registerImeTools(server)
- */
-export declare function registerImeTools(server: McpServer): void;

package/dist/mcp/ime-tools.js

@@ -1,130 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerImeTools = registerImeTools;
-const z = __importStar(require("zod/v4"));
-const tool_utils_1 = require("./tool-utils");
-/**
- * 请求 IME 路由
- * @param endpoint IME API 名称
- * @param query 可选查询参数
- * @returns 返回设备端 JSON 响应
- * @example
- * const payload = await requestImeApi("getText")
- */
-async function requestImeApi(endpoint, query) {
-    const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-    return (0, tool_utils_1.requestRuntimePathJson)(target, `/api/ime/${endpoint}`, query);
-}
-/**
- * 格式化 IME 类 JSON 响应
- * @param actionName 操作名称
- * @param payload 设备端响应
- * @returns 返回标准文本工具响应
- * @example
- * formatImeResult("获取文本", { success: true, data: "hello" })
- */
-function formatImeResult(actionName, payload) {
-    const success = payload.success === true;
-    if ("data" in payload) {
-        return (0, tool_utils_1.createTextToolResult)(`${actionName}${success ? "成功" : "失败"}:\n${(0, tool_utils_1.formatRuntimeJsonText)(payload.data)}`, !success);
-    }
-    return (0, tool_utils_1.createTextToolResult)(`${actionName}${success ? "成功" : "失败"}`, !success);
-}
-/**
- * 注册 IME API 对应 MCP 工具
- * @param server MCP 服务实例
- * @returns 无返回值
- * @example
- * registerImeTools(server)
- */
-function registerImeTools(server) {
-    server.registerTool("ime_is_ok", {
-        title: "IME Is OK",
-        description: "检查 IME 是否可用。",
-        inputSchema: {},
-    }, async () => formatImeResult("检查 IME", await requestImeApi("isOk")));
-    server.registerTool("ime_input", {
-        title: "IME Input",
-        description: "执行输入。",
-        inputSchema: {
-            text: z.string().min(1).describe("待输入文本"),
-        },
-    }, async ({ text }) => formatImeResult("输入文本", await requestImeApi("input", { text })));
-    server.registerTool("ime_get_text", {
-        title: "IME Get Text",
-        description: "获取当前输入文本。",
-        inputSchema: {},
-    }, async () => formatImeResult("获取当前文本", await requestImeApi("getText")));
-    server.registerTool("ime_clear_text", {
-        title: "IME Clear Text",
-        description: "清除当前输入文本。",
-        inputSchema: {},
-    }, async () => formatImeResult("清除文本", await requestImeApi("clearText")));
-    server.registerTool("ime_paste", {
-        title: "IME Paste",
-        description: "粘贴文本。",
-        inputSchema: {
-            text: z.string().optional().default("").describe("待粘贴文本，可为空字符串"),
-        },
-    }, async ({ text }) => formatImeResult("粘贴文本", await requestImeApi("paste", { text })));
-    server.registerTool("ime_press_del", {
-        title: "IME Press Delete",
-        description: "按下删除键。",
-        inputSchema: {},
-    }, async () => formatImeResult("删除字符", await requestImeApi("pressDel")));
-    server.registerTool("ime_press_enter", {
-        title: "IME Press Enter",
-        description: "按下回车键。",
-        inputSchema: {},
-    }, async () => formatImeResult("按下回车", await requestImeApi("pressEnter")));
-    server.registerTool("ime_dismiss", {
-        title: "IME Dismiss",
-        description: "隐藏 IME。",
-        inputSchema: {},
-    }, async () => formatImeResult("隐藏 IME", await requestImeApi("dismiss")));
-    server.registerTool("ime_get_clipboard", {
-        title: "IME Get Clipboard",
-        description: "获取剪贴板内容。",
-        inputSchema: {},
-    }, async () => formatImeResult("获取剪贴板", await requestImeApi("getClipboard")));
-    server.registerTool("ime_set_clipboard", {
-        title: "IME Set Clipboard",
-        description: "设置剪贴板内容。",
-        inputSchema: {
-            text: z.string().min(1).describe("剪贴板文本"),
-        },
-    }, async ({ text }) => formatImeResult("设置剪贴板", await requestImeApi("setClipboard", { text })));
-}

package/dist/mcp/mirror-tools.d.ts

@@ -1,9 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-/**
- * 注册镜像流相关 MCP 工具
- * @param server MCP 服务实例
- * @returns 无返回值
- * @example
- * registerMirrorTools(server)
- */
-export declare function registerMirrorTools(server: McpServer): void;

package/dist/mcp/mirror-tools.js

@@ -1,82 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerMirrorTools = registerMirrorTools;
-const z = __importStar(require("zod/v4"));
-const tool_utils_1 = require("./tool-utils");
-/**
- * 注册镜像流相关 MCP 工具
- * @param server MCP 服务实例
- * @returns 无返回值
- * @example
- * registerMirrorTools(server)
- */
-function registerMirrorTools(server) {
-    server.registerTool("get_mirror_mjpeg_url", {
-        title: "Get Mirror MJPEG URL",
-        description: "生成设备镜像 MJPEG 流地址。MCP 普通文本/图片响应不适合持续显示 MJPEG，建议将返回 URL 交给浏览器或支持 MJPEG 的查看器打开。",
-        inputSchema: {
-            fps: z.number().int().min(1).max(60).optional().default(10).describe("帧率，默认 10"),
-            quality: z
-                .number()
-                .min(0.1)
-                .max(1)
-                .optional()
-                .default(0.25)
-                .describe("压缩质量，默认 0.25"),
-            scalingFactor: z
-                .number()
-                .min(0.1)
-                .max(1)
-                .optional()
-                .default(1)
-                .describe("缩放因子，默认 1.0"),
-        },
-    }, async ({ fps, quality, scalingFactor }) => {
-        const target = await (0, tool_utils_1.resolveRuntimeHttpTarget)();
-        const url = new URL(`http://${target.ip}:${target.port}/mirror/image`);
-        url.searchParams.set("fps", String(fps));
-        url.searchParams.set("quality", String(quality));
-        url.searchParams.set("scalingFactor", String(scalingFactor));
-        return (0, tool_utils_1.createTextToolResult)([
-            `MJPEG 地址: ${url.toString()}`,
-            `设备: ${target.label}`,
-            `fps: ${fps}`,
-            `quality: ${quality}`,
-            `scalingFactor: ${scalingFactor}`,
-            "说明: MCP 工具本身不适合持续渲染 MJPEG 流，建议把这个地址交给浏览器或支持 MJPEG 的播放器打开。",
-        ].join("\n"));
-    });
-}