@raolin2025/claude-code-node 1.0.1 → 1.1.0

package/README.md

@@ -317,3 +317,63 @@ claude-code-node/              33 文件 · 4307 行
 
 *基于 Claude Code 架构的 OpenAI 兼容重构*  
 *零外部依赖 · DeepSeek 默认 · 安全加固 · MIT License*
+
+## 📡 通讯通道 (Notification Channels)
+
+cc-node 支持多平台消息推送，任务完成或出错时自动通知到手机。
+
+### 支持的通道
+
+| 通道 | 配置方式 | 说明 |
+|------|----------|------|
+| **Telegram** | Bot Token + Chat ID | 最推荐，支持 Markdown |
+| **企业微信** | Webhook URL | 群机器人 |
+| **飞书** | Webhook URL | 群机器人 |
+| **Discord** | Webhook URL | 服务器频道 |
+| **Slack** | Webhook URL | Incoming Webhook |
+| **自定义** | HTTP URL + Method | 任意 Webhook |
+
+### 快速配置 (Telegram 为例)
+
+```bash
+# 1. 在 Telegram 找 @BotFather 创建 Bot，拿到 Token
+# 2. 获取你的 Chat ID（给 Bot 发消息后访问 https://api.telegram.org/bot<TOKEN>/getUpdates）
+# 3. 设置环境变量
+export CC_NODE_CHANNEL_TELEGRAM_TOKEN=123456:ABC-DEF
+export CC_NODE_CHANNEL_TELEGRAM_CHAT_ID=78901234
+export CC_NODE_CHANNEL_DEFAULT=telegram
+
+# 4. 启动 cc-node，会自动加载
+cc-node
+```
+
+### 配置文件方式
+
+在 `.claude-code/config.json` 中：
+
+```json
+{
+  "channels": {
+    "telegram": {
+      "type": "telegram",
+      "token": "123456:ABC-DEF",
+      "chatId": "78901234"
+    }
+  },
+  "defaultChannel": "telegram"
+}
+```
+
+### REPL 命令
+
+```
+/channel list           — 列出已配置通道
+/channel test           — 测试通道连通性
+/channel send hello     — 手动发送消息
+```
+
+### 通知时机
+
+- ✅ **任务完成**（one-shot 模式自动通知）
+- ❌ **执行出错**（自动通知错误内容）
+- 🔄 **手动发送**（`/channel send` 命令）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raolin2025/claude-code-node",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Node.js AI Code Agent CLI - Zero dependencies, pure JavaScript, security hardened",
   "type": "module",
   "main": "src/index.js",

package/src/channel/index.js

