evolclaw 2.6.0 → 2.6.1

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';
@@ -317,7 +317,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 +327,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}"
@@ -531,11 +543,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 +565,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) {
@@ -732,6 +749,44 @@ 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) {
+            this.trace('OUT', 'thought.put.error', { channelId, error: String(e) });
+            logger.debug(`[AUN] thought.put failed to ${channelId}: ${e}`);
+        }
+    }
     async sendFile(channelId, filePath, context) {
         if (!this.connected || !this.client) {
             logger.warn('[AUN] Cannot sendFile: not connected');
@@ -834,7 +889,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,7 +904,7 @@ 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)
@@ -1048,10 +1103,11 @@ 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,
             };
             const policy = {

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.

package/dist/core/command-handler.js

@@ -103,7 +103,7 @@ function formatIdleTime(ms) {
     return '刚刚';
 }
 // 支持的命令列表
-const commands = ['/new', '/pwd', '/plist', '/project', '/bind', '/help', '/status', '/restart', '/model', '/effort', '/agent', '/slist', '/session', '/rename', '/stop', '/clear', '/compact', '/repair', '/safe', '/fork', '/del', '/perm', '/file', '/check', '/rewind', '/activity', '/agentmd', '/chatmode'];
+const commands = ['/new', '/pwd', '/plist', '/project', '/bind', '/help', '/status', '/restart', '/model', '/effort', '/agent', '/slist', '/session', '/rename', '/stop', '/clear', '/compact', '/repair', '/safe', '/fork', '/del', '/perm', '/file', '/check', '/rewind', '/activity', '/aid', '/agentmd', '/chatmode'];
 // 命令别名映射
 const aliases = {
     '/p': '/project',
@@ -127,6 +127,7 @@ export class CommandHandler {
     permissionGateway;
     interactionRouter;
     statsCollector;
+    hotLoadChannel;
     agentMap;
     defaultAgentId;
     /** 按 agentId 获取 agent，回退到默认 */
@@ -266,6 +267,9 @@ export class CommandHandler {
     setMessageQueue(messageQueue) {
         this.messageQueue = messageQueue;
     }
+    setHotLoadChannel(fn) {
+        this.hotLoadChannel = fn;
+    }
     setPermissionGateway(gateway) {
         this.permissionGateway = gateway;
     }
@@ -407,6 +411,10 @@ export class CommandHandler {
                     ] : []),
                     ...(isOwner ? [
                         { cmd: '/file', label: '发送项目内文件', desc: '将项目目录内的文件发送给用户' },
+                        { cmd: '/aid', label: 'AID 管理', desc: '创建新 AID 并上线新 Agent 实例', next: { type: 'select', items: [
+                                    { value: 'list', label: '列表', desc: '列出所有 AUN 实例及连接状态' },
+                                    { value: 'new', label: '创建', desc: '创建新 AID 并热加载上线', next: { type: 'text' } },
+                                ] } },
                         { cmd: '/agentmd', label: '管理 agent.md', desc: '查看或更新 AUN 网络上的 agent.md 身份文件', next: { type: 'select', items: [
                                     { value: 'put', label: '上传当前', desc: '将本地 agent.md 上传到 AUN 网络' },
                                     { value: 'set', label: '直接设置', desc: '输入内容直接更新 agent.md', next: { type: 'text' } },
@@ -634,6 +642,7 @@ export class CommandHandler {
                 ...(isOwner ? [
                     '  /restart - 重启服务',
                     '  /file [channel] <path> - 发送项目内文件',
+                    '  /aid [list|new <aid>] - AID 管理',
                     '  /agentmd [put|set <内容>] - 管理 agent.md',
                 ] : []),
                 '',
@@ -1139,6 +1148,94 @@ export class CommandHandler {
             }
             return `✓ 推理强度: ${newEffort}`;
         }
+        // /aid 命令：AID 管理（list / new）
+        if (normalizedContent === '/aid' || normalizedContent === '/aid list' || normalizedContent.startsWith('/aid ')) {
+            if (!isOwner)
+                return '❌ 无权限：此命令仅限 owner 使用';
+            const adapter = this.adapters.get(channel);
+            const channelType = this.channelTypeMap.get(channel);
+            if (channelType !== 'aun')
+                return '❌ 此命令仅在 AUN 通道中可用';
+            const arg = normalizedContent.slice(4).trim();
+            // /aid 或 /aid list — 列出所有 AUN 实例
+            if (!arg || arg === 'list') {
+                const { normalizeChannelInstances } = await import('../config.js');
+                const instances = normalizeChannelInstances(this.config.channels?.aun, 'aun');
+                if (instances.length === 0)
+                    return '暂无 AUN 实例';
+                const lines = ['AUN 实例:'];
+                for (const inst of instances) {
+                    if (inst.enabled === false || !inst.aid)
+                        continue;
+                    const channelObj = this.channelObjects.get(inst.name);
+                    const status = channelObj?.getStatus?.();
+                    const connected = status?.connected ?? false;
+                    const icon = connected ? '✓' : '✗';
+                    const state = connected ? '已连接' : '未连接';
+                    lines.push(`  ${icon} ${inst.name}  ${inst.aid}  ${state}`);
+                }
+                return lines.join('\n');
+            }
+            // /aid new <aid> — 创建新 AID 并热加载
+            if (arg.startsWith('new ')) {
+                const rawName = arg.slice(4).trim();
+                if (!rawName)
+                    return '用法: /aid new <aid>\n例: /aid new reviewer';
+                if (!this.hotLoadChannel)
+                    return '❌ 热加载未就绪';
+                // Derive full AID: if no dots, append domain from current AID
+                const selfAid = typeof adapter._selfAid === 'function' ? adapter._selfAid() : '';
+                let fullAid = rawName;
+                if (!rawName.includes('.')) {
+                    const domain = selfAid.split('.').slice(1).join('.');
+                    if (!domain)
+                        return '❌ 无法推导 AID 域（当前实例未连接）';
+                    fullAid = `${rawName}.${domain}`;
+                }
+                // Validate AID format
+                const { isValidAid } = await import('../utils/init-channel.js');
+                if (!isValidAid(fullAid))
+                    return `❌ 无效 AID 格式: ${fullAid}`;
+                // Check instance name conflict
+                const instName = rawName.includes('.') ? rawName.split('.')[0] : rawName;
+                const { normalizeChannelInstances } = await import('../config.js');
+                const existing = normalizeChannelInstances(this.config.channels?.aun, 'aun');
+                if (existing.some(e => e.name === instName)) {
+                    return `❌ 实例名 "${instName}" 已存在`;
+                }
+                if (existing.some(e => e.aid === fullAid)) {
+                    return `❌ AID ${fullAid} 已在配置中`;
+                }
+                // Create AID (reuse init-channel.ts silent logic)
+                try {
+                    const { createAidSilent, appendAunInstance } = await import('../utils/init-channel.js');
+                    const createResult = await createAidSilent({ aid: fullAid, owner: selfAid });
+                    // Resolve owner from current AUN instance config
+                    const owner = this.config.channels?.aun
+                        ? (Array.isArray(this.config.channels.aun)
+                            ? this.config.channels.aun.find((a) => a.aid === selfAid)?.owner
+                            : this.config.channels.aun.owner)
+                        : undefined;
+                    // Hot-load: build and register new channel instance BEFORE writing config
+                    const { AUNChannelPlugin } = await import('../channels/aun.js');
+                    const plugin = new AUNChannelPlugin();
+                    const tempConfig = JSON.parse(JSON.stringify(this.config));
+                    tempConfig.channels.aun = [{ name: instName, enabled: true, aid: fullAid, owner }];
+                    const newInstances = await plugin.createChannels(tempConfig);
+                    if (newInstances.length === 0)
+                        return '❌ 通道实例创建失败';
+                    await this.hotLoadChannel(newInstances[0]);
+                    // Write config only after successful hot-load
+                    appendAunInstance(this.config, { name: instName, aid: fullAid, owner });
+                    const verb = createResult.alreadyExisted ? '已存在，现已上线' : '已创建并上线';
+                    return `✓ ${fullAid} ${verb}\n  实例名: ${instName}\n  可在 AUN 中搜索该 AID 开始对话`;
+                }
+                catch (e) {
+                    return `❌ 创建失败: ${String(e.message || e).slice(0, 200)}`;
+                }
+            }
+            return '用法: /aid [list|new <aid>]';
+        }
         // /activity 命令：控制中间输出显示模式
         if (normalizedContent === '/agentmd' || normalizedContent.startsWith('/agentmd ')) {
             if (!isOwner)
@@ -2601,7 +2698,7 @@ export class CommandHandler {
     static CTL_COMMANDS = [
         '/help', '/status', '/check',
         '/model', '/effort', '/perm',
-        '/compact', '/activity', '/file', '/send', '/chatmode', '/restart', '/agentmd',
+        '/compact', '/activity', '/file', '/send', '/chatmode', '/restart', '/agentmd', '/bind', '/aid',
     ];
     /**
      * 从 session 恢复 ReplyContext，用于 ctl send 主动发送文本时的路由

package/dist/core/message/message-processor.js

@@ -1,7 +1,9 @@
 import path from 'path';
 import fs from 'fs';
+import crypto from 'crypto';
 import { hasCompact } from '../../agents/claude-runner.js';
 import { StreamFlusher } from './stream-flusher.js';
+import { ThoughtEmitter } from './thought-emitter.js';
 import { StreamIdleMonitor } from './stream-idle-monitor.js';
 import { logger } from '../../utils/logger.js';
 import { getErrorMessage, classifyError, ErrorType, ERROR_PREFIX, isInfraError, prefixErrorType, isRetryableError } from '../../utils/error-utils.js';
@@ -27,7 +29,6 @@ export class MessageProcessor {
     interruptedSessions = new Map(); // sessionId → reason ('new_message' | 'stop' | ...)
     interactionRouter;
     messageQueue;
-    skillsHintDesc = undefined; // undefined=未加载, null=无模板, string=缓存描述
     skillsEnsured = false; // 全局 SKILLS.md 是否已确保
     /** 按 agentId 获取 agent，回退到默认 */
     getAgent(agentId) {
@@ -279,6 +280,8 @@ export class MessageProcessor {
         const { adapter, options } = channelInfo;
         const agent = this.getAgent(session.agentId);
         const streamKey = session.id;
+        // 为本次任务处理生成唯一 task_id（客户端生成，格式 task-{10hex}）
+        const taskId = `task-${crypto.randomUUID().replace(/-/g, '').slice(0, 10)}`;
         try {
             const isBackground = await this.isBackgroundSession(session, message.channel, message.channelId);
             // 记录收到消息
@@ -302,7 +305,7 @@ export class MessageProcessor {
             logger.info(`[MessageProcessor] session=${session.id} chatType=${session.chatType} sessionMode=${session.sessionMode} agentId=${session.agentId} msgChatType=${message.chatType ?? 'n/a'}`);
             // 记录开始处理
             this.eventBus.publish({ type: 'message:processing', sessionId: session.id });
-            adapter.sendProcessingStatus?.(message.channelId, 'start', session.id, this.getReplyContext(message));
+            adapter.sendProcessingStatus?.(message.channelId, 'start', session.id, taskId, this.getReplyContext(message));
             logger.message({
                 msgId: messageId,
                 sessionId: session.id,
@@ -338,6 +341,12 @@ export class MessageProcessor {
             }, (options?.flushDelay ?? this.config.flushDelay ?? 3) * 1000, options?.fileMarkerPattern, this.config.debug?.flusherDiag, isProactive);
             // 保存当前 flusher，用于 compact 事件
             this.currentFlusher = flusher;
+            // Proactive 模式可观测：创建 ThoughtEmitter，将静默的流式事件转发为 thought
+            // selector: context = { type: 'task', id: taskId }
+            let thoughtEmitter = null;
+            if (isProactive && adapter.putThought) {
+                thoughtEmitter = new ThoughtEmitter(adapter, message.channelId, taskId);
+            }
             // 调用 AgentRunner（含上下文过长自动 compact 重试）
             // 捕获当前消息的上下文（闭包），避免后续消息处理时串台
             const capturedChannelId = message.channelId;
@@ -439,14 +448,16 @@ export class MessageProcessor {
                     contextParts.push(`[群聊回复规则] 回复时必须在开头添加 @${message.peerId} 来通知对方`);
                 }
                 // 5. Agent ctl 自管理指令提示 + SKILLS.md 生成
-                if (!this.skillsEnsured) {
-                    this.ensureSkillsFile();
-                    this.skillsEnsured = true;
-                }
-                const skillsHint = this.getSkillsHint();
-                if (skillsHint) {
-                    contextParts.push(`[EvolClaw 自管理] ${skillsHint}`);
-                }
+                // 暂时注释：排查 proactive 模式下 agent 未调用 Bash 工具的问题，
+                // 怀疑此段与 [Proactive 模式] 语义重合稀释了后者的权重
+                // if (!this.skillsEnsured) {
+                //   this.ensureSkillsFile();
+                //   this.skillsEnsured = true;
+                // }
+                // const skillsHint = this.getSkillsHint();
+                // if (skillsHint) {
+                //   contextParts.push(`[EvolClaw 自管理] ${skillsHint}`);
+                // }
                 // 6. Proactive 模式提示词：agent 的输出不会自动发送，必须主动调用 ctl send/file
                 if (isProactive) {
                     contextParts.push('[Proactive 模式] 本次对话中你的流式输出不会自动发送给用户，必须通过以下命令主动发送：\n' +
@@ -463,7 +474,7 @@ export class MessageProcessor {
                         const stream = await agent.runQuery(session.id, effectivePrompt, absoluteProjectPath, session.agentSessionId, message.images, effectiveSystemPrompt, this.sessionManager);
                         agent.registerStream(streamKey, stream);
                         streamRegistered = true;
-                        streamResult = await this.processEventStream(stream, session, flusher, resetTimer, shouldSuppress);
+                        streamResult = await this.processEventStream(stream, session, flusher, resetTimer, shouldSuppress, thoughtEmitter);
                         break; // 成功，跳出重试循环
                     }
                     catch (retryError) {
@@ -493,7 +504,7 @@ export class MessageProcessor {
                         flusher.addActivity('\u2705 压缩完成，正在重试...');
                         const retryStream = await agent.runQuery(session.id, '上下文已自动压缩，请继续之前未完成的任务。', absoluteProjectPath, session.agentSessionId, undefined, options?.systemPromptAppend, this.sessionManager);
                         agent.registerStream(streamKey, retryStream);
-                        streamResult = await this.processEventStream(retryStream, session, flusher, resetTimer, shouldSuppress);
+                        streamResult = await this.processEventStream(retryStream, session, flusher, resetTimer, shouldSuppress, thoughtEmitter);
                     }
                     else {
                         throw new Error('CONTEXT_COMPACT_FAILED');
@@ -607,7 +618,7 @@ export class MessageProcessor {
                 const errorSummary = streamResult.errors?.join('; ') || '任务执行失败';
                 const rawSubtype = streamResult.subtype || 'agent_error';
                 const errorType = prefixErrorType(ERROR_PREFIX.AGENT, rawSubtype);
-                adapter.sendProcessingStatus?.(message.channelId, 'error', session.id, this.getReplyContext(message));
+                adapter.sendProcessingStatus?.(message.channelId, 'error', session.id, taskId, this.getReplyContext(message));
                 this.eventBus.publish({
                     type: 'message:error',
                     sessionId: session.id,
@@ -635,7 +646,7 @@ export class MessageProcessor {
             }
             else {
                 // 真正的成功
-                adapter.sendProcessingStatus?.(message.channelId, interruptReason ? 'interrupted' : 'done', session.id, this.getReplyContext(message));
+                adapter.sendProcessingStatus?.(message.channelId, interruptReason ? 'interrupted' : 'done', session.id, taskId, this.getReplyContext(message));
                 await this.sessionManager.recordSuccess(session.id);
                 this.eventBus.publish({
                     type: 'message:completed',
@@ -688,7 +699,7 @@ export class MessageProcessor {
             // 用户主动中断（新消息打断 或 /stop 命令）时静默，不发送中断/错误提示
             if (!isUserInterrupt) {
                 try {
-                    adapter.sendProcessingStatus?.(message.channelId, procStatus, session.id, this.getReplyContext(message));
+                    adapter.sendProcessingStatus?.(message.channelId, procStatus, session.id, taskId, this.getReplyContext(message));
                 }
                 catch { }
             }
@@ -764,7 +775,7 @@ export class MessageProcessor {
      * 此方法只消费标准 AgentEvent 类型，不引用任何 SDK 特有事件。
      * SDK 事件 → AgentEvent 的转换在 AgentRunner.transformStream() 中完成。
      */
-    async processEventStream(stream, session, flusher, resetTimer, shouldSuppress) {
+    async processEventStream(stream, session, flusher, resetTimer, shouldSuppress, thoughtEmitter) {
         let hasReceivedText = false;
         let hasErrorResult = false; // 是否已有 tool_result/error 事件输出过错误
         let completeResult = { isError: false, lastReplyText: '', fullText: '', hasReceivedText: false };
@@ -777,6 +788,10 @@ export class MessageProcessor {
                 resetTimer(event.type, toolName);
                 // 记录所有事件类型
                 logger.info(`[MessageProcessor] Event: type=${event.type}`);
+                // Proactive 可观测：将事件实时透传为 thought（fire-and-forget）
+                if (thoughtEmitter) {
+                    thoughtEmitter.emit(event).catch(() => { });
+                }
                 // session_id 已在 AgentRunner.transformStream 中处理，此处仅记录
                 if (event.type === 'session_id') {
                     logger.info(`[MessageProcessor] Session ID updated: ${event.sessionId} for session: ${session.id}`);
@@ -1077,42 +1092,28 @@ export class MessageProcessor {
         return 0;
     }
     /**
-     * 从模板 frontmatter 缓存提示（懒加载，整个进程只读一次模板文件）
+     * 从 data/SKILLS.md 读取 frontmatter 并生成提示。
+     * 不缓存：每次读取保证用户编辑立即生效。
+     * 调用前应确保 ensureSkillsFile() 已执行过（首次落盘）。
      */
     getSkillsHint() {
-        if (this.skillsHintDesc === undefined) {
-            this.skillsHintDesc = this.loadSkillsHint();
-        }
-        return this.skillsHintDesc;
-    }
-    /**
-     * 从包模板源读取 frontmatter 并生成提示（仅执行一次）
-     */
-    loadSkillsHint() {
         try {
-            const candidates = [
-                path.join(getPackageRoot(), 'src', 'templates', 'skills.md'),
-                path.join(getPackageRoot(), 'dist', 'templates', 'skills.md'),
+            const skillsPath = path.join(resolveRoot(), 'data', 'SKILLS.md');
+            if (!fs.existsSync(skillsPath))
+                return null;
+            const content = fs.readFileSync(skillsPath, 'utf-8');
+            const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+            if (!frontmatterMatch)
+                return null;
+            const fm = frontmatterMatch[1];
+            const desc = fm.match(/^description:\s*(.+)$/m)?.[1]?.trim() || 'EvolClaw 运行时管理指令';
+            const trigger = fm.match(/^trigger:\s*(.+)$/m)?.[1]?.trim() || '';
+            const parts = [
+                `可通过 Bash 指令管理运行时，${desc}。`,
+                trigger ? `触发时机：${trigger}。` : '',
+                `完整文档见 ${skillsPath}`,
             ];
-            for (const templatePath of candidates) {
-                if (!fs.existsSync(templatePath))
-                    continue;
-                const content = fs.readFileSync(templatePath, 'utf-8');
-                const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
-                if (!frontmatterMatch)
-                    continue;
-                const fm = frontmatterMatch[1];
-                const desc = fm.match(/^description:\s*(.+)$/m)?.[1]?.trim() || 'EvolClaw 运行时管理指令';
-                const trigger = fm.match(/^trigger:\s*(.+)$/m)?.[1]?.trim() || '';
-                const skillsPath = path.join(resolveRoot(), 'data', 'SKILLS.md');
-                const parts = [
-                    `可通过 Bash 执行 \`evolclaw ctl <cmd>\` 管理运行时：${desc}`,
-                    trigger ? `触发时机：${trigger}` : '',
-                    `完整文档见 ${skillsPath}`,
-                ];
-                return parts.filter(Boolean).join('\n');
-            }
-            return null;
+            return parts.filter(Boolean).join('');
         }
         catch {
             return null;

package/dist/core/message/message-queue.js

@@ -169,7 +169,7 @@ export class MessageQueue {
      * 合并多条同 peerId 消息：
      * - content: \n 连接
      * - images / mentions: 扁平合并
-     * - messageId: 置空（合并后不代表某一条具体消息）
+     * - messageId: 取最新一条的 messageId（用于 thought 锚定与中断追踪）
      * - replyContext / peerName / 其余字段: 取最后一条
      */
     mergeItems(items) {
@@ -185,12 +185,20 @@ export class MessageQueue {
                 allMentions.push(...m.mentions);
         }
         const last = items[items.length - 1];
+        // 保留最新一条的 messageId（若最后一条无 ID 则回退到前面已有的 ID）
+        let latestMessageId;
+        for (let i = items.length - 1; i >= 0; i--) {
+            if (items[i].message.messageId) {
+                latestMessageId = items[i].message.messageId;
+                break;
+            }
+        }
         const merged = {
             ...last.message,
             content: contents.join('\n'),
             images: allImages.length > 0 ? allImages : undefined,
             mentions: allMentions.length > 0 ? allMentions : undefined,
-            messageId: undefined,
+            messageId: latestMessageId,
         };
         return {
             message: merged,

package/dist/core/message/stream-debouncer.js

@@ -95,13 +95,21 @@ export class StreamDebouncer {
                 allMentions.push(...e.mentions);
         }
         const last = entries[entries.length - 1];
+        // 合并后保留最新一条的 messageId（用于 thought 锚定与中断追踪）
+        let latestMessageId;
+        for (let i = entries.length - 1; i >= 0; i--) {
+            if (entries[i].messageId) {
+                latestMessageId = entries[i].messageId;
+                break;
+            }
+        }
         const merged = {
             ...last.rest,
             content: contents.join('\n'),
             images: allImages.length > 0 ? allImages : undefined,
             mentions: allMentions.length > 0 ? allMentions : undefined,
             replyContext: last.replyContext,
-            messageId: entries.length > 1 ? undefined : last.messageId,
+            messageId: latestMessageId,
         };
         const resolves = entries.map(e => e.resolve);
         const rejects = entries.map(e => e.reject);

package/dist/core/message/thought-emitter.js

@@ -0,0 +1,146 @@
+import { logger } from '../../utils/logger.js';
+/**
+ * ThoughtEmitter — 将 Proactive 模式下的流式 AgentEvent 实时发送为 thought
+ *
+ * 设计特点：
+ * - 不做聚合/batching，逐事件调用 adapter.putThought()
+ * - 不感知 group vs P2P，通道差异由 adapter 内部处理
+ * - taskId 映射为 context: { type: 'task', id: taskId }（协议 selector）
+ * - fire-and-forget：调用方不 await emit()，错误被内部捕获
+ */
+export class ThoughtEmitter {
+    adapter;
+    channelId;
+    taskId;
+    hasEmittedText = false;
+    constructor(adapter, channelId, taskId) {
+        if (!taskId) {
+            throw new Error('[ThoughtEmitter] taskId is required at construction');
+        }
+        this.adapter = adapter;
+        this.channelId = channelId;
+        this.taskId = taskId;
+    }
+    async emit(event) {
+        // 对齐 interactive 的 dedup：流式 text 已推过时，complete.result 不再重复发 summary
+        if (event.type === 'complete' &&
+            !event.isError &&
+            event.result &&
+            this.hasEmittedText) {
+            return;
+        }
+        const payload = this.mapEventToPayload(event);
+        if (!payload)
+            return;
+        if (!this.adapter.putThought)
+            return;
+        if (payload.stage === 'thinking') {
+            this.hasEmittedText = true;
+        }
+        try {
+            await this.adapter.putThought(this.channelId, this.taskId, payload);
+        }
+        catch (err) {
+            logger.debug(`[ThoughtEmitter] putThought failed: ${err.message}`);
+        }
+    }
+    mapEventToPayload(event) {
+        switch (event.type) {
+            case 'text':
+                if (!event.text)
+                    return null;
+                return { type: 'thought', text: event.text, stage: 'thinking' };
+            case 'tool_use': {
+                const desc = this.summarizeInput(event.input);
+                return {
+                    type: 'thought',
+                    text: desc ? `🔧 ${event.name}: ${desc}` : `🔧 ${event.name}`,
+                    stage: 'tool',
+                    metadata: { tool: event.name, input: desc },
+                };
+            }
+            case 'tool_result':
+                if (event.isError) {
+                    return {
+                        type: 'thought',
+                        text: `⚠️ ${event.name}: ${event.error || '执行失败'}`,
+                        stage: 'tool',
+                        metadata: { tool: event.name, ok: false },
+                    };
+                }
+                {
+                    const resultText = this.truncate(this.stringifyResult(event.result), 200);
+                    return {
+                        type: 'thought',
+                        text: resultText ? `✅ ${event.name}: ${resultText}` : `✅ ${event.name}`,
+                        stage: 'tool',
+                        metadata: { tool: event.name, ok: true },
+                    };
+                }
+            case 'compact':
+                return {
+                    type: 'thought',
+                    text: `💡 会话压缩完成 (压缩前 tokens: ${event.preTokens})`,
+                    stage: 'system',
+                };
+            case 'task_progress': {
+                const stats = this.formatTaskStats(event);
+                const text = event.summary
+                    ? `⏳ 子任务: ${event.summary}${stats ? ` (${stats})` : ''}`
+                    : `⏳ 子任务进行中${stats ? `: ${stats}` : ''}`;
+                return { type: 'thought', text, stage: 'planning' };
+            }
+            case 'error':
+                return { type: 'thought', text: `❌ ${event.error}`, stage: 'error' };
+            case 'complete':
+                if (event.isError) {
+                    const errText = event.errors?.join('; ') || event.result || '任务失败';
+                    return { type: 'thought', text: `❌ ${errText}`, stage: 'error' };
+                }
+                if (event.result) {
+                    return { type: 'thought', text: event.result, stage: 'summary' };
+                }
+                return null;
+            case 'session_id':
+            case 'state_changed':
+            case 'status':
+                return null;
+            default:
+                return null;
+        }
+    }
+    summarizeInput(input) {
+        if (!input || typeof input !== 'object')
+            return '';
+        return (input.description ||
+            input.file_path ||
+            input.pattern ||
+            (typeof input.command === 'string' ? input.command.substring(0, 80) : '') ||
+            (typeof input.prompt === 'string' ? input.prompt.substring(0, 80) : '') ||
+            (typeof input.query === 'string' ? input.query.substring(0, 80) : '') ||
+            '');
+    }
+    stringifyResult(result) {
+        if (result === null || result === undefined)
+            return '';
+        if (typeof result === 'string')
+            return result;
+        try {
+            return JSON.stringify(result);
+        }
+        catch {
+            return String(result);
+        }
+    }
+    truncate(text, maxLen) {
+        return text.length > maxLen ? text.substring(0, maxLen) + '...' : text;
+    }
+    formatTaskStats(event) {
+        const parts = [];
+        if (event.toolUses)
+            parts.push(`${event.toolUses} tools`);
+        if (event.durationMs)
+            parts.push(`${Math.round(event.durationMs / 1000)}s`);
+        return parts.join(', ');
+    }
+}

package/dist/index.js

@@ -204,9 +204,11 @@ async function main() {
         showIdleMonitor: () => true,
         accumulateErrors: () => true,
     };
-    // 注册渠道插件的 adapter 和 policy
-    for (const inst of channelInstances) {
-        // 设置项目路径提供器（如果需要）
+    // ── MessageBridge：Channel ↔ Core 消息桥梁 ──
+    const msgBridge = new MessageBridge(config, sessionManager, processor, messageQueue, cmdHandler, eventBus);
+    // ── Channel instance registration (shared by startup and hot-load) ──
+    function registerChannelInstance(inst) {
+        // 1. 项目路径提供器
         if (inst.onProjectPathRequest && inst.channel.onProjectPathRequest) {
             inst.channel.onProjectPathRequest(async (channelId) => {
                 const session = await sessionManager.getOrCreateSession(inst.adapter.channelName, channelId, config.projects?.defaultPath || process.cwd(), undefined, undefined, undefined, undefined);
@@ -215,7 +217,7 @@ async function main() {
                     : path.resolve(process.cwd(), session.projectPath);
             });
         }
-        // 注册 adapter、policy 和 options（注入 channelType）
+        // 2. 注册 adapter、policy 和 options（注入 channelType）
         const opts = inst.channelType
             ? { ...inst.options, channelType: inst.channelType }
             : inst.options;
@@ -225,18 +227,13 @@ async function main() {
         if (inst.policy) {
             cmdHandler.registerPolicy(inst.adapter.channelName, inst.policy);
         }
-        // 注册交互回调：渠道收到用户操作后路由到 InteractionRouter
+        // 3. 交互回调
         if (inst.adapter.onInteraction) {
             inst.adapter.onInteraction((response) => {
                 interactionRouter.handle(response);
             });
         }
-    }
-    // ── MessageBridge：Channel ↔ Core 消息桥梁 ──
-    const msgBridge = new MessageBridge(config, sessionManager, processor, messageQueue, cmdHandler, eventBus);
-    // ── 渠道消息注册 ──
-    // 连接插件系统的渠道
-    for (const inst of channelInstances) {
+        // 4. MessageBridge 注册（按 channelType 分发）
         const channelType = inst.channelType || inst.adapter.channelName;
         if (channelType === 'feishu') {
             msgBridge.register(inst.adapter.channelName, (handler) => inst.channel.onMessage(async ({ channelId: chatId, content, images, peerId, peerName, messageId, mentions, threadId, rootId, chatType }) => {
@@ -251,7 +248,6 @@ async function main() {
             }), inst.adapter, channelType);
         }
         if (channelType === 'wechat') {
-            // 注入 EventBus（用于 channel:health 事件）
             if (inst.channel.setEventBus) {
                 inst.channel.setEventBus(eventBus);
             }
@@ -281,6 +277,19 @@ async function main() {
                     replyContext: opts.replyContext,
                 });
             }), (channelId, text, replyContext) => inst.channel.sendMessage(channelId, text, replyContext), inst.adapter, channelType);
+            // AUN 重连失败通知
+            if (inst.channel.setOnChannelDown) {
+                inst.channel.setOnChannelDown(() => {
+                    eventBus.publish({
+                        type: 'channel:health',
+                        channel: channelType,
+                        channelName: inst.adapter.channelName,
+                        status: 'auth_error',
+                        message: `⚠️ AUN 渠道 ${inst.adapter.channelName} 断连，自动重试已用尽。\n使用 /check rty aun 手动重连`,
+                        timestamp: Date.now(),
+                    });
+                });
+            }
         }
         if (channelType === 'dingtalk') {
             msgBridge.register(inst.adapter.channelName, (handler) => inst.channel.onMessage(async (event) => {
@@ -310,11 +319,40 @@ async function main() {
                 });
             }), (channelId, text) => inst.channel.sendMessage(channelId, text), inst.adapter, channelType);
         }
-        // 通用：撤回消息 → 中断执行中任务（所有支持 onRecall 的渠道）
+        if (channelType === 'wecom') {
+            msgBridge.register(inst.adapter.channelName, (handler) => inst.channel.onMessage(async (event) => {
+                handler({
+                    channel: channelType,
+                    channelId: event.channelId,
+                    content: event.content,
+                    chatType: event.chatType || 'private',
+                    peerId: event.peerId || '',
+                    peerName: event.peerName,
+                    messageId: event.messageId,
+                });
+            }), (channelId, text) => inst.channel.sendMessage(channelId, text), inst.adapter, channelType);
+        }
+        // 5. 撤回消息 → 中断执行中任务
         inst.channel.onRecall?.((messageId) => {
             msgBridge.cancel(messageId);
         });
     }
+    // ── 注册所有渠道实例 ──
+    for (const inst of channelInstances) {
+        registerChannelInstance(inst);
+    }
+    // ── 设置热加载回调 ──
+    cmdHandler.setHotLoadChannel(async (inst) => {
+        registerChannelInstance(inst);
+        channelInstances.push(inst);
+        await inst.connect();
+        eventBus.publish({
+            type: 'channel:connected',
+            channel: (inst.channelType || inst.adapter.channelName).toLowerCase(),
+            channelName: inst.adapter.channelName,
+            timestamp: Date.now(),
+        });
+    });
     // ── 连接所有渠道 ──
     const connected = await channelLoader.connectAll(channelInstances);
     // 预填充 Feishu 已知 thread_id（重启后避免误判话题创建）
@@ -326,7 +364,6 @@ async function main() {
         }
     }
     for (const name of connected) {
-        // 查找对应实例以获取 channelType
         const inst = channelInstances.find(i => i.adapter.channelName === name);
         const type = inst?.channelType || name;
         eventBus.publish({
@@ -336,22 +373,6 @@ async function main() {
             timestamp: Date.now()
         });
     }
-    // AUN 重连失败通知：通过 channel:health 事件
-    for (const inst of channelInstances) {
-        const channelType = inst.channelType || inst.adapter.channelName;
-        if (channelType === 'aun' && inst.channel.setOnChannelDown) {
-            inst.channel.setOnChannelDown(() => {
-                eventBus.publish({
-                    type: 'channel:health',
-                    channel: channelType,
-                    channelName: inst.adapter.channelName,
-                    status: 'auth_error',
-                    message: `⚠️ AUN 渠道 ${inst.adapter.channelName} 断连，自动重试已用尽。\n使用 /check rty aun 手动重连`,
-                    timestamp: Date.now(),
-                });
-            });
-        }
-    }
     // 统一 channel:health 跨通道通知（仅 auth_error）
     // 按 (channelType, ownerId) 去重，避免同类型多实例重复通知
     eventBus.subscribe('channel:health', (event) => {

package/dist/templates/skills.md

@@ -1,8 +1,8 @@
 ---
 name: evolclaw-ctl
-version: 1.0.0
-description: EvolClaw 运行时自管理指令，仅在 evolclaw 托管环境中可用
-trigger: 用户询问或需要切换模型、调整推理强度、查看运行状态、压缩上下文、检查通道健康、管理权限模式、发送文件、重启服务、重连渠道时
+version: 1.1.0
+description: 仅在 evolclaw 运行时可用
+trigger: 用户询问或需要切换模型、调整推理强度、查看运行状态、压缩上下文、检查通道健康、管理权限模式、重启服务、重连渠道等
 ---
 
 # EvolClaw Ctl
@@ -35,6 +35,8 @@ trigger: 用户询问或需要切换模型、调整推理强度、查看运行
 - `evolclaw ctl agentmd` — 查看当前 agent.md
 - `evolclaw ctl agentmd put` — 发布本地 agent.md
 - `evolclaw ctl agentmd set <内容>` — 直接设置 agent.md 内容
+- `evolclaw ctl aid` — 列出所有 AUN 实例及连接状态
+- `evolclaw ctl aid new <aid>` — 创建新 AID 并热加载（仅 AUN 通道）
 
 ## 使用示例
 

package/dist/utils/init-channel.js

@@ -580,9 +580,9 @@ export async function cmdInitWechat() {
     process.exit(1);
 }
 // ==================== AUN ====================
-// 最低 @agentunion/aun-node 版本要求
-const MIN_AUN_CORE_SDK = [0, 2, 12];
-const AUN_CORE_SDK_PKG = '@agentunion/aun-node';
+// 最低 @agentunion/fastaun 版本要求
+const MIN_AUN_CORE_SDK = [0, 2, 14];
+const AUN_CORE_SDK_PKG = '@agentunion/fastaun';
 function compareVersion(a, min) {
     const parts = a.split('.').map(n => parseInt(n, 10));
     if (parts.length < 3 || parts.some(isNaN))
@@ -711,10 +711,83 @@ export async function checkAunEnvironment(rl) {
     console.log('');
     return true;
 }
-function isValidAid(name) {
+export function isValidAid(name) {
     const labels = name.split('.');
     return labels.length >= 3 && labels.every(l => /^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(l));
 }
+/**
+ * Non-interactive AID creation + agent.md publish.
+ * Reuses the same logic as `evolclaw init --non-interactive --channel aun`.
+ *
+ * Returns the created AID string, or throws on failure.
+ */
+export async function createAidSilent(opts) {
+    const aunPath = path.join(os.homedir(), '.aun');
+    const aidDir = path.join(aunPath, 'AIDs', opts.aid);
+    // Skip creation if AID already exists locally
+    if (fs.existsSync(aidDir) && fs.existsSync(path.join(aidDir, 'private'))) {
+        return { aid: opts.aid, alreadyExisted: true };
+    }
+    const { AUNClient } = await import('@agentunion/fastaun');
+    let client = new AUNClient({ aun_path: aunPath });
+    const result = await client.auth.createAid({ aid: opts.aid });
+    // Download CA root cert (if not already present)
+    const caDownloaded = await downloadCaRoot(aunPath, result.gateway || '');
+    // Rebuild client with CA cert + AID identity for uploadAgentMd
+    const caCertPath = path.join(aunPath, 'CA', 'root', 'root.crt');
+    if (caDownloaded && fs.existsSync(caCertPath)) {
+        try {
+            await client.close();
+        }
+        catch { /* ignore */ }
+        client = new AUNClient({ aun_path: aunPath, root_ca_path: caCertPath, aid: opts.aid });
+    }
+    // Write initial agent.md (initialized: false, name = aid first label)
+    const agentName = opts.aid.split('.')[0];
+    const agentMdContent = `---\naid: "${opts.aid}"\nname: "${agentName}"\ntype: "ai"\nversion: "1.0.0"\ndescription: ""\ntags:\n  - evolclaw\ninitialized: false\n---\n`;
+    const agentMdPath = path.join(aidDir, 'agent.md');
+    try {
+        await client.auth.uploadAgentMd(agentMdContent);
+    }
+    catch (e) {
+        // Non-fatal: first connection will auto-retry
+    }
+    fs.writeFileSync(agentMdPath, agentMdContent, 'utf-8');
+    try {
+        await client.close();
+    }
+    catch { /* ignore */ }
+    if (!fs.existsSync(agentMdPath)) {
+        throw new Error(`agent.md write verification failed: ${agentMdPath}`);
+    }
+    return { aid: opts.aid, alreadyExisted: false };
+}
+/**
+ * Append a new AUN instance to the config's channels.aun array and save.
+ * Handles upgrade from single-object to array format.
+ */
+export function appendAunInstance(config, inst) {
+    if (!config.channels)
+        config.channels = {};
+    const newInst = {
+        name: inst.name,
+        enabled: inst.enabled ?? true,
+        aid: inst.aid,
+        ...(inst.owner && { owner: inst.owner }),
+    };
+    if (Array.isArray(config.channels.aun)) {
+        config.channels.aun.push(newInst);
+    }
+    else if (config.channels.aun) {
+        const oldInst = { ...config.channels.aun, name: config.channels.aun.name || 'aun' };
+        config.channels.aun = [oldInst, newInst];
+    }
+    else {
+        config.channels.aun = [newInst];
+    }
+    const p = resolvePaths();
+    fs.writeFileSync(p.config, JSON.stringify(config, null, 2) + '\n');
+}
 export async function setupAunAid(rl, _config) {
     let aid = '';
     let gatewayPort; // only used locally for AID creation, not written to config
@@ -755,7 +828,7 @@ export async function setupAunAid(rl, _config) {
         console.log('  正在创建 AID...');
         let failed = false;
         try {
-            const { AUNClient } = await import('@agentunion/aun-node');
+            const { AUNClient } = await import('@agentunion/fastaun');
             let client = new AUNClient({ aun_path: aunPath });
             // 如果用户指定了自定义端口，手动设置 gateway URL；否则让 SDK 自动发现
             if (gatewayPort) {

package/dist/utils/init.js

@@ -408,14 +408,14 @@ export async function cmdInit(options) {
             // 自动安装 AUN SDK
             const { resolveAunCoreSdkPkg, npmInstallGlobal, downloadCaRoot } = await import('./init-channel.js');
             if (!resolveAunCoreSdkPkg()) {
-                console.log('正在安装 @agentunion/aun-node...');
-                await npmInstallGlobal('@agentunion/aun-node@latest');
+                console.log('正在安装 @agentunion/fastaun...');
+                await npmInstallGlobal('@agentunion/fastaun@latest');
             }
             // 创建 AID（如果本地不存在）
             const aunPath = path.join(os.homedir(), '.aun');
             const aidDir = path.join(aunPath, 'AIDs', options.aunAid);
             if (!fs.existsSync(path.join(aidDir, 'private'))) {
-                const { AUNClient } = await import('@agentunion/aun-node');
+                const { AUNClient } = await import('@agentunion/fastaun');
                 let client = new AUNClient({ aun_path: aunPath });
                 // 让 SDK 通过 well-known 自动发现网关
                 const result = await client.auth.createAid({ aid: options.aunAid });

package/dist/utils/upgrade.js

@@ -0,0 +1,100 @@
+import fs from 'fs';
+import path from 'path';
+import { execFile } from 'child_process';
+import { getPackageRoot } from '../paths.js';
+/**
+ * 比较两个 semver 版本号 (a.b.c 格式)
+ * 返回 -1 (a < b), 0 (a == b), 1 (a > b)
+ * 自动剥离 pre-release 标签 (e.g. 2.6.0-beta.1 → 2.6.0)
+ */
+export function compareVersions(a, b) {
+    const pa = a.split('-')[0].split('.').map(Number);
+    const pb = b.split('-')[0].split('.').map(Number);
+    const len = Math.max(pa.length, pb.length);
+    for (let i = 0; i < len; i++) {
+        const na = pa[i] ?? 0;
+        const nb = pb[i] ?? 0;
+        if (na < nb)
+            return -1;
+        if (na > nb)
+            return 1;
+    }
+    return 0;
+}
+/**
+ * 检查当前安装是否为 npm link 开发模式。
+ * 正式全局安装的路径结构为 .../node_modules/evolclaw，
+ * 而 npm link 指向项目源码目录，其父目录不是 node_modules。
+ */
+export function isLinkedInstall() {
+    const pkgRoot = getPackageRoot();
+    return path.basename(path.dirname(pkgRoot)) !== 'node_modules';
+}
+/** 获取本地 package.json 中的版本号 */
+export function getLocalVersion() {
+    const pkgPath = path.join(getPackageRoot(), 'package.json');
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    return pkg.version;
+}
+/**
+ * 查询 npm registry 上 evolclaw 的最新版本。
+ * 超时 15 秒，失败返回 null。
+ */
+export function checkLatestVersion() {
+    return new Promise((resolve) => {
+        execFile('npm', ['view', 'evolclaw', 'version'], { timeout: 15000 }, (err, stdout) => {
+            if (err) {
+                resolve(null);
+                return;
+            }
+            const ver = stdout.trim();
+            resolve(ver || null);
+        });
+    });
+}
+/**
+ * 执行 npm install -g evolclaw@latest
+ */
+function runInstall() {
+    return new Promise((resolve) => {
+        execFile('npm', ['install', '-g', 'evolclaw@latest'], { timeout: 120000 }, (err, _stdout, stderr) => {
+            if (err) {
+                resolve({ ok: false, error: stderr || err.message });
+            }
+            else {
+                resolve({ ok: true });
+            }
+        });
+    });
+}
+/**
+ * 完整升级流程：检查 → 比较 → 安装（失败重试一次）
+ */
+export async function tryUpgrade() {
+    // 开发模式跳过
+    if (isLinkedInstall()) {
+        return { status: 'skipped' };
+    }
+    const localVer = getLocalVersion();
+    // 查询 registry
+    const remoteVer = await checkLatestVersion();
+    if (!remoteVer) {
+        return { status: 'skipped', error: 'Failed to check remote version' };
+    }
+    // 版本比较
+    if (compareVersions(localVer, remoteVer) >= 0) {
+        return { status: 'no-update', from: localVer };
+    }
+    // 有新版本，执行升级（失败重试一次）
+    for (let attempt = 0; attempt < 2; attempt++) {
+        const result = await runInstall();
+        if (result.ok) {
+            return { status: 'upgraded', from: localVer, to: remoteVer };
+        }
+        if (attempt === 1) {
+            return { status: 'failed', from: localVer, to: remoteVer, error: result.error };
+        }
+    }
+    // unreachable
+    return { status: 'failed', from: localVer, to: remoteVer };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolclaw",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "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",
@@ -23,8 +23,8 @@
     "prepublishOnly": "npm run build && npm test"
   },
   "dependencies": {
+    "@agentunion/fastaun": "^0.2.15",
     "@anthropic-ai/claude-agent-sdk": "^0.2.100",
-    "@agentunion/aun-node": "^0.2.12",
     "image-type": "^6.0.0",
     "qrcode-terminal": "^0.12.0"
   },
@@ -37,8 +37,8 @@
     "pure-qqbot": "^2.0.0"
   },
   "devDependencies": {
-    "@types/node": "^25.5.0",
     "@types/form-data": "^2.2.1",
+    "@types/node": "^25.5.0",
     "@types/qrcode-terminal": "^0.12.2",
     "@vitest/coverage-v8": "^4.1.0",
     "tsx": "^4.19.0",