@ynhcj/xiaoyi-channel 0.0.88-beta → 0.0.90-beta

package/dist/src/channel.js

@@ -2,34 +2,21 @@ import { resolveXYConfig, listXYAccountIds, getDefaultXYAccountId } from "./conf
 import { xyConfigSchema } from "./config-schema.js";
 import { xyOutbound } from "./outbound.js";
 import { locationTool } from "./tools/location-tool.js";
-import { noteTool } from "./tools/note-tool.js";
-import { searchNoteTool } from "./tools/search-note-tool.js";
-import { modifyNoteTool } from "./tools/modify-note-tool.js";
-import { calendarTool } from "./tools/calendar-tool.js";
-import { searchCalendarTool } from "./tools/search-calendar-tool.js";
-import { searchContactTool } from "./tools/search-contact-tool.js";
-import { searchPhotoGalleryTool } from "./tools/search-photo-gallery-tool.js";
-import { uploadPhotoTool } from "./tools/upload-photo-tool.js";
 import { xiaoyiGuiTool } from "./tools/xiaoyi-gui-tool.js";
-import { callPhoneTool } from "./tools/call-phone-tool.js";
-import { searchMessageTool } from "./tools/search-message-tool.js";
-import { sendMessageTool } from "./tools/send-message-tool.js";
-import { searchFileTool } from "./tools/search-file-tool.js";
-import { uploadFileTool } from "./tools/upload-file-tool.js";
-import { createAlarmTool } from "./tools/create-alarm-tool.js";
-import { searchAlarmTool } from "./tools/search-alarm-tool.js";
-import { modifyAlarmTool } from "./tools/modify-alarm-tool.js";
-import { deleteAlarmTool } from "./tools/delete-alarm-tool.js";
 import { sendFileToUserTool } from "./tools/send-file-to-user-tool.js";
 import { viewPushResultTool } from "./tools/view-push-result-tool.js";
 import { imageReadingTool } from "./tools/image-reading-tool.js";
 import { timestampToUtc8Tool } from "./tools/timestamp-to-utc8-tool.js";
-import { xiaoyiCollectionTool } from "./tools/xiaoyi-collection-tool.js";
-import { xiaoyiAddCollectionTool } from "./tools/xiaoyi-add-collection-tool.js";
-import { xiaoyiDeleteCollectionTool } from "./tools/xiaoyi-delete-collection-tool.js";
-import { saveMediaToGalleryTool } from "./tools/save-media-to-gallery-tool.js";
-import { saveFileToPhoneTool } from "./tools/save-file-to-phone-tool.js";
+import { sendEmailTool } from "./tools/send-email-tool.js";
 import { searchEmailTool } from "./tools/search-email-tool.js";
+import { callDeviceTool } from "./tools/call-device-tool.js";
+import { getNoteToolSchemaTool } from "./tools/get-note-tool-schema.js";
+import { getCalendarToolSchemaTool } from "./tools/get-calendar-tool-schema.js";
+import { getContactToolSchemaTool } from "./tools/get-contact-tool-schema.js";
+import { getPhotoToolSchemaTool } from "./tools/get-photo-tool-schema.js";
+import { getDeviceFileToolSchemaTool } from "./tools/get-device-file-tool-schema.js";
+import { getAlarmToolSchemaTool } from "./tools/get-alarm-tool-schema.js";
+import { getCollectionToolSchemaTool } from "./tools/get-collection-tool-schema.js";
 import { filterToolsByDevice } from "./tools/device-tool-map.js";
 import { getCurrentSessionContext } from "./tools/session-manager.js";
 import { logger } from "./utils/logger.js";
