evolclaw 2.6.0 → 2.6.2

package/dist/channels/aun.js

@@ -1,4 +1,4 @@
-import { AUNClient, GatewayDiscovery } from '@agentunion/aun-node';
+import { AUNClient, GatewayDiscovery } from '@agentunion/fastaun';
 import crypto from 'crypto';
 import fs from 'fs';
 import path from 'path';
@@ -58,9 +58,16 @@ export class AUNChannel {
         const logPath = path.join(resolvePaths().logs, `aun-${today}.log`);
         this.traceStream = fs.createWriteStream(logPath, { flags: 'a' });
     }
-    /** 判断 channelId 是否为群组 ID（g-xxx.agentid.pub 或 grp_ 前缀） */
+    /** 判断 channelId 是否为群组 ID
+     *  - 新格式：group.{issuer}/{group_no|group_name}
+     *  - 数字群号：{group_no}.{issuer}（如 11117.agentid.pub）
+     *  - 兼容旧格式：grp_xxx、g-xxx.agentid.pub
+     */
     isGroupId(id) {
-        return id.startsWith('grp_') || (id.startsWith('g-') && id.includes('.'));
+        return (id.startsWith('group.') && id.includes('/'))
+            || /^\d+\./.test(id)
+            || id.startsWith('grp_')
+            || (id.startsWith('g-') && id.includes('.'));
     }
     getShortAid(aid) {
         if (!aid)
@@ -114,6 +121,7 @@ export class AUNChannel {
             this.messageSeqMap.delete(messageId);
     }
     _aid;
+    _selfName; // 本地 agent.md 中的 name，首次 connect 时读取
     _chatId = ''; // aid:device_id:slot_id — 多实例回声过滤
     seenMessages = new Map();
     peerInfoCache = new Map();
@@ -262,6 +270,7 @@ export class AUNChannel {
             this._aid = this.client.aid ?? undefined;
             const deviceId = this.client._device_id ?? '';
             this._chatId = this._aid ? `${this._aid}:${deviceId}:` : '';
+            this._selfName = this.loadSelfName(aidName);
             this.connected = true;
             this.reconnectAttempt = 0;
             // Workaround: SDK e2ee uses _identity.cert for sender_cert_fingerprint;
@@ -317,7 +326,8 @@ export class AUNChannel {
             if (ownerInfo.type !== null && ownerInfo.type !== 'human') {
                 logger.warn(`[AUN] Owner ${owner} type is "${ownerInfo.type}" (not human). Consider using a human AID as owner.`);
             }
-            // Name: owner agent.md name (first 12 chars) → fallback to owner AID first label (first 12 chars)
+            // Name: prefer existing agent.md name if user has customized it,
+            // otherwise generate "{ownerName}的Evol助手 ({aidLabel})" for disambiguation
             const ownerAidClean = owner.startsWith('@') ? owner.slice(1) : owner;
             let ownerDisplayName;
             if (ownerInfo.name) {
@@ -326,7 +336,18 @@ export class AUNChannel {
             else {
                 ownerDisplayName = ownerAidClean.split('.')[0].slice(0, 12);
             }
-            const agentDisplayName = `${ownerDisplayName}的Evol助手`;
+            // Check if init wrote a meaningful name (vs just the aid first label default)
+            const currentNameMatch = frontmatter.match(/^name:\s*"?([^"\n]+)/m);
+            const currentName = currentNameMatch?.[1]?.trim();
+            const aidLabel = aidName.split('.')[0];
+            let agentDisplayName;
+            if (currentName && currentName !== aidLabel) {
+                // User or previous init set a custom name — keep it
+                agentDisplayName = currentName;
+            }
+            else {
+                agentDisplayName = `${ownerDisplayName}的Evol助手 (${aidLabel})`;
+            }
             // Generate new agent.md with proper fields
             const newAgentMd = `---
 aid: "${aid}"
@@ -376,7 +397,21 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
 - 所有命令以 \`/\` 开头
 
 现在，请先使用 \`/bind\` 命令绑定您的项目目录，然后就可以开始工作了！`;
-            await this.sendMessage(owner, welcomeText);
+            // First contact with Owner races against Owner's async cert fetch from
+            // gateway PKI; a 3s pause lets the cert propagate. persist_required asks
+            // the gateway to durably store the message so Owner can recover it via
+            // pull if the initial E2EE push still arrives before the cert resolves.
+            await new Promise(resolve => setTimeout(resolve, 3000));
+            if (!this.client) {
+                logger.warn('[AUN] Client disconnected before welcome message could be sent');
+                return;
+            }
+            await this.client.call('message.send', {
+                to: owner,
+                payload: { type: 'text', text: welcomeText },
+                encrypt: true,
+                persist_required: true,
+            });
             logger.info(`[AUN] Welcome message sent to owner: ${owner}`);
         }
         catch (e) {
@@ -531,11 +566,14 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             this.acknowledgeImmediately(messageId, seq);
             return;
         }
+        // dispatch_mode from server tells agent how to work in this group
+        const dispatchMode = msg.dispatch_mode ?? payload?.dispatch_mode ?? 'mention';
         const mentionedSelf = this._aid
             ? (this.hasExplicitMention(text, this._aid) || payloadMentions.includes(this._aid))
             : false;
         const mentionedAll = this.hasExplicitMention(text, 'all') || payloadMentions.includes('all');
-        if (!mentionedSelf && !mentionedAll) {
+        // In mention mode, only respond when explicitly mentioned; in broadcast mode, respond to all
+        if (dispatchMode === 'mention' && !mentionedSelf && !mentionedAll) {
             this.acknowledgeImmediately(messageId, seq);
             return;
         }
@@ -550,7 +588,9 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             this.acknowledgeImmediately(messageId, seq);
             return;
         }
-        const mentions = mentionedAll ? ['all'] : (this._aid ? [this._aid] : []);
+        const mentions = mentionedAll
+            ? ['all']
+            : mentionedSelf && this._aid ? [this._aid] : [];
         // Process attachments
         let finalText = strippedText;
         if (hasAttachments && this.client) {
@@ -708,7 +748,8 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
         const payload = { type: 'text', text: finalText };
         if (context?.threadId)
             payload.thread_id = context.threadId;
-        const params = { payload, encrypt: true };
+        const isGroup = this.isGroupId(channelId);
+        const params = { payload, encrypt: !isGroup };
         // Multi-instance routing: channelId may be "aid:device_id:slot_id"
         const colonIdx = channelId.indexOf(':');
         const targetAid = colonIdx > 0 ? channelId.substring(0, colonIdx) : channelId;
@@ -716,7 +757,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             params.payload.chat_id = channelId;
         }
         try {
-            if (this.isGroupId(channelId)) {
+            if (isGroup) {
                 params.group_id = channelId;
                 this.trace('OUT', 'group.send', params);
                 await this.client.call('group.send', params);
@@ -732,6 +773,50 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             logger.error(`[AUN] Send failed to ${channelId}: ${e}`);
         }
     }
+    /**
+     * 发送 thought 内容（Proactive 模式可观测）
+     * 群聊：调用 group.thought.put
+     * 单聊：调用 message.thought.put
+     *
+     * selector 使用 context: { type: 'task', id: taskId }
+     * 存储键：group_id/peer_aid + sender_aid + context.type + context.id
+     */
+    async sendThought(channelId, taskId, payload) {
+        if (!this.connected || !this.client)
+            return;
+        if (!taskId)
+            return;
+        // Multi-instance routing
+        const colonIdx = channelId.indexOf(':');
+        const targetId = colonIdx > 0 ? channelId.substring(0, colonIdx) : channelId;
+        const params = {
+            context: { type: 'task', id: taskId },
+            payload,
+            encrypt: true,
+        };
+        try {
+            if (this.isGroupId(channelId)) {
+                params.group_id = targetId;
+                this.trace('OUT', 'group.thought.put', params);
+                await this.client.call('group.thought.put', params);
+            }
+            else {
+                params.to = targetId;
+                this.trace('OUT', 'message.thought.put', params);
+                await this.client.call('message.thought.put', params);
+            }
+        }
+        catch (e) {
+            const err = e;
+            this.trace('OUT', 'thought.put.error', {
+                channelId,
+                errorName: err?.name,
+                errorCode: err?.code,
+                errorMessage: err?.message,
+            });
+            logger.debug(`[AUN] thought.put failed to ${channelId}: ${err?.name}(${err?.code})=${err?.message}`);
+        }
+    }
     async sendFile(channelId, filePath, context) {
         if (!this.connected || !this.client) {
             logger.warn('[AUN] Cannot sendFile: not connected');
@@ -805,14 +890,15 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             };
             if (context?.threadId)
                 filePayload.thread_id = context.threadId;
-            const params = { payload: filePayload, encrypt: true };
+            const isGroup = this.isGroupId(channelId);
+            const params = { payload: filePayload, encrypt: !isGroup };
             // Multi-instance routing
             const fileColonIdx = channelId.indexOf(':');
             const fileTargetAid = fileColonIdx > 0 ? channelId.substring(0, fileColonIdx) : channelId;
             if (fileColonIdx > 0) {
                 params.payload.chat_id = channelId;
             }
-            if (this.isGroupId(channelId)) {
+            if (isGroup) {
                 params.group_id = channelId;
                 this.trace('OUT', 'group.send.file', params);
                 await this.client.call('group.send', params);
@@ -834,7 +920,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
         // to avoid duplicate "已送达" at the sender CLI
         this.messageSeqMap.delete(messageId);
     }
-    sendProcessingStatus(channelId, status, sessionId, context) {
+    sendProcessingStatus(channelId, status, sessionId, taskId, context) {
         if (status === 'start')
             this.sentCount.delete(channelId); // 新任务开始，重置计数
         if (!this.client || !this.connected)
@@ -849,19 +935,20 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
         const payload = {
             type: 'event',
             event: eventMap[status] ?? `task.${status}`,
-            data: { session_id: sessionId },
+            data: { task_id: taskId, session_id: sessionId },
             severity: status === 'error' || status === 'timeout' ? 'error' : 'info',
         };
         if (context?.threadId)
             payload.thread_id = context.threadId;
-        const params = { payload, encrypt: true };
+        const isGroup = this.isGroupId(channelId);
+        const params = { payload, encrypt: !isGroup };
         // Multi-instance routing
         const statusColonIdx = channelId.indexOf(':');
         const statusTargetAid = statusColonIdx > 0 ? channelId.substring(0, statusColonIdx) : channelId;
         if (statusColonIdx > 0) {
             payload.chat_id = channelId;
         }
-        if (this.isGroupId(channelId)) {
+        if (isGroup) {
             params.group_id = channelId;
             this.trace('OUT', 'group.send.status', params);
             this.client.call('group.send', params).catch(e => {
@@ -983,6 +1070,27 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             maxAttempts: AUNChannel.RECONNECT_DELAYS.length,
         };
     }
+    /** 读取本地 agent.md 中的 name（用于身份上下文展示） */
+    loadSelfName(aid) {
+        try {
+            const aidName = aid.startsWith('@') ? aid.slice(1) : aid;
+            const agentMdPath = path.join(os.homedir(), '.aun', 'AIDs', aidName, 'agent.md');
+            if (!fs.existsSync(agentMdPath))
+                return undefined;
+            const content = fs.readFileSync(agentMdPath, 'utf-8');
+            const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+            if (!fmMatch)
+                return undefined;
+            const nameMatch = fmMatch[1].match(/^name:\s*["']?(.+?)["']?\s*$/m);
+            return nameMatch?.[1]?.trim() || undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    getSelfName() {
+        return this._selfName;
+    }
     async fetchPeerInfo(aid) {
         const cached = this.peerInfoCache.get(aid);
         if (cached !== undefined)
@@ -1048,11 +1156,13 @@ export class AUNChannelPlugin {
                 sendText: (id, text, context) => channel.sendMessage(id, text, context),
                 sendFile: (id, filePath, context) => channel.sendFile(id, filePath, context),
                 acknowledge: (messageId) => { channel.acknowledge(messageId); return Promise.resolve(); },
-                sendProcessingStatus: (id, status, sessionId, context) => channel.sendProcessingStatus(id, status, sessionId, context),
+                sendProcessingStatus: (id, status, sessionId, taskId, context) => channel.sendProcessingStatus(id, status, sessionId, taskId, context),
                 sendCustomPayload: (id, payload) => channel.sendCustomPayload(id, payload),
                 uploadAgentMd: (content) => channel.uploadAgentMd(content),
                 downloadAgentMd: (aid) => channel.downloadAgentMd(aid),
+                putThought: (id, taskId, payload) => channel.sendThought(id, taskId, payload),
                 _selfAid: () => channel.getStatus().aid,
+                _selfName: () => channel.getSelfName(),
             };
             const policy = {
                 canSwitchProject: (chatType, identity) => identity === 'owner' || identity === 'admin',

package/dist/channels/feishu.js

@@ -499,11 +499,12 @@ export class FeishuChannel {
             return;
         try {
             // 检测是否为图片，是则走 sendImage（内联预览）而非文件卡片
-            const header = Buffer.alloc(12);
+            // 读取足够字节供 file-type 解析（ZIP-based 格式如 PPTX 需要更多字节）
+            const header = Buffer.alloc(4100);
             const fd = fs.openSync(filePath, 'r');
-            fs.readSync(fd, header, 0, 12, 0);
+            const bytesRead = fs.readSync(fd, header, 0, 4100, 0);
             fs.closeSync(fd);
-            const imgType = await imageType(header);
+            const imgType = await imageType(header.subarray(0, bytesRead)).catch(() => undefined);
             if (imgType) {
                 logger.info(`[Feishu] Detected image (${imgType.mime}), sending as inline image:`, filePath);
                 const buf = fs.readFileSync(filePath);

package/dist/cli.js

@@ -12,6 +12,7 @@ import { ipcQuery } from './ipc.js';
 import { cmdInitWechat, cmdInitFeishu, cmdInitAun, cmdInitDingtalk, cmdInitQQBot, cmdInitWecom } from './utils/init-channel.js';
 import * as platform from './utils/cross-platform.js';
 import { EventBus } from './core/event-bus.js';
+import { tryUpgrade } from './utils/upgrade.js';
 // Suppress Node.js ExperimentalWarning (e.g. SQLite) from cluttering CLI output
 process.removeAllListeners('warning');
 process.on('warning', (w) => { if (w.name === 'ExperimentalWarning')
@@ -372,6 +373,25 @@ async function cmdStop() {
 async function cmdRestart() {
     console.log('🔄 Restarting EvolClaw...');
     const p = resolvePaths();
+    // 版本检查与自动升级
+    console.log('📦 Checking for updates...');
+    const upgrade = await tryUpgrade();
+    switch (upgrade.status) {
+        case 'upgraded':
+            console.log(`✅ Upgraded: ${upgrade.from} → ${upgrade.to}`);
+            break;
+        case 'no-update':
+            console.log(`✓ Already up to date (${upgrade.from})`);
+            break;
+        case 'skipped':
+            console.log(upgrade.error
+                ? '⏭ Skipped upgrade (network unavailable)'
+                : '⏭ Skipped upgrade check (dev mode)');
+            break;
+        case 'failed':
+            console.log(`⚠ Upgrade failed (${upgrade.from} → ${upgrade.to}), continuing with current version`);
+            break;
+    }
     await stopAndWait(p.pid);
     setTimeout(() => cmdStart(), 1000);
 }
@@ -737,6 +757,27 @@ async function cmdRestartMonitor() {
         });
         await sleep(3000);
     }
+    // 版本检查与自动升级
+    log('Checking for updates...');
+    const upgrade = await tryUpgrade();
+    switch (upgrade.status) {
+        case 'upgraded':
+            log(`✅ Upgraded: ${upgrade.from} → ${upgrade.to}`);
+            await notifyChannel(p, pendingInfo, `📦 已升级 ${upgrade.from} → ${upgrade.to}`, log);
+            break;
+        case 'no-update':
+            log(`Already up to date (${upgrade.from})`);
+            break;
+        case 'skipped':
+            log(upgrade.error
+                ? 'Skipped upgrade (network unavailable)'
+                : 'Skipped upgrade check (dev mode)');
+            break;
+        case 'failed':
+            log(`⚠ Upgrade failed (${upgrade.from} → ${upgrade.to}): ${upgrade.error}`);
+            await notifyChannel(p, pendingInfo, `⚠️ 升级失败，使用当前版本继续`, log);
+            break;
+    }
     // 启动并检测 ready signal
     let started = await spawnAndWaitReady(p, log, READY_TIMEOUT);
     if (started) {
@@ -1244,14 +1285,43 @@ async function cmdDiagnose() {
 // ==================== Ctl ====================
 async function cmdCtl(args) {
     if (args.length === 0) {
-        console.error('用法: evolclaw ctl <command> [args...]');
-        console.error('示例: evolclaw ctl model sonnet');
-        console.error('      evolclaw ctl status');
-        console.error('      evolclaw ctl effort high');
-        console.error('      evolclaw ctl send "<消息内容>"   # proactive 模式主动发消息');
-        console.error('      evolclaw ctl chatmode proactive  # 切换会话模式');
+        console.error(`用法: evolclaw ctl <command> [args...]
+
+查询:
+  status                    查看会话状态
+  check                     检查渠道健康状态
+  help                      显示帮助
+
+配置:
+  model [model-id]          查看/切换模型（如 opus, sonnet, haiku）
+  effort [low|medium|high]  查看/切换推理强度
+  compact                   压缩当前会话上下文
+  chatmode [mode]           查看/切换会话模式
+  activity [all|dm|owner|none]  查看/控制中间输出显示模式
+  perm [mode]               查看/切换权限模式
+
+项目:
+  bind <path>               注册项目目录（不切换当前会话）
+
+消息:
+  send <消息内容>           主动发送文本消息（proactive 模式）
+  file [channel] <path>     发送项目内文件
+
+运维:
+  agentmd [put|set <内容>]  查看/管理 agent.md（仅 AUN 通道）
+  restart [channel]         重启服务或重连指定渠道
+
+示例:
+  evolclaw ctl model sonnet
+  evolclaw ctl effort high
+  evolclaw ctl compact
+  evolclaw ctl chatmode proactive`);
         process.exit(1);
     }
+    // help 不需要连接服务，直接复用无参数时的帮助输出
+    if (args[0] === 'help') {
+        return cmdCtl([]);
+    }
     const sessionId = process.env.EVOLCLAW_SESSION_ID;
     if (!sessionId) {
         console.error('错误: EVOLCLAW_SESSION_ID 未设置（仅在 evolclaw 托管环境中可用）');
@@ -1294,7 +1364,32 @@ export async function main(args) {
     }
     switch (cmd) {
         case 'init':
-            if (args[1] === 'wechat') {
+            if (args[1] === 'help') {
+                console.log(`用法: evolclaw init [渠道] [选项]
+
+交互式初始化:
+  evolclaw init               创建基础配置文件（交互式）
+  evolclaw init feishu        飞书扫码登录并写入配置
+  evolclaw init wechat        微信扫码登录并写入配置
+  evolclaw init dingtalk      钉钉扫码登录并写入配置
+  evolclaw init qqbot         QQ 机器人扫码绑定并写入配置
+  evolclaw init wecom         企业微信 AI Bot 配置（手动输入）
+  evolclaw init aun           AUN 交互式配置（AID 创建 + Owner 绑定）
+
+非交互式初始化:
+  evolclaw init --non-interactive [选项]
+
+  选项:
+    --default-path <path>     项目目录（默认: 当前目录）
+    --channel <name>          渠道类型（默认: aun）
+    --aun-aid <aid>           AUN Agent ID（必填，如 mybot.agentid.pub）
+    --aun-owner <aid>         Owner AID（可选，如 alice.agentid.pub）
+
+  示例:
+    evolclaw init --non-interactive --aun-aid mybot.agentid.pub --aun-owner alice.agentid.pub
+    evolclaw init --non-interactive --default-path /home/user/project --aun-aid bot.agentid.pub`);
+            }
+            else if (args[1] === 'wechat') {
                 await cmdInitWechat();
             }
             else if (args[1] === 'feishu') {
@@ -1380,6 +1475,8 @@ Commands:
                   --level error|warn   只显示指定级别及以上
                   --module <name>      只显示指定模块（如 feishu、AgentRunner）
                   --raw                原始输出，不着色
+  ctl           运行时自管理（模型切换、推理强度、压缩上下文等）
+                  evolclaw ctl help 查看完整命令列表
   diagnose      诊断启动环境（配置、数据库、进程）
   mv <old> <new>  迁移项目目录（保留 Claude/Codex/EvolClaw 会话）
 

package/dist/config.js

@@ -177,7 +177,7 @@ export function saveConfig(config, configPath = resolvePaths().config) {
     fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
 }
 // ── Channel instance normalization ──
-export const channelTypes = ['feishu', 'wechat', 'aun', 'dingtalk', 'qqbot'];
+export const channelTypes = ['feishu', 'wechat', 'aun', 'dingtalk', 'qqbot', 'wecom'];
 /**
  * Normalize a channel config value (single object, array, or undefined) into an array
  * where every element has a `name` field.