@code4bug/jarvis-agent 1.3.5 → 1.3.7

package/README.md

@@ -98,7 +98,21 @@ Jarvis 会按下面顺序加载配置，后者覆盖前者：
 
 - `system.model` 对应 `models` 里的 key
 - `extra_body` 会直接合并进请求体，方便兼容不同服务商
-- 如果没有可用模型配置，程序会回退到 Mock Service，适合本地界面联调
+
+### 首次启动配置
+
+如果未检测到可用的全局配置，Jarvis 启动时会先进入首次配置向导，而不是直接进入主界面。
+
+当前配置向导支持两种接入方式：
+
+- OpenAI 兼容接口
+- Ollama / 本地模型
+
+配置写入位置：
+
+- `~/.jarvis/config.json`
+
+项目目录下的 `./.jarvis/config.json` 仍可作为本地覆盖配置使用。
 
 ## 常用命令
 
@@ -116,21 +130,47 @@ jarvis --version
 | `/init` | 扫描当前项目并生成 `JARVIS.md` |
 | `/new` | 开启新会话 |
 | `/resume` | 恢复历史会话 |
-| `/agent` | 切换智能体 |
+| `/resume <ID>` | 直接恢复指定历史会话 |
+| `/rewind` | 打开当前会话提问列表并回退到指定位置 |
+| `/agent` | 打开智能体切换列表 |
+| `/agent <名称>` | 切换智能体，重启后生效 |
 | `/permissions` | 查看持久化授权 |
 | `/skills` | 查看当前工具与外部 Skill |
 | `/session_clear` | 清理非当前会话历史 |
 | `/version` | 显示版本 |
 | `/help` | 显示帮助 |
+| `/create_skill <描述>` | 根据描述创建新的 Skill |
+| `/exit` | 退出应用 |
+| `/quit` | 退出应用 |
+| `/bye` | 退出应用 |
+| `/read <路径>` | 以工具方式读取文件 |
+| `/write <路径>` | 以工具方式写入文件 |
+| `/bash <命令>` | 以工具方式执行命令 |
+| `/ls <路径>` | 以工具方式列出目录 |
+| `/search <关键词>` | 以工具方式搜索文件内容 |
 
 ### 快捷键
 
 | 快捷键 | 说明 |
 | --- | --- |
 | `Ctrl + L` | 清屏并开始新会话 |
-| `Ctrl + C` | 退出 |
-| `Esc` | 中断当前任务或清空输入 |
+| `Ctrl + C` | 3 秒内连续按两次退出 |
+| `Ctrl + O` | 切换详情视图 |
+| `Esc` | 中断当前任务；空闲时双击清空输入 |
 | `Alt/Option + Enter` | 输入换行 |
+| `Tab` | 输入为空时填入提示词；在斜杠菜单中补全当前项 |
+| `? + Enter` | 输出快捷键帮助信息 |
+
+### 输入与交互
+
+- 输入 `/` 可打开斜杠菜单
+- 斜杠菜单中可使用 `↑ / ↓` 切换命令
+- 在斜杠菜单中按 `Tab` 可补全当前命令
+- 在斜杠菜单中按 `Enter` 可提交当前命令
+- 输入 `/rewind` 后可列出当前会话的提问列表，按时间从上到下升序排列
+- 在 `/rewind` 列表中选择某条提问后，会把该提问回填到输入框，并丢弃该位置之后的上下文
+- 对于多行输入，`↑ / ↓` 用于在输入框内移动光标
+- 对于单行输入，`↑ / ↓` 用于切换历史输入
 
 ## 内置工具
 
@@ -209,6 +249,12 @@ Agent 通过 Markdown 文件定义元信息与系统提示词，切换结果会
 
 每次会话会保存消息、摘要、更新时间和累计 Token。
 
+支持能力：
+
+- `/resume` 从列表恢复历史会话
+- `/resume <ID>` 直接恢复指定会话
+- `/session_clear` 清理除当前会话外的历史记录
+
 ### 长期记忆
 
 - 记忆文件：`~/.jarvis/MEMORY.md`

package/dist/commands/index.d.ts

