@agentunion/kite 1.4.0 → 1.6.0

package/extensions/services/kite_console/static/js/registry-tests.js

@@ -0,0 +1,592 @@
+/**
+ * Kite 注册中心全面测试套件
+ *
+ * 测试覆盖：
+ * 1. 所有模块的 RPC 方法注册
+ * 2. 所有模块的事件发布/订阅注册
+ * 3. 注册中心核心功能
+ * 4. 缓存机制
+ */
+
+// 测试配置
+const TEST_CONFIG = {
+    modules: ['launcher', 'kernel', 'watchdog', 'backup', 'web', 'assistant', 'acp_channel'],
+    timeout: 5000
+};
+
+// 测试结果统计
+const TEST_STATS = {
+    total: 0,
+    passed: 0,
+    failed: 0,
+    skipped: 0
+};
+
+// ============================================================
+// 测试工具函数
+// ============================================================
+
+function logTest(message, type = 'info') {
+    const output = document.getElementById('test-output');
+    if (!output) return;
+
+    const colors = {
+        'info': '#9cdcfe',
+        'pass': '#4ec9b0',
+        'fail': '#f48771',
+        'skip': '#ce9178',
+        'section': '#dcdcaa',
+        'subsection': '#c586c0'
+    };
+
+    const color = colors[type] || colors.info;
+    const prefix = type === 'pass' ? '✓ ' : type === 'fail' ? '✗ ' : type === 'skip' ? '⊘ ' : '';
+
+    // 为测试结果（pass/fail/skip）添加时间戳
+    let timestampPrefix = '';
+    if (type === 'pass' || type === 'fail' || type === 'skip') {
+        const now = new Date();
+        const timestamp = now.toISOString().replace('T', ' ').substring(0, 23); // YYYY-MM-DD HH:MM:SS.mmm
+        timestampPrefix = `[${timestamp}] `;
+    }
+
+    output.innerHTML += `<span style="color:${color}">${timestampPrefix}${prefix}${message}</span>\n`;
+    output.scrollTop = output.scrollHeight;
+}
+
+function assert(condition, message) {
+    TEST_STATS.total++;
+    if (condition) {
+        TEST_STATS.passed++;
+        logTest(message, 'pass');
+        return true;
+    } else {
+        TEST_STATS.failed++;
+        logTest(message, 'fail');
+        return false;
+    }
+}
+
+function skip(message) {
+    TEST_STATS.skipped++;
+    logTest(message, 'skip');
+}
+
+async function testRpcMethod(module, field, methodName) {
+    try {
+        const result = await kernelClient.call('registry.lookup', {
+            field: field,
+            module: module
+        });
+
+        if (result.results && result.results.length > 0) {
+            const value = result.results[0].value;
+            const actualMethod = typeof value === 'string' ? value : value.method;
+            return assert(
+                actualMethod === methodName,
+                `${module}.${methodName}: 注册正确 (${field})`
+            );
+        } else {
+            return assert(false, `${module}.${methodName}: 未找到注册`);
+        }
+    } catch (err) {
+        return assert(false, `${module}.${methodName}: 查询失败 - ${err.message}`);
+    }
+}
+
+async function testEvent(module, eventPath, eventName) {
+    try {
+        const result = await kernelClient.call('registry.lookup', {
+            field: eventPath,
+            module: module
+        });
+
+        return assert(
+            result.results && result.results.length > 0,
+            `${module}: 事件 ${eventName} 已注册`
+        );
+    } catch (err) {
+        return assert(false, `${module}: 事件 ${eventName} 查询失败 - ${err.message}`);
+    }
+}
+
+// ============================================================
+// 主测试入口
+// ============================================================
+
+async function runAllTests() {
+    const output = document.getElementById('test-output');
+    if (!output) return;
+
+    // 重置统计
+    TEST_STATS.total = 0;
+    TEST_STATS.passed = 0;
+    TEST_STATS.failed = 0;
+    TEST_STATS.skipped = 0;
+
+    output.textContent = '';
+    logTest('='.repeat(70), 'info');
+    logTest('Kite 注册中心全面测试套件', 'section');
+    logTest('='.repeat(70), 'info');
+    logTest('', 'info');
+
+    try {
+        // 等待 kernelClient 连接和认证
+        // 使用全局的 app.kernelClient
+        const kernelClient = window.app?.kernelClient;
+
+        if (!kernelClient) {
+            logTest('错误: kernelClient 未初始化', 'fail');
+            logTest('  请确保 evol-app.js 已加载并初始化', 'info');
+            return;
+        }
+
+        if (!kernelClient.connected || !kernelClient.authenticated) {
+            logTest('等待 Kernel 连接和认证...', 'info');
+
+            // 等待最多 10 秒
+            const maxWait = 10000;
+            const startTime = Date.now();
+
+            while ((!kernelClient.connected || !kernelClient.authenticated) && (Date.now() - startTime < maxWait)) {
+                await new Promise(resolve => setTimeout(resolve, 100));
+            }
+
+            if (!kernelClient.connected || !kernelClient.authenticated) {
+                logTest('错误: Kernel 连接或认证超时', 'fail');
+                logTest(`  connected: ${kernelClient.connected}, authenticated: ${kernelClient.authenticated}`, 'info');
+                return;
+            }
+
+            logTest('✓ Kernel 已连接并认证', 'pass');
+            logTest('', 'info');
+        }
+
+        // 将 kernelClient 设置为全局变量，供测试函数使用
+        window.kernelClient = kernelClient;
+
+        // 1. 核心功能测试
+        await testRegistryCore();
+
+        // 2. Launcher 模块测试
+        await testLauncherModule();
+
+        // 3. Kernel 模块测试
+        await testKernelModule();
+
+        // 4. Watchdog 模块测试
+        await testWatchdogModule();
+
+        // 5. Backup 模块测试
+        await testBackupModule();
+
+        // 6. Web 模块测试
+        await testWebModule();
+
+        // 7. Assistant 模块测试 (如果存在)
+        await testAssistantModule();
+
+        // 8. ACP Channel 模块测试 (如果存在)
+        await testAcpChannelModule();
+
+        // 9. 缓存机制测试
+        await testCacheMechanism();
+
+        // 10. 事件订阅测试
+        await testEventSubscription();
+
+        // 总结
+        logTest('', 'info');
+        logTest('='.repeat(70), 'info');
+        logTest('测试完成', 'section');
+        logTest('='.repeat(70), 'info');
+        logTest(`总计: ${TEST_STATS.total} | 通过: ${TEST_STATS.passed} | 失败: ${TEST_STATS.failed} | 跳过: ${TEST_STATS.skipped}`, 'info');
+
+        if (TEST_STATS.failed === 0) {
+            logTest('', 'info');
+            logTest('🎉 所有测试通过！Kite 实例运行正常。', 'pass');
+        } else {
+            logTest('', 'info');
+            logTest(`⚠️  有 ${TEST_STATS.failed} 个测试失败，请检查相关模块。`, 'fail');
+        }
+
+        // 保存日志到服务器
+        logTest('', 'info');
+        logTest('正在保存测试日志到服务器...', 'info');
+        await saveTestLogToServer(output.textContent);
+
+    } catch (err) {
+        logTest('', 'info');
+        logTest(`测试套件执行失败: ${err.message}`, 'fail');
+        console.error(err);
+
+        // 即使失败也保存日志
+        try {
+            await saveTestLogToServer(output.textContent);
+        } catch (saveErr) {
+            console.error('保存日志失败:', saveErr);
+        }
+    }
+}
+
+/**
+ * 保存测试日志到服务器
+ */
+async function saveTestLogToServer(content) {
+    try {
+        const response = await fetch('/api/save_test_log', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({
+                content: content,
+                test_name: 'registry_test'
+            })
+        });
+
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}`);
+        }
+
+        const result = await response.json();
+        logTest(`✓ 日志已保存到服务器: ${result.log_path}`, 'pass');
+        logTest(`  时间: ${result.timestamp}`, 'info');
+
+    } catch (err) {
+        logTest(`✗ 保存日志失败: ${err.message}`, 'fail');
+    }
+}
+
+// ============================================================
+// 1. 注册中心核心功能测试
+// ============================================================
+
+async function testRegistryCore() {
+    logTest('【1】注册中心核心功能测试', 'section');
+    logTest('', 'info');
+
+    // 测试 registry.lookup 基本功能
+    try {
+        const result = await kernelClient.call('registry.lookup', {});
+        assert(
+            result.results && Array.isArray(result.results),
+            'registry.lookup: 返回结果数组'
+        );
+        assert(
+            typeof result.last_update_time === 'number',
+            'registry.lookup: 返回 last_update_time'
+        );
+    } catch (err) {
+        assert(false, `registry.lookup: 基本调用失败 - ${err.message}`);
+    }
+
+    // 测试 registry.get 功能
+    try {
+        const result = await kernelClient.call('registry.get', {
+            path: 'launcher.module_id'
+        });
+        assert(
+            result.value === 'launcher',
+            'registry.get: 精确查询 launcher.module_id'
+        );
+    } catch (err) {
+        assert(false, `registry.get: 查询失败 - ${err.message}`);
+    }
+
+    // 测试 glob 模式匹配
+    try {
+        const result = await kernelClient.call('registry.lookup', {
+            field: 'tools.rpc.module.*'
+        });
+        assert(
+            result.results && result.results.length > 0,
+            'registry.lookup: glob 模式匹配 (tools.rpc.module.*)'
+        );
+    } catch (err) {
+        assert(false, `registry.lookup: glob 匹配失败 - ${err.message}`);
+    }
+
+    logTest('', 'info');
+}
+
+// ============================================================
+// 2. Launcher 模块测试
+// ============================================================
+
+async function testLauncherModule() {
+    logTest('【2】Launcher 模块测试', 'section');
+    logTest('', 'info');
+
+    logTest('RPC 方法注册:', 'subsection');
+    await testRpcMethod('launcher', 'tools.rpc.launcher.start_module', 'start_module');
+    await testRpcMethod('launcher', 'tools.rpc.launcher.stop_module', 'stop_module');
+    await testRpcMethod('launcher', 'tools.rpc.launcher.restart_module', 'restart_module');
+    await testRpcMethod('launcher', 'tools.rpc.launcher.list_modules', 'list_modules');
+    await testRpcMethod('launcher', 'tools.rpc.module.config.get', 'get_module_config');
+    await testRpcMethod('launcher', 'tools.rpc.module.config.update', 'update_module_config');
+    await testRpcMethod('launcher', 'tools.rpc.module.config.reset', 'reset_module_config');
+
+    logTest('', 'info');
+    logTest('事件发布注册:', 'subsection');
+    await testEvent('launcher', 'events_publish.system.ready', 'system.ready');
+    await testEvent('launcher', 'events_publish.module.starting', 'module.starting');
+    await testEvent('launcher', 'events_publish.module.started', 'module.started');
+    await testEvent('launcher', 'events_publish.module.ready', 'module.ready');
+    await testEvent('launcher', 'events_publish.module.stopped', 'module.stopped');
+    await testEvent('launcher', 'events_publish.module.exiting', 'module.exiting');
+    await testEvent('launcher', 'events_publish.module.shutdown', 'module.shutdown');
+
+    logTest('', 'info');
+    logTest('验证已删除的事件:', 'subsection');
+    try {
+        const result = await kernelClient.call('registry.lookup', {
+            field: 'events_publish.module.state_changed',
+            module: 'launcher'
+        });
+        assert(
+            !result.results || result.results.length === 0,
+            'module.state_changed: 已正确删除'
+        );
+    } catch (err) {
+        assert(false, `验证删除失败 - ${err.message}`);
+    }
+
+    logTest('', 'info');
+}
+
+// ============================================================
+// 3. Kernel 模块测试
+// ============================================================
+
+async function testKernelModule() {
+    logTest('【3】Kernel 模块测试', 'section');
+    logTest('', 'info');
+
+    logTest('Kernel 内置 RPC 方法测试:', 'subsection');
+    // Kernel 的方法是内置的，不在注册中心，直接调用测试
+    try {
+        await kernelClient.call('kernel.ping');
+        assert(true, 'kernel.ping: 调用成功');
+    } catch (err) {
+        assert(false, `kernel.ping: 调用失败 - ${err.message}`);
+    }
+
+    try {
+        const stats = await kernelClient.call('kernel.stats');
+        assert(
+            stats && typeof stats.registry === 'object',
+            'kernel.stats: 返回正确的统计数据'
+        );
+    } catch (err) {
+        assert(false, `kernel.stats: 调用失败 - ${err.message}`);
+    }
+
+    try {
+        const health = await kernelClient.call('kernel.health');
+        assert(
+            health && typeof health.status === 'string',
+            'kernel.health: 返回健康状态'
+        );
+    } catch (err) {
+        assert(false, `kernel.health: 调用失败 - ${err.message}`);
+    }
+
+    logTest('', 'info');
+}
+
+// ============================================================
+// 4. Watchdog 模块测试
+// ============================================================
+
+async function testWatchdogModule() {
+    logTest('【4】Watchdog 模块测试', 'section');
+    logTest('', 'info');
+
+    logTest('RPC 方法注册:', 'subsection');
+    await testRpcMethod('watchdog', 'tools.rpc.module.health', 'health');
+    await testRpcMethod('watchdog', 'tools.rpc.module.status', 'status');
+
+    logTest('', 'info');
+    logTest('事件发布注册:', 'subsection');
+    await testEvent('watchdog', 'events_publish.watchdog.module.unhealthy', 'watchdog.module.unhealthy');
+    await testEvent('watchdog', 'events_publish.watchdog.module.recovered', 'watchdog.module.recovered');
+    await testEvent('watchdog', 'events_publish.watchdog.module.resource_critical', 'watchdog.module.resource_critical');
+    await testEvent('watchdog', 'events_publish.watchdog.module.resource_warning', 'watchdog.module.resource_warning');
+    await testEvent('watchdog', 'events_publish.watchdog.module.resource_recovered', 'watchdog.module.resource_recovered');
+    await testEvent('watchdog', 'events_publish.watchdog.alert', 'watchdog.alert');
+
+    logTest('', 'info');
+}
+
+// ============================================================
+// 5. Backup 模块测试
+// ============================================================
+
+async function testBackupModule() {
+    logTest('【5】Backup 模块测试', 'section');
+    logTest('', 'info');
+
+    logTest('RPC 方法注册:', 'subsection');
+    await testRpcMethod('backup', 'tools.rpc.module.health', 'health');
+    await testRpcMethod('backup', 'tools.rpc.module.status', 'status');
+
+    logTest('', 'info');
+    logTest('事件发布注册:', 'subsection');
+    await testEvent('backup', 'events_publish.backup.test', 'backup.test');
+
+    logTest('', 'info');
+}
+
+// ============================================================
+// 6. Web 模块测试
+// ============================================================
+
+async function testWebModule() {
+    logTest('【6】Web 模块测试', 'section');
+    logTest('', 'info');
+
+    logTest('RPC 方法注册:', 'subsection');
+    await testRpcMethod('web', 'tools.rpc.module.health', 'health');
+    await testRpcMethod('web', 'tools.rpc.module.status', 'status');
+    await testRpcMethod('web', 'tools.rpc.web.list_tokens', 'list_tokens');
+    await testRpcMethod('web', 'tools.rpc.web.revoke_token', 'revoke_token');
+
+    logTest('', 'info');
+    logTest('事件发布注册:', 'subsection');
+    await testEvent('web', 'events_publish.web.started', 'web.started');
+    await testEvent('web', 'events_publish.web.test', 'web.test');
+
+    logTest('', 'info');
+}
+
+// ============================================================
+// 7. Assistant 模块测试
+// ============================================================
+
+async function testAssistantModule() {
+    logTest('【7】Assistant 模块测试', 'section');
+    logTest('', 'info');
+
+    // 检查模块是否存在
+    try {
+        const result = await kernelClient.call('registry.lookup', {
+            module: 'assistant'
+        });
+
+        if (!result.results || result.results.length === 0) {
+            skip('Assistant 模块未运行，跳过测试');
+            logTest('', 'info');
+            return;
+        }
+
+        logTest('事件发布注册:', 'subsection');
+        await testEvent('assistant', 'events_publish.assistant.test', 'assistant.test');
+
+    } catch (err) {
+        skip(`Assistant 模块测试失败: ${err.message}`);
+    }
+
+    logTest('', 'info');
+}
+
+// ============================================================
+// 8. ACP Channel 模块测试
+// ============================================================
+
+async function testAcpChannelModule() {
+    logTest('【8】ACP Channel 模块测试', 'section');
+    logTest('', 'info');
+
+    // 检查模块是否存在
+    try {
+        const result = await kernelClient.call('registry.lookup', {
+            module: 'acp_channel'
+        });
+
+        if (!result.results || result.results.length === 0) {
+            skip('ACP Channel 模块未运行，跳过测试');
+            logTest('', 'info');
+            return;
+        }
+
+        logTest('事件发布注册:', 'subsection');
+        await testEvent('acp_channel', 'events_publish.acp_channel.test', 'acp_channel.test');
+
+    } catch (err) {
+        skip(`ACP Channel 模块测试失败: ${err.message}`);
+    }
+
+    logTest('', 'info');
+}
+
+// ============================================================
+// 9. 缓存机制测试
+// ============================================================
+
+async function testCacheMechanism() {
+    logTest('【9】缓存机制测试', 'section');
+    logTest('', 'info');
+
+    try {
+        // 第一次查询
+        const result1 = await kernelClient.call('registry.lookup', {
+            field: 'tools.rpc.module.health'
+        });
+
+        const time1 = result1.last_update_time;
+        assert(typeof time1 === 'number', '缓存: last_update_time 存在');
+
+        // 第二次查询（应该使用缓存）
+        const result2 = await kernelClient.call('registry.lookup', {
+            field: 'tools.rpc.module.health'
+        });
+
+        const time2 = result2.last_update_time;
+        assert(time1 === time2, '缓存: last_update_time 一致（缓存生效）');
+
+        // 检查前端缓存
+        if (typeof _registryCache !== 'undefined') {
+            assert(
+                _registryCache.lastUpdateTime > 0,
+                '前端缓存: lastUpdateTime 已更新'
+            );
+            assert(
+                Object.keys(_registryCache.records).length > 0,
+                '前端缓存: 缓存记录存在'
+            );
+        } else {
+            skip('前端缓存对象未定义');
+        }
+
+    } catch (err) {
+        assert(false, `缓存机制测试失败 - ${err.message}`);
+    }
+
+    logTest('', 'info');
+}
+
+// ============================================================
+// 10. 事件订阅测试
+// ============================================================
+
+async function testEventSubscription() {
+    logTest('【10】事件订阅测试', 'section');
+    logTest('', 'info');
+
+    try {
+        // 测试订阅功能
+        const testEvents = ['module.started', 'module.stopped'];
+        await kernelClient.call('event.subscribe', { events: testEvents });
+        assert(true, '事件订阅: event.subscribe 调用成功');
+
+        // 测试取消订阅
+        await kernelClient.call('event.unsubscribe', { events: ['module.started'] });
+        assert(true, '事件订阅: event.unsubscribe 调用成功');
+
+    } catch (err) {
+        assert(false, `事件订阅测试失败 - ${err.message}`);
+    }
+
+    logTest('', 'info');
+}

package/extensions/services/kite_console/static/js/tests/ARCHITECTURE.md

@@ -0,0 +1,67 @@
+# Evol 前端测试架构重构总结
+
+## 改动概览
+
+将原有的单一注册中心测试重构为模块化的测试中心，支持：
+- 模块测试（单独测试各个模块）
+- 集成测试（测试跨模块流程和机制）
+- 完整测试（运行所有测试并生成报告）
+
+## 文件变更
+
+### 新增文件
+```
+extensions/services/evol/static/js/tests/
+├── test-runner.js                    # 测试运行器核心
+├── index.js                          # 测试入口和调度
+├── README.md                         # 测试架构说明
+├── modules/                          # 模块测试目录
+│   ├── kernel.js
+│   ├── launcher.js
+│   ├── watchdog.js
+│   ├── web.js
+│   └── backup.js
+└── integration/                      # 集成测试目录
+    ├── registry-core.js              # 注册中心核心功能
+    ├── pingpong.js                   # Ping-Pong 机制
+    ├── auth.js                       # 认证机制
+    └── full-workflow.js              # 完整流程
+```
+
+### 修改文件
+- `index.html`：重构测试 UI，添加测试分类 Tab
+- `style.css`：添加测试 Tab 样式
+- `evol-app.js`：重构测试方法，添加报告下载功能
+
+### 保留文件
+- `registry-tests.js`：保留旧测试文件（未删除，但不再使用）
+
+## 测试分类
+
+### 模块测试
+- Kernel：list_modules, get_module_info, ping
+- Launcher：get_processes, ping
+- Watchdog：get_status, ping
+- Web：get_config, ping
+- Backup：get_status, ping
+
+### 集成测试
+- 注册中心核心功能：模块列表、RPC 方法列表、事件列表
+- Ping-Pong 机制：所有模块的 Ping 响应
+- 认证机制：Token 验证
+- 完整流程：启动状态、WebSocket 连接、事件订阅
+
+## 测试报告
+
+完整测试会生成两个日志文件：
+1. `kite-test-full-{timestamp}.log`：完整日志
+2. `kite-test-errors-{timestamp}.log`：错误日志
+
+## 扩展性
+
+新增测试只需：
+1. 创建测试文件
+2. 在 `index.js` 中注册
+3. 在 `index.html` 中引入脚本和添加选项
+
+测试代码完全模块化，易于维护和扩展。