@raolin2025/claude-code-node 2.3.6 → 2.4.0

package/README.md

@@ -359,6 +359,13 @@ cc-node
       "type": "telegram",
       "token": "123456:ABC-DEF",
       "chatId": "78901234"
+    },
+    "qqbot": {
+      "type": "qqbot",
+      "token": "你的BotToken",
+      "appId": "你的AppID",
+      "channelId": "频道ID",
+      "groupOpenId": "群OpenID"
     }
   },
   "defaultChannel": "telegram"
@@ -379,9 +386,61 @@ cc-node
 - ❌ **执行出错**（自动通知错误内容）
 - 🔄 **手动发送**（`/channel send` 命令）
 
-## 🔔 后台运行 (cc-notify)
+## 📱 QQ Bot 远端编程（v2.0 新增）
+
+通过 QQ Bot API v2 实现远程编程控制。独立、零依赖、无需 OpenClaw。
+
+### 前置配置
+
+1. 前往 [QQ 开放平台](https://q.qq.com/) 注册机器人，获取 **AppID** 和 **AppSecret**
+2. 在 QQ 中与机器人对话或拉入群，使用 `/bot-me` 获取你的 **OpenID** 或 **群 OpenID**
+3. 配置环境变量：
+
+```bash
+export CC_NODE_CHANNEL_QQBOT_APPID=你的AppID
+export CC_NODE_CHANNEL_QQBOT_SECRET=你的AppSecret
+export CC_NODE_CHANNEL_QQBOT_GROUPID=你的群OpenID
+```
+
+### 使用方式
+
+启动 cc-notify 后，直接给机器人发消息或在群中 @机器人：
+
+```
+帮我写一个快速排序
+/ping
+/status
+/run ls -la
+/notify 任务完成！
+```
+
+### 技术架构
+
+```
+QQ消息 → WebSocket (wss://api.sgroup.qq.com) → cc-notify → cc-node
+cc-node → cc-notify → QQ API v2 (api.sgroup.qq.com/v2) → QQ消息
+```
+
+- **认证**: `appId + clientSecret` → `access_token`（自动续期，token 有效期 2 小时）
+- **发送**: POST `/v2/groups/{group_openid}/messages` (群) 或 `/v2/users/{openid}/messages` (C2C)
+- **接收**: WebSocket 长连接 + 心跳保活 + 自动重连
+- **代码**: 基于 [qqbot-standalone](https://github.com/bg1avd/qqbot-standalone) 的架构
+- **参考**: `src/channel/qqbot-listener.js`
+
+---
+
+## 🔔 后台运行 (cc-notify v2.0)
 
 cc-notify 是独立的通知守护进程，**不需要 cc-node 在前台运行**，开机自启后随时可用。
+支持 **Telegram** 和 **QQ Bot** 双通道远程编程。
+
+### v2.0 新特性
+
+- ✅ **QQ Bot 支持** — 通过 QQ 群/频道远程操控
+- ✅ **增强版 Telegram 监听** — 速率限制、Markdown 安全编码、多轮对话
+- ✅ **统一消息处理器** — 所有通道共享同一路由逻辑
+- ✅ **长消息分段** — 自动切分超过 4000 字符的回复
+- ✅ **API Key 持久化** — 自动生成并保存，重启不丢失
 
 ### 三种运行方式
 
@@ -393,14 +452,15 @@ cc-notify 是独立的通知守护进程，**不需要 cc-node 在前台运行**
 
 ### 手机交互
 
-在 Telegram 上给 Bot 发消息：
+在 Telegram/QQ 上给 Bot 发消息：
 
 ```
 你好                     → 当作一次性任务发给 cc-node 执行
 /ping                    → 检查服务是否在线
 /run ls -la              → 执行 shell 命令
-/notify 任务完成！        → 向所有通道广播通知
+/notify 任务完成！       → 向所有通道广播通知
 /status                  → 查看服务状态
+/cancel                  → 取消当前操作
 ```
 
 ### HTTP API（守护模式可用）
@@ -409,9 +469,16 @@ cc-notify 是独立的通知守护进程，**不需要 cc-node 在前台运行**
 # 发送通知
 curl -X POST http://localhost:3456/send \
   -H 'Content-Type: application/json' \
+  -H 'X-API-Key: <你的API_Key>' \
   -d '{"text":"构建完成 ✅"}'
 
-# 查看状态
+# 远程编程
+curl -X POST http://localhost:3456/chat \
+  -H 'Content-Type: application/json' \
+  -H 'X-API-Key: <你的API_Key>' \
+  -d '{"text":"帮我查下当前目录"}'
+
+# 查看状态（无需 API Key）
 curl http://localhost:3456/status
 ```
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@raolin2025/claude-code-node",
-  "version": "2.3.6",
-  "description": "Node.js AI Code Agent CLI - Zero dependencies, pure JavaScript, security hardened, multi-channel notifications",
+  "version": "2.4.0",
+  "description": "Node.js AI Code Agent CLI - Zero dependencies, pure JavaScript, security hardened, multi-channel notifications, Telegram & QQ Bot remote programming",
   "type": "module",
   "main": "src/index.js",
   "bin": {

package/src/channel/index.js

@@ -1,13 +1,14 @@
 /**
  * 通讯通道模块 — 支持多平台消息推送
  *
- * v1.1 修复:
- * - TelegramChannel: 添加缺失的 url 属性
- * - 新增 WeComChannel, FeishuChannel, DiscordChannel, SlackChannel 适配器实现
- * - 所有适配器统一错误处理
+ * v2.0 增强：
+ * - 新增 QQBotChannel 适配器（QQ Bot API v2）
+ * - 增强 TelegramChannel：Markdown 安全编码、分片发送、编辑/删除
+ * - 增强速率限制和错误处理
  *
  * 支持的通道：
  * - Telegram Bot API
+ * - QQ Bot (群/频道)
  * - 企业微信 (WeCom) Webhook
  * - 飞书 (Feishu) Webhook
  * - Discord Webhook
@@ -15,44 +16,256 @@
  * - 自定义 HTTP Webhook
  */
 
+// ============================================================
+// MarkdownV2 安全编码
+// ============================================================
+
+const TG_MD_ESCAPE_CHARS = /[_*[\]()~`>#+\-=|{}.!]/g
+
+function escapeMarkdownV2(text) {
+  return text.replace(TG_MD_ESCAPE_CHARS, '\\$&')
+}
+
 // ============================================================
 // 通道适配器
 // ============================================================
 
-/** Telegram Bot API 适配器 */
+/** Telegram Bot API 适配器 v2.0 */
 class TelegramChannel {
   constructor({ token, chatId }) {
     this.token = token
     this.chatId = chatId
-    // v1.1 修复: 添加缺失的 url 属性
-    this.url = `https://api.telegram.org/bot${token}/sendMessage`
-    this.method = 'POST'
-    this.headers = {}
-    this.bodyTemplate = null
+    this.apiBase = `https://api.telegram.org/bot${token}`
+    this.lastCall = 0
+    this.callInterval = 50  // 20 calls/sec max
   }
 
   get name() { return 'telegram' }
 
+  /** 速率限制等待 */
+  async _rateLimit() {
+    const now = Date.now()
+    const wait = this.callInterval - (now - this.lastCall)
+    if (wait > 0) await new Promise(r => setTimeout(r, wait))
+    this.lastCall = Date.now()
+  }
+
+  /** 发送消息（自动分段） */
   async send(text, options = {}) {
-    const body = JSON.stringify({
+    const MAX_LEN = 4000
+    const parts = this._splitMessage(text, MAX_LEN)
+    const results = []
+
+    for (let i = 0; i < parts.length; i++) {
+      const part = parts[i]
+      const header = i > 0 ? `📎 (${i + 1}/${parts.length})\n` : ''
+      const body = header + part
+
+      await this._rateLimit()
+      const result = await this._sendSingle(body, options)
+      results.push(result)
+
+      // 分段之间稍作延迟
+      if (i < parts.length - 1) {
+        await new Promise(r => setTimeout(r, 200))
+      }
+    }
+    return results[0] || {}
+  }
+
+  /** 单条发送 */
+  async _sendSingle(text, options = {}) {
+    const { parseMode, silent, replyTo, disableWebPreview, keyboard } = options
+    const useMarkdown = parseMode === 'Markdown' || parseMode === 'MarkdownV2' || !parseMode
+
+    const body = {
       chat_id: this.chatId,
-      text,
-      parse_mode: options.parseMode || 'Markdown',
-      disable_notification: options.silent || false,
-    })
-    const r = await fetch(this.url, {
-      method: this.method,
-      headers: { 'Content-Type': 'application/json', ...this.headers },
-      body,
+      text: text.slice(0, 4096),
+      parse_mode: 'HTML',  // HTML 比 Markdown 更稳定
+      disable_notification: silent || false,
+      disable_web_page_preview: disableWebPreview ?? true,
+    }
+
+    if (replyTo) body.reply_parameters = { message_id: replyTo }
+    if (keyboard) body.reply_markup = JSON.stringify(keyboard)
+
+    // Telegram HTML 安全编码（只保留基本标签）
+    body.text = this._safeHTML(body.text)
+
+    const r = await fetch(`${this.apiBase}/sendMessage`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(body),
     })
-    if (!r.ok) {
-      const errText = await r.text()
-      throw new Error(`Telegram API error ${r.status}: ${errText.slice(0, 200)}`)
+
+    const data = await r.json()
+    if (!data.ok) {
+      // 429 — 速率限制，自动等待
+      if (data.error_code === 429) {
+        const retryAfter = data.parameters?.retry_after || 3
+        await new Promise(r => setTimeout(r, retryAfter * 1000))
+        return this._sendSingle(text, { ...options, parseMode: undefined })
+      }
+      // 400 格式错 — 降级纯文本
+      if (data.error_code === 400) {
+        return this._sendSingle(text, { ...options, parseMode: 'text' })
+      }
+      throw new Error(`Telegram error ${data.error_code}: ${(data.description || '').slice(0, 200)}`)
     }
+    return data.result
+  }
+
+  /** 安全 HTML（只允许 Telegram 支持的基本标签） */
+  _safeHTML(text) {
+    // Telegram HTML 只支持: <b>, <i>, <u>, <s>, <code>, <pre>, <a href="">
+    // 替换不支持的标签
+    return text
+      .replace(/<h[1-6][^>]*>/gi, '<b>')
+      .replace(/<\/h[1-6]>/gi, '</b>')
+      .replace(/<br\s*\/?>/gi, '\n')
+      .replace(/<p[^>]*>/gi, '')
+      .replace(/<\/p>/gi, '\n\n')
+      .replace(/<strong>/gi, '<b>')
+      .replace(/<\/strong>/gi, '</b>')
+      .replace(/<em>/gi, '<i>')
+      .replace(/<\/em>/gi, '</i>')
+      .replace(/<hr[^>]*>/gi, '\n────────────\n')
+      .replace(/<img[^>]*>/gi, '[图片]')
+      .replace(/<[^>]+>/g, (tag) => {
+        const allowed = ['<b>', '</b>', '<i>', '</i>', '<u>', '</u>', '<s>', '</s>', '<code>', '</code>', '<pre>', '</pre>']
+        if (allowed.includes(tag.toLowerCase())) return tag
+        if (tag.toLowerCase().startsWith('<a ')) return tag
+        if (tag === '</a>') return tag
+        return ''
+      })
+  }
+
+  /** 分片消息 */
+  _splitMessage(text, maxLen) {
+    if (!text || text.length <= maxLen) return [text || '']
+    const parts = []
+    let current = ''
+    for (const line of text.split('\n')) {
+      if (current.length + line.length + 1 > maxLen) {
+        parts.push(current)
+        current = line
+      } else {
+        current += (current ? '\n' : '') + line
+      }
+    }
+    if (current) parts.push(current)
+    return parts
+  }
+
+  /** 编辑消息 */
+  async edit(messageId, text, options = {}) {
+    await this._rateLimit()
+    const r = await fetch(`${this.apiBase}/editMessageText`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        chat_id: this.chatId,
+        message_id: messageId,
+        text: this._safeHTML(text).slice(0, 4096),
+        parse_mode: 'HTML',
+      }),
+    })
     return r.json()
   }
+
+  /** 删除消息 */
+  async delete(messageId) {
+    await this._rateLimit()
+    const r = await fetch(`${this.apiBase}/deleteMessage`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ chat_id: this.chatId, message_id: messageId }),
+    })
+    return r.ok
+  }
 }
 
