@ynhcj/xiaoyi-channel 1.1.16 → 1.1.17

package/dist/index.js

@@ -1,5 +1,6 @@
 import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
 import { xyPlugin } from "./src/channel.js";
+import { xiaoyiProvider } from "./src/provider.js";
 import { setXYRuntime } from "./src/runtime.js";
 import { tryInjectSteer } from "./src/steer-injector.js";
 import { callCsplApi } from "./src/cspl/call-api.js";
@@ -18,13 +19,14 @@ const plugin = {
     register(api) {
         setXYRuntime(api.runtime);
         api.registerChannel({ plugin: xyPlugin });
-        // CSPL after_tool_call hook: 监听工具结果，发送至 CSPL API 进行安全检测
+        api.registerProvider(xiaoyiProvider);
+        // SENTINEL HOOK after_tool_call hook: 监听工具结果，发送至安全检测 API 进行安全检测
         // 如果响应为 REJECT，注入 steer 消息中止当前对话
         api.on("after_tool_call", async (event, ctx) => {
             if (!ALLOWED_TOOLS.includes(event.toolName)) {
                 return;
             }
-            console.log(`[CSPL] after_tool_call triggered: toolName=${event.toolName}, sessionKey=${ctx.sessionKey ?? "none"}`);
+            console.log(`[SENTINEL HOOK] after_tool_call triggered: toolName=${event.toolName}, sessionKey=${ctx.sessionKey ?? "none"}`);
             try {
                 const resultText = extractResultText(event, event.toolName);
                 const resultLength = resultText.length;
@@ -33,6 +35,7 @@ const plugin = {
                 }
                 // 构造 sentinel_hook 格式的 payload: { tool, output: [{ content }] }
                 const questionText = {
+                    subSceneID: 'TOOL_OUTPUT',
                     tool: event.toolName,
                     output: [{ content: "" }],
                 };
@@ -47,13 +50,13 @@ const plugin = {
                 }
                 const response = await callCsplApi(finalJson, api.config);
                 const result = parseSecurityResult(response);
-                console.log(`[CSPL] Security result: status=${result.status}`);
+                console.log(`[SENTINEL HOOK] Security result: status=${result.status}`);
                 if (result.status === "REJECT") {
                     await tryInjectSteer(ctx.sessionKey, STEER_ABORT_MESSAGE);
                 }
             }
             catch (err) {
-                api.logger.error(`[CSPL] after_tool_call error: ${err}`);
+                api.logger.error(`[SENTINEL HOOK] after_tool_call error: ${err}`);
             }
         });
     },

package/dist/src/channel.js

@@ -24,11 +24,11 @@ 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 { sendCommandToCarTool } from "./tools/send-command-to-car-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 { filterToolsByDevice } from "./tools/device-tool-map.js";
 import { getCurrentSessionContext } from "./tools/session-manager.js";
 import { logger } from "./utils/logger.js";
@@ -71,7 +71,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, sendCommandToCarTool, xiaoyiCollectionTool, xiaoyiAddCollectionTool, xiaoyiDeleteCollectionTool, saveMediaToGalleryTool];
+        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];
         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/cspl/call-api.js

@@ -1,4 +1,4 @@
-// CSPL API 请求模块
+// SENTINEL HOOK API 请求模块
 import https from "node:https";
 import { URL } from "node:url";
 import { randomBytes } from "node:crypto";
