evolclaw 2.2.0 → 2.3.0

package/dist/channels/wechat.js

@@ -3,6 +3,7 @@ import fs from 'fs';
 import path from 'path';
 import { resolvePaths } from '../paths.js';
 import { logger } from '../utils/logger.js';
+import { sanitizeFileName, saveToUploads, safeFetch } from '../utils/media-cache.js';
 const CHANNEL_VERSION = '1.0.0';
 const DEFAULT_LONG_POLL_TIMEOUT_MS = 35_000;
 const DEFAULT_API_TIMEOUT_MS = 15_000;
@@ -61,10 +62,7 @@ async function downloadMedia(cdnMedia, hexKey) {
     if (!cdnMedia.encrypt_query_param)
         throw new Error('No encrypt_query_param');
     const url = `${CDN_BASE_URL}/download?encrypted_query_param=${encodeURIComponent(cdnMedia.encrypt_query_param)}`;
-    const res = await fetch(url);
-    if (!res.ok)
-        throw new Error(`CDN download failed: ${res.status}`);
-    const encrypted = Buffer.from(await res.arrayBuffer());
+    const encrypted = await safeFetch(url);
     if (!aesKeyBase64)
         return encrypted; // 无 key = 明文
     return decryptAesEcb(encrypted, parseAesKey(aesKeyBase64));
@@ -142,6 +140,7 @@ export class WechatChannel {
     // Session expired 状态
     sessionPausedUntil = 0;
     onSessionExpired;
+    eventBus;
     // Project path resolver（用于保存文件到 uploads 目录）
     projectPathResolver;
     constructor(config) {
@@ -158,6 +157,10 @@ export class WechatChannel {
     onSessionExpiredNotify(handler) {
         this.onSessionExpired = handler;
     }
+    /** 注册事件总线（推荐，替代 onSessionExpiredNotify） */
+    setEventBus(bus) {
+        this.eventBus = bus;
+    }
     /** 当前是否处于 session 暂停状态 */
     isSessionPaused() {
         return Date.now() < this.sessionPausedUntil;
@@ -385,9 +388,19 @@ export class WechatChannel {
                         const pauseMin = SESSION_PAUSE_DURATION_MS / 60_000;
                         this.sessionPausedUntil = Date.now() + SESSION_PAUSE_DURATION_MS;
                         logger.error(`[WeChat] Session still expired, pausing for ${pauseMin}min`);
-                        // 通知用户（通过其他渠道）
-                        if (this.onSessionExpired) {
-                            this.onSessionExpired(`⚠️ 微信 token 已过期，通道暂停 ${pauseMin} 分钟后自动重试。\n如需立即恢复，请运行: evolclaw init wechat`);
+                        // 通知用户（通过事件总线或回调）
+                        const authMsg = `⚠️ 微信 token 已过期，通道暂停 ${pauseMin} 分钟后自动重试。\n如需立即恢复，请运行: evolclaw init wechat`;
+                        if (this.eventBus) {
+                            this.eventBus.publish({
+                                type: 'channel:health',
+                                channel: 'wechat',
+                                status: 'auth_error',
+                                message: authMsg,
+                                timestamp: Date.now(),
+                            });
+                        }
+                        else if (this.onSessionExpired) {
+                            this.onSessionExpired(authMsg);
                         }
                         await this.sleep(SESSION_PAUSE_DURATION_MS, signal);
                         if (signal.aborted)
@@ -527,14 +540,14 @@ export class WechatChannel {
                 }
                 else if (item.type === MSG_ITEM_FILE && item.file_item?.media) {
                     const buf = await downloadMedia(item.file_item.media);
-                    const fileName = this.sanitizeFileName(item.file_item.file_name || `file_${Date.now()}`);
-                    const savePath = await this.saveToUploads(buf, fileName, channelId);
+                    const fileName = sanitizeFileName(item.file_item.file_name || `file_${Date.now()}`);
+                    const savePath = await this.saveToUploadsLocal(buf, fileName, channelId);
                     prompts.push(`用户发送了文件：${fileName}\n文件已保存到：${savePath}\n请使用 Read 工具读取并分析文件内容。`);
                 }
                 else if (item.type === MSG_ITEM_VIDEO && item.video_item?.media) {
                     const buf = await downloadMedia(item.video_item.media);
                     const fileName = `video_${Date.now()}.mp4`;
-                    const savePath = await this.saveToUploads(buf, fileName, channelId);
+                    const savePath = await this.saveToUploadsLocal(buf, fileName, channelId);
                     prompts.push(`用户发送了视频：${fileName}\n文件已保存到：${savePath}`);
                 }
             }
@@ -544,19 +557,12 @@ export class WechatChannel {
         }
         return { prompt: prompts.join('\n\n'), images };
     }
-    async saveToUploads(buf, fileName, channelId) {
+    async saveToUploadsLocal(buf, fileName, channelId) {
         const projectPath = this.projectPathResolver
             ? await this.projectPathResolver(channelId)
             : process.cwd();
-        const uploadsDir = path.join(projectPath, '.evolclaw', 'uploads');
-        fs.mkdirSync(uploadsDir, { recursive: true });
-        const savePath = path.join(uploadsDir, fileName);
-        fs.writeFileSync(savePath, buf);
-        return savePath;
-    }
-    /** 清理文件名：移除路径穿越字符，只保留 basename */
-    sanitizeFileName(name) {
-        return path.basename(name).replace(/[<>:"|?*\x00-\x1f]/g, '_') || `file_${Date.now()}`;
+        const { filePath } = saveToUploads(buf, fileName, projectPath);
+        return filePath;
     }
     // ── Media Upload (Outbound) ──────────────────────────────────────────
     async getUploadUrl(params) {
@@ -701,66 +707,84 @@ export class WechatChannel {
         });
     }
 }
+import { normalizeChannelInstances } from '../config.js';
 export class WechatChannelPlugin {
     name = 'wechat';
     isEnabled(config) {
-        return config.channels?.wechat?.enabled === true && !!config.channels?.wechat?.token;
+        const raw = config.channels?.wechat;
+        if (!raw)
+            return false;
+        if (Array.isArray(raw)) {
+            return raw.some(inst => inst.enabled !== false && !!inst.token);
+        }
+        return raw.enabled === true && !!raw.token;
+    }
+    async createChannels(config) {
+        const instances = normalizeChannelInstances(config.channels?.wechat, 'wechat');
+        const result = [];
+        for (const inst of instances) {
+            if (inst.enabled === false || !inst.token)
+                continue;
+            const channel = new WechatChannel({
+                baseUrl: inst.baseUrl || 'https://ilinkai.weixin.qq.com',
+                token: inst.token,
+            });
+            const adapter = {
+                channelName: inst.name,
+                sendText: (id, text) => channel.sendMessage(id, text),
+                sendFile: (id, filePath) => channel.sendFile(id, filePath),
+            };
+            const policy = {
+                canSwitchProject: (chatType, identity) => identity === 'owner',
+                canListProjects: (chatType, identity) => identity === 'owner',
+                canCreateSession: (chatType, identity) => true,
+                canDeleteSession: (chatType, identity) => true,
+                canImportCliSession: (chatType, identity) => identity === 'owner',
+                messagePrefix: (chatType, peerName) => '',
+                showMiddleResult: (chatType, identity) => {
+                    const mode = inst.showActivities ?? config.showActivities ?? 'all';
+                    if (mode === 'none')
+                        return false;
+                    if (mode === 'dm-only')
+                        return chatType === 'private';
+                    if (mode === 'owner-dm-only')
+                        return chatType === 'private' && identity === 'owner';
+                    return true;
+                },
+                showIdleMonitor: (chatType, identity) => {
+                    const mode = inst.showActivities ?? config.showActivities ?? 'all';
+                    if (mode === 'none')
+                        return false;
+                    if (mode === 'dm-only')
+                        return chatType === 'private';
+                    if (mode === 'owner-dm-only')
+                        return chatType === 'private' && identity === 'owner';
+                    return true;
+                },
+                accumulateErrors: (chatType, identity) => true,
+            };
+            const options = {
+                fileMarkerPattern: /\[SEND_FILE:(?:(\w+):)?([^\]]+)\]/g,
+                flushDelay: inst.flushDelay ?? 3, // WeChat 默认 3s
+            };
+            result.push({
+                channelType: 'wechat',
+                adapter,
+                channel,
+                policy,
+                options,
+                connect: () => channel.connect(),
+                disconnect: () => channel.disconnect(),
+                onProjectPathRequest: (channelId) => Promise.resolve(config.projects?.defaultPath || process.cwd()),
+            });
+        }
+        return result;
     }
     async createChannel(config) {
-        const wechatConfig = config.channels?.wechat;
-        if (!wechatConfig?.token) {
+        const instances = await this.createChannels(config);
+        if (instances.length === 0) {
             throw new Error('WeChat config missing');
         }
-        const channel = new WechatChannel({
-            baseUrl: wechatConfig.baseUrl || 'https://ilinkai.weixin.qq.com',
-            token: wechatConfig.token,
-        });
-        const adapter = {
-            name: 'wechat',
-            sendText: (id, text) => channel.sendMessage(id, text),
-            sendFile: (id, filePath) => channel.sendFile(id, filePath),
-        };
-        const policy = {
-            canSwitchProject: (chatType, identity) => identity === 'owner',
-            canListProjects: (chatType, identity) => identity === 'owner',
-            canCreateSession: (chatType, identity) => true,
-            canDeleteSession: (chatType, identity) => true,
-            canImportCliSession: (chatType, identity) => identity === 'owner',
-            messagePrefix: (chatType, peerName) => '',
-            showMiddleResult: (chatType, identity) => {
-                const mode = wechatConfig.showActivities ?? config.showActivities ?? 'all';
-                if (mode === 'none')
-                    return false;
-                if (mode === 'dm-only')
-                    return chatType === 'private';
-                if (mode === 'owner-dm-only')
-                    return chatType === 'private' && identity === 'owner';
-                return true;
-            },
-            showIdleMonitor: (chatType, identity) => {
-                const mode = wechatConfig.showActivities ?? config.showActivities ?? 'all';
-                if (mode === 'none')
-                    return false;
-                if (mode === 'dm-only')
-                    return chatType === 'private';
-                if (mode === 'owner-dm-only')
-                    return chatType === 'private' && identity === 'owner';
-                return true;
-            },
-            accumulateErrors: (chatType, identity) => true,
-        };
-        const options = {
-            fileMarkerPattern: /\[SEND_FILE:(?:(\w+):)?([^\]]+)\]/g,
-            flushDelay: wechatConfig.flushDelay ?? 3, // WeChat 默认 3s
-        };
-        return {
-            adapter,
-            channel,
-            policy,
-            options,
-            connect: () => channel.connect(),
-            disconnect: () => channel.disconnect(),
-            onProjectPathRequest: (channelId) => Promise.resolve(config.projects?.defaultPath || process.cwd()),
-        };
+        return instances[0];
     }
 }

package/dist/cli.js

@@ -6,11 +6,9 @@ import { promisify } from 'util';
 import { resolveRoot, resolvePaths, ensureDataDirs, getPackageRoot } from './paths.js';
 import { loadConfig, validateConfigIntegrity, resolveAnthropicConfig } from './config.js';
 import { migrateProject } from './utils/migrate-project.js';
-import readline from 'readline';
-import { cmdInit, cmdInitAun, checkAunEnvironment } from './utils/init.js';
-import { ipcQuery } from './utils/ipc-client.js';
-import { cmdInitWechat } from './utils/init-wechat.js';
-import { cmdInitFeishu } from './utils/init-feishu.js';
+import { cmdInit } from './utils/init.js';
+import { ipcQuery } from './ipc.js';
+import { cmdInitWechat, cmdInitFeishu, cmdInitAun } from './utils/init-channel.js';
 import * as platform from './utils/cross-platform.js';
 import { EventBus } from './core/event-bus.js';
 // Suppress Node.js ExperimentalWarning (e.g. SQLite) from cluttering CLI output
@@ -200,9 +198,11 @@ async function cmdStart() {
         process.exit(1);
     }
     // 检查是否有残留进程（PID 文件已丢失但进程还在）
+    // 只清理属于当前 EVOLCLAW_HOME 的进程，避免误杀其他实例
     let hasOrphan = false;
     const evolclawMain = path.join(getPackageRoot(), 'dist', 'index.js');
-    const orphanPids = platform.findProcesses(evolclawMain.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
+    const allPids = platform.findProcesses(evolclawMain.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
+    const orphanPids = allPids.filter(pid => platform.getProcessEnv(pid, 'EVOLCLAW_HOME') === p.root);
     if (orphanPids.length > 0) {
         console.log(`⚠ 发现 ${orphanPids.length} 个残留进程，正在清理...`);
         for (const p of orphanPids) {
@@ -231,6 +231,7 @@ async function cmdStart() {
         stdio: ['ignore', out, err],
         env: {
             ...process.env,
+            EVOLCLAW_HOME: p.root,
             LOG_LEVEL: process.env.LOG_LEVEL || 'INFO',
             MESSAGE_LOG: process.env.MESSAGE_LOG || 'true',
             EVENT_LOG: process.env.EVENT_LOG || 'true',
@@ -385,27 +386,37 @@ function formatTimeAgo(ms) {
     return `${day}天前`;
 }
 function showConfigChannels(config) {
-    // Feishu
-    if (config.channels?.feishu?.appId) {
-        console.log(`  feishu: Configured (App ID: ${config.channels.feishu.appId.slice(0, 8)}...)`);
-    }
-    else {
-        console.log('  feishu: - Not configured');
-    }
-    // WeChat
-    if (config.channels?.wechat?.token) {
-        console.log(`  wechat: Configured (Token: ${config.channels.wechat.token.slice(0, 20)}...)`);
-    }
-    else {
-        console.log('  wechat: - Not configured');
+    const groups = [];
+    const channelChecks = [
+        { type: 'feishu', isValid: (inst) => !!inst.appId && inst.enabled !== false },
+        { type: 'wechat', isValid: (inst) => !!inst.token && inst.enabled !== false },
+        { type: 'aun', isValid: (inst) => !!inst.aid && inst.enabled !== false && !inst.aid.includes('your-') && !inst.aid.includes('placeholder') },
+    ];
+    for (const { type, isValid } of channelChecks) {
+        const raw = config.channels?.[type];
+        if (!raw)
+            continue;
+        if (Array.isArray(raw)) {
+            const names = raw.filter(isValid).map((inst) => inst.name || type);
+            if (names.length > 0)
+                groups.push({ type, instances: names });
+        }
+        else if (isValid(raw)) {
+            groups.push({ type, instances: [raw.name || type] });
+        }
     }
-    // AUN
-    const aunAid = config.channels?.aun?.aid;
-    if (aunAid && !aunAid.includes('your-') && !aunAid.includes('placeholder')) {
-        console.log(`  aun: Configured (${aunAid})`);
+    if (groups.length > 0) {
+        for (const g of groups) {
+            if (g.instances.length === 1) {
+                console.log(`  ${g.instances[0]}: ✓ Configured`);
+            }
+            else {
+                console.log(`  ${g.type}: [${g.instances.join(', ')}]`);
+            }
+        }
     }
     else {
-        console.log('  aun: - Not configured');
+        console.log('  (no channels configured)');
     }
 }
 async function cmdStatus() {
@@ -421,8 +432,11 @@ async function cmdStatus() {
                 console.log(`  Uptime: ${info.uptime}`);
             if (info.cpu)
                 console.log(`  CPU: ${info.cpu}%`);
-            if (info.memory)
-                console.log(`  Memory: ${info.memory} KB`);
+            if (info.memory) {
+                const memKB = parseInt(info.memory, 10);
+                const memStr = memKB >= 1024 ? `${(memKB / 1024).toFixed(0)} MB` : `${memKB} KB`;
+                console.log(`  Memory: ${memStr}`);
+            }
         }
         catch { }
         console.log(`  EVOLCLAW_HOME: ${resolveRoot()}`);
@@ -493,13 +507,29 @@ async function cmdStatus() {
             const status = await ipcQuery(p.socket, { type: 'status' });
             if (status) {
                 console.log('🔌 Channels (live):');
+                // Group channels by channelType
+                const groups = new Map();
                 for (const [name, ch] of Object.entries(status.channels)) {
-                    const label = ch.connected
-                        ? '✓ Connected'
-                        : ch.reconnectAttempt
-                            ? `⏳ Reconnecting (${ch.reconnectAttempt}/${ch.maxAttempts})`
-                            : '✗ Disconnected';
-                    console.log(`  ${name}: ${label}`);
+                    const type = ch.channelType || name;
+                    if (!groups.has(type))
+                        groups.set(type, []);
+                    groups.get(type).push({ name, ch: ch });
+                }
+                for (const [type, instances] of groups) {
+                    if (instances.length === 1) {
+                        // Single instance: show instance name directly
+                        const { name, ch } = instances[0];
+                        const label = ch.connected ? '✓ Connected' : ch.reconnectAttempt ? `⏳ Reconnecting (${ch.reconnectAttempt}/${ch.maxAttempts})` : '✗ Disconnected';
+                        console.log(`  ${name}: ${label}`);
+                    }
+                    else {
+                        // Multi-instance: feishu [name1 ✓, name2 ✗]
+                        const parts = instances.map(({ name, ch }) => {
+                            const icon = ch.connected ? '✓' : ch.reconnectAttempt ? '⏳' : '✗';
+                            return `${name} ${icon}`;
+                        });
+                        console.log(`  ${type}: [${parts.join(', ')}]`);
+                    }
                 }
                 if (status.stats) {
                     console.log('');
@@ -530,9 +560,9 @@ async function cmdStatus() {
         const sizeMB = (stat.size / 1024 / 1024).toFixed(1);
         console.log(`  Main log: ${mainLog} (${sizeMB} MB)`);
         console.log('');
-        console.log('📝 Recent activity (last 10 lines):');
+        console.log('📝 Recent activity (last 30 lines):');
         const content = fs.readFileSync(mainLog, 'utf-8').trim().split('\n');
-        console.log(content.slice(-10).map(l => `  ${l}`).join('\n'));
+        console.log(content.slice(-30).map(l => `  ${l}`).join('\n'));
     }
     else {
         console.log('  (no log file yet)');
@@ -617,6 +647,13 @@ async function cmdRestartMonitor() {
         // 通知由新进程自行发送（channel-agnostic），此处不再调用 notifyChannel
         process.exit(0);
     }
+    // 启动失败 — 测试环境下跳过 self-heal（避免 claude -p 污染会话列表、误杀生产进程）
+    if (p.root.startsWith('/tmp/') || process.env.EVOLCLAW_TEST === '1') {
+        log('❌ Service failed to start (test environment detected, skipping self-heal)');
+        await notifyChannel(p, pendingInfo, '❌ 服务启动失败（测试环境，已跳过自动修复）', log);
+        cleanupPendingFile(pendingFile, log);
+        process.exit(1);
+    }
     // 启动失败，进入 self-heal 循环
     log('❌ Service failed to start, entering self-heal loop');
     eventBus.publish({ type: 'self-heal:started', reason: 'Service failed to start after restart' });
@@ -719,7 +756,13 @@ async function spawnAndWaitReady(p, log, timeout) {
         fs.unlinkSync(p.readySignal);
     }
     catch { }
-    // 杀掉可能残留的进程
+    // 杀掉可能残留的进程（先读 PID 再删文件，避免数据库锁）
+    try {
+        const stalePid = parseInt(fs.readFileSync(p.pid, 'utf-8').trim(), 10);
+        if (!isNaN(stalePid))
+            platform.killProcess(stalePid, true);
+    }
+    catch { }
     try {
         fs.unlinkSync(p.pid);
     }
@@ -734,6 +777,7 @@ async function spawnAndWaitReady(p, log, timeout) {
         stdio: ['ignore', out, err],
         env: {
             ...process.env,
+            EVOLCLAW_HOME: p.root,
             LOG_LEVEL: process.env.LOG_LEVEL || 'INFO',
             MESSAGE_LOG: process.env.MESSAGE_LOG || 'true',
             EVENT_LOG: process.env.EVENT_LOG || 'true',
@@ -813,6 +857,7 @@ async function invokeClaude(p, attempt, maxAttempts, timeout, log) {
             '-p', prompt,
             '--allowedTools', 'Read,Write,Edit,Bash,Glob,Grep',
             '--output-format', 'text',
+            '--no-session-persistence',
         ], {
             cwd: projectDir,
             timeout,
@@ -854,6 +899,28 @@ function archiveSelfHealLog(p, log) {
     fs.renameSync(p.selfHealLog, archivePath);
     log(`Archived self-heal log to ${archivePath}`);
 }
+/**
+ * Resolve a channel instance name to its type and config object.
+ * Searches across all channel types (feishu, wechat, aun) for a matching instance.
+ */
+function resolveInstanceConfig(config, instanceName) {
+    for (const type of ['feishu', 'wechat', 'aun']) {
+        const raw = config.channels?.[type];
+        if (!raw)
+            continue;
+        if (Array.isArray(raw)) {
+            const inst = raw.find((i) => i.name === instanceName);
+            if (inst)
+                return { type, config: inst };
+        }
+        else {
+            const name = raw.name || type;
+            if (name === instanceName)
+                return { type, config: raw };
+        }
+    }
+    return null;
+}
 /**
  * 通过对应渠道 API 发送通知（轻量级，不依赖 Channel 实例）
  * 支持 feishu / wechat，根据 pendingInfo.channel 路由
@@ -865,14 +932,20 @@ async function notifyChannel(p, pendingInfo, message, log) {
     if (!fs.existsSync(configPath))
         return;
     const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-    if (pendingInfo.channel === 'feishu') {
+    const resolved = resolveInstanceConfig(config, pendingInfo.channel);
+    if (!resolved) {
+        log(`Channel instance "${pendingInfo.channel}" not found in config`);
+        return;
+    }
+    if (resolved.type === 'feishu') {
         try {
-            if (!config.channels?.feishu?.appId || !config.channels?.feishu?.appSecret)
+            const inst = resolved.config;
+            if (!inst.appId || !inst.appSecret)
                 return;
             const lark = await import('@larksuiteoapi/node-sdk');
             const client = new lark.Client({
-                appId: config.channels.feishu.appId,
-                appSecret: config.channels.feishu.appSecret,
+                appId: inst.appId,
+                appSecret: inst.appSecret,
             });
             if (pendingInfo.rootId) {
                 await client.im.message.reply({
@@ -900,13 +973,14 @@ async function notifyChannel(p, pendingInfo, message, log) {
             log(`Feishu notification failed: ${error.message?.slice(0, 200) || error}`);
         }
     }
-    else if (pendingInfo.channel === 'wechat') {
+    else if (resolved.type === 'wechat') {
         try {
-            if (!config.channels?.wechat?.token)
+            const inst = resolved.config;
+            if (!inst.token)
                 return;
             const crypto = await import('node:crypto');
-            const baseUrl = (config.channels.wechat.baseUrl || 'https://ilinkai.weixin.qq.com').replace(/\/$/, '');
-            const token = config.channels.wechat.token;
+            const baseUrl = (inst.baseUrl || 'https://ilinkai.weixin.qq.com').replace(/\/$/, '');
+            const token = inst.token;
             // 读取缓存的 context_token
             const syncBufPath = path.join(p.dataDir, 'wechat-context-tokens.json');
             let contextToken;
@@ -1030,7 +1104,7 @@ async function cmdDiagnose() {
     }
     // 4. 检查数据库
     try {
-        const { SessionManager } = await import('./core/session-manager.js');
+        const { SessionManager } = await import('./core/session/session-manager.js');
         const eventBus = new EventBus();
         new SessionManager(p.db, eventBus);
         console.log(`[diagnose] ✓ 数据库初始化成功: ${p.db}`);
@@ -1071,20 +1145,28 @@ async function cmdDiagnose() {
 }
 async function cmdTui() {
     const config = loadConfig();
-    const aun = config.channels?.aun;
+    // Find the first AUN instance (TUI connects to one AUN instance)
+    const aunResolved = resolveInstanceConfig(config, 'aun');
+    const aun = aunResolved?.type === 'aun' ? aunResolved.config : null;
     if (!aun?.owner || !aun?.aid) {
         console.error('[tui] AUN 未配置，请先运行: evolclaw init aun');
         process.exit(1);
     }
-    // Check Python + aun_core, interactive install if missing
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    const ready = await checkAunEnvironment(rl);
-    rl.close();
-    if (!ready) {
+    // TUI requires Python + aun_core (independent of init aun which is now pure TS)
+    const pythonCheck = aun.pythonBin || process.env.AUN_PYTHON || 'python3';
+    if (!platform.commandExists(pythonCheck)) {
+        console.error(`[tui] Python 未找到 (${pythonCheck})`);
+        console.error('  → TUI 依赖 Python 和 aun-core: pip3 install aun-core');
         process.exit(1);
     }
     const pythonBin = aun.pythonBin || process.env.AUN_PYTHON || 'python3';
     const cliScript = path.join(getPackageRoot(), 'aun', 'aun_cli.py');
+    if (!fs.existsSync(cliScript)) {
+        console.error(`[tui] aun_cli.py 不存在: ${cliScript}`);
+        console.error('  → TUI 需要 AUN CLI 工具，请确认源码目录包含 aun/aun_cli.py');
+        console.error('  → 安装: pip3 install aun-core && 从源码仓库获取 aun_cli.py');
+        process.exit(1);
+    }
     const child = spawn(pythonBin, [cliScript, '-a', aun.owner, '-t', aun.aid], { stdio: 'inherit' });
     child.on('exit', (code) => process.exit(code ?? 0));
 }