evolclaw 2.3.0 → 2.5.0

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,33 +316,44 @@ export class CommandHandler {
     }
     /**
      * 返回结构化命令菜单（供 menu.query 使用）
-     * admin 看到全部命令分组，guest 仅看到用户级命令
+     * owner 看到全部命令，admin 看到管理级命令（不含 owner-only），guest 仅看到用户级命令
      */
-    getMenuItems(isAdmin) {
+    getMenuItems(role, chatType = 'private') {
+        const isOwner = role === 'owner';
+        const isAdmin = role === 'owner' || role === 'admin';
         const items = [];
+        if (!isAdmin && chatType === 'group') {
+            return [
+                {
+                    group: '其他',
+                    commands: [
+                        { cmd: '/status', label: '显示会话状态' },
+                        { cmd: '/check', label: '检查渠道健康' },
+                        { cmd: '/help', label: '显示帮助信息' },
+                    ]
+                }
+            ];
+        }
         if (isAdmin) {
             items.push({
                 group: '项目管理',
                 commands: [
                     { cmd: '/pwd', label: '显示当前项目路径' },
-                    { cmd: '/plist', label: '列出所有配置的项目' },
-                    { cmd: '/p', args: '<name|path>', label: '切换项目' },
-                    { cmd: '/bind', args: '<path>', label: '绑定新项目目录' },
+                    { cmd: '/p', args: '[name|path]', label: '列出或切换项目' },
+                    ...(isOwner ? [{ cmd: '/bind', args: '<path>', label: '绑定新项目目录' }] : []),
                 ]
             });
         }
         items.push({
             group: '会话管理',
             commands: [
-                { cmd: '/new', args: '[name]', label: '创建新会话' },
-                { cmd: '/slist', label: '列出当前项目的所有会话' },
-                { cmd: '/slist', args: 'cli', label: '列出 CLI 会话（未导入的）' },
-                { cmd: '/s', args: '<name|index|uuid>', label: '切换到指定会话' },
+                { 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: '删除指定会话' },
                 ...(isAdmin ? [
                     { cmd: '/fork', args: '[name]', label: '分支当前会话' },
-                    { cmd: '/clear', label: '清空会话对话历史' },
+                    { cmd: '/rewind', args: '[N] [chat|file|all]', label: '查看历史/撤销指定轮次 (别名: /rw)' },
                     { cmd: '/compact', label: '压缩会话上下文' },
                 ] : []),
             ]
@@ -365,7 +370,7 @@ export class CommandHandler {
             items.push({
                 group: '权限管理',
                 commands: [
-                    { cmd: '/perm', args: '[mode|allow|always|deny]', label: '权限模式管理' },
+                    { cmd: '/perm', args: isOwner ? '[mode|allow|always|deny]' : '[allow|always|deny]', label: '权限模式管理' },
                 ]
             });
             items.push({
@@ -373,11 +378,16 @@ export class CommandHandler {
                 commands: [
                     { cmd: '/status', label: '显示会话状态' },
                     { cmd: '/stop', label: '中断当前任务' },
-                    { cmd: '/restart', label: '重启服务' },
-                    { cmd: '/repair', label: '检查并修复会话' },
-                    { cmd: '/safe', label: '进入安全模式' },
-                    { cmd: '/send', args: '[渠道] <path>', label: '发送项目内文件' },
-                    { cmd: '/check', args: '[rty <channel>]', label: '检查渠道状态或重连指定渠道' },
+                    { cmd: '/check', label: '检查渠道状态' },
+                    { cmd: '/activity', args: '[all|dm|owner|none]', label: '查看/控制中间输出显示模式' },
+                    ...(isAdmin ? [
+                        { cmd: '/restart', args: '<channel>', label: '重连指定渠道' },
+                    ] : []),
+                    ...(isOwner ? [
+                        { cmd: '/restart', label: '重启服务' },
+                        { cmd: '/send', args: '[channel] <path>', label: '发送项目内文件' },
+                        { cmd: '/agentmd', args: '[put|set <内容>]', label: '管理 agent.md' },
+                    ] : []),
                 ]
             });
         }
@@ -386,6 +396,7 @@ export class CommandHandler {
                 group: '其他',
                 commands: [
                     { cmd: '/status', label: '显示会话状态' },
+                    { cmd: '/check', label: '检查渠道健康' },
                 ]
             });
         }
@@ -433,16 +444,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 userCommands = ['/slist', '/new', '/session', '/rename', '/name', '/status', '/help', '/del', '/s '];
+            const guestGroupCommands = ['/status', '/help', '/check'];
+            const userCommands = activeChatType === 'group' && !isAdmin
+                ? guestGroupCommands
+                : ['/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 '❌ 无权限：此命令仅限管理员使用';
+                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 是否在处理（不创建）
@@ -480,41 +498,50 @@ export class CommandHandler {
             return undefined;
         // /help 命令不需要会话
         if (normalizedContent === '/help') {
+            if (!isAdmin && activeChatType === 'group') {
+                const lines = [
+                    '可用命令：',
+                    '',
+                    '其他：',
+                    '  /status - 显示会话状态',
+                    '  /check - 检查渠道健康',
+                    '  /help - 显示此帮助信息',
+                ];
+                return lines.join('\n');
+            }
             if (!isAdmin) {
                 const lines = [
                     '可用命令：',
                     '',
                     '🔄 会话管理：',
-                    '  /new [名称] - 创建新会话（可选命名）',
-                    '  /slist - 列出当前项目的所有会话',
-                    '  /slist cli - 列出 CLI 会话（未导入的）',
-                    '  /s, /session <名称|序号|uuid> - 切换到指定会话',
-                    '  /name, /rename <新名称> - 重命名当前会话',
+                    '  /new [名称] - 创建新会话（清空历史请用此命令，可选命名）',
+                    '  /s [cli|名称|序号|uuid] - 列出或切换会话（cli 查看未导入的 CLI 会话）',
+                    '  /name <新名称> - 重命名当前会话',
                     '  /del <名称> - 删除指定会话（仅解绑，不删除文件）',
                     '  /status - 显示会话状态',
+                    '  /check - 检查渠道健康',
                     '',
                     '❓ 帮助：',
                     '  /help - 显示此帮助信息',
                 ];
                 return lines.join('\n');
             }
+            // admin+ 基础命令
             const lines = [
                 '可用命令：',
                 '',
                 '📁 项目管理：',
                 '  /pwd - 显示当前项目路径',
-                '  /plist - 列出所有配置的项目',
-                '  /p, /project <name|path> - 切换项目',
-                '  /bind <path> - 绑定新项目目录',
+                '  /p [name|path] - 列出或切换项目',
+                ...(isOwner ? ['  /bind <path> - 绑定新项目目录'] : []),
                 '',
                 '🔄 会话管理：',
-                '  /new [名称] - 创建新会话（可选命名）',
-                '  /slist - 列出当前项目的所有会话',
-                '  /s, /session <名称> - 切换到指定会话',
-                '  /name, /rename <新名称> - 重命名当前会话',
+                '  /new [名称] - 创建新会话（清空历史请用此命令，可选命名）',
+                '  /s [cli|名称|序号|uuid] - 列出或切换会话（cli 查看未导入的 CLI 会话）',
+                '  /name <新名称> - 重命名当前会话',
                 '  /del <名称> - 删除指定会话（仅解绑，不删除文件）',
                 '  /fork [名称] - 分支当前会话（从当前对话点创建分支）',
-                '  /clear - 清空当前会话的对话历史',
+                '  /rewind [N] [chat|file|all] - 查看历史/撤销指定轮次（别名: /rw）',
                 '  /compact - 压缩会话上下文（减少 token 用量）',
                 '',
                 '🤖 Agent 与模型：',
@@ -524,16 +551,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 - 重启服务',
-                '  /repair - 检查并修复会话',
-                '  /safe - 进入安全模式',
-                '  /send [渠道] <路径> - 发送项目内文件',
+                '  /check - 检查渠道状态',
+                '  /activity [all|dm|owner|none] - 查看/控制中间输出显示模式',
+                ...(isAdmin ? [
+                    '  /restart <channel> - 重连指定渠道',
+                ] : []),
+                ...(isOwner ? [
+                    '  /restart - 重启服务',
+                    '  /send [channel] <path> - 发送项目内文件',
+                    '  /agentmd [put|set <内容>] - 管理 agent.md',
+                ] : []),
                 '',
                 '❓ 帮助：',
                 '  /help - 显示此帮助信息',
@@ -554,7 +587,8 @@ export class CommandHandler {
                 if (!hasPermissionController(permAgent)) {
                     return '❌ 权限控制不可用';
                 }
-                const currentMode = permSession.metadata?.permissionMode ?? 'bypass';
+                const defaultPermMode = identity.role === 'owner' ? 'bypass' : 'readonly';
+                const currentMode = permSession.metadata?.permissionMode ?? defaultPermMode;
                 const modes = permAgent.listModes();
                 // 尝试发送交互卡片
                 if (this.interactionRouter) {
@@ -568,7 +602,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,
@@ -596,7 +630,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');
@@ -636,9 +670,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;
@@ -655,8 +689,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()];
@@ -774,7 +809,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 调整)`
                     : '';
@@ -798,7 +833,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}`;
                 }
@@ -964,8 +999,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') {
@@ -1034,6 +1070,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);
@@ -1180,22 +1361,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. /repair - 检查并修复会话（推荐，保留历史）');
-                lines.push('2. /new [名称] - 创建新会话（清空历史）');
-            }
             if (health.lastError) {
                 lines.push('');
                 lines.push(`最后错误: ${health.lastErrorType || 'unknown'}`);
@@ -1229,31 +1399,12 @@ export class CommandHandler {
                 await agent.clearSession(session.id, session.agentSessionId || '', session.projectPath);
                 await agent.closeSession(session.id);
             }
-            return `✓ 已创建新会话${sessionName ? `: ${sessionName}` : ''}\n  之前的对话历史已保留，可通过 /slist 查看`;
+            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();
@@ -1272,6 +1423,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}`);
@@ -1291,7 +1449,6 @@ export class CommandHandler {
                 ? this.statsCollector.getSnapshot().uptimeMs
                 : process.uptime() * 1000;
             lines.push(`  运行时间: ${this.formatUptime(uptimeMs)}`);
-            lines.push(`  当前安全模式会话: ${this.sessionManager.getSafeModeSessionCount()}`);
             // 近 1 小时统计
             if (this.statsCollector) {
                 const snap = this.statsCollector.getSnapshot();
@@ -1311,16 +1468,34 @@ export class CommandHandler {
                     lines.push(`  工具失败: ${h.toolErrors} (${toolBreakdown})`);
                 }
                 lines.push(`  被中断: ${h.interrupts}`);
-                lines.push(`  进入安全模式: ${h.safeModeEntries}`);
                 if (h.completed > 0) {
                     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))
@@ -1389,8 +1564,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');
@@ -1562,7 +1739,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 = {
@@ -1602,6 +1779,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 逻辑（含卡片交互）
@@ -1641,7 +1819,7 @@ export class CommandHandler {
             else {
                 projectPath = this.projects[arg];
                 if (!projectPath) {
-                    return `❌ 项目 "${arg}" 不存在\n提示: 使用 /plist 查看可用项目`;
+                    return `❌ 项目 "${arg}" 不存在\n提示: 使用 /p 查看可用项目`;
                 }
                 projectName = arg;
             }
@@ -1700,8 +1878,10 @@ export class CommandHandler {
             }
             return response;
         }
-        // /bind 命令：持久化项目到配置（不切换）
+        // /bind 命令：持久化项目到配置（不切换）（owner only）
         if (normalizedContent.startsWith('/bind ')) {
+            if (!isOwner)
+                return '❌ 无权限：此命令仅限 owner 使用';
             const projectPath = normalizedContent.slice(6).trim();
             if (!projectPath)
                 return '用法: /bind <路径>';
@@ -1746,7 +1926,7 @@ export class CommandHandler {
 请先执行以下操作之一：
 1. 发送任意消息 - 自动创建新会话
 2. /new [名称] - 创建命名会话
-3. /project <项目> - 切换到指定项目`;
+3. /p <项目> - 切换到指定项目`;
             }
             const showCliOnly = normalizedContent === '/slist cli';
             // /slist cli — 仅显示 CLI 会话
@@ -1876,7 +2056,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 ? '❌ ' : '';
@@ -1940,13 +2120,17 @@ export class CommandHandler {
                 lines.push('');
             }
             lines.push('使用 /s <序号、name或8位uuid> 切换会话');
-            lines.push('使用 /slist cli 查看 CLI 会话');
+            lines.push('使用 /s cli 查看 CLI 会话');
             return lines.join('\n');
         }
         // /session（无参数）：直接复用 /slist 逻辑（含卡片交互）
         if (normalizedContent === '/session') {
             return this.handle('/slist', channel, channelId, undefined, userId, threadId);
         }
+        // /session cli（= /s cli）：列出未导入的 CLI 会话
+        if (normalizedContent === '/session cli') {
+            return this.handle('/slist cli', channel, channelId, undefined, userId, threadId);
+        }
         // /session 或 /s 命令：切换会话
         if (normalizedContent.startsWith('/session ')) {
             const sessionName = normalizedContent.slice(9).trim();
@@ -1967,7 +2151,7 @@ export class CommandHandler {
                     targetSession = visibleSessions[idx - 1];
                 }
                 else {
-                    return `❌ 序号超出范围 (1-${visibleSessions.length})\n使用 /slist 查看可用会话`;
+                    return `❌ 序号超出范围 (1-${visibleSessions.length})\n使用 /s 查看可用会话`;
                 }
             }
             if (!targetSession && sessionName.length === 8) {
@@ -1992,7 +2176,7 @@ export class CommandHandler {
                 }
             }
             if (!targetSession) {
-                return `❌ 会话不存在: ${sessionName}\n使用 /slist 查看可用会话`;
+                return `❌ 会话不存在: ${sessionName}\n使用 /s 查看可用会话`;
             }
             const lastInput = targetSession.agentSessionId
                 ? this.sessionManager.readSessionLastUserMessage(targetSession.projectPath, targetSession.agentSessionId, targetSession.agentId)
@@ -2071,14 +2255,14 @@ export class CommandHandler {
                     targetSession = visibleSessions[idx - 1];
                 }
                 else {
-                    return `❌ 序号超出范围 (1-${visibleSessions.length})\n使用 /slist 查看可用会话`;
+                    return `❌ 序号超出范围 (1-${visibleSessions.length})\n使用 /s 查看可用会话`;
                 }
             }
             if (!targetSession && sessionName.length === 8) {
                 targetSession = await this.sessionManager.getSessionByUuidPrefix(channel, channelId, sessionName);
             }
             if (!targetSession) {
-                return `❌ 会话不存在: ${sessionName}\n使用 /slist 查看可用会话`;
+                return `❌ 会话不存在: ${sessionName}\n使用 /s 查看可用会话`;
             }
             if (targetSession.id === session.id) {
                 return `❌ 无法删除当前活跃会话\n请先切换到其他会话`;
@@ -2109,38 +2293,66 @@ export class CommandHandler {
                 const forkedSessionId = await forkAgent.forkSession(session.agentSessionId, session.projectPath, forkName);
                 const newSession = await this.sessionManager.createForkedSession(session, forkedSessionId, forkName);
                 this.eventBus.publish({ type: 'session:forked', sessionId: newSession.id, sourceSessionId: session.id, name: forkName });
-                return `✅ 会话已分支: ${newSession.name}\n新会话已激活，可以继续对话\n\n使用 /slist 查看所有会话，/s <名称> 切换回原会话`;
+                return `✅ 会话已分支: ${newSession.name}\n新会话已激活，可以继续对话\n\n使用 /s 查看所有会话，/s <名称> 切换回原会话`;
             }
             catch (error) {
                 logger.error('[CommandHandler] Fork session failed:', error);
                 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) {
@@ -2150,42 +2362,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;
+    }
 }