@sciagent/cli 1.1.9 → 1.1.11

package/bin/sciagent.js

@@ -21,9 +21,11 @@ const { spawn, execSync } = require('child_process');
 const path = require('path');
 const fs = require('fs');
 const os = require('os');
+const https = require('https');
+const http = require('http');
 
 // 当前版本号 - 与 postinstall.js 和 package.json 保持同步
-const CURRENT_VERSION = '1.1.9';
+const CURRENT_VERSION = '1.1.11';
 
 // 极狐GitLab下载配置
 const JIHULAB_URL = 'https://jihulab.com';
@@ -60,6 +62,285 @@ function compareVersions(a, b) {
   return 0;
 }
 
+/**
+ * 检查并应用 .pending-update 标记的更新
+ * 在 sciagent 启动时调用（此时旧进程已退出，二进制文件不再被锁定）
+ * 返回: true 如果应用了更新，false 如果没有待更新
+ */
+function applyPendingUpdate(installDir) {
+  const pendingFile = path.join(installDir, '.pending-update');
+  
+  if (!fs.existsSync(pendingFile)) {
+    return false;
+  }
+  
+  try {
+    const pendingData = JSON.parse(fs.readFileSync(pendingFile, 'utf8'));
+    const { version, tempPath, timestamp } = pendingData;
+    
+    console.log(`[UPDATE] Found pending update: v${version} (queued at ${timestamp})`);
+    
+    // 检查临时文件是否存在
+    if (!fs.existsSync(tempPath)) {
+      console.log(`[UPDATE] Temp file not found: ${tempPath}`);
+      console.log(`[UPDATE] Clearing pending update marker.`);
+      fs.unlinkSync(pendingFile);
+      return false;
+    }
+    
+    // 验证临时文件大小
+    const tempStats = fs.statSync(tempPath);
+    if (tempStats.size < 10 * 1024 * 1024) {
+      console.log(`[UPDATE] Temp file too small (${(tempStats.size / 1024).toFixed(0)} KB), discarding.`);
+      try { fs.unlinkSync(tempPath); } catch (e) {}
+      fs.unlinkSync(pendingFile);
+      return false;
+    }
+    
+    // 确定目标路径
+    const platform = PLATFORM_MAP[process.platform];
+    const binName = platform === 'win32' ? 'sciagent.exe' : 'sciagent';
+    const targetPath = path.join(installDir, binName);
+    
+    // 尝试替换
+    try {
+      if (process.platform === 'win32') {
+        // Windows: 使用 PowerShell
+        const tmpScript = path.join(os.tmpdir(), 'sciagent-apply-update.ps1');
+        const scriptContent = [
+          `Copy-Item -Path "${tempPath}" -Destination "${targetPath}" -Force`,
+          'if (Test-Path $out) { Write-Host "OK" } else { exit 1 }'
+        ].join('\r\n');
+        fs.writeFileSync(tmpScript, scriptContent, 'utf8');
+        try {
+          execSync(`powershell -NoProfile -ExecutionPolicy Bypass -File "${tmpScript}"`, {
+            stdio: 'pipe', timeout: 30000
+          });
+        } finally {
+          try { fs.unlinkSync(tmpScript); } catch (e) {}
+        }
+      } else {
+        fs.copyFileSync(tempPath, targetPath);
+        fs.chmodSync(targetPath, 0o755);
+      }
+      
+      // 验证替换成功
+      if (fs.existsSync(targetPath)) {
+        const targetStats = fs.statSync(targetPath);
+        if (targetStats.size > 10 * 1024 * 1024) {
+          // 更新版本文件
+          fs.writeFileSync(path.join(installDir, '.version'), version);
+          // 清理临时文件和标记
+          try { fs.unlinkSync(tempPath); } catch (e) {}
+          fs.unlinkSync(pendingFile);
+          console.log(`[UPDATE] ✅ Applied pending update: v${version} (${(targetStats.size / (1024 * 1024)).toFixed(1)} MB)`);
+          return true;
+        }
+      }
+      
+      console.log(`[UPDATE] ⚠️ Replace succeeded but validation failed.`);
+    } catch (e) {
+      console.log(`[UPDATE] ⚠️ Failed to apply pending update: ${e.message}`);
+      console.log(`[UPDATE] The update will be retried on next startup.`);
+      // 不删除 pending 文件，下次启动重试
+      return false;
+    }
+  } catch (e) {
+    console.log(`[UPDATE] ⚠️ Error reading pending update: ${e.message}`);
+    try { fs.unlinkSync(pendingFile); } catch (e2) {}
+  }
+  
+  return false;
+}
+
+/**
+ * 从极狐GitLab查询最新版本号
+ * 返回: 版本字符串 或 null
+ */
+function fetchLatestVersion() {
+  return new Promise((resolve) => {
+    const url = (
+      `${JIHULAB_URL}/api/v4/projects/${JIHULAB_PROJECT_ID}` +
+      `/packages?package_name=${JIHULAB_PACKAGE_NAME}&per_page=1&order_by=version&sort=desc` +
+      `&access_token=${JIHULAB_DOWNLOAD_TOKEN}`
+    );
+    
+    const protocol = url.startsWith('https') ? https : http;
+    const request = protocol.get(url, {
+      headers: { 'User-Agent': 'sciagent-cli/1.0' },
+      timeout: 10000
+    }, (response) => {
+      let data = '';
+      response.on('data', (chunk) => { data += chunk; });
+      response.on('end', () => {
+        try {
+          const packages = JSON.parse(data);
+          if (Array.isArray(packages) && packages.length > 0 && packages[0].version) {
+            resolve(packages[0].version);
+          } else {
+            resolve(null);
+          }
+        } catch (e) {
+          resolve(null);
+        }
+      });
+    });
+    
+    request.on('error', () => resolve(null));
+    request.on('timeout', () => { request.destroy(); resolve(null); });
+  });
+}
+
+/**
+ * 后台下载新版本到临时目录
+ * 下载完成后写入 .pending-update 标记
+ * 这是异步操作，不阻塞主进程启动
+ */
+function backgroundDownloadUpdate(platform, arch, latestVersion) {
+  const binName = platform === 'win32' ? 'sciagent.exe' : 'sciagent';
+  const ext = platform === 'win32' ? '.exe' : '';
+  const filename = `sciagent-${platform}-${arch}${ext}`;
+  
+  const downloadUrl = (
+    `${JIHULAB_URL}/api/v4/projects/${JIHULAB_PROJECT_ID}` +
+    `/packages/generic/${JIHULAB_PACKAGE_NAME}/${latestVersion}/${filename}` +
+    `?access_token=${JIHULAB_DOWNLOAD_TOKEN}`
+  );
+  
+  const installDir = getInstallDir(platform);
+  const tempDir = path.join(os.tmpdir(), 'sciagent-update');
+  fs.mkdirSync(tempDir, { recursive: true });
+  const tempPath = path.join(tempDir, binName);
+  
+  // 清理旧的临时文件
+  try { if (fs.existsSync(tempPath)) fs.unlinkSync(tempPath); } catch (e) {}
+  
+  console.log(`[AUTO-UPDATE] Downloading v${latestVersion} in background...`);
+  
+  if (platform === 'win32') {
+    // Windows: 使用 PowerShell 后台下载
+    const tmpScript = path.join(os.tmpdir(), 'sciagent-bg-download.ps1');
+    const scriptContent = [
+      '$ProgressPreference = "SilentlyContinue"',
+      `$uri = "${downloadUrl}"`,
+      `$out = "${tempPath}"`,
+      'Invoke-WebRequest -Uri $uri -OutFile $out -UseBasicParsing',
+      `if (Test-Path $out) { $s = (Get-Item $out).Length; Write-Host "Downloaded: $s bytes" } else { exit 1 }`
+    ].join('\r\n');
+    fs.writeFileSync(tmpScript, scriptContent, 'utf8');
+    
+    const bgProcess = spawn('powershell', [
+      '-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', tmpScript
+    ], { stdio: 'pipe', detached: true, windowsHide: true });
+    
+    bgProcess.on('exit', (code) => {
+      try { fs.unlinkSync(tmpScript); } catch (e) {}
+      if (code === 0 && fs.existsSync(tempPath)) {
+        const stats = fs.statSync(tempPath);
+        if (stats.size > 10 * 1024 * 1024) {
+          console.log(`[AUTO-UPDATE] ✅ Downloaded v${latestVersion} (${(stats.size / (1024 * 1024)).toFixed(1)} MB)`);
+          // 写入 pending update 标记
+          const pendingData = {
+            version: latestVersion,
+            tempPath: tempPath,
+            timestamp: new Date().toISOString(),
+            platform: process.platform
+          };
+          fs.writeFileSync(path.join(installDir, '.pending-update'), JSON.stringify(pendingData, null, 2), 'utf8');
+          console.log(`[AUTO-UPDATE] 📋 Update will be applied on next restart.`);
+        }
+      } else {
+        console.log(`[AUTO-UPDATE] ⚠️ Background download failed.`);
+        try { if (fs.existsSync(tempPath)) fs.unlinkSync(tempPath); } catch (e) {}
+      }
+    });
+    
+    bgProcess.unref();
+  } else {
+    // Linux/macOS: 使用 curl 后台下载
+    const bgProcess = spawn('curl', [
+      '-fsSL', '-o', tempPath, downloadUrl
+    ], { stdio: 'pipe', detached: true });
+    
+    bgProcess.on('exit', (code) => {
+      if (code === 0 && fs.existsSync(tempPath)) {
+        const stats = fs.statSync(tempPath);
+        if (stats.size > 10 * 1024 * 1024) {
+          fs.chmodSync(tempPath, 0o755);
+          console.log(`[AUTO-UPDATE] ✅ Downloaded v${latestVersion} (${(stats.size / (1024 * 1024)).toFixed(1)} MB)`);
+          const pendingData = {
+            version: latestVersion,
+            tempPath: tempPath,
+            timestamp: new Date().toISOString(),
+            platform: process.platform
+          };
+          fs.writeFileSync(path.join(installDir, '.pending-update'), JSON.stringify(pendingData, null, 2), 'utf8');
+          console.log(`[AUTO-UPDATE] 📋 Update will be applied on next restart.`);
+        }
+      } else {
+        console.log(`[AUTO-UPDATE] ⚠️ Background download failed.`);
+        try { if (fs.existsSync(tempPath)) fs.unlinkSync(tempPath); } catch (e) {}
+      }
+    });
+    
+    bgProcess.unref();
+  }
+}
+
+/**
+ * 检查自动更新（后台异步）
+ * 1. 查询极狐GitLab最新版本
+ * 2. 如果有新版本，后台下载到临时目录
+ * 3. 下载完成后写入 .pending-update 标记
+ * 4. 下次启动时自动应用
+ */
+function checkAutoUpdate(platform, arch) {
+  // 不在后台检查中阻塞主进程
+  const installDir = getInstallDir(platform);
+  const pendingFile = path.join(installDir, '.pending-update');
+  
+  // 如果已有待更新，跳过检查
+  if (fs.existsSync(pendingFile)) {
+    try {
+      const pending = JSON.parse(fs.readFileSync(pendingFile, 'utf8'));
+      console.log(`[AUTO-UPDATE] Pending update v${pending.version} already queued. Will apply on next restart.`);
+      return;
+    } catch (e) {}
+  }
+  
+  // 检查上次检查时间（避免频繁查询，至少间隔4小时）
+  const lastCheckFile = path.join(installDir, '.last-update-check');
+  if (fs.existsSync(lastCheckFile)) {
+    try {
+      const lastCheck = new Date(fs.readFileSync(lastCheckFile, 'utf8').trim());
+      const hoursSinceLastCheck = (Date.now() - lastCheck.getTime()) / (1000 * 60 * 60);
+      if (hoursSinceLastCheck < 4) {
+        return; // 4小时内已检查过，跳过
+      }
+    } catch (e) {}
+  }
+  
+  // 记录检查时间
+  fs.writeFileSync(lastCheckFile, new Date().toISOString(), 'utf8');
+  
+  // 异步查询最新版本
+  fetchLatestVersion().then((latestVersion) => {
+    if (!latestVersion) {
+      return;
+    }
+    
+    const cmp = compareVersions(latestVersion, CURRENT_VERSION);
+    if (cmp > 0) {
+      console.log(`[AUTO-UPDATE] 🆕 New version available: v${latestVersion} (current: v${CURRENT_VERSION})`);
+      console.log(`[AUTO-UPDATE] Downloading in background...`);
+      backgroundDownloadUpdate(platform, arch, latestVersion);
+    }
+    // 版本相同或更高，无需更新
+  }).catch(() => {
+    // 静默失败，不影响正常使用
+  });
+}
+
 /**
  * 获取二进制安装目录
  */
