@voko/lite 0.3.1

package/src/server/hermes-api-client.js

@@ -0,0 +1,166 @@
+const http = require('http');
+const { EventEmitter } = require('events');
+
+const DEFAULT_HOST = '127.0.0.1';
+const DEFAULT_PORT = 8642;
+const CHAT_TIMEOUT = 120000;
+const PING_TIMEOUT = 5000;
+
+// 从配置的 profiles 映射中查询端口
+function profilePort(profileName, profiles) {
+  const entry = profiles?.[profileName];
+  return entry?.port || DEFAULT_PORT;
+}
+
+class HermesApiClient extends EventEmitter {
+  constructor(options = {}) {
+    super();
+    this.host = options.host || DEFAULT_HOST;
+    this.port = options.port || DEFAULT_PORT;
+    this.apiKey = options.apiKey || '';
+    this.profiles = options.profiles || {};  // { agentId: { port } }
+    this.connected = false;
+    this._destroyed = false;
+    this._healthTimer = null;
+  }
+
+  _agentPort(agentId) {
+    return this.profiles?.[agentId]?.port || this.port;
+  }
+
+  _request(method, path, body, timeoutMs, extraHeaders = {}, connOverrides = {}) {
+    return new Promise((resolve, reject) => {
+      const data = body ? JSON.stringify(body) : null;
+      const options = {
+        hostname: connOverrides.host || this.host,
+        port: connOverrides.port || this.port,
+        path,
+        method,
+        timeout: timeoutMs,
+        headers: {
+          'Content-Type': 'application/json',
+          ...(this.apiKey ? { 'Authorization': `Bearer ${this.apiKey}` } : {}),
+          ...(data ? { 'Content-Length': Buffer.byteLength(data) } : {}),
+          ...extraHeaders
+        }
+      };
+
+      const req = http.request(options, (res) => {
+        let buf = '';
+        res.on('data', (chunk) => { buf += chunk; });
+        res.on('end', () => {
+          if (res.statusCode < 200 || res.statusCode >= 300) {
+            if (res.statusCode === 401) {
+              const keyLog = this.apiKey ? `"${this.apiKey}" (len=${this.apiKey.length})` : '(空，未带 Authorization)';
+              console.warn(`[HermesApiClient] 401 ${method} ${path} port=${options.port} apiKey=${keyLog}`);
+            }
+            reject(new Error(`HTTP ${res.statusCode}: ${buf.substring(0, 200)}`));
+            return;
+          }
+          try {
+            resolve(JSON.parse(buf));
+          } catch (e) {
+            resolve(buf);
+          }
+        });
+      });
+
+      req.on('error', (err) => reject(err));
+      req.on('timeout', () => { req.destroy(); reject(new Error('请求超时')); });
+
+      if (data) req.write(data);
+      req.end();
+    });
+  }
+
+  _sessionKey(agentId, visitorId) {
+    return `hermes:${agentId}:${visitorId}`;
+  }
+
+  /**
+   * 发送聊天消息并等待回复
+   */
+  async chat(agentId, visitorId, message, timeoutMs) {
+    const sessionId = this._sessionKey(agentId, visitorId);
+    const enriched = `[访客 ${visitorId}]: ${message}`;
+    const conn = { port: this._agentPort(agentId) };
+    const keyLog = this.apiKey ? `"${this.apiKey}" (len=${this.apiKey.length})` : '(空)';
+    console.log(`[HermesApiClient] chat agentId=${agentId} port=${conn.port} apiKey=${keyLog}`);
+
+    const resp = await this._request('POST', '/v1/chat/completions', {
+      messages: [{ role: 'user', content: enriched }],
+      model: 'hermes-agent',
+      stream: false
+    }, timeoutMs || CHAT_TIMEOUT, { 'X-Hermes-Session-Id': sessionId }, conn);
+
+    const reply = resp?.choices?.[0]?.message?.content || '';
+    return { reply, runId: resp?.id || '', sessionKey: sessionId };
+  }
+
+  /**
+   * 注入系统消息到会话
+   */
+  async steer(agentId, visitorId, content) {
+    const sessionId = this._sessionKey(agentId, visitorId);
+    const enriched = `[系统消息] ${content}`;
+    const conn = { port: this._agentPort(agentId) };
+
+    const resp = await this._request('POST', '/v1/chat/completions', {
+      messages: [
+        { role: 'system', content: `[Owner Instruction] ${content}` },
+        { role: 'user', content: enriched }
+      ],
+      model: 'hermes-agent',
+      stream: false
+    }, CHAT_TIMEOUT, { 'X-Hermes-Session-Id': sessionId }, conn);
+
+    const output = resp?.choices?.[0]?.message?.content || '';
+    return { accepted: true, output, sessionKey: sessionId };
+  }
+
+  /**
+   * 健康检查
+   */
+  async ping(agentId) {
+    try {
+      const conn = agentId ? { port: this._agentPort(agentId) } : {};
+      await this._request('GET', '/health', null, PING_TIMEOUT, {}, conn);
+      return true;
+    } catch (e) {
+      return false;
+    }
+  }
+
+  /**
+   * 定期健康检查 + 状态发射
+   */
+  startHealthCheck(intervalMs = 30000) {
+    this.stopHealthCheck();
+    const check = async () => {
+      const ok = await this.ping();
+      if (ok !== this.connected) {
+        this.connected = ok;
+        this.emit('status', { connected: ok });
+      }
+    };
+    check().then(() => {
+      if (this.connected) this.emit('ready');
+    });
+    this._healthTimer = setInterval(check, intervalMs);
+  }
+
+  stopHealthCheck() {
+    if (this._healthTimer) {
+      clearInterval(this._healthTimer);
+      this._healthTimer = null;
+    }
+  }
+
+  destroy() {
+    this._destroyed = true;
+    this.stopHealthCheck();
+    this.removeAllListeners();
+  }
+}
+
+module.exports = { HermesApiClient };