@@ -72,7 +59,7 @@ export const xyPlugin = {
     },
     outbound: xyOutbound,
     agentTools: () => {
-        const allTools = [locationTool, noteTool, searchNoteTool, modifyNoteTool, calendarTool, searchCalendarTool, searchContactTool, searchPhotoGalleryTool, uploadPhotoTool, xiaoyiGuiTool, callPhoneTool, searchMessageTool, sendMessageTool, searchFileTool, uploadFileTool, createAlarmTool, searchAlarmTool, modifyAlarmTool, deleteAlarmTool, sendFileToUserTool, viewPushResultTool, imageReadingTool, timestampToUtc8Tool, xiaoyiCollectionTool, xiaoyiAddCollectionTool, xiaoyiDeleteCollectionTool, saveMediaToGalleryTool, saveFileToPhoneTool, searchEmailTool];
+        const allTools = [locationTool, callDeviceTool, getNoteToolSchemaTool, getCalendarToolSchemaTool, getContactToolSchemaTool, getPhotoToolSchemaTool, xiaoyiGuiTool, getDeviceFileToolSchemaTool, getAlarmToolSchemaTool, getCollectionToolSchemaTool, sendFileToUserTool, viewPushResultTool, imageReadingTool, timestampToUtc8Tool, sendEmailTool, searchEmailTool];
         const ctx = getCurrentSessionContext();
         const filtered = filterToolsByDevice(allTools, ctx?.deviceType);
         logger.log(`[DEVICE-FILTER] deviceType=${ctx?.deviceType ?? "(none)"}, tools: ${allTools.length} → ${filtered.length} (${filtered.map(t => t.name).join(", ")})`);

package/dist/src/reply-dispatcher.js

@@ -267,6 +267,12 @@ export function createXYReplyDispatcher(params) {
                 log(`[TOOL START] Tool: ${name}, phase: ${phase}, taskId: ${currentTaskId}`);
                 if (phase === "start") {
                     const toolName = name || "unknown";
+                    // call_device_tool 由自身 execute() 内部发送具体子工具名的状态更新
+                    // get_xxx_tool_schema 是给 LLM 查 schema 用的，无需向用户展示
+                    if (toolName === "call_device_tool" || toolName.endsWith("_tool_schema")) {
+                        log(`[TOOL START] Skipping generic status for ${toolName}`);
+                        return;
+                    }
                     try {
                         await sendStatusUpdate({
                             config,

package/dist/src/tools/call-device-tool.d.ts

@@ -0,0 +1,5 @@
+/**
+ * call_device_tool - 通用端工具调度器。
+ * LLM 必须先通过 get_xxx_tool_schema 获取具体工具 schema，再用本工具执行。
+ */
+export declare const callDeviceTool: any;

package/dist/src/tools/call-device-tool.js

@@ -0,0 +1,126 @@
+import { noteTool } from "./note-tool.js";
+import { searchNoteTool } from "./search-note-tool.js";
+import { modifyNoteTool } from "./modify-note-tool.js";
+import { createAlarmTool } from "./create-alarm-tool.js";
+import { searchAlarmTool } from "./search-alarm-tool.js";
+import { modifyAlarmTool } from "./modify-alarm-tool.js";
+import { deleteAlarmTool } from "./delete-alarm-tool.js";
+import { searchContactTool } from "./search-contact-tool.js";
+import { callPhoneTool } from "./call-phone-tool.js";
+import { searchMessageTool } from "./search-message-tool.js";
+import { sendMessageTool } from "./send-message-tool.js";
+import { xiaoyiAddCollectionTool } from "./xiaoyi-add-collection-tool.js";
+import { xiaoyiCollectionTool } from "./xiaoyi-collection-tool.js";
+import { xiaoyiDeleteCollectionTool } from "./xiaoyi-delete-collection-tool.js";
+import { calendarTool } from "./calendar-tool.js";
+import { searchCalendarTool } from "./search-calendar-tool.js";
+import { searchPhotoGalleryTool } from "./search-photo-gallery-tool.js";
+import { uploadPhotoTool } from "./upload-photo-tool.js";
+import { saveMediaToGalleryTool } from "./save-media-to-gallery-tool.js";
+import { searchFileTool } from "./search-file-tool.js";
+import { uploadFileTool } from "./upload-file-tool.js";
+import { saveFileToPhoneTool } from "./save-file-to-phone-tool.js";
+import { sendStatusUpdate } from "../formatter.js";
+import { getCurrentSessionContext } from "./session-manager.js";
+import { getCurrentTaskId, getCurrentMessageId } from "../task-manager.js";
+/**
+ * 端工具注册表 —— 按 name 索引所有可通过 call_device_tool 调度的工具。
+ */
+const deviceToolRegistry = new Map([
+    [noteTool.name, noteTool],
+    [searchNoteTool.name, searchNoteTool],
+    [modifyNoteTool.name, modifyNoteTool],
+    [createAlarmTool.name, createAlarmTool],
+    [searchAlarmTool.name, searchAlarmTool],
+    [modifyAlarmTool.name, modifyAlarmTool],
+    [deleteAlarmTool.name, deleteAlarmTool],
+    [searchContactTool.name, searchContactTool],
+    [callPhoneTool.name, callPhoneTool],
+    [searchMessageTool.name, searchMessageTool],
+    [sendMessageTool.name, sendMessageTool],
+    [xiaoyiAddCollectionTool.name, xiaoyiAddCollectionTool],
+    [xiaoyiCollectionTool.name, xiaoyiCollectionTool],
+    [xiaoyiDeleteCollectionTool.name, xiaoyiDeleteCollectionTool],
+    [calendarTool.name, calendarTool],
+    [searchCalendarTool.name, searchCalendarTool],
+    [searchPhotoGalleryTool.name, searchPhotoGalleryTool],
+    [uploadPhotoTool.name, uploadPhotoTool],
+    [saveMediaToGalleryTool.name, saveMediaToGalleryTool],
+    [searchFileTool.name, searchFileTool],
+    [uploadFileTool.name, uploadFileTool],
+    [saveFileToPhoneTool.name, saveFileToPhoneTool],
+]);
+/**
+ * call_device_tool - 通用端工具调度器。
+ * LLM 必须先通过 get_xxx_tool_schema 获取具体工具 schema，再用本工具执行。
+ */
+export const callDeviceTool = {
+    name: "call_device_tool",
+    label: "Call Device Tool",
+    description: "用户设备侧工具调用。必须先调用get_xxx_tool_schema获取了具体的工具schema，才能使用本工具执行对应设备侧工具。",
+    parameters: {
+        type: "object",
+        properties: {
+            toolName: {
+                type: "string",
+                description: "要调用的具体端工具名称，即get_xxx_tool_schema返回的工具的name",
+            },
+            arguments: {
+                type: "object",
+                description: "工具所需的具体参数JSON键值对",
+            },
+        },
+        required: ["toolName", "arguments"],
+    },
+    async execute(toolCallId, params) {
+        const { toolName, arguments: toolArgs } = params;
+        // 向用户端发送具体工具名的状态更新
+        const ctx = getCurrentSessionContext();
+        if (ctx) {
+            const currentTaskId = getCurrentTaskId(ctx.sessionId) ?? ctx.taskId;
+            const currentMessageId = getCurrentMessageId(ctx.sessionId) ?? ctx.messageId;
+            try {
+                await sendStatusUpdate({
+                    config: ctx.config,
+                    sessionId: ctx.sessionId,
+                    taskId: currentTaskId,
+                    messageId: currentMessageId,
+                    text: `正在使用工具: ${toolName}...`,
+                    state: "working",
+                });
+            }
+            catch (_) {
+                // 状态更新失败不影响工具执行
+            }
+        }
+        const tool = deviceToolRegistry.get(toolName);
+        if (!tool) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `端工具${toolName}不存在。请确保toolName为get_xxx_tool_schema返回的工具的name。`,
+                    },
+                ],
+            };
+        }
+        try {
+            return await tool.execute(toolCallId, toolArgs);
+        }
+        catch (error) {
+            // ToolInputError (.name === "ToolInputError") 或其他参数校验错误
+            if (error.name === "ToolInputError") {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `端工具参数错误：${error.message}。请确保arguments符合get_xxx_tool_schema返回的工具schema。`,
+                        },
+                    ],
+                };
+            }
+            // 非参数错误（网络超时等），直接向上抛出
+            throw error;
+        }
+    },
+};

