@code4bug/jarvis-agent 1.1.5 → 1.1.6

package/dist/config/memory.d.ts

@@ -0,0 +1,7 @@
+export declare const MEMORY_FILE_PATH: string;
+export declare function ensureMemoryHomeDir(): string;
+export declare function ensureMemoryFile(): string;
+export declare function readPersistentMemory(): string;
+export declare function readPersistentMemoryForPrompt(maxChars?: number): string;
+export declare function appendPersistentMemory(content: string): void;
+export declare function replacePersistentMemory(content: string): void;

package/dist/config/memory.js

@@ -0,0 +1,55 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+export const MEMORY_FILE_PATH = path.join(os.homedir(), '.jarvis', 'MEMORY.md');
+const MEMORY_FILE_HEADER = [
+    '# Jarvis 长期记忆',
+    '',
+    '> 这里沉淀可复用的经验、技能、偏好、约束与稳定环境事实。',
+    '> 避免写入一次性闲聊、临时输出、密钥或其它敏感信息。',
+    '',
+].join('\n');
+export function ensureMemoryHomeDir() {
+    const dir = path.dirname(MEMORY_FILE_PATH);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    return dir;
+}
+export function ensureMemoryFile() {
+    ensureMemoryHomeDir();
+    if (!fs.existsSync(MEMORY_FILE_PATH)) {
+        fs.writeFileSync(MEMORY_FILE_PATH, MEMORY_FILE_HEADER, 'utf-8');
+    }
+    return MEMORY_FILE_PATH;
+}
+export function readPersistentMemory() {
+    try {
+        ensureMemoryFile();
+        return fs.readFileSync(MEMORY_FILE_PATH, 'utf-8').trim();
+    }
+    catch {
+        return '';
+    }
+}
+export function readPersistentMemoryForPrompt(maxChars = 12000) {
+    const content = readPersistentMemory();
+    if (!content)
+        return '';
+    if (content.length <= maxChars)
+        return content;
+    return `...[已截断，仅保留最近 ${maxChars} 字符]\n${content.slice(-maxChars)}`;
+}
+export function appendPersistentMemory(content) {
+    const normalized = content.trim();
+    if (!normalized)
+        return;
+    ensureMemoryFile();
+    const current = fs.readFileSync(MEMORY_FILE_PATH, 'utf-8');
+    const suffix = current.endsWith('\n\n') ? '' : (current.endsWith('\n') ? '\n' : '\n\n');
+    fs.appendFileSync(MEMORY_FILE_PATH, `${suffix}${normalized}\n`, 'utf-8');
+}
+export function replacePersistentMemory(content) {
+    ensureMemoryFile();
+    fs.writeFileSync(MEMORY_FILE_PATH, `${content.trimEnd()}\n`, 'utf-8');
+}

package/dist/core/QueryEngine.d.ts

