@cxyhhhhh/openclaw-qqbot 1.6.7-alpha.1

package/src/utils/media-tags.ts

@@ -0,0 +1,182 @@
+/**
+ * 富媒体标签预处理与纠错
+ *
+ * 小模型常见的标签拼写错误及变体，在正则匹配前统一修正为标准格式。
+ */
+
+import { expandTilde } from "./platform.js";
+
+// 标准标签名（qqmedia = 统一标签，系统根据文件扩展名自动路由）
+const VALID_TAGS = ["qqimg", "qqvoice", "qqvideo", "qqfile", "qqmedia"] as const;
+
+// 开头标签别名映射（key 全部小写）
+const TAG_ALIASES: Record<string, typeof VALID_TAGS[number]> = {
+  // ---- qqimg 变体 ----
+  "qq_img": "qqimg",
+  "qqimage": "qqimg",
+  "qq_image": "qqimg",
+  "qqpic": "qqimg",
+  "qq_pic": "qqimg",
+  "qqpicture": "qqimg",
+  "qq_picture": "qqimg",
+  "qqphoto": "qqimg",
+  "qq_photo": "qqimg",
+  "img": "qqimg",
+  "image": "qqimg",
+  "pic": "qqimg",
+  "picture": "qqimg",
+  "photo": "qqimg",
+  // ---- qqvoice 变体 ----
+  "qq_voice": "qqvoice",
+  "qqaudio": "qqvoice",
+  "qq_audio": "qqvoice",
+  "voice": "qqvoice",
+  "audio": "qqvoice",
+  // ---- qqvideo 变体 ----
+  "qq_video": "qqvideo",
+  "video": "qqvideo",
+  // ---- qqfile 变体 ----
+  "qq_file": "qqfile",
+  "qqdoc": "qqfile",
+  "qq_doc": "qqfile",
+  "file": "qqfile",
+  "doc": "qqfile",
+  "document": "qqfile",
+  // ---- qqmedia 变体（统一标签，根据扩展名自动路由） ----
+  "qq_media": "qqmedia",
+  "media": "qqmedia",
+  "attachment": "qqmedia",
+  "attach": "qqmedia",
+  "qqattachment": "qqmedia",
+  "qq_attachment": "qqmedia",
+  "qqsend": "qqmedia",
+  "qq_send": "qqmedia",
+  "send": "qqmedia",
+};
+
+// 构建所有可识别的标签名列表（标准名 + 别名）
+const ALL_TAG_NAMES = [...VALID_TAGS, ...Object.keys(TAG_ALIASES)];
+// 按长度降序排列，优先匹配更长的名称（避免 "img" 抢先匹配 "qqimg" 的子串）
+ALL_TAG_NAMES.sort((a, b) => b.length - a.length);
+
+const TAG_NAME_PATTERN = ALL_TAG_NAMES.join("|");
+
+/**
+ * 自闭合属性语法的正则：
+ *   <qqmedia file="/path/to/file.png" />
+ *   <qqimg src="/path" />
+ *   <image file="..." />
+ *   <qqmedia type="file" path="/path/to/file.zip" />   ← 多属性
+ * 支持 file= / src= / path= / url= 属性名，引号可选
+ * 也支持前面有其他属性（如 type="file"）的多属性写法
+ */
+const SELF_CLOSING_TAG_REGEX = new RegExp(
+  "`?" +
+  "[<＜<]\\s*(" + TAG_NAME_PATTERN + ")" +
+  // 允许前面有任意其他属性（如 type="file"），非贪婪跳过
+  "(?:\\s+(?!file|src|path|url)[a-z_-]+\\s*=\\s*[\"']?[^\"'/>＞>]*?[\"']?)*" +
+  "\\s+(?:file|src|path|url)\\s*=\\s*" +
+  "[\"']?" +
+  "([^\"'/>＞>]+?)" +
+  "[\"']?" +
+  // 允许后面还有其他属性
+  "(?:\\s+[a-z_-]+\\s*=\\s*[\"']?[^\"'/>＞>]*?[\"']?)*" +
+  "\\s*/?" +
+  "\\s*[>＞>]" +
+  "`?",
+  "gi"
+);
+
+/**
+ * 构建一个宽容的正则，能匹配各种畸形标签写法：
+ *
+ * 常见错误模式：
+ *  1. 标签名拼错：<qq_img>, <qqimage>, <image>, <img>, <pic> ...
+ *  2. 标签内多余空格：<qqimg >, < qqimg>, <qqimg >
+ *  3. 闭合标签不匹配：<qqimg>url</qqvoice>, <qqimg>url</img>
+ *  4. 闭合标签缺失斜杠：<qqimg>url<qqimg> (用开头标签代替闭合标签)
+ *  5. 闭合标签缺失尖括号：<qqimg>url/qqimg>
+ *  6. 中文尖括号：＜qqimg＞url＜/qqimg＞ 或 <qqimg>url</qqimg>
+ *  7. 多余引号包裹路径：<qqimg>"path"</qqimg>
+ *  8. Markdown 代码块包裹：`<qqimg>path</qqimg>`
+ *  9. 自闭合属性语法：<qqmedia file="/path" /> (由 SELF_CLOSING_TAG_REGEX 处理)
+ */
+const FUZZY_MEDIA_TAG_REGEX = new RegExp(
+  // 可选 Markdown 行内代码反引号
+  "`?" +
+  // 开头标签：允许中文/英文尖括号，标签名前后可有空格
+  "[<＜<]\\s*(" + TAG_NAME_PATTERN + ")\\s*[>＞>]" +
+  // 内容：非贪婪匹配，允许引号包裹
+  "[\"']?\\s*" +
+  "([^<＜<＞>\"'`]+?)" +
+  "\\s*[\"']?" +
+  // 闭合标签：允许各种不规范写法
+  "[<＜<]\\s*/?\\s*(?:" + TAG_NAME_PATTERN + ")\\s*[>＞>]" +
+  // 可选结尾反引号
+  "`?",
+  "gi"
+);
+
+/**
+ * 将标签名映射为标准名称
+ */
+function resolveTagName(raw: string): typeof VALID_TAGS[number] {
+  const lower = raw.toLowerCase();
+  if ((VALID_TAGS as readonly string[]).includes(lower)) {
+    return lower as typeof VALID_TAGS[number];
+  }
+  return TAG_ALIASES[lower] ?? "qqimg";
+}
+
+/**
+ * 预清理：将富媒体标签内部的换行/回车/制表符压缩为单个空格。
+ *
+ * 部分模型会在标签内部插入 \n \r \t 等空白字符，例如：
+ *   <qqimg>\n  /path/to/file.png\n</qqimg>
+ *   <qqimg>/path/to/\nfile.png</qqimg>
+ *
+ * 此正则匹配从开标签到闭标签之间的内容（允许跨行），
+ * 将内部所有 [\r\n\t] 替换为空格，然后压缩连续空格。
+ */
+const MULTILINE_TAG_CLEANUP = new RegExp(
+  "([<＜<]\\s*(?:" + TAG_NAME_PATTERN + ")\\s*[>＞>])" +
+  "([\\s\\S]*?)" +
+  "([<＜<]\\s*/?\\s*(?:" + TAG_NAME_PATTERN + ")\\s*[>＞>])",
+  "gi"
+);
+
+/**
+ * 预处理 LLM 输出文本，将各种畸形/错误的富媒体标签修正为标准格式。
+ *
+ * 标准格式：<qqimg>/path/to/file</qqimg>
+ *
+ * @param text LLM 原始输出
+ * @returns 修正后的文本（如果没有匹配到任何标签则原样返回）
+ */
+export function normalizeMediaTags(text: string): string {
+  // 第 0 步：将自闭合属性语法转换为标准包裹语法
+  // <qqmedia file="/path/to/file.png" /> → <qqmedia>/path/to/file.png</qqmedia>
+  let cleaned = text.replace(SELF_CLOSING_TAG_REGEX, (_match, rawTag: string, content: string) => {
+    const tag = resolveTagName(rawTag);
+    const trimmed = content.trim();
+    if (!trimmed) return _match;
+    const expanded = expandTilde(trimmed);
+    return `<${tag}>${expanded}</${tag}>`;
+  });
+
+  // 第 1 步：将标签内部的换行/回车/制表符压缩为空格
+  cleaned = cleaned.replace(MULTILINE_TAG_CLEANUP, (_m, open: string, body: string, close: string) => {
+    const flat = body.replace(/[\r\n\t]+/g, " ").replace(/ {2,}/g, " ");
+    return open + flat + close;
+  });
+
+  // 第 2 步：将各种畸形标签统一为标准格式
+  return cleaned.replace(FUZZY_MEDIA_TAG_REGEX, (_match, rawTag: string, content: string) => {
+    const tag = resolveTagName(rawTag);
+    const trimmed = content.trim();
+    if (!trimmed) return _match; // 空内容不处理
+    // 展开波浪线路径：~/Desktop/file.png → /Users/xxx/Desktop/file.png
+    const expanded = expandTilde(trimmed);
+    return `<${tag}>${expanded}</${tag}>`;
+  });
+}

