@ynhcj/xiaoyi-channel 0.0.149-beta → 0.0.151-beta

package/dist/src/tools/find-pc-devices-tool.js

@@ -1,98 +1,94 @@
 import { getXYWebSocketManager } from "../client.js";
 import { sendCommand } from "../formatter.js";
-import { getCurrentSessionContext } from "./session-manager.js";
 /**
  * XY find PC devices tool - finds all PC devices associated with the user.
  * Returns device IDs for use in subsequent file search operations.
  */
-export const findPcDevicesTool = {
-    name: "find_pc_devices",
-    label: "Find PC Devices",
-    description: `查找用户所有PC/电脑设备，获取设备ID列表。当用户说"帮我找一下PC/电脑上的xxx文件"、"帮我搜索电脑上的xxx"等涉及PC设备的请求时，先调用此工具获取设备ID，再进行后续操作。注意:操作超时时间为60秒,请勿重复调用此工具,如果超时或失败,最多重试一次。回复约束：如果工具返回没有授权或者其他报错，只需要完整描述没有授权或者其他报错内容即可，不需要主动给用户提供解决方案，请严格遵守。`,
-    parameters: {
-        type: "object",
-        properties: {},
-        required: [],
-    },
-    async execute(toolCallId, params) {
-        // Get session context
-        const sessionContext = getCurrentSessionContext();
-        if (!sessionContext) {
-            throw new Error("No active XY session found. Find PC devices tool can only be used during an active conversation.");
-        }
-        const { config, sessionId, taskId, messageId } = sessionContext;
-        // Get WebSocket manager
-        const wsManager = getXYWebSocketManager(config);
-        // Build GetAllDevice command
-        const command = {
-            header: {
-                namespace: "Common",
-                name: "Action",
-            },
-            payload: {
-                cardParam: {},
-                executeParam: {
-                    achieveType: "INTENT",
-                    actionResponse: true,
-                    bundleName: "com.huawei.hmos.aidispatchservice",
-                    dimension: "",
-                    executeMode: "background",
-                    intentName: "GetAllDevice",
-                    intentParam: {},
-                    needUnlock: true,
-                    permissionId: [],
-                    timeOut: 5,
+export function createFindPcDevicesTool(ctx) {
+    const { config, sessionId, taskId, messageId } = ctx;
+    return {
+        name: "find_pc_devices",
+        label: "Find PC Devices",
+        description: `查找用户所有PC/电脑设备，获取设备ID列表。当用户说"帮我找一下PC/电脑上的xxx文件"、"帮我搜索电脑上的xxx"等涉及PC设备的请求时，先调用此工具获取设备ID，再进行后续操作。注意:操作超时时间为60秒,请勿重复调用此工具,如果超时或失败,最多重试一次。回复约束：如果工具返回没有授权或者其他报错，只需要完整描述没有授权或者其他报错内容即可，不需要主动给用户提供解决方案，请严格遵守。`,
+        parameters: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+        async execute(toolCallId, params) {
+            // Get WebSocket manager
+            const wsManager = getXYWebSocketManager(config);
+            // Build GetAllDevice command
+            const command = {
+                header: {
+                    namespace: "Common",
+                    name: "Action",
                 },
-                needUploadResult: true,
-                pageControlRelated: false,
-                responses: [{
-                        displayText: "",
-                        resultCode: "",
-                        ttsText: "",
-                    }],
-            },
-        };
-        // Send command and wait for response (60 second timeout)
-        return new Promise((resolve, reject) => {
-            const timeout = setTimeout(() => {
-                wsManager.off("data-event", handler);
-                reject(new Error("查找PC设备超时（60秒）"));
-            }, 60000);
-            // Listen for data events from WebSocket
-            const handler = (event) => {
-                if (event.intentName === "GetAllDevice") {
-                    clearTimeout(timeout);
+                payload: {
+                    cardParam: {},
+                    executeParam: {
+                        achieveType: "INTENT",
+                        actionResponse: true,
+                        bundleName: "com.huawei.hmos.aidispatchservice",
+                        dimension: "",
+                        executeMode: "background",
+                        intentName: "GetAllDevice",
+                        intentParam: {},
+                        needUnlock: true,
+                        permissionId: [],
+                        timeOut: 5,
+                    },
+                    needUploadResult: true,
+                    pageControlRelated: false,
+                    responses: [{
+                            displayText: "",
+                            resultCode: "",
+                            ttsText: "",
+                        }],
+                },
+            };
+            // Send command and wait for response (60 second timeout)
+            return new Promise((resolve, reject) => {
+                const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    if (event.status === "success" && event.outputs) {
-                        resolve({
-                            content: [
-                                {
-                                    type: "text",
-                                    text: JSON.stringify(event.outputs),
-                                }
-                            ]
-                        });
-                    }
-                    else {
-                        reject(new Error(`查找PC设备失败: ${event.status}`));
+                    reject(new Error("查找PC设备超时（60秒）"));
+                }, 60000);
+                // Listen for data events from WebSocket
+                const handler = (event) => {
+                    if (event.intentName === "GetAllDevice") {
+                        clearTimeout(timeout);
+                        wsManager.off("data-event", handler);
+                        if (event.status === "success" && event.outputs) {
+                            resolve({
+                                content: [
+                                    {
+                                        type: "text",
+                                        text: JSON.stringify(event.outputs),
+                                    }
+                                ]
+                            });
+                        }
+                        else {
+                            reject(new Error(`查找PC设备失败: ${event.status}`));
+                        }
                     }
-                }
-            };
-            // Register event handler
-            wsManager.on("data-event", handler);
-            // Send the command
-            sendCommand({
-                config,
-                sessionId,
-                taskId,
-                messageId,
-                command,
-            }).then(() => {
-            }).catch((error) => {
-                clearTimeout(timeout);
-                wsManager.off("data-event", handler);
-                reject(error);
+                };
+                // Register event handler
+                wsManager.on("data-event", handler);
+                // Send the command
+                sendCommand({
+                    config,
+                    sessionId,
+                    taskId,
+                    messageId,
+                    command,
+                }).then(() => {
+                }).catch((error) => {
+                    clearTimeout(timeout);
+                    wsManager.off("data-event", handler);
+                    reject(error);
+                });
             });
-        });
-    },
-};
+        },
+    };
+}

package/dist/src/tools/get-device-file-tool-schema.js

@@ -2,13 +2,14 @@ import { createSchemaTool } from "./schema-tool-factory.js";
 import { createSearchFileTool } from "./search-file-tool.js";
 import { createUploadFileTool } from "./upload-file-tool.js";
 import { createSaveFileToPhoneTool } from "./save-file-to-phone-tool.js";
+import { createFindPcDevicesTool } from "./find-pc-devices-tool.js";
 export function createGetDeviceFileToolSchemaTool(ctx) {
     const searchFileTool = createSearchFileTool(ctx);
     const saveFileToPhoneTool = createSaveFileToPhoneTool(ctx);
     return createSchemaTool({
         name: "get_device_file_tool_schema",
         label: "Get Device File Tool Schema",
-        description: "获取可在用户设备上搜索文件系统的文件、将用户设备本地文件上传到公网并获取链接、保存文件到文件管理器的相关端工具列表。",
-        tools: [searchFileTool, createUploadFileTool(ctx), saveFileToPhoneTool],
+        description: "获取可在用户设备上搜索文件系统的文件、将用户设备本地文件上传到公网并获取链接、保存文件到文件管理器、查找PC设备的相关端工具列表。",
+        tools: [searchFileTool, createUploadFileTool(ctx), saveFileToPhoneTool, createFindPcDevicesTool(ctx)],
     });
 }

package/dist/src/tools/image-reading-tool.js

@@ -51,7 +51,7 @@ async function processImageInput(imageInput, uploadService) {
  * Call image understanding API with streaming response
  * Supports both single image and multiple images (imageUrls array)
  */
-async function callImageUnderstandingAPI(imageUrls, text, apiKey, uid, fileUploadUrl) {
+async function callImageUnderstandingAPI(imageUrls, text, apiKey, uid, fileUploadUrl, sessionId) {
     const apiUrl = `${fileUploadUrl}/celia-claw/v1/sse-api/skill/execute`;
     const traceId = `${createHash("sha256").update(uid).digest("hex").slice(0, 32)}_${Date.now()}`;
     const headers = {
@@ -68,7 +68,7 @@ async function callImageUnderstandingAPI(imageUrls, text, apiKey, uid, fileUploa
         version: "1.0",
         session: {
             isNew: false,
-            sessionId: "wangyu202410241921",
+            sessionId,
             interactionId: 0,
         },
         endpoint: {
@@ -166,7 +166,7 @@ async function callImageUnderstandingAPI(imageUrls, text, apiKey, uid, fileUploa
  * Supports both local file paths and remote URLs, up to 10 images at once.
  */
 export function createImageReadingTool(ctx) {
-    const { config } = ctx;
+    const { config, sessionId } = ctx;
     return {
         name: "image_reading",
         label: "Image Reading",
@@ -210,7 +210,7 @@ export function createImageReadingTool(ctx) {
                     allImageUrls.push(await processImageInput(imageInput, uploadService));
                 }
                 // Call image understanding API with all image URLs
-                const caption = await callImageUnderstandingAPI(allImageUrls, prompt, config.apiKey, config.uid, config.fileUploadUrl);
+                const caption = await callImageUnderstandingAPI(allImageUrls, prompt, config.apiKey, config.uid, config.fileUploadUrl, sessionId);
                 return {
                     content: [
                         {

package/dist/src/tools/location-tool.js

@@ -55,7 +55,7 @@ export function createLocationTool(ctx) {
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 获取位置超时（60秒）", { sessionId, toolCallId });
+                    logger.error("超时: 获取位置超时（60秒）", { toolCallId });
                     reject(new Error("获取位置超时（60秒）"));
                 }, 60000);
                 // Listen for data events from WebSocket

package/dist/src/tools/modify-alarm-tool.js

@@ -236,7 +236,7 @@ export function createModifyAlarmTool(ctx) {
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 修改闹钟超时（60秒）", { sessionId, toolCallId });
+                    logger.error("超时: 修改闹钟超时（60秒）", { toolCallId });
                     reject(new Error("修改闹钟超时（60秒）"));
                 }, 60000);
                 // Listen for data events from WebSocket

package/dist/src/tools/modify-note-tool.js

@@ -77,7 +77,7 @@ export function createModifyNoteTool(ctx) {
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 修改备忘录超时（60秒）", { sessionId, toolCallId });
+                    logger.error("超时: 修改备忘录超时（60秒）", { toolCallId });
                     reject(new Error("修改备忘录超时（60秒）"));
                 }, 60000);
                 // Listen for data events from WebSocket

package/dist/src/tools/note-tool.js

@@ -94,7 +94,7 @@ export function createNoteTool(ctx) {
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 创建备忘录超时（60秒）", { sessionId, toolCallId });
+                    logger.error("超时: 创建备忘录超时（60秒）", { toolCallId });
                     reject(new Error("创建备忘录超时（60秒）"));
                 }, 60000);
                 // Listen for data events from WebSocket

package/dist/src/tools/query-app-message-tool.js

@@ -96,7 +96,7 @@ c. 调用工具前需认真检查调用参数是否满足工具要求
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 查询通知消息超时（60秒）", { sessionId, toolCallId: _toolCallId });
+                    logger.error("超时: 查询通知消息超时（60秒）", { toolCallId: _toolCallId });
                     reject(new Error("查询通知消息超时（60秒）"));
                 }, 60000);
                 const handler = (event) => {

package/dist/src/tools/query-memory-data-tool.js

@@ -112,7 +112,7 @@ c. 调用工具前需认真检查调用参数是否满足工具要求
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 查询记忆数据超时（60秒）", { sessionId, toolCallId: _toolCallId });
+                    logger.error("超时: 查询记忆数据超时（60秒）", { toolCallId: _toolCallId });
                     reject(new Error("查询记忆数据超时（60秒）"));
                 }, 60000);
                 const handler = (event) => {

package/dist/src/tools/query-todo-task-tool.js

@@ -91,7 +91,7 @@ d. 当只传入 startTime 时，返回该时间点之后的所有任务；当只
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 查询待办任务超时（60秒）", { sessionId, toolCallId: _toolCallId });
+                    logger.error("超时: 查询待办任务超时（60秒）", { toolCallId: _toolCallId });
                     reject(new Error("查询待办任务超时（60秒）"));
                 }, 60000);
                 const handler = (event) => {

package/dist/src/tools/save-file-to-phone-tool.js

@@ -119,7 +119,7 @@ export function createSaveFileToPhoneTool(ctx) {
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 保存文件到手机超时（60秒）", { sessionId, toolCallId });
+                    logger.error("超时: 保存文件到手机超时（60秒）", { toolCallId });
                     reject(new Error("保存文件到手机超时（60秒）"));
                 }, 60000);
                 // Listen for data events from WebSocket

package/dist/src/tools/save-media-to-gallery-tool.js

@@ -127,7 +127,7 @@ export function createSaveMediaToGalleryTool(ctx) {
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 保存媒体到图库超时（60秒）", { sessionId, toolCallId });
+                    logger.error("超时: 保存媒体到图库超时（60秒）", { toolCallId });
                     reject(new Error("保存媒体到图库超时（60秒）"));
                 }, 60000);
                 // Listen for data events from WebSocket

package/dist/src/tools/search-alarm-tool.js

@@ -168,7 +168,7 @@ b. 使用该工具之前需获取当前真实时间
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 检索闹钟超时（60秒）", { sessionId, toolCallId });
+                    logger.error("超时: 检索闹钟超时（60秒）", { toolCallId });
                     reject(new Error("检索闹钟超时（60秒）"));
                 }, 60000);
                 // Listen for data events from WebSocket

package/dist/src/tools/search-calendar-tool.js

@@ -139,7 +139,7 @@ d. 如果查询结果返回-303，代表查询结果为空
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 检索日程超时（60秒）", { sessionId, toolCallId });
+                    logger.error("超时: 检索日程超时（60秒）", { toolCallId });
                     reject(new Error("检索日程超时（60秒）"));
                 }, 60000);
                 // Listen for data events from WebSocket

package/dist/src/tools/search-contact-tool.js

@@ -67,7 +67,7 @@ export function createSearchContactTool(ctx) {
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 搜索联系人超时（60秒）", { sessionId, toolCallId });
+                    logger.error("超时: 搜索联系人超时（60秒）", { toolCallId });
                     reject(new Error("搜索联系人超时（60秒）"));
                 }, 60000);
                 // Listen for data events from WebSocket

