evolclaw 3.2.0 → 3.4.0

package/dist/index.js

@@ -2,9 +2,8 @@ import { ClaudeSessionFileAdapter } from './core/session/adapters/claude-session
 import { CodexSessionFileAdapter } from './core/session/adapters/codex-session-file-adapter.js';
 import { GeminiSessionFileAdapter } from './core/session/adapters/gemini-session-file-adapter.js';
 import { ensureDataDirs, resolvePaths, getPackageRoot, agentMdPath } from './paths.js';
-import { resolveAnthropicConfig } from './agents/resolve.js';
-import { loadDefaults, autoMigrateIfNeeded, migrateIdentitiesIfNeeded, migrateProcessConfigIfNeeded } from './config-store.js';
-import { loadEvolclawConfig } from './evolclaw-config.js';
+import { resolveAnthropicConfig } from './agents/baseagent.js';
+import { loadDefaults, autoMigrateIfNeeded, migrateIdentitiesIfNeeded, migrateProcessConfigIfNeeded, loadEvolclawConfig } from './config-store.js';
 import { CONFIG_SCHEMA_VERSION } from './types.js';
 import dotenv from 'dotenv';
 import { SessionManager } from './core/session/session-manager.js';
@@ -21,7 +20,7 @@ import { MessageProcessor, buildEnvelope } from './core/message/message-processo
 import { MessageQueue } from './core/message/message-queue.js';
 import { MessageBridge } from './core/message/message-bridge.js';
 import { MessageCache } from './core/message/message-cache.js';
-import { CommandHandler } from './core/command-handler.js';
+import { CommandHandler, isProcessLevelOwner } from './core/command/command-handler.js';
 import { EventBus } from './core/event-bus.js';
 import { StatsCollector } from './utils/stats.js';
 import { AidStatsCollector } from './utils/stats.js';
@@ -33,9 +32,10 @@ import { EvolAgentRegistry } from './core/evolagent-registry.js';
 import { buildReloadHooks } from './core/channel-loader.js';
 import { IpcServer } from './ipc.js';
 import { logger, setLogLevel } from './utils/logger.js';
+import { fetchEcwebPairCode } from './utils/ecweb-pair.js';
 import { writeMain, removeAll, isMainWinner, scanInstances } from './utils/instance-registry.js';
 import { detectDuplicates } from './core/evolagent-registry.js';
-import { loadKitManifest, cleanEckDebug, invalidateKitCache } from './agents/kit-renderer.js';
+import { loadKitManifest, cleanEckDebug, invalidateKitCache } from './eck/kit-renderer.js';
 import { initEck } from './eck/init.js';
 import { TriggerManager } from './core/trigger/manager.js';
 import { TriggerScheduler, calcNextFireAt } from './core/trigger/scheduler.js';
