@voko/lite 0.3.1

package/src/channels/email.js

@@ -0,0 +1,35 @@
+/**
+ * Email 渠道元信息
+ */
+module.exports = {
+  name: 'email',
+  displayName: 'Email',
+
+  configFields: [
+    { key: 'ownerEmail', label: '主人邮箱', type: 'text', required: true },
+    { key: 'agentEmail', label: 'Agent 邮箱地址', type: 'text', required: true },
+    { key: 'authCode', label: '授权码', type: 'password', required: true }
+  ],
+
+  // Email 配置表单有说明文字
+  customUI: true,
+
+  handlerClass: '../server/email-handler',
+
+  extractConfig(channel) {
+    return {
+      ownerEmail: channel.config?.ownerEmail,
+      agentEmail: channel.config?.agentEmail,
+      authCode: channel.config?.authCode,
+      smtp: channel.config?.smtp,
+      imap: channel.config?.imap
+    };
+  },
+
+  extraCallbacks: {},
+
+  // Email 没有 CLI 脚本，使用内联测试
+  test: {
+    inlineTest: true
+  }
+};

package/src/channels/feishu.js

@@ -0,0 +1,31 @@
+/**
+ * 飞书渠道元信息
+ */
+module.exports = {
+  name: 'feishu',
+  displayName: '飞书',
+
+  configFields: [
+    { key: 'appId', label: 'App ID', type: 'text', required: true },
+    { key: 'appSecret', label: 'App Secret', type: 'password', required: true },
+    { key: 'ownerOpenId', label: '主人 OpenID', type: 'text' },
+    { key: 'pollInterval', label: '轮询间隔（秒）', type: 'number', min: 1, max: 60 }
+  ],
+
+  handlerClass: '../server/feishu-handler',
+
+  extractConfig(channel) {
+    return {
+      appId: channel.config?.appId || channel.appId,
+      appSecret: channel.config?.appSecret || channel.appSecret,
+      ownerOpenId: channel.config?.ownerOpenId || channel.ownerOpenId,
+      pollInterval: (channel.config?.pollInterval || 5) * 1000
+    };
+  },
+
+  extraCallbacks: {},
+
+  test: {
+    cliScript: 'owner-intervention-cli.js'
+  }
+};

package/src/channels/qq-email.js

@@ -0,0 +1,30 @@
+/**
+ * QQ 邮箱渠道元信息
+ * 复用 email-handler，SMTP/IMAP 固定使用 qq.com
+ */
+module.exports = {
+  name: 'qq-email',
+  displayName: 'QQ邮箱',
+
+  configFields: [
+    { key: 'ownerEmail', label: '主人邮箱', type: 'text', required: true },
+    { key: 'authCode', label: '授权码', type: 'password', required: true }
+  ],
+
+  customUI: true,
+  handlerClass: '../server/email-handler',
+
+  extractConfig(channel) {
+    const email = channel.config?.agentEmail || channel.config?.ownerEmail || '';
+    const authCode = channel.config?.authCode || '';
+    return {
+      ownerEmail: email,
+      agentEmail: email,
+      authCode,
+      smtp: { host: "smtp.qq.com", port: 587, secure: false, auth: { user: email, pass: authCode } },
+      imap: { host: "imap.qq.com", port: 993, secure: true, auth: { user: email, pass: authCode } }
+    };
+  },
+
+  test: { inlineTest: true }
+};

package/src/channels/registry.js