package/dist/src/tools/device-tool-map.js

@@ -14,9 +14,11 @@ const DEVICE_TOOL_POLICY = {
             "send_message",
             "search_message",
             "search_contact",
+            "get_contact_tool_schema",
             "query_collection",
             "add_collection",
             "delete_collection",
+            "get_collection_tool_schema",
         ],
     },
 };

package/dist/src/tools/get-alarm-tool-schema.d.ts

@@ -0,0 +1,16 @@
+export declare const getAlarmToolSchemaTool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+    execute(_toolCallId: string, _params: any): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/src/tools/get-alarm-tool-schema.js

@@ -0,0 +1,11 @@
+import { createSchemaTool } from "./schema-tool-factory.js";
+import { createAlarmTool } from "./create-alarm-tool.js";
+import { searchAlarmTool } from "./search-alarm-tool.js";
+import { modifyAlarmTool } from "./modify-alarm-tool.js";
+import { deleteAlarmTool } from "./delete-alarm-tool.js";
+export const getAlarmToolSchemaTool = createSchemaTool({
+    name: "get_alarm_tool_schema",
+    label: "Get Alarm Tool Schema",
+    description: "获取可在用户设备上创建、检索、修改、删除闹钟的相关端工具列表。",
+    tools: [createAlarmTool, searchAlarmTool, modifyAlarmTool, deleteAlarmTool],
+});

