evolclaw 3.3.0 → 3.4.0

package/dist/core/permission.js

@@ -143,6 +143,12 @@ export function summarizeToolInput(toolName, input) {
 /** 为 Edit 工具生成 diff 风格摘要 */
 function formatEditSummary(input) {
     const filePath = input.file_path || '';
+    const protocolDiff = typeof input.unified_diff === 'string' ? input.unified_diff
+        : typeof input.unifiedDiff === 'string' ? input.unifiedDiff
+            : typeof input.diff === 'string' ? input.diff
+                : '';
+    if (protocolDiff)
+        return formatProtocolDiffSummary(filePath, protocolDiff);
     const oldStr = typeof input.old_string === 'string' ? input.old_string : '';
     const newStr = typeof input.new_string === 'string' ? input.new_string : '';
     if (!oldStr && !newStr)
@@ -215,6 +221,16 @@ function formatEditSummary(input) {
     }
     return `${filePath}\n\`\`\`\n${diffLines.join('\n')}\n\`\`\``;
 }
+/** 展示 runner/协议已返回的 unified diff；不在 EvolClaw 内重新计算 diff。 */
+function formatProtocolDiffSummary(filePath, diff) {
+    const MAX_DIFF_LINES = 32;
+    const lines = diff.trimEnd().split('\n');
+    const displayLines = lines.length > MAX_DIFF_LINES
+        ? [...lines.slice(0, MAX_DIFF_LINES), `...(省略 ${lines.length - MAX_DIFF_LINES} 行)`]
+        : lines;
+    const body = displayLines.join('\n');
+    return `${filePath}\n\`\`\`diff\n${body}\n\`\`\``;
+}
 export class PermissionGateway {
     pending = new Map();
     eventBus;

package/dist/core/session/session-manager.js

@@ -5,6 +5,7 @@ import { encodePath } from '../../utils/cross-platform.js';
 import { chatDirPath, generateSessionId, formatTimestamp, atomicWriteJson, appendJsonl, readJsonFile, readLastJsonlLine, readAllJsonlLines, scanChatDirs, scanMetaFiles, ensureChatDir, readThreadIndex, writeThreadIndex, } from './session-fs-store.js';
 import { sessionToFile, fileToSession } from './session-mapper.js';
 import { formatSessionKey, DEFAULT_THREAD_ID } from './session-key.js';
+import { tryParseChannelKey } from '../channel-loader.js';
 import path from 'path';
 import fs from 'fs';
 import os from 'os';
@@ -110,6 +111,26 @@ export class SessionManager {
         }
         return chatDirPath(this.sessionsDir, session.channelType, session.channelId, session.selfAID);
     }
+    deriveChannelIdentity(channel, channelId) {
+        const parsed = tryParseChannelKey(channel);
+        if (parsed) {
+            return { channelType: parsed.type, selfAID: parsed.type === 'aun' ? parsed.selfAID : '' };
+        }
+        const existingDir = this.findExistingChatDir(channel, channelId);
+        if (existingDir) {
+            const active = readJsonFile(path.join(existingDir, 'active.json'));
+            if (active) {
+                return { channelType: active.channelType || channel, selfAID: active.selfAID || '' };
+            }
+            for (const metaFile of scanMetaFiles(existingDir)) {
+                const meta = readLastJsonlLine(path.join(existingDir, metaFile));
+                if (meta) {
+                    return { channelType: meta.channelType || channel, selfAID: meta.selfAID || '' };
+                }
+            }
+        }
+        return { channelType: channel, selfAID: '' };
+    }
     /** Public accessor: get the chat directory path for a session (for message log etc.) */
     getChatDir(session) {
         return this.resolveChatDirFromSession(session);
@@ -127,6 +148,30 @@ export class SessionManager {
      * 用于不知道 channelType/selfAID 的 caller 在调用 resolveChatDir 前定位已有目录。
      */
     findExistingChatDir(channel, channelId) {
+        const parsed = tryParseChannelKey(channel);
+        if (parsed) {
+            const exactDir = this.resolveChatDir(channel, channelId, parsed.type, parsed.type === 'aun' ? parsed.selfAID : undefined);
+            const active = readJsonFile(path.join(exactDir, 'active.json'));
+            if (active && active.channel === channel)
+                return exactDir;
+            for (const mf of scanMetaFiles(exactDir)) {
+                const meta = readLastJsonlLine(path.join(exactDir, mf));
+                if (meta && meta.channel === channel)
+                    return exactDir;
+            }
+            const threadsDir = path.join(exactDir, '_threads');
+            if (fs.existsSync(threadsDir)) {
+                const threadMetas = scanMetaFiles(threadsDir);
+                for (const mf of threadMetas) {
+                    const meta = readLastJsonlLine(path.join(threadsDir, mf));
+                    if (meta && meta.channel === channel)
+                        return exactDir;
+                }
+            }
+            if (fs.existsSync(exactDir))
+                return exactDir;
+            return undefined;
+        }
         const dirs = scanChatDirs(this.sessionsDir);
         for (const d of dirs) {
             if (d.channelId !== channelId)
@@ -686,7 +731,8 @@ export class SessionManager {
         const agentId = currentAgentId || 'claude';
         logger.info(`[SessionManager] switchProject: channel=${channel} channelId=${channelId} newPath=${newProjectPath} agent=${agentId}`);
         const inheritedChatType = this.getActiveChatType(channel, channelId);
-        const chatDir = this.ensureResolvedChatDirSafe(channel, channelId);
+        const identity = this.deriveChannelIdentity(channel, channelId);
+        const chatDir = this.ensureResolvedChatDir(channel, channelId, identity.channelType, identity.selfAID);
         const allSessions = this.findAllSessionsInChat(chatDir, false);
         const target = allSessions
             .filter(s => s.projectPath === newProjectPath && (s.agentId || 'claude') === agentId && !s.threadId)
@@ -699,8 +745,8 @@ export class SessionManager {
         }
         // Derive selfAID and channelType from existing sessions in this chatDir
         const existingAny = allSessions[0];
-        const selfAID = existingAny?.selfAID || '';
-        const channelType = existingAny?.channelType || channel;
+        const selfAID = existingAny?.selfAID || identity.selfAID;
+        const channelType = existingAny?.channelType || identity.channelType;
         const session = {
             id: generateSessionId(),
             channel,
@@ -750,12 +796,10 @@ export class SessionManager {
     }
     async switchAgent(channel, channelId, projectPath, newAgentId) {
         const inheritedChatType = this.getActiveChatType(channel, channelId);
-        // Derive channelType/selfAID from existing sessions; fall back to channel name
-        const probeChatDir = this.resolveChatDir(channel, channelId, channel, '');
-        const probeSessions = fs.existsSync(probeChatDir) ? this.findAllSessionsInChat(probeChatDir, false) : [];
-        const existingAny = probeSessions[0];
-        const channelType = existingAny?.channelType || channel;
-        const selfAID = existingAny?.selfAID || '';
+        const identity = this.deriveChannelIdentity(channel, channelId);
+        // Derive channelType/selfAID from existing sessions; fall back to parsed channel key.
+        const channelType = identity.channelType;
+        const selfAID = identity.selfAID;
         const chatDir = this.ensureResolvedChatDir(channel, channelId, channelType, selfAID);
         const allSessions = this.findAllSessionsInChat(chatDir, false);
         const target = allSessions
@@ -1030,8 +1074,9 @@ export class SessionManager {
         const inheritedChatType = this.getActiveChatType(channel, channelId);
         // Derive selfAID and channelType from existing sessions
         const existingDir = this.findExistingChatDir(channel, channelId);
-        let channelType = channel;
-        let selfAID = '';
+        const identity = this.deriveChannelIdentity(channel, channelId);
+        let channelType = identity.channelType;
+        let selfAID = identity.selfAID;
         let inheritedRole = 'guest';
         if (existingDir) {
             const active = readJsonFile(path.join(existingDir, 'active.json'));
@@ -1160,8 +1205,9 @@ export class SessionManager {
         const name = fileInfo.title || `CLI会话-${new Date().toLocaleString('zh-CN', { month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit' })}`;
         // Derive selfAID and channelType from existing sessions
         const existingDir = this.findExistingChatDir(channel, channelId);
-        let channelType = channel;
-        let selfAID = '';
+        const identity = this.deriveChannelIdentity(channel, channelId);
+        let channelType = identity.channelType;
+        let selfAID = identity.selfAID;
         if (existingDir) {
             const active = readJsonFile(path.join(existingDir, 'active.json'));
             if (active) {

package/dist/core/stats/db.js

@@ -176,6 +176,9 @@ function _initTables(db) {
       output_tokens         INTEGER NOT NULL DEFAULT 0,
       cache_creation_tokens INTEGER NOT NULL DEFAULT 0,
       cache_read_tokens     INTEGER NOT NULL DEFAULT 0,
+      context_tokens        INTEGER,
+      max_tokens            INTEGER,
+      auto_compact_tokens   INTEGER,
       degraded      INTEGER NOT NULL DEFAULT 0
     );
     CREATE INDEX IF NOT EXISTS idx_mc_task        ON model_calls(task_id);
@@ -194,6 +197,23 @@ function _initTables(db) {
     catch (e) {
         logger.warn(`[StatsDB] usage_daily peer_type 迁移检测失败: ${e}`);
     }
+    // 轻量迁移：model_calls 早期只记录 usage 原始 token，task.start 自动压缩需要
+    // 使用上轮真实 context/max/compact window，避免按模型名猜窗口。
+    try {
+        const cols = db.prepare(`PRAGMA table_info(model_calls)`).all();
+        if (!cols.some(c => c.name === 'context_tokens')) {
+            db.exec(`ALTER TABLE model_calls ADD COLUMN context_tokens INTEGER`);
+        }
+        if (!cols.some(c => c.name === 'max_tokens')) {
+            db.exec(`ALTER TABLE model_calls ADD COLUMN max_tokens INTEGER`);
+        }
+        if (!cols.some(c => c.name === 'auto_compact_tokens')) {
+            db.exec(`ALTER TABLE model_calls ADD COLUMN auto_compact_tokens INTEGER`);
+        }
+    }
+    catch (e) {
+        logger.warn(`[StatsDB] model_calls context window 迁移检测失败: ${e}`);
+    }
 }
 /**
  * 全量重建 usage_daily：从 usage_events 明细按天聚合重算。

package/dist/core/stats/writer.js

@@ -96,12 +96,12 @@ export function insertModelCalls(evolclawHome, rows) {
       INSERT INTO model_calls
         (ts, task_id, session_id, agent_session_id, agent_aid, peer_key, call_index, model,
          request_id, message_id, input_tokens, output_tokens, cache_creation_tokens,
-         cache_read_tokens, degraded)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+         cache_read_tokens, context_tokens, max_tokens, auto_compact_tokens, degraded)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     `);
         db.exec('BEGIN');
         for (const r of rows) {
-            stmt.run(r.ts, r.task_id, r.session_id ?? null, r.agent_session_id ?? null, r.agent_aid, r.peer_key, r.call_index, r.model, r.request_id ?? null, r.message_id ?? null, r.input_tokens, r.output_tokens, r.cache_creation_tokens, r.cache_read_tokens, r.degraded);
+            stmt.run(r.ts, r.task_id, r.session_id ?? null, r.agent_session_id ?? null, r.agent_aid, r.peer_key, r.call_index, r.model, r.request_id ?? null, r.message_id ?? null, r.input_tokens, r.output_tokens, r.cache_creation_tokens, r.cache_read_tokens, r.context_tokens ?? null, r.max_tokens ?? null, r.auto_compact_tokens ?? null, r.degraded);
         }
         db.exec('COMMIT');
     }

package/dist/data/error-dict.json

@@ -95,6 +95,13 @@
       "type": "api_error",
       "message": "⚠️ API 返回异常响应，正在重试..."
     },
+    {
+      "id": "json-parse-error",
+      "match": "json parse error",
+      "action": "retry",
+      "type": "api_error",
+      "message": "⚠️ API 返回 JSON 解析异常，正在重试..."
+    },
     {
       "id": "feishu-permission",
       "match": "im:resource",

package/dist/index.js

@@ -20,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, isProcessLevelOwner } 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';
@@ -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':
@@ -809,9 +816,10 @@ async function main() {
         catch (e) {
             logger.warn(`控制 AID 首连失败（后台自动重连，不影响 daemon 主流程）: ${e?.message || e}`);
         }
-        // 控制 AID 接收 owner 指令：本轮只做 ECWeb 登录入口（/pair 取配对码）。
-        // 发送方身份由 AUN X.509 证书链验证，非 owner 完全静默。daemon 直接处理，
-        // 不转回 ecweb——仅「配对码是 ecweb 持有的状态」需经 localhost 取一次。
+        // 控制 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)) {
@@ -833,7 +841,20 @@ async function main() {
                     await controlChannel.sendMessage(opts.channelId, reply);
                     return;
                 }
-                // owner 发的其他内容：提示可用指令，避免无响应让 owner 困惑
+                // 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) {
@@ -1085,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)
@@ -1108,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);
         }
@@ -1184,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 要监控；
     // 显式触发更可控。
@@ -1195,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,5 +1,6 @@
 import net from 'net';
 import fs from 'fs';
+import os from 'os';
 import { logger } from './utils/logger.js';
 import { fileCache } from './core/daemon-file-cache.js';
 const isWindows = process.platform === 'win32';
@@ -14,6 +15,17 @@ export class IpcServer {
     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;
@@ -39,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)) {
@@ -222,6 +280,47 @@ export class IpcServer {
                     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

@@ -85,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/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')) {