@@ -0,0 +1,279 @@
+/**
+ * 渠道注册表 — 统一管理所有渠道的初始化、回调、运行时访问
+ *
+ * 新增渠道步骤：
+ *   1. 写 handler class 在 src/server/
+ *   2. 写元信息文件在 src/channels/
+ *   3. 在 REGISTERED 数组中注册
+ */
+
+const channels = {};
+const bus = require('../core/lite-bus');
+
+function loadDef(name) {
+  try {
+    return require(`./${CHANNEL_FILES[name] || name}`);
+  } catch (e) {
+    console.error(`[Registry] 加载渠道元信息失败: ${name}`, e.message);
+    return null;
+  }
+}
+
+const CHANNEL_FILES = { feishu: 'feishu', telegram: 'telegram', email: 'email', 'qq-email': 'qq-email', 'voko-email': 'voko-email' };
+const REGISTERED = ['feishu', 'telegram', 'email', 'qq-email', 'voko-email'];
+
+const handlers = {};
+
+/**
+ * 创建统一的 onOwnerReply 回调
+ */
+function createOnOwnerReply(channelName, deps) {
+  const { databaseAPI, openclawHandler, hermesHandler, mainWindow, db } = deps;
+
+  return (intervention, content, replyMessageId) => {
+    const logTag = channelName.charAt(0).toUpperCase() + channelName.slice(1);
+    console.log(`[${logTag}] ================== 主人回复流程 ==================`);
+
+    // 好友申请自动审批：主人回复"同意"时自动加入白名单
+    if (deps.autoApproveWhitelistIfFriendRequest) {
+      deps.autoApproveWhitelistIfFriendRequest(intervention, content);
+    }
+
+    let isTestReply = false;
+    if (intervention.visitorId && intervention.visitorId.startsWith('system_test:')) {
+      const testId = intervention.visitorId.replace('system_test:', '');
+      console.log(`[${logTag}] 收到渠道测试回复, testId:`, testId);
+      isTestReply = true;
+      if (mainWindow && !mainWindow.isDestroyed()) {
+        bus.emit('channels:test-success', {
+          testId: testId,
+          replyContent: content
+        });
+      }
+    }
+
+    const sessionKeyForForward = intervention.sessionKey;
+    const updateResult = databaseAPI.updateOwnerInterventionReply(intervention.id, content, Date.now(), channelName);
+    console.log(`[${logTag}] 数据库更新结果: id=${intervention.id} contentChanged=${updateResult.contentChanged}${isTestReply ? ' (测试消息)' : ''}`);
+
+    if (!isTestReply && updateResult.contentChanged && sessionKeyForForward) {
+      const forwardMsg = deps.buildOwnerReplyPrompt(intervention, content);
+      const doNotify = () => {
+        databaseAPI.markAgentNotified(intervention.id);
+        databaseAPI.updateOwnerInterventionStatus(intervention.id, 'resolved', Date.now());
+      };
+      if (intervention.agentId) {
+        const backendRow = db ? db.prepare('SELECT backend_type FROM agents WHERE agent_id = ?').get(intervention.agentId) : null;
+        const agentBackend = backendRow?.backend_type;
+        if (agentBackend === 'hermes' && hermesHandler?.connected) {
+          const hermesSessionKey = 'hermes:' + intervention.agentId + ':' + intervention.visitorId;
+          hermesHandler.steer(hermesSessionKey, forwardMsg).then(result => {
+            doNotify();
+            const output = result?.output || '';
+            if (output) {
+              const ts = Math.floor(Date.now() / 1000);
+              const msgId = 'steer-' + intervention.agentId + '-' + intervention.visitorId + '-' + Date.now();
+              try {
+                db.prepare("INSERT INTO messages (id, from_uid, to_uid, content, channel_id, channel_type, agent_id, timestamp, is_me, status, message_seq, client_msg_no, no_persist, red_dot, sync_once, content_type) VALUES (?, ?, ?, ?, ?, 1, ?, ?, 1, 'sent', ?, ?, ?, ?, ?, ?)").run(msgId, '', intervention.visitorId, output, intervention.visitorId, intervention.agentId, ts, null, null, 0, 0, 0, 1);
+              } catch (_e) { /* ignore */ }
+              console.log(`[${logTag}] agent 回复已入库, visitorId=${intervention.visitorId}`);
+            }
+          }).catch(err => {
+            console.error(`[${logTag}] 通知 Hermes agent 失败:`, err.message);
+          });
+        } else if (agentBackend === 'openclaw' && openclawHandler?.connected) {
+          openclawHandler.sendToSession(sessionKeyForForward, forwardMsg).then(doNotify).catch(err => {
+            console.error(`[${logTag}] 通知 agent 失败:`, err.message);
+          });
+        } else {
+          console.log(`[${logTag}] -> 后端类型 ${agentBackend} 不支持主动转发，agent 可通过 check_human_replies 自行读取`);
+        }
+      } else {
+        console.log(`[${logTag}] -> 无可用连接，跳过转发`);
+      }
+      console.log(`[${logTag}] -> 已转发主人回复, sessionKey=${sessionKeyForForward}`);
+    } else if (sessionKeyForForward && !updateResult.contentChanged) {
+      console.log(`[${logTag}] -> 回复内容无变化，跳过通知 agent`);
+    } else if (sessionKeyForForward) {
+      console.log(`[${logTag}] -> 无可用连接，跳过转发`);
+    }
+
+    if (mainWindow && !mainWindow.isDestroyed()) {
+      bus.emit('owner-reply', {
+        channelName,
+        visitorId: intervention.visitorId,
+        content,
+        sessionKey: sessionKeyForForward,
+        replyMessageId
+      });
+    }
+
+    console.log(`[${logTag}] ================== 流程结束 ==================`);
+  };
+}
+
+/**
+ * 统一初始化所有已启用的渠道
+ */
+function initializeAllChannels(deps) {
+  const { getEnabledChannel, databaseAPI, openclawHandler, mainWindow } = deps;
+  const result = {};
+
+  for (const name of REGISTERED) {
+    const def = loadDef(name);
+    if (!def) continue;
+
+    const channel = getEnabledChannel(name);
+    if (!channel || !channel.enabled) {
+      console.log(`[${def.displayName}] 渠道未启用或未配置，跳过初始化`);
+      continue;
+    }
+
+    const config = def.extractConfig(channel);
+    const missingField = def.configFields.find(f => f.required && !config[f.key]);
+    if (missingField) {
+      console.log(`[${def.displayName}] 配置不完整（缺少 ${missingField.label}），跳过初始化`);
+      continue;
+    }
+
+    console.log(`[${def.displayName}] 初始化中...`);
+
+    try {
+      const HandlerClass = require(def.handlerClass);
+
+      const callbacks = {
+        onOwnerReply: createOnOwnerReply(name, deps),
+        getInterventionByParentMsgId: (msgId) => databaseAPI.getOwnerInterventionByParentMsgId(msgId),
+        isEnabled: () => {
+          const ch = getEnabledChannel(name);
+          return ch && ch.enabled;
+        }
+      };
+
+      if (name === 'wecom' || name === 'feishu') {
+        callbacks.getLatestPendingIntervention = () => databaseAPI.getLatestPendingIntervention();
+      }
+      if (name === 'email') {
+        callbacks.getPendingByAgentAndVisitor = (agentId, visitorId) => databaseAPI.getPendingByAgentAndVisitor(agentId, visitorId);
+      }
+      if (name === 'wecom') {
+        callbacks.onSessionExpired = () => {
+          console.log('[Wechat] 会话已过期，请重新扫码登录');
+          if (mainWindow && !mainWindow.isDestroyed()) {
+            bus.emit('wechat:session-expired');
+          }
+        };
+      }
+      if (name === 'voko-email') {
+        callbacks.agentEmailApi = deps.agentEmailApi;
+        callbacks.db = deps.db;
+      }
+
+      const handler = new HandlerClass(config, callbacks);
+      result[`${name}Handler`] = handler;
+      handlers[name] = handler;
+
+      // Email 渠道始终启动 IMAP（IDLE + 30秒轮询），无记录时轮询会快速返回
+      {
+        handler.start().then(() => {
+          console.log(`[${def.displayName}] ✅ ${def.displayName} 处理器已启动 at`, new Date().toISOString());
+      }).catch(err => {
+        console.error(`[${def.displayName}] ❌ 启动失败:`, err.message);
+      });
+      }
+
+    } catch (err) {
+      console.error(`[${def.displayName}] ❌ 初始化失败:`, err.message);
+    }
+  }
+
+  return result;
+}
+
+function getChannelDef(name) {
+  return loadDef(name);
+}
+
+function reinitializeChannel(name, deps) {
+  // 停止旧 handler
+  const old = handlers[name];
+  if (old && typeof old.stop === 'function') {
+    old.stop();
+  }
+  delete handlers[name];
+
+  // 只初始化这一个渠道
+  const def = loadDef(name);
+  if (!def) return null;
+
+  const { getEnabledChannel, databaseAPI, openclawHandler, mainWindow } = deps;
+  const channel = getEnabledChannel(name);
+  if (!channel || !channel.enabled) {
+    console.log(`[${def.displayName}] 渠道未启用，跳过`);
+    return null;
+  }
+
+  const config = def.extractConfig(channel);
+  const missingField = def.configFields.find(f => f.required && !config[f.key]);
+  if (missingField) {
+    console.log(`[${def.displayName}] 配置不完整，跳过`);
+    return null;
+  }
+
+  try {
+    const HandlerClass = require(def.handlerClass);
+    const callbacks = {
+      onOwnerReply: createOnOwnerReply(name, deps),
+      getInterventionByParentMsgId: (msgId) => databaseAPI.getOwnerInterventionByParentMsgId(msgId),
+      isEnabled: () => { const ch = getEnabledChannel(name); return ch && ch.enabled; }
+    };
+
+    if (name === 'wecom' || name === 'feishu') {
+      callbacks.getLatestPendingIntervention = () => databaseAPI.getLatestPendingIntervention();
+    }
+    if (name === 'email') {
+      callbacks.getPendingByAgentAndVisitor = (agentId, visitorId) => databaseAPI.getPendingByAgentAndVisitor(agentId, visitorId);
+    }
+    if (name === 'wecom') {
+      callbacks.onSessionExpired = () => {
+        bus.emit('wechat:session-expired');
+      };
+    }
+
+    const handler = new HandlerClass(config, callbacks);
+    handlers[name] = handler;
+
+    handler.start().then(() => {
+      console.log(`[${def.displayName}] ✅ 已启动`);
+    }).catch(err => {
+      console.error(`[${def.displayName}] ❌ 启动失败:`, err.message);
+    });
+
+    return handler;
+  } catch (err) {
+    console.error(`[${def.displayName}] ❌ 初始化失败:`, err.message);
+    return null;
+  }
+}
+
+function getRegisteredNames() {
+  return REGISTERED;
+}
+
+function getHandler(name) {
+  return handlers[name] || null;
+}
+
+function getAllHandlers() {
+  return { ...handlers };
+}
+
+module.exports = {
+  initializeAllChannels,
+  createOnOwnerReply,
+  getChannelDef,
+  getRegisteredNames,
+  getHandler,
+  getAllHandlers,
+  reinitializeChannel
+};