package/dist/src/tools/search-email-tool.js

@@ -91,7 +91,7 @@ b. 使用该工具之前需获取当前真实时间
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 检索邮件超时（60秒）", { sessionId, toolCallId: _toolCallId });
+                    logger.error("超时: 检索邮件超时（60秒）", { toolCallId: _toolCallId });
                     reject(new Error("检索邮件超时（60秒）"));
                 }, 60000);
                 // Listen for data events from WebSocket

package/dist/src/tools/search-file-tool.js

@@ -11,15 +11,13 @@ export function createSearchFileTool(ctx) {
     return {
         name: "search_file",
         label: "Search File",
-        description: `搜索用户设备文件系统的文件。
+        description: `搜索手机或PC/电脑文件系统的文件。
 
-【重要】使用约束：此工具仅在用户显著说明要从手机/PC等用户设备搜索时才执行，例如：
-- "从我手机/鸿蒙PC里面搜索xxxx"
-- "从手机文件系统找一下xxxx"
-- "在手机上查找文件xxxx"
-- "搜索手机里的文件"
+【重要】使用场景与调用流程：
+1. 搜索手机文件：当用户明确说明要从手机搜索时（如"从手机里面搜索xxxx"、"在手机上查找文件xxxx"），直接调用此工具，无需传入 udid。
+2. 搜索PC/电脑文件：当用户要求搜索PC/电脑上的文件时（如"帮我找一下PC上的xxx文件"、"搜索电脑上的xxx"），必须先调用 find_pc_devices 工具获取设备ID（udid），然后将 udid 传入此工具进行搜索。
 
-如果用户没有明确说明从手机或者PC搜索（如仅说"搜索文件"、"找一下xxxx"），应默认从当前runtime运行环境的本地的文件系统查询，不要调用此工具。
+如果用户没有明确说明从手机或PC搜索（如仅说"搜索文件"、"找一下xxxx"），应默认从当前runtime运行环境的本地文件系统查询，不要调用此工具。
 
 功能说明：根据关键词搜索文件名称或内容，返回匹配的文件列表（包括文件名、路径、大小、修改时间等信息）。
 
@@ -31,6 +29,10 @@ export function createSearchFileTool(ctx) {
                     type: "string",
                     description: "搜索关键词，用于匹配文件名称、后缀名或文件内容",
                 },
+                udid: {
+                    type: "string",
+                    description: "PC/电脑设备ID。当搜索PC/电脑上的文件时，需要先通过 find_pc_devices 工具获取设备ID后传入。搜索手机文件时不需要传入此参数。",
+                },
             },
             required: ["query"],
         },