@@ -7,6 +7,8 @@
 export interface SlashCommand {
     /** 命令名称（不含 /） */
     name: string;
+    /** 可选：菜单展示名 */
+    displayName?: string;
     /** 简短描述 */
     description: string;
     /** 命令类别 */

package/dist/commands/index.js

@@ -12,6 +12,7 @@ const builtinCommands = [
     { name: 'quit', description: '退出应用程序', category: 'builtin', submitMode: 'action' },
     { name: 'bye', description: '退出应用程序', category: 'builtin', submitMode: 'action' },
     { name: 'resume', description: '恢复历史会话上下文', category: 'builtin', submitMode: 'list' },
+    { name: 'rewind', description: '回退当前会话到指定提问位置', category: 'builtin', submitMode: 'list' },
     { name: 'help', description: '显示帮助信息', category: 'builtin', submitMode: 'action' },
     { name: 'agent', description: '切换智能体', category: 'builtin', submitMode: 'list' },
     { name: 'permissions', description: '查看所有持久化授权列表', category: 'builtin', submitMode: 'action' },

package/dist/components/MessageItem.js

@@ -3,6 +3,7 @@ import React from 'react';
 import { Box, Text } from 'ink';
 import Spinner from 'ink-spinner';
 import MarkdownText from './MarkdownText.js';
+import ShortcutHelpMessage from './ShortcutHelpMessage.js';
 // 状态圆点 icon，根据消息类型 + 状态决定颜色
 // reasoning 完成 → 白色 / tool_exec 成功 → 绿色 / error → 红色 / aborted → 黄色 / pending → 黄色
 function statusDot(status, type) {
@@ -80,7 +81,7 @@ function MessageItem({ msg, showDetails = false }) {
                 _jsxs(_Fragment, { children: [_jsxs(Box, { children: [_jsxs(Text, { color: dotColor, children: [dot, " "] }), _jsxs(Text, { color: "blue", dimColor: true, children: [msg.subAgentId, " \u203A "] })] }), _jsx(Box, { marginLeft: 2, flexDirection: "column", children: _jsx(MarkdownText, { text: msg.content }) })] })) : (_jsxs(Box, { flexDirection: "row", alignItems: "flex-start", children: [_jsxs(Text, { color: dotColor, children: [dot, " "] }), _jsx(Box, { flexDirection: "column", flexShrink: 1, children: _jsx(MarkdownText, { text: msg.content }) })] })), _jsx(MessageStats, { msg: msg, show: showDetails })] }));
     }
     if (msg.type === 'system' && msg.content) {
-        return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { flexDirection: "row", alignItems: "flex-start", children: [_jsxs(Text, { color: dotColor, children: [dot, " "] }), _jsx(Box, { flexDirection: "column", flexShrink: 1, children: _jsx(MarkdownText, { text: msg.content, color: "gray" }) })] }), _jsx(MessageStats, { msg: msg, show: showDetails })] }));
+        return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { flexDirection: "row", alignItems: "flex-start", children: [_jsxs(Text, { color: dotColor, children: [dot, " "] }), _jsx(Box, { flexDirection: "column", flexShrink: 1, children: msg.systemKind === 'shortcut_help' ? (_jsx(ShortcutHelpMessage, {})) : (_jsx(MarkdownText, { text: msg.content, color: "gray" })) })] }), _jsx(MessageStats, { msg: msg, show: showDetails })] }));
     }
     if (msg.status !== 'pending' && msg.content) {
         return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { flexDirection: "row", alignItems: "flex-start", children: [_jsxs(Text, { color: dotColor, children: [dot, " "] }), _jsx(Box, { flexDirection: "column", flexShrink: 1, children: _jsx(MarkdownText, { text: msg.content, color: "gray" }) })] }), _jsx(MessageStats, { msg: msg, show: showDetails })] }));

package/dist/components/ShortcutHelpMessage.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+declare function ShortcutHelpMessage(): import("react/jsx-runtime").JSX.Element;
+declare const _default: React.MemoExoticComponent<typeof ShortcutHelpMessage>;
+export default _default;

package/dist/components/ShortcutHelpMessage.js

@@ -0,0 +1,10 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { Box, Text } from 'ink';
+import { getShortcutPlatformNote, getShortcutSections } from '../config/shortcuts.js';
+function ShortcutHelpMessage() {
+    const sections = getShortcutSections();
+    const note = getShortcutPlatformNote();
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "cyan", bold: true, children: "\u5FEB\u6377\u952E\u5E2E\u52A9" }), _jsx(Text, { color: "gray", children: note }), sections.map((section) => (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: "yellow", bold: true, children: section.title }), section.items.map((item, index) => (_jsxs(Box, { children: [_jsx(Box, { width: 24, flexShrink: 0, children: _jsx(Text, { color: "green", bold: true, children: item.key }) }), _jsx(Text, { color: "white", children: item.description })] }, `${section.title}-${item.key}-${index}`)))] }, section.title)))] }));
+}
+export default React.memo(ShortcutHelpMessage);

package/dist/components/SlashCommandMenu.js