@@ -0,0 +1,361 @@
+/**
+ * 通讯通道模块 — 支持多平台消息推送
+ * 
+ * 支持的通道：
+ *   - Telegram Bot API
+ *   - 企业微信 (WeCom) Webhook
+ *   - 飞书 (Feishu) Webhook
+ *   - Discord Webhook
+ *   - Slack Webhook
+ *   - 自定义 HTTP Webhook
+ * 
+ * 配置方式：
+ *   环境变量或 .claude-code/config.json 中的 channels 字段
+ * 
+ * 用法：
+ *   import { ChannelManager } from './channel.js'
+ *   const cm = new ChannelManager()
+ *   await cm.send('任务完成！结果：xxx')
+ *   await cm.send('⚠️ 警告', { channel: 'telegram' })
+ */
+
+import { readFileSync, existsSync } from 'fs'
+import { resolve } from 'path'
+import { homedir } from 'os'
+import { execSync } from 'child_process'
+
+// ============================================================
+// 通道适配器
+// ============================================================
+
+/** Telegram Bot API 适配器 */
+class TelegramChannel {
+  constructor({ token, chatId }) {
+    this.token = token
+    this.chatId = chatId
+  }
+
+  get name() { return 'telegram' }
+
+  async send(text, options = {}) {
+    const url = `https://api.telegram.org/bot${this.token}/sendMessage`
+    const body = {
+      chat_id: this.chatId,
+      text,
+      parse_mode: options.parseMode || 'Markdown',
+      disable_notification: options.silent || false,
+    }
+    return fetch(url, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(body),
+    }).then(r => r.json())
+  }
+}
+
+/** 企业微信 Webhook 适配器 */
+class WeComChannel {
+  constructor({ webhookUrl }) {
+    this.webhookUrl = webhookUrl
+  }
+
+  get name() { return 'wecom' }
+
+  async send(text, options = {}) {
+    const body = {
+      msgtype: options.msgType || 'text',
+      text: { content: text },
+      markdown: options.parseMode === 'markdown' ? { content: text } : undefined,
+    }
+    // 清理 undefined 字段
+    if (body.markdown === undefined) delete body.markdown
+    if (body.msgtype === 'markdown') delete body.text
+
+    return fetch(this.webhookUrl, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(body),
+    }).then(r => r.json())
+  }
+}
+
+/** 飞书 Webhook 适配器 */
+class FeishuChannel {
+  constructor({ webhookUrl }) {
+    this.webhookUrl = webhookUrl
+  }
+
+  get name() { return 'feishu' }
+
+  async send(text, options = {}) {
+    const body = {
+      msg_type: options.msgType || 'text',
+      content: options.parseMode === 'markdown'
+        ? JSON.stringify({ text: text })
+        : JSON.stringify({ text: text }),
+    }
+    return fetch(this.webhookUrl, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(body),
+    }).then(r => r.json())
+  }
+}
+
+/** Discord Webhook 适配器 */
+class DiscordChannel {
+  constructor({ webhookUrl }) {
+    this.webhookUrl = webhookUrl
+  }
+
+  get name() { return 'discord' }
+
+  async send(text, options = {}) {
+    const body = {
+      content: text,
+      username: options.username || 'cc-node',
+    }
+    return fetch(this.webhookUrl, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(body),
+    }).then(r => r.json())
+  }
+}
+
+/** Slack Webhook 适配器 */
+class SlackChannel {
+  constructor({ webhookUrl }) {
+    this.webhookUrl = webhookUrl
+  }
+
+  get name() { return 'slack' }
+
+  async send(text, options = {}) {
+    const body = {
+      text,
+      username: options.username || 'cc-node',
+      mrkdwn: options.parseMode !== 'plain',
+    }
+    return fetch(this.webhookUrl, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(body),
+    }).then(r => r.text())
+  }
+}
+
+/** 通用 HTTP Webhook 适配器 */
+class WebhookChannel {
+  constructor({ url, method = 'POST', headers = {}, bodyTemplate }) {
+    this.url = url
+    this.method = method
+    this.headers = headers
+    this.bodyTemplate = bodyTemplate
+  }
+
+  get name() { return 'webhook' }
+
+  async send(text, options = {}) {
+    const body = this.bodyTemplate
+      ? this.bodyTemplate.replace('{text}', text)
+      : JSON.stringify({ text, ...options })
+    
+    return fetch(this.url, {
+      method: this.method,
+      headers: { 'Content-Type': 'application/json', ...this.headers },
+      body,
+    }).then(r => r.text())
+  }
+}
+
+// ============================================================
+// 通道管理器
+// ============================================================
+
+const CHANNEL_ADAPTERS = {
+  telegram: TelegramChannel,
+  wecom: WeComChannel,
+  feishu: FeishuChannel,
+  discord: DiscordChannel,
+  slack: SlackChannel,
+  webhook: WebhookChannel,
+}
+
+const ENV_PREFIX = 'CC_NODE_CHANNEL_'
+
+export class ChannelManager {
+  constructor(config = {}) {
+    this.channels = new Map()
+    this.defaultChannel = config.defaultChannel || null
+    this._loadFromConfig(config)
+    this._loadFromEnv()
+  }
+
+  /** 从配置对象加载通道 */
+  _loadFromConfig(config) {
+    if (!config.channels) return
+    for (const [name, chConfig] of Object.entries(config.channels)) {
+      if (chConfig.enabled === false) continue
+      this._registerChannel(name, chConfig)
+    }
+    if (config.defaultChannel) {
+      this.defaultChannel = config.defaultChannel
+    }
+  }
+
+  /** 从环境变量加载通道
+   *  
+   *  环境变量格式：
+   *    CC_NODE_CHANNEL_TELEGRAM_TOKEN=xxx
+   *    CC_NODE_CHANNEL_TELEGRAM_CHAT_ID=xxx
+   *    CC_NODE_CHANNEL_WECOM_WEBHOOK_URL=xxx
+   *    CC_NODE_CHANNEL_DEFAULT=telegram
+   */
+  _loadFromEnv() {
+    const envChannels = {}
+    
+    for (const [key, value] of Object.entries(process.env)) {
+      if (!key.startsWith(ENV_PREFIX)) continue
+      const rest = key.slice(ENV_PREFIX.length)
+      
+      if (rest === 'DEFAULT') {
+        this.defaultChannel = value.toLowerCase()
+        continue
+      }
+      
+      // 解析 CC_NODE_CHANNEL_<TYPE>_<PARAM>
+      const parts = rest.split('_')
+      const channelType = parts[0].toLowerCase()
+      const param = parts.slice(1).join('_').toLowerCase()
+      
+      if (!envChannels[channelType]) envChannels[channelType] = { type: channelType }
+      // 将 SNAKE_CASE 转为 camelCase
+      const camelKey = param.replace(/_([a-z])/g, (_, c) => c.toUpperCase())
+      envChannels[channelType][camelKey] = value
+    }
+    
+    for (const [name, chConfig] of Object.entries(envChannels)) {
+      if (!this.channels.has(name)) {
+        this._registerChannel(name, chConfig)
+      }
+    }
+  }
+
+  /** 注册一个通道 */
+  _registerChannel(name, config) {
+    const type = config.type || name
+    const Adapter = CHANNEL_ADAPTERS[type]
+    if (!Adapter) {
+      console.warn(`[channel] Unknown channel type: ${type}`)
+      return
+    }
+    try {
+      const instance = new Adapter(config)
+      this.channels.set(name, instance)
+    } catch (e) {
+      console.warn(`[channel] Failed to register ${name}: ${e.message}`)
+    }
+  }
+
+  /** 获取已注册通道列表 */
+  list() {
+    return Array.from(this.channels.keys())
+  }
+
+  /** 发送消息
+   *  @param {string} text — 消息内容
+   *  @param {object} options — 
+   *    channel: 通道名（默认用 defaultChannel 或全部通道）
+   *    parseMode: 'Markdown' | 'plain'
+   *    silent: 静默通知
+   */
+  async send(text, options = {}) {
+    const targetChannels = options.channel
+      ? [options.channel]
+      : this.defaultChannel
+        ? [this.defaultChannel]
+        : this.list()
+
+    const results = []
+    for (const name of targetChannels) {
+      const ch = this.channels.get(name)
+      if (!ch) {
+        results.push({ channel: name, ok: false, error: 'not registered' })
+        continue
+      }
+      try {
+        const result = await ch.send(text, options)
+        results.push({ channel: name, ok: true, result })
+      } catch (e) {
+        results.push({ channel: name, ok: false, error: e.message })
+      }
+    }
+    return results
+  }
+
+  /** 发送模板消息
+   *  @param {string} template — 模板名：'task-done', 'error', 'question'
+   *  @param {object} data — 模板变量
+   */
+  async sendTemplate(template, data = {}, options = {}) {
+    const templates = {
+      'task-done': `✅ 任务完成\n${data.task || ''}\n${data.result ? '结果：' + data.result : ''}`,
+      'error': `❌ 错误\n${data.task || ''}\n${data.error || ''}`,
+      '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 || ''}`,
+    }
+    const text = templates[template] || `📢 ${data.message || text}`
+    return this.send(text, options)
+  }
+}
+
+// ============================================================
+// REPL 命令集成
+// ============================================================
+
+/** 注册 /channel 命令到 REPL */
+export function registerChannelCommands(repl, channelManager) {
+  if (!repl || !channelManager) return
+
+  repl.addCommand('/channel', {
+    description: '管理通讯通道',
+    handler: async (args) => {
+      const sub = args.trim()
+      if (sub === 'list' || sub === '') {
+        const channels = channelManager.list()
+        if (channels.length === 0) {
+          console.log('📭 没有配置通讯通道')
+          console.log('   设置方法：')
+          console.log('   1. 环境变量: CC_NODE_CHANNEL_TELEGRAM_TOKEN=xxx')
+          console.log('   2. 配置文件: .claude-code/config.json -> channels')
+        } else {
+          console.log('📬 已配置通道:')
+          channels.forEach(ch => {
+            const isDefault = channelManager.defaultChannel === ch ? ' (默认)' : ''
+            console.log(`   - ${ch}${isDefault}`)
+          })
+        }
+      } else if (sub.startsWith('send ')) {
+        const text = sub.slice(5)
+        const results = await channelManager.send(text)
+        results.forEach(r => {
+          console.log(r.ok ? `✅ ${r.channel}: 发送成功` : `❌ ${r.channel}: ${r.error}`)
+        })
+      } else if (sub.startsWith('test')) {
+        const results = await channelManager.send('📡 cc-node 通道测试消息')
+        results.forEach(r => {
+          console.log(r.ok ? `✅ ${r.channel}: 测试成功` : `❌ ${r.channel}: ${r.error}`)
+        })
+      } else {
+        console.log('用法:')
+        console.log('  /channel list       — 列出通道')
+        console.log('  /channel send <msg> — 发送消息')
+        console.log('  /channel test       — 测试通道')
+      }
+    }
+  })
+}
+
+export default ChannelManager