package/dist/src/tools/get-calendar-tool-schema.d.ts

@@ -0,0 +1,16 @@
+export declare const getCalendarToolSchemaTool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+    execute(_toolCallId: string, _params: any): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/src/tools/get-calendar-tool-schema.js

@@ -0,0 +1,9 @@
+import { createSchemaTool } from "./schema-tool-factory.js";
+import { calendarTool } from "./calendar-tool.js";
+import { searchCalendarTool } from "./search-calendar-tool.js";
+export const getCalendarToolSchemaTool = createSchemaTool({
+    name: "get_calendar_tool_schema",
+    label: "Get Calendar Tool Schema",
+    description: "获取可在用户设备上创建、检索日程的相关端工具列表。",
+    tools: [calendarTool, searchCalendarTool],
+});

package/dist/src/tools/get-collection-tool-schema.d.ts

@@ -0,0 +1,16 @@
+export declare const getCollectionToolSchemaTool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+    execute(_toolCallId: string, _params: any): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/src/tools/get-collection-tool-schema.js

@@ -0,0 +1,10 @@
+import { createSchemaTool } from "./schema-tool-factory.js";
+import { xiaoyiAddCollectionTool } from "./xiaoyi-add-collection-tool.js";
+import { xiaoyiCollectionTool } from "./xiaoyi-collection-tool.js";
+import { xiaoyiDeleteCollectionTool } from "./xiaoyi-delete-collection-tool.js";
+export const getCollectionToolSchemaTool = createSchemaTool({
+    name: "get_collection_tool_schema",
+    label: "Get Collection Tool Schema",
+    description: "获取可在用户设备上添加、检索、删除小艺收藏中的公共知识数据的相关端工具列表。",
+    tools: [xiaoyiAddCollectionTool, xiaoyiCollectionTool, xiaoyiDeleteCollectionTool],
+});

package/dist/src/tools/get-contact-tool-schema.d.ts

@@ -0,0 +1,16 @@
+export declare const getContactToolSchemaTool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+    execute(_toolCallId: string, _params: any): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/src/tools/get-contact-tool-schema.js