package/src/utils/payload.ts

@@ -0,0 +1,265 @@
+/**
+ * QQBot 结构化消息载荷工具
+ * 
+ * 用于处理 AI 输出的结构化消息载荷，包括：
+ * - 定时提醒载荷 (cron_reminder)
+ * - 媒体消息载荷 (media)
+ */
+
+// ============================================
+// 类型定义
+// ============================================
+
+/**
+ * 定时提醒载荷
+ */
+export interface CronReminderPayload {
+  type: 'cron_reminder';
+  /** 提醒内容 */
+  content: string;
+  /** 目标类型：c2c (私聊) 或 group (群聊) */
+  targetType: 'c2c' | 'group';
+  /** 目标地址：user_openid 或 group_openid */
+  targetAddress: string;
+  /** 原始消息 ID（可选） */
+  originalMessageId?: string;
+}
+
+/**
+ * 媒体消息载荷
+ */
+export interface MediaPayload {
+  type: 'media';
+  /** 媒体类型：image, audio, video, file */
+  mediaType: 'image' | 'audio' | 'video' | 'file';
+  /** 来源类型：url 或 file */
+  source: 'url' | 'file';
+  /** 媒体路径或 URL */
+  path: string;
+  /** 媒体描述（可选） */
+  caption?: string;
+}
+
+/**
+ * QQBot 载荷联合类型
+ */
+export type QQBotPayload = CronReminderPayload | MediaPayload;
+
+/**
+ * 解析结果
+ */
+export interface ParseResult {
+  /** 是否为结构化载荷 */
+  isPayload: boolean;
+  /** 解析后的载荷对象（如果是结构化载荷） */
+  payload?: QQBotPayload;
+  /** 原始文本（如果不是结构化载荷） */
+  text?: string;
+  /** 解析错误信息（如果解析失败） */
+  error?: string;
+}
+
+// ============================================
+// 常量定义
+// ============================================
+
+/** AI 输出的结构化载荷前缀 */
+const PAYLOAD_PREFIX = 'QQBOT_PAYLOAD:';
+
+/** Cron 消息存储的前缀 */
+const CRON_PREFIX = 'QQBOT_CRON:';
+
+// ============================================
+// 解析函数
+// ============================================
+
+/**
+ * 解析 AI 输出的结构化载荷
+ * 
+ * 检测消息是否以 QQBOT_PAYLOAD: 前缀开头，如果是则提取并解析 JSON
+ * 
+ * @param text AI 输出的原始文本
+ * @returns 解析结果
+ * 
+ * @example
+ * const result = parseQQBotPayload('QQBOT_PAYLOAD:\n{"type": "media", "mediaType": "image", ...}');
+ * if (result.isPayload && result.payload) {
+ *   // 处理结构化载荷
+ * }
+ */
+export function parseQQBotPayload(text: string): ParseResult {
+  const trimmedText = text.trim();
+  
+  // 检查是否以 QQBOT_PAYLOAD: 开头
+  if (!trimmedText.startsWith(PAYLOAD_PREFIX)) {
+    return {
+      isPayload: false,
+      text: text
+    };
+  }
+  
+  // 提取 JSON 内容（去掉前缀）
+  const jsonContent = trimmedText.slice(PAYLOAD_PREFIX.length).trim();
+  
+  if (!jsonContent) {
+    return {
+      isPayload: true,
+      error: '载荷内容为空'
+    };
+  }
+  
+  try {
+    const payload = JSON.parse(jsonContent) as QQBotPayload;
+    
+    // 验证必要字段
+    if (!payload.type) {
+      return {
+        isPayload: true,
+        error: '载荷缺少 type 字段'
+      };
+    }
+    
+    // 根据 type 进行额外验证
+    if (payload.type === 'cron_reminder') {
+      if (!payload.content || !payload.targetType || !payload.targetAddress) {
+        return {
+          isPayload: true,
+          error: 'cron_reminder 载荷缺少必要字段 (content, targetType, targetAddress)'
+        };
+      }
+    } else if (payload.type === 'media') {
+      if (!payload.mediaType || !payload.source || !payload.path) {
+        return {
+          isPayload: true,
+          error: 'media 载荷缺少必要字段 (mediaType, source, path)'
+        };
+      }
+    }
+    
+    return {
+      isPayload: true,
+      payload
+    };
+  } catch (e) {
+    return {
+      isPayload: true,
+      error: `JSON 解析失败: ${e instanceof Error ? e.message : String(e)}`
+    };
+  }
+}
+
+// ============================================
+// Cron 编码/解码函数
+// ============================================
+
+/**
+ * 将定时提醒载荷编码为 Cron 消息格式
+ * 
+ * 将 JSON 编码为 Base64，并添加 QQBOT_CRON: 前缀
+ * 
+ * @param payload 定时提醒载荷
+ * @returns 编码后的消息字符串，格式为 QQBOT_CRON:{base64}
+ * 
+ * @example
+ * const message = encodePayloadForCron({
+ *   type: 'cron_reminder',
+ *   content: '喝水时间到！',
+ *   targetType: 'c2c',
+ *   targetAddress: 'user_openid_xxx'
+ * });
+ * // 返回: QQBOT_CRON:eyJ0eXBlIjoiY3Jvbl9yZW1pbmRlciIs...
+ */
+export function encodePayloadForCron(payload: CronReminderPayload): string {
+  const jsonString = JSON.stringify(payload);
+  const base64 = Buffer.from(jsonString, 'utf-8').toString('base64');
+  return `${CRON_PREFIX}${base64}`;
+}
+
+/**
+ * 解码 Cron 消息中的载荷
+ * 
+ * 检测 QQBOT_CRON: 前缀，解码 Base64 并解析 JSON
+ * 
+ * @param message Cron 触发时收到的消息
+ * @returns 解码结果，包含是否为 Cron 载荷、解析后的载荷对象或错误信息
+ * 
+ * @example
+ * const result = decodeCronPayload('QQBOT_CRON:eyJ0eXBlIjoiY3Jvbl9yZW1pbmRlciIs...');
+ * if (result.isCronPayload && result.payload) {
+ *   // 处理定时提醒
+ * }
+ */
+export function decodeCronPayload(message: string): {
+  isCronPayload: boolean;
+  payload?: CronReminderPayload;
+  error?: string;
+} {
+  const trimmedMessage = message.trim();
+  
+  // 检查是否以 QQBOT_CRON: 开头
+  if (!trimmedMessage.startsWith(CRON_PREFIX)) {
+    return {
+      isCronPayload: false
+    };
+  }
+  
+  // 提取 Base64 内容
+  const base64Content = trimmedMessage.slice(CRON_PREFIX.length);
+  
+  if (!base64Content) {
+    return {
+      isCronPayload: true,
+      error: 'Cron 载荷内容为空'
+    };
+  }
+  
+  try {
+    // Base64 解码
+    const jsonString = Buffer.from(base64Content, 'base64').toString('utf-8');
+    const payload = JSON.parse(jsonString) as CronReminderPayload;
+    
+    // 验证类型
+    if (payload.type !== 'cron_reminder') {
+      return {
+        isCronPayload: true,
+        error: `期望 type 为 cron_reminder，实际为 ${payload.type}`
+      };
+    }
+    
+    // 验证必要字段
+    if (!payload.content || !payload.targetType || !payload.targetAddress) {
+      return {
+        isCronPayload: true,
+        error: 'Cron 载荷缺少必要字段'
+      };
+    }
+    
+    return {
+      isCronPayload: true,
+      payload
+    };
+  } catch (e) {
+    return {
+      isCronPayload: true,
+      error: `Cron 载荷解码失败: ${e instanceof Error ? e.message : String(e)}`
+    };
+  }
+}
+
+// ============================================
+// 辅助函数
+// ============================================
+
+/**
+ * 判断载荷是否为定时提醒类型
+ */
+export function isCronReminderPayload(payload: QQBotPayload): payload is CronReminderPayload {
+  return payload.type === 'cron_reminder';
+}
+
+/**
+ * 判断载荷是否为媒体消息类型
+ */
+export function isMediaPayload(payload: QQBotPayload): payload is MediaPayload {
+  return payload.type === 'media';
+}