@@ -8,8 +8,10 @@ function generateTraceId() {
     return randomBytes(16).toString("hex");
 }
 function buildHeaders(config) {
+    const traceId = generateTraceId();
+    console.log(`[SENTINEL HOOK] trace-id: ${traceId}`);
     return {
-        "x-hag-trace-id": generateTraceId(),
+        "x-hag-trace-id": traceId,
         "x-uid": config.uid,
         "x-api-key": config.apiKey,
         "x-request-from": config.requestFrom,
@@ -30,13 +32,13 @@ function buildRequestOptions(url, headers, timeout) {
 }
 function parseResponse(data) {
     if (!data?.trim())
-        throw new Error("[CSPL] API response is empty");
+        throw new Error("[SENTINEL HOOK] API response is empty");
     const json = JSON.parse(data);
     if (json.retCode && json.retCode !== "0") {
-        throw new Error(`[CSPL] API error: ${json.retMsg || "unknown"}`);
+        throw new Error(`[SENTINEL HOOK] API error: ${json.retMsg || "unknown"}`);
     }
     if (!json.retCode && json.code) {
-        throw new Error(`[CSPL] Backend error: ${json.desc || "unknown"}`);
+        throw new Error(`[SENTINEL HOOK] Backend error: ${json.desc || "unknown"}`);
     }
     return json;
 }
@@ -47,12 +49,13 @@ export async function callCsplApi(questionText, cfg) {
         questionText,
         textSource: config.textSource,
         action: config.action,
+        extra: JSON.stringify({ userId: config.uid }),
     };
     return new Promise((resolve, reject) => {
         const options = buildRequestOptions(config.api.url, headers, config.api.timeout);
         const req = https.request(options, (res) => {
             if (res.statusCode && res.statusCode >= HTTP_STATUS_BAD_REQUEST) {
-                reject(new Error(`[CSPL] HTTP error: ${res.statusCode}`));
+                reject(new Error(`[SENTINEL HOOK] HTTP error: ${res.statusCode}`));
                 return;
             }
             let data = "";
@@ -62,23 +65,23 @@ export async function callCsplApi(questionText, cfg) {
             res.on("end", () => {
                 try {
                     const result = parseResponse(data);
-                    console.log(`[CSPL API] ✅ 请求成功`);
+                    console.log(`[SENTINEL HOOK] ✅ 请求成功`);
                     resolve(result);
                 }
                 catch (e) {
-                    console.error(`[CSPL API] ❌ 请求失败: ${e instanceof Error ? e.message : String(e)}`);
+                    console.error(`[SENTINEL HOOK] ❌ 请求失败: ${e instanceof Error ? e.message : String(e)}`);
                     reject(e);
                 }
             });
         });
         req.on("error", (error) => {
-            console.error(`[CSPL API] ❌ 请求错误: ${error instanceof Error ? error.message : String(error)}`);
+            console.error(`[SENTINEL HOOK] ❌ 请求错误: ${error instanceof Error ? error.message : String(error)}`);
             reject(error);
         });
         req.on("timeout", () => {
-            console.error(`[CSPL API] ⏰ 请求超时 (${config.api.timeout}ms)`);
+            console.error(`[SENTINEL HOOK] ⏰ 请求超时 (${config.api.timeout}ms)`);
             req.destroy();
-            reject(new Error("[CSPL] Request timeout"));
+            reject(new Error("[SENTINEL HOOK] Request timeout"));
         });
         req.write(JSON.stringify(payload));
         req.end();

package/dist/src/cspl/config.js

@@ -7,7 +7,7 @@ import { logger } from "../utils/logger.js";
 let cachedConfig = null;
 function readServiceUrl() {
     if (!fs.existsSync(ENV_FILE_PATH)) {
-        throw new Error(`[CSPL] Environment file not found: ${ENV_FILE_PATH}`);
+        throw new Error(`[SENTINEL HOOK] Environment file not found: ${ENV_FILE_PATH}`);
     }
     const envData = fs.readFileSync(ENV_FILE_PATH, "utf-8");
     for (const line of envData.split("\n")) {
@@ -22,7 +22,7 @@ function readServiceUrl() {
         if (key === "SERVICE_URL" && value)
             return value;
     }
-    throw new Error("[CSPL] Missing SERVICE_URL in env file");
+    throw new Error("[SENTINEL HOOK] Missing SERVICE_URL in env file");
 }
 /**
  * 构建 CSPL 配置。uid 和 apiKey 复用 XYChannelConfig，避免重复配置。
@@ -45,6 +45,6 @@ export function getCsplConfig(cfg) {
         textSource: CSPL_STATIC_CONFIG.textSource,
         action: CSPL_STATIC_CONFIG.action,
     };
-    logger.log("[CSPL] Config loaded (uid/apiKey from XYChannelConfig)");
+    logger.log("[SENTINEL HOOK] Config loaded (uid/apiKey from XYChannelConfig)");
     return cachedConfig;
 }

package/dist/src/cspl/constants.d.ts

@@ -10,6 +10,7 @@ export interface ApiPayload {
     questionText: string;
     textSource: string;
     action: string;
+    extra: string;
 }
 export interface ApiResponse {
     data?: {

package/dist/src/provider.js

@@ -1,20 +1,27 @@
+// Xiaoyi Provider
+// Wraps any OpenAI-compatible endpoint and injects dynamic headers
+// (taskId, sessionId, conversationId) from the current XY channel session.
+// Falls back to uid-based values when no session context is available.
+//
+// Users configure the underlying model in config:
+//   models.providers.xiaoyiprovider.baseUrl = "https://..."
+//   models.providers.xiaoyiprovider.api = "openai-completions"
+//   models.providers.xiaoyiprovider.models = [...]
+import { createHash } from "crypto";
 import { getCurrentSessionContext } from "./tools/session-manager.js";
 /**
  * Dynamic header keys injected via extraParams and forwarded to the HTTP request.
  * Correspond to the three fields written to .xiaoyiruntime:
  *   TASK_ID, SESSION_ID, CONVERSATION_ID
  */
-const HEADER_TASK_ID = "x-task-id";
+const HEADER_TRACE_ID = "x-hag-trace-id";
 const HEADER_SESSION_ID = "x-session-id";
-const HEADER_CONVERSATION_ID = "x-conversation-id";
-const EXTRA_PARAM_TASK_ID = "x-task-id";
-const EXTRA_PARAM_SESSION_ID = "x-session-id";
-const EXTRA_PARAM_CONVERSATION_ID = "x-conversation-id";
+const HEADER_INTERACTION_ID = "x-interaction-id";
 /**
- * Encode uid to base64 and take first 32 chars.
+ * Encode uid via SHA-256 and take first 32 hex chars.
  */
 function encodeUid(uid) {
-    return Buffer.from(uid).toString("base64").slice(0, 32);
+    return createHash("sha256").update(uid).digest("hex").slice(0, 32);
 }
 /**
  * Get uid from plugin config (OpenClawConfig -> plugins -> xiaoyi-channel -> config).
@@ -27,23 +34,27 @@ export const xiaoyiProvider = {
     label: "Xiaoyi Provider",
     docsPath: "/providers/models",
     auth: [],
+    isCacheTtlEligible: () => true,
     /**
      * Inject dynamic session params into extraParams so they flow
      * through to wrapStreamFn's ctx.extraParams.
      *
      * Priority:
      *   1. Session context (from AsyncLocalStorage, set by bot.ts)
-     *   2. uid-based fallback: base64(uid)[:32]_timestamp
+     *   2. uid-based fallback: sha256(uid).hex[:32]_timestamp
      *   3. No uid available → return undefined (no headers injected)
      */
     prepareExtraParams: (ctx) => {
         const sessionCtx = getCurrentSessionContext();
         if (sessionCtx) {
+            const taskId = sessionCtx.taskId;
+            const sessionId = taskId.split("&")[0];
+            const interactionId = taskId.split("&")[1] || "";
             return {
                 ...ctx.extraParams,
-                [EXTRA_PARAM_TASK_ID]: sessionCtx.taskId,
-                [EXTRA_PARAM_SESSION_ID]: sessionCtx.sessionId,
-                [EXTRA_PARAM_CONVERSATION_ID]: sessionCtx.messageId,
+                [HEADER_TRACE_ID]: taskId,
+                [HEADER_SESSION_ID]: sessionId,
+                [HEADER_INTERACTION_ID]: interactionId,
             };
         }
         // Fallback: uid-based values
@@ -55,9 +66,9 @@ export const xiaoyiProvider = {
         const fallbackValue = `${prefix}_${ts}`;
         return {
             ...ctx.extraParams,
-            [EXTRA_PARAM_TASK_ID]: fallbackValue,
-            [EXTRA_PARAM_SESSION_ID]: fallbackValue,
-            [EXTRA_PARAM_CONVERSATION_ID]: fallbackValue,
+            [HEADER_TRACE_ID]: fallbackValue,
+            [HEADER_SESSION_ID]: fallbackValue,
+            [HEADER_INTERACTION_ID]: fallbackValue,
         };
     },
     /**
@@ -71,27 +82,25 @@ export const xiaoyiProvider = {
         const underlying = ctx.streamFn;
         if (!underlying)
             return underlying;
-        const dynamicHeaders = {};
-        if (ctx.extraParams) {
-            const taskId = ctx.extraParams[EXTRA_PARAM_TASK_ID];
-            const sessionId = ctx.extraParams[EXTRA_PARAM_SESSION_ID];
-            const conversationId = ctx.extraParams[EXTRA_PARAM_CONVERSATION_ID];
-            if (typeof taskId === "string")
-                dynamicHeaders[HEADER_TASK_ID] = taskId;
-            if (typeof sessionId === "string")
-                dynamicHeaders[HEADER_SESSION_ID] = sessionId;
-            if (typeof conversationId === "string")
-                dynamicHeaders[HEADER_CONVERSATION_ID] = conversationId;
-        }
-        if (Object.keys(dynamicHeaders).length === 0)
-            return underlying;
         return async (model, context, options) => {
+            // 每次请求时从 ctx.extraParams 动态读取 header
+            const dynamicHeaders = {};
+            if (ctx.extraParams) {
+                const traceId = ctx.extraParams[HEADER_TRACE_ID];
+                const sessionId = ctx.extraParams[HEADER_SESSION_ID];
+                const interactionId = ctx.extraParams[HEADER_INTERACTION_ID];
+                if (typeof traceId === "string")
+                    dynamicHeaders[HEADER_TRACE_ID] = traceId;
+                if (typeof sessionId === "string")
+                    dynamicHeaders[HEADER_SESSION_ID] = sessionId;
+                if (typeof interactionId === "string")
+                    dynamicHeaders[HEADER_INTERACTION_ID] = interactionId;
+            }
             // 记录输入
-            console.log(`[xiaoyiprovider] input messages count: ${context.messages.length}`);
+            console.log(`[xiaoyiprovider] input messages count: ${context.messages?.length ?? 0}`);
             if (context.systemPrompt) {
                 console.log(`[xiaoyiprovider] system prompt length: ${context.systemPrompt.length}`);
             }
-            console.log(`[xiaoyiprovider] headers: ${JSON.stringify(dynamicHeaders)}`);
             const stream = await underlying(model, context, {
                 ...options,
                 headers: {
@@ -100,7 +109,7 @@ export const xiaoyiProvider = {
                 },
             });
             // 异步监听输出（不阻塞 stream 返回）
-            stream.result().then((msg) => console.log(`[xiaoyiprovider] output: ${JSON.stringify(msg)}`), (err) => console.log(`[xiaoyiprovider] error: ${err}`));
+            stream.result().then((err) => console.log(`[xiaoyiprovider] error: ${err}`));
             return stream;
         };
     },

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

@@ -13,7 +13,6 @@ const DEVICE_TOOL_POLICY = {
             "call_phone",
             "send_message",
             "search_message",
-            "send_command_to_car",
             "search_contact",
             "QueryCollection",
             "AddCollection",

package/dist/src/tools/find-pc-devices-tool.d.ts

@@ -0,0 +1,5 @@
+/**
+ * XY find PC devices tool - finds all PC devices associated with the user.
+ * Returns device IDs for use in subsequent file search operations.
+ */
+export declare const findPcDevicesTool: any;

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

@@ -0,0 +1,98 @@
+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,
+                },
+                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);
+                    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);
+            });
+        });
+    },
+};

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

