xiaozuoassistant 0.1.77 → 0.1.79

package/README.md

@@ -16,7 +16,13 @@ xiaozuoAssistant 是一个**本地优先（Local-first）**的个人 AI 助手
   - **项目空间**：管理项目元数据（描述、成员、目录等），为 AI 提供项目上下文（支持多项目关联）。
   - **智能笔记本**：记录笔记和待办事项（Todo），支持关键字自动归档。
 - **更易接入新模型**：统一 LLM(OpenAI 兼容) client 工厂与 provider→baseURL 解析，便于新增 provider。
-- **CLI 管理**：支持 `start/stop/doctor/export/import`。
+- **CLI 管理**：支持 `start/stop/doctor/export/import`，完美支持 Windows/macOS/Linux 跨平台运行。
+
+## 系统要求
+
+- **操作系统**: macOS, Linux, Windows (WSL 或 PowerShell/CMD)
+- **Node.js**: v18.0.0 或更高版本
+- **Python**: v3.0+ (某些依赖可能需要)
 
 ## 快速开始（推荐：npm 全局安装）
 
@@ -86,6 +92,9 @@ xiaozuoAssistant start
 
 - 你可以通过 `config.json` 或 API (`/api/config`) 更新 LLM 配置。
 - 支持 OpenAI 兼容的多 provider（示例：`openai/deepseek/minimax/doubao/qwen/custom`），并会自动映射 baseURL。
+- **配置项增强**：
+  - `maxHistoryMessages`: 控制发送给 LLM 的历史消息数量（默认 20），防止 Context Window 溢出。
+  - `maxToolIterations`: 限制工具调用的最大迭代次数（默认 15），防止死循环。
 - 可用环境变量：`XIAOZUO_LLM_API_KEY`（覆盖 `config.json` 中的 key）。
 
 ## 文档

package/bin/cli.js

@@ -192,69 +192,103 @@ async function isPortOpen(port) {
   });
 }
 