@@ -37,7 +37,8 @@ function SlashCommandMenu({ commands, selectedIndex, maxVisible = 6, }) {
                 const isSelected = realIndex === selectedIndex;
                 const catColor = categoryColor[cmd.category] ?? 'gray';
                 const catText = categoryLabel[cmd.category] ?? cmd.category;
-                return (_jsxs(Box, { children: [_jsxs(Text, { color: isSelected ? 'cyan' : 'white', children: [' ', "/", cmd.name, ' '] }), _jsxs(Text, { color: isSelected ? 'cyan' : 'gray', children: ["- ", cmd.description, ' '] }), _jsxs(Text, { color: catColor, dimColor: true, children: ["[", catText, "]"] })] }, cmd.name));
+                const displayName = cmd.displayName ?? cmd.name;
+                return (_jsxs(Box, { children: [_jsxs(Text, { color: isSelected ? 'cyan' : 'white', children: [' ', "/", displayName, ' '] }), _jsxs(Text, { color: isSelected ? 'cyan' : 'gray', children: ["- ", cmd.description, ' '] }), _jsxs(Text, { color: catColor, dimColor: true, children: ["[", catText, "]"] })] }, `${cmd.name}-${realIndex}`));
             }), start + visible < total && (_jsxs(Text, { color: "gray", dimColor: true, children: ["  \u2193 \u8FD8\u6709 ", total - start - visible, " \u9879"] }))] }));
 }
 export default React.memo(SlashCommandMenu);

package/dist/components/WelcomeHeader.js

@@ -22,6 +22,6 @@ function WelcomeHeader({ width }) {
     const showLogo = width >= 52;
     const appName = getAppName();
     const modelName = getModelName();
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, width: width, children: [showLogo && (_jsx(Box, { flexDirection: "column", children: LOGO_LINES.map((line, i) => (_jsx(Text, { color: LOGO_COLORS[i], children: line }, i))) })), _jsxs(Box, { marginTop: 0, children: [_jsx(Text, { color: "gray" }), _jsx(Text, { color: "white", bold: true, children: "Your AI-Powered Dev Companion" }), _jsx(Text, { color: "gray" })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", children: '─'.repeat(Math.min(width - 4, 48)) }) }), _jsxs(Box, { marginTop: 0, children: [_jsx(Text, { color: "gray", children: "model " }), _jsx(Text, { color: "cyan", children: modelName }), _jsxs(Text, { color: "gray", children: ["  ", appName, " "] }), _jsx(Text, { color: "magenta", children: APP_VERSION })] }), _jsx(Box, { children: _jsx(Text, { color: "gray", children: truncatePath(process.cwd(), maxPath) }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", children: '─'.repeat(Math.min(width - 4, 48)) }) }), _jsxs(Box, { children: [_jsx(Text, { color: "gray", children: "/" }), _jsx(Text, { color: "cyan", children: "init" }), _jsx(Text, { color: "gray", children: " \u521D\u59CB\u5316  " }), _jsx(Text, { color: "gray", children: "/" }), _jsx(Text, { color: "cyan", children: "help" }), _jsx(Text, { color: "gray", children: " \u5E2E\u52A9  " }), _jsx(Text, { color: "gray", children: "/" }), _jsx(Text, { color: "cyan", children: "new" }), _jsx(Text, { color: "gray", children: " \u65B0\u4F1A\u8BDD  " }), _jsx(Text, { color: "gray", children: "/" }), _jsx(Text, { color: "cyan", children: "agent" }), _jsx(Text, { color: "gray", children: " \u5207\u6362" })] }), _jsx(Text, { children: ' ' })] }));
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, width: width, children: [showLogo && (_jsx(Box, { flexDirection: "column", children: LOGO_LINES.map((line, i) => (_jsx(Text, { color: LOGO_COLORS[i], children: line }, i))) })), _jsxs(Box, { marginTop: 0, children: [_jsx(Text, { color: "gray" }), _jsx(Text, { color: "white", bold: true, children: "Your AI-Powered Dev Companion" }), _jsx(Text, { color: "gray" })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", children: '─'.repeat(Math.min(width - 4, 48)) }) }), _jsxs(Box, { marginTop: 0, children: [_jsx(Text, { color: "gray", children: "model " }), _jsx(Text, { color: "cyan", children: modelName }), _jsxs(Text, { color: "gray", children: ["  ", appName, " "] }), _jsx(Text, { color: "magenta", children: APP_VERSION })] }), _jsx(Box, { children: _jsx(Text, { color: "gray", children: truncatePath(process.cwd(), maxPath) }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", children: '─'.repeat(Math.min(width - 4, 48)) }) }), _jsxs(Box, { children: [_jsx(Text, { color: "gray", children: "/" }), _jsx(Text, { color: "cyan", children: "init" }), _jsx(Text, { color: "gray", children: " \u521D\u59CB\u5316  " }), _jsx(Text, { color: "gray", children: "/" }), _jsx(Text, { color: "cyan", children: "help" }), _jsx(Text, { color: "gray", children: " \u5E2E\u52A9  " }), _jsx(Text, { color: "gray", children: "/" }), _jsx(Text, { color: "cyan", children: "new" }), _jsx(Text, { color: "gray", children: " \u65B0\u4F1A\u8BDD  " }), _jsx(Text, { color: "gray", children: "/" }), _jsx(Text, { color: "cyan", children: "agent" }), _jsx(Text, { color: "gray", children: " \u5207\u6362  " }), _jsx(Text, { color: "yellow", bold: true, children: "?" }), _jsx(Text, { color: "gray", children: " \u5FEB\u6377\u952E\u63D0\u793A" })] }), _jsx(Text, { children: ' ' })] }));
 }
 export default React.memo(WelcomeHeader);

