@wecom/wecom-openclaw-plugin 2026.3.25-beta.2 → 2026.3.25-beta.3

package/dist/index.cjs.js

@@ -1220,24 +1220,31 @@ const MODE_ALIASES = {
 };
 /**
  * 修正 checkbox.mode：
- * - 整数 → 原样
+ * - 0 → 单选，1 → 多选，仅允许这两个值
  * - 字符串数字 "0"/"1" → 整数
  * - 语义别名 "multi"/"single" 等 → 对应整数
+ * - 其他正整数（如 2）→ clamp 到 1（多选）
  * - 无法识别 → 删除（让服务端使用默认值 0）
  */
 function coerceCheckboxMode(value) {
+    let num;
     if (typeof value === "number" && Number.isFinite(value)) {
-        return Math.round(value);
+        num = Math.round(value);
     }
-    if (typeof value === "string") {
+    else if (typeof value === "string") {
         const trimmed = value.trim().toLowerCase();
         if (trimmed in MODE_ALIASES)
             return MODE_ALIASES[trimmed];
-        const num = Number(trimmed);
-        if (!Number.isNaN(num))
-            return Math.round(num);
+        const parsed = Number(trimmed);
+        if (!Number.isNaN(parsed))
+            num = Math.round(parsed);
     }
-    return undefined;
+    if (num === undefined)
+        return undefined;
+    // mode 只允许 0（单选）或 1（多选），超出范围 clamp
+    if (num <= 0)
+        return 0;
+    return 1;
 }
 /**
  * 对 LLM 生成的模板卡片 JSON 做字段类型修正，确保符合企业微信 API 的类型要求。
@@ -1396,6 +1403,290 @@ function normalizeTemplateCardFields(card, log) {
     }
     return card;
 }
+// ============================================================================
+// 必填字段校验与自动补全
+// ============================================================================
+/** task_id 合法字符：数字、字母、_-@ */
+const TASK_ID_RE = /^[a-zA-Z0-9_\-@]+$/;
+/**
+ * 生成一个合法的 task_id。
+ * 格式：task_{cardType}_{timestamp}_{随机4位}，确保唯一且符合 API 要求。
+ */
+function generateTaskId(cardType) {
+    const rand = Math.random().toString(36).slice(2, 6);
+    return `task_${cardType}_${Date.now()}_${rand}`;
+}
+/**
+ * 校验并补全模板卡片的必填字段。
+ *
+ * 在 normalizeTemplateCardFields（类型修正）之后调用，确保卡片结构满足企业微信 API 的必填要求。
+ *
+ * 补全策略：
+ * - task_id：所有卡片统一自动补全（交互型 API 必填，通知型插件也需要用于缓存回写）
+ * - main_title：除 text_notice 外的 4 种卡片 API 必填，自动补 { title: "通知" }
+ *   text_notice 要求 main_title.title 与 sub_title_text 至少填一个，缺两个时补 sub_title_text
+ * - card_action：text_notice / news_notice API 必填，自动补 { type: 1, url: "https://work.weixin.qq.com" }
+ * - checkbox：vote_interaction API 必填，无法凭空补全，仅记告警
+ * - submit_button：vote_interaction / multiple_interaction API 必填，自动补 { text: "提交", key: "submit_default" }
+ * - button_list：button_interaction API 必填，无法凭空补全，仅记告警
+ * - select_list：multiple_interaction API 必填，无法凭空补全，仅记告警
+ */
+function validateAndFixRequiredFields(card, log) {
+    const cardType = card.card_type;
+    const fixes = [];
+    const warnings = [];
+    // ── task_id（所有卡片） ────────────────────────────────────────────
+    if (!card.task_id || typeof card.task_id !== "string" || !card.task_id.trim()) {
+        const generated = generateTaskId(cardType);
+        fixes.push(`task_id: (missing) → "${generated}"`);
+        card.task_id = generated;
+    }
+    else {
+        // 校验合法性：只能由数字、字母和 "_-@" 组成
+        const tid = card.task_id;
+        if (!TASK_ID_RE.test(tid)) {
+            // 尝试清理非法字符
+            const cleaned = tid.replace(/[^a-zA-Z0-9_\-@]/g, "_").slice(0, 128);
+            if (cleaned && TASK_ID_RE.test(cleaned)) {
+                fixes.push(`task_id: "${tid}" → "${cleaned}" (cleaned illegal chars)`);
+                card.task_id = cleaned;
+            }
+            else {
+                const generated = generateTaskId(cardType);
+                fixes.push(`task_id: "${tid}" → "${generated}" (replaced, too many illegal chars)`);
+                card.task_id = generated;
+            }
+        }
+    }
+    // ── main_title ────────────────────────────────────────────────────────
+    const mainTitle = card.main_title;
+    const hasMainTitle = mainTitle && typeof mainTitle === "object" &&
+        (typeof mainTitle.title === "string" && mainTitle.title.trim());
+    const hasSubTitleText = typeof card.sub_title_text === "string" && card.sub_title_text.trim();
+    switch (cardType) {
+        case "text_notice":
+            // text_notice: main_title.title 和 sub_title_text 至少一个
+            if (!hasMainTitle && !hasSubTitleText) {
+                card.sub_title_text = card.sub_title_text || "通知";
+                fixes.push(`sub_title_text: (missing, no main_title either) → fallback "通知"`);
+            }
+            break;
+        case "news_notice":
+        case "button_interaction":
+        case "vote_interaction":
+        case "multiple_interaction":
+            // 这四种 main_title 为必填
+            if (!mainTitle || typeof mainTitle !== "object") {
+                card.main_title = { title: "通知" };
+                fixes.push(`main_title: (missing) → { title: "通知" }`);
+            }
+            else if (!hasMainTitle) {
+                mainTitle.title = "通知";
+                fixes.push(`main_title.title: (empty) → "通知"`);
+            }
+            break;
+    }
+    // ── card_action（text_notice / news_notice 必填） ──────────────────
+    if (cardType === "text_notice" || cardType === "news_notice") {
+        if (!card.card_action || typeof card.card_action !== "object") {
+            card.card_action = { type: 1, url: "https://work.weixin.qq.com" };
+            fixes.push(`card_action: (missing) → { type: 1, url: "https://work.weixin.qq.com" }`);
+        }
+    }
+    // ── submit_button（vote_interaction / multiple_interaction 必填） ──
+    if (cardType === "vote_interaction" || cardType === "multiple_interaction") {
+        if (!card.submit_button || typeof card.submit_button !== "object") {
+            card.submit_button = { text: "提交", key: `submit_${cardType}_${Date.now()}` };
+            fixes.push(`submit_button: (missing) → auto-generated`);
+        }
+    }
+    // ── 核心业务字段（无法凭空补全，仅告警） ────────────────────────────
+    if (cardType === "button_interaction") {
+        if (!Array.isArray(card.button_list) || card.button_list.length === 0) {
+            warnings.push(`button_list is missing or empty (required for button_interaction)`);
+        }
+    }
+    if (cardType === "vote_interaction") {
+        if (!card.checkbox || typeof card.checkbox !== "object") {
+            warnings.push(`checkbox is missing (required for vote_interaction)`);
+        }
+    }
+    if (cardType === "multiple_interaction") {
+        if (!Array.isArray(card.select_list) || card.select_list.length === 0) {
+            warnings.push(`select_list is missing or empty (required for multiple_interaction)`);
+        }
+    }
+    if (fixes.length > 0) {
+        log?.(`[template-card-parser] validateAndFixRequiredFields: ${fixes.length} fix(es): ${fixes.join("; ")}`);
+    }
+    if (warnings.length > 0) {
+        log?.(`[template-card-parser] validateAndFixRequiredFields: ${warnings.length} warning(s): ${warnings.join("; ")}`);
+    }
+    return card;
+}
+// ============================================================================
+// 简化格式 → 企微 API 格式转换（vote_interaction / multiple_interaction）
+// ============================================================================
+/**
+ * 生成唯一的 question_key / submit_button.key。
+ */
+function generateKey(prefix) {
+    const rand = Math.random().toString(36).slice(2, 6);
+    return `${prefix}_${Date.now()}_${rand}`;
+}
+/**
+ * 将 vote_interaction 的简化格式转换为企微 API 格式。
+ *
+ * 简化格式字段：
+ *   title        → main_title.title
+ *   description  → main_title.desc
+ *   options      → checkbox.option_list（每个 {id, text} 直接透传）
+ *   mode         → checkbox.mode（0=单选 1=多选）
+ *   submit_text  → submit_button.text
+ *
+ * 代码自动生成：checkbox.question_key, submit_button.key
+ *
+ * 如果 LLM 已输出了合法的 API 原始格式（有 checkbox.option_list），则跳过转换直接透传。
+ */
+function transformVoteInteraction(card, log) {
+    // 防御性：如果已经是合法 API 格式，跳过
+    const existingCheckbox = card.checkbox;
+    if (existingCheckbox && typeof existingCheckbox === "object" && Array.isArray(existingCheckbox.option_list)) {
+        log?.(`[template-card-parser] transformVoteInteraction: already has checkbox.option_list, skipping transform`);
+        return card;
+    }
+    // 提取 options（简化格式的核心字段）
+    const options = card.options;
+    if (!Array.isArray(options) || options.length === 0) {
+        log?.(`[template-card-parser] transformVoteInteraction: no "options" array found, skipping transform`);
+        return card;
+    }
+    log?.(`[template-card-parser] transformVoteInteraction: transforming simplified format → API format`);
+    log?.(`[template-card-parser] transformVoteInteraction: input=${JSON.stringify(card)}`);
+    // ── 构建 main_title ──
+    const title = card.title;
+    const description = card.description;
+    if (title || description) {
+        card.main_title = {
+            ...(title ? { title } : {}),
+            ...(description ? { desc: description } : {}),
+        };
+        delete card.title;
+        delete card.description;
+    }
+    // ── 构建 checkbox（最多 20 个选项） ──
+    const mode = coerceCheckboxMode(card.mode) ?? 0;
+    const questionKey = generateKey("vote");
+    const clampedOptions = options.slice(0, 20);
+    if (options.length > 20) {
+        log?.(`[template-card-parser] transformVoteInteraction: options count ${options.length} exceeds max 20, clamped to 20`);
+    }
+    card.checkbox = {
+        question_key: questionKey,
+        mode,
+        option_list: clampedOptions.map((opt) => ({
+            id: String(opt.id ?? opt.value ?? `opt_${Math.random().toString(36).slice(2, 6)}`),
+            text: String(opt.text ?? opt.label ?? opt.name ?? ""),
+        })),
+    };
+    delete card.options;
+    delete card.mode;
+    // ── 构建 submit_button ──
+    const submitText = card.submit_text || "提交";
+    card.submit_button = {
+        text: submitText,
+        key: generateKey("submit_vote"),
+    };
+    delete card.submit_text;
+    // ── 清理 LLM 可能杜撰的无效字段 ──
+    delete card.vote_question;
+    delete card.vote_option;
+    delete card.vote_options;
+    log?.(`[template-card-parser] transformVoteInteraction: output=${JSON.stringify(card)}`);
+    return card;
+}
+/**
+ * 将 multiple_interaction 的简化格式转换为企微 API 格式。
+ *
+ * 简化格式字段：
+ *   title            → main_title.title
+ *   description      → main_title.desc
+ *   selectors        → select_list（每个 {title, options: [{id, text}]} → {question_key, title, option_list}）
+ *   submit_text      → submit_button.text
+ *
+ * 代码自动生成：select_list[].question_key, submit_button.key
+ *
+ * 如果 LLM 已输出了合法的 API 原始格式（有 select_list[0].option_list），则跳过转换直接透传。
+ */
+function transformMultipleInteraction(card, log) {
+    // 防御性：如果已经是合法 API 格式，跳过
+    const existingSelectList = card.select_list;
+    if (Array.isArray(existingSelectList) &&
+        existingSelectList.length > 0 &&
+        Array.isArray(existingSelectList[0]?.option_list)) {
+        log?.(`[template-card-parser] transformMultipleInteraction: already has select_list[].option_list, skipping transform`);
+        return card;
+    }
+    // 提取 selectors（简化格式的核心字段）
+    const selectors = card.selectors;
+    if (!Array.isArray(selectors) || selectors.length === 0) {
+        log?.(`[template-card-parser] transformMultipleInteraction: no "selectors" array found, skipping transform`);
+        return card;
+    }
+    log?.(`[template-card-parser] transformMultipleInteraction: transforming simplified format → API format`);
+    log?.(`[template-card-parser] transformMultipleInteraction: input=${JSON.stringify(card)}`);
+    // ── 构建 main_title ──
+    const title = card.title;
+    const description = card.description;
+    if (title || description) {
+        card.main_title = {
+            ...(title ? { title } : {}),
+            ...(description ? { desc: description } : {}),
+        };
+        delete card.title;
+        delete card.description;
+    }
+    // ── 构建 select_list（最多 3 个选择器，每个最多 10 个选项） ──
+    const clampedSelectors = selectors.slice(0, 3);
+    if (selectors.length > 3) {
+        log?.(`[template-card-parser] transformMultipleInteraction: selectors count ${selectors.length} exceeds max 3, clamped to 3`);
+    }
+    card.select_list = clampedSelectors.map((sel, idx) => {
+        const selectorOptions = (sel.options ?? []).slice(0, 10);
+        return {
+            question_key: generateKey(`sel_${idx}`),
+            title: String(sel.title ?? sel.label ?? `选择${idx + 1}`),
+            option_list: selectorOptions.map((opt) => ({
+                id: String(opt.id ?? opt.value ?? `opt_${Math.random().toString(36).slice(2, 6)}`),
+                text: String(opt.text ?? opt.label ?? opt.name ?? ""),
+            })),
+        };
+    });
+    delete card.selectors;
+    // ── 构建 submit_button ──
+    const submitText = card.submit_text || "提交";
+    card.submit_button = {
+        text: submitText,
+        key: generateKey("submit_multi"),
+    };
+    delete card.submit_text;
+    log?.(`[template-card-parser] transformMultipleInteraction: output=${JSON.stringify(card)}`);
+    return card;
+}
+/**
+ * 对 vote_interaction / multiple_interaction 执行简化格式转换。
+ * 其他 card_type 直接跳过。
+ */
+function transformSimplifiedCard(card, log) {
+    const cardType = card.card_type;
+    if (cardType === "vote_interaction") {
+        return transformVoteInteraction(card, log);
+    }
+    if (cardType === "multiple_interaction") {
+        return transformMultipleInteraction(card, log);
+    }
+    return card;
+}
 /**
  * 匹配 markdown 代码块的正则表达式
  * 支持 ```json ... ``` 和 ``` ... ``` 两种格式
@@ -1455,8 +1746,12 @@ function extractTemplateCards(text, log) {
             continue;
         }
         log?.(`[template-card-parser] Code block #${blockIndex} is valid template card, card_type="${cardType}"`);
+        // vote_interaction / multiple_interaction：简化格式 → API 格式转换
+        transformSimplifiedCard(parsed, log);
         // 修正 LLM 可能输出的错误字段类型（如 checkbox.mode: "multi" → 1）
         normalizeTemplateCardFields(parsed, log);
+        // 校验并补全必填字段（如缺失的 task_id、main_title、card_action）
+        validateAndFixRequiredFields(parsed, log);
         // 合法的模板卡片，收集并标记移除
         cards.push({
             cardJson: parsed,