@code4bug/jarvis-agent 1.1.4 → 1.1.5

package/README.md

@@ -11,6 +11,10 @@
 
 在终端中与 AI 对话，支持多轮推理、工具调用、流式输出，开箱即用。
 
+> 多智能体，不只是多几个助手，而是让需求分析、方案设计、编码实现、测试验证、代码评审等角色真正协同起来。  
+> 它可以用于多人协作流程构建、跨角色任务接力、复杂项目拆解与推进，也可以用于产品研发、缺陷修复、自动化交付等高频场景。  
+> 当多个智能体围绕同一目标持续沟通、分工与汇总时，AI 才真正从“单点应答”走向“团队作战”。
+
 ---
 
 ## 为什么叫 Jarvis

package/dist/cli.js

@@ -1,9 +1,22 @@
 #!/usr/bin/env node
 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];
+ensureLoggerReady();
+logInfo('cli.launch', {
+    argv: process.argv.slice(2),
+    version: APP_VERSION,
+});
 if (arg === '--version' || arg === '-v' || arg === 'version') {
+    logInfo('cli.version', { version: APP_VERSION });
     console.log(APP_VERSION);
     process.exit(0);
 }
+process.on('uncaughtException', (error) => {
+    logError('process.uncaught_exception', error);
+});
+process.on('unhandledRejection', (reason) => {
+    logError('process.unhandled_rejection', reason);
+});
 startJarvis();

package/dist/config/constants.d.ts

@@ -3,7 +3,9 @@ export declare const APP_VERSION: string;
 export declare const PROJECT_NAME: string;
 /** Agentic Loop 最大迭代次数 */
 export declare const MAX_ITERATIONS = 50;
+export declare const JARVIS_HOME_DIR: string;
 export declare const SESSIONS_DIR: string;
+export declare const LOGS_DIR: string;
 /** 输入后是否隐藏 WelcomeHeader，默认 false（不隐藏） */
 export declare const HIDE_WELCOME_AFTER_INPUT = false;
 export declare const MODEL_NAME: string;

package/dist/config/constants.js

@@ -20,7 +20,9 @@ export const PROJECT_NAME = path.basename(process.cwd());
 export const MAX_ITERATIONS = 50;
 /** 会话存储目录（~/.jarvis/sessions/） */
 import os from 'os';
-export const SESSIONS_DIR = path.join(os.homedir(), '.jarvis', 'sessions');
+export const JARVIS_HOME_DIR = path.join(os.homedir(), '.jarvis');
+export const SESSIONS_DIR = path.join(JARVIS_HOME_DIR, 'sessions');
+export const LOGS_DIR = path.join(JARVIS_HOME_DIR, 'logs');
 /** 输入后是否隐藏 WelcomeHeader，默认 false（不隐藏） */
 export const HIDE_WELCOME_AFTER_INPUT = false;
 /** 从配置文件获取当前模型名称 */

package/dist/config/userProfile.d.ts

@@ -0,0 +1,4 @@
+export declare const USER_PROFILE_PATH: string;
+export declare function ensureJarvisHomeDir(): string;
+export declare function readUserProfile(): string;
+export declare function writeUserProfile(content: string): void;

package/dist/config/userProfile.js

@@ -0,0 +1,25 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+export const USER_PROFILE_PATH = path.join(os.homedir(), '.jarvis', 'USER.md');
+export function ensureJarvisHomeDir() {
+    const dir = path.dirname(USER_PROFILE_PATH);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    return dir;
+}
+export function readUserProfile() {
+    try {
+        if (!fs.existsSync(USER_PROFILE_PATH))
+            return '';
+        return fs.readFileSync(USER_PROFILE_PATH, 'utf-8').trim();
+    }
+    catch {
+        return '';
+    }
+}
+export function writeUserProfile(content) {
+    ensureJarvisHomeDir();
+    fs.writeFileSync(USER_PROFILE_PATH, content.trimEnd() + '\n', 'utf-8');
+}

package/dist/core/AgentMessageBus.d.ts

