@code4bug/jarvis-agent 1.3.8 → 1.3.10

package/README.md

@@ -128,6 +128,7 @@ jarvis --version
 | 命令 | 说明 |
 | --- | --- |
 | `/init` | 扫描当前项目并生成 `JARVIS.md` |
+| `/about` | 查看 Jarvis 的详细特性、功能与信息 |
 | `/new` | 开启新会话 |
 | `/resume` | 恢复历史会话 |
 | `/resume <ID>` | 直接恢复指定历史会话 |

package/dist/cli.js

@@ -2,10 +2,19 @@
 import { APP_VERSION } from './config/constants.js';
 import { ensureLoggerReady, logError, logInfo } from './core/logger.js';
 import { startJarvis } from './index.js';
-const arg = process.argv[2];
+const args = process.argv.slice(2);
+const arg = args[0];
+function printCliUsage() {
+    console.log([
+        '用法:',
+        '  jarvis',
+        '  jarvis --version',
+        '  jarvis --resume <sessionId>',
+    ].join('\n'));
+}
 ensureLoggerReady();
 logInfo('cli.launch', {
-    argv: process.argv.slice(2),
+    argv: args,
     version: APP_VERSION,
 });
 if (arg === '--version' || arg === '-v' || arg === 'version') {
@@ -13,10 +22,22 @@ if (arg === '--version' || arg === '-v' || arg === 'version') {
     console.log(APP_VERSION);
     process.exit(0);
 }
+if (arg === '--resume') {
+    const sessionId = args[1]?.trim();
+    if (!sessionId) {
+        logError('cli.resume.missing_session_id', new Error('missing session id'));
+        printCliUsage();
+        process.exit(1);
+    }
+    logInfo('cli.resume', { sessionId });
+    startJarvis({ initialResumeSessionId: sessionId });
+}
+else {
+    startJarvis();
+}
 process.on('uncaughtException', (error) => {
     logError('process.uncaught_exception', error);
 });
 process.on('unhandledRejection', (reason) => {
     logError('process.unhandled_rejection', reason);
 });
-startJarvis();

package/dist/commands/index.js

@@ -7,6 +7,7 @@
 /** 内置命令 */
 const builtinCommands = [
     { name: 'init', description: '初始化项目信息，生成 JARVIS.md', category: 'builtin', submitMode: 'action' },
+    { name: 'about', description: '查看 Jarvis 的详细特性、功能与信息', category: 'builtin', submitMode: 'action' },
     { name: 'new', description: '开启新会话，重新初始化上下文', category: 'builtin', submitMode: 'action' },
     { name: 'exit', description: '退出应用程序', category: 'builtin', submitMode: 'action' },
     { name: 'quit', description: '退出应用程序', category: 'builtin', submitMode: 'action' },

package/dist/index.d.ts

@@ -1 +1,4 @@
-export declare function startJarvis(): void;
+export interface StartJarvisOptions {
+    initialResumeSessionId?: string;
+}
+export declare function startJarvis(options?: StartJarvisOptions): void;

package/dist/index.js

@@ -2,7 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { render } from 'ink';
 import { logInfo } from './core/logger.js';
 import AppBootstrap from './screens/AppBootstrap.js';
-export function startJarvis() {
-    logInfo('app.render.start');
-    render(_jsx(AppBootstrap, {}), { exitOnCtrlC: false });
+export function startJarvis(options = {}) {
+    logInfo('app.render.start', { initialResumeSessionId: options.initialResumeSessionId });
+    render(_jsx(AppBootstrap, { initialResumeSessionId: options.initialResumeSessionId }), { exitOnCtrlC: false });
 }

package/dist/screens/AppBootstrap.d.ts

@@ -1 +1,5 @@
-export default function AppBootstrap(): import("react/jsx-runtime").JSX.Element;
+interface AppBootstrapProps {
+    initialResumeSessionId?: string;
+}
+export default function AppBootstrap({ initialResumeSessionId }: AppBootstrapProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/screens/AppBootstrap.js

@@ -3,10 +3,10 @@ import { useState } from 'react';
 import REPL from './repl.js';
 import SetupWizard from './setup/SetupWizard.js';
 import { checkBootstrapStatus } from '../config/bootstrap.js';
-export default function AppBootstrap() {
+export default function AppBootstrap({ initialResumeSessionId }) {
     const [status, setStatus] = useState(() => checkBootstrapStatus());
     if (status.ok) {
-        return _jsx(REPL, {});
+        return _jsx(REPL, { initialResumeSessionId: initialResumeSessionId });
     }
     return (_jsx(SetupWizard, { initialStatus: status, onCompleted: () => {
             setStatus(checkBootstrapStatus());

package/dist/screens/repl.d.ts

@@ -1 +1,5 @@
-export default function REPL(): import("react/jsx-runtime").JSX.Element;
+interface REPLProps {
+    initialResumeSessionId?: string;
+}
+export default function REPL({ initialResumeSessionId }: REPLProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/screens/repl.js

@@ -21,14 +21,28 @@ 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() {
+export default function REPL({ initialResumeSessionId }) {
     const { exit } = useApp();
     const width = useTerminalWidth();
     const windowFocused = useWindowFocus();
+    const buildExitHint = useCallback(() => {
+        const sessionId = sessionRef.current.id?.trim();
+        if (!sessionId)
+            return '';
+        const separatorWidth = Math.max(process.stdout.columns ?? 0, 80);
+        const separator = '─'.repeat(separatorWidth);
+        return `\n${separator}\n\nResume this session with:\njarvis --resume ${sessionId}\n\n`;
+    }, []);
     const handleExit = useCallback(() => {
+        const exitHint = buildExitHint();
         exit();
-        setTimeout(() => process.exit(0), 50);
-    }, [exit]);
+        setTimeout(() => {
+            showTerminalCursor();
+            if (exitHint)
+                process.stdout.write(exitHint);
+            process.exit(0);
+        }, 50);
+    }, [buildExitHint, exit]);
     const { countdown, handleCtrlC } = useDoubleCtrlCExit(handleExit);
     const { pushHistory, navigateUp, navigateDown, resetNavigation } = useInputHistory();
     const [messages, setMessages] = useState([]);
@@ -145,6 +159,43 @@ export default function REPL() {
             logInfo('ui.repl.unmounted');
         };
     }, []);
+    useEffect(() => {
+        if (!initialResumeSessionId || !engineRef.current)
+            return;
+        const result = engineRef.current.loadSession(initialResumeSessionId);
+        if (result) {
+            stopAll();
+            setMessages([
+                ...result.messages,
+                {
+                    id: `resume-cli-${Date.now()}`,
+                    type: 'system',
+                    status: 'success',
+                    content: `已通过启动参数恢复会话 ${initialResumeSessionId.slice(0, 8)}...（${result.messages.length} 条消息）`,
+                    timestamp: Date.now(),
+                },
+            ]);
+            sessionRef.current = result.session;
+            tokenCountRef.current = result.session.totalTokens;
+            syncTokenDisplay(result.session.totalTokens);
+            setLoopState(null);
+            setIsProcessing(false);
+            setShowWelcome(false);
+            logInfo('ui.resume_from_cli.success', {
+                sessionId: initialResumeSessionId,
+                messageCount: result.messages.length,
+            });
+            return;
+        }
+        setMessages((prev) => [...prev, {
+                id: `resume-cli-error-${Date.now()}`,
+                type: 'error',
+                status: 'error',
+                content: `启动时恢复会话失败：${initialResumeSessionId} 不存在或已损坏`,
+                timestamp: Date.now(),
+            }]);
+        logWarn('ui.resume_from_cli.failed', { sessionId: initialResumeSessionId });
+    }, [initialResumeSessionId, stopAll, syncTokenDisplay]);
     // 订阅后台 SubAgent 计数变化
     useEffect(() => {
         return subscribeAgentCount((count) => setActiveAgents(count));

package/dist/screens/slashCommands.js

@@ -3,6 +3,7 @@ import { APP_VERSION } from '../config/constants.js';
 import { allTools } from '../tools/index.js';
 import { listSkills } from '../skills/index.js';
 import { getExternalSkillsDir } from '../skills/loader.js';
+import { loadAllAgents } from '../agents/index.js';
 import { listPermanentAuthorizations, DANGER_RULES, } from '../core/safeguard.js';
 /**
  * 斜杠命令执行器
@@ -25,6 +26,7 @@ export async function executeSlashCommand(cmdName) {
             const helpText = [
                 '可用命令:',
                 '  /init        初始化项目信息，生成 JARVIS.md',
+                '  /about       查看 Jarvis 的详细特性、功能与信息',
                 '  /new         开启新会话，重新初始化上下文',
                 '  /exit        退出应用程序',
                 '  /quit        退出应用程序',
@@ -59,6 +61,62 @@ export async function executeSlashCommand(cmdName) {
                 timestamp: Date.now(),
             };
         }
+        case 'about': {
+            const skills = listSkills();
+            const agents = Array.from(loadAllAgents().values());
+            const parts = [
+                'Jarvis 详细信息',
+                '',
+                `- 版本：${APP_VERSION}`,
+                '- 定位：运行在终端里的轻量级 AI Agent，面向代码、命令行与多步骤任务协作',
+                '- 技术栈：React + TypeScript + Ink',
+                '',
+                '核心能力:',
+                '- Agentic Loop：可连续推理、调用工具、读取结果并继续决策',
+                '- 流式终端交互：在终端里实时展示回复、状态与工具执行过程',
+                '- 文件与目录操作：支持读写文件、列目录、搜索内容、语义检索',
+                '- 命令执行：通过 Bash 工具执行命令，并统一经过安全围栏',
+                '- 多智能体协作：支持同步子 Agent、后台子 Agent 与消息总线通信',
+                '- 外部扩展：支持从 ~/.jarvis/skills/ 动态加载外部 Skill',
+                '- 会话与记忆：支持会话持久化、摘要、Token 统计与长期记忆',
+                '',
+                '当前实例概况:',
+                `- 内置工具：${allTools.length} 个`,
+                `- 外部 Skills：${skills.length} 个`,
+                `- 可切换 Agents：${agents.length} 个`,
+                '',
+                '内置工具:',
+                ...allTools.map((tool, index) => `  ${index + 1}. ${tool.name} - ${tool.description.split('\n')[0]}`),
+                '',
+                '可切换 Agents:',
+                ...agents.map((agent, index) => `  ${index + 1}. ${agent.meta.name} - ${agent.meta.description}`),
+                '',
+                '安全与交互:',
+                '- 危险命令会被安全围栏识别，并支持交互式确认与持久化授权',
+                '- 支持斜杠菜单、历史会话恢复、会话回退与快捷键操作',
+                '- 支持多个只读工具并行执行，提高响应效率',
+                '',
+                '常用入口:',
+                '- /help：查看所有斜杠命令',
+                '- /skills：查看当前 tools 和 skills',
+                '- /permissions：查看持久化授权列表',
+                '- /version：查看当前版本号',
+            ];
+            if (skills.length > 0) {
+                parts.push('');
+                parts.push('已加载 Skills:');
+                skills.forEach((skill, index) => {
+                    parts.push(`  ${index + 1}. ${skill.meta.name} - ${skill.meta.description}`);
+                });
+            }
+            return {
+                id: `about-${Date.now()}`,
+                type: 'system',
+                status: 'success',
+                content: parts.join('\n'),
+                timestamp: Date.now(),
+            };
+        }
         case 'permissions': {
             const perms = listPermanentAuthorizations();
             const lines = ['持久化授权列表 (~/.jarvis/.permissions.json)', ''];

package/package.json

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