@raolin2025/claude-code-node 2.6.1 → 2.6.2

package/src/tools/telegram-tools.js

@@ -0,0 +1,319 @@
+/**
+ * Telegram 工具 — 发送消息/媒体、通用 Bot API 调用、定时提醒
+ *
+ * 替代原 qqbot_* 工具（QQ 通道已放弃，统一改用 Telegram）。
+ *
+ * 配置：
+ *   CC_NODE_CHANNEL_TELEGRAM_TOKEN   — Bot Token（必填）
+ *   CC_NODE_CHANNEL_TELEGRAM_CHAT_ID — 默认聊天 ID（可选）
+ *   CC_NODE_CHANNEL_TELEGRAM_PROXY   — SOCKS5 代理（可选）
+ *   CC_NODE_CHANNEL_TELEGRAM_API_BASE— 自定义 API Base（可选）
+ *
+ * 依赖复用 src/channel/tg-listener.js 中的 TelegramBotClient，
+ * 保证与 cc-node 双向通道使用同一套客户端逻辑（速率限制、代理、重试）。
+ */
+
+import { ToolDef } from '../types/index.js'
+import { TelegramBotClient } from '../channel/tg-listener.js'
+
+const API_BASE = (token) => `https://api.telegram.org/bot${token}`
+
+/** 读取配置 */
+function getToken() {
+  return process.env.CC_NODE_CHANNEL_TELEGRAM_TOKEN || ''
+}
+
+function getDefaultChatId() {
+  return process.env.CC_NODE_CHANNEL_TELEGRAM_CHAT_ID || ''
+}
+
+/** 创建 TelegramBotClient 实例 */
+function getClient() {
+  const token = getToken()
+  if (!token) {
+    throw new Error('未配置 Telegram Token（请设置 CC_NODE_CHANNEL_TELEGRAM_TOKEN）')
+  }
+  const proxy = process.env.CC_NODE_CHANNEL_TELEGRAM_PROXY || ''
+  const apiBase = process.env.CC_NODE_CHANNEL_TELEGRAM_API_BASE || API_BASE(token)
+  return new TelegramBotClient(token, { proxy, apiBase })
+}
+
+/** 通用执行器：包装为 ToolDef 的执行格式 */
+function createExecutor(originalFunc) {
+  return async (input) => {
+    try {
+      const result = await originalFunc(input)
+      if (result && result.ok) {
+        return typeof result.result !== 'undefined' ? result.result : result
+      }
+      return result
+    } catch (e) {
+      return `[ERROR] ${e.message}`
+    }
+  }
+}
+
+/** 校验聊天 ID（允许用默认值） */
+function resolveChatId(chatId) {
+  return chatId || getDefaultChatId()
+}
+
+// ============================================================
+// 具体工具函数
+// ============================================================
+
+/** 发送文本消息 */
+async function sendMessage(args) {
+  const { chatId, text, parseMode, silent, disableWebPreview } = args
+  const resolvedChatId = resolveChatId(chatId)
+  if (!resolvedChatId) throw new Error('chatId 必填（或设置 CC_NODE_CHANNEL_TELEGRAM_CHAT_ID 作为默认）')
+  if (!text) throw new Error('text 必填')
+
+  const client = getClient()
+  const result = await client.sendMessage(resolvedChatId, text, {
+    parseMode: parseMode || 'HTML',
+    silent: silent || false,
+    disableWebPreview: disableWebPreview ?? true,
+  })
+  return { ok: true, messageId: result.message_id, chat: result.chat?.id }
+}
+
+/** 发送媒体文件（图片/文档/音频/视频） */
+async function sendMedia(args) {
+  const { chatId, path, caption, mediaType } = args
+  const resolvedChatId = resolveChatId(chatId)
+  if (!resolvedChatId) throw new Error('chatId 必填（或设置 CC_NODE_CHANNEL_TELEGRAM_CHAT_ID 作为默认）')
+  if (!path) throw new Error('path 必填')
+
+  const { readFileSync, existsSync } = await import('fs')
+  const { resolve, basename } = await import('path')
+
+  const absPath = resolve(path)
+  if (!existsSync(absPath)) throw new Error(`文件不存在: ${path}`)
+
+  const client = getClient()
+  const token = getToken()
+  const apiBase = client.apiBase || API_BASE(token)
+
+  // 检测文件类型
+  const ext = absPath.split('.').pop().toLowerCase()
+  const type = mediaType || (
+    ['jpg', 'jpeg', 'png', 'gif', 'webp', 'bmp'].includes(ext) ? 'photo'
+    : ['mp4', 'mov', 'avi', 'mkv', 'webm'].includes(ext) ? 'video'
+    : ['mp3', 'ogg', 'm4a', 'wav', 'flac', 'aac'].includes(ext) ? 'audio'
+    : 'document'
+  )
+
+  const form = new FormData()
+  form.append('chat_id', String(resolvedChatId))
+  if (caption) form.append('caption', String(caption).slice(0, 1024))
+
+  // 上传文件
+  const buf = readFileSync(absPath)
+  const blob = new Blob([buf])
+  // 不同文件类型的 multipart 字段名
+  const fieldName = {
+    photo: 'photo',
+    video: 'video',
+    audio: 'audio',
+    document: 'document',
+    sticker: 'sticker',
+  }[type] || 'document'
+
+  // 带文件名（用 File 形式，node 18+ 支持）
+  const FileCtor = (typeof File !== 'undefined') ? File : null
+  let filePart
+  if (FileCtor) {
+    filePart = new File([buf], basename(absPath))
+  } else {
+    // 兼容：手动组装 multipart
+    form.append(fieldName, blob, basename(absPath))
+    filePart = null
+  }
+  if (filePart) form.append(fieldName, filePart)
+
+  const method = type === 'photo' ? 'sendPhoto'
+    : type === 'video' ? 'sendVideo'
+    : type === 'audio' ? 'sendAudio'
+    : type === 'sticker' ? 'sendSticker'
+    : 'sendDocument'
+
+  const res = await client._fetch(`${apiBase}/${method}`, {
+    method: 'POST',
+    body: form,
+  })
+  const data = await res.json()
+  if (!data.ok) {
+    throw new Error(`Telegram ${method} ${data.error_code}: ${data.description?.slice(0, 200) || 'unknown'}`)
+  }
+  return { ok: true, type, messageId: data.result?.message_id, chat: data.result?.chat?.id }
+}
+
+/** 通用 Telegram Bot API 调用 */
+async function channelApi(args) {
+  const { method = 'POST', path, body = {}, query = {} } = args
+  if (!path) throw new Error('path 必填（如 /sendMessage、/getMe、/getUpdates）')
+
+  const client = getClient()
+  const token = getToken()
+  const apiBase = client.apiBase || API_BASE(token)
+
+  const url = new URL(apiBase + (path.startsWith('/') ? path : '/' + path))
+  for (const [k, v] of Object.entries(query)) url.searchParams.append(k, String(v))
+
+  const res = await client._fetch(url.toString(), {
+    method,
+    headers: { 'Content-Type': 'application/json' },
+    body: ['POST', 'PUT', 'PATCH'].includes(method) ? JSON.stringify(body) : undefined,
+  })
+  const raw = await res.text()
+  if (!res.ok) {
+    throw new Error(`Telegram API ${method} ${path} → ${res.status}: ${raw.slice(0, 200)}`)
+  }
+  const data = raw.trim() ? JSON.parse(raw) : null
+  if (data && !data.ok) {
+    throw new Error(`Telegram API ${data.error_code}: ${data.description?.slice(0, 200) || 'unknown'}`)
+  }
+  return data?.result ?? data
+}
+
+/** 获取机器人信息 */
+async function getMe() {
+  const result = await channelApi({ method: 'POST', path: '/getMe' })
+  return { ok: true, username: result?.username, id: result?.id, firstName: result?.first_name }
+}
+
+/** 定时提醒（复用 qqbot_remind 的调度占位，目标改为 Telegram chatId） */
+async function remind(args) {
+  const { action, content, time, chatId, jobId } = args
+  if (!action || !['add', 'list', 'remove'].includes(action)) {
+    throw new Error('action 必须为 add/list/remove')
+  }
+  const resolvedChatId = resolveChatId(chatId)
+  if (!resolvedChatId) throw new Error('chatId 必填（或设置 CC_NODE_CHANNEL_TELEGRAM_CHAT_ID 作为默认）')
+
+  // TODO: 与 cc-node 调度系统集成后实现真正的定时发送
+  // 当前占位：返回需集成的提示
+  return {
+    ok: false,
+    error: `telegram_remind 尚未完整集成定时任务系统。当前收到: action=${action}, content=${content}, time=${time}, chatId=${resolvedChatId}`
+  }
+}
+
+// ============================================================
+// 导出工具定义
+// ============================================================
+
+export const telegramTools = [
+  new ToolDef(
+    'telegram_send_message',
+    `发送文本消息到 Telegram 聊天。
+使用方法：
+  chatId: 目标聊天 ID（数字或 @username；留空用 CC_NODE_CHANNEL_TELEGRAM_CHAT_ID 默认值）
+  text: 消息内容（Telegram 单条上限 4096 字符，超长自动截断）
+  parseMode: 解析模式（HTML 或 Markdown，默认 HTML）
+  silent: 是否静默发送（可选）
+  disableWebPreview: 是否禁用网页预览（可选）
+
+示例：
+- 发送文本: { "chatId": "123456789", "text": "任务完成 ✅" }`,
+    {
+      type: 'object',
+      properties: {
+        chatId: { type: 'string', description: '目标聊天 ID（数字或 @username，可省略用默认）' },
+        text: { type: 'string', description: '消息内容' },
+        parseMode: { type: 'string', enum: ['HTML', 'Markdown'], description: '解析模式' },
+        silent: { type: 'boolean', description: '静默发送' },
+        disableWebPreview: { type: 'boolean', description: '禁用网页预览' }
+      },
+      required: ['text']
+    },
+    createExecutor(sendMessage)
+  ),
+
+  new ToolDef(
+    'telegram_send_media',
+    `发送图片/文件/音频/视频到 Telegram 聊天。
+使用方法：
+  chatId: 目标聊天 ID（可省略用默认）
+  path: 本地文件绝对路径
+  caption: 附加说明文字（可选）
+  mediaType: 文件类型 photo|video|audio|document|sticker（可选，自动检测）
+
+示例：
+{ "chatId": "123456789", "path": "/tmp/result.png", "caption": "结果截图" }`,
+    {
+      type: 'object',
+      properties: {
+        chatId: { type: 'string', description: '目标聊天 ID（可省略用默认）' },
+        path: { type: 'string', description: '本地文件绝对路径' },
+        caption: { type: 'string', description: '附加说明文字' },
+        mediaType: { type: 'string', enum: ['photo', 'video', 'audio', 'document', 'sticker'], description: '文件类型' }
+      },
+      required: ['path']
+    },
+    createExecutor(sendMedia)
+  ),
+
+  new ToolDef(
+    'telegram_channel_api',
+    `调用 Telegram Bot API（通用）。
+使用方法：
+  method: HTTP 方法 (GET/POST)
+  path: API 路径，如 /getMe、/getUpdates、/sendMessage（自动加 /bot<token> 前缀）
+  body: 请求体 JSON（POST 使用）
+  query: URL 查询参数对象
+
+示例：
+- 获取机器人信息: { "method": "POST", "path": "/getMe" }
+- 获取更新: { "method": "POST", "path": "/getUpdates", "body": { "limit": 10 } }`,
+    {
+      type: 'object',
+      properties: {
+        method: { type: 'string', enum: ['GET', 'POST'], description: 'HTTP 方法' },
+        path: { type: 'string', description: 'API 路径，如 /getMe、/sendMessage' },
+        body: { type: 'object', description: '请求体 JSON（POST 使用）' },
+        query: { type: 'object', additionalProperties: { type: 'string' }, description: 'URL 查询参数' }
+      },
+      required: ['method', 'path']
+    },
+    createExecutor(channelApi)
+  ),
+
+  new ToolDef(
+    'telegram_get_me',
+    '获取 Telegram 机器人自身信息（用户名、ID）。无需参数。',
+    { type: 'object', properties: {} },
+    createExecutor(getMe)
+  ),
+
+  new ToolDef(
+    'telegram_remind',
+    `Telegram 定时提醒（计划集成调度系统）。
+使用方法：
+  action: add|list|remove
+  content: 提醒内容
+  time: 相对时间 (5m, 1h30m) 或 cron 表达式
+  chatId: 目标聊天 ID（可省略用默认）
+
+注意：当前为占位实现，完整调度待集成。`,
+    {
+      type: 'object',
+      properties: {
+        action: { type: 'string', enum: ['add', 'list', 'remove'], description: '操作类型' },
+        content: { type: 'string', description: '提醒内容' },
+        time: { type: 'string', description: '相对时间 (5m, 1h30m) 或 cron 表达式 ("0 8 * * *")' },
+        chatId: { type: 'string', description: '目标聊天 ID（可省略用默认）' },
+        jobId: { type: 'string', description: '任务 ID（仅 remove 使用）' }
+      },
+      required: ['action']
+    },
+    createExecutor(remind)
+  ),
+]
+
+export const metadata = {
+  name: 'telegram-tools',
+  description: 'Telegram 工具：发送消息/媒体、通用 Bot API 调用、定时提醒',
+  tools: telegramTools.map(t => t.name)
+}