+// ============================================================
+// QQ Bot 通道适配器 v2.0
+// ============================================================
+
+/**
+ * QQ Bot 通道适配器 — 独立、零依赖
+ *
+ * 使用 QQ Bot API v2，仅需 appId + clientSecret
+ */
+class QQBotChannel {
+  constructor(config = {}) {
+    this.appId = config.appId || process.env.CC_NODE_CHANNEL_QQBOT_APPID || ''
+    this.secret = config.secret || config.clientSecret || process.env.CC_NODE_CHANNEL_QQBOT_SECRET || ''
+    this._token = null
+    this._tokenCache = { token: null, expireAt: 0 }
+    this.channelId = config.channelId || ''
+    this.groupOpenId = config.groupOpenId || ''
+  }
+
+  get name() { return 'qqbot' }
+
+  async _getToken() {
+    if (this._tokenCache.token && Date.now() < this._tokenCache.expireAt - 300000) {
+      return this._tokenCache.token
+    }
+    const res = await fetch('https://bots.qq.com/app/getAppAccessToken', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ appId: this.appId, clientSecret: this.secret }),
+    })
+    if (!res.ok) throw new Error('QQ Token API ' + res.status)
+    const data = JSON.parse(await res.text())
+    if (!data.access_token) throw new Error('Token API no access_token')
+    this._tokenCache.token = data.access_token
+    this._tokenCache.expireAt = Date.now() + (data.expires_in || 7200) * 1000
+    return data.access_token
+  }
+
+  async send(text, options = {}) {
+    if (!this.appId || !this.secret) {
+      return [{ channel: 'qqbot', ok: false, error: '需要 appId 和 clientSecret' }]
+    }
+    try {
+      const token = await this._getToken()
+      const results = []
+
+      const scope = options.scope || (this.groupOpenId ? 'group' : '')
+      const targetId = options.targetId || this.groupOpenId || this.channelId
+
+      if (!scope || !targetId) {
+        return [{ channel: 'qqbot', ok: false, error: '未配置目标 (groupOpenId)' }]
+      }
+
+      const path = scope === 'group'
+        ? '/v2/groups/' + targetId + '/messages'
+        : '/v2/users/' + targetId + '/messages'
+
+      const body = { content: text.slice(0, 2000), msg_type: 0 }
+      if (options.replyMsgId) body.msg_id = options.replyMsgId
+
+      const r = await fetch('https://api.sgroup.qq.com' + path, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', Authorization: 'QQBot ' + token },
+        body: JSON.stringify(body),
+      })
+      if (!r.ok) {
+        const errText = await r.text().catch(() => '')
+        throw new Error('HTTP ' + r.status + ': ' + errText.slice(0, 100))
+      }
+      results.push({ channel: 'qqbot', ok: true })
+      return results
+    } catch (e) {
+      return [{ channel: 'qqbot', ok: false, error: e.message.slice(0, 200) }]
+    }
+  }
+}
+
+// ============================================================
+// 已有适配器（保持兼容）
+// ============================================================
+
 /** 企业微信 Webhook 适配器 */
 class WeComChannel {
   constructor({ webhookUrl }) {
@@ -64,7 +277,7 @@ class WeComChannel {
   async send(text, options = {}) {
     const body = JSON.stringify({
       msgtype: 'text',
-      text: { content: text },
+      text: { content: text.slice(0, 2048) },
     })
     const r = await fetch(this.webhookUrl, {
       method: 'POST',
@@ -90,7 +303,7 @@ class FeishuChannel {
   async send(text, options = {}) {
     const body = JSON.stringify({
       msg_type: 'text',
-      content: { text },
+      content: { text: text.slice(0, 4096) },
     })
     const r = await fetch(this.webhookUrl, {
       method: 'POST',
@@ -114,7 +327,7 @@ class DiscordChannel {
   get name() { return 'discord' }
 
   async send(text, options = {}) {
-    const body = JSON.stringify({ content: text })
+    const body = JSON.stringify({ content: text.slice(0, 2000) })
     const r = await fetch(this.webhookUrl, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
@@ -137,7 +350,7 @@ class SlackChannel {
   get name() { return 'slack' }
 
   async send(text, options = {}) {
-    const body = JSON.stringify({ text })
+    const body = JSON.stringify({ text: text.slice(0, 3000) })
     const r = await fetch(this.webhookUrl, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
@@ -185,6 +398,7 @@ class WebhookChannel {
 
 const CHANNEL_ADAPTERS = {
   telegram: TelegramChannel,
+  qqbot: QQBotChannel,
   wecom: WeComChannel,
   feishu: FeishuChannel,
   discord: DiscordChannel,
@@ -195,10 +409,16 @@ const CHANNEL_ADAPTERS = {
 const ENV_PREFIX = 'CC_NODE_CHANNEL_'
 
 export class ChannelManager {
-  constructor(config = {}) {
+  constructor(config = {}, defaultChannel) {
     this.channels = new Map()
-    this.defaultChannel = config.defaultChannel || null
-    this._loadFromConfig(config)
+    this.defaultChannel = defaultChannel || config.defaultChannel || null
+    if (config.channels) {
+      this._loadFromConfig(config)
+    }
+    // If config is array-like or flat, handle old format
+    if (typeof config === 'object' && !config.channels && Object.keys(config).length > 0) {
+      this._loadFromConfig({ channels: config })
+    }
     this._loadFromEnv()
   }
 
@@ -209,9 +429,6 @@ export class ChannelManager {
       if (chConfig.enabled === false) continue
       this._registerChannel(name, chConfig)
     }
-    if (config.defaultChannel) {
-      this.defaultChannel = config.defaultChannel
-    }
   }
 
   /** 从环境变量加载通道 */
@@ -221,12 +438,13 @@ export class ChannelManager {
       if (!key.startsWith(ENV_PREFIX)) continue
       const rest = key.slice(ENV_PREFIX.length)
       if (rest === 'DEFAULT') {
-        this.defaultChannel = value.toLowerCase()
+        if (!this.defaultChannel) this.defaultChannel = value.toLowerCase()
         continue
       }
       const parts = rest.split('_')
       const channelType = parts[0].toLowerCase()
       const param = parts.slice(1).join('_').toLowerCase()
+
       if (!envChannels[channelType]) envChannels[channelType] = { type: channelType }
       const camelKey = param.replace(/_([a-z])/g, (_, c) => c.toUpperCase())
       envChannels[channelType][camelKey] = value
@@ -268,6 +486,21 @@ export class ChannelManager {
     for (const name of targetChannels) {
       const ch = this.channels.get(name)
       if (!ch) {
+        // 不存在的通道尝试按 type 注册
+        const Adapter = CHANNEL_ADAPTERS[name]
+        if (Adapter) {
+          this._registerChannel(name, { type: name })
+          const ch2 = this.channels.get(name)
+          if (ch2) {
+            try {
+              const result = await ch2.send(text, options)
+              results.push({ channel: name, ok: true, result })
+            } catch (e) {
+              results.push({ channel: name, ok: false, error: e.message })
+            }
+            continue
+          }
+        }
         results.push({ channel: name, ok: false, error: 'not registered' })
         continue
       }
@@ -289,8 +522,20 @@ export class ChannelManager {
       'question': `❓ 需要确认\n${data.question || ''}\n${data.options ? '选项：' + data.options.join(' / ') : ''}`,
       'progress': `🔄 进度更新\n${data.task || ''}\n${data.progress || ''}${data.percent ? ' (' + data.percent + '%)' : ''}`,
       'warning': `⚠️ 警告\n${data.message || ''}`,
+      'debug': `🔍 调试信息\n${data.info || ''}`,
     }
     const text = templates[template] || `📢 ${data.message || ''}`
     return this.send(text, options)
   }
 }
+
+// 导出适配器类（供外部使用）
+export {
+  TelegramChannel,
+  QQBotChannel,
+  WeComChannel,
+  FeishuChannel,
+  DiscordChannel,
+  SlackChannel,
+  WebhookChannel,
+}