@@ -59,6 +61,7 @@ export function createSearchFileTool(ctx) {
                         timeOut: 5,
                         intentParam: {
                             query: params.query.trim(),
+                            ...(params.udid ? { udid: params.udid } : {}),
                         },
                         permissionId: [],
                         achieveType: "INTENT",
@@ -79,7 +82,7 @@ export function createSearchFileTool(ctx) {
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 搜索文件超时（60秒）", { sessionId, toolCallId });
+                    logger.error("超时: 搜索文件超时（60秒）", { toolCallId });
                     reject(new Error("搜索文件超时（60秒）"));
                 }, 60000);
                 // Listen for data events from WebSocket

package/dist/src/tools/search-message-tool.js

@@ -68,7 +68,7 @@ export function createSearchMessageTool(ctx) {
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 搜索短信超时（60秒）", { sessionId, toolCallId });
+                    logger.error("超时: 搜索短信超时（60秒）", { toolCallId });
                     reject(new Error("搜索短信超时（60秒）"));
                 }, 60000);
                 // Listen for data events from WebSocket

package/dist/src/tools/search-note-tool.js

@@ -66,7 +66,7 @@ export function createSearchNoteTool(ctx) {
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 搜索备忘录超时（60秒）", { sessionId, toolCallId });
+                    logger.error("超时: 搜索备忘录超时（60秒）", { toolCallId });
                     reject(new Error("搜索备忘录超时（60秒）"));
                 }, 60000);
                 // Listen for data events from WebSocket