@@ -59,6 +59,11 @@ function summarizeOutboundPayload(payload) {
             s.isFinal = payload.isFinal;
             s.text = payload.text;
             break;
+        case 'command.result':
+        case 'command.error':
+        case 'result.error':
+            s.text = payload.text;
+            break;
         case 'result.file':
             s.filePath = payload.filePath;
             break;
@@ -72,6 +77,8 @@ function summarizeOutboundPayload(payload) {
             s.interactionKind = payload.interaction?.kind?.kind;
             break;
         case 'status.started':
+        case 'status.progress':
+        case 'status.queued':
         case 'status.completed':
         case 'status.interrupted':
         case 'status.error':
@@ -316,6 +323,40 @@ async function main() {
     // Per-AID 消息统计收集器（累计，供 watch aid 实时展示）
     const aidStatsCollector = new AidStatsCollector(eventBus);
     aidStatsCollector.setSessionsDir(paths.sessionsDir);
+    // 持久化网络流量到 message_events 表
+    aidStatsCollector.onMessage = (ev) => {
+        import('./core/stats/writer.js').then(({ insertMessageEvent }) => {
+            insertMessageEvent(paths.root, ev);
+        }).catch(() => { });
+    };
+    // 日聚合表 usage_daily：首次启动回填 + 每日自愈。
+    // 首次：表为空但明细非空时全量回填历史数据；之后靠 writer 写时增量维护。
+    // 自愈：每日全量重建一次，纠正任何写时漂移。
+    import('./core/stats/db.js').then(({ getDb, rebuildDailyRollup }) => {
+        const db = getDb(paths.root);
+        if (!db)
+            return;
+        try {
+            const daily = db.prepare('SELECT COUNT(*) AS n FROM usage_daily').get();
+            const events = db.prepare('SELECT COUNT(*) AS n FROM usage_events').get();
+            if (daily.n === 0 && events.n > 0) {
+                logger.info('[Stats] usage_daily 为空，回填历史数据…');
+                rebuildDailyRollup(paths.root);
+            }
+        }
+        catch (e) {
+            logger.warn(`[Stats] usage_daily 回填检测失败（非致命）: ${e}`);
+        }
+        // 每日自愈（24h），纠正写时增量漂移。
+        setInterval(() => {
+            try {
+                rebuildDailyRollup(paths.root);
+            }
+            catch (e) {
+                logger.warn(`[Stats] usage_daily 自愈失败（非致命）: ${e}`);
+            }
+        }, 24 * 60 * 60 * 1000);
+    }).catch(() => { });
     // 初始化 SessionManager（文件系统后端）
     const sessionManager = new SessionManager(paths.sessionsDir, eventBus, (channel, userId) => agentRegistry.isOwner(channel, userId), (channel, userId) => agentRegistry.isAdmin(channel, userId));
     // sessionMode 解析：从 channel 路由到具体 agent，按 agent.config.chatmode
@@ -449,7 +490,7 @@ async function main() {
         const evol = evolagentName || primaryAgent.aid;
         const agent = agentMap.get(`${evol}::${baseagent}`)
             || agentMap.get(primaryRunnerKey);
-        if (agent?.hasActiveStream(sessionKey)) {
+        if (agent) {
             await agent.interrupt(sessionKey);
         }
     });
@@ -497,6 +538,17 @@ async function main() {
             }
         }
         scheduler.setFireCallback((msg, trigger) => {
+            const onEnqueueFailed = (err) => {
+                const error = err instanceof Error ? err.message : String(err);
+                logger.error(`[Trigger] Enqueue failed ${trigger.id}: ${error}`);
+                eventBus.publish({
+                    type: 'trigger:failed', triggerId: trigger.id, name: trigger.name,
+                    messageId: msg.messageId || '', error,
+                    targetChannel: trigger.targetChannel, targetChannelId: trigger.targetChannelId,
+                    fireTime: msg.triggerMeta?.fireTime ?? Date.now(), phase: 'enqueue',
+                });
+                scheduler.onTriggerComplete(trigger.id, 'failed');
+            };
             if (trigger.targetSessionStrategy === 'current' && trigger.boundSessionId) {
                 const boundId = trigger.boundSessionId;
                 if (messageQueue.isProcessing(boundId)) {
@@ -509,12 +561,12 @@ async function main() {
                         return;
                     }
                     messageQueue.enqueue(boundId, msg, bound.projectPath, { interruptible: false })
-                        .catch(err => logger.error(`[Trigger] Enqueue failed ${trigger.id}: ${err}`));
+                        .catch(onEnqueueFailed);
                 });
                 return;
             }
             messageQueue.enqueue(`${msg.channel}:${msg.channelId}`, msg, primaryProjectPath, { interruptible: false })
-                .catch(err => logger.error(`[Trigger] Enqueue failed ${trigger.id}: ${err}`));
+                .catch(onEnqueueFailed);
         });
         // Subscribe to trigger:completed/failed/skipped to update cron inflight state
         eventBus.subscribe('trigger:completed', (ev) => scheduler.onTriggerComplete(ev.triggerId, 'completed'));
@@ -523,6 +575,41 @@ async function main() {
             if (ev.reason === 'interrupted')
                 scheduler.onTriggerComplete(ev.triggerId, 'interrupted');
         });