package/src/channels/telegram.js

@@ -0,0 +1,28 @@
+/**
+ * Telegram 渠道元信息
+ */
+module.exports = {
+  name: 'telegram',
+  displayName: 'Telegram',
+
+  configFields: [
+    { key: 'botToken', label: 'Bot Token', type: 'text', required: true },
+    { key: 'ownerChatId', label: 'Owner Chat ID', type: 'text', required: true },
+    { key: 'pollInterval', label: '轮询间隔（秒）', type: 'number', min: 5, max: 60 }
+  ],
+
+  // Telegram 配置表单有「获取 Chat ID」等特殊 UI
+  customUI: true,
+
+  handlerClass: '../server/telegram-handler',
+
+  extractConfig(channel) {
+    return {
+      botToken: channel.config?.botToken || channel.botToken,
+      ownerChatId: channel.config?.ownerChatId || channel.ownerChatId,
+      pollInterval: channel.config?.pollInterval || 10000
+    };
+  },
+
+  extraCallbacks: {}
+};

package/src/channels/voko-email.js

@@ -0,0 +1,7 @@
+module.exports = {
+  name: 'voko-email',
+  displayName: 'VOKO 邮件',
+  configFields: [],
+  handlerClass: '../server/voko-email-handler',
+  extractConfig: (channel) => ({}),
+};