package/dist/config/shortcuts.d.ts

@@ -0,0 +1,13 @@
+export interface ShortcutItem {
+    key: string;
+    description: string;
+}
+export interface ShortcutSection {
+    title: string;
+    items: ShortcutItem[];
+}
+export declare function getShortcutPlatformLabel(): string;
+export declare function getShortcutAltKeyLabel(): string;
+export declare function getShortcutPlatformNote(): string;
+export declare function getShortcutSections(): ShortcutSection[];
+export declare function buildShortcutHelpText(): string;

package/dist/config/shortcuts.js

@@ -0,0 +1,67 @@
+const isMac = process.platform === 'darwin';
+const isWindows = process.platform === 'win32';
+export function getShortcutPlatformLabel() {
+    if (isMac)
+        return 'macOS';
+    if (isWindows)
+        return 'Windows';
+    return 'Linux';
+}
+export function getShortcutAltKeyLabel() {
+    return isMac ? 'Option' : 'Alt';
+}
+export function getShortcutPlatformNote() {
+    if (isMac)
+        return '当前平台：macOS（终端内快捷键使用 Ctrl / Option，通常不是 Cmd）';
+    if (isWindows)
+        return '当前平台：Windows（快捷键使用 Ctrl / Alt）';
+    return '当前平台：Linux（快捷键使用 Ctrl / Alt）';
+}
+export function getShortcutSections() {
+    const altKey = getShortcutAltKeyLabel();
+    const platform = getShortcutPlatformLabel();
+    return [
+        {
+            title: '通用快捷键',
+            items: [
+                { key: '? + Enter', description: '查看全部快捷键说明' },
+                { key: 'Ctrl + C', description: '退出 Jarvis（需连续按两次）' },
+                { key: 'Ctrl + L', description: '清屏并开始新会话' },
+                { key: 'Ctrl + O', description: '切换详情视图' },
+                { key: 'Esc', description: '中断当前任务；空闲时双击清空输入' },
+                { key: `${altKey} + Enter`, description: '插入换行' },
+                { key: 'Tab', description: '输入为空时填入提示词；斜杠菜单中补全选中项' },
+                { key: 'Enter', description: '发送消息；斜杠菜单中提交当前选中命令' },
+            ],
+        },
+        {
+            title: `输入编辑（${platform}）`,
+            items: [
+                { key: '← / →', description: '左右移动光标' },
+                { key: '↑ / ↓', description: '多行输入时上下移动光标' },
+                { key: '↑ / ↓', description: '单行输入时切换历史记录' },
+            ],
+        },
+        {
+            title: '斜杠菜单',
+            items: [
+                { key: '/', description: '打开命令菜单' },
+                { key: '↑ / ↓', description: '切换命令' },
+                { key: 'Tab / Enter', description: '补全或提交当前命令' },
+                { key: 'Esc', description: '关闭命令菜单' },
+            ],
+        },
+    ];
+}
+export function buildShortcutHelpText() {
+    return [
+        '快捷键帮助',
+        getShortcutPlatformNote(),
+        '',
+        ...getShortcutSections().flatMap((section) => [
+            `${section.title}：`,
+            ...section.items.map((item) => `  ${item.key}  ${item.description}`),
+            '',
+        ]),
+    ].join('\n').trim();
+}

package/dist/core/QueryEngine.d.ts