package/src/core/cli.js

@@ -9,28 +9,30 @@ import { SessionManager } from './session.js'
 import { Config } from './config.js'
 import { TokenBudget } from './token-budget.js'
 import { PermissionChecker } from '../permission/permission.js'
+import { ChannelManager } from '../channel/index.js'
 
 const BANNER = `
 ╔═══════════════════════════════════════════════╗
-║  AI Code Agent — Node.js Edition              ║
-║  OpenAI-Compatible · DeepSeek Default          ║
-║  Type '/help' for commands                     ║
-║  Type '/exit' or Ctrl+C to quit                ║
+║   AI Code Agent — Node.js Edition            ║
+║   OpenAI-Compatible · DeepSeek Default        ║
+║   Type '/help' for commands                   ║
+║   Type '/exit' or Ctrl+C to quit              ║
 ╚═══════════════════════════════════════════════╝
 `.trim()
 
 const HELP_TEXT = `
 Commands:
-  /help        — Show this help
-  /model NAME  — Switch model
-  /tools       — List available tools
-  /session     — Show session info
-  /sessions    — List all sessions
-  /clear       — Clear conversation
-  /config KEY  — Show config value
-  /budget      — Show token budget
-  /exit        — Exit (also Ctrl+C)
-  /quit        — Same as /exit
+  /help          — Show this help
+  /model NAME    — Switch model
+  /tools         — List available tools
+  /session       — Show session info
+  /sessions      — List all sessions
+  /clear         — Clear conversation
+  /config KEY    — Show config value
+  /budget        — Show token budget
+  /channel CMD   — Manage notification channels (list|send|test)
+  /exit          — Exit (also Ctrl+C)
+  /quit          — Same as /exit
 `
 
 /**
@@ -52,41 +54,16 @@ function parseArgs(argv) {
   while (i < argv.length) {
     const arg = argv[i]
     switch (arg) {
-      case '--model':
-      case '-m':
-        args.model = argv[++i]
-        break
-      case '--system-prompt':
-      case '-s':
-        args.systemPrompt = argv[++i]
-        break
-      case '--permission-mode':
-      case '-p':
-        args.permissionMode = argv[++i]
-        break
-      case '--max-turns':
-      case '-t':
-        args.maxTurns = parseInt(argv[++i], 10)
-        break
-      case '--api-key':
-        args.apiKey = argv[++i]
-        break
-      case '--api-base':
-        args.apiBase = argv[++i]
-        break
-      case '--resume':
-      case '-r':
-        args.resume = argv[++i]
-        break
-      case '--verbose':
-      case '-v':
-        args.verbose = true
-        break
-      case '--no-stream':
-        args.noStream = true
-        break
-      case '--help':
-      case '-h':
+      case '--model': case '-m': args.model = argv[++i]; break
+      case '--system-prompt': case '-s': args.systemPrompt = argv[++i]; break
+      case '--permission-mode': case '-p': args.permissionMode = argv[++i]; break
+      case '--max-turns': case '-t': args.maxTurns = parseInt(argv[++i], 10); break
+      case '--api-key': args.apiKey = argv[++i]; break
+      case '--api-base': args.apiBase = argv[++i]; break
+      case '--resume': case '-r': args.resume = argv[++i]; break
+      case '--verbose': case '-v': args.verbose = true; break
+      case '--no-stream': args.noStream = true; break
+      case '--help': case '-h':
         console.log(`Usage: cc-node [options]
 
 Options:
@@ -95,24 +72,33 @@ Options:
   -p, --permission-mode     Permission mode: ask|always-allow|deny (default: ask)
   -t, --max-turns N         Max tool loop turns (default: 100)
   --api-base URL            API base URL (default: https://api.deepseek.com/v1)
-  --api-key KEY             API key (or set LLM_API_KEY env)
+  --api-key ***             API key (or set LLM_API_KEY env)
   -r, --resume ID           Resume a session
   -v, --verbose             Verbose mode
   --no-stream               Disable streaming
   -h, --help                Show this help
 
 Environment variables:
-  LLM_API_KEY               Universal API key (recommended)
-  DEEPSEEK_API_KEY          DeepSeek API key (default)
-  OPENAI_API_KEY            OpenAI API key
-  QWEN_API_KEY              Qwen (DashScope) API key
-  GLM_API_KEY               Zhipu GLM API key
-  KIMI_API_KEY              Moonshot Kimi API key
-  LLM_API_BASE              API base URL (default: https://api.deepseek.com/v1)`)
+  LLM_API_KEY        Universal API key (recommended)
+  DEEPSEEK_API_KEY   DeepSeek API key (default)
+  OPENAI_API_KEY     OpenAI API key
+  QWEN_API_KEY       Qwen (DashScope) API key
+  GLM_API_KEY        Zhipu GLM API key
+  KIMI_API_KEY       Moonshot Kimi API key
+  LLM_API_BASE       API base URL (default: https://api.deepseek.com/v1)
+
+Channel environment variables:
+  CC_NODE_CHANNEL_DEFAULT              Default channel name
+  CC_NODE_CHANNEL_TELEGRAM_TOKEN       Telegram bot token
+  CC_NODE_CHANNEL_TELEGRAM_CHAT_ID     Telegram chat ID
+  CC_NODE_CHANNEL_WECOM_WEBHOOK_URL    WeCom webhook URL
+  CC_NODE_CHANNEL_FEISHU_WEBHOOK_URL   Feishu webhook URL
+  CC_NODE_CHANNEL_DISCORD_WEBHOOK_URL  Discord webhook URL
+  CC_NODE_CHANNEL_SLACK_WEBHOOK_URL    Slack webhook URL
+`)
         process.exit(0)
       default:
         if (!arg.startsWith('-')) {
-          // 非选项参数视为一次性输入
           args.oneShot = argv.slice(i).join(' ')
           i = argv.length
         }
@@ -120,7 +106,6 @@ Environment variables:
     }
     i++
   }
-
   return args
 }
 
@@ -191,10 +176,23 @@ export async function main() {
     maxTokens: config.get('maxBudgetTokens') || 200_000,
   })
 
+  // 初始化通讯通道
+  const channelManager = new ChannelManager({
+    channels: config.get('channels') || {},
+    defaultChannel: config.get('defaultChannel') || null,
+  })
+
   // 一次性输入模式
   if (cliArgs.oneShot) {
     const result = await engine.processMessage(cliArgs.oneShot)
     console.log(result.response)
+    // 一次性模式结束后发通知
+    if (channelManager.list().length > 0) {
+      await channelManager.sendTemplate('task-done', {
+        task: cliArgs.oneShot.slice(0, 80),
+        result: result.response.slice(0, 200),
+      })
+    }
     process.exit(0)
   }
 
@@ -207,16 +205,17 @@ export async function main() {
 
   console.log(BANNER)
   console.log(`Model: ${model} | Permission: ${permissionMode} | Tools: ${registry.getNames().join(', ')}`)
+  if (channelManager.list().length > 0) {
+    const chList = channelManager.list().join(', ')
+    const def = channelManager.defaultChannel ? ` (default: ${channelManager.defaultChannel})` : ''
+    console.log(`Channels: ${chList}${def}`)
+  }
   console.log()
-
   rl.prompt()
 
   rl.on('line', async (line) => {
     const input = line.trim()
-    if (!input) {
-      rl.prompt()
-      return
-    }
+    if (!input) { rl.prompt(); return }
 
     // 命令处理
     if (input.startsWith('/')) {
@@ -273,6 +272,41 @@ export async function main() {
         case 'budget':
           console.log(tokenBudget.format())
           break
+        case 'channel': {
+          const subCmd = rest.join(' ')
+          if (subCmd === 'list' || subCmd === '') {
+            const channels = channelManager.list()
+            if (channels.length === 0) {
+              console.log('No channels configured')
+              console.log('Setup options:')
+              console.log('  1. Environment: CC_NODE_CHANNEL_TELEGRAM_TOKEN=xxx CC_NODE_CHANNEL_TELEGRAM_CHAT_ID=xxx')
+              console.log('  2. Config: .claude-code/config.json -> { "channels": { "telegram": { ... } } }')
+            } else {
+              console.log('Channels:')
+              for (const ch of channels) {
+                const isDefault = channelManager.defaultChannel === ch ? ' (default)' : ''
+                console.log(`  - ${ch}${isDefault}`)
+              }
+            }
+          } else if (subCmd.startsWith('send ')) {
+            const text = subCmd.slice(5)
+            const results = await channelManager.send(text)
+            for (const r of results) {
+              console.log(r.ok ? `✅ ${r.channel}: sent` : `❌ ${r.channel}: ${r.error}`)
+            }
+          } else if (subCmd.startsWith('test')) {
+            const results = await channelManager.send('📡 cc-node channel test')
+            for (const r of results) {
+              console.log(r.ok ? `✅ ${r.channel}: test OK` : `❌ ${r.channel}: ${r.error}`)
+            }
+          } else {
+            console.log('Usage:')
+            console.log('  /channel list          — List configured channels')
+            console.log('  /channel send <msg>    — Send message to channels')
+            console.log('  /channel test          — Test channel connectivity')
+          }
+          break
+        }
         case 'exit':
         case 'quit':
           console.log('Goodbye!')
@@ -302,8 +336,14 @@ export async function main() {
       }
     } catch (err) {
       console.error(`\nError: ${err.message}\n`)
+      // 错误也通知
+      if (channelManager.list().length > 0) {
+        await channelManager.sendTemplate('error', {
+          task: input.slice(0, 80),
+          error: err.message.slice(0, 200),
+        }).catch(() => {}) // 通知失败不影响主流程
+      }
     }
-
     rl.prompt()
   })
 

package/src/core/config.js

@@ -27,6 +27,8 @@ const DEFAULTS = {
     fileRead: { maxLines: 2000, maxSizeKB: 256 },
     webFetch: { timeout: 30, maxChars: 100000 },
   },
+    channels: {},
+    defaultChannel: null,
   mcp: {
     servers: {},
   },