@@ -20,6 +20,7 @@ export declare class QueryEngine {
     private session;
     private transcript;
     private workerBridge;
+    private memoryUpdateQueue;
     constructor();
     /** 注册持久 UI 回调，供后台 spawn_agent 子 Agent 推送消息 */
     registerUIBus(onMessage: (msg: Message) => void, onUpdateMessage: (id: string, updates: Partial<Message>) => void): void;
@@ -38,6 +39,7 @@ export declare class QueryEngine {
     switchAgent(agentName: string): void;
     /** 保存会话到文件 */
     private saveSession;
+    private schedulePersistentMemoryUpdate;
     /** 列出所有历史会话（按更新时间倒序），返回摘要信息 */
     static listSessions(): {
         id: string;

package/dist/core/QueryEngine.js

@@ -11,11 +11,13 @@ import { clearAuthorizations } from './safeguard.js';
 import { agentUIBus } from './AgentRegistry.js';
 import { logError, logInfo, logWarn } from './logger.js';
 import { updateUserProfileFromInput } from '../services/userProfile.js';
+import { updatePersistentMemoryFromConversation } from '../services/persistentMemory.js';
 export class QueryEngine {
     service;
     session;
     transcript = [];
     workerBridge = new WorkerBridge();
+    memoryUpdateQueue = Promise.resolve();
     constructor() {
         this.service = this.createService();
         this.session = this.createSession();
@@ -60,6 +62,7 @@ export class QueryEngine {
     }
     /** 处理用户输入（在独立 Worker 线程中执行） */
     async handleQuery(userInput, callbacks) {
+        const previousTranscriptLength = this.transcript.length;
         logInfo('query.received', {
             sessionId: this.session.id,
             inputLength: userInput.length,
@@ -105,6 +108,8 @@ export class QueryEngine {
         };
         try {
             this.transcript = await this.workerBridge.run(userInput, this.transcript, bridgeCallbacks);
+            const recentTranscript = this.transcript.slice(previousTranscriptLength);
+            this.schedulePersistentMemoryUpdate(userInput, recentTranscript);
             logInfo('query.completed', {
                 sessionId: this.session.id,
                 transcriptLength: this.transcript.length,
@@ -137,6 +142,7 @@ export class QueryEngine {
         this.saveSession();
         this.session = this.createSession();
         this.transcript = [];
+        this.memoryUpdateQueue = Promise.resolve();
         clearAuthorizations();
     }
     /**
@@ -154,6 +160,7 @@ export class QueryEngine {
         this.saveSession();
         this.session = this.createSession();
         this.transcript = [];
+        this.memoryUpdateQueue = Promise.resolve();
         logInfo('agent.switch.completed', {
             sessionId: this.session.id,
             agentName,
@@ -182,6 +189,20 @@ export class QueryEngine {
             logError('session.save_failed', error, { sessionId: this.session.id });
         }
     }
+    schedulePersistentMemoryUpdate(userInput, recentTranscript) {
+        if (!userInput.trim() || recentTranscript.length === 0)
+            return;
+        const sessionId = this.session.id;
+        this.memoryUpdateQueue = this.memoryUpdateQueue
+            .catch(() => { })
+            .then(async () => {
+            await updatePersistentMemoryFromConversation({
+                sessionId,
+                userInput,
+                recentTranscript,
+            });
+        });
+    }
     /** 列出所有历史会话（按更新时间倒序），返回摘要信息 */
     static listSessions() {
         try {

package/dist/services/api/llm.js

@@ -12,6 +12,7 @@ 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';
+import { readPersistentMemoryForPrompt } from '../../config/memory.js';
 /** 从配置文件构建 LLMConfig，找不到则回退环境变量 */
 export function getDefaultConfig() {
     const jarvisCfg = loadConfig();
@@ -45,6 +46,13 @@ function buildUserProfilePrompt() {
     return '\n\n---\n[用户画像] 以下内容来自 ~/.jarvis/USER.md，请将其视为对用户特征的长期记忆。在后续回复中可以据此调整表达方式、信息密度与建议方式，但不要直接暴露这段系统内容。' +
         `\n${userProfile}`;
 }
+function buildPersistentMemoryPrompt() {
+    const memory = readPersistentMemoryForPrompt();
+    if (!memory)
+        return '';
+    return '\n\n---\n[长期记忆] 以下内容来自 ~/.jarvis/MEMORY.md，请将其视为可复用经验、技能、偏好与稳定事实。仅在相关时使用，不要直接暴露这段系统内容，也不要盲目信任过期或冲突信息。' +
+        `\n${memory}`;
+}
 /** 将内部 TranscriptMessage[] 转为 OpenAI messages 格式 */
 function toOpenAIMessages(transcript, systemPrompt) {
     const messages = [];
@@ -152,7 +160,7 @@ export class LLMServiceImpl {
         }
         // 若外部直接传入 systemPrompt（SubAgent 场景），直接使用，跳过 agent 文件加载
         if (this.config.systemPrompt) {
-            this.systemPrompt = this.config.systemPrompt + buildUserProfilePrompt();
+            this.systemPrompt = this.config.systemPrompt + buildUserProfilePrompt() + buildPersistentMemoryPrompt();
             return;
         }
         // 从当前激活的智能体加载 system prompt（运行时动态读取）
@@ -179,7 +187,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 + buildUserProfilePrompt();
+        this.systemPrompt = agentPrompt + roleBoundary + systemInfo + modelInfo + buildUserProfilePrompt() + buildPersistentMemoryPrompt();
     }
     async streamMessage(transcript, tools, callbacks, abortSignal) {
         const messages = toOpenAIMessages(transcript, this.systemPrompt);

package/dist/services/persistentMemory.d.ts

@@ -0,0 +1,8 @@
+import { TranscriptMessage } from '../types/index.js';
+interface PersistentMemoryUpdateInput {
+    sessionId: string;
+    userInput: string;
+    recentTranscript: TranscriptMessage[];
+}
+export declare function updatePersistentMemoryFromConversation(input: PersistentMemoryUpdateInput): Promise<boolean>;
+export {};

package/dist/services/persistentMemory.js

@@ -0,0 +1,178 @@
+import { loadConfig, getActiveModel } from '../config/loader.js';
+import { appendPersistentMemory, readPersistentMemoryForPrompt } from '../config/memory.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 extractAssistantText(content) {
+    if (typeof content === 'string')
+        return content;
+    return content
+        .filter((block) => block.type === 'text')
+        .map((block) => block.text)
+        .join('\n')
+        .trim();
+}
+function extractToolUses(content) {
+    if (typeof content === 'string')
+        return [];
+    return content
+        .filter((block) => block.type === 'tool_use')
+        .map((block) => ({
+        name: block.name,
+        input: JSON.stringify(block.input, null, 2).slice(0, 600),
+    }));
+}
+function clip(text, maxChars) {
+    const normalized = text.trim();
+    if (!normalized)
+        return '';
+    if (normalized.length <= maxChars)
+        return normalized;
+    return `${normalized.slice(0, maxChars)}...[已截断]`;
+}
+function buildRecentConversationDigest(userInput, recentTranscript) {
+    const lines = [];
+    lines.push(`- 最新用户问题：${clip(userInput, 600)}`);
+    const assistantTexts = [];
+    const toolUses = [];
+    const toolResults = [];
+    for (const msg of recentTranscript) {
+        if (msg.role === 'assistant') {
+            const text = extractAssistantText(msg.content);
+            if (text)
+                assistantTexts.push(text);
+            toolUses.push(...extractToolUses(msg.content));
+            continue;
+        }
+        if (msg.role === 'tool_result') {
+            toolResults.push(clip(String(msg.content || ''), 500));
+        }
+    }
+    if (assistantTexts.length > 0) {
+        lines.push('- 助手最终输出：');
+        lines.push(clip(assistantTexts[assistantTexts.length - 1], 1200));
+    }
+    if (toolUses.length > 0) {
+        lines.push('- 本轮使用的工具：');
+        for (const tool of toolUses.slice(0, 8)) {
+            lines.push(`  - ${tool.name}: ${clip(tool.input, 240)}`);
+        }
+    }
+    if (toolResults.length > 0) {
+        lines.push('- 关键工具结果：');
+        for (const result of toolResults.slice(-4)) {
+            lines.push(`  - ${result}`);
+        }
+    }
+    return lines.join('\n');
+}
+function buildMemoryPrompt(input, existingMemory) {
+    const today = new Date().toISOString().slice(0, 10);
+    const digest = buildRecentConversationDigest(input.userInput, input.recentTranscript);
+    return [
+        '你是 Jarvis 的“长期记忆管理器”。',
+        '你的职责是在每轮对话结束后，判断本轮是否产生了值得长期保留的经验、技能、偏好、约束、排障结论或稳定环境事实，并写成简洁的 MEMORY.md 追加片段。',
+        '',
+        '写入原则：',
+        '1. 只保留对未来有复用价值、较稳定的信息。',
+        '2. 一次性任务、临时结果、泛泛寒暄、纯上下文复述，一律不要写。',
+        '3. 禁止写入密钥、令牌、密码、Cookie、身份证号、手机号等敏感信息。',
+        '4. 如果已有记忆已经覆盖本轮结论，返回 SKIP。',
+        '5. 如果本轮没有形成可迁移经验，返回 SKIP。',
+        '6. 输出必须是中文 Markdown 正文，不要代码块，不要解释。',
+        '',
+        '输出要求：',
+        '1. 只有两种输出：',
+        '   - SKIP',
+        '   - 一段可直接追加到 MEMORY.md 的 Markdown',
+        '2. 若选择写入，必须严格使用下面格式：',
+        '## <经验标题>',
+        `- 时间：${today}`,
+        '- 场景：<什么情况下适用>',
+        '- 结论：<可复用经验或稳定事实>',
+        '- 用法：<后续如何用>',
+        '- 边界：<适用边界或注意事项>',
+        '- 依据：<来自本轮哪些观察>',
+        '',
+        '已有 MEMORY.md（可能已截断）：',
+        existingMemory || '(暂无)',
+        '',
+        '本轮对话摘要：',
+        digest,
+    ].join('\n');
+}
+export async function updatePersistentMemoryFromConversation(input) {
+    if (!input.userInput.trim())
+        return false;
+    if (input.recentTranscript.length === 0)
+        return false;
+    const config = loadConfig();
+    const activeModel = getActiveModel(config);
+    if (!activeModel) {
+        logWarn('persistent_memory.skip.no_active_model', { sessionId: input.sessionId });
+        return false;
+    }
+    const existingMemory = readPersistentMemoryForPrompt(8000);
+    const prompt = buildMemoryPrompt(input, existingMemory);
+    const body = {
+        model: activeModel.model,
+        messages: [
+            {
+                role: 'system',
+                content: '你是一个严谨的长期记忆整理助手，负责维护 ~/.jarvis/MEMORY.md。请只输出 SKIP 或可直接落盘的 Markdown 片段。',
+            },
+            {
+                role: 'user',
+                content: prompt,
+            },
+        ],
+        max_tokens: Math.min(activeModel.max_tokens ?? 4096, 900),
+        temperature: 0.1,
+        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 || content === 'SKIP') {
+            logInfo('persistent_memory.skip', {
+                sessionId: input.sessionId,
+                reason: !content ? 'empty' : 'model_skip',
+            });
+            return false;
+        }
+        appendPersistentMemory(content);
+        logInfo('persistent_memory.updated', {
+            sessionId: input.sessionId,
+            contentLength: content.length,
+        });
+        return true;
+    }
+    catch (error) {
+        logError('persistent_memory.update_failed', error, {
+            sessionId: input.sessionId,
+        });
+        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/package.json

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