@raolin2025/claude-code-node 1.0.1 → 1.2.0

package/README.md

@@ -317,3 +317,115 @@ 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` 命令）
+
+## 🔔 后台运行 (cc-notify)
+
+cc-notify 是独立的通知守护进程，**不需要 cc-node 在前台运行**，开机自启后随时可用。
+
+### 三种运行方式
+
+| 方式 | 命令 | 说明 |
+|------|------|------|
+| **前台** | `cc-notify` | 调试用，Ctrl+C 退出 |
+| **后台守护** | `cc-notify --daemon` | 脱离终端后台运行 |
+| **系统服务** | `systemctl start cc-notify` | 开机自启，最推荐 |
+
+### 手机交互
+
+在 Telegram 上给 Bot 发消息：
+
+```
+你好                     → 当作一次性任务发给 cc-node 执行
+/ping                    → 检查服务是否在线
+/run ls -la              → 执行 shell 命令
+/notify 任务完成！        → 向所有通道广播通知
+/status                  → 查看服务状态
+```
+
+### HTTP API（守护模式可用）
+
+```bash
+# 发送通知
+curl -X POST http://localhost:3456/send \
+  -H 'Content-Type: application/json' \
+  -d '{"text":"构建完成 ✅"}'
+
+# 查看状态
+curl http://localhost:3456/status
+```
+
+### systemd 开机自启
+
+```bash
+# 安装服务
+sudo cp cc-notify.service /etc/systemd/system/
+# 编辑 Token
+sudo vim /etc/systemd/system/cc-notify.service
+# 启用
+sudo systemctl daemon-reload
+sudo systemctl enable cc-notify
+sudo systemctl start cc-notify
+
+# 查看日志
+journalctl -u cc-notify -f
+```

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@raolin2025/claude-code-node",
-  "version": "1.0.1",
-  "description": "Node.js AI Code Agent CLI - Zero dependencies, pure JavaScript, security hardened",
+  "version": "1.2.0",
+  "description": "Node.js AI Code Agent CLI - Zero dependencies, pure JavaScript, security hardened, multi-channel notifications",
   "type": "module",
   "main": "src/index.js",
   "bin": {
-    "cc-node": "src/index.js"
+    "cc-node": "src/index.js",
+    "cc-notify": "src/channel/notify-daemon.js"
   },
   "scripts": {
     "start": "node src/index.js",
@@ -13,7 +14,15 @@
     "test": "node --test src/__tests__/*.js",
     "repl": "node src/index.js"
   },
-  "keywords": ["claude", "code", "agent", "cli", "llm", "ai", "security"],
+  "keywords": [
+    "claude",
+    "code",
+    "agent",
+    "cli",
+    "llm",
+    "ai",
+    "security"
+  ],
   "license": "MIT",
   "author": "bg1avd",
   "repository": {

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/channel/notify-daemon.js

@@ -0,0 +1,491 @@
+#!/usr/bin/env node
+/**
+ * cc-notify — 轻量通知守护进程
+ * 
+ * 独立于 cc-node 运行，常驻后台，提供：
+ *   1. Telegram Bot 长轮询监听（手机发消息 → 处理 → 回复）
+ *   2. HTTP API 接口（其他程序调用发通知）
+ *   3. Webhook 接收器（接收外部事件触发通知）
+ * 
+ * 用法：
+ *   cc-notify                              # 前台运行
+ *   cc-notify --daemon                     # 后台守护进程
+ *   cc-notify --daemon --pidfile /tmp/cc.pid  # 指定 PID 文件
+ *   cc-notify --stop                       # 停止守护进程
+ *   cc-notify --status                     # 查看状态
+ *   
+ *   # HTTP API（守护模式可用）
+ *   curl -X POST http://localhost:3456/send -d '{"text":"hello"}'
+ *   curl http://localhost:3456/status
+ */
+
+import { createServer } from 'http'
+import { readFileSync, writeFileSync, unlinkSync, existsSync, appendFileSync } from 'fs'
+import { resolve, join } from 'path'
+import { homedir } from 'os'
+import { spawn, execSync } from 'child_process'
+
+// ============================================================
+// 配置
+// ============================================================
+
+const DEFAULT_PORT = 3456
+const DEFAULT_PID_FILE = join(homedir(), '.cc-notify.pid')
+const DEFAULT_LOG_FILE = join(homedir(), '.cc-notify.log')
+const POLL_INTERVAL_MS = 3000 // Telegram 长轮询间隔
+
+function loadConfig() {
+  // 1. 环境变量
+  const config = {
+    channels: {},
+    defaultChannel: process.env.CC_NODE_CHANNEL_DEFAULT || null,
+    port: parseInt(process.env.CC_NOTIFY_PORT || '3456', 10),
+    pidFile: process.env.CC_NOTIFY_PID_FILE || DEFAULT_PID_FILE,
+    logFile: process.env.CC_NOTIFY_LOG_FILE || DEFAULT_LOG_FILE,
+    ccNodePath: process.env.CC_NODE_PATH || 'cc-node',
+  }
+
+  // 2. 从 .claude-code/config.json 加载
+  for (const dir of [process.cwd(), homedir()]) {
+    const cfgPath = join(dir, '.claude-code', 'config.json')
+    if (existsSync(cfgPath)) {
+      try {
+        const data = JSON.parse(readFileSync(cfgPath, 'utf8'))
+        if (data.channels) {
+          Object.assign(config.channels, data.channels)
+        }
+        if (data.defaultChannel && !config.defaultChannel) {
+          config.defaultChannel = data.defaultChannel
+        }
+        if (data.notify?.port) config.port = data.notify.port
+        if (data.notify?.ccNodePath) config.ccNodePath = data.notify.ccNodePath
+      } catch {}
+    }
+  }
+
+  // 3. 环境变量覆盖（CC_NODE_CHANNEL_*）
+  for (const [key, value] of Object.entries(process.env)) {
+    if (!key.startsWith('CC_NODE_CHANNEL_')) continue
+    const rest = key.slice('CC_NODE_CHANNEL_'.length)
+    if (rest === 'DEFAULT') continue
+    const parts = rest.split('_')
+    const type = parts[0].toLowerCase()
+    const param = parts.slice(1).join('_').toLowerCase()
+    if (!config.channels[type]) config.channels[type] = { type }
+    const camelKey = param.replace(/_([a-z])/g, (_, c) => c.toUpperCase())
+    config.channels[type][camelKey] = value
+  }
+
+  return config
+}
+
+// ============================================================
+// 通道适配器（复用 cc-node 的逻辑，独立实现避免依赖）
+// ============================================================
+
+async function sendTelegram(config, text) {
+  const url = `https://api.telegram.org/bot${config.token}/sendMessage`
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ chat_id: config.chatId, text, parse_mode: 'Markdown' }),
+  })
+  return res.json()
+}
+
+async function sendWebhook(url, text, parseMode) {
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ text, msgtype: parseMode === 'markdown' ? 'markdown' : 'text' }),
+  })
+  return res.text()
+}
+
+async function sendToChannel(channels, defaultChannel, text) {
+  const targets = defaultChannel ? [defaultChannel] : Object.keys(channels)
+  const results = []
+  for (const name of targets) {
+    const ch = channels[name]
+    if (!ch) { results.push({ channel: name, ok: false, error: 'not configured' }); continue }
+    try {
+      if (ch.type === 'telegram') {
+        const r = await sendTelegram(ch, text)
+        results.push({ channel: name, ok: r.ok || false, result: r })
+      } else if (ch.webhookUrl) {
+        const r = await sendWebhook(ch.webhookUrl, text)
+        results.push({ channel: name, ok: true, result: r })
+      } else {
+        results.push({ channel: name, ok: false, error: 'unknown type' })
+      }
+    } catch (e) {
+      results.push({ channel: name, ok: false, error: e.message })
+    }
+  }
+  return results
+}
+
+// ============================================================
+// Telegram Bot 长轮询（接收手机消息）
+// ============================================================
+
+class TelegramListener {
+  constructor(config) {
+    this.config = config
+    this.lastUpdateId = 0
+    this.running = false
+    this.handlers = []  // 消息处理器
+  }
+
+  onMessage(handler) {
+    this.handlers.push(handler)
+  }
+
+  async start() {
+    const ch = this.config.channels.telegram
+    if (!ch?.token) {
+      log('Telegram listener: no token, skipping')
+      return
+    }
+    this.running = true
+    log('Telegram listener: started (long polling)')
+    this._poll()
+  }
+
+  stop() {
+    this.running = false
+  }
+
+  async _poll() {
+    while (this.running) {
+      try {
+        const url = `https://api.telegram.org/bot${this.config.channels.telegram.token}/getUpdates`
+        const res = await fetch(url, {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({
+            offset: this.lastUpdateId + 1,
+            timeout: 30, // 长轮询超时
+            allowed_updates: ['message'],
+          }),
+        })
+        const data = await res.json()
+
+        if (data.ok && data.result?.length) {
+          for (const update of data.result) {
+            this.lastUpdateId = update.update_id
+            if (update.message?.text) {
+              const msg = {
+                text: update.message.text,
+                chatId: update.message.chat.id,
+                from: update.message.from?.username || update.message.from?.first_name || 'unknown',
+                date: new Date(update.message.date * 1000),
+              }
+              log(`Telegram msg from ${msg.from}: ${msg.text.slice(0, 80)}`)
+              for (const handler of this.handlers) {
+                try { await handler(msg) } catch (e) { log(`Handler error: ${e.message}`) }
+              }
+            }
+          }
+        }
+      } catch (e) {
+        log(`Telegram poll error: ${e.message}`)
+        await sleep(5000) // 出错后等 5 秒重试
+      }
+    }
+  }
+}
+
+// ============================================================
+// HTTP API 服务
+// ============================================================
+
+class HttpServer {
+  constructor(config, channels) {
+    this.config = config
+    this.channels = channels
+    this.server = null
+  }
+
+  start() {
+    this.server = createServer(async (req, res) => {
+      const url = new URL(req.url, `http://localhost:${this.config.port}`)
+
+      // CORS
+      res.setHeader('Access-Control-Allow-Origin', '*')
+      res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS')
+      res.setHeader('Access-Control-Allow-Headers', 'Content-Type')
+      if (req.method === 'OPTIONS') { res.writeHead(204); res.end(); return }
+
+      try {
+        if (req.method === 'GET' && url.pathname === '/status') {
+          res.writeHead(200, { 'Content-Type': 'application/json' })
+          res.end(JSON.stringify({
+            status: 'running',
+            channels: Object.keys(this.channels),
+            defaultChannel: this.config.defaultChannel,
+            uptime: process.uptime(),
+          }))
+        } else if (req.method === 'POST' && url.pathname === '/send') {
+          const body = await readBody(req)
+          const { text, channel, parseMode } = JSON.parse(body)
+          if (!text) {
+            res.writeHead(400, { 'Content-Type': 'application/json' })
+            res.end(JSON.stringify({ error: 'text is required' }))
+            return
+          }
+          const results = await sendToChannel(
+            this.channels,
+            channel || this.config.defaultChannel,
+            text
+          )
+          res.writeHead(200, { 'Content-Type': 'application/json' })
+          res.end(JSON.stringify({ results }))
+        } else {
+          res.writeHead(404, { 'Content-Type': 'application/json' })
+          res.end(JSON.stringify({ error: 'not found' }))
+        }
+      } catch (e) {
+        res.writeHead(500, { 'Content-Type': 'application/json' })
+        res.end(JSON.stringify({ error: e.message }))
+      }
+    })
+
+    this.server.listen(this.config.port, () => {
+      log(`HTTP API listening on http://localhost:${this.config.port}`)
+    })
+  }
+
+  stop() {
+    this.server?.close()
+  }
+}
+
+// ============================================================
+// 消息处理（收到的消息如何处理）
+// ============================================================
+
+async function handleIncomingMessage(msg, config, channels) {
+  const text = msg.text
+
+  // 命令处理
+  if (text.startsWith('/')) {
+    const [cmd, ...args] = text.split(' ')
+    switch (cmd) {
+      case '/start':
+      case '/help':
+        return `🤖 *cc-notify* — AI Code Agent 通知服务\n\nCommands:\n/ping — 检查服务状态\n/run <cmd> — 执行一次性命令\n/notify <text> — 发送通知到所有通道\n/status — 查看状态`
+      case '/ping':
+        return '🏓 pong!'
+      case '/status':
+        return `📊 cc-notify status\nChannels: ${Object.keys(channels).join(', ') || 'none'}\nUptime: ${Math.floor(process.uptime())}s`
+      case '/notify':
+        const notifyText = args.join(' ')
+        if (!notifyText) return 'Usage: /notify <text>'
+        const results = await sendToChannel(channels, config.defaultChannel, notifyText)
+        return results.map(r => r.ok ? `✅ ${r.channel}` : `❌ ${r.channel}: ${r.error}`).join('\n')
+      case '/run':
+        const cmd = args.join(' ')
+        if (!cmd) return 'Usage: /run <command>'
+        return await runOneShot(config.ccNodePath, cmd)
+      default:
+        return `Unknown command: ${cmd}\nType /help for available commands`
+    }
+  }
+
+  // 普通消息 → 当作一次性任务执行
+  return await runOneShot(config.ccNodePath, text)
+}
+
+/** 调用 cc-node 执行一次性命令 */
+function runOneShot(ccNodePath, input) {
+  return new Promise((resolve) => {
+    const timeout = 60000 // 60 秒超时
+    const timer = setTimeout(() => {
+      child.kill()
+      resolve('⏰ 执行超时（60秒）')
+    }, timeout)
+
+    try {
+      const child = spawn(ccNodePath, [], { stdio: ['pipe', 'pipe', 'pipe'] })
+      let stdout = ''
+      let stderr = ''
+      child.stdout.on('data', (d) => { stdout += d.toString() })
+      child.stderr.on('data', (d) => { stderr += d.toString() })
+      child.stdin.write(input + '\n')
+      child.stdin.end()
+      child.on('close', (code) => {
+        clearTimeout(timer)
+        if (code === 0 && stdout.trim()) {
+          resolve(stdout.trim().slice(0, 4000)) // Telegram 消息长度限制
+        } else if (stderr.trim()) {
+          resolve(`❌ Error: ${stderr.trim().slice(0, 1000)}`)
+        } else {
+          resolve(stdout.trim().slice(0, 4000) || '(no output)')
+        }
+      })
+    } catch (e) {
+      clearTimeout(timer)
+      resolve(`❌ Failed to run cc-node: ${e.message}`)
+    }
+  })
+}
+
+// ============================================================
+// 守护进程管理
+// ============================================================
+
+function startDaemon(config) {
+  log('Starting cc-notify daemon...')
+
+  // 检查是否已在运行
+  if (existsSync(config.pidFile)) {
+    const pid = parseInt(readFileSync(config.pidFile, 'utf8').trim(), 10)
+    try {
+      process.kill(pid, 0) // 检查进程是否存活
+      console.error(`cc-notify already running (PID ${pid})`)
+      console.log('Use --stop to stop it first')
+      process.exit(1)
+    } catch {
+      // 进程已死，清理旧 PID 文件
+      unlinkSync(config.pidFile)
+    }
+  }
+
+  // 用子进程启动自己
+  const child = spawn(process.execPath, [import.meta.url], {
+    detached: true,
+    stdio: 'ignore',
+    env: { ...process.env, CC_NOTIFY_DAEMON: '1' },
+  })
+  child.unref()
+  console.log(`cc-notify daemon started (PID ${child.pid})`)
+  console.log(`PID file: ${config.pidFile}`)
+  console.log(`Log file: ${config.logFile}`)
+  console.log(`HTTP API: http://localhost:${config.port}`)
+  process.exit(0)
+}
+
+function stopDaemon(config) {
+  if (!existsSync(config.pidFile)) {
+    console.log('cc-notify is not running')
+    process.exit(0)
+  }
+  const pid = parseInt(readFileSync(config.pidFile, 'utf8').trim(), 10)
+  try {
+    process.kill(pid, 'SIGTERM')
+    console.log(`cc-notify stopped (PID ${pid})`)
+  } catch {
+    console.log(`Process ${pid} not found, cleaning PID file`)
+  }
+  try { unlinkSync(config.pidFile) } catch {}
+  process.exit(0)
+}
+
+function showStatus(config) {
+  if (!existsSync(config.pidFile)) {
+    console.log('cc-notify is not running')
+    process.exit(0)
+  }
+  const pid = parseInt(readFileSync(config.pidFile, 'utf8').trim(), 10)
+  try {
+    process.kill(pid, 0)
+    console.log(`cc-notify running (PID ${pid})`)
+    // 尝试从 HTTP API 获取详细状态
+    fetch(`http://localhost:${config.port}/status`)
+      .then(r => r.json())
+      .then(data => console.log('Status:', JSON.stringify(data, null, 2)))
+      .catch(() => console.log('(HTTP API not responding)'))
+  } catch {
+    console.log(`PID ${pid} is dead, cleaning up`)
+    try { unlinkSync(config.pidFile) } catch {}
+  }
+}
+
+// ============================================================
+// 工具函数
+// ============================================================
+
+function sleep(ms) { return new Promise(r => setTimeout(r, ms)) }
+
+function readBody(req) {
+  return new Promise((resolve) => {
+    let body = ''
+    req.on('data', (d) => { body += d })
+    req.on('end', () => resolve(body))
+  })
+}
+
+function log(msg) {
+  const ts = new Date().toISOString().slice(11, 19)
+  const line = `[${ts}] ${msg}\n`
+  process.stdout.write(line)
+  try {
+    const config = loadConfig()
+    if (config.logFile) {
+      appendFileSync(config.logFile, line)
+    }
+  } catch {}
+}
+
+// ============================================================
+// 主入口
+// ============================================================
+
+async function main() {
+  const config = loadConfig()
+
+  // 解析命令行
+  const args = process.argv.slice(2)
+  const isDaemon = args.includes('--daemon')
+  const isStop = args.includes('--stop')
+  const isStatus = args.includes('--status')
+
+  if (isStop) return stopDaemon(config)
+  if (isStatus) return showStatus(config)
+  if (isDaemon) return startDaemon(config)
+
+  // 写 PID 文件
+  writeFileSync(config.pidFile, String(process.pid))
+
+  // 优雅退出
+  const cleanup = () => {
+    log('Shutting down...')
+    try { unlinkSync(config.pidFile) } catch {}
+    process.exit(0)
+  }
+  process.on('SIGTERM', cleanup)
+  process.on('SIGINT', cleanup)
+
+  log('cc-notify starting...')
+  log(`Channels: ${Object.keys(config.channels).join(', ') || 'none'}`)
+  log(`Default: ${config.defaultChannel || 'none'}`)
+
+  // 启动 Telegram 监听
+  const tgListener = new TelegramListener(config)
+  tgListener.onMessage(async (msg) => {
+    const reply = await handleIncomingMessage(msg, config, config.channels)
+    // 回复到 Telegram
+    if (config.channels.telegram?.token && msg.chatId) {
+      await sendTelegram(
+        { token: config.channels.telegram.token, chatId: msg.chatId },
+        reply
+      )
+    }
+  })
+  await tgListener.start()
+
+  // 启动 HTTP API
+  const httpServer = new HttpServer(config, config.channels)
+  httpServer.start()
+
+  log('cc-notify ready ✅')
+
+  // 保持进程存活
+  setInterval(() => {}, 60000)
+}
+
+main().catch((err) => {
+  console.error('Fatal:', err)
+  process.exit(1)
+})

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: {},
   },