@code4bug/jarvis-agent 1.1.4 → 1.1.6

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/index.d.ts

@@ -12,7 +12,8 @@ import { sendToAgent } from './sendToAgent.js';
 import { publishMessage } from './publishMessage.js';
 import { subscribeMessage } from './subscribeMessage.js';
 import { readChannel } from './readChannel.js';
-export { readFile, writeFile, runCommand, listDirectory, searchFiles, semanticSearch, createSkill, runAgent, spawnAgent, sendToAgent, publishMessage, subscribeMessage, readChannel, };
+import { manageMemory } from './manageMemory.js';
+export { readFile, writeFile, runCommand, listDirectory, searchFiles, semanticSearch, createSkill, runAgent, spawnAgent, sendToAgent, publishMessage, subscribeMessage, readChannel, manageMemory, };
 /** 所有内置工具 */
 export declare const allTools: Tool[];
 /** 按名称查找内置工具 */

package/dist/tools/index.js

@@ -11,13 +11,15 @@ import { sendToAgent } from './sendToAgent.js';
 import { publishMessage } from './publishMessage.js';
 import { subscribeMessage } from './subscribeMessage.js';
 import { readChannel } from './readChannel.js';
-export { readFile, writeFile, runCommand, listDirectory, searchFiles, semanticSearch, createSkill, runAgent, spawnAgent, sendToAgent, publishMessage, subscribeMessage, readChannel, };
+import { manageMemory } from './manageMemory.js';
+export { readFile, writeFile, runCommand, listDirectory, searchFiles, semanticSearch, createSkill, runAgent, spawnAgent, sendToAgent, publishMessage, subscribeMessage, readChannel, manageMemory, };
 /** 所有内置工具 */
 export const allTools = [
     readFile, writeFile, runCommand, listDirectory, searchFiles,
     semanticSearch, createSkill,
     runAgent, spawnAgent, sendToAgent,
     publishMessage, subscribeMessage, readChannel,
+    manageMemory,
 ];
 /** 按名称查找内置工具 */
 export function findTool(name) {

package/dist/tools/manageMemory.d.ts

@@ -0,0 +1,2 @@
+import { Tool } from '../types/index.js';
+export declare const manageMemory: Tool;

package/dist/tools/manageMemory.js

@@ -0,0 +1,46 @@
+import { MEMORY_FILE_PATH, appendPersistentMemory, readPersistentMemory, replacePersistentMemory, ensureMemoryFile, } from '../config/memory.js';
+export const manageMemory = {
+    name: 'manage_memory',
+    description: [
+        '管理智能体长期记忆文件 ~/.jarvis/MEMORY.md。',
+        '可读取、追加、覆盖记忆，也可返回记忆文件路径。',
+        '适合沉淀可复用的经验、技能、偏好、约束和稳定环境事实。',
+    ].join('\n'),
+    parameters: {
+        action: {
+            type: 'string',
+            description: '操作类型：read | append | replace | path',
+            required: true,
+        },
+        content: {
+            type: 'string',
+            description: 'append 或 replace 时要写入的 Markdown 内容',
+            required: false,
+        },
+    },
+    execute: async (args) => {
+        const action = String(args.action || '').trim();
+        ensureMemoryFile();
+        if (action === 'path') {
+            return MEMORY_FILE_PATH;
+        }
+        if (action === 'read') {
+            return readPersistentMemory() || '(MEMORY.md 为空)';
+        }
+        if (action === 'append') {
+            const content = String(args.content || '').trim();
+            if (!content)
+                throw new Error('append 操作需要提供 content');
+            appendPersistentMemory(content);
+            return `长期记忆已追加到 ${MEMORY_FILE_PATH}`;
+        }
+        if (action === 'replace') {
+            const content = String(args.content || '').trim();
+            if (!content)
+                throw new Error('replace 操作需要提供 content');
+            replacePersistentMemory(content);
+            return `长期记忆已覆盖写入 ${MEMORY_FILE_PATH}`;
+        }
+        throw new Error(`不支持的 action: ${action}`);
+    },
+};

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.6",
   "description": "基于 React + TypeScript + Ink 构建的命令行智能体交互界面",
   "type": "module",
   "main": "dist/index.js",