evolclaw 3.3.0 → 3.4.0

package/dist/core/command-handler.js

@@ -1,4235 +0,0 @@
-import { DEFAULT_PERMISSION_MODE } from '../types.js';
-import { hasModelSwitcher, hasPermissionController } from '../agents/runner-types.js';
-import { getCodexEfforts } from '../agents/codex-runner.js';
-import { renderCommandCardAsText } from './interaction-router.js';
-import { buildEnvelope, sendInteractionPayload } from './message/message-processor.js';
-import { resolvePaths, getPackageRoot } from '../paths.js';
-import { logger } from '../utils/logger.js';
-import crypto from 'crypto';
-import path from 'path';
-import fs from 'fs';
-import os from 'os';
-import { parseTriggerSet, parseTriggerUpdate } from './trigger/parser.js';
-import { calcNextFireAt } from './trigger/scheduler.js';
-import { checkLatestVersion, getLocalVersion, isLinkedInstall, compareVersions } from '../utils/npm-ops.js';
-import { tryParseChannelKey } from './channel-loader.js';
-import { loadDefaults, loadEvolclawConfig } from '../config-store.js';
-import { execAgentAction, execAgentQuery, execAgentOptions, resolveProjectPath } from './message/command-handler-agent-control.js';
-import { displaySessionTitle } from './session/session-title.js';
-const allEfforts = ['low', 'medium', 'high', 'xhigh', 'max'];
-const nonMaxEfforts = allEfforts.filter(e => e !== 'max' && e !== 'xhigh');
-const PERMISSION_MODE_KEYS = ['auto', 'bypass', 'readonly', 'plan', 'edit', 'request', 'noask'];
-const PERMISSION_MODE_USAGE = PERMISSION_MODE_KEYS.join('|');
-// ── CLI 透传（menu.action name=cli action=exec）─────────────────────────
-// 经消息通道的远程命令执行（RCE）：仅 owner、白名单内只读+配置命令、无 shell、超时+截断。
-// command → '*'(全部子命令放行) | Set(允许的子命令)。
-// 刻意排除破坏性/进程控制/数据面：restart stop start init dev mv rpc msg group net、
-//   agent set/new/delete/enable/disable/rename/reload、aid new/delete/agentmd、storage 写操作。
-const CLI_EXEC_WHITELIST = {
-    status: '*',
-    model: '*',
-    stats: '*',
-    agent: new Set(['list', 'show', 'get']),
-    aid: new Set(['list', 'show', 'lookup']),
-    storage: new Set(['ls', 'quota']),
-};
-const CLI_EXEC_TIMEOUT_MS = 15_000;
-const CLI_EXEC_MAX_OUTPUT = 128 * 1024;
-/** 把命令行字符串分词为 argv，尊重单/双引号，不调用 shell。 */
-function tokenizeArgv(line) {
-    const out = [];
-    const re = /"([^"]*)"|'([^']*)'|(\S+)/g;
-    let m;
-    while ((m = re.exec(line)) !== null) {
-        out.push(m[1] ?? m[2] ?? m[3] ?? '');
-    }
-    return out;
-}
-function getAvailableEfforts(agent, model) {
-    if (agent.name === 'claude') {
-        return allEfforts;
-    }
-    if (agent.name === 'codex') {
-        return getCodexEfforts(model);
-    }
-    return [];
-}
-function formatModelUsage(_agent, _model) {
-    return '用法: /model <模型>';
-}
-/**
- * 模型展示标签：短别名 + 实际完整 ID（如 "opus (claude-opus-4-8)"）。
- * 仅用于展示；命令值/持久化仍使用短别名。完整 ID 不可用或与短名相同时只显示短名。
- */
-function modelDisplayLabel(agent, model) {
-    const full = agent.resolveModelId?.(model);
-    return full && full !== model ? `${model} (${full})` : model;
-}
-/**
- * 写入用户级 ~/.claude/settings.json（与 Claude CLI 行为一致）
- */
-function writeUserSettings(updates) {
-    try {
-        const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
-        let settings = {};
-        if (fs.existsSync(settingsPath)) {
-            settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
-        }
-        if (updates.model !== undefined)
-            settings.model = updates.model;
-        if (updates.effortLevel !== undefined) {
-            if (updates.effortLevel === null) {
-                delete settings.effortLevel;
-            }
-            else {
-                settings.effortLevel = updates.effortLevel;
-            }
-        }
-        const claudeDir = path.join(os.homedir(), '.claude');
-        if (!fs.existsSync(claudeDir)) {
-            fs.mkdirSync(claudeDir, { recursive: true });
-        }
-        fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf-8');
-        return { success: true };
-    }
-    catch (error) {
-        return { success: false, error: error.message };
-    }
-}
-/**
- * 计算两个字符串的 Levenshtein 距离（编辑距离）
- */
-function levenshteinDistance(str1, str2) {
-    const len1 = str1.length;
-    const len2 = str2.length;
-    const matrix = [];
-    for (let i = 0; i <= len1; i++) {
-        matrix[i] = [i];
-    }
-    for (let j = 0; j <= len2; j++) {
-        matrix[0][j] = j;
-    }
-    for (let i = 1; i <= len1; i++) {
-        for (let j = 1; j <= len2; j++) {
-            if (str1[i - 1] === str2[j - 1]) {
-                matrix[i][j] = matrix[i - 1][j - 1];
-            }
-            else {
-                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // 替换
-                matrix[i][j - 1] + 1, // 插入
-                matrix[i - 1][j] + 1 // 删除
-                );
-            }
-        }
-    }
-    return matrix[len1][len2];
-}
-function formatIdleTime(ms) {
-    const seconds = Math.floor(ms / 1000);
-    const minutes = Math.floor(seconds / 60);
-    const hours = Math.floor(minutes / 60);
-    const days = Math.floor(hours / 24);
-    if (days > 0)
-        return `${days}天前`;
-    if (hours > 0)
-        return `${hours}小时前`;
-    if (minutes > 0)
-        return `${minutes}分钟前`;
-    return '刚刚';
-}
-function isAdminRole(role) {
-    return role === 'owner' || role === 'admin';
-}
-// 支持的命令列表
-const commands = ['/new', '/pwd', '/help', '/evolhelp', '/status', '/restart', '/model', '/setmodel', '/effort', '/baseagent', '/slist', '/session', '/rename', '/stop', '/compact', '/repair', '/safe', '/fork', '/del', '/perm', '/file', '/check', '/rewind', '/activity', '/chatmode', '/dispatch', '/ask', '/resume', '/aid', '/rpc', '/storage', '/agent', '/trigger', '/upgrade'];
-const deprecatedCommands = ['/clear'];
-// 命令别名映射
-const aliases = {
-    '/s': '/session',
-    '/name': '/rename',
-    '/rw': '/rewind',
-    '/base': '/baseagent',
-};
-// 命令快速路径前缀（所有命令都不进入消息队列）
-const quickCommandPrefixes = ['/new', '/pwd', '/help', '/evolhelp', '/status', '/restart', '/model', '/setmodel', '/effort', '/baseagent', '/slist', '/session', '/rename', '/repair', '/fork', '/stop', '/clear', '/compact', '/safe', '/del', '/perm', '/file', '/check', '/s ', '/name', '/rewind', '/rw', '/rw ', '/activity', '/chatmode', '/dispatch', '/ask', '/resume', '/base ', '/aid', '/rpc', '/storage', '/agent', '/trigger', '/upgrade'];
-export class CommandHandler {
-    sessionManager;
-    messageCache;
-    eventBus;
-    adapters = new Map();
-    policies = new Map();
-    channelObjects = new Map(); // name → actual channel instance (for /check)
-    channelTypeMap = new Map(); // name → channelType (for grouping)
-    processor;
-    messageQueue;
-    permissionGateway;
-    interactionRouter;
-    statsCollector;
-    agentMap;
-    primaryRunnerKey;
-    agentRegistry;
-    triggerScheduler;
-    triggerManager;
-    /**
-     * Get the runner for a (channel, baseagent) pair.
-     *
-     * Resolves the owning EvolAgent via the registry; falls back to default key.
-     * `baseagent` typically comes from `session.agentId` (e.g. 'claude').
-     */
-    getAgent(channel, baseagent) {
-        if (channel && baseagent) {
-            const evolName = this.agentRegistry?.resolveByChannel(channel)?.name || '<unknown>';
-            const key = `${evolName}::${baseagent}`;
-            if (this.agentMap.has(key))
-                return this.agentMap.get(key);
-        }
-        if (this.agentMap.has(this.primaryRunnerKey))
-            return this.agentMap.get(this.primaryRunnerKey);
-        return this.agentMap.values().next().value;
-    }
-    /** Return the list of baseagents available to a given channel (per-EvolAgent isolation). */
-    getAvailableBaseagents(channel) {
-        const evolName = this.agentRegistry?.resolveByChannel(channel)?.name || '<unknown>';
-        const prefix = `${evolName}::`;
-        const result = [];
-        for (const key of this.agentMap.keys()) {
-            if (key.startsWith(prefix))
-                result.push(key.slice(prefix.length));
-        }
-        return result;
-    }
-    /** Extract the baseagent component from `primaryRunnerKey` (e.g. `aid::claude` → `claude`). */
-    parseDefaultBaseagent() {
-        const idx = this.primaryRunnerKey.indexOf('::');
-        return idx >= 0 ? this.primaryRunnerKey.slice(idx + 2) : this.primaryRunnerKey;
-    }
-    constructor(sessionManager, agentRunnerOrMap, messageCache, eventBus, primaryRunnerKey) {
-        this.sessionManager = sessionManager;
-        this.messageCache = messageCache;
-        this.eventBus = eventBus;
-        if (agentRunnerOrMap instanceof Map) {
-            this.agentMap = agentRunnerOrMap;
-            this.primaryRunnerKey = primaryRunnerKey || '<unknown>::claude';
-        }
-        else {
-            // 测试 / 单 runner 路径：占位 agent name 用 '<unknown>'
-            this.agentMap = new Map([[`<unknown>::${agentRunnerOrMap.name}`, agentRunnerOrMap]]);
-            this.primaryRunnerKey = `<unknown>::${agentRunnerOrMap.name}`;
-        }
-    }
-    /** 注入 EvolAgentRegistry，用于判断通道是否被 EvolAgent 管理 */
-    setAgentRegistry(registry) {
-        this.agentRegistry = registry;
-    }
-    /** 注入触发器调度器（由 index.ts 在初始化后调用） */
-    setTriggerScheduler(scheduler, manager) {
-        this.triggerScheduler = scheduler;
-        this.triggerManager = manager;
-    }
-    /** 返回管理当前通道的 EvolAgent，无则返回 null */
-    getOwningAgent(channel) {
-        if (!this.agentRegistry)
-            return null;
-        return this.agentRegistry.resolveByChannel(channel);
-    }
-    /** 返回当前通道的有效项目路径：从 owning agent 取。*/
-    getEffectiveDefaultPath(channel) {
-        const owning = this.getOwningAgent(channel);
-        if (owning)
-            return owning.projectPath;
-        return process.cwd();
-    }
-    /**
-     * 持久化 baseagent.model：写到 agent config.json；找不到 owning agent 时
-     * 退到用户级 ~/.claude/settings.json（Claude 专用）。
-     */
-    persistBaseagentModel(channel, baseagentName, newModel) {
-        const owning = this.getOwningAgent(channel);
-        if (owning) {
-            try {
-                owning.setBaseagentModel(newModel);
-            }
-            catch (e) {
-                return `⚠️ 写入 agent config 失败: ${e?.message || e}`;
-            }
-            return undefined;
-        }
-        // 无 owning agent（罕见，新结构下应当不会发生）→ 仅 Claude 走用户级 fallback
-        if (baseagentName !== 'claude') {
-            return `⚠️ 找不到通道 "${channel}" 所属的 self-agent`;
-        }
-        const updates = {};
-        if (newModel)
-            updates.model = newModel;
-        const writeResult = writeUserSettings(updates);
-        if (!writeResult.success) {
-            return `⚠️ 写入用户配置失败: ${writeResult.error}`;
-        }
-        return undefined;
-    }
-    /**
-     * 持久化 baseagent.effort：写到 agent config.json；找不到时退到用户级 settings。
-     */
-    persistBaseagentEffort(channel, baseagentName, newEffort) {
-        const owning = this.getOwningAgent(channel);
-        if (owning) {
-            try {
-                owning.setBaseagentEffort(newEffort);
-            }
-            catch (e) {
-                return `⚠️ 写入 agent config 失败: ${e?.message || e}`;
-            }
-            return undefined;
-        }
-        if (baseagentName !== 'claude') {
-            return `⚠️ 找不到通道 "${channel}" 所属的 self-agent`;
-        }
-        const updates = { effortLevel: newEffort ?? null };
-        const writeResult = writeUserSettings(updates);
-        if (!writeResult.success) {
-            return `⚠️ 写入用户配置失败: ${writeResult.error}`;
-        }
-        return undefined;
-    }
-    /** 项目列表快捷访问（无 channel 上下文时的 fallback，尽量不用） */
-    get projects() {
-        return {};
-    }
-    /** 根据项目路径查找配置中的项目名称 */
-    getConfiguredProjectName(projectPath) {
-        return Object.entries(this.projects).find(([_, p]) => p === projectPath)?.[0];
-    }
-    /** 根据项目路径查找项目名称（未配置时回退到目录名） */
-    getProjectName(projectPath) {
-        return this.getConfiguredProjectName(projectPath) || path.basename(projectPath);
-    }
-    /** 格式化运行时间 */
-    formatUptime(ms) {
-        const sec = Math.floor(ms / 1000);
-        const d = Math.floor(sec / 86400);
-        const h = Math.floor((sec % 86400) / 3600);
-        const m = Math.floor((sec % 3600) / 60);
-        const s = sec % 60;
-        const parts = [];
-        if (d > 0)
-            parts.push(`${d}天`);
-        if (h > 0)
-            parts.push(`${h}时`);
-        if (m > 0)
-            parts.push(`${m}分`);
-        if (parts.length === 0)
-            parts.push(`${s}秒`);
-        return parts.join('');
-    }
-    /** 获取消息队列 key：话题用 session.id，主会话用 channel-channelId */
-    getQueueKey(session, _channel, _channelId) {
-        // 队列和 agent 均使用 session.id 作为 key
-        return session?.id || '';
-    }
-    /** 从 session 提取渠道预构建的回复上下文 */
-    getReplyContext(session) {
-        return session.metadata?.replyContext;
-    }
-    /**
-     * 发送 CommandCard 卡片。卡片成功返回 null（调用方直接 return），失败返回降级文本。
-     * CommandCard 不进 InteractionRouter，按钮点击由 channel 直接构造伪命令入站消息。
-     *
-     * 走统一 adapter.send(envelope, { kind: 'interaction', ... }) 入口。
-     */
-    async sendCommandCard(opts) {
-        const adapter = this.adapters.get(opts.channel);
-        if (opts.interaction.kind.kind !== 'command-card') {
-            logger.warn(`[CommandHandler] sendCommandCard called with non-CommandCard kind`);
-            return null;
-        }
-        const card = opts.interaction.kind;
-        if (opts.canWrite === false)
-            return renderCommandCardAsText(card);
-        if (!adapter?.send)
-            return renderCommandCardAsText(card);
-        try {
-            const envelope = buildEnvelope({
-                channel: opts.channel,
-                channelId: opts.channelId,
-                agentName: this.agentRegistry?.resolveByChannel(opts.channel)?.name,
-                replyContext: opts.replyCtx,
-            });
-            const fallbackText = renderCommandCardAsText(card);
-            const messageId = await sendInteractionPayload(adapter, envelope, opts.interaction, fallbackText, opts.replyCtx);
-            if (messageId)
-                return null;
-        }
-        catch (e) {
-            logger.warn(`[CommandHandler] sendCommandCard failed: ${e}`);
-        }
-        return renderCommandCardAsText(card);
-    }
-    /**
-     * 通用降级应答入口：按 (sessionId, fallbackCommand) 查找 pending interaction 并路由。
-     * 返回 { matched: true } 表示已处理，调用方直接返回 result。
-     */
-    async handleInteractionFallback(command, args, sessionId, userId) {
-        if (!this.interactionRouter)
-            return { matched: false };
-        const pendingId = this.interactionRouter.findPendingByCommand(sessionId, command);
-        if (!pendingId)
-            return { matched: false };
-        const initiatorId = this.interactionRouter.getInitiator(pendingId);
-        if (initiatorId && userId && initiatorId !== userId) {
-            return { matched: true, result: '⚠️ 仅卡片发起者可应答' };
-        }
-        this.interactionRouter.handle({
-            type: 'interaction.response',
-            id: pendingId,
-            action: args,
-            operatorId: userId,
-        });
-        return { matched: true, result: '✓ 已回答' };
-    }
-    /** 获取活跃会话，无会话时自动创建（话题除外） */
-    async ensureSession(channel, channelId, threadId, chatType, selfAID) {
-        if (threadId) {
-            // 话题会话：仅查询，不创建
-            const session = await this.sessionManager.getThreadSession(channel, channelId, threadId);
-            if (!session) {
-                return { error: '❌ 话题中尚未创建会话\n发送消息后自动创建' };
-            }
-            return { session };
-        }
-        const ct = chatType === 'group' ? 'group' : chatType === 'private' ? 'private' : undefined;
-        const channelType = this.resolveChannelType(channel);
-        const sid = selfAID ?? this.resolveSelfAID(channel);
-        const session = await this.sessionManager.getActiveSession(channel, channelId)
-            ?? await this.sessionManager.getOrCreateSession(channel, channelId, this.getEffectiveDefaultPath(channel), undefined, undefined, undefined, undefined, ct, undefined, sid, channelType);
-        // 如果 session 已存在但 chatType 跟传入的不一致，更新
-        if (ct && session.chatType !== ct) {
-            await this.sessionManager.updateSession(session.id, { chatType: ct });
-            session.chatType = ct;
-        }
-        return { session };
-    }
-    setProcessor(processor) {
-        this.processor = processor;
-    }
-    setMessageQueue(messageQueue) {
-        this.messageQueue = messageQueue;
-    }
-    setPermissionGateway(gateway) {
-        this.permissionGateway = gateway;
-    }
-    setInteractionRouter(router) {
-        this.interactionRouter = router;
-    }
-    setStatsCollector(collector) {
-        this.statsCollector = collector;
-    }
-    registerAdapter(adapter) {
-        this.adapters.set(adapter.channelName, adapter);
-    }
-    registerChannel(name, channel, channelType) {
-        this.channelObjects.set(name, channel);
-        if (channelType)
-            this.channelTypeMap.set(name, channelType);
-    }
-    /** 将实例名解析为渠道类型（用于 session 查询） */
-    resolveChannelType(channelName) {
-        return this.channelTypeMap.get(channelName) || channelName;
-    }
-    /**
-     * 从 channel key（<type>#<selfAID>#<name>）解析本地身份 AID。
-     * 非 evolagent 通道（裸 channelType，如 'feishu'）解析失败返回 undefined。
-     * aun 通道创建 session 时必须提供 selfAID，故所有 getOrCreateSession 调用都经此兜底。
-     */
-    resolveSelfAID(channel) {
-        return tryParseChannelKey(channel)?.selfAID;
-    }
-    registerPolicy(channelName, policy) {
-        this.policies.set(channelName, policy);
-    }
-    getAdapter(channelName) {
-        // 先按实例名查找，再按 channelType 查找
-        let adapter = this.adapters.get(channelName);
-        if (adapter)
-            return adapter;
-        for (const [name, a] of this.adapters) {
-            if ((this.channelTypeMap.get(name) || name) === channelName)
-                return a;
-        }
-        return undefined;
-    }
-    getPolicy(channel) {
-        return this.policies.get(channel) || {
-            canSwitchProject: () => true,
-            canListProjects: () => true,
-            canCreateSession: () => true,
-            canDeleteSession: () => true,
-            canImportCliSession: () => true,
-            messagePrefix: () => '',
-            showMiddleResult: () => true,
-            showIdleMonitor: () => true,
-            accumulateErrors: () => true,
-        };
-    }
-    resolveMenuChatType(channel, channelId, explicit) {
-        if (explicit)
-            return explicit;
-        const active = this.sessionManager.getActiveSessionSync(channel, channelId);
-        return active?.chatType === 'group' ? 'group' : 'private';
-    }
-    canReadTopics(role) {
-        return role !== 'anonymous';
-    }
-    canDeleteTopic(role, chatType, topic, userId) {
-        if (role === 'anonymous')
-            return false;
-        if (isAdminRole(role))
-            return true;
-        if (chatType === 'group')
-            return false;
-        return !!userId && topic.metadata?.peerId === userId;
-    }
-    buildTopicMenuItem(s) {
-        const displayName = displaySessionTitle(s.name, s.threadId || s.id.slice(0, 8));
-        const item = {
-            value: s.threadId,
-            label: displayName,
-        };
-        if (s.agentSessionId) {
-            item.agentSessionId = s.agentSessionId;
-            const fileInfo = this.sessionManager.getSessionFileInfo(s.projectPath, s.agentSessionId, s.agentId);
-            if (fileInfo.turns)
-                item.turns = fileInfo.turns;
-            const firstMsg = this.sessionManager.readSessionFirstMessage(s.projectPath, s.agentSessionId, s.agentId);
-            if (firstMsg)
-                item.preview = firstMsg.length > 80 ? firstMsg.slice(0, 80) + '...' : firstMsg;
-        }
-        if (s.updatedAt)
-            item.lastActive = s.updatedAt;
-        return item;
-    }
-    /**
-     * 返回结构化命令菜单（供 menu.query 使用）
-     * owner 看到全部命令，admin 看到管理级命令（不含 owner-only），guest 仅看到用户级命令
-     */
-    getMenuItems(role, chatType = 'private') {
-        const isOwner = role === 'owner';
-        const isAdmin = role === 'owner' || role === 'admin';
-        const canReadTopic = role !== 'anonymous';
-        const items = [];
-        if (!isAdmin && chatType === 'group') {
-            return [
-                ...(canReadTopic ? [{
-                        group: '话题管理',
-                        commands: [
-                            { cmd: '/topic', label: '话题管理', desc: '查看当前聊天的话题会话', next: { type: 'select', dynamic: true } },
-                        ]
-                    }] : []),
-                {
-                    group: '其他',
-                    commands: [
-                        { cmd: '/status', label: '显示会话状态' },
-                        { cmd: '/check', label: '检查渠道健康' },
-                        { cmd: '/help', label: '显示帮助信息' },
-                    ]
-                }
-            ];
-        }
-        items.push({
-            group: '会话管理',
-            commands: [
-                { cmd: '/new', label: '创建新会话', desc: '清空历史，开始全新对话', next: { type: 'text' } },
-                { cmd: '/s', label: '切换会话', desc: '切换到同项目下的其他会话', next: { type: 'select', dynamic: true } },
-                ...(canReadTopic ? [{ cmd: '/topic', label: '话题管理', desc: '查看与管理当前聊天的话题会话', next: { type: 'select', dynamic: true } }] : []),
-                { cmd: '/name', label: '重命名当前会话', desc: '为当前会话设置一个易识别的名称', next: { type: 'text' } },
-                { cmd: '/del', label: '删除指定会话', desc: '永久删除一个非活跃会话', next: { type: 'select', dynamic: true } },
-                ...(isAdmin ? [
-                    { cmd: '/fork', label: '分支当前会话', desc: '基于当前会话创建独立分支', next: { type: 'text' } },
-                    { cmd: '/rewind', label: '查看历史/撤销指定轮次', desc: '回退会话到指定轮次，可选择撤销文件改动' },
-                    { cmd: '/compact', label: '压缩会话上下文', desc: '将长对话压缩为摘要以节省 token' },
-                ] : []),
-            ]
-        });
-        if (isAdmin) {
-            items.push({
-                group: 'Agent 与模型',
-                commands: [
-                    { cmd: '/baseagent', label: '切换 Agent 后端', desc: '切换当前会话使用的 AI 后端', next: { type: 'select', dynamic: true } },
-                    { cmd: '/model', label: '切换模型', desc: '切换当前 Agent 使用的模型版本', next: { type: 'select', dynamic: true } },
-                    { cmd: '/effort', label: '切换推理强度', desc: '调整模型推理深度，影响响应速度与质量', next: { type: 'select', items: [
-                                { value: 'low', label: 'Low' },
-                                { value: 'medium', label: 'Medium' },
-                                { value: 'high', label: 'High' },
-                                { value: 'max', label: 'Max' },
-                            ] } },
-                    { cmd: '/chatmode', label: '切换会话模式', desc: '控制 Agent 主动性（被动响应或主动推进）', next: { type: 'select', items: [
-                                { value: 'interactive', label: '交互模式', desc: '仅在收到消息时响应' },
-                                { value: 'proactive', label: '主动模式', desc: 'Agent 可主动推进任务' },
-                            ] } },
-                    { cmd: '/dispatch', label: '切换分发模式', desc: '控制群聊消息过滤（仅@提及或广播响应）', next: { type: 'select', items: [
-                                { value: 'mention', label: '@ 提及', desc: '仅在被 @ 提及时响应' },
-                                { value: 'broadcast', label: '广播', desc: '响应群内所有消息' },
-                            ] } },
-                ]
-            });
-            items.push({
-                group: '权限管理',
-                commands: [
-                    { cmd: '/perm', label: '权限模式管理', desc: '控制工具调用的审批策略', next: { type: 'select', items: [
-                                ...(isOwner ? [
-                                    { value: 'auto', label: '自动模式', desc: '根据风险等级自动决定是否审批' },
-                                    { value: 'bypass', label: '免审批模式', desc: '跳过所有工具审批确认' },
-                                    { value: 'readonly', label: '只读模式', desc: '允许读取和临时目录写入，拒绝项目文件修改' },
-                                    { value: 'plan', label: '计划模式', desc: '仅允许只读操作，写操作需审批' },
-                                    { value: 'edit', label: '编辑模式', desc: '允许文件编辑，其他操作需审批' },
-                                    { value: 'request', label: '请求模式', desc: '所有操作均需审批' },
-                                    { value: 'noask', label: '静默模式', desc: '不弹出审批，自动拒绝未授权操作' },
-                                ] : []),
-                                { value: 'allow', label: '允许此操作', desc: '本次允许当前待审批操作' },
-                                { value: 'always', label: '始终允许', desc: '永久允许同类操作' },
-                                { value: 'deny', label: '拒绝此操作', desc: '拒绝当前待审批操作' },
-                            ] } },
-                ]
-            });
-            items.push({
-                group: '运维',
-                commands: [
-                    { cmd: '/status', label: '显示会话状态', desc: '查看当前会话、项目、Agent 的详细状态' },
-                    { cmd: '/stop', label: '中断当前任务', desc: '立即中断正在执行的 Agent 任务' },
-                    { cmd: '/check', label: '检查渠道状态', desc: '检查各消息渠道的连接健康状态' },
-                    { cmd: '/activity', label: '控制中间输出显示', desc: '设置工具调用过程的可见范围', next: { type: 'select', items: [
-                                { value: 'all', label: '全部显示', desc: '所有用户均可见中间输出' },
-                                { value: 'dm', label: '仅私聊', desc: '仅私聊中显示中间输出' },
-                                { value: 'owner', label: '仅 owner 私聊', desc: '仅 owner 的私聊中显示' },
-                                { value: 'none', label: '不显示', desc: '关闭所有中间输出' },
-                            ] } },
-                    ...(isAdmin ? [
-                        { cmd: '/restart', label: '重启服务', desc: '重启整个 EvolClaw 服务进程' },
-                    ] : []),
-                    ...(isOwner ? [
-                        { cmd: '/file', label: '发送项目内文件', desc: '将项目目录内的文件发送给用户' },
-                    ] : []),
-                ]
-            });
-        }
-        else {
-            items.push({
-                group: '其他',
-                commands: [
-                    { cmd: '/status', label: '显示会话状态', desc: '查看当前会话的基本状态' },
-                    { cmd: '/check', label: '检查渠道健康', desc: '检查消息渠道连接状态' },
-                ]
-            });
-        }
-        items.push({
-            group: '帮助',
-            commands: [
-                { cmd: '/help', label: '显示帮助信息', desc: '列出所有可用命令及说明' },
-            ]
-        });
-        return items;
-    }
-    /** 动态子菜单：根据 cmd 路径返回选项列表（供 menu.query + cmd 使用） */
-    async getSubMenuItems(cmd, channel, channelId, userId, args, overrideIdentity, _explicitChatType) {
-        const session = await this.sessionManager.getActiveSession(channel, channelId);
-        // ── 进程级 /agent list（owners 鉴权） ──
-        if (cmd === '/agent') {
-            if (!isProcessLevelOwner(userId, loadEvolclawConfig().owners)) {
-                throw { code: 'FORBIDDEN', message: '操作需要 owner 权限' };
-            }
-            const res = await execAgentOptions(args);
-            if ('error' in res)
-                throw { code: res.code, message: res.error };
-            return res.data.agents.map(ag => ({ value: ag.aid, label: ag.name || ag.aid, desc: ag.status }));
-        }
-        // ── 关系级 /trigger list（每个 trigger 一个 MenuItem） ──
-        if (cmd === '/trigger') {
-            const owningAgent = this.getOwningAgent(channel);
-            const manager = (owningAgent?.triggerManager ?? this.triggerManager);
-            if (!manager)
-                return [];
-            const scope = args?.options === 'all' ? 'all' : 'enabled';
-            const role = (overrideIdentity ?? this.sessionManager.resolveIdentity(channel, userId)).role;
-            const isAdmin = role === 'owner' || role === 'admin';
-            const all = manager.listAll();
-            const list = scope === 'all' ? all.active.concat(all.history) : manager.listActive();
-            const visible = isAdmin ? list
-                : list.filter((t) => t.createdByPeerId === (userId ?? '') && t.createdByChannel === channel);
-            return visible.map((t) => ({
-                // 透传完整 trigger 字段（ECWeb Triggers 表逐列渲染需要）
-                ...t,
-                value: t.id,
-                label: t.name,
-                desc: `${t.scheduleType}${t.nextFireAt ? ` | 下次 ${new Date(t.nextFireAt).toLocaleString()}` : ''}`,
-                // 状态标识：history 条目带 doneReason（fired/cancelled/expired），active 条目恒为 'active'
-                status: t.doneReason ?? 'active',
-            }));
-        }
-        if (cmd === '/topic') {
-            const identity = overrideIdentity ?? this.sessionManager.resolveIdentity(channel, userId);
-            if (!this.canReadTopics(identity.role)) {
-                throw { code: 'FORBIDDEN', message: '无权限查看话题' };
-            }
-            const sessions = await this.sessionManager.listSessions(channel, channelId);
-            return sessions
-                .filter(s => !!s.threadId)
-                .map(s => this.buildTopicMenuItem(s));
-        }
-        if (cmd === '/s' || cmd === '/session' || cmd === '/del') {
-            const sessions = await this.sessionManager.listSessions(channel, channelId);
-            const active = cmd === '/del' ? await this.sessionManager.getActiveSession(channel, channelId) : null;
-            const currentSession = session;
-            const items = sessions
-                .filter(s => !s.threadId)
-                .filter(s => !active || s.id !== active.id)
-                .map(s => {
-                const displayName = displaySessionTitle(s.name, s.id.slice(0, 8));
-                const item = {
-                    value: s.name || s.id.slice(0, 8),
-                    label: displayName,
-                    selected: currentSession ? s.id === currentSession.id : false,
-                };
-                if (s.agentSessionId) {
-                    item.agentSessionId = s.agentSessionId;
-                    const fileInfo = this.sessionManager.getSessionFileInfo(s.projectPath, s.agentSessionId, s.agentId);
-                    if (fileInfo.turns)
-                        item.turns = fileInfo.turns;
-                    const firstMsg = this.sessionManager.readSessionFirstMessage(s.projectPath, s.agentSessionId, s.agentId);
-                    if (firstMsg)
-                        item.preview = firstMsg.length > 80 ? firstMsg.slice(0, 80) + '…' : firstMsg;
-                }
-                if (s.updatedAt)
-                    item.lastActive = s.updatedAt;
-                return item;
-            });
-            if (cmd === '/s' || cmd === '/session') {
-                items.push({ value: 'cli', label: '查看 CLI 会话', desc: '列出未导入的 CLI 本地会话' });
-            }
-            return items;
-        }
-        if (cmd === '/baseagent') {
-            const currentAgent = session?.agentId;
-            return this.getAvailableBaseagents(channel).map(name => ({ value: name, label: name, selected: name === currentAgent }));
-        }
-        if (cmd === '/model') {
-            const agent = this.getAgent(channel, session?.agentId);
-            if (hasModelSwitcher(agent) && agent.listModels) {
-                const models = await agent.listModels() ?? [];
-                const currentModel = agent.getModel();
-                if (models.length > 0)
-                    return models.map((m) => ({ value: m, label: modelDisplayLabel(agent, m), selected: m === currentModel }));
-            }
-            return null;
-        }
-        // if (cmd === '/restart') {
-        //   const isOwner = userId ? this.sessionManager.resolveIdentity(channel, userId).role === 'owner' : false;
-        //   // 列出所有 channel type
-        //   const visibleTypes = new Set<string>();
-        //   for (const [name] of this.adapters) {
-        //     const t = this.channelTypeMap.get(name);
-        //     if (t) visibleTypes.add(t);
-        //   }
-        //   const channels = [...visibleTypes].map(type => ({ value: type, label: type, desc: '重连此类型所有渠道实例' }));
-        //   if (isOwner) channels.unshift({ value: '', label: '重启服务', desc: '重启整个 EvolClaw 服务进程' });
-        //   return channels;
-        // }
-        if (cmd === '/activity') {
-            const currentMode = this.agentRegistry?.getShowActivities?.(channel) ?? 'all';
-            return [
-                { value: 'all', label: '全部显示', selected: currentMode === 'all' },
-                { value: 'dm', label: '仅私聊显示', selected: currentMode === 'dm-only' },
-                { value: 'owner', label: '仅 owner 私聊显示', selected: currentMode === 'owner-dm-only' },
-                { value: 'none', label: '全部静默', selected: currentMode === 'none' },
-            ];
-        }
-        if (cmd === '/effort') {
-            const agent = this.getAgent(channel, session?.agentId);
-            const currentModel = hasModelSwitcher(agent) ? agent.getModel() : agent.name;
-            const efforts = getAvailableEfforts(agent, currentModel);
-            const currentEffort = agent.getEffort?.() || 'auto';
-            const allItems = [...efforts, 'auto'];
-            return allItems.map(e => ({ value: e, label: e === 'auto' ? 'auto (SDK默认)' : e, selected: e === currentEffort }));
-        }
-        if (cmd === '/chatmode') {
-            // 无活跃会话时，selected 跟随 evolagent.config.chatmode.private 默认值
-            let currentMode;
-            if (session?.sessionMode) {
-                currentMode = session.sessionMode;
-            }
-            else {
-                const evolagent = this.agentRegistry?.resolveByChannel(channel);
-                currentMode = evolagent?.config?.chatmode?.private || 'interactive';
-            }
-            return [
-                { value: 'interactive', label: '交互模式', selected: currentMode === 'interactive' },
-                { value: 'proactive', label: '主动模式', selected: currentMode === 'proactive' },
-            ];
-        }
-        if (cmd === '/dispatch') {
-            const currentMode = session?.metadata?.dispatchMode ?? null;
-            return [
-                { value: 'mention', label: '@提及时响应', selected: currentMode === 'mention' },
-                { value: 'broadcast', label: '所有消息响应', selected: currentMode === 'broadcast' },
-            ];
-        }
-        if (cmd === '/perm') {
-            const currentMode = session?.metadata?.permissionMode ?? DEFAULT_PERMISSION_MODE;
-            const permAgent = this.getAgent(channel, session?.agentId);
-            const validModes = hasPermissionController(permAgent)
-                ? permAgent.listModes().filter(m => m.available).map(m => m.key)
-                : [...PERMISSION_MODE_KEYS];
-            return validModes.map(m => ({ value: m, label: m, selected: m === currentMode }));
-        }
-        return null;
-    }
-    // ── Menu Protocol exec ────────────────────────────────────────────────
-    //
-    // 三个入口对应 menu.query / menu.update / menu.action：
-    //   execMenuQuery  — 查询某项当前值（无会话时多数 fallback 到 evolagent config）
-    //   execMenuUpdate — 写入新值（持久化到 session 或 evolagent config）
-    //   execMenuAction — 触发动词（stop/restart/new/delete/compact/fork/switch/check/upgrade）
-    //
-    // 所有方法返回 { data } 或 { error, code? }。code 是结构化错误码（NO_ACTIVE_SESSION 等），
-    // 客户端可据此决定降级策略。message-bridge 把 code 透传到 menu.response。
-    async loadMenuContext(channel, channelId) {
-        const session = await this.sessionManager.getActiveSession(channel, channelId);
-        const evolagent = this.agentRegistry?.resolveByChannel(channel) ?? null;
-        return { session, evolagent };
-    }
-    requireSession(s) {
-        return s ? null : { error: '当前无活跃会话', code: 'NO_ACTIVE_SESSION' };
-    }
-    /** menu.query — 查询当前值。 */
-    async execMenuQuery(cmd, channel, channelId, userId, args, _explicitChatType) {
-        const cmdBase = cmd.trim().split(' ')[0];
-        if (!cmdBase)
-            return { error: '缺少命令', code: 'MISSING_CMD' };
-        const { session, evolagent } = await this.loadMenuContext(channel, channelId);
-        // ── 进程级 /agent（owners 鉴权） ──
-        if (cmdBase === '/agent') {
-            if (!isProcessLevelOwner(userId, loadEvolclawConfig().owners)) {
-                return { error: '操作需要 owner 权限', code: 'FORBIDDEN' };
-            }
-            return await execAgentQuery(args);
-        }
-        if (cmdBase === '/pwd') {
-            const sessPath = session?.projectPath;
-            const fallbackPath = evolagent?.config?.projects?.defaultPath;
-            const path = sessPath ?? fallbackPath ?? null;
-            const name = path ? this.getProjectName(path) : null;
-            return { data: { name, path } };
-        }
-        if (cmdBase === '/session' || cmdBase === '/s') {
-            if (!session) {
-                return { data: { status: 'no-session' } };
-            }
-            const sessionKey = this.getQueueKey(session, channel, channelId);
-            const sessionAgent = this.getAgent(channel, session.agentId);
-            const isProcessing = this.messageQueue.isProcessing(sessionKey) || sessionAgent.hasActiveStream(sessionKey);
-            const queueLength = this.messageQueue.getQueueLength(sessionKey);
-            const health = await this.sessionManager.getHealthStatus(session.id);
-            let processingDuration;
-            if (isProcessing && session.processingState) {
-                const elapsed = Date.now() - parseInt(session.processingState, 10);
-                if (!isNaN(elapsed) && elapsed > 0)
-                    processingDuration = Math.floor(elapsed / 1000);
-            }
-            let turns = 0;
-            if (session.agentSessionId) {
-                const fileInfo = this.sessionManager.getSessionFileInfo(session.projectPath, session.agentSessionId, session.agentId);
-                turns = fileInfo.turns;
-            }
-            const data = {
-                name: session.name || null,
-                agentSessionId: session.agentSessionId || null,
-                status: isProcessing ? 'processing' : 'idle',
-                createdAt: session.createdAt,
-                updatedAt: session.updatedAt,
-            };
-            if (processingDuration !== undefined)
-                data.processingDuration = processingDuration;
-            if (queueLength > 0)
-                data.queueLength = queueLength;
-            if (turns > 0)
-                data.turns = turns;
-            if (health.lastSuccessTime)
-                data.lastSuccess = health.lastSuccessTime;
-            if (health.consecutiveErrors)
-                data.consecutiveErrors = health.consecutiveErrors;
-            if (health.lastError)
-                data.lastError = { type: health.lastErrorType || 'unknown', message: health.lastError.substring(0, 100) };
-            return { data };
-        }
-        if (cmdBase === '/topic') {
-            const identity = this.sessionManager.resolveIdentity(channel, userId);
-            if (!this.canReadTopics(identity.role)) {
-                return { error: '无权限查看话题', code: 'FORBIDDEN' };
-            }
-            const target = (args?.target ?? '').toString().trim();
-            if (!target)
-                return { error: '缺少 args.target', code: 'MISSING_VALUE' };
-            const topic = await this.sessionManager.getThreadSession(channel, channelId, target);
-            if (!topic)
-                return { error: '话题不存在', code: 'NOT_FOUND' };
-            const sessionKey = this.getQueueKey(topic, channel, channelId);
-            const sessionAgent = this.getAgent(channel, topic.agentId);
-            const isProcessing = this.messageQueue.isProcessing(sessionKey) || sessionAgent.hasActiveStream(sessionKey);
-            const queueLength = this.messageQueue.getQueueLength(sessionKey);
-            const health = await this.sessionManager.getHealthStatus(topic.id);
-            let processingDuration;
-            if (isProcessing && topic.processingState) {
-                const elapsed = Date.now() - parseInt(topic.processingState, 10);
-                if (!isNaN(elapsed) && elapsed > 0)
-                    processingDuration = Math.floor(elapsed / 1000);
-            }
-            let turns = 0;
-            if (topic.agentSessionId) {
-                turns = this.sessionManager.getSessionFileInfo(topic.projectPath, topic.agentSessionId, topic.agentId).turns;
-            }
-            const data = {
-                threadId: topic.threadId,
-                name: topic.name || null,
-                agentSessionId: topic.agentSessionId || null,
-                status: isProcessing ? 'processing' : 'idle',
-                createdAt: topic.createdAt,
-                updatedAt: topic.updatedAt,
-            };
-            if (processingDuration !== undefined)
-                data.processingDuration = processingDuration;
-            if (queueLength > 0)
-                data.queueLength = queueLength;
-            if (turns > 0)
-                data.turns = turns;
-            if (health.lastSuccessTime)
-                data.lastSuccess = health.lastSuccessTime;
-            if (health.consecutiveErrors)
-                data.consecutiveErrors = health.consecutiveErrors;
-            if (health.lastError)
-                data.lastError = { type: health.lastErrorType || 'unknown', message: health.lastError.substring(0, 100) };
-            return { data };
-        }
-        if (cmdBase === '/baseagent') {
-            const value = session?.agentId ?? evolagent?.config?.active_baseagent ?? null;
-            return { data: { baseagent: value } };
-        }
-        if (cmdBase === '/model') {
-            if (session) {
-                const agent = this.getAgent(channel, session.agentId);
-                if (hasModelSwitcher(agent))
-                    return { data: { model: agent.getModel() ?? null } };
-            }
-            const ba = evolagent?.config?.active_baseagent;
-            const block = ba && evolagent ? evolagent.config.baseagents?.[ba] : undefined;
-            return { data: { model: block?.model ?? null } };
-        }
-        if (cmdBase === '/effort') {
-            if (session) {
-                const agent = this.getAgent(channel, session.agentId);
-                const e = agent.getEffort?.();
-                if (e !== undefined)
-                    return { data: { effort: e } };
-            }
-            const ba = evolagent?.config?.active_baseagent;
-            const block = ba && evolagent ? evolagent.config.baseagents?.[ba] : undefined;
-            const fallbackField = ba === 'codex' ? (block?.effort ?? block?.reasoning) : block?.effort;
-            return { data: { effort: fallbackField ?? null } };
-        }
-        if (cmdBase === '/chatmode') {
-            const sessionMode = session?.sessionMode;
-            const fallback = evolagent?.config?.chatmode?.private;
-            return { data: { mode: sessionMode || fallback || 'interactive' } };
-        }
-        if (cmdBase === '/dispatch') {
-            const chatType = session?.chatType || 'private';
-            if (chatType !== 'group') {
-                return { error: 'dispatch 仅在群聊会话中有效', code: 'NOT_APPLICABLE' };
-            }
-            const sessionMode = session?.metadata?.dispatchMode;
-            const fallback = evolagent?.config?.dispatch;
-            return { data: { mode: sessionMode ?? fallback ?? null } };
-        }
-        if (cmdBase === '/observable') {
-            return { data: { observable: evolagent?.getObservable() ?? false } };
-        }
-        if (cmdBase === '/perm') {
-            const need = this.requireSession(session);
-            if (need)
-                return need;
-            const currentMode = session.metadata?.permissionMode ?? DEFAULT_PERMISSION_MODE;
-            return { data: { mode: currentMode } };
-        }
-        if (cmdBase === '/activity') {
-            const currentMode = this.agentRegistry?.getShowActivities?.(channel) ?? 'all';
-            return { data: { mode: currentMode } };
-        }
-        if (cmdBase === '/system') {
-            if (!isProcessLevelOwner(userId, loadEvolclawConfig().owners)) {
-                return { error: '操作需要 owner 权限', code: 'FORBIDDEN' };
-            }
-            const owningAgent = this.getOwningAgent(channel);
-            const data = {
-                agent: owningAgent?.name ?? 'DefaultAgent',
-                channel: this.resolveChannelType(channel),
-                pid: process.pid,
-                node: process.version,
-                uptime: Math.floor(process.uptime()),
-            };
-            try {
-                const pkgPath = path.join(getPackageRoot(), 'package.json');
-                const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
-                if (pkg?.version)
-                    data.version = pkg.version;
-            }
-            catch { }
-            try {
-                const fp = path.join(getPackageRoot(), 'node_modules', '@agentunion', 'fastaun', 'package.json');
-                const fp2 = JSON.parse(fs.readFileSync(fp, 'utf-8'));
-                if (fp2?.version)
-                    data.fastaunVersion = fp2.version;
-            }
-            catch { }
-            const channels = owningAgent?.channelInstanceNames?.() ?? [];
-            if (channels.length)
-                data.channels = channels;
-            return { data };
-        }
-        return { error: `不支持 query: ${cmdBase}`, code: 'NOT_SUPPORTED' };
-    }
-    /** menu.update — 写入新值。 */
-    async execMenuUpdate(cmd, value, channel, channelId, userId, overrideIdentity) {
-        const cmdBase = cmd.trim().split(' ')[0];
-        if (!cmdBase)
-            return { error: '缺少命令', code: 'MISSING_CMD' };
-        const arg = value.trim();
-        if (!arg)
-            return { error: '缺少 value 参数', code: 'MISSING_VALUE' };
-        const { session, evolagent } = await this.loadMenuContext(channel, channelId);
-        const identity = overrideIdentity ?? this.sessionManager.resolveIdentity(channel, userId);
-        // ── 关系级 /trigger update（调度参数，value 为 JSON 字符串） ──
-        if (cmdBase === '/trigger') {
-            const owningAgent = this.getOwningAgent(channel);
-            const manager = (owningAgent?.triggerManager ?? this.triggerManager);
-            const scheduler = (owningAgent?.triggerScheduler ?? this.triggerScheduler);
-            if (!manager || !scheduler)
-                return { error: '触发器功能未启用', code: 'NOT_SUPPORTED' };
-            let patch;
-            try {
-                patch = JSON.parse(arg);
-            }
-            catch {
-                return { error: 'value 需为 JSON', code: 'INVALID_ARGS' };
-            }
-            if (!patch?.nameOrId)
-                return { error: '缺少 nameOrId', code: 'INVALID_ARGS' };
-            const isAdmin = identity.role === 'owner' || identity.role === 'admin';
-            if (!isAdmin && !userId)
-                return { error: '无法确认身份，请确保渠道提供发送者 ID', code: 'FORBIDDEN' };
-            const trigger = isAdmin
-                ? (manager.getByName(patch.nameOrId) ?? manager.getById(patch.nameOrId))
-                : (manager.getByNameScoped(patch.nameOrId, userId ?? '', channel) ?? manager.getByIdScoped(patch.nameOrId, userId ?? '', channel));
-            if (!trigger)
-                return { error: '触发器不存在或无权限', code: 'NOT_FOUND' };
-            const fields = {};
-            if (patch.scheduleType !== undefined)
-                fields.scheduleType = patch.scheduleType;
-            if (patch.scheduleValue !== undefined)
-                fields.scheduleValue = String(patch.scheduleValue);
-            if (patch.prompt !== undefined)
-                fields.prompt = String(patch.prompt);
-            // 调度参数变化时重算 nextFireAt——先校验避免 NaN 污染 scheduler heap
-            if (fields.scheduleType !== undefined || fields.scheduleValue !== undefined) {
-                const effType = fields.scheduleType ?? trigger.scheduleType;
-                const effValue = fields.scheduleValue ?? trigger.scheduleValue;
-                const schedErr = validateScheduleParams(effType, effValue);
-                if (schedErr)
-                    return { error: schedErr, code: 'INVALID_ARGS' };
-                fields.nextFireAt = calcNextFireAt(effType, effValue, Date.now());
-            }
-            let updated;
-            try {
-                updated = manager.update(trigger.id, fields);
-            }
-            catch (err) {
-                return { error: `更新失败：${err?.message || err}`, code: 'INVALID_ARGS' };
-            }
-            scheduler.update(updated);
-            return { data: { id: updated.id, nextFireAt: updated.nextFireAt } };
-        }
-        if (cmdBase === '/baseagent') {
-            const valid = this.getAvailableBaseagents(channel);
-            if (valid.length && !valid.includes(arg)) {
-                return { error: `无效 baseagent: ${arg}，可选: ${valid.join(' / ')}`, code: 'INVALID_VALUE' };
-            }
-            // 当前会话切换走 slash 命令的完整逻辑（涉及 runner 状态、session.agentId 重新挂载等）
-            // 仅在 slash 命令成功后才持久化到 evolagent config，避免失败时配置已落盘
-            if (session && session.agentId !== arg) {
-                const result = await this._handleInternal(`/baseagent ${arg}`, channel, channelId, undefined, userId);
-                const payload = result;
-                if (payload?.kind === 'command.error') {
-                    return { error: payload.text || '切换失败', code: 'EXEC_FAILED' };
-                }
-            }
-            // 持久化到 evolagent config（影响后续新会话）
-            if (evolagent)
-                evolagent.setActiveBaseagent(arg);
-            return { data: { baseagent: arg } };
-        }
-        if (cmdBase === '/model') {
-            const agent = this.getAgent(channel, session?.agentId);
-            if (hasModelSwitcher(agent)) {
-                const models = (await agent.listModels?.()) ?? [];
-                if (models.length && !models.includes(arg)) {
-                    return { error: `无效模型: ${arg}`, code: 'INVALID_VALUE' };
-                }
-                agent.setModel(arg);
-            }
-            if (evolagent)
-                evolagent.setBaseagentModel(arg);
-            return { data: { model: arg } };
-        }
-        if (cmdBase === '/effort') {
-            const agent = this.getAgent(channel, session?.agentId);
-            const currentModel = hasModelSwitcher(agent) ? agent.getModel() : agent.name;
-            const validEfforts = getAvailableEfforts(agent, currentModel);
-            const allValid = [...validEfforts, 'auto'];
-            if (!allValid.includes(arg)) {
-                return { error: `无效推理强度: ${arg}，可选: ${allValid.join(' / ')}`, code: 'INVALID_VALUE' };
-            }
-            if (typeof agent.setEffort === 'function') {
-                agent.setEffort(arg === 'auto' ? undefined : arg);
-            }
-            if (evolagent)
-                evolagent.setBaseagentEffort(arg === 'auto' ? undefined : arg);
-            return { data: { effort: arg } };
-        }
-        if (cmdBase === '/chatmode') {
-            if (arg !== 'interactive' && arg !== 'proactive') {
-                return { error: `无效模式: ${arg}`, code: 'INVALID_VALUE' };
-            }
-            if (session) {
-                const chatType = session.chatType || 'private';
-                if (chatType === 'group' && identity.role !== 'owner' && identity.role !== 'admin') {
-                    return { error: '无权限：群聊中仅管理员可切换', code: 'NO_PERMISSION' };
-                }
-                await this.sessionManager.updateSession(session.id, { sessionMode: arg });
-                this.eventBus.publish({ type: 'session:chat-mode-changed', sessionId: session.id, mode: arg, timestamp: Date.now() });
-            }
-            else {
-                if (evolagent)
-                    evolagent.setChatmodePrivate(arg);
-            }
-            return { data: { mode: arg } };
-        }
-        if (cmdBase === '/dispatch') {
-            if (arg !== 'mention' && arg !== 'broadcast') {
-                return { error: `无效模式: ${arg}`, code: 'INVALID_VALUE' };
-            }
-            const chatType = session?.chatType;
-            if (!session || chatType !== 'group') {
-                return { error: 'dispatch 仅在群聊会话中有效', code: 'NOT_APPLICABLE' };
-            }
-            if (identity.role !== 'owner' && identity.role !== 'admin') {
-                return { error: '无权限：群聊中仅管理员可切换', code: 'NO_PERMISSION' };
-            }
-            const metadata = { ...(session.metadata || {}), dispatchMode: arg };
-            await this.sessionManager.updateSession(session.id, { metadata });
-            this.eventBus.publish({ type: 'session:dispatch-mode-changed', sessionId: session.id, mode: arg, timestamp: Date.now() });
-            return { data: { mode: arg } };
-        }
-        if (cmdBase === '/perm') {
-            const need = this.requireSession(session);
-            if (need)
-                return need;
-            if (identity.role !== 'owner')
-                return { error: '无权限', code: 'NO_PERMISSION' };
-            const permAgent = this.getAgent(channel, session.agentId);
-            const validModes = hasPermissionController(permAgent)
-                ? permAgent.listModes().filter(m => m.available).map(m => m.key)
-                : [...PERMISSION_MODE_KEYS];
-            if (!validModes.includes(arg))
-                return { error: `无效模式: ${arg}`, code: 'INVALID_VALUE' };
-            const metadata = { ...(session.metadata || {}), permissionMode: arg };
-            await this.sessionManager.updateSession(session.id, { metadata });
-            return { data: { mode: arg } };
-        }
-        if (cmdBase === '/activity') {
-            const modeMap = { all: 'all', dm: 'dm-only', owner: 'owner-dm-only', none: 'none' };
-            const newMode = modeMap[arg];
-            if (!newMode)
-                return { error: `无效模式: ${arg}，可选: all / dm / owner / none`, code: 'INVALID_VALUE' };
-            if (identity.role !== 'owner')
-                return { error: '中间输出模式切换仅限 owner', code: 'NO_PERMISSION' };
-            if (!this.agentRegistry?.setShowActivities)
-                return { error: '找不到通道所属 agent，无法持久化', code: 'EXEC_FAILED' };
-            this.agentRegistry.setShowActivities(channel, newMode);
-            return { data: { mode: newMode } };
-        }
-        if (cmdBase === '/observable') {
-            if (identity.role !== 'owner')
-                return { error: '观察者模式仅限 owner 开关', code: 'NO_PERMISSION' };
-            if (arg !== 'true' && arg !== 'false')
-                return { error: `无效值: ${arg}，可选: true / false`, code: 'INVALID_VALUE' };
-            if (!evolagent)
-                return { error: '找不到通道所属 agent，无法持久化', code: 'EXEC_FAILED' };
-            evolagent.setObservable(arg === 'true');
-            return { data: { observable: arg === 'true' } };
-        }
-        return { error: `不支持 update: ${cmdBase}`, code: 'NOT_SUPPORTED' };
-    }
-    /** menu.action — 触发动词。 */
-    async execMenuAction(cmd, action, args, channel, channelId, userId, overrideIdentity, explicitChatType) {
-        const cmdBase = cmd.trim().split(' ')[0];
-        if (!cmdBase)
-            return { error: '缺少命令', code: 'MISSING_CMD' };
-        if (!action)
-            return { error: '缺少 action', code: 'MISSING_VALUE' };
-        const { session } = await this.loadMenuContext(channel, channelId);
-        const identity = overrideIdentity ?? this.sessionManager.resolveIdentity(channel, userId);
-        // ── 进程级 /agent（owners 鉴权，不依赖 session/channel） ──
-        // NOTE(D5): 本次进程级 /agent 仅按 evolclaw.json owners 鉴权，任意 evolagent 的 AUN
-        // channel 均可作为入口。part1（daemon 控制 AID）落地后，应叠加 isControlChannel(channelId)
-        // 闸：仅控制 AID channel 上的 /agent /system 生效。见 part1 计划。
-        if (cmdBase === '/agent') {
-            if (!isProcessLevelOwner(userId, loadEvolclawConfig().owners)) {
-                return { error: '操作需要 owner 权限', code: 'FORBIDDEN' };
-            }
-            const a = { ...(args ?? {}) };
-            if (action === 'create') {
-                a.project = resolveProjectPath(a.project, a.aid ?? '', loadDefaults());
-            }
-            // reload / disable / delete 会中断 agent 正在处理的任务，执行前检查是否繁忙。
-            // 队列按 agent 名计数，故先用 registry 把 aid 解析成 name；force 跳过。
-            if ((action === 'reload' || action === 'disable' || action === 'delete') && a.aid && !a.force) {
-                const handle = this.agentRegistry?.get(a.aid) ?? null;
-                const agentName = handle?.name;
-                if (agentName) {
-                    const busy = this.messageQueue.getProcessingCountByAgent(agentName)
-                        + this.messageQueue.getQueueLengthByAgent(agentName);
-                    if (busy > 0) {
-                        return { error: `该 Agent 有 ${busy} 个任务执行中`, code: 'BUSY' };
-                    }
-                }
-            }
-            return await execAgentAction(action, a, userId ?? '');
-        }
-        // ── 关系级 /trigger（不走 owners；复用 isAdmin + scoped 逻辑，D4 直调底层） ──
-        if (cmdBase === '/trigger') {
-            const role = identity.role;
-            const isAdmin = role === 'owner' || role === 'admin';
-            const owningAgent = this.getOwningAgent(channel);
-            const manager = (owningAgent?.triggerManager ?? this.triggerManager);
-            const scheduler = (owningAgent?.triggerScheduler ?? this.triggerScheduler);
-            if (!manager || !scheduler)
-                return { error: '触发器功能未启用', code: 'NOT_SUPPORTED' };
-            if (action === 'set') {
-                // args 结构化 → 直接组装 ParsedTriggerSet（绕过 parseTriggerSet 文本解析，无注入风险）
-                if (!args?.scheduleType || !args?.scheduleValue || !args?.prompt) {
-                    return { error: '缺少必填参数：scheduleType / scheduleValue / prompt', code: 'INVALID_ARGS' };
-                }
-                // menu 路径绕过了 parseTriggerSet 的校验，必须自行校验枚举/数值，
-                // 否则非法值会传到 calcNextFireAt 产出 NaN nextFireAt，污染 scheduler heap。
-                const schedErr = validateScheduleParams(args.scheduleType, String(args.scheduleValue));
-                if (schedErr)
-                    return { error: schedErr, code: 'INVALID_ARGS' };
-                const strategy = args.targetSessionStrategy ?? 'latest';
-                if (!['latest', 'current', 'thread'].includes(strategy)) {
-                    return { error: `无效 targetSessionStrategy: ${strategy}`, code: 'INVALID_ARGS' };
-                }
-                const parsed = {
-                    scheduleType: args.scheduleType,
-                    scheduleValue: String(args.scheduleValue),
-                    prompt: String(args.prompt),
-                    name: args.name,
-                    targetChannel: args.targetChannel,
-                    targetChannelId: args.targetChannelId,
-                    targetThreadId: args.targetThreadId,
-                    targetSessionStrategy: strategy,
-                    agentId: args.agentId,
-                };
-                const r = await this.registerTriggerFromParsed(parsed, channel, channelId, userId ?? '', undefined);
-                if (!r.ok)
-                    return { error: r.error, code: /已存在|exists|重复/.test(r.error) ? 'CONFLICT' : 'INVALID_ARGS' };
-                return { data: { id: r.trigger.id, name: r.trigger.name, nextFireAt: r.trigger.nextFireAt } };
-            }
-            if (action === 'cancel') {
-                const nameOrId = args?.nameOrId;
-                if (!nameOrId)
-                    return { error: '缺少 nameOrId', code: 'INVALID_ARGS' };
-                if (!isAdmin && !userId)
-                    return { error: '无法确认身份，请确保渠道提供发送者 ID', code: 'FORBIDDEN' };
-                const trigger = isAdmin
-                    ? (manager.getByName(nameOrId) ?? manager.getById(nameOrId))
-                    : (manager.getByNameScoped(nameOrId, userId ?? '', channel) ?? manager.getByIdScoped(nameOrId, userId ?? '', channel));
-                if (!trigger)
-                    return { error: '触发器不存在或无权限', code: 'NOT_FOUND' };
-                manager.moveToDone(trigger.id, 'cancelled');
-                scheduler.cancel(trigger.id);
-                this.eventBus.publish({ type: 'trigger:cancelled', triggerId: trigger.id, name: trigger.name, by: userId ?? '' });
-                return { data: { id: trigger.id, cancelled: true } };
-            }
-            return { error: `不支持的 trigger action: ${action}`, code: 'INVALID_ARGS' };
-        }
-        if (cmdBase === '/topic') {
-            if (action !== 'delete') {
-                return { error: `不支持的 topic action: ${action}`, code: 'NOT_SUPPORTED' };
-            }
-            const target = (args?.target ?? '').toString().trim();
-            if (!target)
-                return { error: '缺少 args.target', code: 'MISSING_VALUE' };
-            const topic = await this.sessionManager.getThreadSession(channel, channelId, target);
-            if (!topic)
-                return { error: '话题不存在', code: 'NOT_FOUND' };
-            const chatType = this.resolveMenuChatType(channel, channelId, explicitChatType);
-            if (!this.canDeleteTopic(identity.role, chatType, topic, userId)) {
-                return { error: '无权限删除话题', code: 'FORBIDDEN' };
-            }
-            const success = await this.sessionManager.unbindSession(topic.id);
-            if (!success)
-                return { error: '删除失败', code: 'DELETE_FAILED' };
-            this.eventBus.publish({ type: 'session:deleted', sessionId: topic.id });
-            const targetAgent = this.getAgent(channel, topic.agentId);
-            await targetAgent.closeSession?.(topic.id);
-            return { data: { deleted: true } };
-        }
-        // ── /session 系列 ──
-        if (cmdBase === '/session' || cmdBase === '/s') {
-            if (action === 'stop') {
-                if (!session)
-                    return { error: '当前无活跃会话', code: 'NO_ACTIVE_SESSION' };
-                const sessionKey = this.getQueueKey(session, channel, channelId);
-                const sessionAgent = this.getAgent(channel, session.agentId);
-                const hasActive = sessionAgent.hasActiveStream(sessionKey);
-                const queueLength = this.messageQueue.getQueueLength(sessionKey);
-                if (queueLength === 0 && !hasActive) {
-                    return { error: '当前没有正在处理的任务', code: 'NO_ACTIVE_TASK' };
-                }
-                await sessionAgent.interrupt(sessionKey);
-                this.eventBus.publish({
-                    type: 'task:interrupted',
-                    sessionId: sessionKey,
-                    reason: 'stop',
-                    agentName: this.agentRegistry?.resolveByChannel(channel)?.name ?? '<unknown>',
-                });
-                this.sessionManager.clearProcessing(sessionKey);
-                return { data: { action: 'stop', success: true } };
-            }
-            if (action === 'new') {
-                const name = (args?.name ?? '').toString().trim();
-                return await this.delegateAsAction(action, name ? `/new ${name}` : '/new', channel, channelId, userId, { enrichSession: true });
-            }
-            if (action === 'delete') {
-                const target = (args?.target ?? '').toString().trim();
-                if (!target)
-                    return { error: '缺少 args.target', code: 'MISSING_VALUE' };
-                return await this.delegateAsAction(action, `/del ${target}`, channel, channelId, userId);
-            }
-            if (action === 'switch') {
-                const target = (args?.target ?? '').toString().trim();
-                if (!target)
-                    return { error: '缺少 args.target', code: 'MISSING_VALUE' };
-                return await this.delegateAsAction(action, `/s ${target}`, channel, channelId, userId, { enrichSession: true });
-            }
-            if (action === 'compact') {
-                const need = this.requireSession(session);
-                if (need)
-                    return need;
-                return await this.delegateAsAction(action, '/compact', channel, channelId, userId);
-            }
-            if (action === 'fork') {
-                const need = this.requireSession(session);
-                if (need)
-                    return need;
-                const name = (args?.name ?? '').toString().trim();
-                return await this.delegateAsAction(action, name ? `/fork ${name}` : '/fork', channel, channelId, userId, { enrichSession: true });
-            }
-            return { error: `不支持的 session action: ${action}`, code: 'NOT_SUPPORTED' };
-        }
-        // ── /system 系列 ──
-        if (cmdBase === '/system') {
-            // D1 迁移：进程级鉴权统一查 evolclaw.json owners，替代各 action 内联的 identity.role 判断
-            if (!isProcessLevelOwner(userId, loadEvolclawConfig().owners)) {
-                return { error: '操作需要 owner 权限', code: 'FORBIDDEN' };
-            }
-            if (action === 'restart') {
-                const restartInfo = { channel, channelId, timestamp: Date.now() };
-                fs.writeFileSync(path.join(resolvePaths().dataDir, 'restart-pending.json'), JSON.stringify(restartInfo));
-                const { spawn } = await import('child_process');
-                spawn('node', [path.join(getPackageRoot(), 'dist', 'cli', 'index.js'), 'restart-monitor'], {
-                    detached: true,
-                    stdio: 'ignore',
-                    env: { ...process.env, EVOLCLAW_HOME: resolvePaths().root }
-                }).unref();
-                this.eventBus.publish({ type: 'system:restart', channel, channelId });
-                setTimeout(() => { process.kill(process.pid, 'SIGTERM'); }, 1000);
-                return { data: { action: 'restart', success: true } };
-            }
-            if (action === 'check') {
-                const r = await this.delegateAsAction(action, '/check', channel, channelId, userId, { overrideIdentity });
-                const structured = r.data?.structured ?? null;
-                if (structured)
-                    return { data: { ...r.data, ...structured } };
-                return r;
-            }
-            if (action === 'upgrade') {
-                const devMode = isLinkedInstall();
-                const localEvolclaw = getLocalVersion();
-                // fastaun 本地版本：从 node_modules 读取（与 menu.query name=system 一致）
-                let localFastaun = null;
-                try {
-                    const fp = path.join(getPackageRoot(), 'node_modules', '@agentunion', 'fastaun', 'package.json');
-                    localFastaun = JSON.parse(fs.readFileSync(fp, 'utf-8'))?.version ?? null;
-                }
-                catch { }
-                const [evolclawRemote, fastaunRemote, ecwebRemote] = await Promise.all([
-                    checkLatestVersion('evolclaw'),
-                    checkLatestVersion('@agentunion/fastaun'),
-                    checkLatestVersion('evolclaw-web'),
-                ]);
-                const cmp = (local, remote) => !!(local && remote && compareVersions(local, remote) < 0);
-                return {
-                    data: {
-                        devMode,
-                        evolclaw: { local: localEvolclaw, remote: evolclawRemote, hasUpdate: cmp(localEvolclaw, evolclawRemote) },
-                        fastaun: { local: localFastaun, remote: fastaunRemote, hasUpdate: cmp(localFastaun, fastaunRemote) },
-                        // ecweb 本地版本由 ECWeb 进程自身注入（data.ecwebVersion），此处仅给 remote
-                        ecweb: { remote: ecwebRemote },
-                    },
-                };
-            }
-            return { error: `不支持的 system action: ${action}`, code: 'NOT_SUPPORTED' };
-        }
-        // ── /cli 透传 ──
-        if (cmdBase === '/cli') {
-            if (action !== 'exec')
-                return { error: `不支持的 cli action: ${action}`, code: 'NOT_SUPPORTED' };
-            if (identity.role !== 'owner')
-                return { error: '无权限：CLI 执行仅限 owner', code: 'NO_PERMISSION' };
-            const argv = Array.isArray(args?.argv) ? args.argv.map((x) => String(x))
-                : typeof args?.command === 'string' ? tokenizeArgv(args.command)
-                    : null;
-            if (!argv || argv.length === 0)
-                return { error: '缺少 argv 或 command', code: 'MISSING_VALUE' };
-            const allowed = CLI_EXEC_WHITELIST[argv[0]];
-            if (!allowed)
-                return { error: `命令不在白名单: ${argv[0]}`, code: 'NOT_ALLOWED' };
-            if (allowed !== '*' && !allowed.has(argv[1] ?? '')) {
-                return { error: `子命令不在白名单: ${argv[0]} ${argv[1] ?? ''}`, code: 'NOT_ALLOWED' };
-            }
-            return await this.execCliPassthrough(argv);
-        }
-        return { error: `不支持 action: ${cmdBase}`, code: 'NOT_SUPPORTED' };
-    }
-    /** ECWeb 专用入口：注入 owner identity，进程级操作检查 owners 非空。不暴露 cli。 */
-    async execMenuForEcweb(payload) {
-        const id = payload?.id ?? '';
-        const name = payload?.name;
-        if (name === 'cli' || payload?.cmd === '/cli') {
-            return { type: 'menu.response', id, name, error: { code: 'NOT_SUPPORTED', message: 'cli 不在 ECWeb 控制范围' } };
-        }
-        const isProcessLevel = name === 'system' || name === 'agent';
-        const owners = loadEvolclawConfig().owners ?? [];
-        if (isProcessLevel && owners.length === 0) {
-            return { type: 'menu.response', id, name, error: { code: 'FORBIDDEN', message: '请在 evolclaw.json 配置 owners 后使用进程级操作' } };
-        }
-        const ECWEB_CHANNEL = '__ecweb__';
-        // payload.agent（aid 或 name）时，用该 agent 的首个 channel 实例作为 channel 参数，
-        // 让 execMenuQuery / execMenuUpdate 能按真实 agent 解析 model/effort/perm 等会话级配置。
-        // system / agent 两个进程级 name 不走此路径，仍用 ECWEB_CHANNEL。
-        const agentChannelKey = (() => {
-            if (!payload?.agent || isProcessLevel)
-                return ECWEB_CHANNEL;
-            const handle = this.agentRegistry?.get(payload.agent) ?? null;
-            return handle?.channelInstanceNames()?.[0] ?? ECWEB_CHANNEL;
-        })();
-        const ownerIdentity = { role: 'owner', mode: 'interactive' };
-        // 进程级操作用 owners[0] 让 isProcessLevelOwner() 通过；其余传 undefined
-        const userId = isProcessLevel ? (owners[0] ?? '') : undefined;
-        const nameMap = {
-            pwd: '/pwd', session: '/session', baseagent: '/baseagent', model: '/model',
-            topic: '/topic',
-            effort: '/effort', chatmode: '/chatmode', dispatch: '/dispatch',
-            permission: '/perm', activity: '/activity', system: '/system',
-            agent: '/agent', trigger: '/trigger',
-        };
-        const cmd = name ? (nameMap[name] ?? payload.cmd) : payload.cmd;
-        try {
-            switch (payload?.type) {
-                case 'menu.list':
-                    return { type: 'menu.response', id, data: this.getMenuItems('owner', 'private') };
-                case 'menu.query': {
-                    if (!cmd)
-                        return ecwebErr(id, name, 'MISSING_CMD', '缺少 name/cmd');
-                    const r = await this.execMenuQuery(cmd, agentChannelKey, agentChannelKey, userId, payload.args);
-                    return ecwebResp(id, name, r);
-                }
-                case 'menu.options': {
-                    if (!cmd)
-                        return ecwebErr(id, name, 'MISSING_CMD', '缺少 name/cmd');
-                    const data = await this.getSubMenuItems(cmd, agentChannelKey, agentChannelKey, userId, payload.args, ownerIdentity) ?? [];
-                    return { type: 'menu.response', id, name, data };
-                }
-                case 'menu.update': {
-                    if (!cmd)
-                        return ecwebErr(id, name, 'MISSING_CMD', '缺少 name/cmd');
-                    if (!payload.value)
-                        return ecwebErr(id, name, 'MISSING_VALUE', '缺少 value');
-                    const r = await this.execMenuUpdate(cmd, payload.value, agentChannelKey, agentChannelKey, userId, ownerIdentity);
-                    return ecwebResp(id, name, r);
-                }
-                case 'menu.action': {
-                    if (!cmd)
-                        return ecwebErr(id, name, 'MISSING_CMD', '缺少 name/cmd');
-                    if (!payload.action)
-                        return ecwebErr(id, name, 'MISSING_VALUE', '缺少 action');
-                    const r = await this.execMenuAction(cmd, payload.action, payload.args, agentChannelKey, agentChannelKey, userId, ownerIdentity);
-                    return ecwebResp(id, name, r);
-                }
-                default:
-                    return ecwebErr(id, name, 'NOT_SUPPORTED', `未知类型: ${payload?.type}`);
-            }
-        }
-        catch (e) {
-            return ecwebErr(id, name, 'INTERNAL', e?.message ?? String(e));
-        }
-    }
-    /**
-     * CLI 透传执行：spawn `node dist/cli/index.js <argv>` 子进程，捕获输出回传。
-     * 不 in-process 调用（CLI handler 用 console.log + process.exit，spawn 行为与终端一致且隔离）。
-     * 调用方已完成 owner 校验与白名单过滤。
-     */
-    async execCliPassthrough(argv) {
-        const { spawn } = await import('child_process');
-        const cliEntry = path.join(getPackageRoot(), 'dist', 'cli', 'index.js');
-        const startedAt = Date.now();
-        return await new Promise((resolve) => {
-            let stdout = '';
-            let stderr = '';
-            let total = 0;
-            let truncated = false;
-            let settled = false;
-            const child = spawn('node', [cliEntry, ...argv], {
-                env: { ...process.env, EVOLCLAW_HOME: resolvePaths().root },
-                windowsHide: true,
-            });
-            const append = (buf, sink) => {
-                if (truncated)
-                    return;
-                const remaining = CLI_EXEC_MAX_OUTPUT - total;
-                if (remaining <= 0) {
-                    truncated = true;
-                    return;
-                }
-                const chunk = buf.length > remaining ? buf.subarray(0, remaining) : buf;
-                total += chunk.length;
-                if (sink === 'out')
-                    stdout += chunk.toString('utf-8');
-                else
-                    stderr += chunk.toString('utf-8');
-                if (buf.length > remaining)
-                    truncated = true;
-            };
-            child.stdout?.on('data', (b) => append(b, 'out'));
-            child.stderr?.on('data', (b) => append(b, 'err'));
-            const timer = setTimeout(() => {
-                if (settled)
-                    return;
-                settled = true;
-                try {
-                    child.kill('SIGKILL');
-                }
-                catch { }
-                logger.warn(`[CommandHandler] cli exec timeout: ${argv.join(' ')}`);
-                resolve({ error: `执行超时（${CLI_EXEC_TIMEOUT_MS / 1000}s）：${argv[0]}`, code: 'TIMEOUT' });
-            }, CLI_EXEC_TIMEOUT_MS);
-            child.on('error', (e) => {
-                if (settled)
-                    return;
-                settled = true;
-                clearTimeout(timer);
-                resolve({ error: e?.message || String(e), code: 'INTERNAL' });
-            });
-            child.on('close', (exitCode) => {
-                if (settled)
-                    return;
-                settled = true;
-                clearTimeout(timer);
-                resolve({ data: {
-                        exitCode: exitCode ?? -1,
-                        stdout, stderr, truncated,
-                        durationMs: Date.now() - startedAt,
-                    } });
-            });
-        });
-    }
-    /** 把 menu.action 委派给已有 slash 命令处理逻辑，把 OutboundPayload 包成结构化结果。 */
-    async delegateAsAction(action, slashCmd, channel, channelId, userId, opts = {}) {
-        try {
-            const result = await this._handleInternal(slashCmd, channel, channelId, undefined, userId, undefined, undefined, undefined, undefined, undefined, opts.overrideIdentity);
-            if (result == null) {
-                // null / undefined: 命令未识别或前置守卫拦截（如 idle 检查），视为失败
-                return { error: '命令未执行（可能被前置守卫拦截）', code: 'EXEC_FAILED' };
-            }
-            if (typeof result !== 'object' || !('kind' in result)) {
-                return { data: { action, success: true } };
-            }
-            const payload = result;
-            if (payload.kind === 'command.error') {
-                return { error: payload.text || '执行失败', code: 'EXEC_FAILED' };
-            }
-            const data = { action, success: true };
-            if (payload.text)
-                data.message = payload.text;
-            if (payload.structured)
-                data.structured = payload.structured;
-            // 对于切换/创建类动作，附加切换后的活跃 session 信息便于客户端继续操作
-            if (opts.enrichSession) {
-                const newSession = await this.sessionManager.getActiveSession(channel, channelId);
-                if (newSession) {
-                    data.session = { id: newSession.id, name: newSession.name || null };
-                    if (newSession.agentSessionId)
-                        data.session.agentSessionId = newSession.agentSessionId;
-                }
-            }
-            return { data };
-        }
-        catch (e) {
-            return { error: e?.message || String(e), code: 'INTERNAL' };
-        }
-    }
-    isCommand(content) {
-        return content === '/s' || quickCommandPrefixes.some(cmd => content.startsWith(cmd));
-    }
-    /**
-     * 主命令处理入口
-     */
-    async handle(content, channel, channelId, sendMessage, userId, threadId, chatType, source, messageId, selfAID) {
-        const result = await this._handleInternal(content, channel, channelId, sendMessage, userId, threadId, chatType, source, messageId, selfAID);
-        return result;
-    }
-    async _handleInternal(content, channel, channelId, sendMessage, userId, threadId, chatType, source, messageId, selfAID, overrideIdentity) {
-        // 卡片回调的 chatType 不可靠（飞书 bot 单聊 chatId 也是 oc_ 前缀），
-        // 不应覆盖 session 中已有的正确值
-        if (source === 'card-trigger')
-            chatType = undefined;
-        // 解析身份（按实例名）
-        const identity = overrideIdentity ?? this.sessionManager.resolveIdentity(channel, userId);
-        const policy = this.getPolicy(channel);
-        // 按当前会话选择 agent 后端
-        const activeSession = await this.sessionManager.getActiveSession(channel, channelId);
-        const agent = this.getAgent(channel, activeSession?.agentId);
-        // 规范化命令（将别名转换为完整命令）
-        let normalizedContent = content;
-        for (const [alias, full] of Object.entries(aliases)) {
-            if (content === alias || content.startsWith(alias + ' ')) {
-                normalizedContent = content.replace(alias, full);
-                break;
-            }
-        }
-        if (normalizedContent !== content) {
-            logger.debug(`[CommandHandler] normalized: "${content}" -> "${normalizedContent}"`);
-        }
-        logger.info(`[CommandHandler] handle: channel=${channel} channelId=${channelId} cmd="${normalizedContent.split(' ')[0]}" user=${userId ?? 'n/a'} role=${identity?.role ?? 'n/a'}`);
-        // 话题内禁用部分命令
-        if (threadId) {
-            const threadBlocked = ['/new', '/slist', '/s', '/session', '/fork', '/del', '/baseagent'];
-            const isBlocked = threadBlocked.some(c => normalizedContent === c || normalizedContent.startsWith(c + ' '));
-            if (isBlocked) {
-                return { kind: 'command.error', text: '⚠️ 话题中不支持此命令' };
-            }
-        }
-        // Agent-owned 通道：禁止项目切换和 agent 切换
-        // 权限检查：区分用户级命令和管理级命令
-        const isOwner = identity.role === 'owner';
-        const isAdmin = identity.role === 'owner' || identity.role === 'admin';
-        const activeChatType = activeSession?.chatType || 'private';
-        if (normalizedContent.startsWith('/')) {
-            // guest 在群聊和私聊中均可访问的只读命令：纯查询形态（带参写操作由各 handler 内部守卫拦截）
-            const guestGroupCommands = [
-                '/status', '/help', '/evolhelp', '/check', '/chatmode', '/dispatch',
-                '/model', '/setmodel', '/effort', '/baseagent', '/perm', '/activity', '/safe', '/stop',
-                '/resume', '/trigger',
-            ];
-            const userCommands = activeChatType === 'group' && !isAdmin
-                ? guestGroupCommands
-                : [
-                    ...guestGroupCommands,
-                    // 私聊 guest 额外可用：会话自管理 + 私聊专属的 /rewind 历史查看
-                    '/slist', '/new', '/session', '/rename', '/name', '/del', '/s ', '/rewind',
-                ];
-            const isUserCommand = userCommands.some(cmd => normalizedContent === cmd.trimEnd() || normalizedContent.startsWith(cmd));
-            if (!isUserCommand && !isAdmin) {
-                return { kind: 'command.error', text: activeChatType === 'group'
-                        ? '❌ 无权限：当前群聊仅支持 /status 和 /help'
-                        : '❌ 无权限：此命令仅限管理员使用' };
-            }
-        }
-        // 空闲检查：某些命令需要等待当前会话空闲
-        // 原则：仅对"写/破坏性"形态拦截，纯读/用法提示的无参形态始终放行
-        // - 始终需要 idle（无参即写）：/compact /repair /fork /new
-        // - 仅带参时需要 idle（无参是列表/用法）：/session /baseagent /rewind
-        // - /chatmode：在 handler 内部自行做写操作的 idle 检查
-        // - /dispatch：在 handler 内部自行做写操作的 idle 检查
-        // - /safe：已禁用 no-op，不再要求 idle
-        const idleAlways = ['/compact', '/repair', '/fork', '/new'];
-        const idleWhenArg = ['/session', '/baseagent', '/rewind'];
-        const needsIdle = idleAlways.some(cmd => normalizedContent === cmd || normalizedContent.startsWith(cmd + ' ')) ||
-            idleWhenArg.some(cmd => normalizedContent.startsWith(cmd + ' '));
-        if (needsIdle) {
-            if (threadId) {
-                // 话题中：检查话题 session 是否在处理（不创建）
-                const threadSession = await this.sessionManager.getThreadSession(channel, channelId, threadId);
-                if (threadSession) {
-                    const threadAgent = this.getAgent(channel, threadSession.agentId);
-                    const isBusy = threadAgent.hasActiveStream(threadSession.id) ||
-                        this.messageQueue?.isProcessing(threadSession.id);
-                    if (isBusy) {
-                        return { kind: 'command.error', text: '⚠️ 当前正在处理消息，请稍后再试\n使用 /stop 中断当前任务后重试' };
-                    }
-                }
-            }
-            else if (activeSession) {
-                const isBusy = agent.hasActiveStream(activeSession.id) ||
-                    this.messageQueue?.isProcessing(activeSession.id);
-                if (isBusy) {
-                    return { kind: 'command.error', text: '⚠️ 当前正在处理消息，请稍后再试\n使用 /stop 中断当前任务后重试' };
-                }
-            }
-        }
-        // 检查是否以 / 开头（可能是命令）
-        if (normalizedContent.startsWith('/')) {
-            const inputCmd = normalizedContent.split(' ')[0];
-            const isValidCommand = commands.some(cmd => normalizedContent.startsWith(cmd)) ||
-                deprecatedCommands.some(cmd => normalizedContent === cmd || normalizedContent.startsWith(cmd + ' '));
-            if (!isValidCommand) {
-                const similar = commands.find(cmd => {
-                    const distance = levenshteinDistance(inputCmd, cmd);
-                    return distance <= 2;
-                });
-                if (similar) {
-                    return { kind: 'command.error', text: `❌ 未知命令: ${inputCmd}\n💡 你是不是想输入: ${similar}\n\n输入 /help 查看所有可用命令` };
-                }
-                else {
-                    return { kind: 'command.error', text: `❌ 未知命令: ${inputCmd}\n\n输入 /help 查看所有可用命令` };
-                }
-            }
-        }
-        const isCmd = commands.some(cmd => normalizedContent.startsWith(cmd)) ||
-            deprecatedCommands.some(cmd => normalizedContent === cmd || normalizedContent.startsWith(cmd + ' '));
-        if (!isCmd)
-            return undefined;
-        // /help 命令不需要会话
-        if (normalizedContent === '/help') {
-            if (!isAdmin && activeChatType === 'group') {
-                const lines = [
-                    '可用命令：',
-                    '',
-                    '其他：',
-                    '  /status - 显示会话状态',
-                    '  /check - 检查渠道健康',
-                    '  /help - 显示此帮助信息',
-                ];
-                return { kind: 'command.result', text: lines.join('\n') };
-            }
-            if (!isAdmin) {
-                const lines = [
-                    '可用命令：',
-                    '',
-                    '🔄 会话管理：',
-                    '  /new [名称] - 创建新会话（清空历史请用此命令，可选命名）',
-                    '  /s [cli|名称|序号|uuid] - 列出或切换会话（cli 查看未导入的 CLI 会话）',
-                    '  /name <新名称> - 重命名当前会话',
-                    '  /del <名称> - 删除指定会话（仅解绑，不删除文件）',
-                    '  /status - 显示会话状态',
-                    '  /check - 检查渠道健康',
-                    '',
-                    '❓ 帮助：',
-                    '  /help - 显示此帮助信息',
-                ];
-                return { kind: 'command.result', text: lines.join('\n') };
-            }
-            // admin+ 基础命令
-            const lines = [
-                '可用命令：',
-                '',
-                '📁 项目：',
-                '  /pwd - 显示当前项目路径',
-                '',
-                '🔄 会话管理：',
-                '  /new [名称] - 创建新会话（清空历史请用此命令，可选命名）',
-                '  /s [cli|名称|序号|uuid] - 列出或切换会话（cli 查看未导入的 CLI 会话）',
-                '  /name <新名称> - 重命名当前会话',
-                '  /del <名称> - 删除指定会话（仅解绑，不删除文件）',
-                '  /fork [名称] - 分支当前会话（从当前对话点创建分支）',
-                '  /rewind [N] [chat|file|all] - 查看历史/撤销指定轮次（别名: /rw）',
-                '  /compact - 压缩会话上下文（减少 token 用量）',
-                '',
-                '🤖 Agent 与模型：',
-                '  /baseagent [name] - 查看或切换 Agent 后端（别名: /base）',
-                '  /model [model] - 查看或切换模型',
-                '  /effort [level] - 查看或切换推理强度',
-                '',
-                '💬 聊天设置：',
-                '  /activity [all|dm|owner|none] - 查看/控制中间输出显示模式',
-                '  /chatmode [interactive|proactive] - 查看/切换会话模式（被动响应或主动推进）',
-                '  /dispatch [mention|broadcast] - 查看/切换群聊分发模式（仅@响应或广播响应，仅群聊）',
-                '',
-                '🔐 权限管理：',
-                '  /perm - 查看当前权限模式',
-                ...(isOwner ? [`  /perm <${PERMISSION_MODE_USAGE}> - 切换权限模式`] : []),
-                '  /perm allow|always|deny - 审批权限请求',
-                '',
-                '🛠️ 运维：',
-                '  /status - 显示会话状态',
-                '  /stop - 中断当前任务',
-                '  /check - 检查渠道状态',
-                ...(isAdmin ? [
-                    '  /restart - 重启服务（owner only）',
-                ] : []),
-                ...(isOwner ? [
-                    '  /restart - 重启服务',
-                ] : []),
-                ...(isOwner ? [
-                    '',
-                    '🧰 工具：',
-                    '  /file [channel] <path> - 发送项目内文件',
-                ] : []),
-                '',
-                '❓ 帮助：',
-                '  /help - 显示此帮助信息',
-            ];
-            return { kind: 'command.result', text: lines.join('\n') };
-        }
-        // /evolhelp 命令：返回 JSON 格式的命令列表（供程序解析）
-        if (normalizedContent === '/evolhelp') {
-            const cmds = [];
-            // 项目
-            cmds.push({ command: '/pwd', description: '显示当前项目路径', category: '项目', roles: ['admin', 'owner'] });
-            // 会话管理
-            cmds.push({ command: '/new', args: '[名称]', description: '创建新会话（清空历史请用此命令，可选命名）', category: '会话管理', roles: ['guest', 'admin', 'owner'] });
-            cmds.push({ command: '/s', aliases: ['/session', '/slist'], args: '[cli|名称|序号|uuid]', description: '列出或切换会话', category: '会话管理', roles: ['guest', 'admin', 'owner'] });
-            cmds.push({ command: '/name', aliases: ['/rename'], args: '<新名称>', description: '重命名当前会话', category: '会话管理', roles: ['guest', 'admin', 'owner'] });
-            cmds.push({ command: '/del', args: '<名称>', description: '删除指定会话（仅解绑，不删除文件）', category: '会话管理', roles: ['guest', 'admin', 'owner'] });
-            if (isAdmin) {
-                cmds.push({ command: '/fork', args: '[名称]', description: '分支当前会话（从当前对话点创建分支）', category: '会话管理', roles: ['admin', 'owner'] });
-                cmds.push({ command: '/rewind', aliases: ['/rw'], args: '[N] [chat|file|all]', description: '查看历史/撤销指定轮次', category: '会话管理', roles: ['admin', 'owner'] });
-                cmds.push({ command: '/compact', description: '压缩会话上下文（减少 token 用量）', category: '会话管理', roles: ['admin', 'owner'] });
-            }
-            // Agent 与模型
-            if (isAdmin) {
-                cmds.push({ command: '/baseagent', aliases: ['/base'], args: '[name]', description: '查看或切换 Agent 后端', category: 'Agent 与模型', roles: ['admin', 'owner'] });
-                cmds.push({ command: '/model', args: '[model]', description: '查看或切换模型', category: 'Agent 与模型', roles: ['admin', 'owner'] });
-                cmds.push({ command: '/effort', args: '[level]', description: '查看或切换推理强度', category: 'Agent 与模型', roles: ['admin', 'owner'] });
-            }
-            // 权限管理
-            if (isAdmin) {
-                cmds.push({ command: '/perm', args: isOwner ? `<${PERMISSION_MODE_USAGE}>` : undefined, description: '查看当前权限模式', category: '权限管理', roles: ['admin', 'owner'] });
-                cmds.push({ command: '/perm', args: 'allow|always|deny', description: '审批权限请求', category: '权限管理', roles: ['admin', 'owner'] });
-            }
-            // 运维
-            cmds.push({ command: '/status', description: '显示会话状态', category: '运维', roles: ['guest', 'admin', 'owner'] });
-            cmds.push({ command: '/stop', description: '中断当前任务', category: '运维', roles: ['admin', 'owner'] });
-            cmds.push({ command: '/check', description: '检查渠道状态', category: '运维', roles: ['guest', 'admin', 'owner'] });
-            if (isAdmin) {
-                cmds.push({ command: '/activity', args: '[all|dm|owner|none]', description: '查看/控制中间输出显示模式', category: '聊天设置', roles: ['admin', 'owner'] });
-            }
-            if (isOwner) {
-                cmds.push({ command: '/restart', description: '重启服务', category: '运维', roles: ['owner'] });
-                cmds.push({ command: '/file', args: '[channel] <path>', description: '发送项目内文件', category: '工具', roles: ['owner'] });
-            }
-            // 聊天设置
-            if (isAdmin) {
-                cmds.push({ command: '/chatmode', args: '[interactive|proactive]', description: '查看/切换会话模式（被动响应或主动推进）', category: '聊天设置', roles: ['admin', 'owner'] });
-                cmds.push({ command: '/dispatch', args: '[mention|broadcast]', description: '查看/切换群聊分发模式（仅@响应或广播响应）', category: '聊天设置', roles: ['admin', 'owner'] });
-            }
-            // 交互
-            cmds.push({ command: '/ask', args: '<选项>', description: '回答 Agent 的交互式问题', category: '运维', roles: ['guest', 'admin', 'owner'] });
-            // 帮助
-            cmds.push({ command: '/help', description: '显示帮助信息', category: '帮助', roles: ['guest', 'admin', 'owner'] });
-            const categories = [...new Set(cmds.map(c => c.category))];
-            return { kind: 'command.result', text: JSON.stringify({ commands: cmds, categories }) };
-        }
-        // /perm 命令：权限模式切换 + 权限审批（快速路径，不进入消息队列）
-        if (normalizedContent.startsWith('/perm')) {
-            const args = normalizedContent.slice(5).trim();
-            // 先获取正确的 session 和 agent（话题可能用不同 agent）
-            const permResult = await this.ensureSession(channel, channelId, threadId, chatType);
-            if ('error' in permResult)
-                return { kind: 'command.result', text: permResult.error };
-            const { session: permSession } = permResult;
-            const permAgent = this.getAgent(channel, permSession.agentId);
-            // /perm（无参数）：显示当前模式和可选模式
-            if (!args) {
-                if (!hasPermissionController(permAgent)) {
-                    return { kind: 'command.error', text: '❌ 权限控制不可用' };
-                }
-                const currentMode = permSession.metadata?.permissionMode ?? DEFAULT_PERMISSION_MODE;
-                const modes = permAgent.listModes();
-                // 尝试发送 CommandCard 卡片
-                {
-                    const availableModes = modes.filter(m => m.available);
-                    const interaction = {
-                        type: 'interaction',
-                        id: `perm-${Date.now()}-${crypto.randomBytes(4).toString('hex')}`,
-                        channelId,
-                        sessionId: permSession.id,
-                        initiatorId: userId,
-                        kind: {
-                            kind: 'command-card',
-                            title: '🔐 权限模式',
-                            body: availableModes.map(m => `${m.key === currentMode ? '✓' : '•'} **${m.key}** (${m.nameZh}) - ${m.description}`).join('\n'),
-                            buttons: availableModes.map(m => ({
-                                label: m.key === currentMode ? `✓ ${m.key}` : m.key,
-                                command: `/perm ${m.key}`,
-                                style: (m.key === currentMode ? 'primary' : 'default'),
-                                disabled: m.key === currentMode,
-                            })),
-                        },
-                    };
-                    const replyCtx = this.getReplyContext(permSession);
-                    const cardResult = await this.sendCommandCard({ channel, channelId, interaction, replyCtx, canWrite: isOwner });
-                    if (cardResult === null)
-                        return null;
-                    return { kind: 'command.result', text: cardResult };
-                }
-                // 降级：文本
-                const modeList = modes.map(m => {
-                    const prefix = m.key === currentMode ? '✓' : ' ';
-                    const suffix = m.available ? '' : ' ⚠️ 不可用';
-                    return `  ${prefix} ${m.key} (${m.nameZh}) - ${m.description}${suffix}`;
-                }).join('\n');
-                if (isOwner) {
-                    return { kind: 'command.result', text: `权限模式: ${currentMode}\n\n${modeList}\n\n用法: /perm <模式> 或 allow|always|deny` };
-                }
-                return { kind: 'command.result', text: `当前权限模式: ${currentMode}` };
-            }
-            const parts = args.split(/\s+/);
-            // /perm <mode> 或 /perm allow|always|deny：切换模式 / 快捷审批
-            if (parts.length === 1) {
-                const arg = parts[0];
-                // /perm allow|always|deny：快捷审批
-                // 优先走 InteractionRouter fallback（统一降级路径）
-                if (arg === 'allow' || arg === 'always' || arg === 'deny') {
-                    const fb = await this.handleInteractionFallback('perm', arg, permSession.id, userId);
-                    if (fb.matched)
-                        return { kind: 'command.result', text: fb.result ?? '✓ 已回答' };
-                    // fallback 不命中：走 permissionGateway 直接审批（兼容旧路径）
-                    if (!this.permissionGateway) {
-                        return { kind: 'command.error', text: '❌ 权限审批未启用' };
-                    }
-                    const pendingIds = this.permissionGateway.getPendingRequests(permSession.id);
-                    if (pendingIds.length === 0) {
-                        return { kind: 'command.error', text: '❌ 当前没有待审批的权限请求' };
-                    }
-                    if (pendingIds.length > 1) {
-                        return { kind: 'command.error', text: `❌ 当前有 ${pendingIds.length} 个待审批请求，请指定 requestId：\n${pendingIds.map(id => `  /perm ${id} ${arg}`).join('\n')}` };
-                    }
-                    const requestId = pendingIds[0];
-                    const decision = arg;
-                    this.permissionGateway.resolvePermission(permSession.id, requestId, decision);
-                    const labels = {
-                        allow: '✓ 已授权（本次），继续执行……',
-                        always: '✓ 已授权（始终允许该工具），继续执行……',
-                        deny: '✓ 已拒绝'
-                    };
-                    return { kind: 'command.result', text: labels[decision] };
-                }
-                // /perm <mode>：切换权限模式
-                if (hasPermissionController(permAgent)) {
-                    const modes = permAgent.listModes();
-                    const matched = modes.find(m => m.key === arg);
-                    if (matched) {
-                        if (!matched.available) {
-                            return { kind: 'command.error', text: `❌ ${matched.key} 模式当前不可用：${matched.unavailableReason}` };
-                        }
-                        // guest 和 admin 用户不能切换权限模式（仅 owner）
-                        if (!isOwner) {
-                            return { kind: 'command.error', text: '❌ 权限模式切换仅限 owner' };
-                        }
-                        const metadata = permSession.metadata || {};
-                        metadata.permissionMode = arg;
-                        await this.sessionManager.updateSession(permSession.id, { metadata });
-                        if (source === 'card-trigger')
-                            return null;
-                        return { kind: 'command.result', text: `✓ 权限模式已切换为: ${matched.key} (${matched.nameZh})\n${matched.description}` };
-                    }
-                }
-                // 不是已知模式名也不是 allow/deny
-                const modeKeys = hasPermissionController(permAgent) ? permAgent.listModes().map(m => m.key).join('|') : PERMISSION_MODE_USAGE;
-                return { kind: 'command.error', text: `❌ 未知参数: ${arg}\n用法: /perm <${modeKeys}> 或 /perm allow|always|deny` };
-            }
-            // 双参数不再支持，提示正确用法
-            const allModeKeys = hasPermissionController(permAgent) ? permAgent.listModes().map(m => m.key).join('|') : PERMISSION_MODE_USAGE;
-            return { kind: 'command.error', text: `❌ 未知参数: ${args}\n用法: /perm <${allModeKeys}> 或 /perm allow|always|deny` };
-        }
-        // /ask 命令：回答 AskUserQuestion / ExitPlanMode 的交互式问题
-        if (normalizedContent.startsWith('/ask')) {
-            const args = normalizedContent.slice(4).trim();
-            if (!args) {
-                const askResult = await this.ensureSession(channel, channelId, threadId, chatType);
-                if ('error' in askResult)
-                    return { kind: 'command.result', text: askResult.error };
-                const pendingIds = this.interactionRouter?.getPending(askResult.session.id) || [];
-                if (pendingIds.length === 0)
-                    return { kind: 'command.result', text: '当前没有待回答的问题' };
-                return { kind: 'command.result', text: `当前有 ${pendingIds.length} 个待回答问题，请回复 /ask <选项>` };
-            }
-            const askResult = await this.ensureSession(channel, channelId, threadId, chatType);
-            if ('error' in askResult)
-                return { kind: 'command.result', text: askResult.error };
-            const fb = await this.handleInteractionFallback('ask', args, askResult.session.id, userId);
-            if (fb.matched)
-                return { kind: 'command.result', text: fb.result ?? '✓ 已回答' };
-            return { kind: 'command.error', text: '❌ 当前没有待回答的问题' };
-        }
-        // /resume 命令：返回当前项目的 Claude 会话记录（JSON）
-        if (normalizedContent === '/resume' || normalizedContent.startsWith('/resume ')) {
-            const resumeResult = await this.ensureSession(channel, channelId, threadId, chatType);
-            if ('error' in resumeResult)
-                return { kind: 'command.result', text: resumeResult.error };
-            const { session: resumeSession } = resumeResult;
-            try {
-                const { encodePath } = await import('../utils/cross-platform.js');
-                const homeDir = os.homedir();
-                const encodedPath = encodePath(resumeSession.projectPath);
-                const projectDir = path.join(homeDir, '.claude', 'projects', encodedPath);
-                if (!fs.existsSync(projectDir)) {
-                    return { kind: 'command.error', text: '❌ 未找到 Claude 会话记录目录' };
-                }
-                const jsonlFiles = fs.readdirSync(projectDir).filter(f => f.endsWith('.jsonl'));
-                if (jsonlFiles.length === 0) {
-                    return { kind: 'command.error', text: '❌ 当前项目没有 Claude 会话记录' };
-                }
-                const sessions = [];
-                for (const file of jsonlFiles) {
-                    const filePath = path.join(projectDir, file);
-                    const sessionId = file.replace('.jsonl', '');
-                    let lastTimestamp = '';
-                    let firstUserMessage = '';
-                    let model = '';
-                    let branch = '';
-                    let turns = 0;
-                    try {
-                        const content = fs.readFileSync(filePath, 'utf-8');
-                        const lines = content.split('\n').filter(l => l.trim());
-                        for (const line of lines) {
-                            const event = JSON.parse(line);
-                            if (event.timestamp && event.timestamp > lastTimestamp) {
-                                lastTimestamp = event.timestamp;
-                            }
-                            if (event.gitBranch && !branch) {
-                                branch = event.gitBranch;
-                            }
-                            if (event.type === 'user' && event.message?.role === 'user') {
-                                const msgContent = event.message.content;
-                                const isToolResult = Array.isArray(msgContent) && msgContent.every((c) => c.type === 'tool_result');
-                                if (!isToolResult) {
-                                    turns++;
-                                    if (!firstUserMessage) {
-                                        if (typeof msgContent === 'string') {
-                                            firstUserMessage = msgContent.slice(0, 100);
-                                        }
-                                        else if (Array.isArray(msgContent)) {
-                                            const textBlock = msgContent.find((c) => c.type === 'text');
-                                            if (textBlock?.text) {
-                                                firstUserMessage = textBlock.text.slice(0, 100);
-                                            }
-                                        }
-                                    }
-                                }
-                            }
-                            if (event.type === 'assistant' && event.message?.model && !model) {
-                                model = event.message.model;
-                            }
-                        }
-                    }
-                    catch {
-                        continue;
-                    }
-                    if (!lastTimestamp)
-                        continue;
-                    sessions.push({
-                        sessionId,
-                        lastMessageTime: lastTimestamp,
-                        firstUserMessage: firstUserMessage || '(无消息)',
-                        model: model || 'unknown',
-                        turns,
-                        branch: branch || 'unknown',
-                    });
-                }
-                sessions.sort((a, b) => b.lastMessageTime.localeCompare(a.lastMessageTime));
-                return { kind: 'command.result', text: JSON.stringify(sessions, null, 2) };
-            }
-            catch (error) {
-                logger.error('[CommandHandler] /resume failed:', error);
-                return { kind: 'command.error', text: `❌ 读取会话记录失败: ${error instanceof Error ? error.message : '未知错误'}` };
-            }
-        }
-        // /baseagent 命令：查看或切换 Agent 后端
-        if (normalizedContent === '/baseagent' || normalizedContent.startsWith('/baseagent ')) {
-            const args = normalizedContent.slice(10).trim();
-            // 切换（带参）需权限：群聊 owner only，私聊 admin+；无参查询对所有人放开
-            if (args && (activeChatType === 'group' ? !isOwner : !isAdmin)) {
-                return { kind: 'command.error', text: '❌ 无权限：此命令仅限管理员使用' };
-            }
-            const available = this.getAvailableBaseagents(channel);
-            if (!args) {
-                // currentAgent: 当前 session 的 baseagent，或该 channel 所属 evolagent 的 baseagent
-                const currentAgent = activeSession?.agentId
-                    || this.agentRegistry?.resolveByChannel(channel)?.baseagent
-                    || this.parseDefaultBaseagent();
-                // 尝试发送 CommandCard 卡片
-                if (this.interactionRouter && available.length > 1) {
-                    const interaction = {
-                        type: 'interaction',
-                        id: `agent-${Date.now()}-${crypto.randomBytes(4).toString('hex')}`,
-                        channelId,
-                        sessionId: activeSession?.id || `agent-${Date.now()}`,
-                        initiatorId: userId,
-                        kind: {
-                            kind: 'command-card',
-                            title: '🔌 切换 Agent',
-                            buttons: available.map(a => ({
-                                label: a === currentAgent ? `✓ ${a}` : a,
-                                command: `/baseagent ${a}`,
-                                style: (a === currentAgent ? 'primary' : 'default'),
-                                disabled: a === currentAgent,
-                            })),
-                        },
-                    };
-                    const replyCtx = activeSession ? this.getReplyContext(activeSession) : undefined;
-                    const cardResult = await this.sendCommandCard({ channel, channelId, interaction, replyCtx, canWrite: activeChatType === 'group' ? isOwner : isAdmin });
-                    if (cardResult === null)
-                        return null;
-                    return { kind: 'command.result', text: cardResult };
-                }
-                // 降级：文本
-                const list = available.map(a => `${a === currentAgent ? ' ✓' : '  '} ${a}`).join('\n');
-                const canSwitchAgent = activeChatType === 'group' ? isOwner : isAdmin;
-                if (canSwitchAgent) {
-                    return { kind: 'command.result', text: `当前 Agent: ${currentAgent}\n\n可用:\n${list}\n用法: /baseagent <name>` };
-                }
-                return { kind: 'command.result', text: `当前 Agent: ${currentAgent}` };
-            }
-            if (!available.includes(args)) {
-                return { kind: 'command.error', text: `❌ 未知 Agent: ${args}\n可用: ${available.join(', ')}` };
-            }
-            const result = await this.ensureSession(channel, channelId, threadId, chatType);
-            if ('error' in result)
-                return { kind: 'command.error', text: result.error };
-            const { session } = result;
-            // 取消原会话的 pending 权限请求和交互卡片
-            if (this.permissionGateway) {
-                this.permissionGateway.cancelAll(session.id);
-            }
-            if (this.interactionRouter) {
-                this.interactionRouter.cancelAll(session.id);
-            }
-            // 切换到目标 agent（恢复已有会话或创建新会话）
-            const newSession = await this.sessionManager.switchAgent(channel, channelId, session.projectPath, args);
-            const hasExistingSession = newSession.agentSessionId ? '（恢复已有会话）' : '（新建会话）';
-            const projectName = this.getProjectName(session.projectPath);
-            let agentSwitchResponse = `✓ 已切换 Agent: ${args}\n  项目: ${projectName}\n  会话: ${displaySessionTitle(newSession.name, '(未命名)')}\n  ${hasExistingSession}`;
-            if (source === 'card-trigger')
-                return null;
-            return { kind: 'command.result', text: agentSwitchResponse };
-        }
-        // /setmodel 命令：返回 JSON 格式的模型列表（供程序解析）
-        if (normalizedContent === '/setmodel' || normalizedContent.startsWith('/setmodel ')) {
-            const setmodelResult = await this.ensureSession(channel, channelId, threadId, chatType);
-            if ('error' in setmodelResult)
-                return { kind: 'command.result', text: setmodelResult.error };
-            const { session: setmodelSession } = setmodelResult;
-            const setmodelAgent = this.getAgent(channel, setmodelSession.agentId);
-            const currentModel = hasModelSwitcher(setmodelAgent) ? setmodelAgent.getModel() : setmodelAgent.name;
-            const efforts = getAvailableEfforts(setmodelAgent, currentModel);
-            const currentEffort = setmodelAgent.getEffort?.() || 'auto';
-            const now = Math.floor(Date.now() / 1000);
-            const modelIds = hasModelSwitcher(setmodelAgent) ? await setmodelAgent.listModels() : [];
-            const modelListData = {
-                object: 'list',
-                data: modelIds.map(id => ({ id, object: 'model', created: now, owned_by: setmodelAgent.name === 'codex' ? 'openai' : 'anthropic' })),
-            };
-            return { kind: 'command.result', text: JSON.stringify({
-                    current_model: currentModel,
-                    current_effort: currentEffort,
-                    available_efforts: efforts,
-                    models: modelListData,
-                }, null, 2) };
-        }
-        // /model 命令：查看或切换模型/推理强度
-        if (normalizedContent.startsWith('/model')) {
-            const args = normalizedContent.slice(6).trim();
-            // 获取当前会话（话题会话可能绑定不同 agent）
-            const modelResult = await this.ensureSession(channel, channelId, threadId, chatType);
-            if ('error' in modelResult)
-                return { kind: 'command.result', text: modelResult.error };
-            const { session: modelSession } = modelResult;
-            const modelAgent = this.getAgent(channel, modelSession.agentId);
-            const models = hasModelSwitcher(modelAgent) ? await modelAgent.listModels() : [];
-            if (!args) {
-                const currentModel = hasModelSwitcher(modelAgent) ? modelAgent.getModel() : modelAgent.name;
-                const efforts = getAvailableEfforts(modelAgent, currentModel);
-                const currentEffort = modelAgent.getEffort?.() || 'auto';
-                // 尝试发送 CommandCard 卡片
-                if (this.interactionRouter && models.length > 0) {
-                    const interaction = {
-                        type: 'interaction',
-                        id: `model-${Date.now()}-${crypto.randomBytes(4).toString('hex')}`,
-                        channelId,
-                        sessionId: modelSession.id,
-                        initiatorId: userId,
-                        kind: {
-                            kind: 'command-card',
-                            title: '🤖 切换模型',
-                            buttons: models.map((m) => {
-                                const display = modelDisplayLabel(modelAgent, m);
-                                return {
-                                    label: m === currentModel ? `✓ ${display}` : display,
-                                    command: `/model ${m}`,
-                                    style: (m === currentModel ? 'primary' : 'default'),
-                                    disabled: m === currentModel,
-                                };
-                            }),
-                        },
-                    };
-                    const replyCtx = this.getReplyContext(modelSession);
-                    const cardResult = await this.sendCommandCard({ channel, channelId, interaction, replyCtx, canWrite: isAdmin });
-                    if (cardResult === null)
-                        return null;
-                    return { kind: 'command.result', text: cardResult };
-                }
-                // 降级：文本
-                const modelList = models.map((m) => `  ${m === currentModel ? '✓' : ' '} ${modelDisplayLabel(modelAgent, m)}`).join('\n');
-                const effortHint = efforts.length > 0
-                    ? `\n推理强度: ${currentEffort === 'auto' ? 'auto (SDK默认)' : currentEffort}  (使用 /effort 调整)`
-                    : '';
-                if (isAdmin) {
-                    return { kind: 'command.result', text: `当前模型: ${modelDisplayLabel(modelAgent, currentModel)}${effortHint}\n\n可用模型：\n${modelList}\n\n用法: /model <模型>` };
-                }
-                return { kind: 'command.result', text: `当前模型: ${modelDisplayLabel(modelAgent, currentModel)}${effortHint}` };
-            }
-            // 带参（切换/调整）需 admin+；无参查询已在上方返回
-            if (!isAdmin)
-                return { kind: 'command.error', text: '❌ 无权限：切换模型仅限管理员使用' };
-            const parts = args.split(/\s+/);
-            let newModel;
-            let newEffort;
-            if (parts.length === 1) {
-                const arg = parts[0];
-                const currentModel = hasModelSwitcher(modelAgent) ? modelAgent.getModel() : modelAgent.name;
-                const efforts = getAvailableEfforts(modelAgent, currentModel);
-                // effort 相关参数统一转发到 /effort
-                if (efforts.includes(arg) || arg === 'auto') {
-                    const delegated = await this.handle(`/effort ${arg}`, channel, channelId, undefined, userId, threadId);
-                    return typeof delegated === 'string' ? { kind: 'command.result', text: delegated } : delegated;
-                }
-                else if (allEfforts.includes(arg)) {
-                    return { kind: 'command.error', text: `⚠️ 请使用 /effort ${arg} 调整推理强度` };
-                }
-                else {
-                    const resolvedArg = hasModelSwitcher(modelAgent) ? (modelAgent.resolveModelId?.(arg) ?? arg) : arg;
-                    if (models.includes(resolvedArg)) {
-                        newModel = resolvedArg;
-                    }
-                    else if (models.includes(arg)) {
-                        newModel = arg;
-                    }
-                    else {
-                        const modelList = models.map((m) => `  ${m === currentModel ? '✓' : ' '} ${modelDisplayLabel(modelAgent, m)}`).join('\n');
-                        const effortHint = efforts.length > 0 ? `\n\n推理强度请使用 /effort 命令` : '';
-                        return { kind: 'command.error', text: `❌ 无效参数: ${arg}\n\n可用模型：\n${modelList}${effortHint}` };
-                    }
-                }
-            }
-            else {
-                // 双参数：model effort
-                const [modelArgRaw, effortArg] = parts;
-                const modelArg = hasModelSwitcher(modelAgent)
-                    ? (models.includes(modelArgRaw) ? modelArgRaw : (modelAgent.resolveModelId?.(modelArgRaw) ?? modelArgRaw))
-                    : modelArgRaw;
-                if (!models.includes(modelArg)) {
-                    return { kind: 'command.error', text: `❌ 无效的模型ID: ${modelArgRaw}` };
-                }
-                const targetEfforts = getAvailableEfforts(modelAgent, modelArg);
-                if (targetEfforts.length === 0) {
-                    return { kind: 'command.error', text: `⚠️ ${modelArg} 不支持推理强度设置` };
-                }
-                if (!targetEfforts.includes(effortArg)) {
-                    const errorLabel = allEfforts.includes(effortArg) ? '⚠️' : '❌';
-                    return { kind: 'command.result', text: `${errorLabel} ${modelArg} 不支持 ${effortArg} 推理强度\n可选: ${targetEfforts.join(' / ')}` };
-                }
-                newModel = modelArg;
-                newEffort = effortArg;
-            }
-            // 运行时 model/effort 切换已通过 EvolAgent.setBaseagentModel/setBaseagentEffort 持久化
-            const isCodexAgent = modelAgent.name === 'codex';
-            const changes = [];
-            if (newModel) {
-                modelAgent.setModel?.(newModel);
-                this.eventBus.publish({
-                    type: 'runner:model-changed',
-                    sessionId: modelSession.id,
-                    model: newModel,
-                    timestamp: Date.now()
-                });
-                changes.push(`模型: ${newModel}`);
-            }
-            if (newEffort) {
-                modelAgent.setEffort?.(newEffort);
-                changes.push(`推理强度: ${newEffort}`);
-            }
-            // 持久化：agent-owned channel 写到 agent.json；default 走原"就近原则"
-            if (newModel) {
-                const err = this.persistBaseagentModel(channel, modelAgent.name, newModel);
-                if (err)
-                    return { kind: 'command.result', text: `${err}\n已更新运行时配置，但未持久化` };
-            }
-            if (newEffort) {
-                const err = this.persistBaseagentEffort(channel, modelAgent.name, newEffort);
-                if (err)
-                    return { kind: 'command.result', text: `${err}\n已更新运行时配置，但未持久化` };
-            }
-            if (source === 'card-trigger')
-                return null;
-            return { kind: 'command.result', text: `✓ 已切换\n  ${changes.join('\n  ')}` };
-        }
-        // /effort 命令：查看或切换推理强度
-        if (normalizedContent.startsWith('/effort')) {
-            const args = normalizedContent.slice(7).trim();
-            const effortResult = await this.ensureSession(channel, channelId, threadId, chatType);
-            if ('error' in effortResult)
-                return { kind: 'command.result', text: effortResult.error };
-            const { session: effortSession } = effortResult;
-            const effortAgent = this.getAgent(channel, effortSession.agentId);
-            const currentModel = hasModelSwitcher(effortAgent) ? effortAgent.getModel() : effortAgent.name;
-            const efforts = getAvailableEfforts(effortAgent, currentModel);
-            const currentEffort = effortAgent.getEffort?.() || 'auto';
-            if (efforts.length === 0) {
-                return { kind: 'command.error', text: '⚠️ 当前模型不支持推理强度设置' };
-            }
-            if (!args) {
-                // /effort（无参数）：显示当前推理强度 + 发送 CommandCard 卡片
-                if (this.interactionRouter) {
-                    const allItems = [...efforts, 'auto'];
-                    const interaction = {
-                        type: 'interaction',
-                        id: `effort-${Date.now()}-${crypto.randomBytes(4).toString('hex')}`,
-                        channelId,
-                        sessionId: effortSession.id,
-                        initiatorId: userId,
-                        kind: {
-                            kind: 'command-card',
-                            title: '⚡ 推理强度',
-                            buttons: allItems.map(e => ({
-                                label: e === currentEffort ? `✓ ${e}` : e,
-                                command: `/effort ${e}`,
-                                style: (e === currentEffort ? 'primary' : 'default'),
-                                disabled: e === currentEffort,
-                            })),
-                        },
-                    };
-                    const replyCtx = this.getReplyContext(effortSession);
-                    const cardResult = await this.sendCommandCard({ channel, channelId, interaction, replyCtx, canWrite: isAdmin });
-                    if (cardResult === null)
-                        return null;
-                    return { kind: 'command.result', text: cardResult };
-                }
-                // 降级：文本
-                const effortDisplay = currentEffort === 'auto' ? 'auto (SDK默认)' : currentEffort;
-                const effortOptions = [...efforts, 'auto'].join(' / ');
-                if (isAdmin) {
-                    return { kind: 'command.result', text: `推理强度: ${effortDisplay}  可选: ${effortOptions}  用法: /effort <level>` };
-                }
-                return { kind: 'command.result', text: `推理强度: ${effortDisplay}` };
-            }
-            // 带参（切换）需 admin+；无参查询已在上方返回
-            if (!isAdmin)
-                return { kind: 'command.error', text: '❌ 无权限：切换推理强度仅限管理员使用' };
-            // /effort auto：恢复 SDK 默认
-            if (args === 'auto') {
-                effortAgent.setEffort?.(undefined);
-                const err = this.persistBaseagentEffort(channel, effortAgent.name, undefined);
-                if (err)
-                    return { kind: 'command.result', text: `${err}\n已更新运行时配置，但未持久化` };
-                return { kind: 'command.result', text: '✓ 推理强度已恢复为 auto (SDK默认)' };
-            }
-            // /effort <level>：切换推理强度
-            if (!efforts.includes(args)) {
-                if (allEfforts.includes(args)) {
-                    return { kind: 'command.error', text: `⚠️ ${currentModel} 不支持 ${args} 推理强度\n可选: ${efforts.join(' / ')}` };
-                }
-                return { kind: 'command.error', text: `❌ 无效参数: ${args}\n可选: ${efforts.join(' / ')} / auto` };
-            }
-            const newEffort = args;
-            effortAgent.setEffort?.(newEffort);
-            const err = this.persistBaseagentEffort(channel, effortAgent.name, newEffort);
-            if (err)
-                return { kind: 'command.result', text: `${err}\n已更新运行时配置，但未持久化` };
-            if (source === 'card-trigger')
-                return null;
-            return { kind: 'command.result', text: `✓ 推理强度: ${newEffort}` };
-        }
-        // /agent, /aid, /rpc, /storage — 仅限 ctl 调用，slash 输入拒绝
-        if (normalizedContent === '/agent' || normalizedContent.startsWith('/agent ') ||
-            normalizedContent === '/aid' || normalizedContent.startsWith('/aid ') ||
-            normalizedContent === '/rpc' || normalizedContent.startsWith('/rpc ') ||
-            normalizedContent === '/storage' || normalizedContent.startsWith('/storage ')) {
-            return { kind: 'command.error', text: '❌ 此命令仅限 ctl 调用，不支持 slash 输入' };
-        }
-        if (normalizedContent === '/activity' || normalizedContent.startsWith('/activity ')) {
-            const activityArg = normalizedContent.slice(9).trim();
-            // 带参（写操作）需 admin+；无参查询对所有人开放（owner 门在具体切换点还有一道）
-            if (activityArg && !isAdmin)
-                return { kind: 'command.error', text: '❌ 无权限：此命令仅限管理员使用' };
-            // proactive 模式下流式输出全部静默，activity 配置无意义
-            if (activeSession?.sessionMode === 'proactive') {
-                return { kind: 'command.error', text: '❌ 当前会话为 proactive 模式，不支持 activity 配置（流式输出已全部静默）' };
-            }
-            const modeMap = {
-                all: 'all',
-                dm: 'dm-only',
-                owner: 'owner-dm-only',
-                none: 'none',
-            };
-            const currentMode = this.agentRegistry?.getShowActivities?.(channel) ?? 'all';
-            // 模式描述列表（用于 body 和文本降级）
-            const modeDescriptions = [
-                { key: 'all', configVal: 'all', label: '全部显示' },
-                { key: 'dm', configVal: 'dm-only', label: '仅私聊显示' },
-                { key: 'owner', configVal: 'owner-dm-only', label: '仅 owner 私聊显示' },
-                { key: 'none', configVal: 'none', label: '全部静默' },
-            ];
-            if (!activityArg) {
-                // 尝试发送 CommandCard 卡片
-                {
-                    const interaction = {
-                        type: 'interaction',
-                        id: `activity-${Date.now()}-${crypto.randomBytes(4).toString('hex')}`,
-                        channelId,
-                        sessionId: activeSession?.id || '',
-                        initiatorId: userId,
-                        kind: {
-                            kind: 'command-card',
-                            title: '📋 中间输出模式',
-                            body: modeDescriptions.map(m => `${m.configVal === currentMode ? '✓' : '•'} **${m.key}** (${m.label})`).join('\n'),
-                            buttons: modeDescriptions.map(m => ({
-                                label: m.configVal === currentMode ? `✓ ${m.key}` : m.key,
-                                command: `/activity ${m.key}`,
-                                style: (m.configVal === currentMode ? 'primary' : 'default'),
-                                disabled: m.configVal === currentMode,
-                            })),
-                        },
-                    };
-                    const replyCtx = activeSession ? this.getReplyContext(activeSession) : undefined;
-                    const cardResult = await this.sendCommandCard({ channel, channelId, interaction, replyCtx, canWrite: isOwner });
-                    if (cardResult === null)
-                        return null;
-                    // 卡片降级：fall through 到下方文本输出
-                }
-                // 降级：文本
-                const modeList = modeDescriptions.map(m => {
-                    const prefix = m.configVal === currentMode ? '✓' : '•';
-                    return `  ${prefix} ${m.key} — ${m.label}`;
-                }).join('\n');
-                if (isOwner) {
-                    return { kind: 'command.result', text: `中间输出: ${currentMode}  用法: /activity <all|dm|owner|none>` };
-                }
-                return { kind: 'command.result', text: `中间输出: ${currentMode}` };
-            }
-            const newMode = modeMap[activityArg];
-            if (!newMode) {
-                return { kind: 'command.error', text: `❌ 无效参数: ${activityArg}\n可选: all / dm / owner / none` };
-            }
-            const label = modeDescriptions.find(m => m.configVal === newMode)?.label || newMode;
-            if (newMode === currentMode) {
-                return { kind: 'command.result', text: `📋 中间输出模式已是 ${activityArg}（${label}）` };
-            }
-            // 切换操作仅 owner
-            if (!isOwner)
-                return { kind: 'command.error', text: '❌ 中间输出模式切换仅限 owner' };
-            if (this.agentRegistry?.setShowActivities) {
-                this.agentRegistry.setShowActivities(channel, newMode);
-            }
-            else {
-                return { kind: 'command.error', text: `⚠️ 找不到通道 "${channel}" 所属的 self-agent，无法持久化` };
-            }
-            if (source === 'card-trigger')
-                return null;
-            return { kind: 'command.result', text: `✅ 中间输出模式: ${activityArg}（${label}）` };
-        }
-        // /chatmode 命令：查看/切换 session 会话模式（interactive | proactive）
-        // - 查看：所有人可用
-        // - 设置：单聊任何角色可设置；群聊仅管理员可设置
-        if (normalizedContent === '/chatmode' || normalizedContent.startsWith('/chatmode ')) {
-            const chatmodeResult = await this.ensureSession(channel, channelId, threadId, chatType);
-            if ('error' in chatmodeResult)
-                return { kind: 'command.result', text: chatmodeResult.error };
-            const chatmodeSession = chatmodeResult.session;
-            const arg = normalizedContent.slice(9).trim();
-            const currentMode = chatmodeSession.sessionMode || 'interactive';
-            const chatmodeChatType = chatmodeSession.chatType || activeChatType;
-            const isGroup = chatmodeChatType === 'group';
-            const canSwitch = !isGroup;
-            if (!arg) {
-                if (isGroup) {
-                    return { kind: 'command.result', text: `📋 会话模式: proactive（群聊强制）` };
-                }
-                // 尝试发送 CommandCard 卡片
-                if (canSwitch) {
-                    const modes = [
-                        { key: 'interactive', name: '交互模式', desc: '被动响应：收到消息时才回复，回复直接显示' },
-                        { key: 'proactive', name: '主动模式', desc: '主动推进：流式输出静默，由 Agent 自调 ctl send 发声' },
-                    ];
-                    const interaction = {
-                        type: 'interaction',
-                        id: `chatmode-${Date.now()}-${crypto.randomBytes(4).toString('hex')}`,
-                        channelId,
-                        sessionId: chatmodeSession.id,
-                        initiatorId: userId,
-                        kind: {
-                            kind: 'command-card',
-                            title: '🔄 会话模式',
-                            body: modes.map(m => `${m.key === currentMode ? '✓' : '•'} **${m.key}** (${m.name}) - ${m.desc}`).join('\n'),
-                            buttons: modes.map(m => ({
-                                label: m.key === currentMode ? `✓ ${m.key}` : m.key,
-                                command: `/chatmode ${m.key}`,
-                                style: (m.key === currentMode ? 'primary' : 'default'),
-                                disabled: m.key === currentMode,
-                            })),
-                        },
-                    };
-                    const replyCtx = this.getReplyContext(chatmodeSession);
-                    const cardResult = await this.sendCommandCard({ channel, channelId, interaction, replyCtx, canWrite: isAdmin });
-                    if (cardResult === null)
-                        return null;
-                    // 卡片降级：fall through 到下方文本输出
-                }
-                // 降级：文本
-                if (canSwitch) {
-                    return { kind: 'command.result', text: `会话模式: ${currentMode}  用法: /chatmode <interactive|proactive>` };
-                }
-                return { kind: 'command.result', text: `会话模式: ${currentMode}` };
-            }
-            if (arg !== 'interactive' && arg !== 'proactive') {
-                return { kind: 'command.error', text: `❌ 无效模式: ${arg}\n可选: interactive / proactive` };
-            }
-            // 群聊强制 proactive，不可切换
-            if ((chatmodeSession.chatType || activeChatType) === 'group') {
-                return { kind: 'command.error', text: '❌ 群聊强制 proactive 模式，不可切换' };
-            }
-            if (arg === currentMode) {
-                return { kind: 'command.result', text: `📋 当前会话模式已是 ${arg}` };
-            }
-            // 仅在真正需要切换时才要求会话空闲
-            if (threadId) {
-                const threadSession = await this.sessionManager.getThreadSession(channel, channelId, threadId);
-                if (threadSession) {
-                    const threadAgent = this.getAgent(channel, threadSession.agentId);
-                    if (threadAgent.hasActiveStream(threadSession.id) || this.messageQueue?.isProcessing(threadSession.id)) {
-                        return { kind: 'command.error', text: '⚠️ 当前正在处理消息，请稍后再试\n使用 /stop 中断当前任务后重试' };
-                    }
-                }
-            }
-            else if (agent.hasActiveStream(chatmodeSession.id) || this.messageQueue?.isProcessing(chatmodeSession.id)) {
-                return { kind: 'command.error', text: '⚠️ 当前正在处理消息，请稍后再试\n使用 /stop 中断当前任务后重试' };
-            }
-            await this.sessionManager.updateSession(chatmodeSession.id, { sessionMode: arg });
-            this.eventBus.publish({ type: 'session:chat-mode-changed', sessionId: chatmodeSession.id, mode: arg, timestamp: Date.now() });
-            if (source === 'card-trigger')
-                return null;
-            return { kind: 'command.result', text: `✅ 会话模式已切换: ${arg}` };
-        }
-        // /dispatch 命令：查看/切换群聊分发模式（mention | broadcast）
-        // 仅群聊可用；群聊中设置需管理员权限
-        if (normalizedContent === '/dispatch' || normalizedContent.startsWith('/dispatch ')) {
-            const dispatchResult = await this.ensureSession(channel, channelId, threadId, chatType);
-            if ('error' in dispatchResult)
-                return { kind: 'command.result', text: dispatchResult.error };
-            const dispatchSession = dispatchResult.session;
-            const dispatchChatType = dispatchSession.chatType || activeChatType;
-            if (dispatchChatType !== 'group') {
-                return { kind: 'command.error', text: '❌ /dispatch 仅在群聊中可用' };
-            }
-            const arg = normalizedContent.slice(9).trim();
-            const currentMode = dispatchSession.metadata?.dispatchMode;
-            if (!arg) {
-                const displayMode = currentMode ?? '未设置（跟随群设置）';
-                // 尝试发送 CommandCard 卡片
-                if (isAdmin) {
-                    const modes = [
-                        { key: 'mention', name: '提及模式', desc: '仅当被 @ 提及（含 @all）时响应群消息' },
-                        { key: 'broadcast', name: '广播模式', desc: '群内所有消息都触发响应' },
-                    ];
-                    const interaction = {
-                        type: 'interaction',
-                        id: `dispatch-${Date.now()}-${crypto.randomBytes(4).toString('hex')}`,
-                        channelId,
-                        sessionId: dispatchSession.id,
-                        initiatorId: userId,
-                        kind: {
-                            kind: 'command-card',
-                            title: '📡 分发模式',
-                            body: modes.map(m => `${m.key === currentMode ? '✓' : '•'} **${m.key}** (${m.name}) - ${m.desc}`).join('\n'),
-                            buttons: modes.map(m => ({
-                                label: m.key === currentMode ? `✓ ${m.key}` : m.key,
-                                command: `/dispatch ${m.key}`,
-                                style: (m.key === currentMode ? 'primary' : 'default'),
-                                disabled: m.key === currentMode,
-                            })),
-                        },
-                    };
-                    const replyCtx = this.getReplyContext(dispatchSession);
-                    const cardResult = await this.sendCommandCard({ channel, channelId, interaction, replyCtx, canWrite: isAdmin });
-                    if (cardResult === null)
-                        return null;
-                    // 卡片降级：fall through 到下方文本输出
-                }
-                // 降级：文本
-                if (isAdmin) {
-                    return { kind: 'command.result', text: `分发模式: ${displayMode}  用法: /dispatch <mention|broadcast>` };
-                }
-                return { kind: 'command.result', text: `分发模式: ${displayMode}` };
-            }
-            if (arg !== 'mention' && arg !== 'broadcast') {
-                return { kind: 'command.error', text: `❌ 无效模式: ${arg}\n可选: mention / broadcast\n用法: /dispatch <模式>` };
-            }
-            if (!isAdmin) {
-                return { kind: 'command.error', text: '❌ 无权限：群聊中切换分发模式仅限管理员使用' };
-            }
-            if (arg === currentMode) {
-                return { kind: 'command.result', text: `当前已是 ${arg}` };
-            }
-            const metadata = { ...(dispatchSession.metadata || {}), dispatchMode: arg };
-            await this.sessionManager.updateSession(dispatchSession.id, { metadata });
-            this.eventBus.publish({ type: 'session:dispatch-mode-changed', sessionId: dispatchSession.id, mode: arg, timestamp: Date.now() });
-            if (source === 'card-trigger')
-                return null;
-            return { kind: 'command.result', text: `✅ 分发模式已切换: ${currentMode ?? '未设置'} → ${arg}` };
-        }
-        // /stop 命令：中断当前任务
-        if (normalizedContent === '/stop') {
-            const stopResult = await this.ensureSession(channel, channelId, threadId, chatType);
-            if ('error' in stopResult)
-                return { kind: 'command.result', text: '当前没有正在处理的任务' };
-            const { session: stopSession } = stopResult;
-            const stopAgent = this.getAgent(channel, stopSession.agentId);
-            const sessionKey = stopSession.id;
-            const queueLength = this.messageQueue.getQueueLength(sessionKey);
-            const hasActive = stopAgent.hasActiveStream(sessionKey);
-            const isProcessing = this.messageQueue.isProcessing(sessionKey);
-            if (queueLength === 0 && !hasActive && !isProcessing) {
-                return { kind: 'command.result', text: '当前没有正在处理的任务' };
-            }
-            await stopAgent.interrupt(sessionKey);
-            // 发布中断事件，让 MessageProcessor 标记为 interrupted（而非 done）
-            this.eventBus.publish({
-                type: 'task:interrupted',
-                sessionId: sessionKey,
-                reason: 'stop',
-                agentName: this.agentRegistry?.resolveByChannel(channel)?.name ?? '<unknown>',
-            });
-            // 强制清除 processing_state
-            this.sessionManager.clearProcessing(sessionKey);
-            return { kind: 'command.result', text: '✓ 已发送中断信号，任务将尽快停止' };
-        }
-        // /clear 已移除：Claude/Codex/Gemini 对“清空当前 backend 历史”的语义不一致。
-        // 统一使用 /new 创建新会话来开始全新上下文。
-        if (normalizedContent === '/clear') {
-            return { kind: 'command.error', text: '⚠️ /clear 已移除\n\n请使用 /new [名称] 创建新会话来开始全新上下文。旧会话会保留，可通过 /s 查看或切换。' };
-        }
-        // /compact 命令：手动压缩会话上下文
-        if (normalizedContent === '/compact') {
-            const result = await this.ensureSession(channel, channelId, threadId, chatType);
-            if ('error' in result)
-                return { kind: 'command.error', text: result.error };
-            const { session } = result;
-            const sessionAgent = this.getAgent(channel, session.agentId);
-            if (!sessionAgent.capabilities?.compact) {
-                return { kind: 'command.error', text: `❌ 当前 Agent (${sessionAgent.name}) 不支持 /compact` };
-            }
-            if (!session.agentSessionId) {
-                return { kind: 'command.error', text: '❌ 当前会话没有历史记录，无需压缩' };
-            }
-            const projectPath = path.isAbsolute(session.projectPath)
-                ? session.projectPath
-                : path.resolve(process.cwd(), session.projectPath);
-            const releaseLock = this.messageQueue.acquireLock(session.id);
-            try {
-                if (sendMessage) {
-                    await sendMessage(channelId, '⏳ 正在压缩会话上下文...', this.getReplyContext(session));
-                }
-                const compacted = await sessionAgent.compactSession(session.id, session.agentSessionId, projectPath);
-                if (compacted) {
-                    return {
-                        kind: 'command.result',
-                        text: '✅ 会话压缩完成',
-                    };
-                }
-                else {
-                    return { kind: 'command.error', text: '❌ 会话压缩失败，请稍后重试' };
-                }
-            }
-            finally {
-                releaseLock();
-            }
-        }
-        // 尝试获取活跃会话（话题时直接查找话题 session）
-        let session;
-        const resolvedSelfAID = selfAID ?? this.resolveSelfAID(channel);
-        if (threadId) {
-            session = await this.sessionManager.getOrCreateSession(channel, channelId, this.getEffectiveDefaultPath(channel), threadId, undefined, undefined, undefined, chatType, undefined, resolvedSelfAID, this.resolveChannelType(channel));
-        }
-        else {
-            session = await this.sessionManager.getActiveSession(channel, channelId);
-        }
-        // 如果没有会话，自动创建（所有后续命令都需要 session）
-        if (!session) {
-            session = await this.sessionManager.getOrCreateSession(channel, channelId, this.getEffectiveDefaultPath(channel), undefined, undefined, undefined, undefined, chatType, undefined, resolvedSelfAID, this.resolveChannelType(channel));
-        }
-        // /status 命令：显示会话状态
-        if (normalizedContent === '/status') {
-            // session 现在总是存在（上面已自动创建）
-            if (!session) {
-                return { kind: 'command.error', text: `❌ 无法创建会话，请检查配置` };
-            }
-            const sessionKey = this.getQueueKey(session, channel, channelId);
-            const sessionAgent = this.getAgent(channel, session.agentId);
-            const isCurrentlyProcessing = this.messageQueue.isProcessing(sessionKey) || sessionAgent.hasActiveStream(sessionKey);
-            const queueLength = this.messageQueue.getQueueLength(sessionKey);
-            const isThread = !!session.threadId;
-            let sessionStatus = isCurrentlyProcessing ? '处理中' : '空闲';
-            // 处理中时显示时长
-            if (isCurrentlyProcessing) {
-                const elapsed = Date.now() - parseInt(session.processingState, 10);
-                if (!isNaN(elapsed) && elapsed > 0) {
-                    const sec = Math.floor(elapsed / 1000);
-                    sessionStatus = sec < 60 ? `处理中 (${sec}秒)` :
-                        sec < 3600 ? `处理中 (${Math.floor(sec / 60)}分钟)` :
-                            `处理中 (${Math.floor(sec / 3600)}小时)`;
-                }
-            }
-            const projectName = this.getProjectName(session.projectPath);
-            const owningAgent = this.getOwningAgent(channel);
-            const agentName = owningAgent?.name ?? 'DefaultAgent';
-            const health = await this.sessionManager.getHealthStatus(session.id);
-            const timeSinceSuccess = Date.now() - health.lastSuccessTime;
-            const timeStr = timeSinceSuccess < 60000 ? '刚刚' :
-                timeSinceSuccess < 3600000 ? `${Math.floor(timeSinceSuccess / 60000)}分钟前` :
-                    `${Math.floor(timeSinceSuccess / 3600000)}小时前`;
-            // 获取会话文件信息并同步 name
-            let sessionTurns = 0;
-            if (session.agentSessionId) {
-                const fileInfo = this.sessionManager.getSessionFileInfo(session.projectPath, session.agentSessionId, session.agentId);
-                sessionTurns = fileInfo.turns;
-                if (fileInfo.title && fileInfo.title !== session.name) {
-                    await this.sessionManager.renameSession(session.id, fileInfo.title);
-                    session.name = fileInfo.title;
-                }
-            }
-            const lines = [];
-            const sessionMode = session.sessionMode || 'interactive';
-            const dispatchMode = session.metadata?.dispatchMode ?? '未设置（跟随群设置）';
-            const chatModeLine = `会话模式: ${sessionMode}`;
-            const dispatchModeLine = session.chatType === 'group' ? `分发模式: ${dispatchMode}` : null;
-            if (isAdmin) {
-                lines.push(`📊 ${isThread ? '话题' : '会话'}状态 (Agent: ${agentName})：`, `渠道: ${this.resolveChannelType(channel)} / 项目: ${projectName} / 会话: ${displaySessionTitle(session.name, '(未命名)')}`, `会话ID: ${session.id}`, `项目路径: ${session.projectPath}`, `会话状态: ${sessionStatus}`, chatModeLine, ...(dispatchModeLine ? [dispatchModeLine] : []), `会话轮数: ${sessionTurns}`);
-                if (health.consecutiveErrors > 0) {
-                    lines.push(`异常计数: ${health.consecutiveErrors}`);
-                }
-                lines.push(`最后成功: ${timeStr}`, `${session.agentId}会话: ${session.agentSessionId || '(未初始化)'}`, `创建时间: ${new Date(session.createdAt).toLocaleString('zh-CN')}`, `更新时间: ${new Date(session.updatedAt).toLocaleString('zh-CN')}`);
-            }
-            else {
-                lines.push(`📊 ${isThread ? '话题' : '会话'}状态 (Agent: ${agentName})：`, `渠道: ${channel} / 项目: ${projectName} / ${session.agentId}会话`, `状态: ${sessionStatus}`, chatModeLine, ...(dispatchModeLine ? [dispatchModeLine] : []), `会话轮数: ${sessionTurns}`, `最后活跃: ${timeStr}`);
-            }
-            if (health.lastError) {
-                lines.push('');
-                lines.push(`最后错误: ${health.lastErrorType || 'unknown'}`);
-                lines.push(`错误信息: ${health.lastError.substring(0, 100)}`);
-            }
-            return { kind: 'command.result', text: lines.join('\n') };
-        }
-        // /new 命令：创建新会话（支持命名）
-        if (normalizedContent.startsWith('/new')) {
-            const sessionName = normalizedContent.slice(4).trim() || undefined;
-            if (sessionName) {
-                const existing = await this.sessionManager.getSessionByName(channel, channelId, sessionName);
-                if (existing) {
-                    return { kind: 'command.error', text: `❌ 会话名称 "${sessionName}" 已存在，请使用其他名称` };
-                }
-            }
-            const projectPath = this.getEffectiveDefaultPath(channel);
-            if (sendMessage && session) {
-                await sendMessage(channelId, `⏳ 正在创建新会话${sessionName ? `: ${sessionName}` : ''}...`, this.getReplyContext(session));
-            }
-            const newSession = await this.sessionManager.createNewSession(channel, channelId, projectPath, sessionName, session?.agentId || this.primaryRunnerKey);
-            this.eventBus.publish({
-                type: 'session:created',
-                sessionId: newSession.id,
-                channel,
-                channelId,
-                projectPath,
-                name: sessionName,
-                timestamp: Date.now()
-            });
-            if (session) {
-                // Reset agent backend state so the new
-                // session starts with a fresh conversation history
-                await agent.clearSession(session.id, session.agentSessionId || '', session.projectPath);
-                await agent.closeSession(session.id);
-            }
-            return { kind: 'command.result', text: `✓ 已创建新会话${sessionName ? `: ${sessionName}` : ''}\n  项目: ${this.getProjectName(projectPath)}\n  之前的对话历史已保留，可通过 /s 查看` };
-        }
-        // /check 命令：检查渠道状态（guest 可用，详情仅 admin）/ 重连指定渠道（admin only）
-        if (normalizedContent === '/check' || normalizedContent.startsWith('/check ')) {
-            const subCmd = normalizedContent.slice('/check'.length).trim();
-            // 限定可见渠道：agent-owned 通道仅显示该 agent 名下的渠道；
-            // __ecweb__ 是 ECWeb 系统级入口，展示全量渠道
-            const checkOwningAgent = this.getOwningAgent(channel);
-            let allowedChannels;
-            if (checkOwningAgent) {
-                allowedChannels = new Set(checkOwningAgent.channelInstanceNames());
-            }
-            else if (channel === '__ecweb__') {
-                // ECWeb 全局视图：展示所有渠道
-                allowedChannels = new Set(this.adapters.keys());
-            }
-            else {
-                // default 范围：不再有 default channel 概念，等价于"所有 channel"
-                const defaultNames = [];
-                for (const [name] of this.adapters) {
-                    const owner = this.agentRegistry?.resolveByChannel(name);
-                    if (!owner)
-                        defaultNames.push(name);
-                }
-                allowedChannels = new Set(defaultNames);
-            }
-            // Default: show system health check (non-admin 仅看摘要)
-            const checkAgentName = checkOwningAgent?.name ?? 'DefaultAgent';
-            const lines = [`📡 渠道状态 (Agent: ${checkAgentName})：`];
-            // Group by channelType
-            const groups = new Map();
-            for (const [name] of this.adapters) {
-                if (!allowedChannels.has(name))
-                    continue;
-                const type = this.channelTypeMap.get(name) || name;
-                const ch = this.channelObjects.get(name);
-                let status;
-                if (ch?.getStatus) {
-                    const s = ch.getStatus();
-                    status = s.connected ? '✓ 已连接' : '⏳ 重连中';
-                }
-                else {
-                    status = '✓ 已注册';
-                }
-                if (!groups.has(type))
-                    groups.set(type, []);
-                groups.get(type).push({ name, status });
-            }
-            if (!isAdmin) {
-                // guest/user: 仅显示渠道健康摘要
-                const total = [...groups.values()].flat().length;
-                const healthy = [...groups.values()].flat().filter(i => i.status.includes('✓')).length;
-                lines.push(`  ${healthy}/${total} 渠道正常`);
-                return { kind: 'command.result', text: lines.join('\n') };
-            }
-            for (const [type, instances] of groups) {
-                if (instances.length === 1) {
-                    lines.push(`  ${type}: ${instances[0].status}`);
-                }
-                else {
-                    const parts = instances.map(i => {
-                        const seg = i.name.split('#');
-                        const instName = seg.length >= 3 ? seg.slice(2).join('#') : i.name;
-                        return `${i.status.includes('✓') ? '✓' : '⏳'} ${instName}`;
-                    });
-                    lines.push(`  ${type}: ${parts.join(', ')}`);
-                }
-            }
-            // 当前 agent 名（用于 agent 维度 stats / queue 查询）
-            const currentAgentName = checkOwningAgent?.name ?? '<unknown>';
-            // 队列状态（按当前 agent 维度）
-            lines.push('', '📬 队列状态：');
-            lines.push(`  待处理消息: ${this.messageQueue.getQueueLengthByAgent(currentAgentName)}`);
-            lines.push(`  处理中队列: ${this.messageQueue.getProcessingCountByAgent(currentAgentName)}`);
-            // 运行概况（全局，进程级）
-            lines.push('', '🖥️ 运行概况：');
-            const uptimeMs = this.statsCollector
-                ? this.statsCollector.getSnapshot().uptimeMs
-                : process.uptime() * 1000;
-            lines.push(`  运行时间: ${this.formatUptime(uptimeMs)}`);
-            // 近 1 小时统计（按当前 agent 维度）
-            if (this.statsCollector) {
-                const snap = this.statsCollector.getSnapshot(currentAgentName);
-                const h = snap.lastHour;
-                lines.push('', '📊 近 1 小时统计：');
-                lines.push(`  收到消息: ${h.received}`);
-                lines.push(`  完成处理: ${h.completed}`);
-                if (h.errors > 0) {
-                    const breakdown = Object.entries(h.errorsByType).map(([t, c]) => `${t}: ${c}`).join(', ');
-                    lines.push(`  处理出错: ${h.errors} (${breakdown})`);
-                }
-                else {
-                    lines.push(`  处理出错: 0`);
-                }
-                if (h.toolErrors > 0) {
-                    const toolBreakdown = Object.entries(h.toolErrorsByName).map(([t, c]) => `${t}: ${c}`).join(', ');
-                    lines.push(`  工具失败: ${h.toolErrors} (${toolBreakdown})`);
-                }
-                lines.push(`  被中断: ${h.interrupts}`);
-                if (h.completed > 0) {
-                    lines.push(`  平均响应耗时: ${(h.avgResponseMs / 1000).toFixed(1)}s`);
-                }
-            }
-            const checkSnap = this.statsCollector?.getSnapshot(currentAgentName);
-            const structured = {
-                channels: [...groups.entries()].map(([type, instances]) => ({ type, instances })),
-                queue: {
-                    pending: this.messageQueue.getQueueLengthByAgent(currentAgentName),
-                    processing: this.messageQueue.getProcessingCountByAgent(currentAgentName),
-                },
-                uptimeMs,
-                lastHour: checkSnap?.lastHour ?? null,
-                evolagents: this.agentRegistry?.list().map((ag) => ({
-                    name: ag.name, aid: ag.aid ?? '', status: ag.status,
-                    baseagent: ag.baseagent ?? null,
-                    activeTasks: this.messageQueue.getProcessingCountByAgent(ag.name)
-                        + this.messageQueue.getQueueLengthByAgent(ag.name),
-                    error: ag.error,
-                })) ?? [],
-                baseagents: [...this.agentMap.entries()].map(([key, runner]) => ({
-                    name: key.split('::')[1] ?? key,
-                    activeStreams: runner.activeStreamCount?.() ?? 0,
-                    healthy: true,
-                })),
-            };
-            return { kind: 'command.result', text: lines.join('\n'), structured };
-        }
-        // /restart 命令：重启服务（owner only）
-        if (normalizedContent === '/restart') {
-            // /restart（无参数）— 重启整个服务（owner only）
-            if (!isOwner)
-                return { kind: 'command.error', text: '❌ 无权限：服务重启仅限 owner 使用' };
-            const allSessions = await this.sessionManager.listSessions(channel, channelId);
-            const sessionsWithMessages = allSessions
-                .filter(s => this.messageCache.hasMessages(s.id))
-                .map(s => {
-                const count = this.messageCache.getCount(s.id);
-                return `${s.projectPath} 有 ${count} 条新消息`;
-            });
-            // 执行重启逻辑（共用于卡片回调和文本确认）
-            const executeRestart = async () => {
-                let replyContext;
-                if (threadId) {
-                    const threadSession = await this.sessionManager.getOrCreateSession(channel, channelId, this.getEffectiveDefaultPath(channel), threadId, undefined, undefined, undefined, undefined, undefined, selfAID ?? this.resolveSelfAID(channel), this.resolveChannelType(channel));
-                    replyContext = this.getReplyContext(threadSession);
-                }
-                const restartInfo = {
-                    channel,
-                    channelId,
-                    timestamp: Date.now(),
-                    ...(replyContext?.replyToMessageId ? { rootId: replyContext.replyToMessageId } : {}),
-                };
-                fs.writeFileSync(path.join(resolvePaths().dataDir, 'restart-pending.json'), JSON.stringify(restartInfo));
-                const { spawn } = await import('child_process');
-                spawn('node', [path.join(getPackageRoot(), 'dist', 'cli', 'index.js'), 'restart-monitor'], {
-                    detached: true,
-                    stdio: 'ignore',
-                    env: { ...process.env, EVOLCLAW_HOME: resolvePaths().root }
-                }).unref();
-                this.eventBus.publish({ type: 'system:restart', channel, channelId });
-                // 先发送重启反馈消息，等待发送完成后再 kill 进程
-                // 避免消息还没发出去进程就退出了
-                const adapter = this.adapters.get(channel);
-                if (adapter) {
-                    try {
-                        const envelope = buildEnvelope({
-                            taskId: `restart-${Date.now()}`,
-                            channel,
-                            channelId,
-                            agentName: 'system',
-                            chatmode: 'interactive',
-                            replyContext,
-                        });
-                        await adapter.send(envelope, { kind: 'command.result', text: '🔄 服务正在重启，请稍候...（约 5 秒后恢复）' });
-                        // 等待消息发送完成后再延迟 kill
-                        await new Promise(resolve => setTimeout(resolve, 500));
-                    }
-                    catch (err) {
-                        logger.error('[System] Failed to send restart notification:', err);
-                    }
-                }
-                // 发 SIGTERM 而非直接 process.exit(0)，让 index.ts 的 shutdown() 先
-                // 正常关闭所有 channel（包括 Feishu WebSocket close frame），
-                // 避免 Feishu 服务端因连接异常断开而重推未 ack 的消息给新进程。
-                setTimeout(() => {
-                    logger.info('[System] Restarting by user command...');
-                    process.kill(process.pid, 'SIGTERM');
-                }, 1000);
-                return true;
-            };
-            // 文本确认流程
-            if (sessionsWithMessages.length > 0) {
-                const restartKey = `${channel}-${channelId}`;
-                const restartConfirmFile = path.join(resolvePaths().dataDir, `restart-confirm-${restartKey}.json`);
-                if (fs.existsSync(restartConfirmFile)) {
-                    const confirmInfo = JSON.parse(fs.readFileSync(restartConfirmFile, 'utf-8'));
-                    const now = Date.now();
-                    if (now - confirmInfo.timestamp < 10000) {
-                        fs.unlinkSync(restartConfirmFile);
-                    }
-                    else {
-                        fs.writeFileSync(restartConfirmFile, JSON.stringify({ timestamp: now }));
-                        return { kind: 'command.result', text: sessionsWithMessages.join('\n') + '\n再次输入 /restart 将强制重启。' };
-                    }
-                }
-                else {
-                    fs.writeFileSync(restartConfirmFile, JSON.stringify({ timestamp: Date.now() }));
-                    return { kind: 'command.result', text: sessionsWithMessages.join('\n') + '\n再次输入 /restart 将强制重启。' };
-                }
-            }
-            await executeRestart();
-            // executeRestart 内部已经发送了反馈消息，这里返回 null 避免重复发送
-            return null;
-        }
-        // /upgrade 命令：检查版本更新，提示用户手动重启
-        if (normalizedContent === '/upgrade') {
-            if (!isAdmin)
-                return { kind: 'command.error', text: '❌ 无权限：升级检查仅限管理员使用' };
-            if (isLinkedInstall()) {
-                return { kind: 'command.result', text: '⏭ 开发模式，跳过升级检查' };
-            }
-            const localVer = getLocalVersion();
-            const remoteVer = await checkLatestVersion();
-            if (!remoteVer) {
-                return { kind: 'command.result', text: `⚠️ 无法连接 npm registry（当前版本 ${localVer}）` };
-            }
-            if (compareVersions(localVer, remoteVer) >= 0) {
-                return { kind: 'command.result', text: `✓ 已是最新版本 (${localVer})` };
-            }
-            return { kind: 'command.result', text: `📦 发现新版本 ${localVer} → ${remoteVer}\n执行 /restart 升级` };
-        }
-        // /pwd 命令：显示当前项目路径
-        if (normalizedContent === '/pwd') {
-            if (!session) {
-                return { kind: 'command.error', text: `❌ 无法创建会话，请检查配置` };
-            }
-            const configName = this.getConfiguredProjectName(session.projectPath);
-            if (configName) {
-                return { kind: 'command.result', text: `当前项目: ${configName}\n路径: ${session.projectPath}` };
-            }
-            return { kind: 'command.result', text: `当前项目: ${session.projectPath}` };
-        }
-        // /file 命令：发送项目内文件，支持 /file path 和 /file channel path（owner only）
-        if (normalizedContent.startsWith('/file')) {
-            if (!isOwner)
-                return { kind: 'command.error', text: '❌ 无权限：此命令仅限 owner 使用' };
-            // 飞书会将 .md 等后缀自动转为 Markdown 链接: foo.md → [foo.md](http://foo.md/)
-            // 还原: 将 [text](url) 替换为 text
-            const rawArg = normalizedContent.slice(5).trim().replace(/\[([^\]]+)\]\([^)]+\)/g, '$1');
-            if (!rawArg) {
-                return { kind: 'command.result', text: '用法: /file <相对路径> 或 /file <渠道> <相对路径>\n示例: /file src/index.ts\n示例: /file feishu report.md' };
-            }
-            // 解析目标通道：第一个 token 按实例名匹配，再按 channelType 匹配
-            const tokens = rawArg.split(/\s+/);
-            let targetChannel = channel;
-            let targetLabel = channel;
-            let filePath = rawArg;
-            if (tokens.length >= 2) {
-                const spec = tokens[0];
-                if (this.adapters.has(spec)) {
-                    // 精确实例名
-                    targetChannel = spec;
-                    targetLabel = spec;
-                    filePath = tokens.slice(1).join(' ');
-                }
-                else {
-                    // 按 channelType 查找第一个匹配的实例
-                    for (const [name] of this.adapters) {
-                        if ((this.channelTypeMap.get(name) || name) === spec) {
-                            targetChannel = name;
-                            targetLabel = spec;
-                            filePath = tokens.slice(1).join(' ');
-                            break;
-                        }
-                    }
-                }
-            }
-            const isCrossChannel = targetChannel !== channel;
-            // 跨通道仅限 owner
-            if (isCrossChannel && identity.role !== 'owner') {
-                return { kind: 'command.error', text: '❌ 跨通道发送仅限管理员' };
-            }
-            // 找目标 adapter
-            const targetAdapter = this.adapters.get(targetChannel);
-            if (!targetAdapter) {
-                return { kind: 'command.error', text: `❌ 通道 ${targetLabel} 未启用或不存在` };
-            }
-            if (!targetAdapter.capabilities?.file) {
-                return { kind: 'command.error', text: `❌ 通道 ${targetLabel} 不支持文件发送` };
-            }
-            // 获取 session（需要 projectPath）
-            const sendResult = await this.ensureSession(channel, channelId, threadId, chatType);
-            if ('error' in sendResult)
-                return { kind: 'command.result', text: sendResult.error };
-            const sendSession = sendResult.session;
-            // 路径安全校验
-            if (path.isAbsolute(filePath)) {
-                return { kind: 'command.error', text: '❌ 不支持绝对路径\n请使用项目内的相对路径' };
-            }
-            if (filePath.split(path.sep).includes('..') || filePath.split('/').includes('..')) {
-                return { kind: 'command.error', text: '❌ 不支持 .. 路径穿越' };
-            }
-            const resolvedPath = path.resolve(sendSession.projectPath, filePath);
-            // 存在性检查
-            if (!fs.existsSync(resolvedPath)) {
-                return { kind: 'command.error', text: `❌ 文件不存在: ${filePath}` };
-            }
-            // 符号链接安全：realpath 后验证仍在项目目录内
-            const realPath = fs.realpathSync(resolvedPath);
-            const realProjectPath = fs.realpathSync(sendSession.projectPath);
-            if (!realPath.startsWith(realProjectPath + path.sep) && realPath !== realProjectPath) {
-                return { kind: 'command.error', text: '❌ 路径不允许: 文件不在项目目录内' };
-            }
-            const stat = fs.statSync(resolvedPath);
-            if (stat.isDirectory()) {
-                return { kind: 'command.error', text: '❌ 暂不支持发送目录\n目录打包发送将在后续版本支持' };
-            }
-            const MAX_SIZE = 10 * 1024 * 1024;
-            if (stat.size > MAX_SIZE) {
-                return { kind: 'command.error', text: `❌ 文件过大: ${(stat.size / 1024 / 1024).toFixed(1)} MB (限制 10 MB)` };
-            }
-            // 找目标 channelId
-            let targetChannelId = channelId;
-            if (isCrossChannel) {
-                const ownerPeerId = this.agentRegistry?.getOwner?.(targetChannel);
-                targetChannelId = ownerPeerId ? (this.sessionManager.getOwnerChatId(targetChannel, ownerPeerId) ?? '') : '';
-                if (!targetChannelId) {
-                    return { kind: 'command.error', text: `❌ 未找到 ${targetLabel} 的私聊会话，请先在该通道发送一条消息` };
-                }
-            }
-            // 发送文件
-            try {
-                const replyCtx = isCrossChannel ? undefined : this.getReplyContext(sendSession);
-                await targetAdapter.send(buildEnvelope({ channel: targetAdapter.channelName, channelId: targetChannelId, replyContext: replyCtx }), { kind: 'result.file', filePath: realPath });
-                const sizeStr = stat.size < 1024 ? `${stat.size} B`
-                    : stat.size < 1024 * 1024 ? `${(stat.size / 1024).toFixed(1)} KB`
-                        : `${(stat.size / 1024 / 1024).toFixed(1)} MB`;
-                return { kind: 'command.result', text: isCrossChannel
-                        ? `📎 文件已通过 ${targetLabel} 发送: ${filePath} (${sizeStr})`
-                        : `✅ 已发送: ${filePath} (${sizeStr})` };
-            }
-            catch (error) {
-                logger.error('[CommandHandler] /file failed:', error);
-                return { kind: 'command.error', text: `❌ 文件发送失败: ${error.message || error}` };
-            }
-        }
-        // /slist 命令：列出当前项目的会话
-        // /slist      — 仅 EvolClaw 会话
-        // /slist cli  — 仅 CLI 会话（未导入的）
-        if (normalizedContent === '/slist' || normalizedContent === '/slist cli') {
-            if (!session) {
-                return { kind: 'command.error', text: `❌ 当前没有活跃会话
-
-请先执行以下操作之一：
-1. 发送任意消息 - 自动创建新会话
-2. /new [名称] - 创建命名会话` };
-            }
-            const showCliOnly = normalizedContent === '/slist cli';
-            // /slist cli — 仅显示 CLI 会话
-            if (showCliOnly) {
-                const canImportCli = policy.canImportCliSession(session.chatType || 'private', identity.role);
-                if (!canImportCli) {
-                    return { kind: 'command.error', text: '❌ 当前无权查看 CLI 会话' };
-                }
-                const cliSessions = await this.sessionManager.scanCliSessions(session.projectPath, session.agentId);
-                const sessions = await this.sessionManager.listSessions(channel, channelId);
-                const currentProjectSessions = sessions.filter(s => s.projectPath === session.projectPath && s.agentId === session.agentId && !s.threadId);
-                const dbSessionIds = new Set(currentProjectSessions.map(s => s.agentSessionId).filter(Boolean));
-                const orphanCliSessions = cliSessions.filter(c => !dbSessionIds.has(c.uuid));
-                if (orphanCliSessions.length === 0) {
-                    return { kind: 'command.result', text: `当前项目 ${path.basename(session.projectPath)} 没有未导入的 CLI 会话` };
-                }
-                // 构建显示数据（复用于卡片和文本）
-                const cliDisplayItems = orphanCliSessions.map(c => {
-                    const time = new Date(c.mtime).toLocaleString('zh-CN', { month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit' });
-                    const message = this.sessionManager.readSessionFirstMessage(session.projectPath, c.uuid, session.agentId) || '(无消息)';
-                    const uuid = c.uuid.substring(0, 8);
-                    return { uuid, fullUuid: c.uuid, time, message };
-                });
-                // 尝试发送 CommandCard 卡片
-                if (this.interactionRouter && cliDisplayItems.length > 0) {
-                    const bodyLines = cliDisplayItems.map(item => `• ${item.time}  (${item.uuid})  "${item.message}"`);
-                    const interaction = {
-                        type: 'interaction',
-                        id: `slist-cli-${Date.now()}-${crypto.randomBytes(4).toString('hex')}`,
-                        channelId,
-                        sessionId: session.id,
-                        initiatorId: userId,
-                        kind: {
-                            kind: 'command-card',
-                            title: `📋 ${path.basename(session.projectPath)} CLI 会话 (${cliDisplayItems.length})`,
-                            body: bodyLines.join('\n'),
-                            buttons: cliDisplayItems.map(item => ({
-                                label: item.uuid,
-                                command: `/session ${item.uuid}`,
-                                style: 'default',
-                            })),
-                        },
-                    };
-                    const replyCtx = this.getReplyContext(session);
-                    const cardResult = await this.sendCommandCard({ channel, channelId, interaction, replyCtx });
-                    if (cardResult === null)
-                        return null;
-                    return { kind: 'command.result', text: cardResult };
-                }
-                // 降级：文本列表
-                const lines = [`当前项目 ${path.basename(session.projectPath)} 的 CLI 会话 (共 ${orphanCliSessions.length} 个):`, ''];
-                for (const item of cliDisplayItems) {
-                    lines.push(`  ${item.time}  (${item.uuid})  "${item.message}"`);
-                }
-                lines.push('');
-                lines.push('使用 /s <8位uuid> 导入并切换到 CLI 会话');
-                return { kind: 'command.result', text: lines.join('\n') };
-            }
-            // /slist — 仅显示 EvolClaw 会话
-            const sessions = await this.sessionManager.listSessions(channel, channelId);
-            const currentProjectSessions = sessions.filter(s => s.projectPath === session.projectPath && s.agentId === session.agentId && !s.threadId);
-            // 从 SDK 同步会话名称（发现 CLI 改名）
-            try {
-                const sdkSessions = await this.sessionManager.listSdkSessions(session.projectPath, session.agentId);
-                for (const sdkSession of sdkSessions) {
-                    if (!sdkSession.title)
-                        continue;
-                    const dbSession = currentProjectSessions.find(s => s.agentSessionId === sdkSession.sessionId);
-                    if (dbSession && sdkSession.title !== dbSession.name) {
-                        await this.sessionManager.renameSession(dbSession.id, sdkSession.title);
-                        dbSession.name = sdkSession.title;
-                    }
-                }
-            }
-            catch (error) {
-                logger.debug('[CommandHandler] SDK listSessions sync failed (non-critical):', error);
-            }
-            // 构建可显示会话列表（复用于卡片和文本）
-            const maxDisplay = 10;
-            const displaySessions = [];
-            let displayIndex = 0;
-            for (let i = 0; i < currentProjectSessions.length; i++) {
-                const s = currentProjectSessions[i];
-                if (displayIndex >= maxDisplay)
-                    break;
-                const isActive = s.metadata?.isActive === true;
-                displayIndex++;
-                const name = displaySessionTitle(s.name, '(未命名)');
-                const idleTime = formatIdleTime(Date.now() - s.updatedAt);
-                const fileMissing = !!(s.agentSessionId && !this.sessionManager.checkSessionFileExists(s.projectPath, s.agentSessionId, s.agentId));
-                let status = '[空闲]';
-                if (fileMissing) {
-                    status = '[会话文件缺失]';
-                }
-                else if (!!s.processingState) {
-                    status = '[处理中]';
-                }
-                else if (isActive) {
-                    status = '[活跃]';
-                }
-                displaySessions.push({ session: s, index: displayIndex, isActive, name, status, idleTime, fileMissing });
-            }
-            // 尝试发送 CommandCard 卡片（每个会话一个按钮，一键切换）
-            if (this.interactionRouter && displaySessions.length >= 1) {
-                const bodyLines = displaySessions.map(ds => {
-                    const prefix = ds.isActive ? '✓' : '•';
-                    const uuid = ds.session.agentSessionId ? `(${ds.session.agentSessionId.substring(0, 8)})` : '';
-                    const fileMark = ds.fileMissing ? '❌ ' : '';
-                    return `${prefix} ${ds.index}. ${fileMark}**${ds.name}** ${uuid}  ${ds.idleTime} ${ds.status}`;
-                });
-                const interaction = {
-                    type: 'interaction',
-                    id: `slist-${Date.now()}-${crypto.randomBytes(4).toString('hex')}`,
-                    channelId,
-                    sessionId: session.id,
-                    initiatorId: userId,
-                    kind: {
-                        kind: 'command-card',
-                        title: `📋 ${path.basename(session.projectPath)} 会话列表`,
-                        body: bodyLines.join('\n'),
-                        buttons: displaySessions.map(ds => {
-                            const shortId = ds.session.agentSessionId ? ds.session.agentSessionId.substring(0, 8) : ds.name;
-                            return {
-                                label: ds.isActive ? `✓ ${ds.index}. ${shortId}` : `${ds.index}. ${shortId}`,
-                                command: `/session ${ds.index}`,
-                                style: (ds.isActive ? 'primary' : 'default'),
-                                disabled: ds.isActive,
-                            };
-                        }),
-                    },
-                };
-                const replyCtx = this.getReplyContext(session);
-                const cardResult = await this.sendCommandCard({ channel, channelId, interaction, replyCtx });
-                if (cardResult === null)
-                    return null;
-                return { kind: 'command.result', text: cardResult };
-            }
-            // 降级：文本列表
-            const lines = [`当前项目 ${path.basename(session.projectPath)} 的 [${session.agentId}] 会话列表:`, ''];
-            if (currentProjectSessions.length > 0) {
-                for (const ds of displaySessions) {
-                    const prefix = ds.isActive ? '  ✓' : '   ';
-                    const num = `${ds.index}.`;
-                    const uuid = ds.session.agentSessionId ? `(${ds.session.agentSessionId.substring(0, 8)})` : '';
-                    if (ds.fileMissing) {
-                        lines.push(`${prefix} ${num} ❌ ${ds.name} ${uuid} - ${ds.idleTime} ${ds.status}`);
-                    }
-                    else {
-                        lines.push(`${prefix} ${num} ${ds.name} ${uuid} - ${ds.idleTime} ${ds.status}`);
-                    }
-                }
-                const hiddenCount = currentProjectSessions.length - displayIndex;
-                if (hiddenCount > 0) {
-                    const parts = [];
-                    if (hiddenCount > 0)
-                        parts.push(`${hiddenCount} 个更早的会话`);
-                    lines.push(`\n  (已隐藏 ${parts.join('、')})`);
-                }
-                lines.push('');
-            }
-            lines.push('使用 /s <序号、name或8位uuid> 切换会话');
-            lines.push('使用 /s cli 查看 CLI 会话');
-            return { kind: 'command.result', text: lines.join('\n') };
-        }
-        // /session（无参数）：直接复用 /slist 逻辑（含卡片交互）
-        if (normalizedContent === '/session') {
-            const delegated = await this.handle('/slist', channel, channelId, undefined, userId, threadId);
-            return typeof delegated === 'string' ? { kind: 'command.result', text: delegated } : delegated;
-        }
-        // /session cli（= /s cli）：列出未导入的 CLI 会话
-        if (normalizedContent === '/session cli') {
-            const delegated = await this.handle('/slist cli', channel, channelId, undefined, userId, threadId);
-            return typeof delegated === 'string' ? { kind: 'command.result', text: delegated } : delegated;
-        }
-        // /session 或 /s 命令：切换会话
-        if (normalizedContent.startsWith('/session ')) {
-            const sessionName = normalizedContent.slice(9).trim();
-            if (!sessionName)
-                return { kind: 'command.result', text: '用法: /s <序号、会话名称或前8位UUID>' };
-            let targetSession = await this.sessionManager.getSessionByName(channel, channelId, sessionName);
-            // 序号切换：纯数字时按 /slist 显示的序号匹配（超过10个时隐藏非活跃话题会话）
-            if (!targetSession && /^\d+$/.test(sessionName) && session) {
-                const idx = parseInt(sessionName, 10);
-                const allSessions = await this.sessionManager.listSessions(channel, channelId);
-                const visibleSessions = allSessions.filter(s => s.projectPath === session.projectPath && s.agentId === session.agentId && !s.threadId);
-                if (idx >= 1 && idx <= visibleSessions.length) {
-                    targetSession = visibleSessions[idx - 1];
-                }
-                else {
-                    return { kind: 'command.error', text: `❌ 序号超出范围 (1-${visibleSessions.length})\n使用 /s 查看可用会话` };
-                }
-            }
-            if (!targetSession && sessionName.length >= 8) {
-                targetSession = await this.sessionManager.getSessionByUuidPrefix(channel, channelId, sessionName);
-            }
-            if (targetSession?.threadId) {
-                return { kind: 'command.error', text: `❌ 话题会话不支持通过 /s 切换\n请在对应话题内继续对话` };
-            }
-            const canImport = policy.canImportCliSession(session?.chatType || 'private', identity.role);
-            if (!targetSession && sessionName.length >= 8 && canImport) {
-                const projectPaths = Object.values(this.projects);
-                if (session) {
-                    projectPaths.unshift(session.projectPath);
-                }
-                for (const projectPath of projectPaths) {
-                    const currentAgentId = session?.agentId || this.primaryRunnerKey;
-                    const cliSessions = await this.sessionManager.scanCliSessions(projectPath, currentAgentId);
-                    const cliSession = cliSessions.find(c => c.uuid.startsWith(sessionName));
-                    if (cliSession) {
-                        const imported = await this.sessionManager.importCliSession(channel, channelId, projectPath, cliSession.uuid, currentAgentId);
-                        this.eventBus.publish({ type: 'session:imported', sessionId: imported.id, agentSessionId: cliSession.uuid, projectPath });
-                        const projectName = this.getProjectName(projectPath);
-                        return { kind: 'command.result', text: `✓ 已导入 CLI 会话: ${displaySessionTitle(imported.name, '(未命名)')}\n  项目: ${projectName}\n  将继续之前的对话历史` };
-                    }
-                }
-            }
-            if (!targetSession) {
-                return { kind: 'command.error', text: `❌ 会话不存在: ${sessionName}\n使用 /s 查看可用会话` };
-            }
-            const lastInput = targetSession.agentSessionId
-                ? this.sessionManager.readSessionLastUserMessage(targetSession.projectPath, targetSession.agentSessionId, targetSession.agentId)
-                : null;
-            const lastInputLine = lastInput ? `\n  最后输入: "${lastInput}"` : '';
-            if (!session) {
-                const switched = await this.sessionManager.switchToSession(channel, channelId, targetSession.id);
-                if (!switched) {
-                    return { kind: 'command.error', text: `❌ 切换会话失败` };
-                }
-                if (source === 'card-trigger')
-                    return null;
-                return { kind: 'command.result', text: `✓ 已切换到会话: ${displaySessionTitle(targetSession.name, sessionName)}\n  项目: ${path.basename(targetSession.projectPath)}${lastInputLine}` };
-            }
-            if (targetSession.id === session.id) {
-                return { kind: 'command.result', text: `当前已在会话: ${displaySessionTitle(targetSession.name, sessionName)}` };
-            }
-            // 阻止从主会话切换到话题会话
-            if (!session.threadId && targetSession.threadId) {
-                return { kind: 'command.error', text: `❌ 无法从主会话切换到话题会话\n话题会话仅在对应话题内可用` };
-            }
-            const switched = await this.sessionManager.switchToSession(channel, channelId, targetSession.id);
-            if (!switched) {
-                return { kind: 'command.error', text: `❌ 切换会话失败` };
-            }
-            this.eventBus.publish({ type: 'session:switched', sessionId: targetSession.id, fromSessionId: session.id, toSessionId: targetSession.id });
-            const continueHint = lastInput ? '\n  将继续之前的对话历史' : '\n  当前会话未有发言';
-            if (source === 'card-trigger')
-                return null;
-            return { kind: 'command.result', text: `✓ 已切换到会话: ${displaySessionTitle(targetSession.name, sessionName)}${continueHint}${lastInputLine}` };
-        }
-        // /rename 或 /name 命令：重命名当前会话
-        if (normalizedContent === '/rename' || normalizedContent === '/name') {
-            return { kind: 'command.result', text: '用法: /name <新名称> 或 /rename <新名称>' };
-        }
-        if (normalizedContent.startsWith('/rename ')) {
-            const newName = normalizedContent.slice(8).trim();
-            if (!newName)
-                return { kind: 'command.result', text: '用法: /name <新名称> 或 /rename <新名称>' };
-            if (!session) {
-                return { kind: 'command.error', text: `❌ 当前没有活跃会话
-
-请先执行以下操作之一：
-1. 发送任意消息 - 自动创建新会话
-2. /new [名称] - 创建命名会话
-3. /session <名称> - 切换到已有会话` };
-            }
-            const existing = await this.sessionManager.getSessionByName(channel, channelId, newName);
-            if (existing && existing.id !== session.id) {
-                return { kind: 'command.error', text: `❌ 会话名称 "${newName}" 已存在，请使用其他名称` };
-            }
-            const oldName = displaySessionTitle(session.name, '(未命名)');
-            const success = await this.sessionManager.renameSession(session.id, newName);
-            if (success && session.agentSessionId) {
-                const renameAgent = this.getAgent(channel, session.agentId);
-                await renameAgent.setSessionName?.(session.agentSessionId, newName).catch(error => {
-                    logger.debug('[CommandHandler] Backend session rename sync failed:', error);
-                });
-            }
-            if (!success) {
-                return { kind: 'command.error', text: `❌ 重命名失败` };
-            }
-            this.eventBus.publish({ type: 'session:renamed', sessionId: session.id, oldName, newName });
-            return { kind: 'command.result', text: `✓ 已将当前会话重命名为: ${newName}` };
-        }
-        // /del 命令：删除指定会话（仅解绑，不删除文件）
-        if (normalizedContent.startsWith('/del ')) {
-            const sessionName = normalizedContent.slice(5).trim();
-            if (!sessionName)
-                return { kind: 'command.result', text: '用法: /del <序号、会话名称或前8位UUID>' };
-            if (!session) {
-                return { kind: 'command.error', text: `❌ 当前没有活跃会话` };
-            }
-            // 权限检查：policy 控制谁可以删除会话
-            if (!policy.canDeleteSession(session.chatType || 'private', identity.role)) {
-                return { kind: 'command.error', text: `❌ 无权限：群聊中仅管理员可删除会话` };
-            }
-            let targetSession = await this.sessionManager.getSessionByName(channel, channelId, sessionName);
-            // 序号删除（与 /slist 显示序号一致）
-            if (!targetSession && /^\d+$/.test(sessionName)) {
-                const idx = parseInt(sessionName, 10);
-                const allSessions = await this.sessionManager.listSessions(channel, channelId);
-                const visibleSessions = allSessions.filter(s => s.projectPath === session.projectPath && s.agentId === session.agentId && !s.threadId);
-                if (idx >= 1 && idx <= visibleSessions.length) {
-                    targetSession = visibleSessions[idx - 1];
-                }
-                else {
-                    return { kind: 'command.error', text: `❌ 序号超出范围 (1-${visibleSessions.length})\n使用 /s 查看可用会话` };
-                }
-            }
-            if (!targetSession && sessionName.length >= 8) {
-                targetSession = await this.sessionManager.getSessionByUuidPrefix(channel, channelId, sessionName);
-            }
-            if (targetSession?.threadId) {
-                return { kind: 'command.error', text: `❌ 请使用话题管理删除话题会话` };
-            }
-            if (!targetSession) {
-                return { kind: 'command.error', text: `❌ 会话不存在: ${sessionName}\n使用 /s 查看可用会话` };
-            }
-            if (targetSession.id === session.id) {
-                return { kind: 'command.error', text: `❌ 无法删除当前活跃会话\n请先切换到其他会话` };
-            }
-            const success = await this.sessionManager.unbindSession(targetSession.id);
-            if (!success) {
-                return { kind: 'command.error', text: `❌ 删除失败` };
-            }
-            this.eventBus.publish({ type: 'session:deleted', sessionId: targetSession.id });
-            const targetAgent = this.getAgent(channel, targetSession.agentId);
-            await targetAgent.closeSession(targetSession.id);
-            return { kind: 'command.result', text: `✓ 已删除会话: ${displaySessionTitle(targetSession.name, sessionName)}\n会话文件已保留，可通过 CLI 访问` };
-        }
-        // /fork 命令：分支当前会话
-        if (normalizedContent === '/fork' || normalizedContent.startsWith('/fork ')) {
-            const forkName = normalizedContent.slice(5).trim() || undefined;
-            if (!session) {
-                return { kind: 'command.error', text: `❌ 当前没有活跃会话，无法分支` };
-            }
-            if (!session.agentSessionId) {
-                return { kind: 'command.error', text: `❌ 当前会话尚未初始化对话，无法分支\n\n请先发送一条消息，然后再使用 /fork` };
-            }
-            const forkAgent = this.getAgent(channel, session.agentId);
-            if (!forkAgent.capabilities?.fork) {
-                return { kind: 'command.error', text: `❌ 当前 Agent (${forkAgent.name}) 不支持 /fork\n\n可使用 /new 创建新会话替代` };
-            }
-            try {
-                const forkedSessionId = await forkAgent.forkSession(session.agentSessionId, session.projectPath, forkName);
-                const newSession = await this.sessionManager.createForkedSession(session, forkedSessionId, forkName);
-                await forkAgent.updateSessionMetadata?.(forkedSessionId, {
-                    gitInfo: {
-                        branch: null,
-                        commitHash: null,
-                        repositoryUrl: null,
-                    },
-                    evolclawSessionId: newSession.id,
-                    sourceSessionId: session.id,
-                }).catch(error => {
-                    logger.debug('[CommandHandler] Backend fork metadata sync failed:', error);
-                });
-                this.eventBus.publish({ type: 'session:forked', sessionId: newSession.id, sourceSessionId: session.id, name: forkName });
-                return { kind: 'command.result', text: `✅ 会话已分支: ${displaySessionTitle(newSession.name, '(未命名)')}\n新会话已激活，可以继续对话\n\n使用 /s 查看所有会话，/s <名称> 切换回原会话` };
-            }
-            catch (error) {
-                logger.error('[CommandHandler] Fork session failed:', error);
-                return { kind: 'command.error', text: `❌ 会话分支失败: ${error instanceof Error ? error.message : '未知错误'}` };
-            }
-        }
-        // /rewind 命令：查看历史 / 回退会话
-        if (normalizedContent === '/rewind' || normalizedContent.startsWith('/rewind ')) {
-            const result = await this.ensureSession(channel, channelId, threadId, chatType);
-            if ('error' in result)
-                return { kind: 'command.error', text: result.error };
-            const { session } = result;
-            const rewindAgent = this.getAgent(channel, session.agentId);
-            if (!session.agentSessionId) {
-                return { kind: 'command.error', text: '❌ 当前会话无历史记录\n\n请先发送一条消息，然后再使用 /rewind' };
-            }
-            if (!rewindAgent.getSessionMessages) {
-                return { kind: 'command.error', text: `❌ 当前 Agent (${rewindAgent.name}) 不支持 /rewind` };
-            }
-            const args = normalizedContent.slice('/rewind'.length).trim();
-            if (!args) {
-                return { kind: 'command.result', text: await this.handleRewindList(session, rewindAgent) };
-            }
-            // 带参（执行回退，会删除文件/改对话）需 admin+
-            if (!isAdmin)
-                return { kind: 'command.error', text: '❌ 无权限：回退操作仅限管理员使用' };
-            const parts = args.split(/\s+/);
-            const turnNum = parseInt(parts[0], 10);
-            if (isNaN(turnNum) || turnNum < 1) {
-                return { kind: 'command.error', text: '❌ 无效轮次，用法：/rewind <N> chat|file|all（撤销第N轮）' };
-            }
-            const mode = parts[1]?.toLowerCase();
-            if (!mode) {
-                return { kind: 'command.error', text: `❌ 请指定回退模式：/rewind ${turnNum} chat | file | all（撤销第${turnNum}轮）` };
-            }
-            if (!['chat', 'file', 'all'].includes(mode)) {
-                return { kind: 'command.error', text: `❌ 无效模式 "${mode}"，可选：chat | file | all` };
-            }
-            return { kind: 'command.result', text: await this.handleRewind(session, rewindAgent, turnNum, mode) };
-        }
-        // /repair 命令：检查并修复会话文件
-        if (normalizedContent === '/repair') {
-            const repairResult = await this.ensureSession(channel, channelId, threadId, chatType);
-            if ('error' in repairResult)
-                return { kind: 'command.result', text: repairResult.error };
-            const { session: repairSession } = repairResult;
-            const repairAgent = this.getAgent(channel, repairSession.agentId);
-            const { checkSessionFile, backupSessionFile } = await import('./session/session-file-health.js');
-            try {
-                if (!repairSession.agentSessionId) {
-                    await this.sessionManager.resetHealthStatus(repairSession.id);
-                    return { kind: 'command.result', text: `✓ 修复完成\n\n修复内容：\n- 未发现问题（新会话）\n- 已重置异常计数器` };
-                }
-                // 通过 agent 定位 session 文件
-                const sessionFile = repairAgent.resolveSessionFile?.(repairSession.agentSessionId, repairSession.projectPath) ?? null;
-                if (!sessionFile) {
-                    // 文件不存在（已被删除或从未创建），直接重置
-                    await this.sessionManager.resetHealthStatus(repairSession.id);
-                    return { kind: 'command.result', text: `✓ 修复完成\n\n修复内容：\n- 会话文件不存在（可能已被清理）\n- 已重置异常计数器` };
-                }
-                const healthCheck = await checkSessionFile(sessionFile);
-                if (healthCheck.corrupt) {
-                    const backupPath = await backupSessionFile(sessionFile);
-                    const fsPromises = await import('fs/promises');
-                    await fsPromises.unlink(sessionFile);
-                    await this.sessionManager.updateAgentSessionIdBySessionId(repairSession.id, '');
-                    repairAgent.updateSessionId(repairSession.id, '');
-                    await this.sessionManager.resetHealthStatus(repairSession.id);
-                    return { kind: 'command.result', text: `✓ 修复完成\n\n检测到问题：\n${healthCheck.issues.map((i) => `- ${i}`).join('\n')}\n\n修复操作：\n- 已备份损坏文件\n- 已删除损坏文件\n- 已重置异常计数器\n\n备份位置：${backupPath}` };
-                }
-                if (healthCheck.issues.length > 0) {
-                    await this.sessionManager.resetHealthStatus(repairSession.id);
-                    return { kind: 'command.error', text: `⚠️ 检测到问题：\n${healthCheck.issues.map((i) => `- ${i}`).join('\n')}\n\n建议使用 /new 创建新会话\n\n已重置异常计数器，可继续使用当前会话。` };
-                }
-                await this.sessionManager.resetHealthStatus(repairSession.id);
-                return { kind: 'command.result', text: `✓ 修复完成\n\n修复内容：\n- 未发现问题\n- 已重置异常计数器` };
-            }
-            catch (error) {
-                logger.error('[Repair] Failed:', error);
-                return { kind: 'command.error', text: `❌ 修复失败: ${error.message}` };
-            }
-        }
-        // /safe 命令：安全模式已禁用
-        if (normalizedContent === '/safe') {
-            return { kind: 'command.result', text: `ℹ️ 安全模式已禁用\n\n如需重置会话，请使用 /new 创建新会话。` };
-        }
-        // /trigger 命令
-        if (normalizedContent === '/trigger' || normalizedContent.startsWith('/trigger ')) {
-            const text = await this.handleTrigger(normalizedContent, channel, channelId, userId ?? '', isAdmin, messageId);
-            return { kind: 'command.result', text };
-        }
-        return null;
-    }
-    async handleTrigger(content, channel, channelId, peerId, isAdmin, messageId) {
-        // Resolve trigger manager/scheduler from the owning agent of this channel
-        const owningAgent = this.getOwningAgent(channel);
-        const scheduler = (owningAgent?.triggerScheduler ?? this.triggerScheduler);
-        const manager = (owningAgent?.triggerManager ?? this.triggerManager);
-        // Bare /trigger → list active
-        if (content === '/trigger') {
-            if (!manager)
-                return '⚠️ 触发器功能未启用';
-            const active = manager.listActive();
-            if (active.length === 0)
-                return '📭 当前没有活跃的触发器';
-            const lines = active.map(t => {
-                const next = new Date(t.nextFireAt).toLocaleString();
-                const fired = t.fireCount > 0 ? ` | 已触发 ${t.fireCount} 次` : '';
-                return `• **${t.name}** [${t.scheduleType}] 下次: ${next}${fired}`;
-            });
-            return `📋 活跃触发器（${active.length} 个）：\n\n${lines.join('\n')}`;
-        }
-        const sub = content.slice('/trigger '.length).trim();
-        // /trigger list → list all (active + history)
-        if (sub === 'list' || sub.startsWith('list ')) {
-            if (!manager)
-                return '⚠️ 触发器功能未启用';
-            const { active, history } = manager.listAll();
-            const lines = [];
-            if (active.length > 0) {
-                lines.push(`**活跃 (${active.length})**`);
-                for (const t of active) {
-                    const next = new Date(t.nextFireAt).toLocaleString();
-                    lines.push(`• ${t.name} [${t.scheduleType}] 下次: ${next} | 触发 ${t.fireCount} 次`);
-                }
-            }
-            if (history.length > 0) {
-                lines.push(`\n**历史 (${history.length})**`);
-                for (const h of history.slice(-10)) {
-                    const done = new Date(h.doneAt).toLocaleString();
-                    lines.push(`• ${h.name} [${h.doneReason}] ${done}`);
-                }
-            }
-            if (lines.length === 0)
-                return '📭 没有触发器记录';
-            return lines.join('\n');
-        }
-        // /trigger cancel <name|id>
-        if (sub.startsWith('cancel ')) {
-            if (!manager || !scheduler)
-                return '⚠️ 触发器功能未启用';
-            const nameOrId = sub.slice('cancel '.length).trim();
-            if (!nameOrId)
-                return '❌ 用法：/trigger cancel <名称>';
-            // Find trigger: non-admin lookup is scoped to (peerId, channel) to avoid info disclosure
-            // Non-admins can cancel by name or by their own trigger's UUID
-            let trigger;
-            if (isAdmin) {
-                trigger = manager.getByName(nameOrId) ?? manager.getById(nameOrId);
-            }
-            else {
-                trigger = manager.getByNameScoped(nameOrId, peerId, channel)
-                    ?? manager.getByIdScoped(nameOrId, peerId, channel);
-            }
-            if (!trigger) {
-                return isAdmin
-                    ? `❌ 未找到触发器：${nameOrId}`
-                    : `❌ 未找到触发器 "${nameOrId}"，或无权限取消`;
-            }
-            manager.moveToDone(trigger.id, 'cancelled');
-            scheduler.cancel(trigger.id);
-            this.eventBus.publish({ type: 'trigger:cancelled', triggerId: trigger.id, name: trigger.name, by: peerId });
-            return `✅ 触发器已取消：**${trigger.name}**`;
-        }
-        // /trigger update <name|id> [--参数...]
-        if (sub.startsWith('update ')) {
-            if (!manager || !scheduler)
-                return '⚠️ 触发器功能未启用';
-            const args = sub.slice('update '.length);
-            const result = parseTriggerUpdate(args);
-            if (!result.ok)
-                return `❌ ${result.error}`;
-            const { nameOrId, value: patch } = result;
-            // Find trigger: non-admin lookup is scoped
-            let trigger;
-            if (isAdmin) {
-                trigger = manager.getByName(nameOrId) ?? manager.getById(nameOrId);
-            }
-            else {
-                trigger = manager.getByNameScoped(nameOrId, peerId, channel)
-                    ?? manager.getByIdScoped(nameOrId, peerId, channel);
-            }
-            if (!trigger) {
-                return isAdmin
-                    ? `❌ 未找到触发器：${nameOrId}`
-                    : `❌ 未找到触发器 "${nameOrId}"，或无权限修改`;
-            }
-            // If schedule changed, recalculate nextFireAt
-            if (patch.scheduleType && patch.scheduleValue) {
-                const now = Date.now();
-                patch.nextFireAt = calcNextFireAt(patch.scheduleType, patch.scheduleValue, now);
-            }
-            // 跨渠道迁移：改了 targetChannel 时必须同步重算 targetChannelType，
-            // 并按 session 策略重新绑定执行会话（与 set 路径保持一致，否则 trigger
-            // 仍按旧 channelType 路由 / 仍绑在旧渠道的 boundSessionId 上）。
-            const effectiveChannel = patch.targetChannel ?? trigger.targetChannel;
-            const effectiveChannelId = patch.targetChannelId ?? trigger.targetChannelId;
-            if (patch.targetChannel) {
-                patch.targetChannelType = this.resolveChannelType(patch.targetChannel);
-            }
-            // 解析最终生效的 session 策略（patch 优先，否则沿用原 trigger）
-            const effStrategy = patch.targetSessionStrategy ?? trigger.targetSessionStrategy;
-            // 渠道或策略变化时，按策略重新绑定会话
-            if (patch.targetChannel || patch.targetSessionStrategy) {
-                if (effStrategy === 'current') {
-                    if (patch.targetChannel && patch.targetChannel !== trigger.targetChannel) {
-                        return '❌ 跨渠道不支持 --session current，请改用 latest 或 thread';
-                    }
-                    const active = await this.sessionManager.getActiveSession(effectiveChannel, effectiveChannelId);
-                    if (!active)
-                        return '❌ 目标渠道当前没有活跃会话，改用 --session latest 或先在该渠道发一条消息';
-                    patch.boundSessionId = active.id;
-                }
-                else if (effStrategy === 'thread') {
-                    const adapter = this.adapters.get(effectiveChannel);
-                    if (!adapter?.capabilities.thread)
-                        return '❌ 目标渠道不支持 thread 会话';
-                }
-                else {
-                    // latest 策略：清除旧的 boundSessionId（若有），按渠道动态取最新会话
-                    if (trigger.boundSessionId)
-                        patch.boundSessionId = undefined;
-                }
-            }
-            let updated;
-            try {
-                updated = manager.update(trigger.id, patch);
-                scheduler.update(updated);
-            }
-            catch (err) {
-                return `❌ 更新失败：${err.message}`;
-            }
-            const nextStr = new Date(updated.nextFireAt).toLocaleString();
-            return `✅ 触发器已更新：**${updated.name}**\n下次触发：${nextStr}`;
-        }
-        // /trigger set ...
-        if (sub.startsWith('set ')) {
-            if (!manager || !scheduler)
-                return '⚠️ 触发器功能未启用';
-            const args = sub.slice('set '.length);
-            const result = parseTriggerSet(args);
-            if (!result.ok)
-                return `❌ ${result.error}`;
-            const reg = await this.registerTriggerFromParsed(result.value, channel, channelId, peerId, messageId);
-            if (!reg.ok)
-                return `❌ ${reg.error}`;
-            const nextStr = new Date(reg.trigger.nextFireAt).toLocaleString();
-            return `✅ 触发器已注册：**${reg.trigger.name}**\n下次触发：${nextStr}`;
-        }
-        return `❌ 未知子命令。用法：\n/trigger — 查看活跃触发器\n/trigger list — 查看所有触发器\n/trigger set <参数> — 注册触发器\n/trigger update <名称|ID> <参数> — 修改触发器\n/trigger cancel <名称> — 取消触发器`;
-    }
-    /** 从已解析的 trigger 参数组装 Trigger 并注册。文本路径（handleTrigger）与 menu 路径共用。
-     *  parsed 形状 = parseTriggerSet 的 result.value（ParsedTriggerSet）。
-     *  失败 return { ok:false, error }；成功 return { ok:true, trigger }。本方法不改变原文本路径行为。 */
-    async registerTriggerFromParsed(parsed, channel, channelId, peerId, messageId) {
-        const owningAgent = this.getOwningAgent(channel);
-        const scheduler = (owningAgent?.triggerScheduler ?? this.triggerScheduler);
-        const manager = (owningAgent?.triggerManager ?? this.triggerManager);
-        if (!manager || !scheduler)
-            return { ok: false, error: '触发器功能未启用' };
-        const now = Date.now();
-        const nextFireAt = calcNextFireAt(parsed.scheduleType, parsed.scheduleValue, now);
-        // Auto-generate name if not provided
-        const name = parsed.name ?? `trigger-${Date.now().toString(36)}`;
-        // Validate target channel exists
-        const targetChannelName = parsed.targetChannel ?? channel;
-        if (parsed.targetChannel && !this.adapters.has(parsed.targetChannel)) {
-            return { ok: false, error: `目标渠道不存在或未启用：${parsed.targetChannel}` };
-        }
-        // Validate channelId format for AUN: must look like an AID (contains '.')
-        const targetChannelType = this.resolveChannelType(targetChannelName);
-        const targetChannelId = parsed.targetChannelId ?? channelId;
-        if (targetChannelType === 'aun' && parsed.targetChannelId && !parsed.targetChannelId.includes('.')) {
-            return { ok: false, error: `AUN 渠道的 --channelid 必须是 AID 格式（如 user.agentid.pub），收到："${parsed.targetChannelId}"` };
-        }
-        const trigger = {
-            id: crypto.randomUUID(),
-            name,
-            scheduleType: parsed.scheduleType,
-            scheduleValue: parsed.scheduleValue,
-            nextFireAt,
-            targetChannel: targetChannelName,
-            targetChannelId,
-            targetChannelType,
-            targetThreadId: parsed.targetThreadId,
-            targetSessionStrategy: parsed.targetSessionStrategy,
-            agentId: parsed.agentId,
-            prompt: parsed.prompt,
-            createdByPeerId: peerId,
-            createdByChannel: channel,
-            fireCount: 0,
-            failCount: 0,
-            createdAt: now,
-            updatedAt: now,
-        };
-        try {
-            // Strategy-based session binding
-            if (parsed.targetSessionStrategy === 'current') {
-                if (parsed.targetChannel && parsed.targetChannel !== channel) {
-                    return { ok: false, error: '跨渠道不支持 --session current，请改用 latest 或 thread' };
-                }
-                const active = await this.sessionManager.getActiveSession(channel, channelId);
-                if (!active)
-                    return { ok: false, error: '当前没有活跃会话，改用 --session latest 或 thread' };
-                trigger.boundSessionId = active.id;
-            }
-            else if (parsed.targetSessionStrategy === 'thread') {
-                const targetAdapterName = parsed.targetChannel ?? channel;
-                const adapter = this.adapters.get(targetAdapterName);
-                if (!adapter?.capabilities.thread)
-                    return { ok: false, error: '目标渠道不支持 thread 会话' };
-                const channelType = adapter.channelKey.split('#')[0];
-                trigger.targetChannelType = channelType;
-                if (channelType === 'aun') {
-                    trigger.threadKind = 'aun';
-                    trigger.targetThreadId = `trigger-${trigger.id}`;
-                }
-                else {
-                    if (!messageId)
-                        return { ok: false, error: '飞书 thread 模式需要消息 ID，请重新发送命令' };
-                    trigger.threadKind = 'feishu';
-                    trigger.rootMessageId = messageId;
-                    trigger.pendingThread = true;
-                }
-            }
-            // Validate name uniqueness before persisting (manager.register writes to disk)
-            // scheduler.register is in-memory only and cannot fail, so order is safe here.
-            // If manager.register throws (duplicate name/ID), nothing is persisted.
-            manager.register(trigger);
-            scheduler.register(trigger);
-        }
-        catch (err) {
-            return { ok: false, error: `注册失败：${err.message}` };
-        }
-        return { ok: true, trigger };
-    }
-    // ── /rewind helpers ──
-    async handleRewindList(session, agent) {
-        try {
-            const messages = await agent.getSessionMessages(session.agentSessionId, session.projectPath);
-            const turns = this.buildTurnList(messages);
-            if (turns.length === 0) {
-                return '📋 当前会话暂无对话记录';
-            }
-            const lines = turns.map(t => `#${t.index} ${t.userContent}`);
-            return [
-                `📋 会话历史 (共 ${turns.length} 轮)`,
-                '',
-                ...lines,
-                '',
-                '💡 /rewind <N> chat|file|all — 撤销第N轮',
-            ].join('\n');
-        }
-        catch (error) {
-            logger.error('[CommandHandler] Failed to read session messages:', error);
-            return `❌ 读取会话历史失败: ${error instanceof Error ? error.message : '未知错误'}`;
-        }
-    }
-    async handleRewind(session, agent, turnNum, mode) {
-        try {
-            const messages = await agent.getSessionMessages(session.agentSessionId, session.projectPath);
-            const turns = this.buildTurnList(messages);
-            if (turnNum < 1 || turnNum > turns.length) {
-                return `❌ 轮次超出范围，当前共 ${turns.length} 轮`;
-            }
-            // /rewind N = 撤销第N轮（及之后），保留 1..N-1
-            const rewindTarget = turns[turnNum - 1]; // 被撤销的轮次（用于文件回退）
-            const keepTarget = turnNum >= 2 ? turns[turnNum - 2] : null; // 保留到的轮次（用于对话回退）
-            const results = [];
-            // 文件回退（立即执行）
-            if (mode === 'file' || mode === 'all') {
-                if (!agent.rewindFiles) {
-                    return '❌ 当前 Agent 不支持文件回退';
-                }
-                const fileResult = await agent.rewindFiles(session.agentSessionId, session.projectPath, rewindTarget.userUuid);
-                if (!fileResult.canRewind) {
-                    if (mode === 'file') {
-                        return `❌ 当前会话无文件快照，无法回退文件${fileResult.error ? `\n原因: ${fileResult.error}` : ''}`;
-                    }
-                    results.push(`⚠️ 文件回退失败${fileResult.error ? `: ${fileResult.error}` : '（无文件快照）'}`);
-                }
-                else {
-                    const detail = fileResult.filesChanged
-                        ? `（恢复了 ${fileResult.filesChanged.length} 个文件）`
-                        : '';
-                    if (agent.capabilities?.fileRewind === 'git-head') {
-                        results.push(`✅ 已按 Git HEAD 恢复文件${detail}（Codex 当前不提供逐轮文件快照）`);
-                    }
-                    else {
-                        results.push(`✅ 已恢复文件到第 ${turnNum} 轮之前的状态${detail}`);
-                    }
-                }
-            }
-            // 对话回退：Codex app-server 可直接 rollback；Claude 走 resumeAt 延迟到下次消息生效。
-            if (mode === 'chat' || mode === 'all') {
-                const discarded = turns.length - turnNum + 1;
-                if (agent.rollbackSessionTurns) {
-                    const ok = await agent.rollbackSessionTurns(session.agentSessionId, session.projectPath, discarded);
-                    if (!ok)
-                        return '❌ 对话回退失败';
-                    const meta = { ...(session.metadata || {}) };
-                    delete meta.resumeAt;
-                    await this.sessionManager.updateSession(session.id, { metadata: meta });
-                }
-                else if (keepTarget) {
-                    const meta = { ...(session.metadata || {}), resumeAt: keepTarget.assistantUuid };
-                    await this.sessionManager.updateSession(session.id, { metadata: meta });
-                }
-                else {
-                    // N=1：撤销全部对话，清空 session 从头开始
-                    const meta = { ...(session.metadata || {}) };
-                    delete meta.resumeAt;
-                    await this.sessionManager.updateSession(session.id, {
-                        metadata: meta,
-                        agentSessionId: null,
-                    });
-                }
-                results.push(`✅ 已撤销第 ${turnNum} 轮${discarded > 1 ? `及后续共 ${discarded} 轮` : ''}`, keepTarget ? `下次发言将从第 ${turnNum - 1} 轮继续` : '下次发言将开始全新对话');
-            }
-            this.eventBus.publish({
-                type: 'session:rewind',
-                sessionId: session.id,
-                turnNum,
-                mode,
-            });
-            return results.join('\n');
-        }
-        catch (error) {
-            logger.error('[CommandHandler] Rewind failed:', error);
-            return `❌ 回退失败: ${error instanceof Error ? error.message : '未知错误'}`;
-        }
-    }
-    buildTurnList(messages) {
-        const turns = [];
-        let pendingUser = null;
-        for (const msg of messages) {
-            if (msg.type === 'user') {
-                const m = msg.message;
-                if (Array.isArray(m?.content) && m.content.every((c) => c.type === 'tool_result')) {
-                    continue;
-                }
-                const content = this.extractUserContent(msg.message);
-                if (content) {
-                    pendingUser = { content, uuid: msg.uuid };
-                }
-            }
-            else if (msg.type === 'assistant' && pendingUser) {
-                turns.push({
-                    index: turns.length + 1,
-                    userContent: pendingUser.content,
-                    userUuid: pendingUser.uuid,
-                    assistantUuid: msg.uuid,
-                });
-                pendingUser = null;
-            }
-        }
-        return turns;
-    }
-    // ── Agent Ctl ──
-    static CTL_COMMANDS = [
-        '/help', '/status', '/check', '/pwd',
-        '/model', '/effort', '/perm', '/agent', '/baseagent',
-        '/compact', '/file', '/send', '/restart', '/aid', '/rpc', '/storage',
-        '/rename', '/name', '/trigger',
-        '/chatmode', '/dispatch', '/activity',
-    ];
-    /** ctl 中仅允许查询形态的指令；写形态（带参）一律拒绝 */
-    static CTL_READONLY = new Set(['/baseagent']);
-    /**
-     * 从 session 恢复 ReplyContext，用于 ctl send 主动发送文本时的路由
-     * - 群聊话题：metadata.replyContext.{threadId,peerId}
-     * - 私聊：metadata.peerId
-     * - taskId/chatmode：从 processing_state 和 sessionMode 注入
-     */
-    buildCtlReplyContext(session) {
-        const ctx = {};
-        const meta = session.metadata;
-        if (meta?.replyContext?.threadId)
-            ctx.threadId = meta.replyContext.threadId;
-        if (meta?.replyContext?.peerId)
-            ctx.peerId = meta.replyContext.peerId;
-        if (!ctx.peerId && meta?.peerId)
-            ctx.peerId = meta.peerId;
-        const taskId = this.sessionManager.getActiveTaskId(session.id);
-        const chatmode = session.sessionMode || 'interactive';
-        const encrypted = this.sessionManager.getSessionEncrypt(session.id);
-        // 诊断日志：记录 task_id 解析结果
-        logger.info(`[CommandHandler] buildCtlReplyContext: sessionId=${session.id} taskId=${taskId ?? 'none'} chatmode=${chatmode} threadId=${ctx.threadId ?? 'none'}`);
-        if (taskId || chatmode !== 'interactive' || encrypted != null) {
-            ctx.metadata = {};
-            if (taskId)
-                ctx.metadata.taskId = taskId;
-            if (chatmode !== 'interactive')
-                ctx.metadata.chatmode = chatmode;
-            if (encrypted != null)
-                ctx.metadata.encrypted = encrypted;
-        }
-        return Object.keys(ctx).length > 0 ? ctx : undefined;
-    }
-    /**
-     * Agent ctl 入口：通过 IPC 接收 Agent 自主管理指令
-     * 复用现有 slash cmd 逻辑，权限继承 session 用户角色
-     */
-    async handleCtl(cmd, sessionId) {
-        logger.info(`[ctl] cmd="${cmd}" sessionId=${sessionId}`);
-        // 1. 白名单检查
-        const inputCmd = cmd.split(' ')[0];
-        if (!CommandHandler.CTL_COMMANDS.includes(inputCmd)) {
-            return { ok: false, error: `不允许的指令: ${inputCmd}` };
-        }
-        // 1.1 只读守卫：带参形态（写操作）在 ctl 中禁止
-        if (CommandHandler.CTL_READONLY.has(inputCmd) && cmd.trimEnd().length > inputCmd.length) {
-            return { ok: false, error: `${inputCmd} 在 ctl 中仅支持查询形态，不支持带参切换` };
-        }
-        // 2. 通过 sessionId 查 session
-        const session = await this.sessionManager.getSessionById(sessionId);
-        if (!session) {
-            return { ok: false, error: '无效的 session' };
-        }
-        // 3. 从 session.metadata.peerId 获取 userId（用于权限判断）
-        const userId = session.metadata?.peerId;
-        // 3.1 /agent: EvolAgent 管理（转发到 CLI）
-        if (cmd === '/agent' || cmd.startsWith('/agent ')) {
-            const arg = cmd.slice('/agent'.length).trim();
-            // 无参数时返回用法
-            if (!arg) {
-                return { ok: true, result: `用法:\n  /agent list              列出所有 agent\n  /agent show [name]       查看 agent 详情\n  /agent enable <name>     启用 agent\n  /agent disable <name>    停用 agent\n  /agent get <name> <key>  读取配置字段\n  /agent set <name> <key> <val>  修改配置字段\n  /agent rename <name> <newname> 修改名称\n  /agent reload [name]     热重载配置` };
-            }
-            const parts = arg.split(/\s+/);
-            const subCmd = parts[0];
-            // ctl 禁止 new/delete（仅限 CLI 操作）
-            if (subCmd === 'new' || subCmd === 'delete') {
-                return { ok: false, error: `❌ /agent ${subCmd} 仅限 CLI 操作，请使用: evolclaw agent ${subCmd} ...` };
-            }
-            // 自我保护：不能 disable 自己所在的 agent
-            const selfAgent = this.getOwningAgent(session.channel);
-            const selfName = selfAgent?.name;
-            if (selfName && subCmd === 'disable' && parts[1] === selfName) {
-                return { ok: false, error: `❌ 不能 disable 自己所在的 agent: ${selfName}` };
-            }
-            // 转发到 CLI
-            const cliArgs = ['agent', ...parts];
-            try {
-                const { execFile } = await import('node:child_process');
-                const { promisify } = await import('node:util');
-                const execFileAsync = promisify(execFile);
-                const { stdout, stderr } = await execFileAsync('evolclaw', cliArgs, {
-                    timeout: 30000,
-                    encoding: 'utf-8',
-                    env: { ...process.env, AUN_LOG_INI_DISABLE: '1' },
-                });
-                const output = (stdout || '').trim();
-                if (!output && stderr)
-                    return { ok: true, result: `⚠ ${stderr.trim().slice(0, 500)}` };
-                return { ok: true, result: output || '(无输出)' };
-            }
-            catch (e) {
-                const msg = e.stderr?.trim() || e.stdout?.trim() || String(e.message || e);
-                return { ok: false, error: msg.slice(0, 500) };
-            }
-        }
-        // 4. /send 文本消息：直接通过 adapter 主动发送，不走 handle()
-        if (cmd.startsWith('/send ') || cmd === '/send') {
-            // 解析 --encrypt 标志和消息文本
-            const raw = cmd.startsWith('/send ') ? cmd.slice(6).trim() : '';
-            const forceEncrypt = raw.startsWith('--encrypt ');
-            const text = forceEncrypt ? raw.slice(10).trim() : raw;
-            if (!text)
-                return { ok: false, error: '消息内容不能为空' };
-            const adapter = this.adapters.get(session.channel);
-            if (!adapter)
-                return { ok: false, error: `adapter 未找到: ${session.channel}` };
-            try {
-                const replyContext = this.buildCtlReplyContext(session);
-                const taskId = replyContext?.metadata?.taskId;
-                const chatmode = replyContext?.metadata?.chatmode ?? 'interactive';
-                // --encrypt 覆盖 session 加密状态
-                // 添加 source: 'ctl' 标记（用于区分 ec ctl send）
-                const enrichedReplyContext = forceEncrypt
-                    ? { ...(replyContext ?? {}), metadata: { ...(replyContext?.metadata ?? {}), encrypted: true, source: 'ctl' } }
-                    : { ...(replyContext ?? {}), metadata: { ...(replyContext?.metadata ?? {}), source: 'ctl' } };
-                await adapter.send(buildEnvelope({ taskId, channel: adapter.channelName, channelId: session.channelId, chatmode, replyContext: enrichedReplyContext }), { kind: 'result.text', text, isFinal: true });
-                // 出方向 jsonl 写入已下沉到 aun.ts:deliverTextEntry，message.send 成功后统一写入。
-                return { ok: true, result: 'ok' };
-            }
-            catch (err) {
-                return { ok: false, error: err.message || String(err) };
-            }
-        }
-        // 5. file 路径限制：只允许 projectPath 下的文件
-        if (cmd.startsWith('/file')) {
-            const sendArgs = cmd.slice(5).trim();
-            const parts = sendArgs.split(/\s+/);
-            const filePath = parts[parts.length - 1];
-            if (filePath) {
-                const resolved = path.resolve(session.projectPath, filePath).replace(/\\/g, '/');
-                const projectPath = session.projectPath.replace(/\\/g, '/');
-                if (!resolved.startsWith(projectPath)) {
-                    return { ok: false, error: '路径越界：只能发送项目目录下的文件' };
-                }
-            }
-        }
-        // 5.1 /aid, /rpc, /storage — ctl 专属，转发到 CLI 执行
-        if (cmd === '/aid' || cmd.startsWith('/aid ') ||
-            cmd === '/rpc' || cmd.startsWith('/rpc ') ||
-            cmd === '/storage' || cmd.startsWith('/storage ')) {
-            // 权限检查：仅 owner
-            if (userId) {
-                const identity = this.sessionManager.resolveIdentity(session.channel, userId);
-                if (identity.role !== 'owner') {
-                    return { ok: false, error: '无权限：此命令仅限 owner 使用' };
-                }
-            }
-            // 无参数时返回用法说明
-            if (cmd === '/aid') {
-                return { ok: true, result: `用法:\n  /aid list              列出本地所有 AID\n  /aid show <aid>        查看 AID 详情\n  /aid new <aid>         创建新 AID\n  /aid delete <aid>      删除本地 AID\n  /aid lookup <aid>      远程探测 AID\n  /aid agentmd put <aid> 签名并上传 agent.md\n  /aid agentmd get <aid> 下载并验签 agent.md` };
-            }
-            if (cmd === '/rpc') {
-                return { ok: true, result: `用法: /rpc --as <aid> --params <json>\n示例: /rpc --as myaid.agentid.pub --params {"method":"meta.ping","params":{}}` };
-            }
-            if (cmd === '/storage') {
-                return { ok: true, result: `用法:\n  /storage upload <aid> <file> <path> [--public]\n  /storage download <aid> <url> [local-path]\n  /storage ls <aid> [prefix]\n  /storage rm <aid> <path>\n  /storage quota <aid>` };
-            }
-            // /aid 自我保护：不能删除当前 agent 所用的 AID
-            if (cmd.startsWith('/aid delete ')) {
-                const targetAid = cmd.slice('/aid delete '.length).trim();
-                const selfAgent = this.getOwningAgent(session.channel);
-                const selfAid = selfAgent?.config?.aid;
-                if (selfAid && targetAid === selfAid) {
-                    return { ok: false, error: `❌ 不能删除当前 agent 所用的 AID: ${selfAid}` };
-                }
-            }
-            const cliArgs = cmd.slice(1); // strip leading /
-            try {
-                const { execFile } = await import('node:child_process');
-                const { promisify } = await import('node:util');
-                const execFileAsync = promisify(execFile);
-                const { stdout, stderr } = await execFileAsync('evolclaw', cliArgs.split(/\s+/), {
-                    timeout: 30000,
-                    encoding: 'utf-8',
-                    env: { ...process.env, AUN_LOG_INI_DISABLE: '1' },
-                });
-                const output = (stdout || '').trim();
-                if (!output && stderr)
-                    return { ok: true, result: `⚠ ${stderr.trim().slice(0, 500)}` };
-                return { ok: true, result: output || '(无输出)' };
-            }
-            catch (e) {
-                const msg = e.stderr?.trim() || e.stdout?.trim() || String(e.message || e);
-                return { ok: false, error: msg.slice(0, 500) };
-            }
-        }
-        // 6. 调用现有 handle()，不传 sendMessage 回调（结果直接返回）
-        try {
-            const result = await this.handle(cmd, session.channel, session.channelId, undefined, // 不发送消息
-            userId);
-            const text = typeof result === 'string' ? result : (result && 'text' in result ? result.text : '(无输出)');
-            return { ok: true, result: text || '(无输出)' };
-        }
-        catch (err) {
-            return { ok: false, error: err.message };
-        }
-    }
-    extractUserContent(message) {
-        const m = message;
-        let text = '';
-        if (typeof m?.content === 'string') {
-            text = m.content;
-        }
-        else if (Array.isArray(m?.content)) {
-            text = m.content.filter((b) => b.type === 'text').map((b) => b.text).join(' ');
-        }
-        text = text.trim();
-        // Strip injection wrappers before previewing (outermost first):
-        // 1. Interrupt wrapper: 【新消息插入】\n...\n【请无视之前中断继续处理】
-        text = text.replace(/^【新消息插入】\s*/, '').replace(/\s*【请无视之前中断继续处理】$/, '').trim();
-        // 2. Current format: ‹metadata›\ncontent  (message-renderer item.md)
-        if (text.startsWith('‹')) {
-            const nl = text.indexOf('\n');
-            if (nl !== -1)
-                text = text.slice(nl + 1).trim();
-        }
-        // 3. Legacy XML format: <messages><message sender="..." time="...">content</message></messages>
-        if (text.startsWith('<messages>')) {
-            const parts = [];
-            const re = /<message(?:\s[^>]*)?>([\s\S]*?)<\/message>/g;
-            let match;
-            while ((match = re.exec(text)) !== null)
-                parts.push(match[1].trim());
-            if (parts.length > 0)
-                text = parts.join(' ');
-        }
-        text = text.replace(/\s+/g, ' ').trim();
-        if (!text)
-            return '';
-        return text.length > 50 ? text.substring(0, 50) + '…' : text;
-    }
-}
-/** 进程级 menu 操作（/agent、/system）鉴权：发送方 AID 必须在 owners 名单中。
- *  owners 来自 evolclaw.json 顶层（进程级控制面配置）。纯静态名单比对。 */
-export function isProcessLevelOwner(peerId, owners) {
-    if (!peerId)
-        return false;
-    return (owners ?? []).includes(peerId);
-}
-/** ECWeb menu.response 错误信封。 */
-function ecwebErr(id, name, code, message) {
-    return { type: 'menu.response', id, ...(name ? { name } : {}), error: { code, message } };
-}
-/** 把 execMenu* 的 {data}|{error} 结果转成 menu.response。 */
-function ecwebResp(id, name, result) {
-    return 'error' in result
-        ? { type: 'menu.response', id, ...(name ? { name } : {}), error: { code: result.code ?? 'EXEC_FAILED', message: result.error } }
-        : { type: 'menu.response', id, ...(name ? { name } : {}), data: result.data };
-}
-/** 校验 menu 路径直传的 trigger 调度参数（绕过 parseTriggerSet 文本解析后必须自校验）。
- *  返回错误字符串表示非法；返回 null 表示通过。
- *  防止非法 scheduleType/scheduleValue 传到 calcNextFireAt 产出 NaN/throw，污染 scheduler heap。 */
-export function validateScheduleParams(scheduleType, scheduleValue) {
-    if (!['delay', 'at', 'cron'].includes(scheduleType)) {
-        return `无效 scheduleType: ${scheduleType}（可选: delay / at / cron）`;
-    }
-    if (scheduleType === 'delay') {
-        const ms = Number(scheduleValue);
-        if (!Number.isFinite(ms) || ms <= 0)
-            return `delay 的 scheduleValue 需为正整数毫秒: ${scheduleValue}`;
-    }
-    else if (scheduleType === 'at') {
-        const ts = new Date(scheduleValue).getTime();
-        if (!Number.isFinite(ts))
-            return `at 的 scheduleValue 需为合法时间: ${scheduleValue}`;
-    }
-    else {
-        // cron：交给 calcNextFireAt 内部的 CronExpressionParser 校验（会 throw，被上层 catch）
-        try {
-            calcNextFireAt('cron', scheduleValue, Date.now());
-        }
-        catch {
-            return `无效 cron 表达式: ${scheduleValue}`;
-        }
-    }
-    return null;
-}