evolclaw 2.0.3 → 2.0.5

package/dist/core/message-processor.js

@@ -109,7 +109,7 @@ export class MessageProcessor {
         });
         try {
             await Promise.race([
-                this._processMessageInternal(message, resetTimer),
+                this._processMessageInternal(message, resetTimer, isGroup),
                 timeoutPromise
             ]);
         }
@@ -172,7 +172,7 @@ export class MessageProcessor {
             await adapter.sendText(channelId, `⚠️ 检测到异常（${consecutiveErrors}/${safeModeThreshold}）\n\n如果问题持续，系统将自动进入安全模式。建议使用 /status 查看状态。`);
         }
     }
-    async _processMessageInternal(message, resetTimer) {
+    async _processMessageInternal(message, resetTimer, isGroup) {
         const messageId = `${message.channel}_${message.channelId}_${message.timestamp || Date.now()}`;
         const channelInfo = this.channels.get(message.channel);
         if (!channelInfo) {
@@ -215,6 +215,7 @@ export class MessageProcessor {
             // 创建 StreamFlusher，传入文件标记模式用于自动过滤
             // 使用动态判断，确保切换项目后不会继续输出
             let firstReply = true;
+            const messageIsGroup = isGroup; // 捕获 isGroup 供闭包使用
             const flusher = new StreamFlusher(async (text, isFinal) => {
                 // 动态判断是否是后台任务
                 const currentActiveSession = await this.sessionManager.getActiveSession(message.channel, message.channelId);
@@ -537,6 +538,9 @@ export class MessageProcessor {
         // 纯标点/特殊字符（非路径字符）
         if (/^[.\s…]+$/.test(filePath))
             return true;
+        // 含正则/代码特殊字符（Agent 在说明中引用了代码或正则表达式）
+        if (/[\\[\]{}*+?|^$]/.test(filePath))
+            return true;
         return false;
     }
 }

package/dist/core/session-manager.js

@@ -2,6 +2,7 @@ import { DatabaseSync } from 'node:sqlite';
 import { ensureDir } from '../config.js';
 import { resolvePaths } from '../paths.js';
 import { logger } from '../utils/logger.js';
+import { encodePath } from '../utils/platform.js';
 import path from 'path';
 import fs from 'fs';
 import os from 'os';
@@ -16,7 +17,7 @@ export class SessionManager {
         return this.db;
     }
     getProjectDirName(projectPath) {
-        return projectPath.replace(/\//g, '-');
+        return encodePath(projectPath);
     }
     getSessionFilePath(projectPath, sessionId) {
         const homeDir = os.homedir();
@@ -61,13 +62,13 @@ export class SessionManager {
     }
     extractUserMessageText(messageContent) {
         if (typeof messageContent === 'string') {
-            const text = messageContent.trim();
+            const text = messageContent.trim().replace(/\s+/g, ' ');
             return text.substring(0, 50) + (text.length > 50 ? '...' : '');
         }
         else if (Array.isArray(messageContent)) {
             const textContent = messageContent.find((c) => c.type === 'text');
             if (textContent?.text) {
-                const text = textContent.text.trim();
+                const text = textContent.text.trim().replace(/\s+/g, ' ');
                 return text.substring(0, 50) + (text.length > 50 ? '...' : '');
             }
         }

package/dist/index.js

@@ -89,6 +89,9 @@ async function main() {
                 const fileMatches = [...text.matchAll(fileMarkerPattern)];
                 for (const match of fileMatches) {
                     const filePath = match[1].trim();
+                    // 跳过占位符/代码片段中的伪路径
+                    if (!filePath || /[\\[\]{}*+?|^$]/.test(filePath))
+                        continue;
                     const session = await sessionManager.getActiveSession(channel, channelId);
                     const projectPath = session?.projectPath || process.cwd();
                     const absoluteFilePath = path.isAbsolute(filePath) ? filePath : path.join(projectPath, filePath);
@@ -132,7 +135,7 @@ async function main() {
             isGroupChat: (channelId) => feishu.getChatMode(channelId).then(m => m === 'group'),
         };
         const feishuOptions = {
-            systemPromptAppend: '[重要系统功能] 你可以通过飞书发送文件给用户。方法：在响应中使用 [SEND_FILE:文件路径] 标记。示例：文件已准备好！[SEND_FILE:/path/to/file.txt] 系统会自动上传并发送。',
+            systemPromptAppend: '[重要系统功能] 你可以通过飞书发送文件给用户。方法：在响应中使用 [SEND_FILE:文件路径] 标记。示例：文件已准备好！[SEND_FILE:./report.txt] 路径支持相对路径（相对项目目录）或绝对路径。系统会自动上传并发送。',
             fileMarkerPattern: /\[SEND_FILE:([^\]]+)\]/g,
             supportsImages: true,
         };
@@ -155,11 +158,23 @@ async function main() {
             baseUrl: config.channels.wechat.baseUrl || 'https://ilinkai.weixin.qq.com',
             token: config.channels.wechat.token,
         });
+        // 设置项目路径提供器（用于接收文件保存）
+        wechat.onProjectPathRequest(async (channelId) => {
+            const session = await sessionManager.getOrCreateSession('wechat', channelId, config.projects?.defaultPath || process.cwd());
+            return path.isAbsolute(session.projectPath)
+                ? session.projectPath
+                : path.resolve(process.cwd(), session.projectPath);
+        });
         const wechatAdapter = {
             name: 'wechat',
             sendText: (channelId, text) => wechat.sendMessage(channelId, text),
+            sendFile: (channelId, filePath) => wechat.sendFile(channelId, filePath),
         };
-        processor.registerChannel(wechatAdapter);
+        const wechatOptions = {
+            systemPromptAppend: '[系统功能] 你可以发送文件给用户。方法：在响应中使用 [SEND_FILE:文件路径] 标记。示例：文件已准备好！[SEND_FILE:./report.txt]',
+            fileMarkerPattern: /\[SEND_FILE:([^\]]+)\]/g,
+        };
+        processor.registerChannel(wechatAdapter, wechatOptions);
         cmdHandler.registerAdapter(wechatAdapter);
         // Session 过期通知（通过 Feishu 等其他渠道告知用户）
         wechat.onSessionExpiredNotify(async (message) => {
@@ -177,7 +192,7 @@ async function main() {
                 logger.warn(`[WeChat] ${message}`);
             }
         });
-        wechat.onMessage(async (channelId, content, userId) => {
+        wechat.onMessage(async (channelId, content, userId, images) => {
             content = content.trim();
             // 首次交互自动绑定主人
             if (userId && !config.channels?.wechat?.owner) {
@@ -203,12 +218,12 @@ async function main() {
             // 获取当前项目路径
             const session = await sessionManager.getOrCreateSession('wechat', channelId, config.projects?.defaultPath || process.cwd());
             // 普通消息进入队列
-            await messageQueue.enqueue(`wechat-${channelId}`, { channel: 'wechat', channelId, content, timestamp: Date.now(), userId }, session.projectPath);
+            await messageQueue.enqueue(`wechat-${channelId}`, { channel: 'wechat', channelId, content, images, timestamp: Date.now(), userId }, session.projectPath);
         });
     }
     // Feishu 消息处理
     if (feishu) {
-        feishu.onMessage(async (chatId, content, images, userId, userName, messageId) => {
+        feishu.onMessage(async (chatId, content, images, userId, userName, messageId, mentions) => {
             content = content.trim();
             // 首次交互自动绑定主人
             if (userId && !config.channels?.feishu?.owner) {
@@ -239,7 +254,7 @@ async function main() {
                 content = `[${userName}] ${content}`;
             }
             // 普通消息进入队列
-            await messageQueue.enqueue(`feishu-${chatId}`, { channel: 'feishu', channelId: chatId, content, images, timestamp: Date.now(), userId, userName, messageId, isGroup: chatMode === 'group' }, session.projectPath);
+            await messageQueue.enqueue(`feishu-${chatId}`, { channel: 'feishu', channelId: chatId, content, images, timestamp: Date.now(), userId, userName, messageId, isGroup: chatMode === 'group', mentions }, session.projectPath);
         });
     }
     // AUN 消息处理
@@ -269,13 +284,21 @@ async function main() {
     // 连接渠道
     const channels = [];
     const channelInstances = [
-        ...(feishu ? [{ name: 'Feishu', instance: feishu }] : []),
+        ...(feishu ? [{ name: 'Feishu', instance: feishu, timeout: 5000 }] : []),
         ...(aun ? [{ name: 'AUN', instance: aun }] : []),
         ...(wechat ? [{ name: 'WeChat', instance: wechat }] : []),
     ];
-    for (const { name, instance } of channelInstances) {
+    for (const { name, instance, timeout } of channelInstances) {
         try {
-            await instance.connect();
+            if (timeout) {
+                await Promise.race([
+                    instance.connect(),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error('Connection timeout')), timeout))
+                ]);
+            }
+            else {
+                await instance.connect();
+            }
             logger.info(`✓ ${name} connected`);
             channels.push(name);
         }

package/dist/paths.js

@@ -41,5 +41,7 @@ export function ensureDataDirs() {
     fs.mkdirSync(p.logs, { recursive: true });
 }
 export function getPackageRoot() {
-    return path.resolve(new URL('.', import.meta.url).pathname, '..');
+    // import.meta.dirname is available in Node.js 21.2+ and always returns
+    // the correct OS-native path, regardless of Git Bash or MSYS2 environment.
+    return path.resolve(import.meta.dirname, '..');
 }

package/dist/utils/init.js

@@ -7,6 +7,7 @@ import { execFileSync } from 'child_process';
 import { promisify } from 'util';
 import { execFile } from 'child_process';
 import { resolveRoot, resolvePaths, ensureDataDirs, getPackageRoot } from '../paths.js';
+import { isWindows, commandExists } from './platform.js';
 const execFileAsync = promisify(execFile);
 // ==================== Helpers ====================
 function ask(rl, question) {
@@ -18,6 +19,9 @@ async function npmInstallGlobal(pkg) {
     }
     catch (e) {
         if (e.stderr?.includes('EACCES') || e.message?.includes('EACCES')) {
+            if (isWindows) {
+                throw new Error('权限不足。请以管理员身份运行 PowerShell 或 CMD，然后重试');
+            }
             await execFileAsync('sudo', ['npm', 'install', '-g', pkg], { timeout: 120000 });
         }
         else {
@@ -38,6 +42,9 @@ async function sudoExec(cmd, args) {
     }
     catch (e) {
         if (e.stderr?.includes('EACCES') || e.message?.includes('EACCES') || e.code === 'EACCES') {
+            if (isWindows) {
+                throw new Error('权限不足。请以管理员身份运行 PowerShell 或 CMD，然后重试');
+            }
             await execFileAsync('sudo', [cmd, ...args], { timeout: 120000, env });
         }
         else {
@@ -57,15 +64,15 @@ async function checkEnvironment(rl) {
         console.log(`  ✗ Node.js v${process.versions.node} — 需要 >= 22（node:sqlite 依赖）`);
         // 检测 nvm
         // 检测 bash 是否存在（nvm 和 n 都依赖 bash）
-        let hasBash = false;
-        try {
-            execFileSync('which', ['bash'], { encoding: 'utf-8' });
-            hasBash = true;
-        }
-        catch { }
+        const hasBash = commandExists('bash');
         if (!hasBash) {
-            console.log('  ⚠ 当前环境没有 bash（Alpine 容器？），无法自动升级 Node.js');
-            console.log('  → 请手动升级: apk add nodejs-current 或重建容器使用 node:22-alpine');
+            if (isWindows) {
+                console.log('  ⚠ Windows 环境，请从 https://nodejs.org 下载安装 Node.js 22+');
+            }
+            else {
+                console.log('  ⚠ 当前环境没有 bash（Alpine 容器？），无法自动升级 Node.js');
+                console.log('  → 请手动升级: apk add nodejs-current 或重建容器使用 node:22-alpine');
+            }
             return false;
         }
         const hasNvm = !!process.env.NVM_DIR && fs.existsSync(process.env.NVM_DIR);
@@ -91,12 +98,7 @@ async function checkEnvironment(rl) {
         }
         else {
             // 检测 n
-            let hasN = false;
-            try {
-                execFileSync('which', ['n'], { encoding: 'utf-8' });
-                hasN = true;
-            }
-            catch { }
+            const hasN = commandExists('n');
             if (hasN) {
                 const answer = (await ask(rl, '  → 是否通过 n 升级到 Node.js 22？[Y/n] ')).trim().toLowerCase();
                 if (answer === 'n' || answer === 'no') {
@@ -138,48 +140,49 @@ async function checkEnvironment(rl) {
     }
     // claude CLI >= 2.1.32
     const MIN_CLAUDE_VER = [2, 1, 32];
-    let claudeInstalled = false;
-    try {
-        execFileSync('which', ['claude'], { encoding: 'utf-8' });
-        claudeInstalled = true;
-        const verOutput = execFileSync('claude', ['--version'], { encoding: 'utf-8' }).trim();
-        const verMatch = verOutput.match(/^(\d+\.\d+\.\d+)/);
-        if (verMatch) {
-            const parts = verMatch[1].split('.').map(Number);
-            const isOk = parts[0] > MIN_CLAUDE_VER[0]
-                || (parts[0] === MIN_CLAUDE_VER[0] && parts[1] > MIN_CLAUDE_VER[1])
-                || (parts[0] === MIN_CLAUDE_VER[0] && parts[1] === MIN_CLAUDE_VER[1] && parts[2] >= MIN_CLAUDE_VER[2]);
-            if (isOk) {
-                console.log(`  ✓ claude CLI v${verMatch[1]}`);
-            }
-            else {
-                console.log(`  ✗ claude CLI v${verMatch[1]} — 需要 >= ${MIN_CLAUDE_VER.join('.')}`);
-                const answer = (await ask(rl, '  → 是否升级 claude CLI？[Y/n] ')).trim().toLowerCase();
-                if (answer === 'n' || answer === 'no') {
-                    console.log('  已取消');
-                    return false;
-                }
-                console.log('  正在升级 claude CLI...');
-                try {
-                    await npmInstallGlobal('@anthropic-ai/claude-code@latest');
-                    console.log('  ✓ claude CLI 升级完成');
+    const claudeInstalled = commandExists('claude');
+    if (claudeInstalled) {
+        try {
+            const verOutput = execFileSync('claude', ['--version'], { encoding: 'utf-8' }).trim();
+            const verMatch = verOutput.match(/^(\d+\.\d+\.\d+)/);
+            if (verMatch) {
+                const parts = verMatch[1].split('.').map(Number);
+                const isOk = parts[0] > MIN_CLAUDE_VER[0]
+                    || (parts[0] === MIN_CLAUDE_VER[0] && parts[1] > MIN_CLAUDE_VER[1])
+                    || (parts[0] === MIN_CLAUDE_VER[0] && parts[1] === MIN_CLAUDE_VER[1] && parts[2] >= MIN_CLAUDE_VER[2]);
+                if (isOk) {
+                    console.log(`  ✓ claude CLI v${verMatch[1]}`);
                 }
-                catch (e) {
-                    console.log(`  ✗ 升级失败: ${e.message?.slice(0, 200) || e}`);
-                    return false;
+                else {
+                    console.log(`  ✗ claude CLI v${verMatch[1]} — 需要 >= ${MIN_CLAUDE_VER.join('.')}`);
+                    const answer = (await ask(rl, '  → 是否升级 claude CLI？[Y/n] ')).trim().toLowerCase();
+                    if (answer === 'n' || answer === 'no') {
+                        console.log('  已取消');
+                        return false;
+                    }
+                    console.log('  正在升级 claude CLI...');
+                    try {
+                        await npmInstallGlobal('@anthropic-ai/claude-code@latest');
+                        console.log('  ✓ claude CLI 升级完成');
+                    }
+                    catch (e) {
+                        console.log(`  ✗ 升级失败: ${e.message?.slice(0, 200) || e}`);
+                        return false;
+                    }
                 }
             }
+            else {
+                console.log(`  ✓ claude CLI (${verOutput})`);
+            }
         }
-        else {
-            console.log(`  ✓ claude CLI (${verOutput})`);
+        catch {
+            // claude command exists but --version failed
         }
     }
-    catch {
-        if (!claudeInstalled) {
-            console.log('  ✗ claude CLI 未找到');
-            console.log('  → 请先安装: npm install -g @anthropic-ai/claude-code');
-            return false;
-        }
+    else {
+        console.log('  ✗ claude CLI 未找到');
+        console.log('  → 请先安装: npm install -g @anthropic-ai/claude-code');
+        return false;
     }
     // @anthropic-ai/claude-agent-sdk >= 0.2.75
     let sdkAction = 'ok';
@@ -226,6 +229,19 @@ async function checkEnvironment(rl) {
 }
 // ==================== Shell Profile ====================
 function setupEnvVar(home) {
+    if (isWindows) {
+        // Windows: use setx to set user environment variable
+        try {
+            execFileSync('setx', ['EVOLCLAW_HOME', home], { encoding: 'utf-8', stdio: 'pipe' });
+            console.log(`  ✓ 已设置用户环境变量: EVOLCLAW_HOME=${home}`);
+            console.log('  ⚠ 请重新打开终端使其生效');
+        }
+        catch (e) {
+            console.log(`  ⚠ 设置环境变量失败: ${e.message?.slice(0, 100) || e}`);
+            console.log(`  → 请手动设置环境变量 EVOLCLAW_HOME=${home}`);
+        }
+        return;
+    }
     const exportLine = `export EVOLCLAW_HOME="${home}"`;
     const candidates = [
         path.join(os.homedir(), '.zshrc'),

package/dist/utils/markdown-to-feishu.js

@@ -2,6 +2,59 @@
  * Markdown 到飞书富文本格式转换工具
  * 使用飞书 post 格式的 md tag 原生渲染 Markdown
  */
+/**
+ * 计算字符串的显示宽度（CJK 字符按 2 宽度计算）
+ */
+function displayWidth(str) {
+    let width = 0;
+    for (const ch of str) {
+        const code = ch.codePointAt(0);
+        // CJK Unified Ideographs, CJK Compatibility, Fullwidth Forms, etc.
+        if ((code >= 0x4E00 && code <= 0x9FFF) || // CJK Unified
+            (code >= 0x3400 && code <= 0x4DBF) || // CJK Extension A
+            (code >= 0xF900 && code <= 0xFAFF) || // CJK Compatibility
+            (code >= 0xFF01 && code <= 0xFF60) || // Fullwidth Forms
+            (code >= 0x3000 && code <= 0x303F) // CJK Symbols
+        ) {
+            width += 2;
+        }
+        else {
+            width += 1;
+        }
+    }
+    return width;
+}
+/**
+ * 用空格填充字符串到指定显示宽度
+ */
+function padToWidth(str, targetWidth) {
+    const current = displayWidth(str);
+    const padding = Math.max(0, targetWidth - current);
+    return str + ' '.repeat(padding);
+}
+/**
+ * 将 Markdown 表格转换为代码块内的对齐文本
+ * 飞书 post md tag 不支持标准 markdown 表格，会静默丢弃内容
+ * 用代码块 + 等宽对齐保留二维结构
+ */
+function convertTablesToText(text) {
+    const tableRegex = /^(\|.+\|)\n(\|[\s:|-]+\|)\n((?:\|.+\|\n?)+)/gm;
+    return text.replace(tableRegex, (_match, headerLine, _sep, bodyBlock) => {
+        const parseRow = (line) => line.split('|').slice(1, -1).map((c) => c.trim());
+        const headers = parseRow(headerLine);
+        const rows = bodyBlock.trim().split('\n').map(parseRow);
+        // 计算每列最大显示宽度
+        const colWidths = headers.map((h, i) => {
+            const cellWidths = rows.map(r => displayWidth(r[i] || ''));
+            return Math.max(displayWidth(h), ...cellWidths);
+        });
+        // 构建对齐的表格文本
+        const headerStr = headers.map((h, i) => padToWidth(h, colWidths[i])).join('  ');
+        const sepStr = colWidths.map(w => '-'.repeat(w)).join('  ');
+        const rowStrs = rows.map(r => headers.map((_, i) => padToWidth(r[i] || '', colWidths[i])).join('  '));
+        return '```\n' + [headerStr, sepStr, ...rowStrs].join('\n') + '\n```';
+    });
+}
 /**
  * 将 Markdown 文本转换为飞书 post 消息格式
  * 利用 md tag 让飞书原生渲染，支持代码高亮、嵌套列表、引用等全部语法
@@ -9,7 +62,9 @@
 export function markdownToFeishuPost(markdown, defaultTitle) {
     const match = markdown.match(/^# (.+)$/m);
     const title = match?.[1] ?? defaultTitle ?? '';
-    const body = match ? markdown.replace(/^# .+\n?/, '') : markdown;
+    let body = match ? markdown.replace(/^# .+\n?/, '') : markdown;
+    // 转换飞书不支持的 markdown 表格
+    body = convertTablesToText(body);
     return {
         zh_cn: {
             title,
@@ -32,7 +87,8 @@ export function hasMarkdownSyntax(text) {
         /```[\s\S]*?```/, // 代码块
         /\[.*?\]\(.*?\)/, // 链接
         /^[\s]*[-*+]\s/m, // 无序列表
-        /^[\s]*\d+\.\s/m // 有序列表
+        /^[\s]*\d+\.\s/m, // 有序列表
+        /^\|.+\|$/m // 表格
     ];
     return markdownPatterns.some(pattern => pattern.test(text));
 }

package/dist/utils/permission.js

@@ -1,5 +1,6 @@
 // 危险命令黑名单（正则表达式）
 const DANGEROUS_PATTERNS = [
+    // Unix
     /\brm\s+-\w*r\w*f/, // rm -rf
     /\bsudo\b/, // sudo
     /\bmkfs\b/, // mkfs (格式化文件系统)
@@ -8,6 +9,12 @@ const DANGEROUS_PATTERNS = [
     />\s*\/dev\//, // 重定向到设备文件
     /\bshutdown\b/, // 关机
     /\breboot\b/, // 重启
+    // Windows
+    /\bformat\s+[a-zA-Z]:/i, // format C: (格式化磁盘)
+    /\brd\s+\/s/i, // rd /s (递归删除目录)
+    /\bdel\s+\/[sfq]/i, // del /f, /s, /q (强制删除)
+    /\breg\s+delete/i, // reg delete (删除注册表)
+    /\bnet\s+stop/i, // net stop (停止服务)
 ];
 /**
  * 权限检查回调函数

package/dist/utils/platform.js

@@ -0,0 +1,175 @@
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { execFileSync, execFile, spawn } from 'child_process';
+import { promisify } from 'util';
+import fs from 'fs';
+const execFileAsync = promisify(execFile);
+export const isWindows = process.platform === 'win32';
+/**
+ * Encode project path as directory name (Claude SDK convention).
+ * Replace all path separators with '-'.
+ * e.g. /home/user/project -> -home-user-project
+ *      C:\Users\project -> C-Users-project
+ */
+export function encodePath(projectPath) {
+    return projectPath.replace(/[/\\]/g, '-');
+}
+/**
+ * Cross-platform process liveness check.
+ */
+export function isProcessRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        // ESRCH = process not found; EPERM = exists but no permission
+        return e.code === 'EPERM';
+    }
+}
+/**
+ * Cross-platform process termination.
+ */
+export function killProcess(pid, force = false) {
+    if (isWindows && force) {
+        try {
+            execFileSync('taskkill', ['/PID', String(pid), '/F']);
+        }
+        catch { }
+    }
+    else {
+        try {
+            process.kill(pid, force ? 'SIGKILL' : 'SIGTERM');
+        }
+        catch { }
+    }
+}
+/**
+ * Cross-platform process search by command line pattern.
+ * Returns list of matching PIDs.
+ */
+export function findProcesses(pattern) {
+    try {
+        if (isWindows) {
+            const output = execFileSync('wmic', ['process', 'where', `CommandLine like '%${pattern}%'`, 'get', 'ProcessId'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+            return output.split('\n')
+                .map(line => parseInt(line.trim(), 10))
+                .filter(pid => !isNaN(pid) && pid !== process.pid);
+        }
+        else {
+            const output = execFileSync('pgrep', ['-f', pattern], { encoding: 'utf-8' }).trim();
+            return output ? output.split('\n').map(Number).filter(pid => pid !== process.pid) : [];
+        }
+    }
+    catch {
+        return [];
+    }
+}
+export function getProcessInfo(pid) {
+    try {
+        if (isWindows) {
+            // Use wmic on Windows
+            const output = execFileSync('wmic', ['process', 'where', `ProcessId=${pid}`, 'get', 'WorkingSetSize,CreationDate'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+            const lines = output.trim().split('\n').filter(l => l.trim());
+            if (lines.length >= 2) {
+                const parts = lines[1].trim().split(/\s+/);
+                const memKB = parts[1] ? Math.round(parseInt(parts[1], 10) / 1024) : undefined;
+                return { memory: memKB ? `${memKB}` : undefined };
+            }
+        }
+        else {
+            const uptime = execFileSync('ps', ['-p', String(pid), '-o', 'etime='], { encoding: 'utf-8' }).trim();
+            const cpu = execFileSync('ps', ['-p', String(pid), '-o', '%cpu='], { encoding: 'utf-8' }).trim();
+            const mem = execFileSync('ps', ['-p', String(pid), '-o', 'rss='], { encoding: 'utf-8' }).trim();
+            return { uptime, cpu, memory: mem };
+        }
+    }
+    catch { }
+    return {};
+}
+/**
+ * Cross-platform command existence check.
+ */
+export function commandExists(cmd) {
+    try {
+        if (isWindows) {
+            execFileSync('where', [cmd], { encoding: 'utf-8', stdio: 'pipe' });
+        }
+        else {
+            execFileSync('which', [cmd], { encoding: 'utf-8', stdio: 'pipe' });
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Cross-platform live log tailing (replaces tail -f).
+ * Returns an abort function.
+ */
+export function tailFile(filePath) {
+    if (!isWindows) {
+        // Unix: use tail -f (more efficient)
+        const child = spawn('tail', ['-f', filePath], { stdio: 'inherit' });
+        child.on('exit', (code) => process.exit(code || 0));
+        return { abort: () => child.kill() };
+    }
+    // Windows: Node.js-based implementation
+    // Output last 20 lines of existing content
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const lines = content.split('\n');
+    const lastLines = lines.slice(-20);
+    process.stdout.write(lastLines.join('\n'));
+    let position = fs.statSync(filePath).size;
+    const watcher = fs.watch(filePath, () => {
+        const stat = fs.statSync(filePath);
+        if (stat.size > position) {
+            const fd = fs.openSync(filePath, 'r');
+            const buffer = Buffer.alloc(stat.size - position);
+            fs.readSync(fd, buffer, 0, buffer.length, position);
+            fs.closeSync(fd);
+            process.stdout.write(buffer.toString('utf-8'));
+            position = stat.size;
+        }
+    });
+    return { abort: () => watcher.close() };
+}
+/**
+ * Resolve file path from import.meta.url (cross-platform safe).
+ * Replaces unsafe `new URL('.', import.meta.url).pathname` usage.
+ */
+export function dirFromImportMeta(importMetaUrl) {
+    return path.dirname(fileURLToPath(importMetaUrl));
+}
+/**
+ * Check if current file is the main entry script (cross-platform safe).
+ * Replaces unsafe `import.meta.url === \`file://\${process.argv[1]}\`` check.
+ */
+export function isMainScript(importMetaUrl) {
+    const argv1 = process.argv[1];
+    if (!argv1)
+        return false;
+    try {
+        const selfPath = fileURLToPath(importMetaUrl);
+        const argvPath = fs.realpathSync(argv1);
+        return selfPath === argvPath || fs.realpathSync(selfPath) === argvPath;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Register graceful shutdown signal handlers (cross-platform safe).
+ */
+export function onShutdown(callback) {
+    process.on('SIGINT', callback);
+    // SIGTERM is not fully supported on Windows, but Node.js can still emit it
+    // in some scenarios (e.g., process managers), so register it anyway
+    process.on('SIGTERM', callback);
+    if (isWindows) {
+        // On Windows, also handle SIGHUP for graceful shutdown
+        // when the process is terminated via Task Manager or similar
+        process.on('SIGHUP', callback);
+    }
+}

package/package.json

@@ -1,21 +1,20 @@
 {
   "name": "evolclaw",
-  "version": "2.0.3",
+  "version": "2.0.5",
   "description": "Lightweight AI Agent gateway connecting Claude Agent SDK to messaging channels (Feishu, ACP) with multi-project session management",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
-    "evolclaw": "./bin/evolclaw"
+    "evolclaw": "./dist/cli.js"
   },
   "files": [
     "dist/",
     "!dist/experimental/",
-    "bin/",
     "data/evolclaw.sample.json"
   ],
   "scripts": {
     "dev": "tsx watch src/index.ts",
-    "build": "tsc",
+    "build": "tsc && node -e \"const f='dist/cli.js',c=require('fs').readFileSync(f,'utf8');if(!c.startsWith('#!'))require('fs').writeFileSync(f,'#!/usr/bin/env node\\n'+c)\" && node -e \"try{require('child_process').execFileSync('chmod',['+x','dist/cli.js'])}catch{}\"",
     "start": "node dist/index.js",
     "test": "vitest run",
     "test:watch": "vitest",

package/bin/evolclaw

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-const { main } = await import(join(__dirname, '..', 'dist', 'cli.js'));
-main(process.argv.slice(2));