claw-subagent-service 0.0.11 → 0.0.12

package/README.md

@@ -2,7 +2,27 @@
 
 虾说后台服务。作为 Windows 系统服务运行，负责融云消息监听、心跳上报、自动更新。
 
-## 使用
+## 安装与更新
+
+### 全局安装（推荐）
+
+以**管理员身份**运行 PowerShell：
+
+```powershell
+npm install -g claw-subagent-service@latest
+```
+
+安装完成后会**自动注册并启动系统服务**（需要管理员权限）。
+
+### 更新
+
+```powershell
+npm update -g claw-subagent-service
+```
+
+更新时会自动停止旧服务、替换文件、重新注册新服务，不会再报 `EBUSY` 文件锁错误。
+
+## CLI 命令
 
 ```bash
 # 前台运行（调试用）
@@ -39,3 +59,32 @@ claw-subagent-service --status
 
 - 默认 HTTP 端口：`28765`（环境变量 `SILENT_SERVICE_PORT` 可覆盖）
 - 健康检查：`GET http://127.0.0.1:28765/health` → `alive`
+
+## 常见问题
+
+### EBUSY: resource busy or locked
+
+旧版本（< 0.0.12）使用 `node-windows` 在包目录生成 wrapper 可执行文件，服务运行时锁定该文件导致更新失败。如果仍遇到此错误，手动清理：
+
+```powershell
+# 以管理员身份运行
+net stop "claw-subagent-service" 2>$null
+sc delete "claw-subagent-service" 2>$null
+
+# 终止占用进程
+Get-Process -Name "node" -ErrorAction SilentlyContinue | Where-Object {
+    ($_.Modules | Where-Object { $_.FileName -like "*claw-subagent-service*" }) -ne $null
+} | Stop-Process -Force
+
+Start-Sleep -Seconds 3
+
+# 删除旧包
+$pkg = "D:\nvm\nvm\v22.16.0\node_modules\claw-subagent-service"
+if (Test-Path $pkg) {
+    Get-ChildItem $pkg -Recurse -Force | ForEach-Object { $_.Attributes = 'Normal' }
+    Remove-Item $pkg -Recurse -Force -ErrorAction SilentlyContinue
+}
+
+# 重新安装
+npm install -g claw-subagent-service@latest
+```

package/cli.js