package/src/utils/pkg-version.ts

@@ -0,0 +1,54 @@
+/**
+ * 从 import.meta.url 向上遍历目录树查找 package.json 并读取 version。
+ * 不依赖硬编码的 "../" 层级，无论编译输出结构如何变化都能可靠找到。
+ */
+
+import { fileURLToPath } from "node:url";
+import { createRequire } from "node:module";
+import path from "node:path";
+import fs from "node:fs";
+
+let _cached: string | null = null;
+
+export function getPackageVersion(metaUrl?: string): string {
+  if (_cached !== null) return _cached;
+
+  // Strategy 1: 从调用者的 import.meta.url（或本模块）向上遍历找 package.json
+  const startFile = metaUrl ? fileURLToPath(metaUrl) : fileURLToPath(import.meta.url);
+  let dir = path.dirname(startFile);
+  const root = path.parse(dir).root;
+
+  while (dir !== root) {
+    const candidate = path.join(dir, "package.json");
+    try {
+      if (fs.existsSync(candidate)) {
+        const pkg = JSON.parse(fs.readFileSync(candidate, "utf8"));
+        // 确认是我们自己的包（避免找到其他 package.json）
+        if (pkg.name === "@tencent-connect/openclaw-qqbot" && pkg.version) {
+          _cached = pkg.version as string;
+          return _cached;
+        }
+      }
+    } catch {
+      // ignore and try parent
+    }
+    dir = path.dirname(dir);
+  }
+
+  // Strategy 2: fallback 用 createRequire 尝试常见相对路径
+  try {
+    const require = createRequire(metaUrl ?? import.meta.url);
+    for (const rel of ["../../package.json", "../package.json", "./package.json"]) {
+      try {
+        const pkg = require(rel);
+        if (pkg?.version) {
+          _cached = pkg.version as string;
+          return _cached;
+        }
+      } catch { /* next */ }
+    }
+  } catch { /* fallback */ }
+
+  _cached = "unknown";
+  return _cached;
+}