evolclaw 2.4.0 → 2.5.1

package/dist/core/command-handler.js

@@ -1,5 +1,5 @@
 import { hasModelSwitcher, hasPermissionController } from '../agents/claude-runner.js';
-import { saveConfig, resolvePaths, getPackageRoot, getOwner } from '../config.js';
+import { saveConfig, resolvePaths, getPackageRoot, getOwner, getChannelShowActivities, setChannelShowActivities } from '../config.js';
 import { logger } from '../utils/logger.js';
 import crypto from 'crypto';
 import path from 'path';
@@ -22,10 +22,10 @@ function formatModelUsage(agent, model) {
     const efforts = getAvailableEfforts(agent, model);
     const lines = [
         '用法:',
-        '  /model <model>           切换模型',
+        '  /model <模型>            切换模型',
     ];
     if (efforts.length > 0) {
-        lines.push('  /model <model> <effort>  切换模型+推理强度');
+        lines.push('  /model <模型> <强度>     切换模型+推理强度');
         lines.push('  /effort [level]          查看或切换推理强度');
     }
     return lines.join('\n');
@@ -103,15 +103,16 @@ function formatIdleTime(ms) {
     return '刚刚';
 }
 // 支持的命令列表
-const commands = ['/new', '/pwd', '/plist', '/project', '/bind', '/help', '/status', '/restart', '/model', '/effort', '/agent', '/slist', '/session', '/rename', '/stop', '/clear', '/compact', '/repair', '/safe', '/fork', '/del', '/perm', '/send', '/check'];
+const commands = ['/new', '/pwd', '/plist', '/project', '/bind', '/help', '/status', '/restart', '/model', '/effort', '/agent', '/slist', '/session', '/rename', '/stop', '/clear', '/compact', '/repair', '/safe', '/fork', '/del', '/perm', '/send', '/check', '/rewind', '/activity', '/agentmd'];
 // 命令别名映射
 const aliases = {
     '/p': '/project',
     '/s': '/session',
-    '/name': '/rename'
+    '/name': '/rename',
+    '/rw': '/rewind'
 };
 // 命令快速路径前缀（所有命令都不进入消息队列）
-const quickCommandPrefixes = ['/new', '/pwd', '/plist', '/project', '/bind', '/help', '/status', '/restart', '/model', '/effort', '/agent', '/slist', '/session', '/rename', '/repair', '/fork', '/stop', '/clear', '/compact', '/safe', '/del', '/perm', '/send', '/check', '/p ', '/s ', '/name '];
+const quickCommandPrefixes = ['/new', '/pwd', '/plist', '/project', '/bind', '/help', '/status', '/restart', '/model', '/effort', '/agent', '/slist', '/session', '/rename', '/repair', '/fork', '/stop', '/clear', '/compact', '/safe', '/del', '/perm', '/send', '/check', '/p ', '/s ', '/name', '/rewind', '/rw', '/rw ', '/activity'];
 export class CommandHandler {
     sessionManager;
     config;
@@ -237,15 +238,8 @@ export class CommandHandler {
             return false;
         const wrappedCallback = async (action, values, operatorId) => {
             await opts.callback(action, values, operatorId);
-            const adapter = this.adapters.get(opts.channel);
-            if (adapter?.patchInteractionCard) {
-                const disabledCard = {
-                    config: { wide_screen_mode: true },
-                    header: { template: 'grey', title: { tag: 'plain_text', content: '已过期' } },
-                    elements: [{ tag: 'markdown', content: '此卡片已过期，请查看最新卡片。' }],
-                };
-                adapter.patchInteractionCard(messageId, disabledCard).catch(() => { });
-            }
+            // 已完成交互的卡片：保留原始内容，仅禁用按钮（不标记为"已过期"）
+            // "已过期"仅用于被新卡片替代的旧卡片（invalidateOldCards）
         };
         this.interactionRouter.register(opts.requestId, opts.sessionId, wrappedCallback, { timeoutMs: 120_000, messageId });
         return true;
@@ -322,9 +316,11 @@ export class CommandHandler {
     }
     /**
      * 返回结构化命令菜单（供 menu.query 使用）
-     * admin 看到全部命令分组，guest 仅看到用户级命令
+     * owner 看到全部命令，admin 看到管理级命令（不含 owner-only），guest 仅看到用户级命令
      */
-    getMenuItems(isAdmin, chatType = 'private') {
+    getMenuItems(role, chatType = 'private') {
+        const isOwner = role === 'owner';
+        const isAdmin = role === 'owner' || role === 'admin';
         const items = [];
         if (!isAdmin && chatType === 'group') {
             return [
@@ -332,6 +328,7 @@ export class CommandHandler {
                     group: '其他',
                     commands: [
                         { cmd: '/status', label: '显示会话状态' },
+                        { cmd: '/check', label: '检查渠道健康' },
                         { cmd: '/help', label: '显示帮助信息' },
                     ]
                 }
@@ -341,22 +338,23 @@ export class CommandHandler {
             items.push({
                 group: '项目管理',
                 commands: [
-                    { cmd: '/pwd', label: '显示当前项目路径' },
-                    { cmd: '/p', args: '[name|path]', label: '列出或切换项目' },
-                    { cmd: '/bind', args: '<path>', label: '绑定新项目目录' },
+                    { cmd: '/pwd', label: '显示当前项目路径', desc: '查看当前会话绑定的项目目录' },
+                    { cmd: '/p', label: '列出或切换项目', desc: '切换到其他已配置的项目', next: { type: 'select', dynamic: true } },
+                    ...(isOwner ? [{ cmd: '/bind', label: '绑定新项目目录', desc: '将当前会话绑定到指定项目路径', next: { type: 'text' } }] : []),
                 ]
             });
         }
         items.push({
             group: '会话管理',
             commands: [
-                { cmd: '/new', args: '[name]', label: '创建新会话（清空历史请用此命令）' },
-                { cmd: '/s', args: '[cli|name|index|uuid]', label: '列出或切换会话（cli 查看未导入的 CLI 会话）' },
-                { cmd: '/name', args: '<name>', label: '重命名当前会话' },
-                { cmd: '/del', args: '<name>', label: '删除指定会话' },
+                { cmd: '/new', label: '创建新会话', desc: '清空历史，开始全新对话', next: { type: 'text' } },
+                { cmd: '/s', 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', args: '[name]', label: '分支当前会话' },
-                    { cmd: '/compact', label: '压缩会话上下文' },
+                    { cmd: '/fork', label: '分支当前会话', desc: '基于当前会话创建独立分支', next: { type: 'text' } },
+                    { cmd: '/rewind', label: '查看历史/撤销指定轮次', desc: '回退会话到指定轮次，可选择撤销文件改动' },
+                    { cmd: '/compact', label: '压缩会话上下文', desc: '将长对话压缩为摘要以节省 token' },
                 ] : []),
             ]
         });
@@ -364,25 +362,56 @@ export class CommandHandler {
             items.push({
                 group: 'Agent 与模型',
                 commands: [
-                    { cmd: '/agent', args: '[name]', label: '查看或切换 Agent 后端' },
-                    { cmd: '/model', args: '[model]', label: '查看或切换模型' },
-                    { cmd: '/effort', args: '[level]', label: '查看或切换推理强度' },
+                    { cmd: '/agent', 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' },
+                            ] } },
                 ]
             });
             items.push({
                 group: '权限管理',
                 commands: [
-                    { cmd: '/perm', args: '[mode|allow|always|deny]', label: '权限模式管理' },
+                    { cmd: '/perm', label: '权限模式管理', desc: '控制工具调用的审批策略', next: { type: 'select', items: [
+                                ...(isOwner ? [
+                                    { value: 'auto', label: '自动模式', desc: '根据风险等级自动决定是否审批' },
+                                    { value: 'bypass', 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: '显示会话状态' },
-                    { cmd: '/stop', label: '中断当前任务' },
-                    { cmd: '/restart', label: '重启服务' },
-                    { cmd: '/send', args: '[channel] <path>', label: '发送项目内文件' },
-                    { cmd: '/check', args: '[rty <channel>]', label: '检查渠道状态或重连指定渠道' },
+                    { 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: '重启服务或重连指定渠道', next: { type: 'select', dynamic: true } },
+                    ] : []),
+                    ...(isOwner ? [
+                        { cmd: '/send', label: '发送项目内文件', desc: '将项目目录内的文件发送给用户' },
+                        { cmd: '/agentmd', label: '管理 agent.md', desc: '查看或更新 AUN 网络上的 agent.md 身份文件', next: { type: 'select', items: [
+                                    { value: 'put', label: '上传当前', desc: '将本地 agent.md 上传到 AUN 网络' },
+                                    { value: 'set', label: '直接设置', desc: '输入内容直接更新 agent.md', next: { type: 'text' } },
+                                ] } },
+                    ] : []),
                 ]
             });
         }
@@ -390,21 +419,67 @@ export class CommandHandler {
             items.push({
                 group: '其他',
                 commands: [
-                    { cmd: '/status', label: '显示会话状态' },
+                    { cmd: '/status', label: '显示会话状态', desc: '查看当前会话的基本状态' },
+                    { cmd: '/check', label: '检查渠道健康', desc: '检查消息渠道连接状态' },
                 ]
             });
         }
         items.push({
             group: '帮助',
             commands: [
-                { cmd: '/help', label: '显示帮助信息' },
+                { cmd: '/help', label: '显示帮助信息', desc: '列出所有可用命令及说明' },
             ]
         });
         return items;
     }
-    /**
-     * 快速判断是否为命令（不进队列的命令）
-     */
+    /** 动态子菜单：根据 cmd 路径返回选项列表（供 menu.query + cmd 使用） */
+    async getSubMenuItems(cmd, channel, channelId, userId) {
+        const session = await this.sessionManager.getActiveSession(channel, channelId);
+        if (cmd === '/s' || cmd === '/del') {
+            const sessions = await this.sessionManager.listSessions(channel, channelId);
+            const active = cmd === '/del' ? await this.sessionManager.getActiveSession(channel, channelId) : null;
+            const items = sessions
+                .filter(s => !active || s.id !== active.id)
+                .map(s => {
+                const shortId = s.agentSessionId ? s.agentSessionId.substring(0, 8) : '';
+                const time = s.updatedAt ? formatIdleTime(Date.now() - s.updatedAt) : '';
+                const parts = [shortId, time].filter(Boolean).join(' · ');
+                return {
+                    value: s.name || s.id.slice(0, 8),
+                    label: s.name || s.id.slice(0, 8),
+                    desc: parts || undefined,
+                };
+            });
+            if (cmd === '/s') {
+                items.push({ value: 'cli', label: '查看 CLI 会话', desc: '列出未导入的 CLI 本地会话' });
+            }
+            return items;
+        }
+        if (cmd === '/p') {
+            const list = this.config.projects?.list || {};
+            return Object.entries(list).map(([name, path]) => ({ value: name, label: name, desc: path }));
+        }
+        if (cmd === '/agent') {
+            return [...this.agentMap.keys()].map(name => ({ value: name, label: name }));
+        }
+        if (cmd === '/model') {
+            const agent = this.getAgent(session?.agentId);
+            if (hasModelSwitcher(agent) && agent.listModels) {
+                const models = await agent.listModels() ?? [];
+                if (models.length > 0)
+                    return models.map((m) => ({ value: m, label: m }));
+            }
+            return null;
+        }
+        if (cmd === '/restart') {
+            const isOwner = userId ? this.sessionManager.resolveIdentity(channel, userId).role === 'owner' : false;
+            const channels = [...this.adapters.keys()].map(name => ({ value: name, label: name, desc: '重连此渠道' }));
+            if (isOwner)
+                channels.unshift({ value: '', label: '重启服务', desc: '重启整个 EvolClaw 服务进程' });
+            return channels;
+        }
+        return null;
+    }
     isCommand(content) {
         return content === '/p' || content === '/s' || quickCommandPrefixes.some(cmd => content.startsWith(cmd));
     }
@@ -438,20 +513,23 @@ export class CommandHandler {
             }
         }
         // 权限检查：区分用户级命令和管理级命令
-        const isAdmin = identity.role === 'owner';
+        const isOwner = identity.role === 'owner';
+        const isAdmin = identity.role === 'owner' || identity.role === 'admin';
         const activeChatType = activeSession?.chatType || 'private';
         if (normalizedContent.startsWith('/')) {
-            const guestGroupCommands = ['/status', '/help'];
+            const guestGroupCommands = ['/status', '/help', '/check'];
             const userCommands = activeChatType === 'group' && !isAdmin
                 ? guestGroupCommands
-                : ['/slist', '/new', '/session', '/rename', '/name', '/status', '/help', '/del', '/s '];
+                : ['/slist', '/new', '/session', '/rename', '/name', '/status', '/help', '/del', '/s ', '/check'];
             const isUserCommand = userCommands.some(cmd => normalizedContent === cmd.trimEnd() || normalizedContent.startsWith(cmd));
             if (!isUserCommand && !isAdmin) {
-                return '❌ 无权限：当前群聊仅支持 /status 和 /help';
+                return activeChatType === 'group'
+                    ? '❌ 无权限：当前群聊仅支持 /status 和 /help'
+                    : '❌ 无权限：此命令仅限管理员使用';
             }
         }
         // 空闲检查：某些命令需要等待当前会话空闲
-        const requiresIdle = ['/new', '/session', '/clear', '/compact', '/safe', '/repair', '/fork', '/bind', '/project', '/agent'];
+        const requiresIdle = ['/new', '/session', '/clear', '/compact', '/safe', '/repair', '/fork', '/bind', '/project', '/agent', '/rewind'];
         if (requiresIdle.some(cmd => normalizedContent === cmd || normalizedContent.startsWith(cmd + ' '))) {
             if (threadId) {
                 // 话题中：检查话题 session 是否在处理（不创建）
@@ -495,6 +573,7 @@ export class CommandHandler {
                     '',
                     '其他：',
                     '  /status - 显示会话状态',
+                    '  /check - 检查渠道健康',
                     '  /help - 显示此帮助信息',
                 ];
                 return lines.join('\n');
@@ -509,19 +588,21 @@ export class CommandHandler {
                     '  /name <新名称> - 重命名当前会话',
                     '  /del <名称> - 删除指定会话（仅解绑，不删除文件）',
                     '  /status - 显示会话状态',
+                    '  /check - 检查渠道健康',
                     '',
                     '❓ 帮助：',
                     '  /help - 显示此帮助信息',
                 ];
                 return lines.join('\n');
             }
+            // admin+ 基础命令
             const lines = [
                 '可用命令：',
                 '',
                 '📁 项目管理：',
                 '  /pwd - 显示当前项目路径',
                 '  /p [name|path] - 列出或切换项目',
-                '  /bind <path> - 绑定新项目目录',
+                ...(isOwner ? ['  /bind <path> - 绑定新项目目录'] : []),
                 '',
                 '🔄 会话管理：',
                 '  /new [名称] - 创建新会话（清空历史请用此命令，可选命名）',
@@ -529,6 +610,7 @@ export class CommandHandler {
                 '  /name <新名称> - 重命名当前会话',
                 '  /del <名称> - 删除指定会话（仅解绑，不删除文件）',
                 '  /fork [名称] - 分支当前会话（从当前对话点创建分支）',
+                '  /rewind [N] [chat|file|all] - 查看历史/撤销指定轮次（别名: /rw）',
                 '  /compact - 压缩会话上下文（减少 token 用量）',
                 '',
                 '🤖 Agent 与模型：',
@@ -538,14 +620,22 @@ export class CommandHandler {
                 '',
                 '🔐 权限管理：',
                 '  /perm - 查看当前权限模式',
-                '  /perm <auto|bypass|request|edit|plan|noask> - 切换权限模式',
+                ...(isOwner ? ['  /perm <auto|bypass|request|edit|plan|noask> - 切换权限模式'] : []),
                 '  /perm allow|always|deny - 审批权限请求',
                 '',
                 '🛠️ 运维：',
                 '  /status - 显示会话状态',
                 '  /stop - 中断当前任务',
-                '  /restart - 重启服务',
-                '  /send [channel] <path> - 发送项目内文件',
+                '  /check - 检查渠道状态',
+                '  /activity [all|dm|owner|none] - 查看/控制中间输出显示模式',
+                ...(isAdmin ? [
+                    '  /restart <channel> - 重连指定渠道',
+                ] : []),
+                ...(isOwner ? [
+                    '  /restart - 重启服务',
+                    '  /send [channel] <path> - 发送项目内文件',
+                    '  /agentmd [put|set <内容>] - 管理 agent.md',
+                ] : []),
                 '',
                 '❓ 帮助：',
                 '  /help - 显示此帮助信息',
@@ -581,7 +671,7 @@ export class CommandHandler {
                         kind: {
                             kind: 'action',
                             title: '🔐 权限模式',
-                            body: availableModes.map(m => `${m.key === currentMode ? '▶' : '•'} **${m.key}** (${m.nameZh}) - ${m.description}`).join('\n'),
+                            body: availableModes.map(m => `${m.key === currentMode ? '✓' : '•'} **${m.key}** (${m.nameZh}) - ${m.description}`).join('\n'),
                             buttons: availableModes.map(m => ({
                                 key: m.key,
                                 label: m.key === currentMode ? `✓ ${m.key}` : m.key,
@@ -609,7 +699,7 @@ export class CommandHandler {
                 }
                 // 降级：文本
                 const modeList = modes.map(m => {
-                    const prefix = m.key === currentMode ? '▶' : ' ';
+                    const prefix = m.key === currentMode ? '✓' : ' ';
                     const suffix = m.available ? '' : ' ⚠️ 不可用';
                     return `  ${prefix} ${m.key} (${m.nameZh}) - ${m.description}${suffix}`;
                 }).join('\n');
@@ -649,9 +739,9 @@ export class CommandHandler {
                         if (!matched.available) {
                             return `❌ ${matched.key} 模式当前不可用：${matched.unavailableReason}`;
                         }
-                        // guest 用户只能保持 readonly 模式
-                        if (identity.role !== 'owner' && arg !== 'readonly') {
-                            return '❌ 当前身份无法切换权限模式';
+                        // guest 和 admin 用户不能切换权限模式（仅 owner）
+                        if (!isOwner) {
+                            return '❌ 权限模式切换仅限 owner';
                         }
                         const metadata = permSession.metadata || {};
                         metadata.permissionMode = arg;
@@ -668,8 +758,9 @@ export class CommandHandler {
             return `❌ 未知参数: ${args}\n用法: /perm <${allModeKeys}> 或 /perm allow|always|deny`;
         }
         // /agent 命令：查看或切换 Agent 后端
-        if (normalizedContent.startsWith('/agent')) {
-            if (!isAdmin)
+        if (normalizedContent === '/agent' || normalizedContent.startsWith('/agent ')) {
+            // 群聊中 owner only，私聊中 admin+
+            if (activeChatType === 'group' ? !isOwner : !isAdmin)
                 return '❌ 无权限：此命令仅限管理员使用';
             const args = normalizedContent.slice(6).trim();
             const available = [...this.agentMap.keys()];
@@ -787,7 +878,7 @@ export class CommandHandler {
                         return null;
                 }
                 // 降级：文本
-                const modelList = models.map((m) => `- ${m}`).join('\n');
+                const modelList = models.map((m) => `  ${m === currentModel ? '✓' : ' '} ${m}`).join('\n');
                 const effortHint = efforts.length > 0
                     ? `\n推理强度: ${currentEffort === 'auto' ? 'auto (SDK默认)' : currentEffort}  (使用 /effort 调整)`
                     : '';
@@ -811,7 +902,7 @@ export class CommandHandler {
                     newModel = arg;
                 }
                 else {
-                    const modelList = models.map((m) => `- ${m}`).join('\n');
+                    const modelList = models.map((m) => `  ${m === currentModel ? '✓' : ' '} ${m}`).join('\n');
                     const effortHint = efforts.length > 0 ? `\n\n推理强度请使用 /effort 命令` : '';
                     return `❌ 无效参数: ${arg}\n\n可用模型：\n${modelList}${effortHint}`;
                 }
@@ -977,8 +1068,9 @@ export class CommandHandler {
                 }
                 // 降级：文本
                 const effortDisplay = currentEffort === 'auto' ? 'auto (SDK默认)' : currentEffort;
-                const effortList = efforts.map(e => `${e === currentEffort ? '  ✓' : '   '} ${e}`).join('\n');
-                return `⚡ 推理强度: ${effortDisplay}\n\n可选:\n${effortList}\n   ${currentEffort === 'auto' ? '  ✓' : '   '} auto\n\n用法: /effort <level>`;
+                const allItems = [...efforts, 'auto'];
+                const effortList = allItems.map(e => `  ${e === currentEffort ? '✓' : ' '} ${e}${e === 'auto' ? ' (SDK默认)' : ''}`).join('\n');
+                return `⚡ 推理强度: ${effortDisplay}\n\n可选:\n${effortList}\n\n用法: /effort <level>`;
             }
             // /effort auto：恢复 SDK 默认
             if (args === 'auto') {
@@ -1047,6 +1139,151 @@ export class CommandHandler {
             }
             return `✓ 推理强度: ${newEffort}`;
         }
+        // /activity 命令：控制中间输出显示模式
+        if (normalizedContent === '/agentmd' || normalizedContent.startsWith('/agentmd ')) {
+            if (!isOwner)
+                return '❌ 无权限：此命令仅限 owner 使用';
+            const adapter = this.adapters.get(channel);
+            if (!adapter?.uploadAgentMd)
+                return '❌ 当前通道不支持 agent.md 操作';
+            const selfAid = typeof adapter._selfAid === 'function' ? adapter._selfAid() : '';
+            const arg = normalizedContent.slice(9).trim();
+            // put — read local ~/.aun/AIDs/{aid}/agent.md and upload
+            if (arg === 'put') {
+                if (!selfAid)
+                    return '❌ 未连接，无法确定本地 AID';
+                try {
+                    const { readFileSync } = await import('node:fs');
+                    const { join } = await import('node:path');
+                    const { homedir } = await import('node:os');
+                    const localPath = join(homedir(), '.aun', 'AIDs', selfAid, 'agent.md');
+                    const content = readFileSync(localPath, 'utf-8');
+                    await adapter.uploadAgentMd(content);
+                    return '✅ agent.md 已发布';
+                }
+                catch (e) {
+                    return `❌ 发布失败: ${String(e.message || e).slice(0, 100)}`;
+                }
+            }
+            // set <content> — upload inline content and sync to local
+            if (arg.startsWith('set ')) {
+                const content = arg.slice(4).trim();
+                if (!content)
+                    return '用法：/agentmd set <内容>';
+                if (!selfAid)
+                    return '❌ 未连接，无法确定本地 AID';
+                try {
+                    await adapter.uploadAgentMd(content);
+                    const { writeFileSync, mkdirSync } = await import('node:fs');
+                    const { join } = await import('node:path');
+                    const { homedir } = await import('node:os');
+                    const localDir = join(homedir(), '.aun', 'AIDs', selfAid);
+                    mkdirSync(localDir, { recursive: true });
+                    writeFileSync(join(localDir, 'agent.md'), content, 'utf-8');
+                    return '✅ agent.md 已更新并发布到AUN网络';
+                }
+                catch (e) {
+                    return `❌ 发布失败: ${String(e.message || e).slice(0, 100)}`;
+                }
+            }
+            // view — /agentmd or /agentmd <aid>
+            const aidToView = arg || selfAid;
+            if (!aidToView)
+                return '用法：/agentmd [<aid>] | put | set <内容>';
+            try {
+                const md = await adapter.downloadAgentMd(aidToView);
+                if (!md || !md.trim())
+                    return `ℹ️ ${aidToView} 尚未设置 agent.md`;
+                return `\`\`\`\n${md.slice(0, 1500)}\n\`\`\``;
+            }
+            catch (e) {
+                const msg = String(e.message || e);
+                if (msg.includes('not found') || msg.includes('404')) {
+                    return `ℹ️ ${aidToView} 尚未设置 agent.md`;
+                }
+                return `❌ 获取失败: ${msg.slice(0, 100)}`;
+            }
+        }
+        if (normalizedContent === '/activity' || normalizedContent.startsWith('/activity ')) {
+            if (!isAdmin)
+                return '❌ 无权限：此命令仅限管理员使用';
+            const activityArg = normalizedContent.slice(9).trim();
+            const modeMap = {
+                all: 'all',
+                dm: 'dm-only',
+                owner: 'owner-dm-only',
+                none: 'none',
+            };
+            const currentMode = getChannelShowActivities(this.config, channel);
+            // 模式描述列表（用于 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) {
+                // 无参数：显示当前模式 + Action 卡片
+                if (this.interactionRouter) {
+                    const requestId = `activity-${Date.now()}-${crypto.randomBytes(4).toString('hex')}`;
+                    const body = modeDescriptions.map(m => `${m.configVal === currentMode ? '✓' : '•'} **${m.key}** (${m.label})`).join('\n');
+                    const buttons = modeDescriptions.map(m => ({
+                        key: m.key,
+                        label: m.configVal === currentMode ? `✓ ${m.key}` : m.key,
+                        style: m.configVal === currentMode ? 'primary' : 'default',
+                    }));
+                    const interaction = {
+                        type: 'interaction',
+                        id: requestId,
+                        channelId,
+                        sessionId: activeSession?.id || requestId,
+                        kind: {
+                            kind: 'action',
+                            title: '📋 中间输出模式',
+                            body,
+                            buttons,
+                        },
+                    };
+                    const replyCtx = activeSession ? this.getReplyContext(activeSession) : undefined;
+                    const cardSent = await this.sendInteractionCard({
+                        channel, channelId, sessionId: activeSession?.id || requestId, requestId, interaction, replyCtx,
+                        callback: async (action, _values, operatorId) => {
+                            const newMode = modeMap[action];
+                            if (newMode && newMode !== currentMode) {
+                                if (userId && operatorId && operatorId !== userId)
+                                    return;
+                                const result = await this.handle(`/activity ${action}`, channel, channelId, undefined, userId, threadId);
+                                if (result) {
+                                    const adapter = this.adapters.get(channel);
+                                    adapter?.sendText(channelId, result, replyCtx);
+                                }
+                            }
+                        },
+                    });
+                    if (cardSent)
+                        return null;
+                }
+                // 降级：文本
+                const modeList = modeDescriptions.map(m => {
+                    const prefix = m.configVal === currentMode ? '✓' : ' ';
+                    return `  ${prefix} ${m.key} (${m.label})`;
+                }).join('\n');
+                return `📋 中间输出模式: ${currentMode}\n\n${modeList}\n\n用法:\n  /activity <模式>    切换中间输出显示模式`;
+            }
+            const newMode = modeMap[activityArg];
+            if (!newMode) {
+                return `❌ 无效参数: ${activityArg}\n可选: all / dm / owner / none`;
+            }
+            const label = modeDescriptions.find(m => m.configVal === newMode)?.label || newMode;
+            if (newMode === currentMode) {
+                return `📋 中间输出模式已是 ${activityArg}（${label}）`;
+            }
+            // 切换操作仅 owner
+            if (!isOwner)
+                return '❌ 中间输出模式切换仅限 owner';
+            setChannelShowActivities(this.config, channel, newMode);
+            return `✅ 中间输出模式: ${activityArg}（${label}）`;
+        }
         // /stop 命令：中断当前任务
         if (normalizedContent === '/stop') {
             const stopResult = await this.ensureSession(channel, channelId, threadId);
@@ -1193,22 +1430,11 @@ export class CommandHandler {
                 if (health.consecutiveErrors > 0) {
                     lines.push(`异常计数: ${health.consecutiveErrors}`);
                 }
-                if (health.safeMode) {
-                    lines.push(`安全模式: 是 ⚠️`);
-                }
                 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 ? '话题' : '会话'}状态：`, `渠道: ${channel} / 项目: ${projectName} / ${session.agentId}会话`, `状态: ${sessionStatus}`, `会话轮数: ${sessionTurns}`, `最后活跃: ${timeStr}`);
             }
-            if (health.safeMode) {
-                lines.push('');
-                lines.push('⚠️ 当前处于安全模式（历史上下文已禁用）');
-                lines.push('');
-                lines.push('退出方式：');
-                lines.push('1. /new [名称] - 创建新会话（清空历史）');
-                lines.push('2. 联系管理员使用 /repair 检查并修复会话');
-            }
             if (health.lastError) {
                 lines.push('');
                 lines.push(`最后错误: ${health.lastErrorType || 'unknown'}`);
@@ -1244,29 +1470,10 @@ export class CommandHandler {
             }
             return `✓ 已创建新会话${sessionName ? `: ${sessionName}` : ''}\n  之前的对话历史已保留，可通过 /s 查看`;
         }
-        // /check 命令：检查渠道状态 / 手动重连指定渠道
+        // /check 命令：检查渠道状态（guest 可用，详情仅 admin）/ 重连指定渠道（admin only）
         if (normalizedContent === '/check' || normalizedContent.startsWith('/check ')) {
-            if (!isAdmin)
-                return '❌ 无权限：此命令仅限管理员使用';
             const subCmd = normalizedContent.slice('/check'.length).trim();
-            // /check rty <channel> — 重连指定渠道
-            if (subCmd.startsWith('rty')) {
-                const target = subCmd.slice('rty'.length).trim();
-                if (!target) {
-                    return '❌ 请指定渠道名称，例如：/check rty feishu';
-                }
-                const ch = this.channelObjects.get(target);
-                if (!ch) {
-                    const available = [...this.channelObjects.keys()].join(', ') || '无';
-                    return `❌ 未找到渠道 "${target}"，可用渠道：${available}`;
-                }
-                if (!ch.reconnect) {
-                    return `❌ 渠道 "${target}" 不支持重连`;
-                }
-                const result = await ch.reconnect();
-                return `🔄 ${target} 重连: ${result}`;
-            }
-            // Default: show full system health check
+            // Default: show system health check (non-admin 仅看摘要)
             const lines = ['📡 渠道状态：'];
             // Group by channelType
             const groups = new Map();
@@ -1285,6 +1492,13 @@ export class CommandHandler {
                     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 lines.join('\n');
+            }
             for (const [type, instances] of groups) {
                 if (instances.length === 1) {
                     lines.push(`  ${instances[0].name}: ${instances[0].status}`);
@@ -1327,11 +1541,30 @@ export class CommandHandler {
                     lines.push(`  平均响应耗时: ${(h.avgResponseMs / 1000).toFixed(1)}s`);
                 }
             }
-            lines.push('', '💡 /check rty <channel> — 重连指定渠道');
             return lines.join('\n');
         }
-        // /restart 命令：重启服务
-        if (normalizedContent === '/restart') {
+        // /restart 命令：重启服务（owner only） / 重连指定渠道（admin+）
+        if (normalizedContent === '/restart' || normalizedContent.startsWith('/restart ')) {
+            const restartArg = normalizedContent.slice('/restart'.length).trim();
+            // /restart <channel> — 重连指定渠道（admin only）
+            if (restartArg) {
+                if (!isAdmin)
+                    return '❌ 无权限：渠道重连仅限管理员使用';
+                const target = restartArg;
+                const ch = this.channelObjects.get(target);
+                if (!ch) {
+                    const available = [...this.channelObjects.keys()].join(', ') || '无';
+                    return `❌ 未找到渠道 "${target}"，可用渠道：${available}`;
+                }
+                if (!ch.reconnect) {
+                    return `❌ 渠道 "${target}" 不支持重连`;
+                }
+                const result = await ch.reconnect();
+                return `🔄 ${target} 重连: ${result}`;
+            }
+            // /restart（无参数）— 重启整个服务（owner only）
+            if (!isOwner)
+                return '❌ 无权限：服务重启仅限 owner 使用';
             const allSessions = await this.sessionManager.listSessions(channel, channelId);
             const sessionsWithMessages = allSessions
                 .filter(s => this.messageCache.hasMessages(s.id))
@@ -1400,8 +1633,10 @@ export class CommandHandler {
             }
             return `当前项目: ${session.projectPath}`;
         }
-        // /send 命令：发送项目内文件，支持 /send path 和 /send channel path
+        // /send 命令：发送项目内文件，支持 /send path 和 /send channel path（owner only）
         if (normalizedContent.startsWith('/send')) {
+            if (!isOwner)
+                return '❌ 无权限：此命令仅限 owner 使用';
             // 飞书会将 .md 等后缀自动转为 Markdown 链接: foo.md → [foo.md](http://foo.md/)
             // 还原: 将 [text](url) 替换为 text
             const rawArg = normalizedContent.slice(5).trim().replace(/\[([^\]]+)\]\([^)]+\)/g, '$1');
@@ -1573,7 +1808,7 @@ export class CommandHandler {
                 }));
                 const bodyLines = entries.map(e => {
                     const status = buildStatusText(e);
-                    const prefix = e.isCurrent ? '▶' : '•';
+                    const prefix = e.isCurrent ? '✓' : '•';
                     return `${prefix} **${e.name}** (${e.projectPath})  ${status}`;
                 });
                 const interaction = {
@@ -1613,6 +1848,7 @@ export class CommandHandler {
                 const prefix = entry.isCurrent ? '  ✓' : '   ';
                 lines.push(`${prefix} ${entry.name} (${entry.projectPath}) - ${buildStatusText(entry)}`);
             }
+            lines.push('', '提示: 使用 /p <名称> 切换项目');
             return lines.join('\n');
         }
         // /project（无参数）：直接复用 /plist 逻辑（含卡片交互）
@@ -1711,8 +1947,12 @@ export class CommandHandler {
             }
             return response;
         }
-        // /bind 命令：持久化项目到配置（不切换）
+        // /bind 命令：持久化项目到配置（不切换）（owner only）
+        if (normalizedContent === '/bind')
+            return '用法: /bind <路径>';
         if (normalizedContent.startsWith('/bind ')) {
+            if (!isOwner)
+                return '❌ 无权限：此命令仅限 owner 使用';
             const projectPath = normalizedContent.slice(6).trim();
             if (!projectPath)
                 return '用法: /bind <路径>';
@@ -1887,7 +2127,7 @@ export class CommandHandler {
                     };
                 });
                 const bodyLines = displaySessions.map(ds => {
-                    const prefix = ds.isActive ? '▶' : '•';
+                    const prefix = ds.isActive ? '✓' : '•';
                     const threadTag = ds.session.threadId ? '[话题] ' : '';
                     const uuid = ds.session.agentSessionId ? `(${ds.session.agentSessionId.substring(0, 8)})` : '';
                     const fileMark = ds.fileMissing ? '❌ ' : '';
@@ -2036,6 +2276,9 @@ export class CommandHandler {
             return `✓ 已切换到会话: ${targetSession.name || sessionName}${continueHint}${lastInputLine}`;
         }
         // /rename 或 /name 命令：重命名当前会话
+        if (normalizedContent === '/rename' || normalizedContent === '/name') {
+            return '用法: /name <新名称> 或 /rename <新名称>';
+        }
         if (normalizedContent.startsWith('/rename ')) {
             const newName = normalizedContent.slice(8).trim();
             if (!newName)
@@ -2131,31 +2374,59 @@ export class CommandHandler {
                 return `❌ 会话分支失败: ${error instanceof Error ? error.message : '未知错误'}`;
             }
         }
-        // /repair 命令：检查并修复会话
+        // /rewind 命令：查看历史 / 回退会话
+        if (normalizedContent === '/rewind' || normalizedContent.startsWith('/rewind ')) {
+            const result = await this.ensureSession(channel, channelId, threadId);
+            if ('error' in result)
+                return result.error;
+            const { session } = result;
+            const rewindAgent = this.getAgent(session.agentId);
+            if (rewindAgent.name !== 'claude') {
+                return '❌ /rewind 仅支持 Claude 后端';
+            }
+            if (!session.agentSessionId) {
+                return '❌ 当前会话无历史记录\n\n请先发送一条消息，然后再使用 /rewind';
+            }
+            if (!rewindAgent.getSessionMessages) {
+                return '❌ 当前 Agent 不支持 /rewind';
+            }
+            const args = normalizedContent.slice('/rewind'.length).trim();
+            if (!args) {
+                return await this.handleRewindList(session, rewindAgent);
+            }
+            const parts = args.split(/\s+/);
+            const turnNum = parseInt(parts[0], 10);
+            if (isNaN(turnNum) || turnNum < 1) {
+                return '❌ 无效轮次，用法：/rewind <N> chat|file|all（撤销第N轮）';
+            }
+            const mode = parts[1]?.toLowerCase();
+            if (!mode) {
+                return `❌ 请指定回退模式：/rewind ${turnNum} chat | file | all（撤销第${turnNum}轮）`;
+            }
+            if (!['chat', 'file', 'all'].includes(mode)) {
+                return `❌ 无效模式 "${mode}"，可选：chat | file | all`;
+            }
+            return await this.handleRewind(session, rewindAgent, turnNum, mode);
+        }
+        // /repair 命令：检查并修复会话文件
         if (normalizedContent === '/repair') {
             const repairResult = await this.ensureSession(channel, channelId, threadId);
             if ('error' in repairResult)
                 return repairResult.error;
             const { session: repairSession } = repairResult;
-            const health = await this.sessionManager.getHealthStatus(repairSession.id);
-            if (!health.safeMode) {
-                return `当前不在安全模式，无需修复\n\n如需进入安全模式，请使用 /safe`;
-            }
             const repairAgent = this.getAgent(repairSession.agentId);
             const { checkSessionFile, backupSessionFile } = await import('./session/session-file-health.js');
             try {
                 if (!repairSession.agentSessionId) {
                     await this.sessionManager.resetHealthStatus(repairSession.id);
-                    this.eventBus.publish({ type: 'session:safe-mode-exited', sessionId: repairSession.id, method: 'repair' });
-                    return `✓ 修复完成，已退出安全模式\n\n修复内容：\n- 未发现问题（新会话）\n- 已重置异常计数器\n- 已恢复正常会话模式`;
+                    return `✓ 修复完成\n\n修复内容：\n- 未发现问题（新会话）\n- 已重置异常计数器`;
                 }
                 // 通过 agent 定位 session 文件
                 const sessionFile = repairAgent.resolveSessionFile?.(repairSession.agentSessionId, repairSession.projectPath) ?? null;
                 if (!sessionFile) {
                     // 文件不存在（已被删除或从未创建），直接重置
                     await this.sessionManager.resetHealthStatus(repairSession.id);
-                    this.eventBus.publish({ type: 'session:safe-mode-exited', sessionId: repairSession.id, method: 'repair' });
-                    return `✓ 修复完成，已退出安全模式\n\n修复内容：\n- 会话文件不存在（可能已被清理）\n- 已重置异常计数器\n- 已恢复正常会话模式`;
+                    return `✓ 修复完成\n\n修复内容：\n- 会话文件不存在（可能已被清理）\n- 已重置异常计数器`;
                 }
                 const healthCheck = await checkSessionFile(sessionFile);
                 if (healthCheck.corrupt) {
@@ -2165,42 +2436,195 @@ export class CommandHandler {
                     await this.sessionManager.updateAgentSessionIdBySessionId(repairSession.id, '');
                     repairAgent.updateSessionId(repairSession.id, '');
                     await this.sessionManager.resetHealthStatus(repairSession.id);
-                    this.eventBus.publish({ type: 'session:safe-mode-exited', sessionId: repairSession.id, method: 'repair' });
-                    return `✓ 修复完成，已退出安全模式\n\n检测到问题：\n${healthCheck.issues.map((i) => `- ${i}`).join('\n')}\n\n修复操作：\n- 已备份损坏文件\n- 已删除损坏文件\n- 已重置异常计数器\n\n备份位置：${backupPath}`;
+                    return `✓ 修复完成\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);
-                    this.eventBus.publish({ type: 'session:safe-mode-exited', sessionId: repairSession.id, method: 'repair' });
                     return `⚠️ 检测到问题：\n${healthCheck.issues.map((i) => `- ${i}`).join('\n')}\n\n建议使用 /new 创建新会话\n\n已重置异常计数器，可继续使用当前会话。`;
                 }
                 await this.sessionManager.resetHealthStatus(repairSession.id);
-                this.eventBus.publish({ type: 'session:safe-mode-exited', sessionId: repairSession.id, method: 'repair' });
-                return `✓ 修复完成，已退出安全模式\n\n修复内容：\n- 未发现问题\n- 已重置异常计数器\n- 已恢复正常会话模式`;
+                return `✓ 修复完成\n\n修复内容：\n- 未发现问题\n- 已重置异常计数器`;
             }
             catch (error) {
                 logger.error('[Repair] Failed:', error);
                 return `❌ 修复失败: ${error.message}`;
             }
         }
-        // /safe 命令：手动进入安全模式
+        // /safe 命令：安全模式已禁用
         if (normalizedContent === '/safe') {
-            const safeResult = await this.ensureSession(channel, channelId, threadId);
-            if ('error' in safeResult)
-                return safeResult.error;
-            const { session: safeSession } = safeResult;
-            await this.sessionManager.setSafeMode(safeSession.id, true);
-            this.eventBus.publish({ type: 'session:safe-mode-entered', sessionId: safeSession.id, reason: 'manual' });
-            return `✓ 已进入安全模式
-
-当前行为：
-- 暂时不加载会话历史（每次对话独立）
-- 所有功能正常可用（读写文件、执行命令等）
-- 不会丢失历史数据（仍保存在 .claude/ 目录）
-
-退出安全模式：
-- 使用 /repair 检查并修复会话
-- 使用 /new 创建全新会话`;
+            return `ℹ️ 安全模式已禁用\n\n如需重置会话，请使用 /new 创建新会话。`;
         }
         return null;
     }
+    // ── /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} 个文件）`
+                        : '';
+                    results.push(`✅ 已恢复文件到第 ${turnNum} 轮之前的状态${detail}`);
+                }
+            }
+            // 对话回退（延迟执行 — 下次发消息时生效）
+            if (mode === 'chat' || mode === 'all') {
+                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,
+                    });
+                }
+                const discarded = turns.length - turnNum + 1;
+                const keepDesc = keepTarget
+                    ? `回退到第 ${turnNum - 1} 轮："${keepTarget.userContent}"`
+                    : '已清空全部对话历史';
+                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',
+        '/model', '/effort', '/perm',
+        '/compact', '/activity', '/send', '/restart', '/agentmd',
+    ];
+    /**
+     * Agent ctl 入口：通过 IPC 接收 Agent 自主管理指令
+     * 复用现有 slash cmd 逻辑，权限继承 session 用户角色
+     */
+    async handleCtl(cmd, sessionId) {
+        // 1. 白名单检查
+        const inputCmd = cmd.split(' ')[0];
+        if (!CommandHandler.CTL_COMMANDS.includes(inputCmd)) {
+            return { ok: false, error: `不允许的指令: ${inputCmd}` };
+        }
+        // 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;
+        // 4. send 路径限制：只允许 projectPath 下的文件
+        if (cmd.startsWith('/send')) {
+            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);
+                if (!resolved.startsWith(session.projectPath)) {
+                    return { ok: false, error: '路径越界：只能发送项目目录下的文件' };
+                }
+            }
+        }
+        // 5. 调用现有 handle()，不传 sendMessage 回调（结果直接返回）
+        try {
+            const result = await this.handle(cmd, session.channel, session.channelId, undefined, // 不发送消息
+            userId);
+            return { ok: true, result: result ?? '(无输出)' };
+        }
+        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().replace(/\s+/g, ' ');
+        if (!text)
+            return '';
+        return text.length > 50 ? text.substring(0, 50) + '…' : text;
+    }
 }