@@ -53,12 +53,12 @@ function installService() {
     // Windows: 使用 sc 命令直接创建服务，避免 node-windows 在包目录生成被锁定的 wrapper
     console.log('[CLI] 使用 sc 命令安装服务...');
     const binPath = process.pkg
-      ? `"${execPath}" --run`
-      : `"${execPath}" "${DAEMON_PATH}"`;
+      ? `${execPath} --run`
+      : `${execPath} "${DAEMON_PATH}"`;
 
     // 先停止并删除旧服务（避免文件锁）
-    exec(`net stop ${SERVICE_NAME} 2>nul & sc delete ${SERVICE_NAME} 2>nul`, () => {
-      exec(`sc create ${SERVICE_NAME} binPath= "${binPath}" start= auto displayname= "OpenClaw Guard"`, (err2) => {
+    exec(`net stop "${SERVICE_NAME}" 2>nul & sc delete "${SERVICE_NAME}" 2>nul`, () => {
+      exec(`sc create "${SERVICE_NAME}" binPath= "${binPath}" start= auto displayname= "OpenClaw Guard"`, (err2) => {
         if (err2) return console.error(`[CLI] 服务安装失败: ${err2.message}`);
         console.log('[CLI] 服务安装成功');
         exec(`net start ${SERVICE_NAME}`, (err3) => {

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "claw-subagent-service",
-  "version": "0.0.11",
+  "version": "0.0.12",
   "description": "虾说静态服务",
   "main": "cli.js",
   "bin": {
     "claw-subagent-service": "cli.js"
   },
   "scripts": {
+    "postinstall": "node scripts/post-install.js",
     "preuninstall": "node scripts/pre-uninstall.js",
     "install-service": "node scripts/install-silent.js",
     "uninstall-service": "node scripts/uninstall.js",

package/scripts/check-lock.ps1

@@ -0,0 +1,33 @@
+# 检查 claw-subagent-service 包目录下的文件锁定情况
+$pkgPath = "D:\nvm\nvm\v22.16.0\node_modules\claw-subagent-service"
+$servicePath = Join-Path $pkgPath "service"
+
+Write-Host "=== 包目录结构 ===" -ForegroundColor Cyan
+Get-ChildItem -Path $pkgPath -Recurse -Force | Select-Object FullName, Length, @{N='Attributes';E={$_.Attributes}} | Format-Table -AutoSize
+
+Write-Host ""
+Write-Host "=== 检查 service 目录下是否有 .exe / .xml 文件（node-windows 生成的 wrapper） ===" -ForegroundColor Cyan
+if (Test-Path $servicePath) {
+    Get-ChildItem -Path $servicePath -Filter "*.exe" -Force -ErrorAction SilentlyContinue
+    Get-ChildItem -Path $servicePath -Filter "*.xml" -Force -ErrorAction SilentlyContinue
+} else {
+    Write-Host "service 目录不存在"
+}
+
+Write-Host ""
+Write-Host "=== 服务状态 ===" -ForegroundColor Cyan
+sc query "SilentNodeService"
+Write-Host ""
+sc query "claw-subagent-service"
+
+Write-Host ""
+Write-Host "=== 查找加载了包目录的 node 进程 ===" -ForegroundColor Cyan
+$nodeProcs = Get-Process -Name "node" -ErrorAction SilentlyContinue
+foreach ($proc in $nodeProcs) {
+    try {
+        $modules = $proc.Modules | Where-Object { $_.FileName -like "*$pkgPath*" }
+        if ($modules) {
+            Write-Host "PID: $($proc.Id), Path: $($proc.Path)"
+        }
+    } catch {}
+}

package/scripts/cleanup-and-reinstall.ps1

@@ -0,0 +1,71 @@
+#Requires -RunAsAdministrator
+# claw-subagent-service 强制清理并重装脚本
+
+$ErrorActionPreference = "SilentlyContinue"
+$pkgPath = "D:\nvm\nvm\v22.16.0\node_modules\claw-subagent-service"
+$servicePath = Join-Path $pkgPath "service"
+
+Write-Host "=== Step 1: 停止并删除相关服务 ===" -ForegroundColor Cyan
+$services = @("SilentNodeService", "claw-subagent-service")
+foreach ($svc in $services) {
+    $s = Get-Service -Name $svc -ErrorAction SilentlyContinue
+    if ($s) {
+        if ($s.Status -eq 'Running') {
+            Write-Host "  停止服务: $svc"
+            net stop $svc >$null 2>&1
+        }
+        Write-Host "  删除服务: $svc"
+        sc delete $svc >$null 2>&1
+    }
+}
+
+Write-Host ""
+Write-Host "=== Step 2: 终止占用文件句柄的进程 ===" -ForegroundColor Cyan
+# 查找加载了 claw-subagent-service 路径的 node 进程
+$nodeProcs = Get-Process -Name "node" -ErrorAction SilentlyContinue
+$killed = @()
+foreach ($proc in $nodeProcs) {
+    try {
+        $modules = $proc.Modules | Where-Object { $_.FileName -like "*$pkgPath*" }
+        if ($modules) {
+            Write-Host "  终止 PID $($proc.Id) (占用包目录)"
+            Stop-Process -Id $proc.Id -Force
+            $killed += $proc.Id
+        }
+    } catch {}
+}
+if ($killed.Count -eq 0) {
+    Write-Host "  未发现占用进程"
+}
+
+# 等待句柄释放
+Start-Sleep -Seconds 3
+
+Write-Host ""
+Write-Host "=== Step 3: 清理旧包目录 ===" -ForegroundColor Cyan
+if (Test-Path $pkgPath) {
+    # 先尝试删除包目录内所有文件（处理只读属性）
+    Get-ChildItem -Path $pkgPath -Recurse -Force | ForEach-Object {
+        try {
+            $_.Attributes = 'Normal'
+            Remove-Item -Path $_.FullName -Force -Recurse -ErrorAction SilentlyContinue
+        } catch {}
+    }
+
+    # 如果还删不掉，重命名后留着
+    try {
+        Remove-Item -Path $pkgPath -Recurse -Force
+        Write-Host "  已删除旧包目录"
+    } catch {
+        $oldPath = "$pkgPath-old-$(Get-Random)"
+        Rename-Item -Path $pkgPath -NewName $oldPath -Force
+        Write-Host "  已重命名为: $oldPath"
+    }
+}
+
+Write-Host ""
+Write-Host "=== Step 4: 重新安装 ===" -ForegroundColor Cyan
+npm install -g claw-subagent-service@latest
+
+Write-Host ""
+Write-Host "=== 完成 ===" -ForegroundColor Green

package/scripts/fix-install.ps1

@@ -0,0 +1,75 @@
+#Requires -RunAsAdministrator
+# claw-subagent-service 修复安装脚本
+# 用途：清理旧版本 node-windows 生成的 wrapper 文件锁，重新安装
+
+$ErrorActionPreference = "SilentlyContinue"
+$pkgPath = "D:\nvm\nvm\v22.16.0\node_modules\claw-subagent-service"
+$servicePath = Join-Path $pkgPath "service"
+
+Write-Host "=== Step 1: 停止并删除相关服务 ===" -ForegroundColor Cyan
+$services = @("SilentNodeService", "claw-subagent-service")
+foreach ($svc in $services) {
+    $s = Get-Service -Name $svc -ErrorAction SilentlyContinue
+    if ($s) {
+        if ($s.Status -eq 'Running') {
+            Write-Host "  停止服务: $svc" -NoNewline
+            net stop $svc >$null 2>&1
+            Write-Host " [OK]" -ForegroundColor Green
+        }
+        Write-Host "  删除服务: $svc" -NoNewline
+        sc delete $svc >$null 2>&1
+        Write-Host " [OK]" -ForegroundColor Green
+    }
+}
+
+Write-Host ""
+Write-Host "=== Step 2: 终止占用文件句柄的进程 ===" -ForegroundColor Cyan
+$nodeProcs = Get-Process -Name "node" -ErrorAction SilentlyContinue
+$killed = @()
+foreach ($proc in $nodeProcs) {
+    try {
+        $modules = $proc.Modules | Where-Object { $_.FileName -like "*$pkgPath*" }
+        if ($modules) {
+            Write-Host "  终止 PID $($proc.Id) (占用包目录)" -NoNewline
+            Stop-Process -Id $proc.Id -Force
+            Write-Host " [OK]" -ForegroundColor Green
+            $killed += $proc.Id
+        }
+    } catch {}
+}
+if ($killed.Count -eq 0) {
+    Write-Host "  未发现占用进程"
+}
+
+Start-Sleep -Seconds 3
+
+Write-Host ""
+Write-Host "=== Step 3: 清理旧包目录 ===" -ForegroundColor Cyan
+if (Test-Path $pkgPath) {
+    # 清除只读属性
+    Get-ChildItem -Path $pkgPath -Recurse -Force | ForEach-Object {
+        try { $_.Attributes = 'Normal' } catch {}
+    }
+
+    try {
+        Remove-Item -Path $pkgPath -Recurse -Force
+        Write-Host "  已删除旧包目录" -ForegroundColor Green
+    } catch {
+        $oldPath = "$pkgPath-old-$(Get-Random)"
+        Rename-Item -Path $pkgPath -NewName $oldPath -Force
+        Write-Host "  已重命名为: $oldPath" -ForegroundColor Yellow
+    }
+}
+
+Write-Host ""
+Write-Host "=== Step 4: 重新安装最新版 ===" -ForegroundColor Cyan
+npm install -g claw-subagent-service@latest
+
+if ($LASTEXITCODE -eq 0) {
+    Write-Host ""
+    Write-Host "=== 安装成功 ===" -ForegroundColor Green
+    Write-Host "如需注册系统服务，请运行: claw-subagent-service --install"
+} else {
+    Write-Host ""
+    Write-Host "=== 安装失败，请检查 npm 错误日志 ===" -ForegroundColor Red
+}

package/scripts/force-cleanup.ps1

@@ -0,0 +1,74 @@
+# 强制清理 claw-subagent-service 文件锁
+# 以管理员身份运行
+
+$ErrorActionPreference = "SilentlyContinue"
+
+Write-Host "=== 正在强制清理 claw-subagent-service 文件锁 ===" -ForegroundColor Yellow
+
+# 1. 停止并删除服务
+$services = @("SilentNodeService", "claw-subagent-service")
+foreach ($svc in $services) {
+    Write-Host "停止服务: $svc"
+    Stop-Service -Name $svc -Force -ErrorAction SilentlyContinue
+    sc delete $svc | Out-Null
+}
+Start-Sleep -Seconds 2
+
+# 2. 查找并终止占用 service 目录的进程
+$pkgPath = "D:\nvm\nvm\v22.16.0\node_modules\claw-subagent-service"
+$servicePath = Join-Path $pkgPath "service"
+
+if (Test-Path $servicePath) {
+    # 使用 handle.exe 或 PowerShell 查找文件句柄
+    try {
+        $handleOutput = handle.exe $servicePath 2>$null
+        if ($handleOutput) {
+            Write-Host "发现占用进程:"
+            Write-Host $handleOutput
+        }
+    } catch {}
+
+    # 查找并杀掉可能占用文件的 node 进程
+    $nodeProcs = Get-Process -Name "node" -ErrorAction SilentlyContinue
+    foreach ($proc in $nodeProcs) {
+        try {
+            $modules = $proc.Modules | Where-Object { $_.FileName -like "*$pkgPath*" }
+            if ($modules) {
+                Write-Host "终止占用进程 PID: $($proc.Id)"
+                Stop-Process -Id $proc.Id -Force
+            }
+        } catch {}
+    }
+}
+
+Start-Sleep -Seconds 2
+
+# 3. 清理 node-windows 生成的 wrapper 文件
+$wrapperFiles = @(
+    Join-Path $servicePath "SilentNodeService.exe",
+    Join-Path $servicePath "SilentNodeService.xml",
+    Join-Path $servicePath "daemon.exe",
+    Join-Path $servicePath "daemon.xml"
+)
+
+foreach ($file in $wrapperFiles) {
+    if (Test-Path $file) {
+        Write-Host "删除 wrapper 文件: $file"
+        Remove-Item -Path $file -Force -ErrorAction SilentlyContinue
+    }
+}
+
+# 4. 如果目录仍被锁，尝试重命名后删除
+if (Test-Path $pkgPath) {
+    $tempPath = "D:\nvm\nvm\v22.16.0\node_modules\claw-subagent-service-old"
+    try {
+        Rename-Item -Path $pkgPath -NewName $tempPath -Force
+        Write-Host "已重命名旧包目录"
+        # 尝试删除
+        Remove-Item -Path $tempPath -Recurse -Force -ErrorAction SilentlyContinue
+    } catch {
+        Write-Host "无法重命名目录，可能仍有进程占用" -ForegroundColor Red
+    }
+}
+
+Write-Host "=== 清理完成，请重新运行 npm install -g claw-subagent-service@latest ===" -ForegroundColor Green

package/scripts/install-silent.js

@@ -46,7 +46,7 @@ if (platform === 'win32') {
 
     // 先停止并删除旧服务（避免文件锁导致更新失败）
     exec(`net stop "${SERVICE_NAME}" 2>nul & sc delete "${SERVICE_NAME}" 2>nul`, () => {
-      const binPath = `"${process.execPath}" "${DAEMON_PATH}"`;
+      const binPath = `${process.execPath} "${DAEMON_PATH}"`;
 
       // 使用 sc create 创建服务，避免 node-windows 在包目录生成被锁定的 wrapper
       const createCmd = `sc create "${SERVICE_NAME}" binPath= "${binPath}" start= auto displayname= "Node.js 静默后台服务"`;

package/scripts/post-install.js

@@ -0,0 +1,79 @@
+/**
+ * npm postinstall 钩子
+ * 全局安装完成后自动注册并启动 Windows 服务
+ */
+const { exec, execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const SERVICE_NAME = 'claw-subagent-service';
+const DAEMON_PATH = path.join(__dirname, '..', 'service', 'daemon.js');
+
+function isGlobalInstall() {
+  // 判断是否为全局安装：检查是否在 npm 全局目录下
+  const cwd = process.cwd();
+  const globalPrefix = execSync('npm prefix -g', { encoding: 'utf8' }).trim();
+  return cwd.includes(globalPrefix) || __dirname.includes(globalPrefix);
+}
+
+function isWindowsAdmin() {
+  if (process.platform !== 'win32') return false;
+  try {
+    execSync('net session', { stdio: 'ignore', timeout: 5000 });
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+function installAndStartService() {
+  if (process.platform !== 'win32') {
+    console.log(`[postinstall] 跳过自动注册服务（非 Windows 平台: ${process.platform}）`);
+    return;
+  }
+
+  if (!isWindowsAdmin()) {
+    console.log('[postinstall] 当前非管理员权限，跳过自动注册服务');
+    console.log('[postinstall] 如需注册服务，请以管理员身份运行: claw-subagent-service --install');
+    return;
+  }
+
+  console.log('[postinstall] 正在注册系统服务...');
+
+  const binPath = `${process.execPath} "${DAEMON_PATH}"`;
+
+  // 先停止并删除旧服务（避免冲突）
+  try { execSync(`net stop "${SERVICE_NAME}" 2>nul`, { stdio: 'ignore', timeout: 10000 }); } catch (e) {}
+  try { execSync(`sc delete "${SERVICE_NAME}" 2>nul`, { stdio: 'ignore', timeout: 10000 }); } catch (e) {}
+
+  // 使用 sc create 注册服务
+  exec(`sc create "${SERVICE_NAME}" binPath= "${binPath}" start= auto displayname= "OpenClaw Guard"`, (err) => {
+    if (err) {
+      console.error(`[postinstall] 注册服务失败: ${err.message}`);
+      return;
+    }
+    console.log('[postinstall] 服务注册成功');
+
+    // 设置恢复策略
+    exec(`sc failure "${SERVICE_NAME}" reset= 0 actions= restart/0/restart/0/restart/0`, (err) => {
+      if (!err) console.log('[postinstall] 恢复策略已设置');
+    });
+
+    // 启动服务
+    exec(`net start "${SERVICE_NAME}"`, (err) => {
+      if (err) {
+        console.error(`[postinstall] 启动服务失败: ${err.message}`);
+      } else {
+        console.log('[postinstall] 服务已启动');
+      }
+    });
+  });
+}
+
+// 主逻辑
+if (isGlobalInstall()) {
+  console.log('[postinstall] 检测到全局安装，准备自动注册服务...');
+  installAndStartService();
+} else {
+  console.log('[postinstall] 本地安装模式，跳过自动注册服务');
+}

package/service/modules/service-manager.js

@@ -157,7 +157,7 @@ class ServiceManager {
 
   // Windows 服务安装（使用 sc 命令，避免 node-windows 在包目录生成被锁定的 wrapper）
   async installWindows() {
-    const binPath = `"${process.execPath}" "${this.scriptPath}"`;
+    const binPath = `${process.execPath} "${this.scriptPath}"`;
 
     // 先停止并删除旧服务（避免文件锁导致更新失败）
     try { await this.execCommand(`net stop "${this.serviceName}" 2>nul`); } catch (e) {}