package/src/server/hermes-discovery.js

@@ -0,0 +1,80 @@
+const { execSync, spawnSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const { getHermesProfilesDir } = require('../core/hermes-paths');
+
+/**
+ * 发现 Hermes 下的所有 profiles（agents）
+ * 从 demo/discover.js 适配而来
+ * 返回: [{ name, model, isDefault }]
+ */
+function discoverHermes() {
+  const profiles = [];
+
+  // 方案1：解析 hermes profile list 输出（用 spawnSync 避免 Windows cmd.exe 乱码）
+  try {
+    const result = spawnSync('hermes', ['profile', 'list'], {
+      encoding: 'utf-8',
+      timeout: 2000,
+      windowsHide: true,
+      stdio: ['ignore', 'pipe', 'pipe']
+    });
+    if (result.error || result.status !== 0) throw result.error || new Error('non-zero exit');
+    const output = result.stdout;
+    const lines = output.split('\n').filter(l => l.trim());
+
+    let parsing = false;
+    for (const line of lines) {
+      if (line.includes('───')) {
+        parsing = true;
+        continue;
+      }
+      if (!parsing) continue;
+
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+
+      const isDefault = trimmed.startsWith('◆');
+      const clean = trimmed.replace(/^◆\s*/, '');
+      const parts = clean.split(/\s{2,}/).map(s => s.trim());
+
+      if (parts.length >= 1) {
+        profiles.push({
+          name: parts[0],
+          model: parts[1] || 'unknown',
+          isDefault
+        });
+      }
+    }
+  } catch (err) {
+    // hermes CLI 未安装或不在 PATH 中（Windows 系统错误信息为 GBK 编码，
+    // 输出 err.message 会显示乱码），使用固定提示替代
+    console.warn('[HermesDiscover] hermes CLI 未安装或不可用，跳过 discovery');
+  }
+
+  // 方案2：回退读取 profiles 目录
+  if (profiles.length === 0) {
+    const profilesDir = getHermesProfilesDir();
+    try {
+      if (fs.existsSync(profilesDir)) {
+        const dirs = fs.readdirSync(profilesDir);
+        for (const dir of dirs) {
+          const configPath = path.join(profilesDir, dir, 'config.yaml');
+          let model = 'unknown';
+          if (fs.existsSync(configPath)) {
+            const configContent = fs.readFileSync(configPath, 'utf-8');
+            const modelMatch = configContent.match(/default:\s*(\S+)/);
+            if (modelMatch) model = modelMatch[1];
+          }
+          profiles.push({ name: dir, model, isDefault: false });
+        }
+      }
+    } catch (err) {
+      console.warn('[HermesDiscover] 读取 profiles 目录失败:', err.message);
+    }
+  }
+
+  return profiles;
+}
+
+module.exports = { discoverHermes };

package/src/server/hermes-handler.js

@@ -0,0 +1,287 @@
+const { EventEmitter } = require('events');
+const { spawn } = require('child_process');
+const { HermesApiClient } = require('./hermes-api-client');
+
+const DEFAULT_HOST = '127.0.0.1';
+const DEFAULT_PORT = 8642;
+
+/**
+ * Hermes Handler — voko 与 Hermes Agent API Server 之间的适配层
+ *
+ * 职责：
+ *  - 管理 HermesApiClient 生命周期
+ *  - 提供 sendToSession() / steer() 接口给 main.js 调用
+ *  - 转发 agent.reply 事件
+ *
+ * 通过 HTTP 与 hermes-agent 原生 API Server 通信，取代旧版 TCP Bridge。
+ */
+class HermesHandler extends EventEmitter {
+  constructor(database, mainWindow, options = {}) {
+    super();
+    this.db = database;
+    this.mainWindow = mainWindow;
+    this.options = options;
+    this.enabled = false;
+    this.connected = false;
+    this.client = null;
+    this._destroyed = false;
+    this.logs = [];
+    this.maxLogSize = 200;
+  }
+
+  addLog(msg) {
+    const entry = `[${new Date().toLocaleTimeString('zh-CN', { hour12: false })}] ${msg}`;
+    this.logs.push(entry);
+    if (this.logs.length > this.maxLogSize) this.logs.shift();
+    console.log(`[HermesHandler] ${msg}`);
+  }
+
+  /**
+   * 启用/停用 Hermes API 客户端
+   */
+  setEnabled(enabled) {
+    this.enabled = enabled;
+    if (enabled && !this.client) {
+      this.addLog('🚀 Hermes Handler 初始化中...');
+      this._initClient().catch(err => {
+        this.addLog(`❌ 客户端初始化失败: ${err.message}`);
+        this.connected = false;
+        this.emit('status', { connected: false, enabled: true });
+      });
+    } else if (!enabled && this.client) {
+      this.addLog('⏹ Hermes Handler 已停用');
+      this.destroy();
+    }
+  }
+
+  async _initClient() {
+    this.client = new HermesApiClient({
+      host: this.options.host || DEFAULT_HOST,
+      port: this.options.port || DEFAULT_PORT,
+      apiKey: this.options.apiKey || '',
+      profiles: this.options.profiles || {}
+    });
+
+    const profileCount = Object.keys(this.options.profiles || {}).length;
+    this.addLog(`🔌 Hermes API 客户端已创建 (${profileCount} 个 profile)`);
+
+    this.client.on('ready', () => {
+      this.connected = true;
+      this.addLog('✅ Hermes API 客户端已就绪');
+      this.emit('status', { connected: true, enabled: this.enabled });
+    });
+
+    this.client.on('status', ({ connected }) => {
+      this.connected = connected;
+      this.addLog(connected ? '🟢 Gateway 已连接' : '🔴 Gateway 已断开');
+      this.emit('status', { connected, enabled: this.enabled });
+    });
+
+  }
+
+  /**
+   * 健康检查（由外部 60s 定时器驱动）
+   * 逐个检查所有已配置的 agent gateway HTTP 端口，记录可达的 agentId
+   */
+  async healthCheck() {
+    if (!this.client) return;
+    this.connectedAgents = new Set();
+    const profilePorts = Object.keys(this.options.profiles || {});
+    let anyOk = false;
+    if (profilePorts.length > 0) {
+      for (const agentId of profilePorts) {
+        let ok = await this.client.ping(agentId);
+        if (ok) {
+          anyOk = true;
+          this.connectedAgents.add(agentId);
+        }
+      }
+    } else {
+      anyOk = await this.client.ping();
+      if (anyOk) this.connectedAgents = null;
+    }
+    if (anyOk !== this.client.connected) {
+      this.client.connected = anyOk;
+      this.emit('status', { connected: anyOk, enabled: this.enabled });
+    }
+    if (anyOk !== this.connected) {
+      this.connected = anyOk;
+      const agentCount = this.connectedAgents ? this.connectedAgents.size : (anyOk ? 1 : 0);
+      this.addLog(anyOk ? `🟢 健康检查通过 (${agentCount} 个 Agent 在线)` : '🔴 健康检查失败（所有 Gateway 离线）');
+    }
+  }
+
+  /**
+   * 获取状态
+   */
+  getStatus() {
+    return {
+      connected: this.connected,
+      enabled: this.enabled,
+      clientReady: this.client?.connected || false,
+      logs: this.logs.slice()
+    };
+  }
+
+  /**
+   * 确保 Hermes gateway 在运行，如未运行则自动启动
+   */
+  async _ensureGatewayRunning(agentId) {
+    // 检查 API Key 是否已配置
+    if (!this.options?.apiKey) {
+      this.addLog(`❌ API Key 未配置，请先到「设置 → 网关连接管理 → Hermes 连接管理」中点击「一键配置」`);
+      return false;
+    }
+    const port = this.client._agentPort(agentId);
+    // 先检查是否已经在运行
+    const alreadyRunning = await this.client.ping(agentId);
+    if (alreadyRunning) {
+      if (!this.connected) {
+        this.connected = true;
+        this.client.connected = true;
+        this.addLog(`🟢 Gateway 已连接 ${agentId}`);
+        this.emit('status', { connected: true, enabled: this.enabled });
+      }
+      return true;
+    }
+    this.addLog(`🔧 gateway 未运行，启动 profile=${agentId} port=${port}...`);
+    try {
+      const cleanEnv = { ...process.env, HTTPS_PROXY: '', HTTP_PROXY: '' };
+      spawn('hermes', ['--profile', agentId, 'gateway', 'run', '--replace'], {
+        stdio: 'ignore', windowsHide: true, detached: true, env: cleanEnv
+      }).on('error', (err) => {
+        this.addLog(`❌ gateway 进程启动失败 (${agentId}): ${err.message}`);
+      }).unref();
+      // 等待就绪（最多 30s）
+      for (let i = 0; i < 30; i++) {
+        await new Promise(r => setTimeout(r, 1000));
+        const ok = await this.client.ping(agentId);
+        if (ok) {
+          this.connected = true;
+          this.client.connected = true;
+          this.addLog(`✅ gateway 已就绪 ${agentId} port=${port}`);
+          this.emit('status', { connected: true, enabled: this.enabled });
+          return true;
+        }
+      }
+      this.addLog(`❌ gateway 启动超时 ${agentId}`);
+      return false;
+    } catch (e) {
+      this.addLog(`❌ gateway 启动失败 ${agentId}: ${e.message}`);
+      return false;
+    }
+  }
+
+  /**
+   * 发送访客消息到 Hermes agent（走 API Server）
+   * sessionKey 格式: hermes:{agentId}:{visitorId}
+   */
+  async sendToSession(sessionKey, message, extraData = null) {
+    const parts = sessionKey.split(':');
+    if (parts.length < 3 || parts[0] !== 'hermes') {
+      throw new Error(`无效的 Hermes sessionKey: ${sessionKey}`);
+    }
+    const agentId = parts[1];
+    const visitorId = parts.slice(2).join(':');
+
+    this.addLog(`📤 转发消息 ${agentId} (visitor=${visitorId.substring(0, 12)}...)`);
+
+    // 构造结构化 JSON
+    const structuredMsg = JSON.stringify({
+      type: 'message',
+      content: message,
+      fromUid: visitorId,
+      channelId: extraData?.channelId || visitorId,
+      channelType: extraData?.channelType ?? 1,
+      contentType: extraData?.contentType ?? 1,
+      messageId: extraData?.messageId || '',
+      timestamp: extraData?.timestamp || Math.floor(Date.now() / 1000)
+    });
+
+    // 自动启动 gateway
+    const justStarted = !this.connected;
+    await this._ensureGatewayRunning(agentId);
+    if (!this.connected) return;
+
+    try {
+      const result = await this.client.chat(agentId, visitorId, structuredMsg);
+      const replyLen = (result.reply || '').length;
+      const replyPreview = (result.reply || '').substring(0, 120).replace(/\n/g, '\\n');
+      this.addLog(`📥 收到回复 ${agentId} (${replyLen} 字) 内容="${replyPreview}"`);
+      console.log(`[HermesHandler] 完整回复 ${agentId}:`, result.reply);
+      this.emit('agent.reply', {
+        agentId,
+        visitorId,
+        content: result.reply,
+        sessionKey
+      });
+    } catch (err) {
+      // 刚启动的 gateway 可能因 --replace 切换窗口而短暂不可用，等 2s 重试
+      if (justStarted && (err.message?.includes('ECONNRESET') || err.message?.includes('ECONNREFUSED'))) {
+        await new Promise(r => setTimeout(r, 2000));
+        try {
+          const result = await this.client.chat(agentId, visitorId, structuredMsg);
+          const replyLen2 = (result.reply || '').length;
+          const replyPrev2 = (result.reply || '').substring(0, 120).replace(/\n/g, '\\n');
+          this.addLog(`📥 收到回复 ${agentId} (重试, ${replyLen2} 字) 内容="${replyPrev2}"`);
+          console.log(`[HermesHandler] 完整回复(重试) ${agentId}:`, result.reply);
+          this.emit('agent.reply', { agentId, visitorId, content: result.reply, sessionKey });
+          return;
+        } catch (retryErr) {}
+      }
+      this.addLog(`❌ chat 失败 ${agentId}: ${err.message}`);
+    }
+  }
+
+  /**
+   * 注入系统消息到 Hermes agent 会话（走 API Server）
+   * 用于支付通知、主人回复等场景
+   */
+  async steer(sessionKey, content) {
+    const parts = sessionKey.split(':');
+    if (parts.length < 3 || parts[0] !== 'hermes') {
+      throw new Error(`无效的 Hermes sessionKey: ${sessionKey}`);
+    }
+    const agentId = parts[1];
+    const visitorId = parts.slice(2).join(':');
+
+    this.addLog(`📝 注入系统消息 ${agentId}`);
+
+    // 自动启动 gateway
+    const justStarted = !this.connected;
+    await this._ensureGatewayRunning(agentId);
+    if (!this.connected) return;
+
+    try {
+      const result = await this.client.steer(agentId, visitorId, content);
+      this.addLog(`✅ steer 完成 ${agentId} (回复 ${(result.output || '').length} 字)`);
+      return result;
+    } catch (err) {
+      if (justStarted && (err.message?.includes('ECONNRESET') || err.message?.includes('ECONNREFUSED'))) {
+        await new Promise(r => setTimeout(r, 2000));
+        try {
+          const result = await this.client.steer(agentId, visitorId, content);
+          this.addLog(`✅ steer 完成 ${agentId} (重试)`);
+          return result;
+        } catch (retryErr) {}
+      }
+      this.addLog(`❌ steer 失败 ${agentId}: ${err.message}`);
+    }
+  }
+
+  /**
+   * 清理资源
+   */
+  async destroy() {
+    this._destroyed = true;
+    this.enabled = false;
+    this.connected = false;
+    if (this.client) {
+      this.client.destroy();
+      this.client = null;
+    }
+    this.removeAllListeners();
+  }
+}
+
+module.exports = HermesHandler;

package/src/server/openclaw-handler-cli.js

@@ -0,0 +1,131 @@
+const { spawn } = require('child_process');
+
+/**
+ * OpenClaw CLI 消息处理器
+ * 使用 CLI 命令调用 OpenClaw，无需 Gateway HTTP 配置
+ */
+class OpenClawCLIHandler {
+  constructor(database, mainWindow) {
+    this.db = database;
+    this.mainWindow = mainWindow;
+    this.enabled = false;
+    this.processingChannels = new Set();
+    this.agentName = 'main'; // 默认使用 main agent，可改成 voko
+  }
+
+  setEnabled(enabled) {
+    this.enabled = enabled;
+    console.log('[OpenClaw CLI] 自动回复:', enabled ? '已启用' : '已禁用');
+  }
+
+  async onNewMessage(channelId, messageContent) {
+    if (!this.enabled) return;
+    if (this.processingChannels.has(channelId)) return;
+
+    try {
+      this.processingChannels.add(channelId);
+      console.log(`[OpenClaw CLI] 开始处理 - Channel: ${channelId}, Content: ${messageContent?.substring(0, 50)}`);
+
+      // 调用 OpenClaw CLI 生成回复
+      console.log('[OpenClaw CLI] 调用: openclaw run --agent', this.agentName);
+      const reply = await this.callOpenClawCLI(messageContent);
+      console.log(`[OpenClaw CLI] 收到回复: ${reply?.substring(0, 100)}`);
+
+      // 发送回复到 VOKO IM
+      await this.sendReply(channelId, reply);
+      console.log('[OpenClaw CLI] 回复发送成功');
+
+    } catch (err) {
+      console.error('[OpenClaw CLI] 处理失败:', err.message);
+    } finally {
+      this.processingChannels.delete(channelId);
+    }
+  }
+
+  // 调用 OpenClaw CLI 命令
+  callOpenClawCLI(messageContent) {
+    return new Promise((resolve, reject) => {
+      const prompt = `你是 VOKO IM 智能助手。用户发来消息："${messageContent}"
+
+请生成友好、专业的回复（100字以内）。只输出回复内容，不要有任何前缀或解释。`;
+
+      console.log('[OpenClaw CLI] 执行命令...');
+      
+      const child = spawn('openclaw', [
+        'run',
+        '--agent', this.agentName,
+        '--message', prompt
+      ], {
+        timeout: 60000, // 60秒超时
+        windowsHide: true // 隐藏命令行窗口
+      });
+
+      let output = '';
+      let errorOutput = '';
+
+      child.stdout.on('data', (data) => {
+        output += data.toString();
+        console.log('[OpenClaw CLI stdout]:', data.toString().substring(0, 100));
+      });
+
+      child.stderr.on('data', (data) => {
+        errorOutput += data.toString();
+        console.log('[OpenClaw CLI stderr]:', data.toString().substring(0, 100));
+      });
+
+      child.on('close', (code) => {
+        console.log(`[OpenClaw CLI] 进程退出码: ${code}`);
+        if (code === 0) {
+          resolve(output.trim() || '收到你的消息');
+        } else {
+          reject(new Error(`CLI 失败，退出码: ${code}, 错误: ${errorOutput}`));
+        }
+      });
+
+      child.on('error', (err) => {
+        console.error('[OpenClaw CLI] 启动失败:', err.message);
+        if (err.code === 'ENOENT') {
+          reject(new Error('找不到 openclaw 命令，请检查 PATH 或安装 OpenClaw'));
+        } else {
+          reject(err);
+        }
+      });
+    });
+  }
+
+  // 发送回复到 VOKO IM
+  sendReply(channelId, content) {
+    return new Promise((resolve, reject) => {
+      const http = require('http');
+      const postData = JSON.stringify({
+        toUid: channelId,
+        content,
+        channelType: 1
+      });
+
+      const req = http.request({
+        hostname: 'localhost',
+        port: 3002,
+        path: '/api/send-message',
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'Content-Length': Buffer.byteLength(postData)
+        }
+      }, (res) => {
+        let data = '';
+        res.on('data', chunk => data += chunk);
+        res.on('end', () => {
+          console.log(`[OpenClaw Send] 状态: ${res.statusCode}`);
+          resolve(data);
+        });
+      });
+
+      req.on('error', reject);
+      req.write(postData);
+      req.end();
+    });
+  }
+}
+
+module.exports = OpenClawCLIHandler;