-async function stopServer() {
-  const pidFile = getPidFilePath();
-  const port = getPortFromConfig();
-
-  const killPid = async (pid) => {
-    const waitGone = async (ms) => new Promise(r => setTimeout(r, ms));
-
-    const tryKill = (targetPid, signal) => {
-      try {
-        process.kill(targetPid, signal);
-        return true;
-      } catch (e) {
-        return false;
-      }
-    };
-
-    const killedGroup = tryKill(-pid, 'SIGTERM');
-    if (!killedGroup) {
-      tryKill(pid, 'SIGTERM');
+async function killProcessTree(pid) {
+  if (process.platform === 'win32') {
+    try {
+      await runCommand('taskkill', ['/pid', pid.toString(), '/T', '/F'], { stdio: 'ignore' });
+      return true;
+    } catch {
+      return false;
     }
+  }
 
-    for (let i = 0; i < 10; i++) {
-      if (!isProcessRunning(pid)) return true;
-      await waitGone(300);
+  // Unix-like implementation
+  const tryKill = (targetPid, signal) => {
+    try {
+      process.kill(targetPid, signal);
+      return true;
+    } catch (e) {
+      return false;
     }
+  };
 
-    const killedGroupHard = tryKill(-pid, 'SIGKILL');
-    if (!killedGroupHard) {
+  tryKill(-pid, 'SIGTERM');
+  tryKill(pid, 'SIGTERM');
+  
+  // Wait a bit
+  await new Promise(r => setTimeout(r, 500));
+  
+  if (isProcessRunning(pid)) {
+      tryKill(-pid, 'SIGKILL');
       tryKill(pid, 'SIGKILL');
-    }
-
-    for (let i = 0; i < 10; i++) {
-      if (!isProcessRunning(pid)) return true;
-      await waitGone(300);
-    }
+  }
+  
+  return !isProcessRunning(pid);
+}
 
-    return !isProcessRunning(pid);
-  };
+async function stopServer() {
+  const pidFile = getPidFilePath();
+  const port = getPortFromConfig();
 
   const killByPort = async () => {
-    const lsof = spawn('lsof', ['-ti', `tcp:${port}`], { stdio: ['ignore', 'pipe', 'ignore'] });
-    let output = '';
-    lsof.stdout.on('data', (d) => { output += d.toString(); });
-    await new Promise((resolve) => lsof.on('close', resolve));
-
-    const pids = output
-      .split(/\s+/)
-      .map(s => s.trim())
-      .filter(Boolean)
-      .map(Number)
-      .filter(n => Number.isFinite(n) && n > 0);
-
-    if (pids.length === 0) return false;
-
-    for (const pid of pids) {
-      await killPid(pid);
+    if (process.platform === 'win32') {
+       // Windows implementation using netstat
+       try {
+         const netstat = spawn('netstat', ['-ano'], { stdio: ['ignore', 'pipe', 'ignore'] });
+         let output = '';
+         netstat.stdout.on('data', d => output += d.toString());
+         await new Promise(r => netstat.on('close', r));
+         
+         const lines = output.split('\n');
+         const pids = new Set();
+         for (const line of lines) {
+             if (line.includes(`:${port}`)) {
+                 const parts = line.trim().split(/\s+/);
+                 const pid = parts[parts.length - 1];
+                 if (pid && !isNaN(Number(pid)) && Number(pid) > 0) {
+                     pids.add(Number(pid));
+                 }
+             }
+         }
+         
+         if (pids.size === 0) return false;
+         
+         for (const pid of pids) {
+             await killProcessTree(pid);
+         }
+         return true;
+       } catch (e) {
+           console.error('[CLI] Windows port kill failed:', e);
+           return false;
+       }
+    } else {
+        // Unix implementation using lsof
+        const lsof = spawn('lsof', ['-ti', `tcp:${port}`], { stdio: ['ignore', 'pipe', 'ignore'] });
+        let output = '';
+        lsof.stdout.on('data', (d) => { output += d.toString(); });
+        await new Promise((resolve) => lsof.on('close', resolve));
+
+        const pids = output
+          .split(/\s+/)
+          .map(s => s.trim())
+          .filter(Boolean)
+          .map(Number)
+          .filter(n => Number.isFinite(n) && n > 0);
+
+        if (pids.length === 0) return false;
+
+        for (const pid of pids) {
+          await killProcessTree(pid);
+        }
+        return true;
     }
-    return true;
   };
 
   if (fs.existsSync(pidFile)) {
     const pidStr = fs.readFileSync(pidFile, 'utf-8').trim();
     const pid = Number(pidStr);
+    
+    // ... existing pid checks ...
     if (!Number.isFinite(pid) || pid <= 0) {
       fs.unlinkSync(pidFile);
       console.log('[CLI] 未找到可用的 PID（已清理 pid 文件）。');
@@ -268,7 +302,7 @@ async function stopServer() {
     }
 
     console.log(`[CLI] 正在停止服务（PID: ${pid}）...`);
-    await killPid(pid);
+    await killProcessTree(pid);
     await killByPort();
     try { fs.unlinkSync(pidFile); } catch (e) {}
 
@@ -276,9 +310,14 @@ async function stopServer() {
       console.log('[CLI] ✅ 服务已停止。');
       return;
     }
-
+    
+    // Fallback message
     console.error('[CLI] ❌ 停止失败：端口仍在占用。');
-    console.error(`[CLI] 你可以手动执行：lsof -ti tcp:${port} | xargs kill -9`);
+    if (process.platform !== 'win32') {
+        console.error(`[CLI] 你可以手动执行：lsof -ti tcp:${port} | xargs kill -9`);
+    } else {
+        console.error(`[CLI] 你可以手动执行：netstat -ano | findstr :${port} 并 kill 对应 PID`);
+    }
     return;
   }
 

package/dist/server/config/loader.js

@@ -64,7 +64,8 @@ catch (error) {
             requestTimeoutMs: 600000,
             maxRetries: 2,
             maxToolIterations: 200,
-            maxHistoryMessages: 20
+            maxHistoryMessages: 20,
+            sessionWakeupHours: 24
         },
         logging: { level: 'info' },
         scheduler: { memoryMaintenanceCron: '0 0 * * *', sessionRetentionDays: 5 },

package/dist/server/core/brain.js

@@ -20,6 +20,25 @@ export class Brain {
         if (process.env.DEBUG)
             console.log('[Brain] Processing message:', newMessage);
         const defaultSystemPrompt = systemPrompt || config.systemPrompt || SYSTEM_PROMPT || 'You are xiaozuoAssistant, a helpful AI assistant. You can use tools to help users.';
+        // Check for long inactivity (Session Wake-up)
+        const sessionLastActive = context?.session?.lastActiveAt || 0;
+        const now = Date.now();
+        const hoursSinceActive = (now - sessionLastActive) / (1000 * 60 * 60);
+        const WAKEUP_THRESHOLD = config.llm.sessionWakeupHours ?? 24;
+        let wakeupContext = '';
+        if (sessionLastActive > 0 && hoursSinceActive > WAKEUP_THRESHOLD) {
+            if (process.env.DEBUG)
+                console.log(`[Brain] Session wake-up detected (${hoursSinceActive.toFixed(1)}h > ${WAKEUP_THRESHOLD}h). Generating recap...`);
+            // Use recent history for quick summary, or could query Vector DB for deeper context
+            // For now, simple summary of recent messages to refresh context
+            const recentText = history.slice(-50).map(m => `${m.role}: ${m.content}`).join('\n');
+            if (recentText.length > 100) {
+                const summary = await this.generateSummary(recentText);
+                if (summary) {
+                    wakeupContext = `\n\n[System Notice]: The user has returned after ${Math.floor(hoursSinceActive)} hours. Here is a brief recap of the previous conversation context to help you catch up:\n${summary}`;
+                }
+            }
+        }
         // Convert history messages to the format expected by OpenAI
         // Strategy: Keep last N messages to avoid context window overflow
         // TODO: A better strategy would be token-based truncation.
@@ -36,7 +55,7 @@ export class Brain {
             return msg;
         });
         const messages = [
-            { role: 'system', content: defaultSystemPrompt },
+            { role: 'system', content: defaultSystemPrompt + wakeupContext },
             ...messageHistory,
             { role: 'user', content: newMessage }
         ];

package/package.json

@@ -2,7 +2,7 @@
   "name": "xiaozuoassistant",
   "private": false,
   "description": "Your personal, locally-hosted AI assistant for office productivity.",
-  "version": "0.1.77",
+  "version": "0.1.79",
   "author": "mantle.lau",
   "license": "MIT",
   "repository": {
@@ -39,7 +39,7 @@
     "check": "tsc --noEmit",
     "server:dev": "nodemon --watch src --watch config.json --exec tsx src/index.ts",
     "dev": "concurrently \"npm run client:dev\" \"npm run server:dev\"",
-    "postinstall": "node scripts/init-app-home.cjs || true && cp node_modules/@lancedb/lancedb-darwin-x64/lancedb.darwin-x64.node node_modules/@lancedb/lancedb/dist/ 2>/dev/null || true && npm rebuild better-sqlite3"
+    "postinstall": "node scripts/init-app-home.cjs || true"
   },
   "dependencies": {
     "@lancedb/lancedb": "0.22.3",