universal-memory-mcp 0.2.3 → 0.3.2

package/dist/cron.js

@@ -0,0 +1,200 @@
+#!/usr/bin/env node
+/**
+ * universal-memory-cron - 定时任务管理 CLI
+ */
+import { execSync, spawnSync } from 'node:child_process';
+import { platform } from 'node:os';
+function printHelp() {
+    console.log(`
+universal-memory-cron - 管理长期记忆整理定时任务
+
+使用方法:
+  universal-memory-cron <command>
+
+命令:
+  install     安装定时任务（每天凌晨 2:00 运行）
+  uninstall   卸载定时任务
+  status      查看定时任务状态
+
+示例:
+  universal-memory-cron install
+  universal-memory-cron uninstall
+  universal-memory-cron status
+
+说明:
+  此命令用于管理 universal-memory-consolidate 的定时任务。
+  安装后，系统会每天凌晨 2:00 自动运行记忆整理。
+
+  支持的系统：macOS, Linux
+  Windows 用户请使用 Task Scheduler 手动配置。
+`);
+}
+function getCronJobLine() {
+    // 每天凌晨 2:00 运行，整理前一天的对话
+    return `0 2 * * * $(which universal-memory-consolidate) --days 1 >> ~/.ai_memory/consolidate.log 2>&1`;
+}
+function getCronMarker() {
+    return '# universal-memory-consolidate';
+}
+function installCron() {
+    const os = platform();
+    if (os === 'win32') {
+        console.log('❌ Windows 不支持自动安装 cron 任务');
+        console.log('\n请使用 Task Scheduler 手动配置：');
+        console.log('  1. 打开 Task Scheduler');
+        console.log('  2. 创建基本任务');
+        console.log('  3. 触发器：每天 2:00');
+        console.log('  4. 操作：运行 universal-memory-consolidate --days 1');
+        return;
+    }
+    // 检查是否已安装
+    try {
+        const currentCrontab = execSync('crontab -l 2>/dev/null', { encoding: 'utf-8' });
+        if (currentCrontab.includes(getCronMarker())) {
+            console.log('ℹ️  定时任务已存在');
+            console.log('\n当前配置：');
+            const lines = currentCrontab.split('\n').filter(l => l.includes('universal-memory'));
+            lines.forEach(l => console.log(`  ${l}`));
+            return;
+        }
+    }
+    catch {
+        // crontab 为空或不存在
+    }
+    // 安装新的 cron 任务
+    const marker = getCronMarker();
+    const cronJob = getCronJobLine();
+    const newEntry = `${marker}\n${cronJob}`;
+    try {
+        // 获取现有 crontab
+        let currentCrontab = '';
+        try {
+            currentCrontab = execSync('crontab -l 2>/dev/null', { encoding: 'utf-8' });
+        }
+        catch {
+            // crontab 为空
+        }
+        // 添加新任务
+        const newCrontab = currentCrontab.trim() + '\n' + newEntry + '\n';
+        // 写入 crontab
+        const result = spawnSync('crontab', ['-'], {
+            input: newCrontab,
+            encoding: 'utf-8',
+        });
+        if (result.status !== 0) {
+            throw new Error(result.stderr || 'Unknown error');
+        }
+        console.log('✅ 定时任务已安装');
+        console.log('\n配置详情：');
+        console.log('  时间：每天凌晨 2:00');
+        console.log('  命令：universal-memory-consolidate --days 1');
+        console.log('  日志：~/.ai_memory/consolidate.log');
+        console.log('\n查看：crontab -l | grep universal-memory');
+    }
+    catch (error) {
+        console.error('❌ 安装失败:', error.message);
+        console.log('\n请尝试手动安装：');
+        console.log('  crontab -e');
+        console.log(`  # 添加以下行：`);
+        console.log(`  ${cronJob}`);
+    }
+}
+function uninstallCron() {
+    const os = platform();
+    if (os === 'win32') {
+        console.log('❌ Windows 请使用 Task Scheduler 手动删除任务');
+        return;
+    }
+    try {
+        const currentCrontab = execSync('crontab -l 2>/dev/null', { encoding: 'utf-8' });
+        if (!currentCrontab.includes('universal-memory')) {
+            console.log('ℹ️  没有找到相关的定时任务');
+            return;
+        }
+        // 移除相关行
+        const newCrontab = currentCrontab
+            .split('\n')
+            .filter(line => !line.includes('universal-memory'))
+            .join('\n');
+        // 写入 crontab
+        const result = spawnSync('crontab', ['-'], {
+            input: newCrontab,
+            encoding: 'utf-8',
+        });
+        if (result.status !== 0) {
+            throw new Error(result.stderr || 'Unknown error');
+        }
+        console.log('✅ 定时任务已卸载');
+    }
+    catch (error) {
+        if (error.message.includes('no crontab')) {
+            console.log('ℹ️  没有找到相关的定时任务');
+        }
+        else {
+            console.error('❌ 卸载失败:', error.message);
+        }
+    }
+}
+function showStatus() {
+    const os = platform();
+    if (os === 'win32') {
+        console.log('ℹ️  Windows 请使用 Task Scheduler 查看任务状态');
+        return;
+    }
+    try {
+        const currentCrontab = execSync('crontab -l 2>/dev/null', { encoding: 'utf-8' });
+        const lines = currentCrontab.split('\n').filter(l => l.includes('universal-memory') && !l.startsWith('#'));
+        if (lines.length === 0) {
+            console.log('ℹ️  未安装定时任务');
+            console.log('\n运行以下命令安装：');
+            console.log('  universal-memory-cron install');
+        }
+        else {
+            console.log('✅ 定时任务已安装\n');
+            console.log('当前配置：');
+            lines.forEach(l => console.log(`  ${l}`));
+            // 检查日志文件
+            try {
+                const logTail = execSync('tail -5 ~/.ai_memory/consolidate.log 2>/dev/null', { encoding: 'utf-8' });
+                if (logTail.trim()) {
+                    console.log('\n最近日志：');
+                    console.log(logTail);
+                }
+            }
+            catch {
+                console.log('\n暂无运行日志');
+            }
+        }
+    }
+    catch {
+        console.log('ℹ️  未安装定时任务');
+        console.log('\n运行以下命令安装：');
+        console.log('  universal-memory-cron install');
+    }
+}
+function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    switch (command) {
+        case 'install':
+            installCron();
+            break;
+        case 'uninstall':
+            uninstallCron();
+            break;
+        case 'status':
+            showStatus();
+            break;
+        case '--help':
+        case '-h':
+        case undefined:
+            printHelp();
+            break;
+        default:
+            console.error(`未知命令: ${command}`);
+            console.log('运行 universal-memory-cron --help 查看帮助');
+            process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=cron.js.map

package/dist/cron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.js","sourceRoot":"","sources":["../src/cron.ts"],"names":[],"mappings":";AAEA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;CAsBb,CAAC,CAAC;AACH,CAAC;AAED,SAAS,cAAc;IACrB,wBAAwB;IACxB,OAAO,+FAA+F,CAAC;AACzG,CAAC;AAED,SAAS,aAAa;IACpB,OAAO,gCAAgC,CAAC;AAC1C,CAAC;AAED,SAAS,WAAW;IAClB,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;IAEtB,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;QAChE,OAAO;IACT,CAAC;IAED,UAAU;IACV,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,QAAQ,CAAC,wBAAwB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACjF,IAAI,cAAc,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACvB,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC;YACrF,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;IAED,eAAe;IACf,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,GAAG,MAAM,KAAK,OAAO,EAAE,CAAC;IAEzC,IAAI,CAAC;QACH,eAAe;QACf,IAAI,cAAc,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,cAAc,GAAG,QAAQ,CAAC,wBAAwB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7E,CAAC;QAAC,MAAM,CAAC;YACP,aAAa;QACf,CAAC;QAED,QAAQ;QACR,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC;QAElE,aAAa;QACb,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,EAAE;YACzC,KAAK,EAAE,UAAU;YACjB,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,eAAe,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,SAAS,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,SAAS,aAAa;IACpB,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;IAEtB,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QACnD,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,QAAQ,CAAC,wBAAwB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAEjF,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;YAC/B,OAAO;QACT,CAAC;QAED,QAAQ;QACR,MAAM,UAAU,GAAG,cAAc;aAC9B,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;aAClD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,aAAa;QACb,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,EAAE;YACzC,KAAK,EAAE,UAAU;YACjB,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,eAAe,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YACpD,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,SAAS,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;IAEtB,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;QACrD,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,QAAQ,CAAC,wBAAwB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACjF,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAClD,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CACrD,CAAC;QAEF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACrB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;YAE1C,SAAS;YACT,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,QAAQ,CAAC,kDAAkD,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;gBACpG,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;oBACnB,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBACvB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,SAAS,IAAI;IACX,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAExB,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,SAAS;YACZ,WAAW,EAAE,CAAC;YACd,MAAM;QACR,KAAK,WAAW;YACd,aAAa,EAAE,CAAC;YAChB,MAAM;QACR,KAAK,QAAQ;YACX,UAAU,EAAE,CAAC;YACb,MAAM;QACR,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI,CAAC;QACV,KAAK,SAAS;YACZ,SAAS,EAAE,CAAC;YACZ,MAAM;QACR;YACE,OAAO,CAAC,KAAK,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "universal-memory-mcp",
-  "version": "0.2.3",
+  "version": "0.3.2",
   "description": "MCP Server for persistent AI memory across sessions",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
     "universal-memory-mcp": "./dist/index.js",
-    "universal-memory-record": "./dist/record.js"
+    "universal-memory-record": "./dist/record.js",
+    "universal-memory-consolidate": "./dist/consolidate.js",
+    "universal-memory-cron": "./dist/cron.js"
   },
   "exports": {
     ".": {
@@ -25,7 +27,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "universal-memory-core": "^0.1.3"
+    "universal-memory-core": "^0.1.4"
   },
   "devDependencies": {
     "@types/node": "^20.11.0",

package/scripts/postinstall.js

@@ -12,8 +12,10 @@ import fs from 'fs';
 import path from 'path';
 import os from 'os';
 
-const CLAUDE_SETTINGS_PATH = path.join(os.homedir(), '.claude', 'settings.json');
-const CLAUDE_SKILLS_PATH = path.join(os.homedir(), '.claude', 'skills');
+const CLAUDE_DIR = path.join(os.homedir(), '.claude');
+const CLAUDE_SETTINGS_PATH = path.join(CLAUDE_DIR, 'settings.json');
+const CLAUDE_SKILLS_PATH = path.join(CLAUDE_DIR, 'skills');
+const CLAUDE_HOOKS_PATH = path.join(CLAUDE_DIR, 'hooks');
 
 // MCP server configuration
 const MCP_CONFIG = {
@@ -155,6 +157,21 @@ memory_update_long_term({
 - Use project name when in project context
 `;
 
+/**
+ * Check if Claude Code is installed
+ */
+function checkClaudeCodeInstalled() {
+  if (!fs.existsSync(CLAUDE_DIR)) {
+    console.log('\n⚠️  Claude Code not detected!\n');
+    console.log('Please install Claude Code first:');
+    console.log('  https://code.claude.com/\n');
+    console.log('After installing Claude Code, run:');
+    console.log('  npm install -g universal-memory-mcp\n');
+    return false;
+  }
+  return true;
+}
+
 /**
  * Read JSON file safely
  */
@@ -253,6 +270,184 @@ function installSkill() {
   return true;
 }
 
+/**
+ * Install Stop hook script
+ */
+function installStopHook() {
+  console.log('\n🪝 Installing Stop hook...');
+
+  const hookScriptPath = path.join(CLAUDE_HOOKS_PATH, 'universal-memory-stop-hook.mjs');
+
+  // Create hooks directory if not exists
+  if (!fs.existsSync(CLAUDE_HOOKS_PATH)) {
+    fs.mkdirSync(CLAUDE_HOOKS_PATH, { recursive: true });
+    console.log('  Created hooks directory');
+  }
+
+  // Get source script path (in the same directory as this postinstall script)
+  const sourceScript = new URL('universal-memory-stop-hook.mjs', import.meta.url).pathname;
+
+  // Check if hook already exists
+  if (fs.existsSync(hookScriptPath)) {
+    const existingContent = fs.readFileSync(hookScriptPath, 'utf-8');
+    const newContent = fs.readFileSync(sourceScript, 'utf-8');
+
+    if (existingContent === newContent) {
+      console.log('  Stop hook already installed (same version)');
+      return false;
+    }
+
+    // Backup existing hook
+    const backupPath = `${hookScriptPath}.backup.${Date.now()}`;
+    fs.copyFileSync(hookScriptPath, backupPath);
+    console.log(`  Backed up existing hook to: ${backupPath}`);
+  }
+
+  fs.copyFileSync(sourceScript, hookScriptPath);
+  fs.chmodSync(hookScriptPath, 0o755); // Make executable
+  console.log('  Stop hook installed successfully');
+  return true;
+}
+
+/**
+ * Install SessionStart hook script
+ */
+function installStartHook() {
+  console.log('\n🚀 Installing SessionStart hook...');
+
+  const hookScriptPath = path.join(CLAUDE_HOOKS_PATH, 'universal-memory-start-hook.mjs');
+
+  // Create hooks directory if not exists
+  if (!fs.existsSync(CLAUDE_HOOKS_PATH)) {
+    fs.mkdirSync(CLAUDE_HOOKS_PATH, { recursive: true });
+    console.log('  Created hooks directory');
+  }
+
+  // Get source script path (in the same directory as this postinstall script)
+  const sourceScript = new URL('universal-memory-start-hook.mjs', import.meta.url).pathname;
+
+  // Check if source exists
+  if (!fs.existsSync(sourceScript)) {
+    console.log('  Start hook source not found, skipping');
+    return false;
+  }
+
+  // Check if hook already exists
+  if (fs.existsSync(hookScriptPath)) {
+    const existingContent = fs.readFileSync(hookScriptPath, 'utf-8');
+    const newContent = fs.readFileSync(sourceScript, 'utf-8');
+
+    if (existingContent === newContent) {
+      console.log('  Start hook already installed (same version)');
+      return false;
+    }
+
+    // Backup existing hook
+    const backupPath = `${hookScriptPath}.backup.${Date.now()}`;
+    fs.copyFileSync(hookScriptPath, backupPath);
+    console.log(`  Backed up existing hook to: ${backupPath}`);
+  }
+
+  fs.copyFileSync(sourceScript, hookScriptPath);
+  fs.chmodSync(hookScriptPath, 0o755); // Make executable
+  console.log('  Start hook installed successfully');
+  return true;
+}
+
+/**
+ * Configure Stop hook in Claude settings
+ */
+function configureStopHook() {
+  console.log('\n⚙️  Configuring Stop hook...');
+
+  let settings = readJsonFile(CLAUDE_SETTINGS_PATH) || {};
+
+  // Initialize hooks if not exists
+  if (!settings.hooks) {
+    settings.hooks = {};
+  }
+
+  // Initialize Stop hook array if not exists
+  if (!settings.hooks.Stop) {
+    settings.hooks.Stop = [];
+  }
+
+  // Check if our hook is already configured
+  const hookScriptPath = path.join(os.homedir(), '.claude', 'hooks', 'universal-memory-stop-hook.mjs');
+  const hookCommand = `node ${hookScriptPath}`;
+  const alreadyConfigured = settings.hooks.Stop.some(entry =>
+    entry.hooks?.some(hook =>
+      hook.type === 'command' && hook.command.includes('universal-memory-stop-hook')
+    )
+  );
+
+  if (alreadyConfigured) {
+    console.log('  Stop hook already configured');
+    return false;
+  }
+
+  // Add Stop hook configuration
+  settings.hooks.Stop.push({
+    hooks: [
+      {
+        type: 'command',
+        command: hookCommand
+      }
+    ]
+  });
+
+  writeJsonFile(CLAUDE_SETTINGS_PATH, settings);
+  console.log('  Stop hook configured successfully');
+  return true;
+}
+
+/**
+ * Configure SessionStart hook in Claude settings
+ */
+function configureStartHook() {
+  console.log('\n⚙️  Configuring SessionStart hook...');
+
+  let settings = readJsonFile(CLAUDE_SETTINGS_PATH) || {};
+
+  // Initialize hooks if not exists
+  if (!settings.hooks) {
+    settings.hooks = {};
+  }
+
+  // Initialize SessionStart hook array if not exists
+  if (!settings.hooks.SessionStart) {
+    settings.hooks.SessionStart = [];
+  }
+
+  // Check if our hook is already configured
+  const hookScriptPath = path.join(os.homedir(), '.claude', 'hooks', 'universal-memory-start-hook.mjs');
+  const hookCommand = `node ${hookScriptPath}`;
+  const alreadyConfigured = settings.hooks.SessionStart.some(entry =>
+    entry.hooks?.some(hook =>
+      hook.type === 'command' && hook.command.includes('universal-memory-start-hook')
+    )
+  );
+
+  if (alreadyConfigured) {
+    console.log('  SessionStart hook already configured');
+    return false;
+  }
+
+  // Add SessionStart hook configuration
+  settings.hooks.SessionStart.push({
+    hooks: [
+      {
+        type: 'command',
+        command: hookCommand
+      }
+    ]
+  });
+
+  writeJsonFile(CLAUDE_SETTINGS_PATH, settings);
+  console.log('  SessionStart hook configured successfully');
+  return true;
+}
+
 /**
  * Main installation
  */
@@ -261,26 +456,48 @@ function main() {
   console.log('║         Universal Memory MCP - Setup                       ║');
   console.log('╚════════════════════════════════════════════════════════════╝');
 
+  // Check Claude Code installation
+  if (!checkClaudeCodeInstalled()) {
+    process.exit(0);
+  }
+
   let needsRestart = false;
 
   try {
-    // Configure MCP server
+    // 1. Configure MCP server
     const mcpConfigured = configureMcpServer();
     if (mcpConfigured) needsRestart = true;
 
-    // Install skill
+    // 2. Install skill
     const skillInstalled = installSkill();
     if (skillInstalled) needsRestart = true;
 
+    // 3. Install Stop hook script
+    const stopHookInstalled = installStopHook();
+    if (stopHookInstalled) needsRestart = true;
+
+    // 4. Configure Stop hook
+    const stopHookConfigured = configureStopHook();
+    if (stopHookConfigured) needsRestart = true;
+
+    // 5. Install SessionStart hook script
+    const startHookInstalled = installStartHook();
+    if (startHookInstalled) needsRestart = true;
+
+    // 6. Configure SessionStart hook
+    const startHookConfigured = configureStartHook();
+    if (startHookConfigured) needsRestart = true;
+
     // Summary
     console.log('\n' + '═'.repeat(60));
 
     if (needsRestart) {
       console.log('\n✅ Setup complete!\n');
-      console.log('⚠️  IMPORTANT: Please restart Claude Code to enable the MCP server.\n');
+      console.log('⚠️  IMPORTANT: Please restart Claude Code to enable all features.\n');
       console.log('After restart, Claude will automatically:');
+      console.log('  • Recall your profile at session start (via SessionStart hook)');
       console.log('  • Search past conversations when you reference them');
-      console.log('  • Record important conversations for future recall');
+      console.log('  • Record EVERY conversation automatically (via Stop hook)');
       console.log('  • Remember your preferences and decisions\n');
     } else {
       console.log('\n✅ Already configured! No changes needed.\n');
@@ -289,8 +506,16 @@ function main() {
     console.log('📁 Configuration locations:');
     console.log(`   MCP config: ${CLAUDE_SETTINGS_PATH}`);
     console.log(`   Skill: ${path.join(CLAUDE_SKILLS_PATH, 'memory-assistant', 'SKILL.md')}`);
+    console.log(`   Stop hook: ${path.join(CLAUDE_HOOKS_PATH, 'universal-memory-stop-hook.mjs')}`);
+    console.log(`   Start hook: ${path.join(CLAUDE_HOOKS_PATH, 'universal-memory-start-hook.mjs')}`);
     console.log(`   Memory storage: ${path.join(os.homedir(), '.ai_memory')}\n`);
 
+    console.log('💡 可选：设置自动整理长期记忆');
+    console.log('   # 手动整理最近 7 天的对话');
+    console.log('   universal-memory-consolidate --days 7\n');
+    console.log('   # 完整整理（包含二次整合）');
+    console.log('   universal-memory-consolidate --days 7 --consolidate-summary\n');
+
   } catch (error) {
     console.error('\n❌ Setup failed:', error.message);
     console.error('\nPlease configure manually. See README for instructions.');

package/scripts/universal-memory-start-hook.mjs

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+
+/**
+ * Universal Memory - SessionStart Hook
+ *
+ * 在会话开始时召回用户画像，注入到会话上下文中。
+ *
+ * 功能：
+ * 1. 读取 profile-summary.md（Level 2 整合摘要）
+ * 2. 如果不存在，回退到 profile.md（Level 1 原始条目）
+ * 3. 输出用户画像到 stdout，Claude Code 会将其作为系统上下文
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+
+// Enable debug logging via environment variable
+const DEBUG = process.env.UNIVERSAL_MEMORY_DEBUG === '1';
+
+function debugLog(message) {
+  if (DEBUG) {
+    fs.appendFileSync('/tmp/universal-memory-start-hook.log', `[${new Date().toISOString()}] ${message}\n`);
+  }
+}
+
+function getMemoryPath() {
+  return process.env.MEMORY_PATH || path.join(os.homedir(), '.ai_memory');
+}
+
+function readProfileSummary() {
+  const memoryPath = getMemoryPath();
+  const longTermDir = path.join(memoryPath, 'long_term');
+
+  // 优先读取 Level 2 整合摘要
+  const summaryPath = path.join(longTermDir, 'profile-summary.md');
+  if (fs.existsSync(summaryPath)) {
+    debugLog(`Reading profile summary from: ${summaryPath}`);
+    const content = fs.readFileSync(summaryPath, 'utf-8');
+    return { source: 'profile-summary.md', content };
+  }
+
+  // 回退到 Level 1 原始条目
+  const profilePath = path.join(longTermDir, 'profile.md');
+  if (fs.existsSync(profilePath)) {
+    debugLog(`Reading profile from: ${profilePath}`);
+    const content = fs.readFileSync(profilePath, 'utf-8');
+    return { source: 'profile.md', content };
+  }
+
+  debugLog('No profile found');
+  return null;
+}
+
+function readKnowledgeSummary() {
+  const memoryPath = getMemoryPath();
+  const longTermDir = path.join(memoryPath, 'long_term');
+
+  const summaryPath = path.join(longTermDir, 'knowledge-summary.md');
+  if (fs.existsSync(summaryPath)) {
+    debugLog(`Reading knowledge summary from: ${summaryPath}`);
+    const content = fs.readFileSync(summaryPath, 'utf-8');
+    return { source: 'knowledge-summary.md', content };
+  }
+
+  return null;
+}
+
+function formatOutput(profile, knowledge) {
+  const parts = [];
+
+  parts.push('<user-memory>');
+  parts.push('以下是从长期记忆中召回的用户信息，请在对话中参考：');
+  parts.push('');
+
+  if (profile) {
+    parts.push(`<!-- Source: ${profile.source} -->`);
+    parts.push(profile.content);
+    parts.push('');
+  }
+
+  // 知识库摘要可能太长，只包含前 2000 字符
+  if (knowledge) {
+    const truncated = knowledge.content.length > 2000
+      ? knowledge.content.substring(0, 2000) + '\n\n[... 更多内容请使用 memory_search 查询]'
+      : knowledge.content;
+    parts.push(`<!-- Source: ${knowledge.source} -->`);
+    parts.push(truncated);
+    parts.push('');
+  }
+
+  parts.push('</user-memory>');
+
+  return parts.join('\n');
+}
+
+function main() {
+  debugLog('Start hook triggered');
+
+  // 读取 stdin（Claude Code 会传入 hook 输入）
+  let hookInput = {};
+  try {
+    const raw = fs.readFileSync(0, 'utf8');
+    if (raw.trim()) {
+      hookInput = JSON.parse(raw);
+      debugLog(`Hook input: ${JSON.stringify(hookInput).substring(0, 200)}`);
+    }
+  } catch (err) {
+    debugLog(`Failed to parse hook input: ${err.message}`);
+  }
+
+  // 读取用户画像
+  const profile = readProfileSummary();
+
+  // 可选：读取知识库摘要（如果需要的话）
+  // const knowledge = readKnowledgeSummary();
+  const knowledge = null; // 暂时不包含知识库，避免上下文过长
+
+  if (!profile && !knowledge) {
+    debugLog('No memory to recall, exiting');
+    process.exit(0);
+  }
+
+  // 输出到 stdout
+  const output = formatOutput(profile, knowledge);
+  debugLog(`Output length: ${output.length} chars`);
+
+  // 输出 JSON 格式，包含要注入的内容
+  const result = {
+    result: output,
+  };
+
+  console.log(JSON.stringify(result));
+}
+
+main();