evolclaw 3.1.10 → 3.2.0

package/dist/index.js

@@ -3,7 +3,8 @@ import { CodexSessionFileAdapter } from './core/session/adapters/codex-session-f
 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 { loadDefaults, autoMigrateIfNeeded, migrateIdentitiesIfNeeded, migrateProcessConfigIfNeeded } from './config-store.js';
+import { loadEvolclawConfig } from './evolclaw-config.js';
 import { CONFIG_SCHEMA_VERSION } from './types.js';
 import dotenv from 'dotenv';
 import { SessionManager } from './core/session/session-manager.js';
@@ -12,7 +13,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';
@@ -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 暂跳过
@@ -584,6 +595,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);
@@ -675,6 +699,27 @@ async function main() {
             timestamp: Date.now()
         });
     }
+    // ── 控制 AID（daemon 进程身份）：pureIdentity 接入 AUN，独立于 evolagent ──
+    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}`);
+        }
+    }
     // 上线通知：延迟 1-3 秒后向 owner 发送上线消息（带 name + 工作目录）
     // 需在配置中 debug.upmsg: true 手动开启
     setTimeout(() => {
@@ -882,6 +927,9 @@ 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
@@ -1036,6 +1084,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/cache/file-cache.js';
 const isWindows = process.platform === 'win32';
 const isNamedPipe = (p) => isWindows && p.startsWith('\\\\.\\pipe\\');
 export class IpcServer {
@@ -102,6 +103,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' };

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/media-cache.js

@@ -85,7 +85,14 @@ export async function validateImage(buffer, opts) {
     }
     // 动态导入 image-type（ESM only）
     const { default: imageType } = await import('image-type');
-    const type = await imageType(buffer);
+    // image-type 对极短/截断的 buffer 会抛 EndOfStreamError，捕获后按「无法识别」处理。
+    let type;
+    try {
+        type = await imageType(buffer);
+    }
+    catch (e) {
+        return { mime: null, reason: `Image type detection error: ${e.message}` };
+    }
     if (!type) {
         return { mime: null, reason: 'Unable to detect image type' };
     }
@@ -94,6 +101,38 @@ export async function validateImage(buffer, opts) {
     }
     return { mime: type.mime };
 }
+/**
+ * 把已下载的附件 Buffer 转成入站图片条目（供 baseagent 视觉通道）。
+ *
+ * 适用于所有「需要先下载再注入」的通道（AUN ticket 下载、未来其它 CDN 下载等）。
+ * 飞书/微信已有各自的 SDK 下载路径，可按需复用本函数统一 MIME 判定。
+ *
+ * 判定优先级：
+ *   1. magic bytes（image-type 库，最可靠，同时做大小/白名单校验）
+ *   2. 元数据 MIME 字段（att.content_type / mime_type / mimeType）
+ *   3. 文件名后缀
+ *
+ * @returns 是图片返回 InboundImage；非图片或校验失败返回 null。
+ */
+export async function bufferToInboundImage(buffer, hints) {
+    // 1. magic bytes（含大小 + 白名单校验；validateImage 已吞掉 image-type 的异常）
+    const validated = await validateImage(buffer);
+    if (validated.mime) {
+        return { data: buffer.toString('base64'), mimeType: validated.mime };
+    }
+    // 2/3. magic bytes 未识别时，回退到元数据字段 / 文件名后缀
+    //      （仍受 image 白名单约束，避免把任意文件当图片注入）
+    const metaCt = hints?.contentType || hints?.mimeType || '';
+    const byMeta = typeof metaCt === 'string' && ALLOWED_IMAGE_MIMES.has(metaCt) ? metaCt : '';
+    const byExt = hints?.filename
+        ? (ALLOWED_IMAGE_MIMES.has(guessMime(hints.filename)) ? guessMime(hints.filename) : '')
+        : '';
+    const fallback = byMeta || byExt;
+    if (fallback && buffer.length > 0 && buffer.length <= DEFAULT_MAX_IMAGE_SIZE) {
+        return { data: buffer.toString('base64'), mimeType: fallback };
+    }
+    return null;
+}
 /**
  * 保存 Buffer 到 uploads 目录
  * - 自动创建目录

package/dist/utils/npm-ops.js

@@ -15,10 +15,20 @@ import { isWindows } from './cross-platform.js';
 const execFileAsync = promisify(execFile);
 // ── npm install -g (shared) ────────────────────────────────────────────────
 export async function npmInstallGlobal(pkg) {
-    const npmCmd = isWindows ? 'npm.cmd' : 'npm';
-    const execOpts = { timeout: 180000, shell: isWindows };
+    let cmd;
+    let args;
+    // Windows: run via cmd /c to avoid shell:true deprecation warning on Node 22.
+    // Unix: npm directly, no shell needed.
+    if (isWindows) {
+        cmd = 'cmd';
+        args = ['/c', 'npm', 'install', '-g', pkg];
+    }
+    else {
+        cmd = 'npm';
+        args = ['install', '-g', pkg];
+    }
     try {
-        await execFileAsync(npmCmd, ['install', '-g', pkg], execOpts);
+        await execFileAsync(cmd, args, { timeout: 180000 });
     }
     catch (e) {
         if (e.stderr?.includes('EACCES') || e.message?.includes('EACCES')) {

package/kits/templates/message-fragments/item.md

@@ -1,2 +1,2 @@
-‹{{now}}{{?chatType=group}} · {{peerName}}{{/}}{{?sameDevice}} · 📍同设备{{/}}{{?sameNetwork}} · 🌐同网络{{/}}{{?sameEgressIp}} · 🔀同出口IP{{/}}›
+‹{{now}} · from:{{peerId}}{{?peerName}}({{peerName}}){{/}}{{?chatType=group}} → 群:{{groupLabel}} · self:{{selfAid}}{{/}}{{?chatType=private}} → self:{{selfAid}}{{/}}{{?sameDevice}} · 📍同设备{{/}}{{?sameNetwork}} · 🌐同网络{{/}}{{?sameEgressIp}} · 🔀同出口IP{{/}}{{?mentionAids}} · @:{{mentionAids}}{{/}}›
 {{content}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolclaw",
-  "version": "3.1.10",
+  "version": "3.2.0",
   "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",