@@ -93,7 +374,14 @@ function getBinaryPath() {
   const binPath = path.join(installDir, binName);
   const versionFile = path.join(installDir, '.version');
 
-  // 检查已安装的二进制
+  // 1. 首先检查并应用 pending update（此时旧进程已退出，文件不再锁定）
+  const updated = applyPendingUpdate(installDir);
+  if (updated) {
+    // 更新已应用，重新读取版本信息
+    console.log(`[INFO] Update applied. Starting with new version...`);
+  }
+
+  // 2. 检查已安装的二进制
   if (fs.existsSync(binPath)) {
     const stats = fs.statSync(binPath);
     if (stats.size > 10 * 1024 * 1024) {
@@ -105,29 +393,38 @@ function getBinaryPath() {
         if (cmp === 0) {
           // 版本精确匹配 → 直接使用
           console.log(`[INFO] SciAgent v${installedVersion} (${(stats.size / (1024 * 1024)).toFixed(1)} MB, ${stats.mtime.toISOString().slice(0,10)})`);
+          // 后台检查自动更新
+          checkAutoUpdate(platform, arch);
           return binPath;
         } else if (cmp < 0) {
           // 版本过低 → 自动下载新版本
           console.log(`[INFO] SciAgent version outdated: v${installedVersion} (${(stats.size / (1024 * 1024)).toFixed(1)} MB) → v${CURRENT_VERSION}`);
           console.log(`[INFO] Downloading new version from JiHuLab...`);
-          try { fs.unlinkSync(binPath); fs.unlinkSync(versionFile); } catch (e) {}
-          const downloaded = downloadBinary(platform, arch, CURRENT_VERSION);
-          if (downloaded) return downloaded;
-          console.error(`[ERROR] Failed to download v${CURRENT_VERSION}. Please run: npm install -g @sciagent/cli`);
-          process.exit(1);
+          // 注意：此时当前进程正在运行旧二进制，无法直接替换
+          // 下载到临时目录，写入 .pending-update，下次启动时应用
+          const downloaded = downloadBinaryToTemp(platform, arch, CURRENT_VERSION);
+          if (downloaded) {
+            console.log(`[INFO] ✅ New version downloaded. Please restart sciagent to apply update.`);
+            // 继续使用当前版本
+            return binPath;
+          }
+          // 下载失败，继续使用当前版本
+          console.log(`[INFO] ⚠️ Download failed. Continuing with current version.`);
+          return binPath;
         } else {
           // 版本更高 → 允许运行（用户可能手动安装了新版）
           console.log(`[INFO] SciAgent v${installedVersion} (newer than package v${CURRENT_VERSION}, ${(stats.size / (1024 * 1024)).toFixed(1)} MB)`);
+          checkAutoUpdate(platform, arch);
           return binPath;
         }
       } else {
-        // 没有.version文件 → 可能是旧安装，重新下载
+        // 没有.version文件 → 可能是旧安装，下载到临时目录
         console.log(`[INFO] SciAgent binary found but version unknown, downloading v${CURRENT_VERSION}...`);
-        try { fs.unlinkSync(binPath); } catch (e) {}
-        const downloaded = downloadBinary(platform, arch, CURRENT_VERSION);
-        if (downloaded) return downloaded;
-        console.error(`[ERROR] Failed to download v${CURRENT_VERSION}. Please run: npm install -g @sciagent/cli`);
-        process.exit(1);
+        const downloaded = downloadBinaryToTemp(platform, arch, CURRENT_VERSION);
+        if (downloaded) {
+          console.log(`[INFO] ✅ New version downloaded. Please restart sciagent to apply update.`);
+        }
+        return binPath;
       }
     } else {
       // 文件太小，损坏
@@ -151,6 +448,7 @@ function getBinaryPath() {
   
   const downloaded = downloadBinary(platform, arch, CURRENT_VERSION);
   if (downloaded && fs.existsSync(downloaded)) {
+    checkAutoUpdate(platform, arch);
     return downloaded;
   }
   
@@ -160,7 +458,90 @@ function getBinaryPath() {
 }
 
 /**
- * 从极狐GitLab下载二进制文件
+ * 从极狐GitLab下载二进制文件到临时目录（不替换当前运行的二进制）
+ * 下载完成后写入 .pending-update 标记，下次启动时自动应用
+ * 返回: tempPath 或 null
+ */
+function downloadBinaryToTemp(platform, arch, version) {
+  const binName = platform === 'win32' ? 'sciagent.exe' : 'sciagent';
+  const ext = platform === 'win32' ? '.exe' : '';
+  const filename = `sciagent-${platform}-${arch}${ext}`;
+  
+  const downloadUrl = (
+    `${JIHULAB_URL}/api/v4/projects/${JIHULAB_PROJECT_ID}` +
+    `/packages/generic/${JIHULAB_PACKAGE_NAME}/${version}/${filename}` +
+    `?access_token=${JIHULAB_DOWNLOAD_TOKEN}`
+  );
+  
+  const installDir = getInstallDir(platform);
+  const tempDir = path.join(os.tmpdir(), 'sciagent-update');
+  fs.mkdirSync(tempDir, { recursive: true });
+  const tempPath = path.join(tempDir, binName);
+  
+  // 清理旧的临时文件
+  try { if (fs.existsSync(tempPath)) fs.unlinkSync(tempPath); } catch (e) {}
+  
+  console.log(`   Downloading ${filename} v${version} to temp...`);
+  console.log(`   Temp: ${tempPath}`);
+  
+  try {
+    if (platform === 'win32') {
+      const tmpScript = path.join(os.tmpdir(), 'sciagent-download.ps1');
+      const scriptContent = [
+        '$ProgressPreference = "SilentlyContinue"',
+        `$uri = "${downloadUrl}"`,
+        `$out = "${tempPath}"`,
+        'Write-Host "  Downloading from JiHuLab..."',
+        'Invoke-WebRequest -Uri $uri -OutFile $out -UseBasicParsing',
+        'if (Test-Path $out) { $s = (Get-Item $out).Length; Write-Host "  Downloaded: $s bytes" } else { Write-Error "File not created"; exit 1 }'
+      ].join('\r\n');
+      fs.writeFileSync(tmpScript, scriptContent, 'utf8');
+      
+      try {
+        execSync(`powershell -NoProfile -ExecutionPolicy Bypass -File "${tmpScript}"`, {
+          stdio: 'inherit',
+          timeout: 600000
+        });
+      } finally {
+        try { fs.unlinkSync(tmpScript); } catch (e) {}
+      }
+    } else {
+      execSync(`curl -fsSL -o '${tempPath}' '${downloadUrl}'`, {
+        stdio: 'pipe',
+        timeout: 600000
+      });
+      fs.chmodSync(tempPath, 0o755);
+    }
+    
+    // 验证下载
+    if (fs.existsSync(tempPath)) {
+      const stats = fs.statSync(tempPath);
+      if (stats.size > 10 * 1024 * 1024) {
+        console.log(`   ✅ Downloaded: ${(stats.size / (1024 * 1024)).toFixed(1)} MB`);
+        // 写入 .pending-update 标记
+        const pendingData = {
+          version: version,
+          tempPath: tempPath,
+          timestamp: new Date().toISOString(),
+          platform: process.platform
+        };
+        fs.writeFileSync(path.join(installDir, '.pending-update'), JSON.stringify(pendingData, null, 2), 'utf8');
+        return tempPath;
+      } else {
+        console.error(`   ❌ Downloaded file too small: ${(stats.size / 1024).toFixed(0)} KB`);
+        try { fs.unlinkSync(tempPath); } catch (e) {}
+      }
+    }
+  } catch (e) {
+    console.error(`   ❌ Download failed: ${e.message}`);
+    try { if (fs.existsSync(tempPath)) fs.unlinkSync(tempPath); } catch (e2) {}
+  }
+  
+  return null;
+}
+
+/**
+ * 从极狐GitLab下载二进制文件（直接到目标路径，用于首次安装）
  */
 function downloadBinary(platform, arch, version) {
   const binName = platform === 'win32' ? 'sciagent.exe' : 'sciagent';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sciagent/cli",
-  "version": "1.1.9",
+  "version": "1.1.11",
   "description": "SciAgent CLI - AI Research Assistant",
   "main": "index.js",
   "files": [

package/scripts/postinstall.js

@@ -27,7 +27,7 @@ const ARCH_MAP = {
 };
 
 // 当前版本号 - 每次发布时同步更新
-const CURRENT_VERSION = '1.1.9';
+const CURRENT_VERSION = '1.1.11';
 
 // GitHub Releases 回退版本列表（当当前版本的 release 不存在时尝试）
 const GITHUB_FALLBACK_VERSIONS = ['1.1.3', '1.0.50', '1.0.48', '1.0.46', '1.0.40', '1.0.38', '1.0.36'];
@@ -528,6 +528,159 @@ const JIHULAB_PACKAGE_NAME = 'sciagent';
 // Deploy token with read_package_registry permission (for downloading)
 const JIHULAB_DOWNLOAD_TOKEN = '2qxfs606HfwESUYJxtRlgm86MQp1OjVnazAK.01.101vzs2qo';
 
+/**
+ * 检查 sciagent 进程是否正在运行
+ */
+function isSciAgentRunning() {
+  try {
+    if (process.platform === 'win32') {
+      const result = execSync('tasklist /FI "IMAGENAME eq sciagent.exe" /NH', {
+        encoding: 'utf8',
+        timeout: 5000
+      });
+      return result.includes('sciagent.exe');
+    } else {
+      const result = execSync('pgrep -x sciagent || true', {
+        encoding: 'utf8',
+        timeout: 5000
+      });
+      return result.trim().length > 0;
+    }
+  } catch (e) {
+    return false;
+  }
+}
+
+/**
+ * 终止 sciagent 进程
+ */
+function killSciAgent() {
+  try {
+    if (process.platform === 'win32') {
+      execSync('taskkill /F /IM sciagent.exe', { timeout: 10000 });
+    } else {
+      execSync('pkill -x sciagent', { timeout: 10000 });
+    }
+    // 等待进程完全退出
+    let retries = 10;
+    while (retries-- > 0 && isSciAgentRunning()) {
+      const sleep = require('util').promisify(setTimeout);
+      sleep(500);
+    }
+    return !isSciAgentRunning();
+  } catch (e) {
+    return false;
+  }
+}
+
+/**
+ * 尝试将临时文件替换为目标二进制文件
+ * 返回: 'replaced' | 'locked' | 'error'
+ */
+function tryReplaceBinary(tempPath, targetPath, installDir, version, platform) {
+  try {
+    // 先尝试直接复制
+    if (process.platform === 'win32') {
+      // Windows: 使用 PowerShell Copy-Item
+      const tmpScript = path.join(os.tmpdir(), 'sciagent-replace.ps1');
+      const scriptContent = [
+        `Copy-Item -Path "${tempPath}" -Destination "${targetPath}" -Force`,
+        'if (Test-Path $out) { Write-Host "OK" } else { Write-Error "Copy failed"; exit 1 }'
+      ].join('\r\n');
+      fs.writeFileSync(tmpScript, scriptContent, 'utf8');
+      try {
+        execSync(`powershell -NoProfile -ExecutionPolicy Bypass -File "${tmpScript}"`, {
+          stdio: 'pipe',
+          timeout: 30000
+        });
+      } finally {
+        try { fs.unlinkSync(tmpScript); } catch (e) {}
+      }
+    } else {
+      fs.copyFileSync(tempPath, targetPath);
+      fs.chmodSync(targetPath, 0o755);
+    }
+    
+    // 验证替换成功
+    if (fs.existsSync(targetPath)) {
+      const stats = fs.statSync(targetPath);
+      if (stats.size > 10 * 1024 * 1024) {
+        fs.writeFileSync(path.join(installDir, '.version'), version);
+        // 清理临时文件
+        try { fs.unlinkSync(tempPath); } catch (e) {}
+        return 'replaced';
+      }
+    }
+    return 'error';
+  } catch (e) {
+    // 检查是否是文件锁定错误
+    const msg = (e.message || '').toLowerCase();
+    if (msg.includes('used by another process') || msg.includes('being used') ||
+        msg.includes('eperm') || msg.includes('eacces') || msg.includes('access denied') ||
+        msg.includes('锁定') || msg.includes('denied')) {
+      return 'locked';
+    }
+    return 'error';
+  }
+}
+
+/**
+ * 写入 .pending-update 标记文件
+ * 下次 sciagent 启动时会自动应用更新
+ */
+function writePendingUpdate(installDir, tempPath, version) {
+  const pendingFile = path.join(installDir, '.pending-update');
+  const pendingData = {
+    version: version,
+    tempPath: tempPath,
+    timestamp: new Date().toISOString(),
+    platform: process.platform
+  };
+  fs.writeFileSync(pendingFile, JSON.stringify(pendingData, null, 2), 'utf8');
+  console.log(`  [PENDING] Update deferred. Written .pending-update marker.`);
+  console.log(`  [PENDING] New version will be applied on next sciagent startup.`);
+}
+
+/**
+ * 交互式提示用户选择更新方式
+ * 返回: 'kill' | 'defer'
+ */
+function promptUpdateChoice() {
+  // 检查是否在交互式终端中
+  if (!process.stdin.isTTY) {
+    console.log(`  [INFO] Non-interactive mode. Deferring update to next startup.`);
+    return 'defer';
+  }
+  
+  const readline = require('readline');
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  
+  return new Promise((resolve) => {
+    console.log('');
+    console.log('  ╔══════════════════════════════════════════════════════════╗');
+    console.log('  ║   SciAgent is currently running. Update requires        ║');
+    console.log('  ║   replacing the binary file which is locked.            ║');
+    console.log('  ╠══════════════════════════════════════════════════════════╣');
+    console.log('  ║   [K] Kill SciAgent & update now                        ║');
+    console.log('  ║   [D] Defer - update on next startup                    ║');
+    console.log('  ╚══════════════════════════════════════════════════════════╝');
+    console.log('');
+    
+    rl.question('  Choose [K/D] (default: D): ', (answer) => {
+      rl.close();
+      const choice = (answer || 'D').trim().toUpperCase();
+      if (choice === 'K' || choice === 'KILL') {
+        resolve('kill');
+      } else {
+        resolve('defer');
+      }
+    });
+  });
+}
+
 async function downloadFromJiHuLab(platform, arch, version) {
   const binName = platform === 'win32' ? 'sciagent.exe' : 'sciagent';
   const ext = platform === 'win32' ? '.exe' : '';
@@ -546,6 +699,14 @@ async function downloadFromJiHuLab(platform, arch, version) {
   fs.mkdirSync(installDir, { recursive: true });
   const targetPath = path.join(installDir, binName);
   
+  // 下载到临时目录（避免直接覆盖正在运行的二进制）
+  const tempDir = path.join(os.tmpdir(), 'sciagent-update');
+  fs.mkdirSync(tempDir, { recursive: true });
+  const tempPath = path.join(tempDir, binName);
+  
+  // 清理旧的临时文件
+  try { if (fs.existsSync(tempPath)) fs.unlinkSync(tempPath); } catch (e) {}
+  
   // Windows: 优先使用 PowerShell（更可靠的大文件下载）
   if (platform === 'win32') {
     try {
@@ -553,7 +714,7 @@ async function downloadFromJiHuLab(platform, arch, version) {
       const scriptContent = [
         '$ProgressPreference = "SilentlyContinue"',
         `$uri = "${downloadUrl}"`,
-        `$out = "${targetPath}"`,
+        `$out = "${tempPath}"`,
         'Write-Host "  [JiHuLab] Downloading..."',
         'Invoke-WebRequest -Uri $uri -OutFile $out -UseBasicParsing',
         'if (Test-Path $out) { $s = (Get-Item $out).Length; Write-Host "  [JiHuLab] Downloaded: $s bytes" } else { Write-Error "File not created"; exit 1 }'
@@ -569,13 +730,13 @@ async function downloadFromJiHuLab(platform, arch, version) {
         try { fs.unlinkSync(tmpScript); } catch (e) {}
       }
       
-      // 验证下载
-      if (fs.existsSync(targetPath)) {
-        const stats = fs.statSync(targetPath);
+      // 验证下载到临时文件
+      if (fs.existsSync(tempPath)) {
+        const stats = fs.statSync(tempPath);
         if (stats.size > 10 * 1024 * 1024) {
-          console.log(`  [OK] JiHuLab download success: ${targetPath} (${(stats.size / (1024 * 1024)).toFixed(1)} MB)`);
-          fs.writeFileSync(path.join(installDir, '.version'), version);
-          return true;
+          console.log(`  [OK] Downloaded to temp: ${tempPath} (${(stats.size / (1024 * 1024)).toFixed(1)} MB)`);
+          // 尝试替换
+          return await applyDownloadedBinary(tempPath, targetPath, installDir, version, platform);
         }
       }
       
@@ -585,21 +746,20 @@ async function downloadFromJiHuLab(platform, arch, version) {
     }
   }
   
-  // 通用方式: Node.js https 下载
+  // 通用方式: Node.js https 下载到临时文件
   try {
-    await downloadFile(downloadUrl, targetPath, 600000); // 10 分钟超时
+    await downloadFile(downloadUrl, tempPath, 600000); // 10 分钟超时
     
     // 验证下载
-    if (fs.existsSync(targetPath)) {
-      const stats = fs.statSync(targetPath);
+    if (fs.existsSync(tempPath)) {
+      const stats = fs.statSync(tempPath);
       if (stats.size > 10 * 1024 * 1024) {
-        console.log(`  [OK] JiHuLab download success: ${targetPath} (${(stats.size / (1024 * 1024)).toFixed(1)} MB)`);
+        console.log(`  [OK] Downloaded to temp: ${tempPath} (${(stats.size / (1024 * 1024)).toFixed(1)} MB)`);
         if (platform !== 'win32') {
-          fs.chmodSync(targetPath, 0o755);
+          fs.chmodSync(tempPath, 0o755);
         }
-        // 写入版本文件
-        fs.writeFileSync(path.join(installDir, '.version'), version);
-        return true;
+        // 尝试替换
+        return await applyDownloadedBinary(tempPath, targetPath, installDir, version, platform);
       }
     }
     
@@ -611,6 +771,89 @@ async function downloadFromJiHuLab(platform, arch, version) {
   }
 }
 
+/**
+ * 将已下载到临时路径的二进制文件应用到目标位置
+ * 处理文件锁定情况：交互式选择杀死进程或延迟更新
+ */
+async function applyDownloadedBinary(tempPath, targetPath, installDir, version, platform) {
+  // 如果目标文件不存在（首次安装），直接移动
+  if (!fs.existsSync(targetPath)) {
+    try {
+      if (process.platform === 'win32') {
+        // Windows: 使用 PowerShell 移动
+        const tmpScript = path.join(os.tmpdir(), 'sciagent-move.ps1');
+        const scriptContent = `Move-Item -Path "${tempPath}" -Destination "${targetPath}" -Force`;
+        fs.writeFileSync(tmpScript, scriptContent, 'utf8');
+        try {
+          execSync(`powershell -NoProfile -ExecutionPolicy Bypass -File "${tmpScript}"`, {
+            stdio: 'pipe', timeout: 30000
+          });
+        } finally {
+          try { fs.unlinkSync(tmpScript); } catch (e) {}
+        }
+      } else {
+        fs.renameSync(tempPath, targetPath);
+        fs.chmodSync(targetPath, 0o755);
+      }
+      fs.writeFileSync(path.join(installDir, '.version'), version);
+      console.log(`  [OK] Installed: ${targetPath}`);
+      return true;
+    } catch (e) {
+      console.log(`  [WARN] Move failed: ${e.message}, trying copy...`);
+      // fallback to copy
+      const result = tryReplaceBinary(tempPath, targetPath, installDir, version, platform);
+      return result === 'replaced';
+    }
+  }
+  
+  // 目标文件已存在，尝试替换
+  const replaceResult = tryReplaceBinary(tempPath, targetPath, installDir, version, platform);
+  
+  if (replaceResult === 'replaced') {
+    console.log(`  [OK] Updated: ${targetPath} (v${version})`);
+    return true;
+  }
+  
+  if (replaceResult === 'locked') {
+    console.log(`  [WARN] Binary file is locked (SciAgent is running).`);
+    
+    // 交互式选择
+    const choice = await promptUpdateChoice();
+    
+    if (choice === 'kill') {
+      console.log(`  [INFO] Killing SciAgent process...`);
+      const killed = killSciAgent();
+      if (killed) {
+        console.log(`  [OK] SciAgent process terminated.`);
+        // 重试替换
+        const retryResult = tryReplaceBinary(tempPath, targetPath, installDir, version, platform);
+        if (retryResult === 'replaced') {
+          console.log(`  [OK] Updated: ${targetPath} (v${version})`);
+          return true;
+        } else {
+          console.log(`  [WARN] Replace still failed after killing process. Deferring to next startup.`);
+          writePendingUpdate(installDir, tempPath, version);
+          return true; // 下载成功，只是替换延迟
+        }
+      } else {
+        console.log(`  [WARN] Failed to kill SciAgent. Deferring update to next startup.`);
+        writePendingUpdate(installDir, tempPath, version);
+        return true; // 下载成功，只是替换延迟
+      }
+    } else {
+      // 用户选择延迟
+      writePendingUpdate(installDir, tempPath, version);
+      console.log(`  [INFO] Update will be applied automatically on next startup.`);
+      return true; // 下载成功，只是替换延迟
+    }
+  }
+  
+  // 其他错误
+  console.log(`  [WARN] Replace failed with unexpected error. Deferring to next startup.`);
+  writePendingUpdate(installDir, tempPath, version);
+  return true; // 下载成功，只是替换延迟
+}
+
 async function downloadFromServer(platform, arch, version) {
   const binName = platform === 'win32' ? 'sciagent.exe' : 'sciagent';
   const downloadUrl = `${RELEASE_SERVER_URL}/api/releases/download/${platform}/${arch}/${version}`;
@@ -623,24 +866,28 @@ async function downloadFromServer(platform, arch, version) {
   
   const targetPath = path.join(installDir, binName);
   
+  // 下载到临时目录
+  const tempDir = path.join(os.tmpdir(), 'sciagent-update');
+  fs.mkdirSync(tempDir, { recursive: true });
+  const tempPath = path.join(tempDir, binName);
+  try { if (fs.existsSync(tempPath)) fs.unlinkSync(tempPath); } catch (e) {}
+  
   try {
-    await downloadFile(downloadUrl, targetPath, 600000); // 10 分钟超时
+    await downloadFile(downloadUrl, tempPath, 600000); // 10 分钟超时
     
     // 验证下载
-    if (fs.existsSync(targetPath)) {
-      const stats = fs.statSync(targetPath);
+    if (fs.existsSync(tempPath)) {
+      const stats = fs.statSync(tempPath);
       if (stats.size > 10 * 1024 * 1024) { // 至少 10MB
-        console.log(`  ✅ 下载成功: ${targetPath} (${(stats.size / (1024 * 1024)).toFixed(1)} MB)`);
+        console.log(`  ✅ 下载到临时文件: ${tempPath} (${(stats.size / (1024 * 1024)).toFixed(1)} MB)`);
         
         // Linux/macOS 添加执行权限
         if (platform !== 'win32') {
-          fs.chmodSync(targetPath, 0o755);
+          fs.chmodSync(tempPath, 0o755);
         }
         
-        // 写入版本文件
-        fs.writeFileSync(path.join(installDir, '.version'), version);
-        
-        return true;
+        // 尝试替换（处理文件锁定）
+        return await applyDownloadedBinary(tempPath, targetPath, installDir, version, platform);
       }
     }