package/dist/src/tools/search-photo-gallery-tool.js

@@ -128,7 +128,7 @@ async function searchPhotos(wsManager, config, sessionId, taskId, messageId, que
     return new Promise((resolve, reject) => {
         const timeout = setTimeout(() => {
             wsManager.off("data-event", handler);
-            logger.error("超时: 搜索照片超时（60秒）", { sessionId });
+            logger.error("超时: 搜索照片超时（60秒）");
             reject(new Error("搜索照片超时（60秒）"));
         }, 60000);
         const handler = (event) => {

package/dist/src/tools/send-email-tool.js

@@ -92,7 +92,7 @@ c. 调用工具前需认真检查调用参数是否满足工具要求
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 发送邮件超时（60秒）", { sessionId, toolCallId: _toolCallId });
+                    logger.error("超时: 发送邮件超时（60秒）", { toolCallId: _toolCallId });
                     reject(new Error("发送邮件超时（60秒）"));
                 }, 60000);
                 const handler = (event) => {

package/dist/src/tools/send-file-to-user-tool.js

@@ -240,10 +240,10 @@ b. 操作超时时间为2分钟（120秒），请勿重复调用此工具，如
                             error: { code: 0 },
                         }),
                     };
-                    logger.log(`[SEND-FILE-TO-USER] 🚀 EXEC sending: sessionId=${sessionId} taskId=${currentTaskId} fileName=${fileName}`);
+                    logger.log(`[SEND-FILE-TO-USER] EXEC sending, fileName=${fileName}`);
                     // Send WebSocket message
                     await wsManager.sendMessage(sessionId, agentResponse);