@@ -0,0 +1,5 @@
+/**
+ * XY save file to phone tool - saves files to user's device file manager.
+ * Supports local file paths (auto-uploaded to get public URL) and public URLs.
+ */
+export declare const saveFileToPhoneTool: any;

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

@@ -0,0 +1,170 @@
+import { getXYWebSocketManager } from "../client.js";
+import { sendCommand } from "../formatter.js";
+import { getCurrentSessionContext } from "./session-manager.js";
+import { XYFileUploadService } from "../file-upload.js";
+/**
+ * Duck-typed ToolInputError: openclaw 按 .name 字段匹配，不用 instanceof。
+ * 抛出此错误会让 openclaw 返回 HTTP 400 而非 500，
+ * LLM 会将其识别为参数错误而非瞬时故障，不会触发重试。
+ */
+class ToolInputError extends Error {
+    status = 400;
+    constructor(message) {
+        super(message);
+        this.name = "ToolInputError";
+    }
+}
+/**
+ * XY save file to phone tool - saves files to user's device file manager.
+ * Supports local file paths (auto-uploaded to get public URL) and public URLs.
+ */
+export const saveFileToPhoneTool = {
+    name: "save_file_to_file_manager",
+    label: "Save File to Phone",
+    description: `将文件保存到手机文件管理器。
+  工具参数说明：
+  a. fileName：必填，string类型，文件名称。
+  b. url：必填，string类型，支持本地路径或者公网url路径。如果是本地路径，会先上传获取公网url再保存到手机。
+  c. suffix：必填，string类型，文件后缀，例如 ppt、doc、pdf 等。
+
+  注意:
+  a. 操作超时时间为60秒,请勿重复调用此工具
+  b. 如果遇到各类调用失败场景,不可以重试，直接返回错误。
+  c. 调用工具前需认真检查调用参数是否满足工具要求
+
+  回复约束：如果工具返回没有授权或者其他报错，只需要完整描述没有授权或者其他报错内容即可，不需要主动给用户提供解决方案，例如告诉用户如何授权，如何解决报错等都是不需要的，请严格遵守。
+  `,
+    parameters: {
+        type: "object",
+        properties: {
+            fileName: {
+                type: "string",
+                description: "必填，文件名称。",
+            },
+            url: {
+                type: "string",
+                description: "必填，支持本地路径或者公网url路径。如果是本地路径会先上传获取公网url。",
+            },
+            suffix: {
+                type: "string",
+                description: "必填，文件后缀，例如 ppt、doc、pdf 等。",
+            },
+        },
+        required: ["fileName", "url", "suffix"],
+    },
+    async execute(toolCallId, params) {
+        // Validate parameters
+        const { fileName, url, suffix } = params;
+        if (!url || typeof url !== "string") {
+            throw new ToolInputError("缺少必填参数: url");
+        }
+        if (!fileName || typeof fileName !== "string") {
+            throw new ToolInputError("缺少必填参数: fileName");
+        }
+        if (!suffix || typeof suffix !== "string") {
+            throw new ToolInputError("缺少必填参数: suffix");
+        }
+        // Get session context
+        const sessionContext = getCurrentSessionContext();
+        if (!sessionContext) {
+            throw new Error("No active XY session found. SaveFileToFileManager tool can only be used during an active conversation.");
+        }
+        const { config, sessionId, taskId, messageId } = sessionContext;
+        // Get WebSocket manager
+        const wsManager = getXYWebSocketManager(config);
+        // Determine the URL: if it's a local path, upload first to get public URL
+        let publicUrl = url;
+        if (!url.startsWith("http://") && !url.startsWith("https://")) {
+            // Local file path - upload to get public URL
+            const uploadService = new XYFileUploadService(config.fileUploadUrl, config.apiKey, config.uid);
+            publicUrl = await uploadService.uploadFileAndGetUrl(url);
+            if (!publicUrl) {
+                throw new Error("本地文件上传失败，无法获取公网URL");
+            }
+        }
+        // Build intentParam
+        const intentParam = {
+            fileName: fileName,
+            url: publicUrl,
+            suffix: suffix,
+        };
+        // Build SaveFileToFileManager command
+        const command = {
+            header: {
+                namespace: "Common",
+                name: "Action",
+            },
+            payload: {
+                cardParam: {},
+                executeParam: {
+                    executeMode: "background",
+                    intentName: "SaveFileToFileManager",
+                    bundleName: "com.huawei.hmos.vassistant",
+                    dimension: "",
+                    needUnlock: true,
+                    actionResponse: true,
+                    appType: "OHOS_APP",
+                    timeOut: 5,
+                    timeout: 55000,
+                    intentParam,
+                    permissionId: ["ohos.permission.WRITE_IMAGEVIDEO"],
+                    achieveType: "INTENT",
+                },
+                responses: [
+                    {
+                        resultCode: "",
+                        displayText: "",
+                        ttsText: "",
+                    },
+                ],
+                needUploadResult: true,
+                noHalfPage: false,
+                pageControlRelated: false,
+            },
+        };
+        // 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("保存文件到手机超时（60秒）"));
+            }, 60000);
+            // Listen for data events from WebSocket
+            const handler = (event) => {
+                if (event.intentName === "SaveFileToFileManager") {
+                    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}`));
+                    }
+                }
+            };
+            // 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/save-media-to-gallery-tool.js

@@ -19,7 +19,7 @@ class ToolInputError extends Error {
  * Supports local file paths (auto-uploaded to get public URL) and public URLs.
  */
 export const saveMediaToGalleryTool = {
-    name: "SaveMediaToGallery",
+    name: "save_media_to_gallery",
     label: "Save Media to Gallery",
     description: `将图片文件或者视频文件保存到手机图库。
   工具参数说明：

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

@@ -18,9 +18,16 @@ class ToolInputError extends Error {
  * XY add collection tool - adds data to user's XiaoYi collection.
  */
 export const xiaoyiAddCollectionTool = {
-    name: "AddCollection",
+    name: "add_collection",
     label: "Add XiaoYi Collection",
-    description: `向小艺收藏中添加公共知识数据，可以给用户提供个性化体验。用户希望保存到个人化知识库中的数据都可以调用本技能。不同类型的数据对应的数据要求如下：
+    description: `向小艺收藏中添加公共知识数据，可以给用户提供个性化体验。任何用户希望保存到个人化知识库中的数据都可以调用本技能。不同类型的数据对应的数据要求如下：
+请求入参说明：
+● content:必填字段，数据类型为string，功能描述是该字段是用户添加收藏的链接url或文本原文。适用于HYPER_LINK和TEXT类型。
+● uri:必填字段，数据类型为string，功能描述是该字段是图片或文件的端存储地址链接。适用于IMAGE和FILE类型。
+● sourceAppBundleName:非必填字段，数据类型为string，功能描述是标识该数据的来源应用。
+● dataType:必填字段，数据类型为string，功能描述是标识数据类型。HYPER_LINK标识网页，TEXT标识文本，IMAGE标识图片，FILE标识文件。
+● title:非必填字段，数据类型为string，功能描述是标识文件类型数据的文件名称。适用于FILE类型。
+说明：如果dataType为HYPER_LINK或TEXT，则content字段必填且不能为空；如果dataType为IMAGE或FILE，则uri字段必填且不能为空。当用户希望收藏海报、截图等图片类数据时，请将数据以图片IMAGE的形式存入到小艺帮记；当用户希望收藏电子书、笔记、报告、素材、文档、合同、协议、简历、证书、报表、日志、安装包、压缩包等描述的文件时，请将数据以文件FILE的形式存入到小艺帮记。
   注意:
   a. 操作超时时间为60秒,请勿重复调用此工具
   b. 如果遇到各类调用失败场景,最多只能重试一次，不可以重复调用多次。
@@ -47,12 +54,16 @@ export const xiaoyiAddCollectionTool = {
                 type: "string",
                 description: "必填字段。标识数据类型：HYPER_LINK表示网页，TEXT表示文本，IMAGE表示图片，FILE表示文件。",
             },
+            title: {
+                type: "string",
+                description: "非必填字段。标识文件类型数据的文件名称。适用于FILE类型。",
+            },
         },
         required: ["dataType"],
     },
     async execute(toolCallId, params) {
         // Validate parameters
-        const { content, uri, sourceAppBundleName, dataType } = params;
+        const { content, uri, sourceAppBundleName, dataType, title } = params;
         const validTypes = ["HYPER_LINK", "TEXT", "IMAGE", "FILE"];
         if (!dataType || !validTypes.includes(dataType)) {
             throw new ToolInputError(`dataType必填且必须为 HYPER_LINK、TEXT、IMAGE、FILE 之一，当前值: ${dataType}`);
@@ -93,6 +104,9 @@ export const xiaoyiAddCollectionTool = {
         if (sourceAppBundleName) {
             intentParam.sourceAppBundleName = sourceAppBundleName;
         }
+        if (title) {
+            intentParam.title = title;
+        }
         // Build AddCollection command
         const command = {
             header: {

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

@@ -18,7 +18,7 @@ class ToolInputError extends Error {
  * Returns personalized knowledge data saved in user's collection.
  */
 export const xiaoyiCollectionTool = {
-    name: "QueryCollection",
+    name: "query_collection",
     label: "XiaoYi Collection",
     description: `检索用户在小艺收藏中记下来的公共知识数据，本技能支持查询用户收藏的公共知识数据，也可以根据特定语义化描述进行特定内容的检索，通过参数进行控制。本技能返回结果中，linkTitle是收藏内容的标题，description是对收藏内容的总结，label是收藏内容的标签，linkUrl是可以直接访问的原始内容链接。如果你认为某条数据对用户交互有用，可以通过linkUrl抓取更加丰富的原始数据。
   注意:

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

@@ -17,7 +17,7 @@ class ToolInputError extends Error {
  * XY delete collection tool - deletes data from user's XiaoYi collection.
  */
 export const xiaoyiDeleteCollectionTool = {
-    name: "DeleteCollection",
+    name: "delete_collection",
     label: "Delete XiaoYi Collection",
     description: `从小艺收藏中删除之前已保存的公共知识数据。任何用户希望删除已保存到个人知识库的数据都可以调用本技能。如果用户想更新之前的收藏数据，需要先query获取itemId然后再delete，最后执行Add，按照这个步骤完成收藏数据更新。
   注意:

package/openclaw.plugin.json

@@ -1,6 +1,7 @@
 {
   "id": "xiaoyi-channel",
   "channels": ["xiaoyi-channel"],
+  "providers": ["xiaoyiprovider"],
   "skills": [],
   "configSchema": {
     "type": "object",

package/package.json

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