package/src/types/index.js

@@ -24,8 +24,13 @@ export class Message {
 }
 
 export class UserMessage extends Message {
-  constructor(content) {
+  /**
+   * @param {string} content 文本内容
+   * @param {string[]} [images] 图片 URL 列表（data URL 或 http URL，视觉模型用）
+   */
+  constructor(content, images = []) {
     super(Role.USER, content)
+    this.images = images
   }
 }
 

package/src/utils/llm-server.js

@@ -76,7 +76,7 @@ export function isLocalHostname(hostname) {
 
 /**
  * 判断一个 apiBase 是否指向「自建本地 LLM 服务」（无需强制 apiKey）
- * @param {string} apiBase - 如 http://192.168.1.50:11434/v1
+ * @param {string} apiBase - 如 http://127.0.0.1:11434/v1
  */
 export function isLocalLlmServer(apiBase) {
   if (!apiBase) return false

package/src/tools/qqbot-channel-api.js

@@ -1,147 +0,0 @@
-/**
- * QQ Bot 频道管理工具 — 调用 QQ Bot API v2
- *
- * 使用方式：在工具调用中指定 method、path、body、query
- *
- * 示例：
- *   qqbot_channel_api: {\n     method: 'GET',\n     path: '/users/@me/guilds',\n     query: { limit: '100' }\n   }
- *
- * 所有请求自动携带 Authorization 头，无需手动处理 Token
- */
-
-const API_BASE = 'https://api.sgroup.qq.com'
-const TOKEN_URL = 'https://bots.qq.com/app/getAppAccessToken'
-
-/** 获取指定账户的 Token（通过环境变量或全局配置） */
-async function getToken(appId, clientSecret) {
-  if (!appId || !clientSecret) {
-    throw new Error('QQBot 需要 appId 和 clientSecret（请配置 CC_NODE_CHANNEL_QQBOT_APPID / CC_NODE_CHANNEL_QQBOT_SECRET）')
-  }
-
-  const res = await fetch(TOKEN_URL, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({ appId, clientSecret }),
-  })
-  if (!res.ok) {
-    const t = await res.text().catch(() => '')
-    throw new Error(`Token API ${res.status}: ${t.slice(0, 200)}`)
-  }
-  const data = await res.json()
-  if (!data.access_token) throw new Error('Token API no access_token')
-  return data.access_token
-}
-
-/** 核心 API 调用 */
-async function qqbotChannelApiCall(params) {
-  const { method = 'GET', path, body, query = {} } = params
-
-  if (!path) throw new Error('path 是必填参数')
-
-  // 从环境变量获取凭证（简化：使用全局默认账户）
-  const appId = process.env.CC_NODE_CHANNEL_QQBOT_APPID || ''
-  const clientSecret = process.env.CC_NODE_CHANNEL_QQBOT_SECRET || ''
-  const token = await getToken(appId, clientSecret)
-
-  // 构建 URL + 查询参数
-  const url = new URL(API_BASE + path)
-  for (const [k, v] of Object.entries(query)) {
-    url.searchParams.append(k, String(v))
-  }
-
-  // 执行请求
-  const res = await fetch(url.toString(), {
-    method,
-    headers: {
-      'Authorization': `QQBot ${token}`,
-      'Content-Type': 'application/json',
-    },
-    body: (body && ['POST', 'PUT', 'PATCH'].includes(method)) ? JSON.stringify(body) : undefined,
-  })
-
-  const raw = await res.text()
-  if (!res.ok) {
-    let detail = raw.slice(0, 200)
-    try { detail = JSON.parse(raw).message || detail } catch {}
-    throw new Error(`QQ API ${method} ${path} → ${res.status}: ${detail}`)
-  }
-
-  return raw.trim() ? JSON.parse(raw) : null
-}
-
-// ── 工具函数（具体操作封装） ───────────────────────────────
-
-/** 获取机器人所在的频道列表 */
-async function listGuilds(limit = 100, before, after) {
-  const query = { limit: String(limit) }
-  if (before) query.before = String(before)
-  if (after) query.after = String(after)
-  return await qqbotChannelApiCall({ method: 'GET', path: '/users/@me/guilds', query })
-}
-
-/** 获取频道的子频道列表 */
-async function listChannels(guildId) {
-  return await qqbotChannelApiCall({ method: 'GET', path: `/guilds/${guildId}/channels` })
-}
-
-/** 创建子频道 */
-async function createChannel(guildId, { name, type = 0, position = 1, sub_type = 0, parent_id, private_type, private_user_ids, speak_permission, application_id }) {
-  const body = { name, type: Number(type), position: Number(position), sub_type: Number(sub_type) }
-  if (parent_id) body.parent_id = parent_id
-  if (private_type !== undefined) body.private_type = private_type
-  if (private_user_ids) body.private_user_ids = private_user_ids
-  if (speak_permission !== undefined) body.speak_permission = speak_permission
-  if (application_id) body.application_id = application_id
-  return await qqbotChannelApiCall({ method: 'POST', path: `/guilds/${guildId}/channels`, body })
-}
-
-/** 获取频道成员列表（分页） */
-async function listMembers(guildId, limit = 100, after = 0) {
-  return await qqbotChannelApiCall({ method: 'GET', path: `/guilds/${guildId}/members`, query: { limit: String(limit), after: String(after) } })
-}
-
-/** 获取指定成员详情 */
-async function getMember(guildId, userId) {
-  return await qqbotChannelApiCall({ method: 'GET', path: `/guilds/${guildId}/members/${userId}` })
-}
-
-/** 发布公告 */
-async function createAnnounce(guildId, { message_id, channel_id, announces_type = 0, recommend_channels = [] }) {
-  const body = { announces_type, recommend_channels }
-  if (message_id) body.message_id = message_id
-  if (channel_id) body.channel_id = channel_id
-  return await qqbotChannelApiCall({ method: 'POST', path: `/guilds/${guild_id}/announces`, body })
-}
-
-/** 删除公告 */
-async function deleteAnnounce(guildId, message_id) {
-  const messageId = message_id === 'all' ? 'all' : encodeURIComponent(message_id)
-  return await qqbotChannelApiCall({ method: 'DELETE', path: `/guilds/${guildId}/announces/${messageId}` })
-}
-
-/** 获取子频道在线人数 */
-async function getChannelOnlineCount(channelId) {
-  return await qqbotChannelApiCall({ method: 'GET', path: `/channels/${channelId}/online_nums` })
-}
-
-// 导出工具函数作为工具接口
-export const tools = {
-  qqbot_channel_api: async (args) => {
-    // 通用 API 调用
-    return await qqbotChannelApiCall(args)
-  },
-
-  // 便捷函数
-  qqbot_list_guilds: async (args = {}) => await listGuilds(args.limit, args.before, args.after),
-  qqbot_list_channels: async (args) => await listChannels(args.guildId),
-  qqbot_get_member: async (args) => await getMember(args.guildId, args.userId),
-  qqbot_list_members: async (args) => await listMembers(args.guildId, args.limit, args.after),
-  qqbot_get_channel_online: async (args) => await getChannelOnlineCount(args.channelId),
-}
-
-// 工具元数据
-export const metadata = {
-  name: 'qqbot-channel-api',
-  description: 'QQ Bot 频道管理工具，调用 QQ Bot API v2，支持频道、成员、公告等操作',
-  tools: Object.keys(tools)
-}

package/src/tools/qqbot-media.js

@@ -1,177 +0,0 @@
-/**
- * QQ Bot 富媒体工具 — 图片/语音/文件上传与发送
- *
- * 功能：
- * - 验证文件路径（必须在 ~/.openclaw/media/qqbot 或 ~/.openclaw/media）
- * - 自动检测文件类型
- * - 上传并通过 QQ Bot 发送
- *
- * 使用方式：
- *   qqbot_media: { action: 'upload', path: '/home/.../image.png', scope: 'group', targetId: '群OPENID' }
- */
-
-import { QQBotEnhanced } from '../channel/qqbot-enhanced.js'
-import { parseQQMediaTags } from '../channel/qqbot-enhanced.js'
-
-const API_BASE = 'https://api.sgroup.qq.com'
-
-async function getToken(appId, clientSecret) {
-  const TOKEN_URL = 'https://bots.qq.com/app/getAppAccessToken'
-  const res = await fetch(TOKEN_URL, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({ appId, clientSecret }),
-  })
-  if (!res.ok) throw new Error(`Token API ${res.status}`)
-  const data = await res.json()
-  if (!data.access_token) throw new Error('No access_token')
-  return data.access_token
-}
-
-async function uploadFileToQQ(token, scope, targetId, filePath, fileType) {
-  const { readFileSync, existsSync } = await import('fs')
-  const { resolve } = await import('path')
-
-  const absPath = resolve(filePath)
-  if (!existsSync(absPath)) {
-    throw new Error(`文件不存在: ${filePath}`)
-  }
-
-  // 安全检查：必须在 media/qqbot 或 media 目录下
-  const allowedDirs = [
-    process.env.HOME + '/.openclaw/media/qqbot',
-    process.env.HOME + '/.openclaw/media'
-  ]
-  const isAllowed = allowedDirs.some(dir => absPath.startsWith(dir))
-  if (!isAllowed) {
-    throw new Error(`安全限制: 文件必须在 ~/.openclaw/media/qqbot 或 ~/.openclaw/media 目录下`)
-  }
-
-  const path = scope === 'group'
-    ? `/v2/groups/${targetId}/files`
-    : `/v2/users/${targetId}/files`
-
-  const body = {
-    file_type: fileType,
-    srv_send_msg: false
-  }
-
-  // 读取文件并转为 base64
-  const buf = readFileSync(absPath)
-  body.file_data = buf.toString('base64')
-
-  const res = await fetch(API_BASE + path, {
-    method: 'POST',
-    headers: {
-      'Authorization': `QQBot ${token}`,
-      'Content-Type': 'application/json',
-    },
-    body: JSON.stringify(body),
-  })
-
-  if (!res.ok) {
-    const err = await res.text().catch(() => '')
-    throw new Error(`上传失败 ${res.status}: ${err.slice(0, 100)}`)
-  }
-
-  const result = await res.json()
-  if (!result.file_info) {
-    throw new Error(`上传响应异常: ${JSON.stringify(result)}`)
-  }
-
-  return result.file_info
-}
-
-async function sendMediaMessage(token, scope, targetId, fileInfo) {
-  const path = scope === 'group'
-    ? `/v2/groups/${targetId}/messages`
-    : `/v2/users/${targetId}/messages`
-
-  const body = {
-    msg_type: 7,  // 媒体消息
-    media: { file_info: fileInfo }
-  }
-
-  const res = await fetch(API_BASE + path, {
-    method: 'POST',
-    headers: {
-      'Authorization': `QQBot ${token}`,
-      'Content-Type': 'application/json',
-    },
-    body: JSON.stringify(body),
-  })
-
-  if (!res.ok) {
-    const err = await res.text().catch(() => '')
-    throw new Error(`发送失败 ${res.status}: ${err.slice(0, 100)}`)
-  }
-
-  return res.json()
-}
-
-/** 工具函数 */
-
-async function uploadAndSendMedia(params) {
-  const { path: filePath, scope, targetId, appId, clientSecret } = params
-
-  if (!filePath) throw new Error('path 必填')
-  if (!scope || !targetId) throw new Error('scope 和 targetId 必填')
-
-  // 获取凭证
-  const resolvedAppId = appId || process.env.CC_NODE_CHANNEL_QQBOT_APPID || ''
-  const resolvedSecret = clientSecret || process.env.CC_NODE_CHANNEL_QQBOT_SECRET || ''
-  const token = await getToken(resolvedAppId, resolvedSecret)
-
-  // 检测文件类型
-  const ext = filePath.split('.').pop().toLowerCase()
-  let fileType
-  if (['jpg', 'jpeg', 'png', 'gif', 'webp', 'bmp'].includes(ext)) fileType = 1
-  else if (['mp4', 'mov', 'avi', 'mkv', 'webm'].includes(ext)) fileType = 2
-  else if (['silk', 'wav', 'mp3', 'ogg', 'aac', 'flac', 'm4a'].includes(ext)) fileType = 3
-  else fileType = 4
-
-  // 上传
-  const fileInfo = await uploadFileToQQ(token, scope, targetId, filePath, fileType)
-
-  // 发送
-  const result = await sendMediaMessage(token, scope, targetId, fileInfo)
-
-  return { ok: true, fileInfo, result }
-}
-
-/** 解析文本中的 <qqmedia> 标签并批量处理 */
-async function processQQMediaText(text, context) {
-  const { mediaFiles } = parseQQMediaTags(text)
-  const scope = context.scope || 'group'
-  const targetId = context.targetId
-
-  const results = []
-  for (const media of mediaFiles) {
-    try {
-      const result = await uploadAndSendMedia({
-        path: media.path,
-        scope,
-        targetId,
-        appId: context.appId,
-        clientSecret: context.clientSecret
-      })
-      results.push({ ok: true, path: media.path, result })
-    } catch (e) {
-      results.push({ ok: false, path: media.path, error: e.message })
-    }
-  }
-
-  return results
-}
-
-// 导出
-export const tools = {
-  qqbot_media_upload: async (args) => await uploadAndSendMedia(args),
-  qqbot_media_process_text: async (args) => await processQQMediaText(args.text, args.context)
-}
-
-export const metadata = {
-  name: 'qqbot-media',
-  description: 'QQ Bot 富媒体上传工具，支持图片、文件、语音',
-  tools: ['qqbot_media_upload', 'qqbot_media_process_text']
-}