-                    logger.log(`send ${fileName} file to user success`);
+                    logger.log(`[SEND-FILE-TO-USER] send ${fileName} file to user success`);
                     sentFiles.push({ fileName, fileId });
                 }
                 return {

package/dist/src/tools/send-message-tool.js

@@ -89,7 +89,7 @@ export function createSendMessageTool(ctx) {
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 发送短信超时（60秒）", { sessionId, toolCallId });
+                    logger.error("超时: 发送短信超时（60秒）", { toolCallId });
                     reject(new Error("发送短信超时（60秒）"));
                 }, 60000);
                 // Listen for data events from WebSocket

package/dist/src/tools/session-manager.js

@@ -27,6 +27,11 @@ const getLastRegisteredKey = () => _g.__xyLastRegisteredSessionKey;
 const setLastRegisteredKey = (key) => { _g.__xyLastRegisteredSessionKey = key; };
 // AsyncLocalStorage for thread-safe session context isolation
 export const asyncLocalStorage = new AsyncLocalStorage();
+// Export AsyncLocalStorage to globalThis so logger.ts can access it
+// without creating a circular dependency (session-manager imports logger)
+if (!_g.__xyAsyncLocalStorage) {
+    _g.__xyAsyncLocalStorage = asyncLocalStorage;
+}
 /**
  * Register a session context for tool access.
  * Should be called when starting to process a message.

package/dist/src/tools/upload-file-tool.js

@@ -19,14 +19,19 @@ export function createUploadFileTool(ctx) {
     return {
         name: "upload_file",
         label: "Upload File",
-        description: `工具能力描述：将用户本地设备文件上传并获取可公网访问的 URL。
+        description: `工具能力描述：将手机或PC/电脑本地文件上传并获取可公网访问的 URL。
 
   前置工具调用：此工具使用前必须先通过call_device_tool调用 search_file 或者 query_collection 工具获取文件的 uri
 
+  使用场景与调用流程：
+  1. 上传手机文件：直接调用此工具，无需传入 udid。
+  2. 上传PC/电脑文件：当用户要求上传PC/电脑上的文件时，需要先通过 find_pc_devices 工具获取设备ID（udid），然后将 udid 传入此工具。
+
   工具参数说明：
   a. 入参中的fileInfos数组，每个元素必须包含mediaUri字段（对应于search_file工具或者query_collection返回结果中的uri），必须与search_file或者query_collection结果中对应的uri完全保持一致，不要自行修改。
   b. fileInfos中的timeout字段是可选的，表示上传文件超时时间，单位是毫秒，默认是20000（20秒）。
-  c. fileInfos 是文件在用户设备本地的信息数组（从 search_file 工具或者query_collection 工具响应中获取）。限制：每次最多支持传入 5 条文件信息。
+  c. fileInfos 是文件在本地的信息数组（从 search_file 工具或者query_collection 工具响应中获取）。限制：每次最多支持传入 5 条文件信息。
+  d. udid 是PC/电脑设备ID，仅在上传PC/电脑文件时需要传入（通过 find_pc_devices 工具获取）。
 
   注意事项：
   a. 操作超时时间为60秒,请勿重复调用此工具,如果超时或失败,最多重试一次。
@@ -39,6 +44,10 @@ export function createUploadFileTool(ctx) {
                     // 具体的类型验证和转换在 execute 函数内部进行
                     description: "文件信息数组，每个元素包含mediaUri（必需）和timeout（可选，默认20000）。必须先通过 search_file 工具获取。每次最多支持 5 条文件信息。",
                 },
+                udid: {
+                    type: "string",
+                    description: "PC/电脑设备ID。当上传PC/电脑上的文件时，需要先通过 find_pc_devices 工具获取设备ID后传入。上传手机文件时不需要传入此参数。",
+                },
             },
             required: ["fileInfos"],
         },
@@ -97,7 +106,7 @@ export function createUploadFileTool(ctx) {
             const wsManager = getXYWebSocketManager(config);
             // Get public URLs for the files
             const currentTaskId = getCurrentTaskId(sessionId) ?? taskId;
-            const fileUrls = await getFileUrls(wsManager, config, sessionId, currentTaskId, messageId, fileInfos);
+            const fileUrls = await getFileUrls(wsManager, config, sessionId, currentTaskId, messageId, fileInfos, params.udid);
             return {
                 content: [
                     {
@@ -117,7 +126,7 @@ export function createUploadFileTool(ctx) {
  * Get public URLs for files using fileInfos
  * Returns array of publicly accessible file URLs
  */