package/src/channels/wechat.js

@@ -0,0 +1,35 @@
+/**
+ * 微信 clawbot 渠道元信息
+ */
+module.exports = {
+  name: 'wecom',
+  displayName: '微信clawbot',
+
+  configFields: [
+    { key: 'botToken', label: 'Bot Token', type: 'text', required: true },
+    { key: 'ownerUserId', label: 'Owner User ID', type: 'text', required: true },
+    { key: 'accountId', label: 'Account ID', type: 'text' },
+    { key: 'baseUrl', label: 'Base URL', type: 'text' },
+    { key: 'pollInterval', label: '轮询间隔（秒）', type: 'number', min: 1, max: 60 }
+  ],
+
+  handlerClass: '../server/wechat-handler',
+
+  extractConfig(channel) {
+    return {
+      baseUrl: channel.config?.baseUrl || 'https://ilinkai.weixin.qq.com',
+      botToken: channel.config?.botToken,
+      ownerUserId: channel.config?.ownerUserId,
+      pollInterval: channel.config?.pollInterval || 35000,
+      pollIntervalMs: channel.config?.pollIntervalMs || 1000
+    };
+  },
+
+  extraCallbacks: {
+    onSessionExpired: null // 由 registry 在初始化时注入
+  },
+
+  test: {
+    cliScript: 'wechat-owner-intervention.js'
+  }
+};

package/src/cli.js

