evolclaw 3.1.11 → 3.3.0

package/dist/index.js

@@ -2,8 +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 } from './config-store.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';
@@ -12,7 +12,7 @@ import { CodexAgentPlugin } from './agents/codex-runner.js';
 import { GeminiAgentPlugin } from './agents/gemini-runner.js';
 import { FeishuChannelPlugin } from './channels/feishu.js';
 import { WechatChannelPlugin } from './channels/wechat.js';
-import { AUNChannelPlugin } from './channels/aun.js';
+import { AUNChannel, AUNChannelPlugin } from './channels/aun.js';
 import { DingtalkChannelPlugin } from './channels/dingtalk.js';
 import { QQBotChannelPlugin } from './channels/qqbot.js';
 import { WecomChannelPlugin } from './channels/wecom.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 } from './core/command-handler.js';
+import { CommandHandler, isProcessLevelOwner } from './core/command-handler.js';
 import { EventBus } from './core/event-bus.js';
 import { StatsCollector } from './utils/stats.js';
 import { AidStatsCollector } from './utils/stats.js';
@@ -32,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';
@@ -216,6 +217,9 @@ async function main() {
     // ── 自动迁移 ──
     migrateIdentitiesIfNeeded();
     autoMigrateIfNeeded();
+    // config.json（ProcessConfig）→ evolclaw.json：必须在任何 getAidStore（AUN 连接）之前，
+    // 否则首次读 encryptionSeed 时迁移还没发生。
+    migrateProcessConfigIfNeeded();
     // ── ECK 运行时初始化 ──
     initEck();
     // 加载 ECK manifest + 清理旧调试文件
@@ -223,6 +227,13 @@ async function main() {
     loadKitManifest();
     // 加载配置（新结构：defaults.json + per-agent config.json）
     const defaults = loadDefaults() ?? { $schema_version: CONFIG_SCHEMA_VERSION };
+    const evolclawCfg = loadEvolclawConfig();
+    // 进程级 menu 操作（/system /agent）鉴权：owners 来自 evolclaw.json 顶层。
+    // owners 为空时这些操作一律 FORBIDDEN，启动时提示如何配置。
+    if (!evolclawCfg.owners || evolclawCfg.owners.length === 0) {
+        logger.warn('[startup] evolclaw.json.owners 未配置：进程级 menu 操作（/system /agent）将一律拒绝。' +
+            '如需远程管理，请在 evolclaw.json 配置 owners: [<你的 AID>]');
+    }
     // 应用配置中的日志级别（优先于环境变量）
     // logLevel 现在不在新结构中——若要保留，将来可加 defaults.debug.logLevel
     // 阶段 2c 暂跳过
@@ -305,6 +316,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
@@ -438,7 +483,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);
         }
     });