-async function getFileUrls(wsManager, config, sessionId, taskId, messageId, fileInfos) {
+async function getFileUrls(wsManager, config, sessionId, taskId, messageId, fileInfos, udid) {
     const command = {
         header: {
             namespace: "Common",
@@ -135,6 +144,7 @@ async function getFileUrls(wsManager, config, sessionId, taskId, messageId, file
                 timeOut: 5,
                 intentParam: {
                     fileInfos: fileInfos,
+                    ...(udid ? { udid } : {}),
                 },
                 permissionId: [],
                 achieveType: "INTENT",
@@ -154,7 +164,7 @@ async function getFileUrls(wsManager, config, sessionId, taskId, messageId, file
     return new Promise((resolve, reject) => {
         const timeout = setTimeout(() => {
             wsManager.off("data-event", handler);
-            logger.error("超时: 获取文件URL超时（60秒）", { sessionId });
+            logger.error("超时: 获取文件URL超时（60秒）");
             reject(new Error("获取文件URL超时（60秒）"));
         }, 60000);
         const handler = (event) => {

package/dist/src/tools/upload-photo-tool.js

@@ -137,7 +137,7 @@ async function getPhotoUrls(wsManager, config, sessionId, taskId, messageId, med
     return new Promise((resolve, reject) => {
         const timeout = setTimeout(() => {
             wsManager.off("data-event", handler);
-            logger.error("超时: 获取照片URL超时（60秒）", { sessionId });
+            logger.error("超时: 获取照片URL超时（60秒）");
             reject(new Error("获取照片URL超时（60秒）"));
         }, 60000);
         const handler = (event) => {

package/dist/src/tools/xiaoyi-add-collection-tool.js

@@ -145,7 +145,7 @@ export function createXiaoyiAddCollectionTool(ctx) {
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 添加小艺收藏超时（60秒）", { sessionId, toolCallId });
+                    logger.error("超时: 添加小艺收藏超时（60秒）", { toolCallId });
                     reject(new Error("添加小艺收藏超时（60秒）"));
                 }, 60000);
                 // Listen for data events from WebSocket

package/dist/src/tools/xiaoyi-collection-tool.js

@@ -100,7 +100,7 @@ export function createXiaoyiCollectionTool(ctx) {
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 查询小艺收藏超时（60秒）", { sessionId, toolCallId });
+                    logger.error("超时: 查询小艺收藏超时（60秒）", { toolCallId });
                     reject(new Error("查询小艺收藏超时（60秒）"));
                 }, 60000);
                 // Listen for data events from WebSocket

package/dist/src/tools/xiaoyi-delete-collection-tool.js

@@ -116,7 +116,7 @@ export function createXiaoyiDeleteCollectionTool(ctx) {
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("data-event", handler);
-                    logger.error("超时: 删除小艺收藏超时（60秒）", { sessionId, toolCallId });
+                    logger.error("超时: 删除小艺收藏超时（60秒）", { toolCallId });
                     reject(new Error("删除小艺收藏超时（60秒）"));
                 }, 60000);
                 // Listen for data events from WebSocket

package/dist/src/tools/xiaoyi-gui-tool.js

@@ -64,7 +64,7 @@ export function createXiaoyiGuiTool(ctx) {
             return new Promise((resolve, reject) => {
                 const timeout = setTimeout(() => {
                     wsManager.off("gui-agent-response", handler);
-                    logger.error("超时: XiaoYi GUI Agent 操作超时（5分钟）", { sessionId, toolCallId });
+                    logger.error("超时: XiaoYi GUI Agent 操作超时（5分钟）", { toolCallId });
                     reject(new Error("XiaoYi GUI Agent 操作超时（5分钟）"));
                 }, 180000); // 5 minutes timeout
                 // Listen for GUI agent response events