@@ -1,16 +1,3 @@
-/**
- * AgentMessageBus — SubAgent 间通讯总线（进程内单例）
- *
- * 提供发布/订阅机制，允许：
- *   - SubAgent 向命名频道发布消息
- *   - SubAgent 订阅频道，等待其他 Agent 发布的消息
- *   - 主 Agent 观察所有频道历史
- *
- * 线程安全说明：
- *   Node.js Worker 线程之间不共享内存，因此 MessageBus 运行在
- *   主线程（queryWorker）中，SubAgent Worker 通过 IPC 消息与其交互。
- *   SubAgentBridge 负责在主线程侧代理 publish/subscribe 请求。
- */
 export interface BusMessage {
     /** 发布者 Agent 标识 */
     from: string;

package/dist/core/AgentMessageBus.js

@@ -11,6 +11,7 @@
  *   主线程（queryWorker）中，SubAgent Worker 通过 IPC 消息与其交互。
  *   SubAgentBridge 负责在主线程侧代理 publish/subscribe 请求。
  */
+import { logInfo } from './logger.js';
 class AgentMessageBus {
     /** 频道历史消息，key = channel */
     history = new Map();
@@ -24,6 +25,11 @@ class AgentMessageBus {
      */
     publish(from, channel, payload) {
         const msg = { from, channel, payload, timestamp: Date.now() };
+        logInfo('bus.publish', {
+            from,
+            channel,
+            payloadLength: payload.length,
+        });
         // 存入历史
         if (!this.history.has(channel))
             this.history.set(channel, []);
@@ -48,10 +54,19 @@ class AgentMessageBus {
      * @param fromOffset 从第几条开始消费（0-based），不传则只等新消息
      */
     subscribe(channel, timeoutMs = 30_000, fromOffset) {
+        logInfo('bus.subscribe', {
+            channel,
+            timeoutMs,
+            fromOffset,
+        });
         // 如果指定了 offset 且历史中已有该位置之后的消息，立即返回
         if (fromOffset !== undefined) {
             const history = this.history.get(channel) ?? [];
             if (fromOffset < history.length) {
+                logInfo('bus.subscribe.hit_history', {
+                    channel,
+                    fromOffset,
+                });
                 return Promise.resolve(history[fromOffset]);
             }
         }
@@ -62,10 +77,16 @@ class AgentMessageBus {
                 if (list) {
                     this.waiters.set(channel, list.filter((w) => w.resolve !== resolve));
                 }
+                logInfo('bus.subscribe.timeout', { channel, timeoutMs, fromOffset });
                 resolve(null);
             }, timeoutMs);
             const wrappedResolve = (msg) => {
                 clearTimeout(timer);
+                logInfo('bus.subscribe.received', {
+                    channel,
+                    fromOffset,
+                    from: msg.from,
+                });
                 resolve(msg);
             };
             if (!this.waiters.has(channel))

package/dist/core/QueryEngine.d.ts

@@ -25,6 +25,7 @@ export declare class QueryEngine {
     registerUIBus(onMessage: (msg: Message) => void, onUpdateMessage: (id: string, updates: Partial<Message>) => void): void;
     private createSession;
     private ensureSessionDir;
+    private createService;
     /** 处理用户输入（在独立 Worker 线程中执行） */
     handleQuery(userInput: string, callbacks: EngineCallbacks): Promise<void>;
     /** 终止当前任务（通知 Worker 中断） */

package/dist/core/QueryEngine.js

@@ -9,32 +9,26 @@ import { SESSIONS_DIR } from '../config/constants.js';
 import { setActiveAgent } from '../config/agentState.js';
 import { clearAuthorizations } from './safeguard.js';
 import { agentUIBus } from './AgentRegistry.js';
+import { logError, logInfo, logWarn } from './logger.js';
+import { updateUserProfileFromInput } from '../services/userProfile.js';
 export class QueryEngine {
     service;
     session;
     transcript = [];
     workerBridge = new WorkerBridge();
     constructor() {
-        // 尝试从配置文件加载 LLM，失败则回退 MockService
-        const config = loadConfig();
-        const activeModel = getActiveModel(config);
-        if (activeModel) {
-            try {
-                this.service = new LLMServiceImpl();
-            }
-            catch {
-                this.service = new MockService();
-            }
-        }
-        else {
-            this.service = new MockService();
-        }
+        this.service = this.createService();
         this.session = this.createSession();
         this.ensureSessionDir();
+        logInfo('engine.created', {
+            sessionId: this.session.id,
+            service: this.service.constructor.name,
+        });
     }
     /** 注册持久 UI 回调，供后台 spawn_agent 子 Agent 推送消息 */
     registerUIBus(onMessage, onUpdateMessage) {
         agentUIBus.register(onMessage, onUpdateMessage);
+        logInfo('engine.ui_bus_registered', { sessionId: this.session.id });
     }
     createSession() {
         return {
@@ -51,8 +45,26 @@ export class QueryEngine {
             fs.mkdirSync(SESSIONS_DIR, { recursive: true });
         }
     }
+    createService() {
+        const config = loadConfig();
+        const activeModel = getActiveModel(config);
+        if (activeModel) {
+            try {
+                return new LLMServiceImpl();
+            }
+            catch {
+                return new MockService();
+            }
+        }
+        return new MockService();
+    }
     /** 处理用户输入（在独立 Worker 线程中执行） */
     async handleQuery(userInput, callbacks) {
+        logInfo('query.received', {
+            sessionId: this.session.id,
+            inputLength: userInput.length,
+            preview: userInput.slice(0, 200),
+        });
         const userMsg = {
             id: uuid(),
             type: 'user',
@@ -62,6 +74,12 @@ export class QueryEngine {
         };
         callbacks.onMessage(userMsg);
         this.session.messages.push(userMsg);
+        if (this.transcript.length === 0) {
+            const updated = await updateUserProfileFromInput(userInput);
+            if (updated) {
+                this.service = this.createService();
+            }
+        }
         // 将回调包装后传给 WorkerBridge，Worker 事件会映射回这里
         const bridgeCallbacks = {
             onMessage: (msg) => {
@@ -87,8 +105,14 @@ export class QueryEngine {
         };
         try {
             this.transcript = await this.workerBridge.run(userInput, this.transcript, bridgeCallbacks);
+            logInfo('query.completed', {
+                sessionId: this.session.id,
+                transcriptLength: this.transcript.length,
+                totalTokens: this.session.totalTokens,
+            });
         }
         catch (err) {
+            logError('query.failed', err, { sessionId: this.session.id });
             const errMsg = {
                 id: uuid(),
                 type: 'error',
@@ -104,10 +128,12 @@ export class QueryEngine {
     }
     /** 终止当前任务（通知 Worker 中断） */
     abort() {
+        logWarn('query.abort_requested', { sessionId: this.session.id });
         this.workerBridge.abort();
     }
     /** 重置会话 */
     reset() {
+        logInfo('session.reset', { sessionId: this.session.id });
         this.saveSession();
         this.session = this.createSession();
         this.transcript = [];
@@ -117,25 +143,22 @@ export class QueryEngine {
      * 切换智能体：持久化选择 + 重建 LLM service + 重置会话
      */
     switchAgent(agentName) {
+        logInfo('agent.switch.start', {
+            fromSessionId: this.session.id,
+            agentName,
+        });
         setActiveAgent(agentName);
         // 重建 LLM service 以加载新 agent 的 system prompt
-        const config = loadConfig();
-        const activeModel = getActiveModel(config);
-        if (activeModel) {
-            try {
-                this.service = new LLMServiceImpl();
-            }
-            catch {
-                this.service = new MockService();
-            }
-        }
-        else {
-            this.service = new MockService();
-        }
+        this.service = this.createService();
         // 重置会话上下文
         this.saveSession();
         this.session = this.createSession();
         this.transcript = [];
+        logInfo('agent.switch.completed', {
+            sessionId: this.session.id,
+            agentName,
+            service: this.service.constructor.name,
+        });
     }
     /** 保存会话到文件 */
     saveSession() {
@@ -149,8 +172,15 @@ export class QueryEngine {
             }
             const filePath = path.join(SESSIONS_DIR, `${this.session.id}.json`);
             fs.writeFileSync(filePath, JSON.stringify(this.session, null, 2), 'utf-8');
+            logInfo('session.saved', {
+                sessionId: this.session.id,
+                filePath,
+                messageCount: this.session.messages.length,
+            });
+        }
+        catch (error) {
+            logError('session.save_failed', error, { sessionId: this.session.id });
         }
-        catch { /* 静默失败 */ }
     }
     /** 列出所有历史会话（按更新时间倒序），返回摘要信息 */
     static listSessions() {
@@ -221,9 +251,15 @@ export class QueryEngine {
                     });
                 }
             }
+            logInfo('session.loaded', {
+                sessionId,
+                messageCount: cleanedMessages.length,
+                transcriptLength: this.transcript.length,
+            });
             return { session: this.session, messages: cleanedMessages };
         }
-        catch {
+        catch (error) {
+            logError('session.load_failed', error, { sessionId });
             return null;
         }
     }
@@ -250,9 +286,14 @@ export class QueryEngine {
                 }
                 catch { /* 跳过删除失败的文件 */ }
             }
+            logInfo('session.clear_others', {
+                sessionId: this.session.id,
+                removedCount: count,
+            });
             return count;
         }
-        catch {
+        catch (error) {
+            logError('session.clear_others_failed', error, { sessionId: this.session.id });
             return 0;
         }
     }

package/dist/core/SubAgentBridge.js

@@ -12,6 +12,7 @@ import { Worker } from 'worker_threads';
 import { fileURLToPath } from 'url';
 import path from 'path';
 import { agentMessageBus } from './AgentMessageBus.js';
+import { logError, logInfo, logWarn } from './logger.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 /** 创建 SubAgent Worker（兼容 tsx 开发模式与编译后 .js） */
@@ -42,6 +43,10 @@ export class SubAgentBridge {
         return new Promise((resolve, reject) => {
             const worker = createSubAgentWorker();
             this.worker = worker;
+            logInfo('subagent_bridge.run.start', {
+                taskId: task.taskId,
+                allowedTools: task.allowedTools,
+            });
             // 收集 SubAgent 产生的所有消息，用于汇总结果
             const collectedMessages = [];
             let finalTranscript = [];
@@ -125,6 +130,11 @@ export class SubAgentBridge {
                         finalTranscript = msg.transcript;
                         this.worker = null;
                         worker.terminate();
+                        logInfo('subagent_bridge.run.done', {
+                            taskId: msg.taskId,
+                            transcriptLength: msg.transcript.length,
+                            messageCount: collectedMessages.length,
+                        });
                         // 从 transcript 中提取最终输出文本
                         resolve({
                             taskId: msg.taskId,
@@ -137,6 +147,10 @@ export class SubAgentBridge {
                     case 'error':
                         this.worker = null;
                         worker.terminate();
+                        logError('subagent_bridge.run.failed', msg.message, {
+                            taskId: msg.taskId,
+                            messageCount: collectedMessages.length,
+                        });
                         resolve({
                             taskId: msg.taskId,
                             status: 'error',
@@ -150,12 +164,14 @@ export class SubAgentBridge {
             });
             worker.on('error', (err) => {
                 this.worker = null;
+                logError('subagent_bridge.worker_error', err, { taskId: task.taskId });
                 reject(err);
             });
             worker.on('exit', (code) => {
                 if (this.worker) {
                     // Worker 退出但未发送 done/error，说明异常终止
                     this.worker = null;
+                    logError('subagent_bridge.worker_exit_abnormal', undefined, { taskId: task.taskId, code });
                     reject(new Error(`SubAgent Worker 意外退出，code=${code}`));
                 }
             });
@@ -166,6 +182,7 @@ export class SubAgentBridge {
     /** 中断 SubAgent 执行 */
     abort() {
         if (this.worker) {
+            logWarn('subagent_bridge.abort_forwarded');
             const msg = { type: 'abort' };
             this.worker.postMessage(msg);
         }

package/dist/core/WorkerBridge.js

@@ -7,6 +7,7 @@ import { fileURLToPath } from 'url';
 import path from 'path';
 import { agentMessageBus } from './AgentMessageBus.js';
 import { spawnSubAgentInMainThread } from '../tools/spawnAgent.js';
+import { logError, logInfo, logWarn } from './logger.js';
 // 兼容 ESM __dirname
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -41,6 +42,10 @@ export class WorkerBridge {
             const workerTsPath = path.join(__dirname, 'queryWorker.ts');
             const worker = createWorker(workerTsPath);
             this.worker = worker;
+            logInfo('worker_bridge.run.start', {
+                inputLength: userInput.length,
+                transcriptLength: transcript.length,
+            });
             worker.on('message', async (msg) => {
                 switch (msg.type) {
                     case 'message':
@@ -143,22 +148,28 @@ export class WorkerBridge {
                     case 'done':
                         this.worker = null;
                         worker.terminate();
+                        logInfo('worker_bridge.run.done', {
+                            transcriptLength: msg.transcript.length,
+                        });
                         resolve(msg.transcript);
                         break;
                     case 'error':
                         this.worker = null;
                         worker.terminate();
+                        logError('worker_bridge.run.error', msg.message);
                         reject(new Error(msg.message));
                         break;
                 }
             });
             worker.on('error', (err) => {
                 this.worker = null;
+                logError('worker_bridge.worker_error', err);
                 reject(err);
             });
             worker.on('exit', (code) => {
                 if (code !== 0 && this.worker) {
                     this.worker = null;
+                    logError('worker_bridge.worker_exit_abnormal', undefined, { code });
                     reject(new Error(`Worker 异常退出，code=${code}`));
                 }
             });
@@ -170,6 +181,7 @@ export class WorkerBridge {
     /** 向 Worker 发送中断信号 */
     abort() {
         if (this.worker) {
+            logWarn('worker_bridge.abort_forwarded');
             const msg = { type: 'abort' };
             this.worker.postMessage(msg);
         }

package/dist/core/logger.d.ts

@@ -0,0 +1,8 @@
+export type LogLevel = 'INFO' | 'WARN' | 'ERROR';
+export interface LogPayload {
+    [key: string]: unknown;
+}
+export declare function ensureLoggerReady(): string;
+export declare function logInfo(event: string, payload?: LogPayload): void;
+export declare function logWarn(event: string, payload?: LogPayload): void;
+export declare function logError(event: string, error?: unknown, payload?: LogPayload): void;

package/dist/core/logger.js

@@ -0,0 +1,63 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { isMainThread, threadId } from 'worker_threads';
+function resolveLogsDir() {
+    return path.join(os.homedir(), '.jarvis', 'logs');
+}
+function ensureLogsDir() {
+    const logsDir = resolveLogsDir();
+    if (!fs.existsSync(logsDir)) {
+        fs.mkdirSync(logsDir, { recursive: true });
+    }
+    return logsDir;
+}
+function getLogFilePath(date = new Date()) {
+    const logsDir = ensureLogsDir();
+    const day = date.toISOString().slice(0, 10);
+    return path.join(logsDir, `${day}.log`);
+}
+function normalizeError(error) {
+    if (error instanceof Error) {
+        return {
+            name: error.name,
+            message: error.message,
+            stack: error.stack,
+        };
+    }
+    return { message: String(error) };
+}
+function writeLog(level, event, payload = {}) {
+    try {
+        const now = new Date();
+        const line = JSON.stringify({
+            timestamp: now.toISOString(),
+            level,
+            event,
+            pid: process.pid,
+            threadId,
+            workerType: isMainThread ? 'main' : 'worker',
+            cwd: process.cwd(),
+            ...payload,
+        });
+        fs.appendFileSync(getLogFilePath(now), `${line}\n`, 'utf-8');
+    }
+    catch {
+        // 日志系统自身不能影响主流程
+    }
+}
+export function ensureLoggerReady() {
+    return ensureLogsDir();
+}
+export function logInfo(event, payload) {
+    writeLog('INFO', event, payload);
+}
+export function logWarn(event, payload) {
+    writeLog('WARN', event, payload);
+}
+export function logError(event, error, payload = {}) {
+    writeLog('ERROR', event, {
+        ...payload,
+        ...(error !== undefined ? { error: normalizeError(error) } : {}),
+    });
+}

package/dist/core/query.js

@@ -5,6 +5,7 @@ import path from 'path';
 import { findToolMerged as findTool } from '../tools/index.js';
 import { MAX_ITERATIONS, CONTEXT_TOKEN_LIMIT } from '../config/constants.js';
 import { sanitizeOutput, validateCommand, authorizeCommand, authorizeRule } from './safeguard.js';
+import { logError, logInfo, logWarn } from './logger.js';
 // 兼容 ESM __dirname
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -74,6 +75,10 @@ function compressTranscript(transcript) {
  * 单轮 Agentic Loop：推理 → 工具调用 → 循环
  */
 export async function executeQuery(userInput, transcript, _tools, service, callbacks, abortSignal) {
+    logInfo('agent_loop.start', {
+        inputLength: userInput.length,
+        initialTranscriptLength: transcript.length,
+    });
     const localTranscript = [...transcript];
     localTranscript.push({ role: 'user', content: userInput });
     const loopState = {
@@ -85,8 +90,19 @@ export async function executeQuery(userInput, transcript, _tools, service, callb
     callbacks.onLoopStateChange({ ...loopState });
     while (loopState.iteration < MAX_ITERATIONS && !abortSignal.aborted) {
         loopState.iteration++;
+        logInfo('agent_loop.iteration.start', {
+            iteration: loopState.iteration,
+            transcriptLength: localTranscript.length,
+        });
         callbacks.onLoopStateChange({ ...loopState });
         const result = await runOneIteration(compressTranscript(localTranscript), _tools, service, callbacks, abortSignal);
+        logInfo('agent_loop.iteration.result', {
+            iteration: loopState.iteration,
+            textLength: result.text.length,
+            toolCallCount: result.toolCalls.length,
+            duration: result.duration,
+            tokenCount: result.tokenCount,
+        });
         // 构建 assistant transcript 块
         const assistantBlocks = [];
         if (result.text)
@@ -102,6 +118,10 @@ export async function executeQuery(userInput, transcript, _tools, service, callb
             break;
         // 中断发生在推理阶段
         if (abortSignal.aborted) {
+            logWarn('agent_loop.aborted_before_tool_execution', {
+                iteration: loopState.iteration,
+                toolCallCount: result.toolCalls.length,
+            });
             for (const tc of result.toolCalls) {
                 const skippedResult = `[用户中断] 工具 ${tc.name} 未执行（用户按下 ESC 中断）`;
                 localTranscript.push({ role: 'tool_result', toolUseId: tc.id, content: skippedResult });
@@ -145,11 +165,20 @@ export async function executeQuery(userInput, transcript, _tools, service, callb
     loopState.aborted = abortSignal.aborted;
     callbacks.onLoopStateChange({ ...loopState });
     if (abortSignal.aborted) {
+        logWarn('agent_loop.aborted', {
+            finalIteration: loopState.iteration,
+            transcriptLength: localTranscript.length,
+        });
         localTranscript.push({
             role: 'user',
             content: '[系统提示] 用户中断了上一轮回复（按下 ESC）。上一条助手消息可能不完整，请在后续回复中注意这一点。',
         });
     }
+    logInfo('agent_loop.done', {
+        finalIteration: loopState.iteration,
+        aborted: abortSignal.aborted,
+        transcriptLength: localTranscript.length,
+    });
     return localTranscript;
 }
 /** 执行一次 LLM 调用 */
@@ -161,6 +190,10 @@ async function runOneIteration(transcript, tools, service, callbacks, abortSigna
     let tokenCount = 0;
     let firstTokenTime = null;
     const thinkingId = uuid();
+    logInfo('llm.iteration.requested', {
+        transcriptLength: transcript.length,
+        toolCount: tools.length,
+    });
     callbacks.onMessage({
         id: thinkingId,
         type: 'thinking',
@@ -268,6 +301,15 @@ async function runOneIteration(transcript, tools, service, callbacks, abortSigna
         });
     }
     const effectiveText = accumulatedText || (accumulatedThinking && toolCalls.length === 0 ? accumulatedThinking : '');
+    logInfo('llm.iteration.completed', {
+        duration,
+        tokenCount,
+        firstTokenLatency,
+        tokensPerSecond,
+        textLength: effectiveText.length,
+        thinkingLength: accumulatedThinking.length,
+        toolCallCount: toolCalls.length,
+    });
     return { text: effectiveText, toolCalls, duration, tokenCount, firstTokenLatency, tokensPerSecond };
 }
 // ===== 并行执行判断 =====
@@ -358,17 +400,27 @@ export async function runToolDirect(tc, abortSignal) {
     if (!tool)
         return `错误: 未知工具 ${tc.name}`;
     try {
+        logInfo('tool.direct.start', { toolName: tc.name, toolArgs: tc.input });
         const result = await tool.execute(tc.input, abortSignal);
         const { sanitizeOutput } = await import('./safeguard.js');
+        logInfo('tool.direct.done', {
+            toolName: tc.name,
+            resultLength: String(result).length,
+        });
         return sanitizeOutput(result);
     }
     catch (err) {
+        logError('tool.direct.failed', err, { toolName: tc.name, toolArgs: tc.input });
         return `错误: ${err.message || '工具执行失败'}`;
     }
 }
 /** 并行执行多个工具，每个工具在独立 Worker 线程中运行，实时更新 UI */
 async function executeToolsInParallel(calls, callbacks, abortSignal) {
     const groupId = uuid();
+    logInfo('tool.parallel_group.start', {
+        groupId,
+        toolNames: calls.map((call) => call.name),
+    });
     // 为每个工具预先创建 pending 消息节点（TUI 立即渲染占位）
     const msgIds = calls.map((tc) => {
         const msgId = uuid();
@@ -433,11 +485,18 @@ async function executeToolsInParallel(calls, callbacks, abortSignal) {
         }
         catch (err) {
             const errMsg = err.message || '工具执行失败';
+            logError('tool.parallel.failed', err, { groupId, toolName: tc.name, toolArgs: tc.input });
             callbacks.onUpdateMessage(msgId, { status: 'error', content: errMsg, toolResult: errMsg });
             return { tc, content: `错误: ${errMsg}`, isError: false };
         }
     });
-    return Promise.all(tasks);
+    const results = await Promise.all(tasks);
+    logInfo('tool.parallel_group.done', {
+        groupId,
+        toolNames: calls.map((call) => call.name),
+        errorCount: results.filter((item) => item.isError).length,
+    });
+    return results;
 }
 /** 执行工具并返回结果 */
 async function executeTool(tc, callbacks, abortSignal) {
@@ -462,6 +521,11 @@ async function executeTool(tc, callbacks, abortSignal) {
         toolName: tc.name,
         toolArgs: tc.input,
     });
+    logInfo('tool.execute.start', {
+        toolName: tc.name,
+        toolArgs: tc.input,
+        toolExecId,
+    });
     // ===== 安全围栏：Bash 命令拦截 + 交互式确认 =====
     if (tc.name === 'Bash' && tc.input.command) {
         const command = tc.input.command;
@@ -470,6 +534,7 @@ async function executeTool(tc, callbacks, abortSignal) {
             if (!check.canOverride) {
                 // critical 级别：直接禁止
                 const errMsg = `${check.reason}\n🚫 该命令已被永久禁止，无法通过授权绕过。\n命令: ${command}`;
+                logWarn('tool.execute.blocked', { toolName: tc.name, command, reason: check.reason });
                 callbacks.onUpdateMessage(toolExecId, { status: 'error', content: errMsg, toolResult: errMsg });
                 return { content: `错误: ${errMsg}`, isError: true };
             }
@@ -480,6 +545,7 @@ async function executeTool(tc, callbacks, abortSignal) {
                 const userChoice = await callbacks.onConfirmDangerousCommand(command, reason, ruleName);
                 if (userChoice === 'cancel') {
                     const cancelMsg = `⛔ 用户取消执行危险命令: ${command}`;
+                    logWarn('tool.execute.cancelled_by_user', { toolName: tc.name, command, reason });
                     callbacks.onUpdateMessage(toolExecId, { status: 'error', content: cancelMsg, toolResult: cancelMsg });
                     return { content: cancelMsg, isError: true };
                 }
@@ -502,6 +568,7 @@ async function executeTool(tc, callbacks, abortSignal) {
     const tool = findTool(tc.name);
     if (!tool) {
         const errMsg = `未知工具: ${tc.name}`;
+        logWarn('tool.execute.unknown', { toolName: tc.name });
         callbacks.onUpdateMessage(toolExecId, { status: 'error', content: errMsg });
         return { content: errMsg, isError: true };
     }
@@ -539,10 +606,22 @@ async function executeTool(tc, callbacks, abortSignal) {
             duration: Date.now() - start,
             ...(wasAborted ? { abortHint: '命令已中断（ESC）' } : {}),
         });
+        logInfo('tool.execute.done', {
+            toolName: tc.name,
+            toolExecId,
+            duration: Date.now() - start,
+            aborted: Boolean(wasAborted),
+            resultLength: safeResult.length,
+        });
         return { content: safeResult, isError: false };
     }
     catch (err) {
         const errMsg = err.message || '工具执行失败';
+        logError('tool.execute.failed', err, {
+            toolName: tc.name,
+            toolArgs: tc.input,
+            toolExecId,
+        });
         callbacks.onUpdateMessage(toolExecId, {
             status: 'error',
             content: errMsg,

package/dist/core/queryWorker.js

@@ -10,8 +10,10 @@ import { MockService } from '../services/api/mock.js';
 import { loadConfig, getActiveModel } from '../config/loader.js';
 import { pendingBusRequests } from './workerBusProxy.js';
 import { pendingSpawnRequests } from './spawnRegistry.js';
+import { logError, logInfo, logWarn } from './logger.js';
 if (!parentPort)
     throw new Error('queryWorker must run inside worker_threads');
+logInfo('query_worker.ready');
 // ===== 初始化 LLM 服务 =====
 const config = loadConfig();
 const activeModel = getActiveModel(config);
@@ -30,6 +32,7 @@ const pendingConfirms = new Map();
 parentPort.on('message', async (msg) => {
     if (msg.type === 'abort') {
         abortSignal.aborted = true;
+        logWarn('query_worker.abort_received');
         return;
     }
     if (msg.type === 'danger_confirm_result') {
@@ -73,6 +76,10 @@ parentPort.on('message', async (msg) => {
     }
     if (msg.type === 'run') {
         abortSignal.aborted = false;
+        logInfo('query_worker.run.start', {
+            inputLength: msg.userInput.length,
+            transcriptLength: msg.transcript.length,
+        });
         const send = (out) => parentPort.postMessage(out);
         const callbacks = {
             onMessage: (m) => send({ type: 'message', msg: m }),
@@ -92,9 +99,13 @@ parentPort.on('message', async (msg) => {
         };
         try {
             const newTranscript = await executeQuery(msg.userInput, msg.transcript, getAllTools(), service, callbacks, abortSignal);
+            logInfo('query_worker.run.done', {
+                transcriptLength: newTranscript.length,
+            });
             send({ type: 'done', transcript: newTranscript });
         }
         catch (err) {
+            logError('query_worker.run.failed', err);
             send({ type: 'error', message: err.message ?? '未知错误' });
         }
     }

package/dist/core/subAgentWorker.js

@@ -15,8 +15,10 @@ import { LLMServiceImpl, fromModelConfig } from '../services/api/llm.js';
 import { MockService } from '../services/api/mock.js';
 import { loadConfig, getActiveModel } from '../config/loader.js';
 import { pendingBusRequests } from './workerBusProxy.js';
+import { logError, logInfo, logWarn } from './logger.js';
 if (!parentPort)
     throw new Error('subAgentWorker must run inside worker_threads');
+logInfo('subagent_worker.ready');
 // ===== 初始化 LLM 服务 =====
 const config = loadConfig();
 const activeModel = getActiveModel(config);
@@ -43,6 +45,7 @@ const pendingConfirms = new Map();
 parentPort.on('message', async (msg) => {
     if (msg.type === 'abort') {
         abortSignal.aborted = true;
+        logWarn('subagent_worker.abort_received');
         return;
     }
     if (msg.type === 'danger_confirm_result') {
@@ -79,6 +82,12 @@ parentPort.on('message', async (msg) => {
         abortSignal.aborted = false;
         const { task } = msg;
         const { taskId, instruction, allowedTools, contextTranscript, role, systemPrompt } = task;
+        logInfo('subagent_worker.run.start', {
+            taskId,
+            inputLength: instruction.length,
+            allowedTools,
+            transcriptLength: contextTranscript?.length ?? 0,
+        });
         const send = (out) => parentPort.postMessage(out);
         const service = buildSubAgentService(role, systemPrompt);
         const tools = getAllTools().filter((t) => !allowedTools || allowedTools.length === 0 || allowedTools.includes(t.name));
@@ -98,9 +107,14 @@ parentPort.on('message', async (msg) => {
         };
         try {
             const newTranscript = await executeQuery(instruction, contextTranscript ?? [], tools, service, callbacks, abortSignal);
+            logInfo('subagent_worker.run.done', {
+                taskId,
+                transcriptLength: newTranscript.length,
+            });
             send({ type: 'done', taskId, transcript: newTranscript });
         }
         catch (err) {
+            logError('subagent_worker.run.failed', err, { taskId });
             send({ type: 'error', taskId, message: err.message ?? '未知错误' });
         }
     }

package/dist/index.js

@@ -1,6 +1,8 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { render } from 'ink';
+import { logInfo } from './core/logger.js';
 import REPL from './screens/repl.js';
 export function startJarvis() {
+    logInfo('app.render.start');
     render(_jsx(REPL, {}), { exitOnCtrlC: false });
 }

package/dist/screens/repl.js

@@ -21,6 +21,7 @@ import { QueryEngine } from '../core/QueryEngine.js';
 import { HIDE_WELCOME_AFTER_INPUT } from '../config/constants.js';
 import { generateAgentHint } from '../core/hint.js';
 import { subscribeAgentCount, getActiveAgentCount } from '../core/spawnRegistry.js';
+import { logError, logInfo, logWarn } from '../core/logger.js';
 export default function REPL() {
     const { exit } = useApp();
     const width = useTerminalWidth();
@@ -45,6 +46,7 @@ export default function REPL() {
     const { displayTokens, tokenCountRef, startTokenTimer, stopTokenTimer, updateTokenCount, syncTokenDisplay, resetTokens, } = useTokenDisplay();
     // ===== 新会话逻辑 =====
     const handleNewSession = useCallback(() => {
+        logInfo('ui.new_session');
         if (engineRef.current) {
             engineRef.current.reset();
             sessionRef.current = engineRef.current.getSession();
@@ -74,8 +76,13 @@ export default function REPL() {
         // 注册持久 UI 回调，供 spawn_agent 后台子 Agent 跨轮次推送消息
         engineRef.current.registerUIBus((msg) => setMessages((prev) => [...prev, msg]), (id, updates) => setMessages((prev) => prev.map((m) => (m.id === id ? { ...m, ...updates } : m))));
         generateAgentHint().then((hint) => setPlaceholder(hint)).catch((err) => {
+            logError('ui.hint.init_failed', err);
             console.error('[hint] 初始化提示失败:', err);
         });
+        logInfo('ui.repl.mounted');
+        return () => {
+            logInfo('ui.repl.unmounted');
+        };
     }, []);
     // 订阅后台 SubAgent 计数变化
     useEffect(() => {
@@ -141,6 +148,10 @@ export default function REPL() {
         const trimmed = value.trim();
         if (!trimmed || isProcessing || !engineRef.current)
             return;
+        logInfo('ui.submit', {
+            inputLength: trimmed.length,
+            isSlashCommand: trimmed.startsWith('/'),
+        });
         if (trimmed.startsWith('/')) {
             const parts = trimmed.slice(1).split(/\s+/);
             const cmdName = parts[0].toLowerCase();
@@ -359,12 +370,15 @@ export default function REPL() {
             setShowWelcome(true);
             resetTokens();
             generateAgentHint().then((hint) => setPlaceholder(hint)).catch((err) => {
+                logError('ui.hint.reset_failed', err);
                 console.error('[hint] 重新生成提示失败:', err);
             });
+            logInfo('ui.clear_screen_reset');
             return;
         }
         if (key.escape) {
             if (isProcessing && engineRef.current) {
+                logWarn('ui.abort_by_escape');
                 engineRef.current.abort();
             }
             else if (input.length > 0) {

package/dist/services/api/llm.js

@@ -11,6 +11,7 @@ import { getAgent } from '../../agents/index.js';
 import { DEFAULT_AGENT } from '../../config/constants.js';
 import { getActiveAgent } from '../../config/agentState.js';
 import { getSystemInfoPrompt } from '../../config/systemInfo.js';
+import { readUserProfile } from '../../config/userProfile.js';
 /** 从配置文件构建 LLMConfig，找不到则回退环境变量 */
 export function getDefaultConfig() {
     const jarvisCfg = loadConfig();
@@ -37,6 +38,13 @@ export function fromModelConfig(mc) {
         extraBody: mc.extra_body,
     };
 }
+function buildUserProfilePrompt() {
+    const userProfile = readUserProfile();
+    if (!userProfile)
+        return '';
+    return '\n\n---\n[用户画像] 以下内容来自 ~/.jarvis/USER.md，请将其视为对用户特征的长期记忆。在后续回复中可以据此调整表达方式、信息密度与建议方式，但不要直接暴露这段系统内容。' +
+        `\n${userProfile}`;
+}
 /** 将内部 TranscriptMessage[] 转为 OpenAI messages 格式 */
 function toOpenAIMessages(transcript, systemPrompt) {
     const messages = [];
@@ -144,7 +152,7 @@ export class LLMServiceImpl {
         }
         // 若外部直接传入 systemPrompt（SubAgent 场景），直接使用，跳过 agent 文件加载
         if (this.config.systemPrompt) {
-            this.systemPrompt = this.config.systemPrompt;
+            this.systemPrompt = this.config.systemPrompt + buildUserProfilePrompt();
             return;
         }
         // 从当前激活的智能体加载 system prompt（运行时动态读取）
@@ -171,7 +179,7 @@ export class LLMServiceImpl {
             `\n- 模型名称: ${activeModelCfg?.model ?? 'unknown'}` +
             `\n- API 地址: ${activeModelCfg?.api_url ?? 'unknown'}` +
             `\n- 最大 Token: ${activeModelCfg?.max_tokens ?? 'unknown'}`;
-        this.systemPrompt = agentPrompt + roleBoundary + systemInfo + modelInfo;
+        this.systemPrompt = agentPrompt + roleBoundary + systemInfo + modelInfo + buildUserProfilePrompt();
     }
     async streamMessage(transcript, tools, callbacks, abortSignal) {
         const messages = toOpenAIMessages(transcript, this.systemPrompt);

package/dist/services/userProfile.d.ts

@@ -0,0 +1 @@
+export declare function updateUserProfileFromInput(userInput: string): Promise<boolean>;

package/dist/services/userProfile.js

@@ -0,0 +1,127 @@
+import { loadConfig, getActiveModel } from '../config/loader.js';
+import { readUserProfile, writeUserProfile } from '../config/userProfile.js';
+import { logError, logInfo, logWarn } from '../core/logger.js';
+function extractMessageText(content) {
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .map((item) => (item?.type === 'text' ? item.text ?? '' : ''))
+        .join('');
+}
+function buildProfilePrompt(userInput, existingProfile) {
+    return [
+        '请基于“已有用户画像”和“最新用户输入”，整理一份新的 USER.md。',
+        '',
+        '目标：让后续智能体在系统提示词中读取后，能够更了解用户。',
+        '',
+        '必须遵守：',
+        '1. 只保留对后续交互有帮助的信息。',
+        '2. 有明确依据的内容写成确定描述；只有弱信号时写成“可能/倾向于”。',
+        '3. 没有依据时明确写“未知”，不要编造职业、年龄、经历。',
+        '4. 输出必须是中文 Markdown，不要输出代码块围栏，不要解释你的推理过程。',
+        '5. 画像应简洁稳定，避免复述用户原话。',
+        '',
+        '请严格按下面结构输出：',
+        '# 用户画像',
+        '## 基本信息',
+        '- 职业：',
+        '- 年龄阶段：',
+        '- 所在地区：',
+        '- 语言偏好：',
+        '',
+        '## 思维与沟通',
+        '- 思维习惯：',
+        '- 沟通风格：',
+        '- 决策偏好：',
+        '',
+        '## 能力与背景',
+        '- 技术背景：',
+        '- 专业领域：',
+        '- 熟悉工具：',
+        '',
+        '## 当前关注点',
+        '- 长期目标：',
+        '- 近期任务倾向：',
+        '- 约束与偏好：',
+        '',
+        '## 交互建议',
+        '- 回答策略：',
+        '- 需要避免：',
+        '',
+        '## 置信说明',
+        '- 高置信信息：',
+        '- 低置信推断：',
+        '- 明显未知：',
+        '',
+        '---',
+        '已有用户画像：',
+        existingProfile || '(暂无)',
+        '',
+        '最新用户输入：',
+        userInput,
+    ].join('\n');
+}
+export async function updateUserProfileFromInput(userInput) {
+    const normalizedInput = userInput.trim();
+    if (!normalizedInput)
+        return false;
+    const config = loadConfig();
+    const activeModel = getActiveModel(config);
+    if (!activeModel) {
+        logWarn('user_profile.skip.no_active_model');
+        return false;
+    }
+    const prompt = buildProfilePrompt(normalizedInput, readUserProfile());
+    const body = {
+        model: activeModel.model,
+        messages: [
+            {
+                role: 'system',
+                content: '你是一个严谨的用户画像整理助手，负责维护 ~/.jarvis/USER.md。输出必须是可直接写入文件的 Markdown 正文。',
+            },
+            {
+                role: 'user',
+                content: prompt,
+            },
+        ],
+        max_tokens: Math.min(activeModel.max_tokens ?? 4096, 1200),
+        temperature: 0.2,
+        stream: false,
+    };
+    if (activeModel.extra_body) {
+        Object.assign(body, activeModel.extra_body);
+    }
+    try {
+        const response = await fetch(activeModel.api_url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${activeModel.api_key}`,
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => '');
+            throw new Error(`API 错误 ${response.status}: ${errorText.slice(0, 300)}`);
+        }
+        const data = await response.json();
+        const content = extractMessageText(data.choices?.[0]?.message?.content).trim();
+        if (!content) {
+            throw new Error('用户画像生成结果为空');
+        }
+        writeUserProfile(content);
+        logInfo('user_profile.updated', {
+            inputLength: normalizedInput.length,
+            outputLength: content.length,
+        });
+        return true;
+    }
+    catch (error) {
+        logError('user_profile.update_failed', error, {
+            inputLength: normalizedInput.length,
+        });
+        return false;
+    }
+}

package/dist/tools/runCommand.js

@@ -1,10 +1,12 @@
 import { exec } from 'child_process';
 import { sanitizeOutput } from '../core/safeguard.js';
+import { logError, logInfo, logWarn } from '../core/logger.js';
 /**
  * 异步执行命令，支持通过 abortSignal 中断子进程
  */
 function execAsync(command, options, abortSignal) {
     return new Promise((resolve, reject) => {
+        logInfo('bash.exec.start', { command });
         const child = exec(command, options, (error, stdout, stderr) => {
             // 清理轮询
             if (pollTimer !== null)
@@ -12,6 +14,10 @@ function execAsync(command, options, abortSignal) {
             // 被中断时直接返回已有输出，不视为错误
             if (abortSignal?.aborted) {
                 const partial = sanitizeOutput(String(stdout ?? '').trim());
+                logWarn('bash.exec.aborted', {
+                    command,
+                    stdoutLength: String(stdout ?? '').length,
+                });
                 resolve(partial ? `(命令被中断)\n${partial}` : '(命令被中断)');
                 return;
             }
@@ -25,9 +31,18 @@ function execAsync(command, options, abortSignal) {
                     parts.push(`[exit code] ${error.code}`);
                 if (parts.length === 0)
                     parts.push(error.message);
+                logError('bash.exec.failed', error, {
+                    command,
+                    stdoutLength: String(stdout ?? '').length,
+                    stderrLength: String(stderr ?? '').length,
+                });
                 reject(new Error(`命令执行失败:\n${parts.join('\n')}`));
                 return;
             }
+            logInfo('bash.exec.done', {
+                command,
+                stdoutLength: String(stdout ?? '').length,
+            });
             resolve(sanitizeOutput(String(stdout).trim()) || '(命令执行完成，无输出)');
         });
         // 轮询 abortSignal，检测到中断时 kill 子进程
@@ -38,6 +53,7 @@ function execAsync(command, options, abortSignal) {
                     if (pollTimer !== null)
                         clearInterval(pollTimer);
                     pollTimer = null;
+                    logWarn('bash.exec.kill_requested', { command, pid: child.pid });
                     // 先尝试 SIGTERM，给进程优雅退出的机会
                     try {
                         child.kill('SIGTERM');

package/dist/tools/spawnAgent.js

@@ -15,6 +15,7 @@ import { agentUIBus } from '../core/AgentRegistry.js';
 import { agentMessageBus } from '../core/AgentMessageBus.js';
 import { getBus } from '../core/busAccess.js';
 import { pendingSpawnRequests, incrementActiveAgents, decrementActiveAgents } from '../core/spawnRegistry.js';
+import { logError, logInfo } from '../core/logger.js';
 /** 运行中的 task_id 集合（主线程侧，防止重复启动） */
 const runningAgents = new Set();
 function resolveAgentLabel(taskId, role) {
@@ -31,12 +32,18 @@ function resolveAgentLabel(taskId, role) {
  */
 export function spawnSubAgentInMainThread(taskId, instruction, agentLabel, allowedTools) {
     if (runningAgents.has(taskId)) {
+        logInfo('spawn_agent.duplicate', { taskId, agentLabel });
         return `子 Agent [${taskId}] 已在运行中，请使用 send_to_agent 向其发送消息，或使用不同的 task_id 启动新实例。`;
     }
     const replyChannel = `agent-reply:${taskId}`;
     const bridge = new SubAgentBridge();
     runningAgents.add(taskId);
     incrementActiveAgents();
+    logInfo('spawn_agent.started', {
+        taskId,
+        agentLabel,
+        allowedTools,
+    });
     bridge.run({ taskId, instruction, allowedTools }, {
         onMessage: (_tid, msg) => {
             const tagged = { ...msg, subAgentId: agentLabel };
@@ -51,10 +58,20 @@ export function spawnSubAgentInMainThread(taskId, instruction, agentLabel, allow
     }).then((result) => {
         runningAgents.delete(taskId);
         decrementActiveAgents();
+        logInfo('spawn_agent.done', {
+            taskId,
+            agentLabel,
+            status: result.status,
+            outputLength: result.output.length,
+        });
         agentMessageBus.publish(taskId, replyChannel, `[AGENT_DONE] ${result.output || '子 Agent 已完成'}`);
     }).catch((err) => {
         runningAgents.delete(taskId);
         decrementActiveAgents();
+        logError('spawn_agent.failed', err, {
+            taskId,
+            agentLabel,
+        });
         agentMessageBus.publish(taskId, replyChannel, `[AGENT_ERROR] ${err.message}`);
     });
     const inboxChannel = `agent-inbox:${taskId}`;

package/package.json

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