@openclaw-china/wecom-app 0.1.2 → 0.1.3

package/dist/index.d.ts

@@ -41,6 +41,16 @@ type WecomAppAccountConfig = {
     };
     /** 媒体文件大小限制 (MB)，默认 100 */
     maxFileSizeMB?: number;
+    /**
+     * 语音发送转码策略（可选）
+     * enabled=true 时：当检测到 wav/mp3 等不支持的语音格式，
+     * - 若系统存在 ffmpeg：自动转码为 amr 再以 voice 发送
+     * - 若无 ffmpeg：降级为 file 发送
+     */
+    voiceTranscode?: {
+        enabled?: boolean;
+        prefer?: "amr";
+    };
     /** 欢迎文本 */
     welcomeText?: string;
     /** DM 策略 */
@@ -281,6 +291,19 @@ declare const wecomAppPlugin: {
                         };
                     };
                 };
+                voiceTranscode: {
+                    type: string;
+                    additionalProperties: boolean;
+                    properties: {
+                        enabled: {
+                            type: string;
+                        };
+                        prefer: {
+                            type: string;
+                            enum: string[];
+                        };
+                    };
+                };
                 welcomeText: {
                     type: string;
                 };

package/dist/index.js

@@ -1,7 +1,8 @@
+import { homedir, tmpdir } from 'os';
+import { join, extname, basename } from 'path';
 import crypto from 'crypto';
-import { mkdir, writeFile, unlink } from 'fs/promises';
-import { extname, join } from 'path';
-import { tmpdir } from 'os';
+import { mkdir, writeFile, rename, unlink, readdir, stat } from 'fs/promises';
+import { spawn } from 'child_process';
 
 var __defProp = Object.defineProperty;
 var __export = (target, all) => {
@@ -4048,8 +4049,6 @@ var coerce = {
   date: ((arg) => ZodDate.create({ ...arg, coerce: true }))
 };
 var NEVER = INVALID;
-
-// src/config.ts
 var DEFAULT_ACCOUNT_ID = "default";
 var WecomAppAccountSchema = external_exports.object({
   name: external_exports.string().optional(),
@@ -4071,6 +4070,13 @@ var WecomAppAccountSchema = external_exports.object({
     maxBytes: external_exports.number().optional(),
     keepDays: external_exports.number().optional()
   }).optional(),
+  // 语音发送策略（可选）：当遇到不支持的格式（如 wav/mp3）时，
+  // - enabled=true 且系统存在 ffmpeg：自动转码为 amr 后再发送 voice
+  // - 否则：降级为 file 发送（并可配合 caption 提示）
+  voiceTranscode: external_exports.object({
+    enabled: external_exports.boolean().optional(),
+    prefer: external_exports.enum(["amr"]).optional()
+  }).optional(),
   // 其他字段
   welcomeText: external_exports.string().optional(),
   dmPolicy: external_exports.enum(["open", "pairing", "allowlist", "disabled"]).optional(),
@@ -4107,6 +4113,14 @@ var WecomAppConfigJsonSchema = {
           keepDays: { type: "number" }
         }
       },
+      voiceTranscode: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          enabled: { type: "boolean" },
+          prefer: { type: "string", enum: ["amr"] }
+        }
+      },
       welcomeText: { type: "string" },
       dmPolicy: { type: "string", enum: ["open", "pairing", "allowlist", "disabled"] },
       allowFrom: { type: "array", items: { type: "string" } },
