@raolin2025/claude-code-node 2.5.0 → 2.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raolin2025/claude-code-node",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "description": "Node.js AI Code Agent CLI - Zero dependencies, pure JavaScript, security hardened, multi-channel notifications, Telegram & QQ Bot remote programming, rich media upload, multi-account management",
   "type": "module",
   "main": "src/index.js",

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

@@ -0,0 +1,147 @@
+/**
+ * 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

@@ -0,0 +1,177 @@
+/**
+ * QQ Bot 富媒体工具 — 图片/语音/文件上传与发送
+ *
+ * 功能：
+ * - 验证文件路径（必须在 ~/.openclaw/media/qqbot 或 ~/.openclaw/media）
+ * - 自动检测文件类型
+ * - 上传并通过 QQ Bot 发送
+ *
+ * 使用方式：
+ *   qqbot_media: { action: 'upload', path: '/home/.../image.png', scope: 'group', targetId: '群OPENID' }
+ */
+
+import { QQBotEnhanced } from '../src/channel/qqbot-enhanced.js'
+import { parseQQMediaTags } from '../src/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']
+}

package/src/tools/qqbot-remind.js

@@ -0,0 +1,42 @@
+/**
+ * QQ Bot 定时提醒工具 — 基于 cron 的定时任务（简化版）
+ *
+ * 注意：此工具依赖主项目的定时任务系统。当前实现为占位符，
+ * 实际功能待后续与 cc-node 的调度系统集成后完成。
+ */
+
+// 时间解析器
+function parseRelativeTime(timeStr) {
+  const match = timeStr.match(/^(\d+)(h|m|s)$/)
+  if (!match) return null
+  const [, value, unit] = match
+  const num = parseInt(value, 10)
+  const multipliers = { s: 1000, m: 60000, h: 3600000 }
+  return num * multipliers[unit]
+}
+
+/** 主工具函数 */
+async function qqbotRemind(args) {
+  const { action, content, time, targetId, accountId, jobId } = args
+
+  if (!action || !['add', 'list', 'remove'].includes(action)) {
+    return { ok: false, error: 'action 必须为 add/list/remove' }
+  }
+
+  // 占位：说明需要集成调度系统
+  return {
+    ok: false,
+    error: `qqbot_remind 尚未完整集成定时任务系统。当前收到: action=${action}, content=${content}, time=${time}, targetId=${targetId}`
+  }
+}
+
+// 导出
+export const tools = {
+  qqbotRemind
+}
+
+export const metadata = {
+  name: 'qqbot-remind',
+  description: 'QQ Bot 定时提醒工具 —— 支持一次性/周期性提醒（待集成调度系统）',
+  tools: ['qqbot_remind']
+}

package/src/tools/qqbot-tools-wrapper.js

@@ -8,9 +8,9 @@
  */
 
 import { ToolDef } from '../types/index.js'
-import { tools as qqbotChannelApiTools } from '../../tools/qqbot-channel-api.js'
-import { tools as qqbotRemindTools } from '../../tools/qqbot-remind.js'
-import { tools as qqbotMediaTools } from '../../tools/qqbot-media.js'
+import { tools as qqbotChannelApiTools } from './qqbot-channel-api.js'
+import { tools as qqbotRemindTools } from './qqbot-remind.js'
+import { tools as qqbotMediaTools } from './qqbot-media.js'
 
 // 通用执行器：将原始函数包装为 ToolDef 的执行格式
 function createExecutor(originalFunc) {