@@ -0,0 +1,11 @@
+import { createSchemaTool } from "./schema-tool-factory.js";
+import { searchContactTool } from "./search-contact-tool.js";
+import { callPhoneTool } from "./call-phone-tool.js";
+import { searchMessageTool } from "./search-message-tool.js";
+import { sendMessageTool } from "./send-message-tool.js";
+export const getContactToolSchemaTool = createSchemaTool({
+    name: "get_contact_tool_schema",
+    label: "Get Contact Tool Schema",
+    description: "获取可在用户设备上检索通讯录联系人信息、拨打电话、搜索短信与发送短信的相关端工具列表。",
+    tools: [searchContactTool, callPhoneTool, searchMessageTool, sendMessageTool],
+});

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

@@ -0,0 +1,16 @@
+export declare const getDeviceFileToolSchemaTool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+    execute(_toolCallId: string, _params: any): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

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

@@ -0,0 +1,10 @@
+import { createSchemaTool } from "./schema-tool-factory.js";
+import { searchFileTool } from "./search-file-tool.js";
+import { uploadFileTool } from "./upload-file-tool.js";
+import { saveFileToPhoneTool } from "./save-file-to-phone-tool.js";
+export const getDeviceFileToolSchemaTool = createSchemaTool({
+    name: "get_device_file_tool_schema",
+    label: "Get Device File Tool Schema",
+    description: "获取可在用户设备上搜索文件系统的文件、将用户设备本地文件上传到公网并获取链接、保存文件到文件管理器的相关端工具列表。",
+    tools: [searchFileTool, uploadFileTool, saveFileToPhoneTool],
+});

package/dist/src/tools/get-note-tool-schema.d.ts

@@ -0,0 +1,16 @@
+export declare const getNoteToolSchemaTool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+    execute(_toolCallId: string, _params: any): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

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

@@ -0,0 +1,10 @@
+import { createSchemaTool } from "./schema-tool-factory.js";
+import { noteTool } from "./note-tool.js";
+import { searchNoteTool } from "./search-note-tool.js";
+import { modifyNoteTool } from "./modify-note-tool.js";
+export const getNoteToolSchemaTool = createSchemaTool({
+    name: "get_note_tool_schema",
+    label: "Get Note Tool Schema",
+    description: "获取可在用户设备上创建、搜索、追加备忘录的相关端工具列表。",
+    tools: [noteTool, searchNoteTool, modifyNoteTool],
+});

package/dist/src/tools/get-photo-tool-schema.d.ts

@@ -0,0 +1,16 @@
+export declare const getPhotoToolSchemaTool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+    execute(_toolCallId: string, _params: any): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/dist/src/tools/get-photo-tool-schema.js

@@ -0,0 +1,10 @@
+import { createSchemaTool } from "./schema-tool-factory.js";
+import { searchPhotoGalleryTool } from "./search-photo-gallery-tool.js";
+import { uploadPhotoTool } from "./upload-photo-tool.js";
+import { saveMediaToGalleryTool } from "./save-media-to-gallery-tool.js";
+export const getPhotoToolSchemaTool = createSchemaTool({
+    name: "get_photo_tool_schema",
+    label: "Get Photo Tool Schema",
+    description: "获取可在用户设备上搜索图库照片、将照片上传到公网并获取链接、保存图片或视频到图库的相关端工具列表。",
+    tools: [searchPhotoGalleryTool, uploadPhotoTool, saveMediaToGalleryTool],
+});

package/dist/src/tools/schema-tool-factory.d.ts

@@ -0,0 +1,27 @@
+/**
+ * schema-tool-factory: 创建 get_xxx_tool_schema 工具。
+ * 每个工具在被 LLM 调用时，返回其所包含的子工具的 name / description / parameters schema。
+ */
+interface SchemaToolOptions {
+    name: string;
+    label: string;
+    description: string;
+    tools: any[];
+}
+export declare function createSchemaTool(options: SchemaToolOptions): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+    execute(_toolCallId: string, _params: any): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+export {};

