@tencent-connect/openclaw-qqbot 1.7.1 → 2.0.0

package/src/utils/media-tags.ts

@@ -1,183 +0,0 @@
-/**
- * 富媒体标签预处理与纠错
- *
- * 小模型常见的标签拼写错误及变体，在正则匹配前统一修正为标准格式。
- */
-
-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

@@ -1,265 +0,0 @@
-/**
- * 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/text-parsing.ts

@@ -1,85 +0,0 @@
-/**
- * QQ Bot 文本解析工具函数
- */
-
-import type { RefAttachmentSummary } from "../ref-index-store.js";
-import { inferAttachmentType } from "../group-history.js";
-import { MSG_TYPE_QUOTE } from "../types.js";
-
-/**
- * 解析 QQ 表情标签，将 <faceType=1,faceId="13",ext="base64..."> 格式
- * 替换为 【表情: 中文名】 格式
- * ext 字段为 Base64 编码的 JSON，格式如 {"text":"呲牙"}
- */
-export function parseFaceTags(text: string): string {
-  if (!text) return text;
-
-  return text.replace(/<faceType=\d+,faceId="[^"]*",ext="([^"]*)">/g, (_match, ext: string) => {
-    try {
-      const decoded = Buffer.from(ext, "base64").toString("utf-8");
-      const parsed = JSON.parse(decoded);
-      const faceName = parsed.text || "未知表情";
-      return `【表情: ${faceName}】`;
-    } catch {
-      return _match;
-    }
-  });
-}
-
-/**
- * 过滤内部标记（如 [[reply_to: xxx]]）
- * 这些标记可能被 AI 错误地学习并输出，需要在发送前移除
- */
-export function filterInternalMarkers(text: string): string {
-  if (!text) return text;
-  
-  let result = text.replace(/\[\[[a-z_]+:\s*[^\]]*\]\]/gi, "");
-  // 过滤框架内部图片引用标记：@image:image_xxx.png、@voice:voice_xxx.silk 等
-  result = result.replace(/@(?:image|voice|video|file):[a-zA-Z0-9_.-]+/g, "");
-  result = result.replace(/\n{3,}/g, "\n\n").trim();
-  
-  return result;
-}
-
-/** 从 ext 和 msg_elements 中解析引用索引，仅 MSG_TYPE_QUOTE 时取 msg_elements */
-export function parseRefIndices(
-  ext?: string[],
-  messageType?: number,
-  msgElements?: Array<{ msg_idx?: string }>,
-): { refMsgIdx?: string; msgIdx?: string } {
-  let refMsgIdx: string | undefined;
-  let msgIdx: string | undefined;
-  if (ext && ext.length > 0) {
-    for (const item of ext) {
-      if (item.startsWith("ref_msg_idx=")) {
-        refMsgIdx = item.slice("ref_msg_idx=".length);
-      } else if (item.startsWith("msg_idx=")) {
-        msgIdx = item.slice("msg_idx=".length);
-      }
-    }
-  }
-  // 仅当 message_type=MSG_TYPE_QUOTE（引用消息）时，msg_elements[0].msg_idx 更权威，有值时覆盖 ext 解析结果
-  if (messageType === MSG_TYPE_QUOTE) {
-    const refElement = msgElements?.[0];
-    if (refElement?.msg_idx) {
-      refMsgIdx = refElement.msg_idx;
-    }
-  }
-  return { refMsgIdx, msgIdx };
-}
-
-/**
- * 从附件列表中构建附件摘要（用于引用索引缓存）
- */
-export function buildAttachmentSummaries(
-  attachments?: Array<{ content_type: string; url: string; filename?: string; voice_wav_url?: string }>,
-  localPaths?: Array<string | null>,
-): RefAttachmentSummary[] | undefined {
-  if (!attachments || attachments.length === 0) return undefined;
-  return attachments.map((att, idx) => ({
-    type: inferAttachmentType(att.content_type),
-    filename: att.filename,
-    contentType: att.content_type,
-    localPath: localPaths?.[idx] ?? undefined,
-  }));
-}

package/src/utils/upload-cache.ts

