@raolin2025/claude-code-node 2.5.2 → 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/index.js

@@ -5,3 +5,4 @@ export { unifiedDiff, inlineDiff } from './diff.js'
 export { safeReadFile, safeWriteFile, editFile, pathExists, removeRecursive, getMtime, resolvePath } from './file-ops.js'
 export { execCommand, spawnProcess, commandExists, sendInput } from './process.js'
 export { format, codeBlock, formatPath, formatToolCall, formatToolResult, formatTokenUsage, formatDuration, formatBytes, formatTable, progressBar } from './format.js'
+export { isLocalLlmServer, isLocalHostname, buildAuthHeaders } from './llm-server.js'

package/src/utils/llm-server.js

@@ -0,0 +1,106 @@
+/**
+ * LLM 服务器识别工具
+ *
+ * 用于判断一个 `--api-base` 是否是「自建本地 LLM 服务」。
+ * 自建服务（Ollama / llama.cpp / vLLM 等）通常运行在 localhost 或内网，
+ * 且默认【不需要 apiKey】（认证是可选配置）。
+ *
+ * 用途：当 apiBase 指向自建服务时，允许缺省 apiKey 运行，
+ *      并将旧的 `Authorization: Bearer undefined` 替换为不附带该头。
+ *      这解决了公共项目接入 Ollama / llama.cpp / vLLM 时被强制要求
+ *      假 apiKey 的问题。
+ */
+
+// RFC1918 私有段 + 回环
+const PRIVATE_PATTERNS = [
+  /^127\./,        // 127.0.0.0/8 回环
+  /^10\./,         // 10.0.0.0/8
+  /^192\.168\./,   // 192.168.0.0/16
+  /^172\.(1[6-9]|2\d|3[01])\./, // 172.16.0.0/12
+  /^169\.254\./,   // 链路本地
+  /^::1$/,         // IPv6 回环
+  /^fc[0-9a-f]{2}:/i, // IPv6 ULA fc00::/7
+  /^fe[89ab][0-9a-f]:/i, // IPv6 link-local fe80::/10
+]
+
+// 明确视为「本地自建」的主机名关键词
+const LOCAL_HOSTNAME_KEYWORDS = [
+  'localhost',
+  '127.0.0.1',
+  '::1',
+  '.local',
+  '.lan',
+  '.localdomain',
+]
+
+let cachedHost = null
+
+/**
+ * 从 URL 中提取 host（含端口），便于可读性判断
+ */
+function parseUrl(apiBase) {
+  try {
+    return new URL(apiBase)
+  } catch {
+    // 非标准 URL（可能缺 scheme），尝试补 http:// 再解析
+    try {
+      return new URL(apiBase.startsWith('http') ? apiBase : `http://${apiBase}`)
+    } catch {
+      return null
+    }
+  }
+}
+
+/**
+ * 判断主机是否为「本地/内网/回环」地址
+ * @param {string} hostname - 无端口的主机名或 IP
+ */
+export function isLocalHostname(hostname) {
+  if (!hostname) return false
+  const h = hostname.toLowerCase()
+
+  // 主机名关键词
+  for (const kw of LOCAL_HOSTNAME_KEYWORDS) {
+    if (kw.startsWith('.') ? h.endsWith(kw) : (h === kw || h.startsWith(kw + '.'))) {
+      return true
+    }
+  }
+
+  // IPv4 / IPv6 私有段
+  for (const re of PRIVATE_PATTERNS) {
+    if (re.test(h)) return true
+  }
+
+  return false
+}
+
+/**
+ * 判断一个 apiBase 是否指向「自建本地 LLM 服务」（无需强制 apiKey）
+ * @param {string} apiBase - 如 http://127.0.0.1:11434/v1
+ */
+export function isLocalLlmServer(apiBase) {
+  if (!apiBase) return false
+  const url = parseUrl(apiBase)
+  if (!url || !url.hostname) return false
+  return isLocalHostname(url.hostname)
+}
+
+/**
+ * 计算请求应携带的 Authorization 头。
+ * - 若提供了 apiKey → 正常 Bearer
+ * - 若未提供 apiKey 且目标是【自建本地服务】 → 不附带该头（返回 null/undefined）
+ * - 若未提供 apiKey 且目标是【云端服务】 → 返回 null（由上层决定是否报错）
+ * @param {string} apiBase
+ * @param {string} apiKey
+ * @returns {{ Authorization: string } | undefined} 返回 undefined 表示不附带 Authorization 头
+ */
+export function buildAuthHeaders(apiBase, apiKey) {
+  if (apiKey) {
+    return { 'Authorization': `Bearer ${apiKey}` }
+  }
+  // 无 key：本地自建服务返回空对象（不带 Authorization），云端返回 undefined（保持不变，交由上层判断）
+  if (isLocalLlmServer(apiBase)) {
+    return {}
+  }
+  return undefined
+}

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)
-}