package/dist/src/tools/schema-tool-factory.js

@@ -0,0 +1,32 @@
+/**
+ * schema-tool-factory: 创建 get_xxx_tool_schema 工具。
+ * 每个工具在被 LLM 调用时，返回其所包含的子工具的 name / description / parameters schema。
+ */
+export function createSchemaTool(options) {
+    const { name, label, description, tools } = options;
+    return {
+        name,
+        label,
+        description,
+        parameters: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+        async execute(_toolCallId, _params) {
+            const schemas = tools.map((t) => ({
+                name: t.name,
+                description: t.description,
+                parameters: t.parameters,
+            }));
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(schemas, null, 2),
+                    },
+                ],
+            };
+        },
+    };
+}

package/dist/src/tools/send-email-tool.d.ts

@@ -0,0 +1,4 @@
+/**
+ * XY send email tool - sends an email via 花瓣邮箱 on user's device.
+ */
+export declare const sendEmailTool: any;

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

@@ -0,0 +1,134 @@
+// Send Email tool implementation
+import { getXYWebSocketManager } from "../client.js";
+import { sendCommand } from "../formatter.js";
+import { getCurrentSessionContext } from "./session-manager.js";
+class ToolInputError extends Error {
+    status = 400;
+    constructor(message) {
+        super(message);
+        this.name = "ToolInputError";
+    }
+}
+/**
+ * XY send email tool - sends an email via 花瓣邮箱 on user's device.
+ */
+export const sendEmailTool = {
+    name: "send_email",
+    label: "Send Email",
+    description: `在用户设备上通过花瓣邮箱发送邮件。
+注意：
+a. 操作超时时间为60秒，请勿重复调用此工具
+b. 如果遇到各类调用失败场景，最多只能重试一次，不可以重复调用多次。
+c. 调用工具前需认真检查调用参数是否满足工具要求
+
+回复约束：如果工具返回没有授权或者其他报错，只需要完整描述没有授权或者其他报错内容即可，不需要主动给用户提供解决方案，例如告诉用户如何授权，如何解决报错等都是不需要的，请严格遵守。`,
+    parameters: {
+        type: "object",
+        properties: {
+            subject: {
+                type: "string",
+                description: "邮件主题，必填",
+            },
+            to: {
+                type: "string",
+                description: "收件人邮箱地址，必填",
+            },
+            body: {
+                type: "string",
+                description: "邮件内容，必填",
+            },
+        },
+        required: ["subject", "to", "body"],
+    },
+    async execute(_toolCallId, params) {
+        if (typeof params.subject !== "string" || !params.subject.trim()) {
+            throw new ToolInputError("缺少必填参数 subject（邮件主题）");
+        }
+        if (typeof params.to !== "string" || !params.to.trim()) {
+            throw new ToolInputError("缺少必填参数 to（收件人邮箱地址）");
+        }
+        if (typeof params.body !== "string" || !params.body.trim()) {
+            throw new ToolInputError("缺少必填参数 body（邮件内容）");
+        }
+        const sessionContext = getCurrentSessionContext();
+        if (!sessionContext) {
+            throw new Error("No active XY session found. Send email tool can only be used during an active conversation.");
+        }
+        const { config, sessionId, taskId, messageId } = sessionContext;
+        const wsManager = getXYWebSocketManager(config);
+        const command = {
+            header: {
+                namespace: "Common",
+                name: "Action",
+            },
+            payload: {
+                cardParam: {},
+                executeParam: {
+                    executeMode: "background",
+                    intentName: "SendEmail",
+                    bundleName: "com.huawei.hmos.email",
+                    needUnlock: true,
+                    actionResponse: true,
+                    appType: "OHOS_APP",
+                    timeOut: 5,
+                    intentParam: {
+                        subject: params.subject.trim(),
+                        to: [params.to.trim()],
+                        body: params.body.trim(),
+                    },
+                    permissionId: [],
+                    achieveType: "INTENT",
+                },
+                responses: [
+                    {
+                        resultCode: "",
+                        displayText: "",
+                        ttsText: "",
+                    },
+                ],
+                needUploadResult: true,
+                noHalfPage: false,
+                pageControlRelated: false,
+            },
+        };
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                wsManager.off("data-event", handler);
+                reject(new Error("发送邮件超时（60秒）"));
+            }, 60000);
+            const handler = (event) => {
+                if (event.intentName === "SendEmail") {
+                    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(`发送邮件失败: ${event.status}`));
+                    }
+                }
+            };
+            wsManager.on("data-event", handler);
+            sendCommand({
+                config,
+                sessionId,
+                taskId,
+                messageId,
+                command,
+            })
+                .then(() => { })
+                .catch((error) => {
+                clearTimeout(timeout);
+                wsManager.off("data-event", handler);
+                reject(error);
+            });
+        });
+    },
+};

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