@@ -486,6 +531,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)) {
@@ -498,12 +554,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'));
@@ -512,6 +568,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.
@@ -584,6 +675,19 @@ async function main() {
         if (inst.registerHooks) {
             inst.registerHooks({ eventBus, sessionManager });
         }
+        // 4c. 观察者模式配置读取器（AUN）：从 EvolAgent 的 merged config 读 observable/owners，
+        // 不另建缓存——EvolAgent 那份在启动/重启/热重载时统一更新，是唯一真相源。
+        const channelForObserver = inst.channel;
+        if (typeof channelForObserver.setObserverConfigResolver === 'function') {
+            const channelKey = inst.adapter.channelKey;
+            channelForObserver.setObserverConfigResolver(() => {
+                const owningAgent = agentRegistry.resolveByChannel(channelKey);
+                return {
+                    observable: owningAgent?.getObservable() ?? false,
+                    owners: owningAgent?.config.owners ?? [],
+                };
+            });
+        }
         // 5. 撤回消息 → 中断执行中任务
         inst.channel.onRecall?.((messageId) => {
             msgBridge.cancel(messageId);
@@ -627,6 +731,7 @@ async function main() {
                     createdByPeerId: '__system__',
                     createdByChannel: '__system__',
                     fireCount: 0,
+                    failCount: 0,
                     createdAt: Date.now(),
                     updatedAt: Date.now(),
                 };
@@ -675,6 +780,67 @@ async function main() {
             timestamp: Date.now()
         });
     }
+    // ── 控制 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({
+            aid: evolclawCfg.aid,
+            agentName: evolclawCfg.aid,
+            channelName: 'control',
+            pureIdentity: true,
+            aunTrace: evolclawCfg.debug?.aunTrace ?? defaults.debug?.aunTrace,
+            aunSdkLog: evolclawCfg.debug?.aunSdkLog ?? defaults.debug?.aunSdkLog,
+        });
+        // connect() 失败不置空实例：AUNChannel 内部有无限重连（SDK auto_reconnect +
+        // scheduleReconnect），首连失败后台会自愈；保留实例供 status 显示 disconnected。
+        try {
+            await controlChannel.connect();
+            logger.info(`✓ 控制 AID 已连接: ${evolclawCfg.aid}`);
+        }
+        catch (e) {
+            logger.warn(`控制 AID 首连失败（后台自动重连，不影响 daemon 主流程）: ${e?.message || e}`);
+        }
+        // 控制 AID 接收 owner 指令：本轮只做 ECWeb 登录入口（/pair 取配对码）。
+        // 发送方身份由 AUN X.509 证书链验证，非 owner 完全静默。daemon 直接处理，
+        // 不转回 ecweb——仅「配对码是 ecweb 持有的状态」需经 localhost 取一次。
+        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;
+                }
+                // owner 发的其他内容：提示可用指令，避免无响应让 owner 困惑
+                await controlChannel.sendMessage(opts.channelId, '可用指令：/pair（获取 ECWeb 登录配对码）');
+            }
+            catch (e) {
+                logger.warn(`控制 AID 消息处理失败: ${e?.message || e}`);
+            }
+        });
+    }
     // 上线通知：延迟 1-3 秒后向 owner 发送上线消息（带 name + 工作目录）
     // 需在配置中 debug.upmsg: true 手动开启
     setTimeout(() => {
@@ -882,10 +1048,14 @@ async function main() {
                 errors: snap.lastHour.errors,
                 avgResponseMs: snap.lastHour.avgResponseMs,
             },
+            controlAid: evolclawCfg.aid
+                ? { aid: evolclawCfg.aid, connected: controlChannel?.getAidState().status === 'connected' }
+                : undefined,
         };
     }, 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 = [];
@@ -1036,6 +1206,13 @@ async function main() {
             const type = inst.channelType || inst.adapter.channelName;
             eventBus.publish({ type: 'channel:disconnected', channel: type, channelName: inst.adapter.channelName, reason: 'shutdown' });
         }
+        // 断开控制 AID（daemon 进程身份）
+        if (controlChannel) {
+            try {
+                await controlChannel.disconnect();
+            }
+            catch { /* ignore */ }
+        }
         sessionManager.close();
         removeAll();
         logger.info('✓ Shutdown complete');

package/dist/ipc.js

@@ -1,6 +1,7 @@
 import net from 'net';
 import fs from 'fs';
 import { logger } from './utils/logger.js';
+import { fileCache } from './core/daemon-file-cache.js';
 const isWindows = process.platform === 'win32';
 const isNamedPipe = (p) => isWindows && p.startsWith('\\\\.\\pipe\\');
 export class IpcServer {
@@ -12,6 +13,7 @@ export class IpcServer {
     aunAidProvider;
     aunAidStatsProvider;
     aunAidStatsRecorder;
+    menuExecutor;
     constructor(socketPath, getStatus, commandExecutor) {
         this.socketPath = socketPath;
         this.getStatus = getStatus;
@@ -21,6 +23,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;
@@ -102,6 +108,11 @@ export class IpcServer {
                 const stats = this.aunAidStatsProvider ? this.aunAidStatsProvider() : [];
                 return { ok: true, stats };
             }
+            case 'cache-stats': {
+                // daemon 统一 FileCache 的只读运行统计（watch web Cache 页用）。
+                // 直接读单例，无需 provider 注入（与 manifest-engine 等 import 单例同款）。
+                return { ok: true, stats: fileCache.stats() };
+            }
             case 'aun-aid-stats-record-outbound': {
                 if (!this.aunAidStatsRecorder)
                     return { ok: false, error: 'recorder not configured' };
@@ -200,6 +211,17 @@ 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) };
+                }
+            }
             default:
                 return { error: `unknown command: ${cmd.type}` };
         }

package/dist/paths.js