+        // ── Trigger 失败/跳过通知：向 targetChannel 发送告警消息 ──
+        eventBus.subscribe('trigger:failed', (ev) => {
+            const adapter = processor.getAdapter(ev.targetChannel);
+            if (!adapter)
+                return;
+            const phaseLabel = ev.phase === 'enqueue' ? '入队' : '执行';
+            const timeStr = ev.fireTime ? new Date(ev.fireTime).toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai' }) : '未知';
+            const text = `⚠️ 定时任务 [${ev.name || ev.triggerId}] 执行失败\n阶段：${phaseLabel}\n原因：${ev.error}\n触发时间：${timeStr}`;
+            const envelope = {
+                taskId: `trigger-notify:${ev.triggerId}`,
+                channel: ev.targetChannel,
+                channelId: ev.targetChannelId,
+                agentName: 'system',
+                chatmode: 'interactive',
+                timestamp: Date.now(),
+            };
+            adapter.send(envelope, { kind: 'result.text', text, isFinal: true, format: 'plain' }).catch(() => { });
+        });
+        eventBus.subscribe('trigger:skipped', (ev) => {
+            if (ev.reason !== 'overlap')
+                return;
+            const adapter = processor.getAdapter(ev.targetChannel);
+            if (!adapter)
+                return;
+            const text = `⚠️ 定时任务 [${ev.name || ev.triggerId}] 本次跳过（上次执行仍在进行中）`;
+            const envelope = {
+                taskId: `trigger-notify:${ev.triggerId}`,
+                channel: ev.targetChannel,
+                channelId: ev.targetChannelId,
+                agentName: 'system',
+                chatmode: 'interactive',
+                timestamp: Date.now(),
+            };
+            adapter.send(envelope, { kind: 'result.text', text, isFinal: true, format: 'plain' }).catch(() => { });
+        });
         // Note: only the primary agent's scheduler is wired to cmdHandler.
         // Non-primary agent channels will receive "⚠️ 触发器功能未启用" when using /trigger.
         // Full per-channel scheduler routing is a future improvement.
@@ -651,6 +738,7 @@ async function main() {
                     createdByPeerId: '__system__',
                     createdByChannel: '__system__',
                     fireCount: 0,
+                    failCount: 0,
                     createdAt: Date.now(),
                     updatedAt: Date.now(),
                 };
@@ -700,6 +788,15 @@ async function main() {
         });
     }
     // ── 控制 AID（daemon 进程身份）：pureIdentity 接入 AUN，独立于 evolagent ──