@@ -18,7 +18,7 @@ export const uploadFileTool = {
     label: "Upload File",
     description: `工具能力描述：将用户本地设备文件上传并获取可公网访问的 URL。
 
-  前置工具调用：此工具使用前必须先调用 search_file 或者 query_collection 工具获取文件的 uri
+  前置工具调用：此工具使用前必须先通过call_device_tool调用 search_file 或者 query_collection 工具获取文件的 uri
 
   工具参数说明：
   a. 入参中的fileInfos数组，每个元素必须包含mediaUri字段（对应于search_file工具或者query_collection返回结果中的uri），必须与search_file或者query_collection结果中对应的uri完全保持一致，不要自行修改。

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

@@ -14,7 +14,7 @@ export const uploadPhotoTool = {
     label: "Upload Photo",
     description: `工具能力描述：将用户本地设备文件回传并获取可公网访问的 URL。
   
-  前置工具调用：此工具使用前必须先调用 search_photo_gallery 工具获取照片的 mediaUri或者thumbnailUri
+  前置工具调用：此工具使用前必须先通过call_device_tool工具调用 search_photo_gallery 工具获取照片的 mediaUri或者thumbnailUri
   工具参数说明：
   a. 入参中的mediaUris中的mediaUri必须与search_photo_gallery结果中对应的mediaUri或者thumbnailUri完全保持一致，不要自行修改，必须是file:://开头的路径。
   b. 优先使用search_photo_gallery结果中的thumbnailUri作为入参，thumbnailUri是缩略图，清晰度与文件大小都非常合适展示给用户，如果thumbnailUri不存在或者用户要求使用原图，则使用search_photo_gallery结果中对应的mediaUri

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

@@ -25,7 +25,7 @@ export const xiaoyiCollectionTool = {
   a. 操作超时时间为60秒,请勿重复调用此工具
   b. 如果遇到各类调用失败场景,最多只能重试一次，不可以重复调用多次。
   c. 调用工具前需认真检查调用参数是否满足工具要求
-  d. 如果用户希望获取文件，可以使用upload_file工具完成文件上传
+  d. 如果用户希望获取文件，可以使用call_device_tool工具调用upload_file工具完成文件上传
 
   回复约束：如果工具返回没有授权或者其他报错，只需要完整描述没有授权或者其他报错内容即可，不需要主动给用户提供解决方案，例如告诉用户如何授权，如何解决报错等都是不需要的，请严格遵守。
   `,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ynhcj/xiaoyi-channel",
-  "version": "0.0.88-beta",
+  "version": "0.0.90-beta",
   "description": "OpenClaw Xiaoyi Channel plugin - Xiaoyi A2A protocol integration",
   "type": "module",
   "main": "./dist/index.js",