@@ -4234,15 +4248,24 @@ function resolveAllowFrom(config) {
 function resolveGroupAllowFrom(config) {
   return config.groupAllowFrom ?? [];
 }
+var DEFAULT_INBOUND_MEDIA_DIR = join(homedir(), ".openclaw", "media", "wecom-app", "inbound");
 var DEFAULT_INBOUND_MEDIA_MAX_BYTES = 10 * 1024 * 1024;
+var DEFAULT_INBOUND_MEDIA_KEEP_DAYS = 7;
 function resolveInboundMediaEnabled(config) {
   if (typeof config.inboundMedia?.enabled === "boolean") return config.inboundMedia.enabled;
   return true;
 }
+function resolveInboundMediaDir(config) {
+  return (config.inboundMedia?.dir ?? "").trim() || DEFAULT_INBOUND_MEDIA_DIR;
+}
 function resolveInboundMediaMaxBytes(config) {
   const v = config.inboundMedia?.maxBytes;
   return typeof v === "number" && Number.isFinite(v) && v > 0 ? v : DEFAULT_INBOUND_MEDIA_MAX_BYTES;
 }
+function resolveInboundMediaKeepDays(config) {
+  const v = config.inboundMedia?.keepDays;
+  return typeof v === "number" && Number.isFinite(v) && v >= 0 ? v : DEFAULT_INBOUND_MEDIA_KEEP_DAYS;
+}
 
 // ../../packages/shared/src/logger/logger.ts
 function createLogger(prefix, opts) {
@@ -4449,6 +4472,83 @@ function encryptWecomAppPlaintext(params) {
   return encrypted.toString("base64");
 }
 var DOWNLOAD_TIMEOUT = 12e4;
+function formatDateDir(d = /* @__PURE__ */ new Date()) {
+  const yyyy = d.getFullYear();
+  const mm = String(d.getMonth() + 1).padStart(2, "0");
+  const dd = String(d.getDate()).padStart(2, "0");
+  return `${yyyy}-${mm}-${dd}`;
+}
+function isProbablyInWecomTmpDir(p) {
+  try {
+    const base = join(tmpdir(), "wecom-app-media");
+    const norm = (s) => s.replace(/\\/g, "/").toLowerCase();
+    return norm(p).includes(norm(base));
+  } catch {
+    return false;
+  }
+}
+async function finalizeInboundMedia(account, filePath) {
+  const p = String(filePath ?? "").trim();
+  if (!p) return p;
+  if (!isProbablyInWecomTmpDir(p)) return p;
+  const baseDir = resolveInboundMediaDir(account.config ?? {});
+  const datedDir = join(baseDir, formatDateDir());
+  await mkdir(datedDir, { recursive: true });
+  const name = basename(p);
+  const dest = join(datedDir, name);
+  try {
+    await rename(p, dest);
+    return dest;
+  } catch {
+    try {
+      await unlink(p);
+    } catch {
+    }
+    return p;
+  }
+}
+async function pruneInboundMediaDir(account) {
+  const baseDir = resolveInboundMediaDir(account.config ?? {});
+  const keepDays = resolveInboundMediaKeepDays(account.config ?? {});
+  if (keepDays < 0) return;
+  const now = Date.now();
+  const cutoff = now - keepDays * 24 * 60 * 60 * 1e3;
+  let entries;
+  try {
+    entries = await readdir(baseDir);
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(entry)) continue;
+    const dirPath = join(baseDir, entry);
+    let st;
+    try {
+      st = await stat(dirPath);
+    } catch {
+      continue;
+    }
+    if (!st.isDirectory()) continue;
+    const dirTime = st.mtimeMs || st.ctimeMs || 0;
+    if (dirTime >= cutoff) continue;
+    let files = [];
+    try {
+      files = await readdir(dirPath);
+    } catch {
+      continue;
+    }
+    for (const f of files) {
+      const fp = join(dirPath, f);
+      try {
+        const fst = await stat(fp);
+        if (fst.isFile() && (fst.mtimeMs || fst.ctimeMs || 0) < cutoff) {
+          await unlink(fp);
+        }
+      } catch {
+      }
+    }
+  }
+}
 var FileSizeLimitError2 = class _FileSizeLimitError extends Error {
   actualSize;
   limitSize;
@@ -4584,12 +4684,6 @@ function parseContentDispositionFilename(headerValue) {
   if (m2?.[1]) return m2[1].trim().replace(/^"|"$/g, "");
   return void 0;
 }
-async function cleanupFile(filePath) {
-  try {
-    await unlink(filePath);
-  } catch {
-  }
-}
 function getWecomTempDir() {
   return join(tmpdir(), "wecom-app-media");
 }
@@ -5036,6 +5130,10 @@ async function downloadVoice(voiceUrl) {
 async function downloadAndSendVoice(account, target, voiceUrl) {
   try {
     console.log(`[wecom-app] Downloading voice from: ${voiceUrl}`);
+    const voiceExt = (voiceUrl.split("?")[0].match(/\.([^.]+)$/)?.[1] || "").toLowerCase();
+    if (voiceExt === "wav") {
+      console.warn(`[wecom-app] Voice format is .wav; WeCom usually expects .amr/.speex. Consider converting to .amr before sending.`);
+    }
     const { buffer: voiceBuffer, contentType } = await downloadVoice(voiceUrl);
     console.log(`[wecom-app] Voice downloaded, size: ${voiceBuffer.length} bytes, contentType: ${contentType || "unknown"}`);
     const extMatch = voiceUrl.match(/\.([^.]+)$/);
@@ -5050,10 +5148,13 @@ async function downloadAndSendVoice(account, target, voiceUrl) {
     return result;
   } catch (err) {
     console.error(`[wecom-app] downloadAndSendVoice error:`, err);
+    const rawMsg = err instanceof Error ? err.message : String(err);
+    const voiceExt = (voiceUrl.split("?")[0].match(/\.([^.]+)$/)?.[1] || "").toLowerCase();
+    const hint = voiceExt === "wav" ? "WeCom voice usually requires .amr/.speex. Your file is .wav; please convert to .amr and retry. (e.g., ffmpeg -i in.wav -ar 8000 -ac 1 -c:a amr_nb out.amr)" : "";
     return {
       ok: false,
       errcode: -1,
-      errmsg: err instanceof Error ? err.message : String(err)
+      errmsg: hint ? `${rawMsg} | hint: ${hint}` : rawMsg
     };
   }
 }
@@ -5166,9 +5267,26 @@ async function downloadAndSendFile(account, target, fileUrl) {
     console.log(`[wecom-app] Downloading file from: ${fileUrl}`);
     const { buffer: fileBuffer, contentType } = await downloadFile(fileUrl);
     console.log(`[wecom-app] File downloaded, size: ${fileBuffer.length} bytes, contentType: ${contentType || "unknown"}`);
-    const extMatch = fileUrl.match(/\.([^.]+)$/);
-    const ext = extMatch ? `.${extMatch[1]}` : ".bin";
-    const filename = `file${ext}`;
+    let filename = "file.bin";
+    try {
+      if (!fileUrl.startsWith("http://") && !fileUrl.startsWith("https://")) {
+        const path = await import('path');
+        const base = path.basename(fileUrl);
+        if (base && base !== "." && base !== "/") {
+          filename = base;
+        }
+      } else {
+        const u = new URL(fileUrl);
+        const base = u.pathname.split("/").filter(Boolean).pop();
+        if (base) filename = base;
+      }
+    } catch {
+    }
+    if (!/\.[A-Za-z0-9]{1,10}$/.test(filename)) {
+      const extMatch = fileUrl.split("?")[0].match(/\.([^.]+)$/);
+      const ext = extMatch ? `.${extMatch[1]}` : ".bin";
+      filename = `file${ext}`;
+    }
     console.log(`[wecom-app] Uploading file to WeCom media API, filename: ${filename}`);
     const mediaId = await uploadMedia(account, fileBuffer, filename, contentType, "file");
     console.log(`[wecom-app] File uploaded, media_id: ${mediaId}`);
@@ -5242,8 +5360,9 @@ async function enrichInboundContentWithMedia(params) {
     text,
     mediaPaths,
     cleanup: async () => {
-      for (const p of mediaPaths) {
-        await cleanupFile(p);
+      try {
+        await pruneInboundMediaDir(account);
+      } catch {
       }
     }
   });
@@ -5256,8 +5375,9 @@ async function enrichInboundContentWithMedia(params) {
       if (mediaId) {
         const saved = await downloadWecomMediaToFile(account, mediaId, { maxBytes, prefix: "img" });
         if (saved.ok && saved.path) {
-          mediaPaths.push(saved.path);
-          return makeResult(`[image] saved:${saved.path}`);
+          const finalPath = await finalizeInboundMedia(account, saved.path);
+          mediaPaths.push(finalPath);
+          return makeResult(`[image] saved:${finalPath}`);
         }
         return makeResult(`[image] (save failed) ${saved.error ?? ""}`.trim());
       }
@@ -5266,8 +5386,9 @@ async function enrichInboundContentWithMedia(params) {
         try {
           const saved = await downloadWecomMediaToFile(account, url, { maxBytes, prefix: "img" });
           if (saved.ok && saved.path) {
-            mediaPaths.push(saved.path);
-            return makeResult(`[image] saved:${saved.path}`);
+            const finalPath = await finalizeInboundMedia(account, saved.path);
+            mediaPaths.push(finalPath);
+            return makeResult(`[image] saved:${finalPath}`);
           }
         } catch {
         }
@@ -5284,8 +5405,9 @@ async function enrichInboundContentWithMedia(params) {
       if (mediaId) {
         const saved = await downloadWecomMediaToFile(account, mediaId, { maxBytes, prefix: "file" });
         if (saved.ok && saved.path) {
-          mediaPaths.push(saved.path);
-          return makeResult(`[file] saved:${saved.path}`);
+          const finalPath = await finalizeInboundMedia(account, saved.path);
+          mediaPaths.push(finalPath);
+          return makeResult(`[file] saved:${finalPath}`);
         }
         return makeResult(`[file] (save failed) ${saved.error ?? ""}`.trim());
       }
@@ -5302,12 +5424,13 @@ async function enrichInboundContentWithMedia(params) {
       if (mediaId) {
         const saved = await downloadWecomMediaToFile(account, mediaId, { maxBytes, prefix: "voice" });
         if (saved.ok && saved.path) {
-          mediaPaths.push(saved.path);
+          const finalPath = await finalizeInboundMedia(account, saved.path);
+          mediaPaths.push(finalPath);
           if (recognition) {
-            return makeResult(`[voice] saved:${saved.path}
+            return makeResult(`[voice] saved:${finalPath}
 [recognition] ${recognition}`);
           }
-          return makeResult(`[voice] saved:${saved.path}`);
+          return makeResult(`[voice] saved:${finalPath}`);
         }
         if (recognition) {
           return makeResult(`[voice] (save failed) ${saved.error ?? ""}
@@ -5350,8 +5473,9 @@ async function enrichInboundContentWithMedia(params) {
             try {
               const saved = await downloadWecomMediaToFile(account, mediaId, { maxBytes, prefix: "img" });
               if (saved.ok && saved.path) {
-                mediaPaths.push(saved.path);
-                parts.push(`[image] saved:${saved.path}`);
+                const finalPath = await finalizeInboundMedia(account, saved.path);
+                mediaPaths.push(finalPath);
+                parts.push(`[image] saved:${finalPath}`);
               } else {
                 const url = String(typed.image?.url ?? "").trim();
                 parts.push(url ? `[image] ${url}` : "[image]");
@@ -6069,14 +6193,40 @@ async function handleWecomAppWebhookRequest(req, res) {
   );
   return true;
 }
+async function hasFfmpeg() {
+  return new Promise((resolve) => {
+    const p = spawn("ffmpeg", ["-version"], { stdio: "ignore" });
+    p.on("error", () => resolve(false));
+    p.on("exit", (code) => resolve(code === 0));
+  });
+}
+async function transcodeToAmr(params) {
+  const args = ["-y", "-i", params.inputPath, "-ar", "8000", "-ac", "1", "-c:a", "amr_nb", params.outputPath];
+  await new Promise((resolve, reject) => {
+    const p = spawn("ffmpeg", args, { stdio: ["ignore", "ignore", "pipe"] });
+    let err = "";
+    p.stderr?.on("data", (d) => err += String(d));
+    p.on("error", (e) => reject(e));
+    p.on("exit", (code) => {
+      if (code === 0) return resolve();
+      reject(new Error(`ffmpeg transcode failed (code=${code}): ${err.slice(0, 2e3)}`));
+    });
+  });
+}
 
 // src/channel.ts
 function detectMediaType2(filePath, mimeType) {
   if (mimeType) {
     const mime = mimeType.split(";")[0].trim().toLowerCase();
+    if (mime.includes("svg")) {
+      return "file";
+    }
     if (mime.startsWith("image/")) {
       return "image";
     }
+    if (mime === "audio/wav" || mime === "audio/x-wav") {
+      return "file";
+    }
     if (mime.startsWith("audio/") || mime === "audio/amr") {
       return "voice";
     }
@@ -6089,10 +6239,16 @@ function detectMediaType2(filePath, mimeType) {
   if (imageExts.includes(ext)) {
     return "image";
   }
-  const voiceExts = ["amr", "speex", "mp3", "wav"];
+  if (ext === "svg") {
+    return "file";
+  }
+  const voiceExts = ["amr", "speex", "mp3"];
   if (voiceExts.includes(ext)) {
     return "voice";
   }
+  if (ext === "wav") {
+    return "file";
+  }
   return "file";
 }
 var meta = {
@@ -6383,8 +6539,53 @@ var wecomAppPlugin = {
           result = await downloadAndSendImage(account, target, params.mediaUrl);
         } else if (mediaType === "voice") {
           console.log(`[wecom-app] Routing to downloadAndSendVoice`);
-          result = await downloadAndSendVoice(account, target, params.mediaUrl);
+          const voiceUrl = params.mediaUrl;
+          const ext = (voiceUrl.split("?")[0].match(/\.([^.]+)$/)?.[1] || "").toLowerCase();
+          const likelyUnsupported = ext === "wav" || ext === "mp3";
+          const transcodeEnabled = Boolean(account.config.voiceTranscode?.enabled);
+          if (likelyUnsupported && transcodeEnabled) {
+            const can = await hasFfmpeg();
+            if (can) {
+              try {
+                if (!voiceUrl.startsWith("http://") && !voiceUrl.startsWith("https://")) {
+                  const os = await import('os');
+                  const path = await import('path');
+                  const fs = await import('fs');
+                  const out = path.join(os.tmpdir(), `wecom-app-voice-${Date.now()}.amr`);
+                  console.log(`[wecom-app] voiceTranscode: ffmpeg available, transcoding ${voiceUrl} -> ${out}`);
+                  await transcodeToAmr({ inputPath: voiceUrl, outputPath: out });
+                  result = await downloadAndSendVoice(account, target, out);
+                  try {
+                    await fs.promises.unlink(out);
+                  } catch {
+                  }
+                } else {
+                  console.warn(`[wecom-app] voiceTranscode enabled but mediaUrl is remote; fallback to file send (download once is not implemented yet)`);
+                  result = await downloadAndSendFile(account, target, voiceUrl);
+                }
+              } catch (e) {
+                console.warn(`[wecom-app] voiceTranscode failed; fallback to file send:`, e);
+                result = await downloadAndSendFile(account, target, voiceUrl);
+              }
+            } else {
+              console.warn(`[wecom-app] voiceTranscode enabled but ffmpeg not found; fallback to file send`);
+              result = await downloadAndSendFile(account, target, voiceUrl);
+            }
+          } else if (likelyUnsupported) {
+            console.log(`[wecom-app] Voice format .${ext} likely unsupported; fallback to file send`);
+            result = await downloadAndSendFile(account, target, voiceUrl);
+          } else {
+            result = await downloadAndSendVoice(account, target, voiceUrl);
+          }
         } else {
+          if (params.text?.trim()) {
+            try {
+              console.log(`[wecom-app] Sending caption text before file: ${params.text}`);
+              await sendWecomAppMessage(account, target, params.text);
+            } catch (err) {
+              console.warn(`[wecom-app] Failed to send caption before file:`, err);
+            }
+          }
           console.log(`[wecom-app] Routing to downloadAndSendFile`);
           result = await downloadAndSendFile(account, target, params.mediaUrl);
         }