@@ -38,7 +38,8 @@ export function resolvePaths() {
         socket: resolveInstanceSocketPath(root),
         // ── 新结构（evolclaw-directory-design.md）────────────────
         defaultsConfig: path.join(root, 'agents', 'defaults.json'),
-        processConfig: path.join(root, 'config.json'),
+        processConfig: path.join(root, 'config.json'), // legacy ProcessConfig path — only for migration source
+        evolclawJson: path.join(root, 'evolclaw.json'),
         eckDir: path.join(root, 'eck'),
         instanceReadySignal: path.join(root, 'data', 'instance', 'ready.signal'),
         instanceSocket: resolveInstanceSocketPath(root),
@@ -182,14 +183,17 @@ function migrateFromAun() {
     catch { }
 }
 /**
- * 首次运行时从 assets/ 模板拷贝 config.json 和 .env 到 $EVOLCLAW_HOME。
+ * 首次运行时从 assets/ 模板拷贝 .env 到 $EVOLCLAW_HOME。
  * 已存在则跳过，不覆盖用户修改。
+ *
+ * 注：config.json（旧 ProcessConfig）已废弃——不再 seed，否则会与
+ * migrateProcessConfigIfNeeded 的归档形成每次启动重建+重迁移的循环。
+ * 进程级配置统一走 evolclaw.json。
  */
 function seedConfigTemplates() {
     const root = resolveRoot();
     const assetsDir = path.join(getPackageRoot(), 'assets');
     const templates = [
-        { src: 'config.json.template', dst: 'config.json' },
         { src: '.env.template', dst: '.env' },
     ];
     for (const { src, dst } of templates) {

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.

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/stats.js

@@ -104,6 +104,8 @@ export class AidStatsCollector {
     queueStatsProvider;
     /** sessionId → 当前正在跑该 session 的 agent，task:started 写入，task:completed/error 清除 */
     sessionToAgent = new Map();
+    /** 外部注入的持久化回调（写入 message_events 表） */
+    onMessage;
     constructor(eventBus) {
         if (!eventBus)
             return;
@@ -342,6 +344,12 @@ export class AidStatsCollector {
         }
         entry.bytesReceived += byteLength;
         entry.uniquePeers.add(fromPeer);
+        // 持久化
+        this.onMessage?.({
+            ts: Date.now(), agent_aid: aid, peer_key: `aun#${fromPeer}`,
+            direction: 'in', msg_type: isSystem ? 'system' : 'private',
+            bytes: byteLength, encrypted: encrypt, chatmode,
+        });
     }
     recordOutbound(aid, toPeer, byteLength, text, isSystem = false, encrypt, chatmode) {
         const entry = this.getOrCreate(aid);
@@ -369,6 +377,12 @@ export class AidStatsCollector {
         }
         entry.bytesSent += byteLength;
         entry.uniquePeers.add(toPeer);
+        // 持久化
+        this.onMessage?.({
+            ts: Date.now(), agent_aid: aid, peer_key: `aun#${toPeer}`,
+            direction: 'out', msg_type: isSystem ? 'system' : 'private',
+            bytes: byteLength, encrypted: encrypt, chatmode,
+        });
     }
     getAllSnapshots() {
         const out = [];

package/kits/docs/evolclaw/INDEX.md

@@ -14,7 +14,8 @@
 | `ec msg` | 私聊收发消息 | 回复/发消息/拉取/撤回/查在线 | 有对端（peerId） | `msg.md` |
 | `ec group` | 群聊收发与群管理 | 群发/建群/邀请/踢人/退群/群成员 | 群聊（groupId） | `group.md` |
 | `ec aid` | AID 身份管理 | 身份/证书/名片/探测对端 | 任意有渠道场景 | `aid.md` |
-| `ec storage` | 文件存储 | 上传/下载/配额 | 任意有渠道场景 | `storage.md` |
+| `ec fs` | 网络文件系统（统一前端） | 上传/下载/看文件/列目录/分享/共享/挂载/配额 | 任意有渠道场景 | `fs.md`（架构全景 `fs-architecture.md`） |
+| `ec storage` | 文件存储（底层调试） | 上传/下载/配额 | 任意有渠道场景 | `storage.md` |
 | `ec agent` | EvolAgent 生命周期 | 创建/启停/热重载/改配置 | 管理员（owner/admin） | `agent.md` |
 | `ec rpc` | 底层 AUN RPC（逃生通道） | 直接调协议方法 | 高级/兜底 | `rpc.md` |
 
@@ -29,6 +30,7 @@
 | 命令集 | 用途 | 触发词 | 文档 |
 |--------|------|--------|------|
 | `ec model` | 模型管理（按作用域持久化） | 切模型/列模型/看当前/改强度 | `model.md` |
+| `ec stats` | Token 用量与费用统计 | 用量/费用/统计/预算/token/cost | `stats.md` |
 
 ## 开发者工具（非 agent 会话能力）