@@ -0,0 +1,120 @@
+/**
+ * Lite CLI 命令实现
+ *
+ * 直接复用 core 模块，不调 HTTP / MCP。
+ */
+
+const { registerCapabilitiesForAgent } = require('./core/register-capabilities');
+const { generateOSSSignature } = require('./server/oss');
+
+/**
+ * voko list — 列出所有 agents
+ */
+function listAgents({ db, databaseAPI, agentManager }) {
+  const rows = db.prepare(`
+    SELECT agent_id, agent_name, backend_type, publish_status, access_mode, owner_email
+    FROM agents ORDER BY created_at DESC
+  `).all();
+
+  if (rows.length === 0) {
+    console.log('暂无 agent');
+    return;
+  }
+
+  console.log('\n=== Agents ===');
+  for (const r of rows) {
+    const status = agentManager?.getStatus(r.agent_id);
+    const imMark = status?.connected ? '●' : '○';
+    console.log(`  ${imMark} ${r.agent_name || r.agent_id} (${r.backend_type}) [${r.publish_status}] ${r.access_mode === 'private' ? '🔒' : ''}`);
+    console.log(`       ID: ${r.agent_id}`);
+    if (r.owner_email) console.log(`       邮箱: ${r.owner_email}`);
+  }
+  console.log('');
+}
+
+/**
+ * voko status — Lite 运行状态
+ */
+function showStatus({ db, databaseAPI, agentManager }) {
+  const dbPath = db.name;
+  const dbSize = require('fs').existsSync(dbPath)
+    ? (require('fs').statSync(dbPath).size / 1024 / 1024).toFixed(1)
+    : '?';
+
+  const agentCount = db.prepare('SELECT COUNT(*) as c FROM agents').get()?.c || 0;
+  const publishedCount = db.prepare("SELECT COUNT(*) as c FROM agents WHERE publish_status = 'published'").get()?.c || 0;
+  const msgCount = db.prepare('SELECT COUNT(*) as c FROM messages').get()?.c || 0;
+  const convCount = db.prepare('SELECT COUNT(*) as c FROM conversations').get()?.c || 0;
+
+  console.log('\n=== VOKO Lite Status ===');
+  console.log(`  版本: ${require('../package.json').version}`);
+  console.log(`  运行时间: ${Math.floor(process.uptime() / 60)} 分钟`);
+  console.log(`  数据库: ${dbPath}`);
+  console.log(`  数据库大小: ${dbSize} MB`);
+  console.log(`  Agents: ${agentCount} (已发布: ${publishedCount})`);
+  console.log(`  消息: ${msgCount}`);
+  console.log(`  会话: ${convCount}`);
+
+  if (agentManager) {
+    console.log(`  Worker 进程: ${agentManager.workers.size}`);
+    for (const [id, entry] of agentManager.workers) {
+      const s = agentManager.getStatus(id);
+      console.log(`    ${s.connected ? '●' : '○'} ${id} (${s.status || 'unknown'})`);
+    }
+  }
+  console.log('');
+}
+
+/**
+ * voko register-capabilities — 为指定 agent 注册能力
+ */
+async function registerCapabilities({ db }, agentId) {
+  if (!agentId) {
+    console.error('需指定 agent_id: voko register-capabilities <agent_id>');
+    return;
+  }
+  console.log(`正在为 ${agentId} 注册能力...`);
+  const result = await registerCapabilitiesForAgent({ db, agentId });
+  if (result.success) {
+    console.log('✅ 能力注册成功');
+  } else {
+    console.error('❌ 能力注册失败:', result.error);
+  }
+}
+
+/**
+ * 检查 npm 最新版本
+ */
+async function checkVersion() {
+  try {
+    const pkg = require('../package.json');
+    const res = await fetch('https://registry.npmjs.org/@voko/lite/latest', { signal: AbortSignal.timeout(5000) });
+    if (!res.ok) return;
+    const { version: latest } = await res.json();
+    if (latest && latest !== pkg.version) {
+      const cmp = pkg.version.localeCompare(latest, undefined, { numeric: true });
+      if (cmp < 0) {
+        console.error(`[VOKO] 新版本 ${latest} 可用（当前 ${pkg.version}），运行 voko update 升级`);
+      }
+    }
+  } catch (_) {}
+}
+
+/**
+ * voko update — 升级到最新版
+ */
+function updateLite() {
+  const pkg = require('../package.json');
+  console.error(`正在升级 @voko/lite（当前 ${pkg.version}）...`);
+  try {
+    const { execSync } = require('child_process');
+    execSync('npm install -g @voko/lite@latest', { stdio: 'inherit', windowsHide: true });
+    console.error('✅ 升级完成，请重启 VOKO');
+    process.exit(0);
+  } catch (e) {
+    console.error('❌ 升级失败:', e.message);
+    process.exit(1);
+  }
+}
+
+module.exports = { listAgents, showStatus, registerCapabilities, checkVersion, updateLite };