@@ -1,128 +0,0 @@
-/**
- * file_info 缓存 — 借鉴 Telegram file_id 机制
- * 
- * QQ Bot API 上传文件后返回 file_info + ttl，在 TTL 内相同文件可直接复用 file_info
- * 避免重复上传同一文件，节省带宽和时间。
- * 
- * 缓存 key = md5(fileContent) + targetType(c2c/group) + targetId + fileType
- */
-
-import * as crypto from "node:crypto";
-import * as fs from "node:fs";
-
-interface CacheEntry {
-  fileInfo: string;
-  fileUuid: string;
-  /** 过期时间戳（ms），比 API 返回的 TTL 提前 60 秒失效 */
-  expiresAt: number;
-}
-
-// 内存缓存，key 格式：`${contentHash}:${scope}:${targetId}:${fileType}`
-const cache = new Map<string, CacheEntry>();
-
-// 最大缓存条目数，防止内存泄漏
-const MAX_CACHE_SIZE = 500;
-
-/**
- * 计算文件内容的 MD5 hash（用于缓存 key）
- * 对于 Base64 数据直接 hash，对于文件路径读取后 hash
- */
-export function computeFileHash(data: string | Buffer): string {
-  const content = typeof data === "string" ? data : data;
-  return crypto.createHash("md5").update(content).digest("hex");
-}
-
-/**
- * 构建缓存 key
- * @param contentHash - 文件内容 hash
- * @param scope - "c2c" | "group"
- * @param targetId - 用户 openid 或群 openid
- * @param fileType - 1=IMAGE, 2=VIDEO, 3=VOICE, 4=FILE
- */
-function buildCacheKey(contentHash: string, scope: string, targetId: string, fileType: number): string {
-  return `${contentHash}:${scope}:${targetId}:${fileType}`;
-}
-
-/**
- * 从缓存获取 file_info
- * @returns file_info 字符串，未命中或已过期返回 null
- */
-export function getCachedFileInfo(
-  contentHash: string,
-  scope: "c2c" | "group",
-  targetId: string,
-  fileType: number,
-): string | null {
-  const key = buildCacheKey(contentHash, scope, targetId, fileType);
-  const entry = cache.get(key);
-
-  if (!entry) return null;
-
-  // 检查是否过期
-  if (Date.now() >= entry.expiresAt) {
-    cache.delete(key);
-    return null;
-  }
-
-  console.log(`[upload-cache] Cache HIT: key=${key.slice(0, 40)}..., fileUuid=${entry.fileUuid}`);
-  return entry.fileInfo;
-}
-
-/**
- * 将上传结果写入缓存
- * @param ttl - API 返回的 TTL（秒），缓存会提前 60 秒失效
- */
-export function setCachedFileInfo(
-  contentHash: string,
-  scope: "c2c" | "group",
-  targetId: string,
-  fileType: number,
-  fileInfo: string,
-  fileUuid: string,
-  ttl: number,
-): void {
-  // 清理过期条目（惰性清理）
-  if (cache.size >= MAX_CACHE_SIZE) {
-    const now = Date.now();
-    for (const [k, v] of cache) {
-      if (now >= v.expiresAt) {
-        cache.delete(k);
-      }
-    }
-    // 如果清理后仍然超限，删除最早的一半
-    if (cache.size >= MAX_CACHE_SIZE) {
-      const keys = Array.from(cache.keys());
-      for (let i = 0; i < keys.length / 2; i++) {
-        cache.delete(keys[i]!);
-      }
-    }
-  }
-
-  const key = buildCacheKey(contentHash, scope, targetId, fileType);
-  // 提前 60 秒失效，避免临界点过期
-  const safetyMargin = 60;
-  const effectiveTtl = Math.max(ttl - safetyMargin, 10);
-  
-  cache.set(key, {
-    fileInfo,
-    fileUuid,
-    expiresAt: Date.now() + effectiveTtl * 1000,
-  });
-
-  console.log(`[upload-cache] Cache SET: key=${key.slice(0, 40)}..., ttl=${effectiveTtl}s, uuid=${fileUuid}`);
-}
-
-/**
- * 获取缓存统计
- */
-export function getUploadCacheStats(): { size: number; maxSize: number } {
-  return { size: cache.size, maxSize: MAX_CACHE_SIZE };
-}
-
-/**
- * 清除所有缓存
- */
-export function clearUploadCache(): void {
-  cache.clear();
-  console.log(`[upload-cache] Cache cleared`);
-}