@@ -30,6 +30,9 @@ export declare class QueryEngine {
     /** 注册持久 UI 回调，供后台 spawn_agent 子 Agent 推送消息 */
     registerUIBus(onMessage: (msg: Message) => void, onUpdateMessage: (id: string, updates: Partial<Message>) => void): void;
     private createSession;
+    private rebuildTranscriptFromMessages;
+    private recomputeSessionSummary;
+    private recomputeSessionTokens;
     private ensureSessionDir;
     private createService;
     /** 处理用户输入（在独立 Worker 线程中执行） */
@@ -62,6 +65,19 @@ export declare class QueryEngine {
         messages: Message[];
     } | null;
     getSession(): Session;
+    getCurrentSessionUserTurns(): Array<{
+        messageId: string;
+        turnIndex: number;
+        input: string;
+        answerPreview: string;
+        timestamp: number;
+    }>;
+    rewindToUserMessage(messageId: string): {
+        session: Session;
+        messages: Message[];
+        input: string;
+        turnIndex: number;
+    } | null;
     /**
      * 清理非当前会话的所有历史会话文件
      * @returns 删除的会话数量

package/dist/core/QueryEngine.js

@@ -51,6 +51,39 @@ export class QueryEngine {
             totalCost: 0,
         };
     }
+    rebuildTranscriptFromMessages(messages) {
+        const transcript = [];
+        for (const msg of messages) {
+            if (msg.type === 'user') {
+                transcript.push({ role: 'user', content: msg.content });
+            }
+            else if (msg.type === 'reasoning' && msg.status === 'success' && msg.content) {
+                transcript.push({
+                    role: 'assistant',
+                    content: [{ type: 'text', text: msg.content }],
+                });
+            }
+            else if (msg.type === 'tool_exec' && msg.toolName && msg.toolResult !== undefined) {
+                transcript.push({
+                    role: 'assistant',
+                    content: [{ type: 'tool_use', id: msg.id, name: msg.toolName, input: msg.toolArgs ?? {} }],
+                });
+                transcript.push({
+                    role: 'tool_result',
+                    content: msg.toolResult,
+                    toolUseId: msg.id,
+                });
+            }
+        }
+        return transcript;
+    }
+    recomputeSessionSummary(messages) {
+        const firstUser = messages.find((m) => m.type === 'user');
+        return firstUser ? firstUser.content.slice(0, 80).replace(/\n/g, ' ') : undefined;
+    }
+    recomputeSessionTokens(messages) {
+        return messages.reduce((sum, msg) => sum + (msg.tokenCount ?? 0), 0);
+    }
     ensureSessionDir() {
         if (!fs.existsSync(SESSIONS_DIR)) {
             fs.mkdirSync(SESSIONS_DIR, { recursive: true });
@@ -321,31 +354,7 @@ export class QueryEngine {
             const cleanedMessages = loaded.messages.filter((m) => !(m.type === 'thinking' && m.status === 'pending'));
             this.session.messages = cleanedMessages;
             // 从历史消息重建 transcript
-            this.transcript = [];
-            for (const msg of loaded.messages) {
-                if (msg.type === 'user') {
-                    this.transcript.push({ role: 'user', content: msg.content });
-                }
-                else if (msg.type === 'reasoning' && msg.status === 'success' && msg.content) {
-                    // assistant 消息的 content 必须是 ContentBlock[]，与 query.ts 中的构建方式一致
-                    this.transcript.push({
-                        role: 'assistant',
-                        content: [{ type: 'text', text: msg.content }],
-                    });
-                }
-                else if (msg.type === 'tool_exec' && msg.toolName && msg.toolResult !== undefined) {
-                    // 工具调用：assistant tool_use + tool_result
-                    this.transcript.push({
-                        role: 'assistant',
-                        content: [{ type: 'tool_use', id: msg.id, name: msg.toolName, input: msg.toolArgs ?? {} }],
-                    });
-                    this.transcript.push({
-                        role: 'tool_result',
-                        content: msg.toolResult,
-                        toolUseId: msg.id,
-                    });
-                }
-            }
+            this.transcript = this.rebuildTranscriptFromMessages(cleanedMessages);
             logInfo('session.loaded', {
                 sessionId,
                 messageCount: cleanedMessages.length,
@@ -362,6 +371,57 @@ export class QueryEngine {
     getSession() {
         return this.session;
     }
+    getCurrentSessionUserTurns() {
+        const cleanedMessages = this.session.messages.filter((m) => !(m.type === 'thinking' && m.status === 'pending'));
+        const userMessages = cleanedMessages.filter((m) => m.type === 'user');
+        return userMessages.map((msg, index) => {
+            const currentIndex = cleanedMessages.findIndex((item) => item.id === msg.id);
+            const nextUserIndex = cleanedMessages.findIndex((item, i) => i > currentIndex && item.type === 'user');
+            const endIndex = nextUserIndex >= 0 ? nextUserIndex : cleanedMessages.length;
+            const answerPreview = cleanedMessages
+                .slice(currentIndex + 1, endIndex)
+                .filter((item) => item.type === 'reasoning' && item.content)
+                .map((item) => item.content.trim())
+                .find(Boolean) ?? '';
+            return {
+                messageId: msg.id,
+                turnIndex: index + 1,
+                input: msg.content,
+                answerPreview,
+                timestamp: msg.timestamp,
+            };
+        });
+    }
+    rewindToUserMessage(messageId) {
+        const cleanedMessages = this.session.messages.filter((m) => !(m.type === 'thinking' && m.status === 'pending'));
+        const targetIndex = cleanedMessages.findIndex((m) => m.id === messageId && m.type === 'user');
+        if (targetIndex < 0)
+            return null;
+        const userTurns = cleanedMessages.filter((m) => m.type === 'user');
+        const turnIndex = userTurns.findIndex((m) => m.id === messageId) + 1;
+        const targetMessage = cleanedMessages[targetIndex];
+        const keptMessages = cleanedMessages.slice(0, targetIndex);
+        this.session.messages = keptMessages;
+        this.session.summary = this.recomputeSessionSummary(keptMessages);
+        this.session.totalTokens = this.recomputeSessionTokens(keptMessages);
+        this.session.updatedAt = Date.now();
+        this.transcript = this.rebuildTranscriptFromMessages(keptMessages);
+        this.touchActivity();
+        this.saveSession();
+        logInfo('session.rewind', {
+            sessionId: this.session.id,
+            targetMessageId: messageId,
+            turnIndex,
+            keptMessageCount: keptMessages.length,
+            transcriptLength: this.transcript.length,
+        });
+        return {
+            session: this.session,
+            messages: keptMessages,
+            input: targetMessage.content,
+            turnIndex,
+        };
+    }
     /**
      * 清理非当前会话的所有历史会话文件
      * @returns 删除的会话数量

package/dist/hooks/useSlashMenu.d.ts

@@ -27,12 +27,13 @@ export declare function useSlashMenu(opts: UseSlashMenuOptions): {
     slashMenuIndex: number;
     agentMenuMode: boolean;
     resumeMenuMode: boolean;
+    rewindMenuMode: boolean;
     handleSlashMenuUp: () => void;
     handleSlashMenuDown: () => void;
     handleSlashMenuClose: () => void;
     getSelectedCommand: () => SlashCommand | null;
     autocompleteSlashMenuSelection: (currentInput: string) => string;
-    openListCommand: (commandName: "agent" | "resume") => "/agent " | "/resume ";
+    openListCommand: (commandName: "agent" | "resume" | "rewind") => "/agent " | "/rewind " | "/resume ";
     updateSlashMenu: (val: string) => void;
     setSlashMenuVisible: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     resumeSession: (sessionId: string) => void;

package/dist/hooks/useSlashMenu.js

@@ -13,6 +13,7 @@ export function useSlashMenu(opts) {
     const [slashMenuIndex, setSlashMenuIndex] = useState(0);
     const [agentMenuMode, setAgentMenuMode] = useState(false);
     const [resumeMenuMode, setResumeMenuMode] = useState(false);
+    const [rewindMenuMode, setRewindMenuMode] = useState(false);
     // 上移
     const handleSlashMenuUp = useCallback(() => {
         setSlashMenuIndex((prev) => (prev > 0 ? prev - 1 : slashMenuItems.length - 1));
@@ -23,9 +24,10 @@ export function useSlashMenu(opts) {
     }, [slashMenuItems.length]);
     // 关闭
     const handleSlashMenuClose = useCallback(() => {
-        if (agentMenuMode || resumeMenuMode) {
+        if (agentMenuMode || resumeMenuMode || rewindMenuMode) {
             setAgentMenuMode(false);
             setResumeMenuMode(false);
+            setRewindMenuMode(false);
             setInput('/');
             const matched = filterCommands('');
             setSlashMenuItems(matched);
@@ -35,7 +37,7 @@ export function useSlashMenu(opts) {
         else {
             setSlashMenuVisible(false);
         }
-    }, [agentMenuMode, resumeMenuMode, setInput]);
+    }, [agentMenuMode, resumeMenuMode, rewindMenuMode, setInput]);
     // 恢复会话的通用逻辑
     const resumeSession = useCallback((sessionId) => {
         if (!engineRef.current)
@@ -76,6 +78,25 @@ export function useSlashMenu(opts) {
             return null;
         return slashMenuItems[slashMenuIndex] ?? null;
     }, [slashMenuItems, slashMenuIndex]);
+    const buildRewindItems = useCallback(() => {
+        if (!engineRef.current)
+            return [];
+        return engineRef.current.getCurrentSessionUserTurns()
+            .slice()
+            .map((turn) => {
+            const date = new Date(turn.timestamp);
+            const dateStr = `${date.getMonth() + 1}/${date.getDate()} ${date.getHours().toString().padStart(2, '0')}:${date.getMinutes().toString().padStart(2, '0')}`;
+            const question = turn.input.replace(/\s+/g, ' ').slice(0, 32);
+            const answer = turn.answerPreview.replace(/\s+/g, ' ').slice(0, 24);
+            return {
+                name: turn.messageId,
+                displayName: `rewind-${turn.turnIndex}`,
+                description: `[Q${turn.turnIndex} ${dateStr}] ${question}${answer ? ` ｜ A: ${answer}` : ''}`,
+                category: 'builtin',
+                submitMode: 'action',
+            };
+        });
+    }, [engineRef]);
     const openListCommand = useCallback((commandName) => {
         if (commandName === 'agent') {
             setInput('/agent ');
@@ -84,9 +105,21 @@ export function useSlashMenu(opts) {
             setSlashMenuIndex(0);
             setAgentMenuMode(true);
             setResumeMenuMode(false);
+            setRewindMenuMode(false);
             setSlashMenuVisible(matched.length > 0);
             return '/agent ';
         }
+        if (commandName === 'rewind') {
+            const items = buildRewindItems();
+            setInput('/rewind ');
+            setSlashMenuItems(items);
+            setSlashMenuIndex(0);
+            setSlashMenuVisible(items.length > 0);
+            setRewindMenuMode(true);
+            setResumeMenuMode(false);
+            setAgentMenuMode(false);
+            return '/rewind ';
+        }
         const sessions = QueryEngine.listSessions().slice(0, 20);
         const items = sessions.map((s) => {
             const date = new Date(s.updatedAt);
@@ -104,8 +137,9 @@ export function useSlashMenu(opts) {
         setSlashMenuVisible(items.length > 0);
         setResumeMenuMode(true);
         setAgentMenuMode(false);
+        setRewindMenuMode(false);
         return '/resume ';
-    }, [setInput]);
+    }, [setInput, buildRewindItems]);
     const autocompleteSlashMenuSelection = useCallback((currentInput) => {
         const cmd = getSelectedCommand();
         if (!cmd)
@@ -124,17 +158,23 @@ export function useSlashMenu(opts) {
             setSlashMenuVisible(false);
             return nextInput;
         }
+        if (rewindMenuMode) {
+            const nextInput = `/rewind ${cmd.name}`;
+            setInput(nextInput);
+            setSlashMenuVisible(false);
+            return nextInput;
+        }
         const match = currentInput.match(/^\/\S*/);
         const suffix = match ? currentInput.slice(match[0].length) : '';
         const needsTrailingSpace = !suffix && (cmd.submitMode === 'context' || cmd.submitMode === 'list');
         const nextInput = `/${cmd.name}${suffix}${needsTrailingSpace ? ' ' : ''}`;
         setInput(nextInput);