+    // 证书缺失检测/生成在 CLI 侧（evolclaw start）完成。daemon 是后台进程无终端，
+    // 这里只做兜底：证书缺失时 warn 并继续（AUNChannel 内部后台重连），绝不阻塞。
+    if (evolclawCfg.aid) {
+        const aunPath = resolvePaths().root;
+        const certKey = path.join(aunPath, 'AIDs', evolclawCfg.aid, 'private', 'key.json');
+        if (!fs.existsSync(certKey)) {
+            logger.warn(`控制 AID 证书缺失：${evolclawCfg.aid}（AUN 控制通道后台重连；如需重建运行 evolclaw init）`);
+        }
+    }
     let controlChannel;
     if (evolclawCfg.aid) {
         controlChannel = new AUNChannel({
@@ -719,6 +816,51 @@ async function main() {
         catch (e) {
             logger.warn(`控制 AID 首连失败（后台自动重连，不影响 daemon 主流程）: ${e?.message || e}`);
         }
+        // 控制 AID 接收 owner 指令：
+        // 1. /pair — ECWeb 配对码（文本快路径）
+        // 2. menu.* JSON — 路由到 cmdHandler.execMenuForControl（进程级 + 全量权限）
+        // 发送方身份由 AUN X.509 证书链验证，非 owner 完全静默。
+        controlChannel.onMessage(async (opts) => {
+            try {
+                if (!isProcessLevelOwner(opts.peerId, evolclawCfg.owners)) {
+                    logger.debug(`控制 AID 收到非 owner 消息，忽略: from=${opts.peerId}`);
+                    return;
+                }
+                const text = (opts.content || '').trim();
+                if (text.toLowerCase() === '/pair') {
+                    const port = evolclawCfg.ecweb?.port ?? 42705;
+                    const pair = await fetchEcwebPairCode(port);
+                    let reply;
+                    if (pair) {
+                        const mins = Math.max(0, Math.round((pair.expiresAt - Date.now()) / 60000));
+                        reply = `ECWeb 配对码：${pair.code}（约 ${mins} 分钟内有效）\n在浏览器打开 ECWeb 后输入此码登录`;
+                    }
+                    else {
+                        reply = 'ECWeb 未运行或暂不可达。请在主机运行 ec watch web 启动后重试。';
+                    }
+                    await controlChannel.sendMessage(opts.channelId, reply);
+                    return;
+                }
+                // menu.* JSON 路由：owner 已在上方校验，转交 execMenuForControl（fromControlChannel=true）
+                let parsed;
+                try {
+                    parsed = JSON.parse(text);
+                }
+                catch {
+                    parsed = null;
+                }
+                if (parsed && typeof parsed === 'object' && typeof parsed.type === 'string' && parsed.type.startsWith('menu.')) {
+                    const response = await cmdHandler.execMenuForControl(parsed, opts.peerId);
+                    await controlChannel.sendMessage(opts.channelId, JSON.stringify(response));
+                    return;
+                }
+                // owner 发的其他内容：提示可用指令
+                await controlChannel.sendMessage(opts.channelId, '可用指令：/pair（获取 ECWeb 登录配对码）');
+            }
+            catch (e) {
+                logger.warn(`控制 AID 消息处理失败: ${e?.message || e}`);
+            }
+        });
     }
     // 上线通知：延迟 1-3 秒后向 owner 发送上线消息（带 name + 工作目录）
     // 需在配置中 debug.upmsg: true 手动开启
@@ -934,6 +1076,7 @@ async function main() {
     }, async (cmd, sessionId) => cmdHandler.handleCtl(cmd, sessionId));
     // M3: direct call (not cast) — wire EvolAgentRegistry into IPC for evolagent.* handlers
     ipcServer.setAgentRegistry(agentRegistry);
+    ipcServer.setMenuExecutor((payload) => cmdHandler.execMenuForEcweb(payload));
     // 注入 AUN AID 状态聚合器：遍历所有 aun 类型 channel，调 getAidState() 收集
     ipcServer.setAunAidProvider(() => {
         const out = [];
@@ -963,16 +1106,30 @@ async function main() {
     aidStatsCollector.setQueueStatsProvider((agentName) => ({
         processing: messageQueue.getProcessingCountByAgent(agentName),
         queued: messageQueue.getQueueLengthByAgent(agentName),
+        muted: messageQueue.isAgentMuted(agentName),
     }));
     ipcServer.setAunAidStatsProvider(() => aidStatsCollector.getAllSnapshots());
     ipcServer.setAunAidStatsRecorder((params) => {
-        aidStatsCollector.recordOutbound(params.aid, params.toPeer, Buffer.byteLength(params.text || '', 'utf-8'), params.text, false, params.encrypt, params.chatmode);
+        aidStatsCollector.recordOutbound(params.aid, params.toPeer, Buffer.byteLength(params.text || '', 'utf-8'), params.text, false, params.encrypt, params.chatmode, 'send');
     });
     // ── Reload hooks: enable agentRegistry.reload() to drain/disconnect/restart channels ──
     const reloadHooks = buildReloadHooks({
         channelLoader,
         channelInstances,
         registerChannelInstance,
+        unregisterChannelInstance: (channelName) => {
+            processor.unregisterChannel(channelName);
+            cmdHandler.unregisterChannel(channelName);
+            msgBridge.removeChannel(channelName);
+        },
+        onChannelStarted: (inst) => {
+            // startChannel 重建渠道时重新注入 AidStatsCollector（与 hot-load 路径对齐）
+            if (inst.channelType === 'aun') {
+                const ch = inst.channel;
+                if (typeof ch?.setAidStatsCollector === 'function')
+                    ch.setAidStatsCollector(aidStatsCollector);
+            }
+        },
         messageQueue,
     });
     // Make reload hooks accessible to IPC handler & ctl handler (both run in this process)
@@ -986,6 +1143,11 @@ async function main() {
         const instances = await channelLoader.createForAgent(agent);
         for (const inst of instances) {
             registerChannelInstance(inst);
+            if (inst.channelType === 'aun') {
+                const ch = inst.channel;
+                if (typeof ch?.setAidStatsCollector === 'function')
+                    ch.setAidStatsCollector(aidStatsCollector);
+            }
             agent.channels.set(inst.adapter.channelKey, inst.adapter);
             channelInstances.push(inst);
         }
@@ -1062,6 +1224,8 @@ async function main() {
     };
     // I3: start IPC server LAST, after all hook setup, to eliminate race window
     ipcServer.start();
+    ipcServer.setStatsProvider(() => statsCollector.getSnapshot());
+    ipcServer.startCpuTracking();
     // 配置 reload 走 IPC `evolagent.reload` 触发，不再用 watchFile。
     // 双 rename 原子写下 watchFile 的语义会被破坏，且新结构有 N 个 config.json 要监控；
     // 显式触发更可控。
@@ -1073,6 +1237,7 @@ async function main() {
         const pid = process.pid;
         const ppid = process.ppid;
         logger.info(`\n\nShutting down gracefully... (signal=${shutdownSignal}, pid=${pid}, ppid=${ppid})`);
+        ipcServer.stopCpuTracking();
         ipcServer.stop();
         eventBus.publish({
             type: 'system:shutdown',

package/dist/ipc.js

@@ -1,7 +1,8 @@
 import net from 'net';
 import fs from 'fs';
+import os from 'os';
 import { logger } from './utils/logger.js';
-import { fileCache } from './core/cache/file-cache.js';
+import { fileCache } from './core/daemon-file-cache.js';
 const isWindows = process.platform === 'win32';
 const isNamedPipe = (p) => isWindows && p.startsWith('\\\\.\\pipe\\');
 export class IpcServer {
@@ -13,6 +14,18 @@ export class IpcServer {
     aunAidProvider;
     aunAidStatsProvider;
     aunAidStatsRecorder;
+    menuExecutor;
+    statsProvider;
+    // CPU 占用追踪：IPC handler 是一次性同步调用，无法在响应里做 200ms 异步采样，
+    // 故用后台 1s interval 累积 process.cpuUsage() 增量，handler 直接读最近值。
+    // procCpuPercent = 本 daemon 进程占单核的百分比（可 >100% 仅当多核，已 clamp 到 100）；
+    // sysCpuPercent  = 整机所有核平均忙碌百分比（由 os.cpus() times 增量算出）。
+    lastCpuUsage = process.cpuUsage();
+    lastCpuTs = Date.now();
+    cpuPercent = 0; // 进程级
+    sysCpuPercent = 0; // 系统级
+    lastCpuTimes = null;
+    cpuTimer = null;
     constructor(socketPath, getStatus, commandExecutor) {
         this.socketPath = socketPath;
         this.getStatus = getStatus;
@@ -22,6 +35,10 @@ export class IpcServer {
     setAgentRegistry(registry) {
         this.agentRegistry = registry;
     }
+    /** Inject menu.* executor (ECWeb Control proxies menu requests through this) */
+    setMenuExecutor(executor) {
+        this.menuExecutor = executor;
+    }
     /** Inject AUN AID state aggregator for aun-aids IPC handler */
     setAunAidProvider(provider) {
         this.aunAidProvider = provider;
@@ -34,6 +51,52 @@ export class IpcServer {
     setAunAidStatsRecorder(recorder) {
         this.aunAidStatsRecorder = recorder;
     }
+    /** Inject global StatsSnapshot provider for monitor-snapshot IPC handler */
+    setStatsProvider(provider) {
+        this.statsProvider = provider;
+    }
+    /** Start the 1s background CPU sampling loop (for monitor-snapshot). Call after start(). */
+    startCpuTracking() {
+        if (this.cpuTimer)
+            return;
+        this.cpuTimer = setInterval(() => {
+            const now = Date.now();
+            const elapsedUs = (now - this.lastCpuTs) * 1000; // wall time in microseconds
+            if (elapsedUs > 0) {
+                const usage = process.cpuUsage(this.lastCpuUsage); // delta since last sample
+                this.cpuPercent = Math.min(100, ((usage.user + usage.system) / elapsedUs) * 100);
+            }
+            this.lastCpuUsage = process.cpuUsage();
+            this.lastCpuTs = now;
+            // 系统级 CPU：os.cpus() 累计 times 的增量 → 整机平均忙碌率
+            try {
+                const cpus = os.cpus();
+                let idle = 0, total = 0;
+                for (const c of cpus) {
+                    idle += c.times.idle;
+                    total += c.times.user + c.times.nice + c.times.sys + c.times.idle + c.times.irq;
+                }
+                if (this.lastCpuTimes) {
+                    const idleDelta = idle - this.lastCpuTimes.idle;
+                    const totalDelta = total - this.lastCpuTimes.total;
+                    if (totalDelta > 0) {
+                        this.sysCpuPercent = Math.max(0, Math.min(100, (1 - idleDelta / totalDelta) * 100));
+                    }
+                }
+                this.lastCpuTimes = { idle, total };
+            }
+            catch { /* os.cpus() 理论上不抛 */ }
+        }, 1000);
+        // Don't keep the event loop alive for sampling alone.
+        this.cpuTimer.unref?.();
+    }
+    /** Stop the CPU sampling loop. */
+    stopCpuTracking() {
+        if (this.cpuTimer) {
+            clearInterval(this.cpuTimer);
+            this.cpuTimer = null;
+        }
+    }
     start() {
         // Remove stale socket file (Unix only — named pipes auto-cleanup on process exit)
         if (!isNamedPipe(this.socketPath)) {
@@ -206,6 +269,58 @@ export class IpcServer {
                     return { ok: false, error: e?.message || String(e) };
                 }
             }
+            case 'menu.exec': {
+                if (!this.menuExecutor)
+                    return { ok: false, error: 'menu.exec not configured' };
+                try {
+                    const response = await this.menuExecutor(cmd.payload);
+                    return { ok: true, response };
+                }
+                catch (e) {
+                    return { ok: false, error: e?.message ?? String(e) };
+                }
+            }
+            case 'monitor-snapshot': {
+                // watch web Monitor 页用：进程级 + 系统级运行指标 + 全局 stats + per-agent 汇总。
+                const mem = process.memoryUsage();
+                const totalMem = os.totalmem();
+                const freeMem = os.freemem();
+                const aids = this.aunAidProvider ? this.aunAidProvider() : [];
+                const aidStats = this.aunAidStatsProvider ? this.aunAidStatsProvider() : [];
+                const statsMap = new Map(aidStats.map((s) => [s.aid, s]));
+                return {
+                    ok: true,
+                    snapshot: {
+                        ts: Date.now(),
+                        uptimeMs: Math.round(process.uptime() * 1000),
+                        cpuCount: os.cpus().length,
+                        // 进程级：本 daemon 进程
+                        memory: {
+                            rss: mem.rss,
+                            heapUsed: mem.heapUsed,
+                            heapTotal: mem.heapTotal,
+                            external: mem.external,
+                        },
+                        cpuPercent: Math.round(this.cpuPercent * 10) / 10,
+                        // 系统级：整机
+                        system: {
+                            memTotal: totalMem,
+                            memUsed: totalMem - freeMem,
+                            memFree: freeMem,
+                            cpuPercent: Math.round(this.sysCpuPercent * 10) / 10,
+                            loadAvg: os.loadavg(), // [1m, 5m, 15m]（Windows 恒 0）
+                        },
+                        stats: this.statsProvider ? this.statsProvider() : null,
+                        agents: aids.map((a) => ({
+                            aid: a.aid,
+                            agentName: a.agentName,
+                            channelName: a.channelName,
+                            status: a.status,
+                            stats: statsMap.get(a.aid) ?? null,
+                        })),
+                    },
+                };
+            }
             default:
                 return { error: `unknown command: ${cmd.type}` };
         }

package/dist/utils/cross-platform.js

@@ -5,15 +5,33 @@ import { promisify } from 'util';
 import fs from 'fs';
 const execFileAsync = promisify(execFile);
 export const isWindows = process.platform === 'win32';
+const ENCODE_PATH_MAX = 200;
+function encodePathHash(s) {
+    let h = 0;
+    for (let i = 0; i < s.length; i++)
+        h = (h << 5) - h + s.charCodeAt(i) | 0;
+    return Math.abs(h).toString(36);
+}
 /**
  * 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
+ * Mirrors the SDK's F0(L_(path)) logic:
+ *   1. path.resolve → realpath (if exists) → Unicode NFC
+ *   2. replace every non-alphanumeric character with '-'
+ *   3. truncate to 200 chars + hash suffix for long paths
+ * This must stay in sync with the SDK so evolclaw can locate session files.
  */
 export function encodePath(projectPath) {
-    const normalized = projectPath.replace(/[/\\]+$/, '');
-    return normalized.replace(/[/\\:]/g, '-');
+    const resolved = path.resolve(projectPath);
+    let real = resolved;
+    try {
+        real = fs.realpathSync(resolved);
+    }
+    catch { }
+    const nfc = real.normalize('NFC');
+    const encoded = nfc.replace(/[^a-zA-Z0-9]/g, '-');
+    if (encoded.length <= ENCODE_PATH_MAX)
+        return encoded;
+    return `${encoded.slice(0, ENCODE_PATH_MAX)}-${encodePathHash(nfc)}`;
 }
 /**
  * Cross-platform process liveness check.
@@ -67,6 +85,41 @@ export function findProcesses(pattern) {
         return [];
     }
 }
+/**
+ * Cross-platform: find PIDs listening on a TCP port.
+ * Used to clean up stale/orphaned listeners (e.g. manually-spawned ecweb
+ * that never registered a pid file) before binding the port again.
+ */
+export function findProcessByPort(port) {
+    const pids = new Set();
+    try {
+        if (isWindows) {
+            const result = spawnSync('netstat', ['-ano', '-p', 'TCP'], { encoding: 'utf-8', windowsHide: true });
+            const output = result.stdout || '';
+            for (const line of output.split('\n')) {
+                // 形如:  TCP    0.0.0.0:42705   0.0.0.0:0   LISTENING   23004
+                if (!/LISTENING/i.test(line))
+                    continue;
+                const m = line.match(/:(\d+)\s+\S+\s+LISTENING\s+(\d+)/i);
+                if (m && Number(m[1]) === port) {
+                    const pid = Number(m[2]);
+                    if (pid && pid !== process.pid)
+                        pids.add(pid);
+                }
+            }
+        }
+        else {
+            const output = execFileSync('lsof', ['-ti', `tcp:${port}`, '-sTCP:LISTEN'], { encoding: 'utf-8' }).trim();
+            for (const line of output.split('\n')) {
+                const pid = parseInt(line.trim(), 10);
+                if (pid && pid !== process.pid)
+                    pids.add(pid);
+            }
+        }
+    }
+    catch { /* netstat/lsof missing or no match */ }
+    return [...pids];
+}
 export function getProcessInfo(pid) {
     try {
         if (isWindows) {

package/dist/utils/ecweb-launch.js

@@ -0,0 +1,49 @@
+import fs from 'fs';
+import path from 'path';
+import { resolveGlobalPkg } from './npm-ops.js';
+import { isWindows as platformIsWindows, resolveCommandPath } from './cross-platform.js';
+const ECWEB_PKG = 'evolclaw-web';
+const ECWEB_BIN = 'evolclaw-web';
+function readEcwebPackageEntry(pkgJsonPath) {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf-8'));
+        const bin = typeof pkg.bin === 'string' ? pkg.bin : pkg.bin?.[ECWEB_BIN];
+        if (!bin)
+            return null;
+        const entry = path.resolve(path.dirname(pkgJsonPath), bin);
+        return fs.existsSync(entry) ? entry : null;
+    }
+    catch {
+        return null;
+    }
+}
+function packageJsonBesideNpmShim(commandPath, isWindows) {
+    if (!isWindows || !/\.(cmd|bat)$/i.test(commandPath))
+        return null;
+    const pkgJsonPath = path.join(path.dirname(commandPath), 'node_modules', ECWEB_PKG, 'package.json');
+    return fs.existsSync(pkgJsonPath) ? pkgJsonPath : null;
+}
+/**
+ * Resolve how to launch ecweb as a real background process.
+ *
+ * On Windows, npm bins are usually .cmd shims. Launching that shim through a
+ * shell can create a visible console window; launching the package's JS entry
+ * through the current Node executable avoids that wrapper entirely.
+ */
+export function resolveEcwebLaunchCommand(ecwebArgs, opts = {}) {
+    const nodePath = opts.nodePath ?? process.execPath;
+    const installed = opts.installedPkg !== undefined ? opts.installedPkg : resolveGlobalPkg(ECWEB_PKG);
+    let entry = installed?.path ? readEcwebPackageEntry(installed.path) : null;
+    if (entry) {
+        return { command: nodePath, args: [entry, ...ecwebArgs], entry, source: 'package-bin' };
+    }
+    const commandPath = opts.commandPath !== undefined ? opts.commandPath : resolveCommandPath(ECWEB_BIN);
+    if (!commandPath)
+        return null;
+    const shimPkgJson = packageJsonBesideNpmShim(commandPath, opts.isWindows ?? platformIsWindows);
+    entry = shimPkgJson ? readEcwebPackageEntry(shimPkgJson) : null;
+    if (entry) {
+        return { command: nodePath, args: [entry, ...ecwebArgs], entry, source: 'package-bin' };
+    }
+    return { command: commandPath, args: ecwebArgs, source: 'command' };
+}

package/dist/utils/ecweb-pair.js

@@ -0,0 +1,20 @@
+/**
+ * ECWeb 配对码取码 helper（共享给 daemon 和 CLI）。
+ *
+ * 配对码是 ecweb 进程自己生成并持有的内部状态。daemon/CLI 通过 ecweb 的
+ * localhost-only HTTP 接口 GET /api/pair-code 取当前码（远程访问被 ecweb 403 拒绝）。
+ */
+/** 经 localhost 拉取 ecweb 当前配对码（仅本机可取）。失败返回 null。 */
+export async function fetchEcwebPairCode(port) {
+    try {
+        const resp = await fetch(`http://127.0.0.1:${port}/api/pair-code`, {
+            signal: AbortSignal.timeout(2000),
+        });
+        if (!resp.ok)
+            return null;
+        return await resp.json();
+    }
+    catch {
+        return null;
+    }
+}

package/dist/utils/error-utils.js

@@ -191,6 +191,22 @@ export function _setDictPath(p) {
     _dictPath = p;
     _lastMtime = 0; // 强制下次刷新
 }
+// ── 上下文过长检测（统一真相源）─────────────────────────────────────
+//
+// 覆盖所有已知的「上下文/输入超限」错误措辞，来源包括：
+//  - Anthropic 标准：prompt is too long / input is too long
+//  - OpenAI 兼容：context_length_exceeded / maximum context length
+//  - 网关自定义：reached its context window limit / context window limit
+//  - 中文：上下文过长
+//
+// ⚠️ 新增措辞统一往这里加，不要再在各模块本地复制正则。
+export const CONTEXT_TOO_LONG_PATTERN = /prompt is too long|input is too long|context too long|context limit|context_length_exceeded|context_window_exceeded|context window limit|reached its context window|exceed(?:s|ed)? the context window|maximum context length|上下文过长/i;
+/** 判断一段文本是否为「上下文过长」类错误。空文本返回 false。 */
+export function isContextTooLongText(text) {
+    if (!text)
+        return false;
+    return CONTEXT_TOO_LONG_PATTERN.test(text);
+}
 // ── 错误分类 / 重试 / 消息 ──────────────────────────────────────────
 export function classifyError(error) {
     const msg = (error?.message || '').toLowerCase();
@@ -206,9 +222,7 @@ export function classifyError(error) {
         return ErrorType.UNKNOWN;
     }
     // 内置兜底规则（结构性、稳定的错误模式）
-    if (msg.includes('context_length_exceeded') || msg.includes('context_compact_failed')
-        || msg.includes('context limit') || msg.includes('input is too long')
-        || msg.includes('上下文过长')) {
+    if (msg.includes('context_compact_failed') || isContextTooLongText(msg)) {
         return ErrorType.CONTEXT_TOO_LONG;
     }
     if (msg.includes('invalid_model') || msg.includes('model_not_found')
@@ -285,8 +299,7 @@ export function getErrorMessage(error, terminalReason, includeEmoji = true) {
     // 内置兜底规则（结构性错误）
     const warnPrefix = includeEmoji ? '⚠️ ' : '';
     const errPrefix = includeEmoji ? '❌ ' : '';
-    if (msg.includes('CONTEXT_COMPACT_FAILED') || msg.includes('context_length_exceeded')
-        || msg.includes('Context limit')) {
+    if (msg.includes('CONTEXT_COMPACT_FAILED') || isContextTooLongText(msg)) {
         return `${warnPrefix}上下文过长，自动压缩失败，请手动输入 /compact 重试`;
     }
     if (msg.includes('401') || msg.includes('authentication_error')) {