-        if (cmd.submitMode === 'list' && (cmd.name === 'agent' || cmd.name === 'resume') && !suffix.trim()) {
+        if (cmd.submitMode === 'list' && (cmd.name === 'agent' || cmd.name === 'resume' || cmd.name === 'rewind') && !suffix.trim()) {
             return openListCommand(cmd.name);
         }
         updateSlashMenu(nextInput);
         return nextInput;
-    }, [agentMenuMode, resumeMenuMode, getSelectedCommand, setInput, openListCommand]);
+    }, [agentMenuMode, resumeMenuMode, rewindMenuMode, getSelectedCommand, setInput, openListCommand]);
     // 输入变化时更新菜单
     const updateSlashMenu = useCallback((val) => {
         if (val.startsWith('/') && !val.includes('\n')) {
@@ -172,6 +212,22 @@ export function useSlashMenu(opts) {
                 setSlashMenuVisible(matched.length > 0);
                 setResumeMenuMode(true);
                 setAgentMenuMode(false);
+                setRewindMenuMode(false);
+                return;
+            }
+            // /rewind 二级菜单
+            if (/^rewind\s/i.test(query)) {
+                const subQuery = query.replace(/^rewind\s*/i, '').toLowerCase();
+                const items = buildRewindItems();
+                const matched = subQuery
+                    ? items.filter((i) => i.name.includes(subQuery) || (i.displayName ?? '').toLowerCase().includes(subQuery) || i.description.toLowerCase().includes(subQuery))
+                    : items;
+                setSlashMenuItems(matched);
+                setSlashMenuIndex(0);
+                setSlashMenuVisible(matched.length > 0);
+                setRewindMenuMode(true);
+                setResumeMenuMode(false);
+                setAgentMenuMode(false);
                 return;
             }
             // 一级菜单
@@ -181,19 +237,22 @@ export function useSlashMenu(opts) {
             setSlashMenuVisible(matched.length > 0);
             setAgentMenuMode(false);
             setResumeMenuMode(false);
+            setRewindMenuMode(false);
         }
         else {
             setSlashMenuVisible(false);
             setAgentMenuMode(false);
             setResumeMenuMode(false);
+            setRewindMenuMode(false);
         }
-    }, []);
+    }, [buildRewindItems]);
     return {
         slashMenuVisible,
         slashMenuItems,
         slashMenuIndex,
         agentMenuMode,
         resumeMenuMode,
+        rewindMenuMode,
         handleSlashMenuUp,
         handleSlashMenuDown,
         handleSlashMenuClose,

package/dist/screens/repl.js

@@ -19,6 +19,7 @@ import { subscribeAgentCount, getActiveAgentCount } from '../core/spawnRegistry.
 import { logError, logInfo, logWarn } from '../core/logger.js';
 import { getAgentSubCommands } from '../commands/index.js';
 import { setActiveAgent } from '../config/agentState.js';
+import { buildShortcutHelpText } from '../config/shortcuts.js';
 import { hideTerminalCursor, showTerminalCursor } from '../terminal/cursor.js';
 export default function REPL() {
     const { exit } = useApp();
@@ -200,6 +201,22 @@ export default function REPL() {
         const trimmed = value.trim();
         if (!trimmed || isProcessing || !engineRef.current)
             return;
+        if (trimmed === '?') {
+            setInput('');
+            slashMenu.setSlashMenuVisible(false);
+            if (HIDE_WELCOME_AFTER_INPUT)
+                setShowWelcome(false);
+            setMessages((prev) => [...prev, {
+                    id: `shortcut-help-${Date.now()}`,
+                    type: 'system',
+                    status: 'success',
+                    systemKind: 'shortcut_help',
+                    content: buildShortcutHelpText(),
+                    timestamp: Date.now(),
+                }]);
+            logInfo('ui.shortcut_help.open');
+            return;
+        }
         logInfo('ui.submit', {
             inputLength: trimmed.length,
             isSlashCommand: trimmed.startsWith('/'),
@@ -243,6 +260,49 @@ export default function REPL() {
                 }
                 return;
             }
+            // /rewind
+            if (cmdName === 'rewind') {
+                if (hasArgs && engineRef.current) {
+                    setInput('');
+                    slashMenu.setSlashMenuVisible(false);
+                    const messageId = parts.slice(1).join(' ').trim();
+                    const result = engineRef.current.rewindToUserMessage(messageId);
+                    if (!result) {
+                        const errMsg = {
+                            id: `rewind-err-${Date.now()}`,
+                            type: 'error',
+                            status: 'error',
+                            content: '未找到要回退的会话位置',
+                            timestamp: Date.now(),
+                        };
+                        setMessages((prev) => [...prev, errMsg]);
+                        return;
+                    }
+                    stopAll();
+                    setMessages([
+                        ...result.messages,
+                        {
+                            id: `rewind-${Date.now()}`,
+                            type: 'system',
+                            status: 'success',
+                            content: `已回退到当前会话的第 ${result.turnIndex} 条提问，请确认后重新发送。`,
+                            timestamp: Date.now(),
+                        },
+                    ]);
+                    sessionRef.current = result.session;
+                    tokenCountRef.current = result.session.totalTokens;
+                    syncTokenDisplay(result.session.totalTokens);
+                    setLoopState(null);
+                    setIsProcessing(false);
+                    setShowWelcome(false);
+                    resetNavigation();
+                    setInput(result.input);
+                }
+                else {
+                    slashMenu.openListCommand('rewind');
+                }
+                return;
+            }
             // /create_skill
             if (cmdName === 'create_skill') {
                 setInput('');

package/dist/screens/slashCommands.js

@@ -31,6 +31,7 @@ export async function executeSlashCommand(cmdName) {
                 '  /bye         退出应用程序',
                 '  /resume      恢复历史会话（支持二级菜单选择）',
                 '  /resume <ID> 直接恢复指定会话',
+                '  /rewind      回退当前会话到指定提问位置',
                 '  /help        显示此帮助信息',
                 '  /session_clear 清理所有非当前会话的历史记录',
                 '  /skills      查看当前所有 tools 和 skills',

package/dist/types/index.d.ts

@@ -6,6 +6,7 @@ export interface Message {
     status: MessageStatus;
     content: string;
     timestamp: number;
+    systemKind?: 'shortcut_help';
     /** 耗时 ms */
     duration?: number;
     /** token 统计 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@code4bug/jarvis-agent",
-  "version": "1.3.5",
+  "version": "1.3.7",
   "description": "基于 React + TypeScript + Ink 构建的命令行智能体交互界面",
   "type": "module",
   "main": "dist/index.js",