- packages/protocol: 协议定义(信封/方法/错误码/能力schema/校验/HMAC/ULID) - packages/client: 控制端客户端库(连接/握手/invoke/超时) - apps/agent: Windows 被控端(监听/HMAC认证/能力分发/7项能力/进程执行) - apps/cli: 控制端 CLI(connect/info/status/ps/services/exec/apps/install/list/invoke) - apps/mcp: MCP server(na_* 工具,接入 WorkBuddy) - scripts: install.ps1 / uninstall.ps1(开机自启 + 防火墙 + 密钥生成) - tests/e2e: 端到端测试 13/13 通过(握手/能力/超时强杀/参数校验/鉴权失败/未认证)
163 lines
5.8 KiB
PowerShell
163 lines
5.8 KiB
PowerShell
<#
|
|
.SYNOPSIS
|
|
nodeagent - Windows agent installer.
|
|
|
|
.DESCRIPTION
|
|
Registers the nodeagent agent as a scheduled task (auto-start on logon),
|
|
opens the inbound firewall port, and prints connection info for the Mac side.
|
|
|
|
Prerequisites on the Windows machine:
|
|
1. Node.js 22+ (https://nodejs.org)
|
|
2. This repository (git clone, or copy the folder over)
|
|
3. Built artifacts (run `pnpm install` then `pnpm build` in the repo root)
|
|
|
|
.EXAMPLE
|
|
# Run as Administrator from the repo root
|
|
powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1
|
|
|
|
.EXAMPLE
|
|
.\install.ps1 -Port 8765 -NodeId my-pc
|
|
#>
|
|
[CmdletBinding()]
|
|
param(
|
|
[int]$Port = 8765,
|
|
[string]$NodeId = $env:COMPUTERNAME,
|
|
[string]$Key = "",
|
|
[switch]$NoTls,
|
|
[string]$ProjectRoot = ""
|
|
)
|
|
|
|
$ErrorActionPreference = "Stop"
|
|
|
|
function Write-Step($m) { Write-Host "[*] $m" -ForegroundColor Cyan }
|
|
function Write-Ok($m) { Write-Host "[+] $m" -ForegroundColor Green }
|
|
function Write-Warn($m) { Write-Host "[!] $m" -ForegroundColor Yellow }
|
|
function Write-Err($m) { Write-Host "[x] $m" -ForegroundColor Red }
|
|
|
|
Write-Host ""
|
|
Write-Host " nodeagent installer" -ForegroundColor White
|
|
Write-Host " -------------------" -ForegroundColor DarkGray
|
|
|
|
# 1. Require Administrator
|
|
$isAdmin = ([Security.Principal.WindowsPrincipal] `
|
|
[Security.Principal.WindowsIdentity]::GetCurrent()
|
|
).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
|
|
if (-not $isAdmin) {
|
|
Write-Err "Please run this script as Administrator."
|
|
exit 1
|
|
}
|
|
|
|
# 2. Check Node.js
|
|
Write-Step "Checking Node.js..."
|
|
$nodeCmd = Get-Command node -ErrorAction SilentlyContinue
|
|
if (-not $nodeCmd) {
|
|
Write-Err "Node.js not found. Install Node.js 22+ from https://nodejs.org"
|
|
exit 1
|
|
}
|
|
$ver = (& node --version).TrimStart('v')
|
|
$major = [int]($ver.Split('.')[0])
|
|
if ($major -lt 22) {
|
|
Write-Err "Node.js 22+ required, found v$ver"
|
|
exit 1
|
|
}
|
|
Write-Ok "Node.js v$ver"
|
|
|
|
# 3. Locate the built agent
|
|
if (-not $ProjectRoot) { $ProjectRoot = Split-Path -Parent $PSScriptRoot }
|
|
$agentJs = Join-Path $ProjectRoot "apps\agent\dist\index.js"
|
|
if (-not (Test-Path $agentJs)) {
|
|
Write-Err "Agent build not found: $agentJs"
|
|
Write-Warn "Run 'pnpm install' and 'pnpm build' in the repo root first."
|
|
exit 1
|
|
}
|
|
Write-Ok "Agent entry: $agentJs"
|
|
|
|
# 4. Config + pre-shared key
|
|
$cfgDir = Join-Path $env:USERPROFILE ".nodeagent"
|
|
$cfgPath = Join-Path $cfgDir "agent.json"
|
|
New-Item -ItemType Directory -Force -Path $cfgDir | Out-Null
|
|
|
|
if (Test-Path $cfgPath) {
|
|
try { $existing = Get-Content $cfgPath -Raw | ConvertFrom-Json } catch { $existing = $null }
|
|
if ($existing -and -not $Key) {
|
|
$Key = $existing.key
|
|
Write-Ok "Existing config found, reusing its key"
|
|
}
|
|
}
|
|
if (-not $Key) {
|
|
$bytes = New-Object byte[] 32
|
|
[System.Security.Cryptography.RandomNumberGenerator]::Create().GetBytes($bytes)
|
|
$Key = ($bytes | ForEach-Object { $_.ToString('x2') }) -join ''
|
|
Write-Ok "Generated a new pre-shared key"
|
|
}
|
|
|
|
@{
|
|
node_id = $NodeId
|
|
host = "0.0.0.0"
|
|
port = $Port
|
|
tls = (-not $NoTls)
|
|
key = $Key
|
|
log_level = "info"
|
|
} | ConvertTo-Json | Set-Content -Path $cfgPath -Encoding UTF8
|
|
Write-Ok "Config written: $cfgPath"
|
|
|
|
# 5. Firewall (inbound, agent listens)
|
|
Write-Step "Configuring firewall..."
|
|
$ruleName = "nodeagent (TCP $Port)"
|
|
Get-NetFirewallRule -DisplayName $ruleName -ErrorAction SilentlyContinue |
|
|
Remove-NetFirewallRule -ErrorAction SilentlyContinue
|
|
New-NetFirewallRule -DisplayName $ruleName -Direction Inbound -Action Allow `
|
|
-Protocol TCP -LocalPort $Port -Profile Any | Out-Null
|
|
Write-Ok "Inbound rule allowed on TCP $Port"
|
|
|
|
# 6. Scheduled task (auto start on logon, highest privileges)
|
|
Write-Step "Registering scheduled task..."
|
|
$taskName = "nodeagent"
|
|
$nodeExe = $nodeCmd.Source
|
|
$action = New-ScheduledTaskAction -Execute $nodeExe -Argument "`"$agentJs`"" -WorkingDirectory $ProjectRoot
|
|
$trigger = New-ScheduledTaskTrigger -AtLogOn
|
|
$settings = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries `
|
|
-RestartCount 3 -RestartInterval (New-TimeSpan -Minutes 1) -ExecutionTimeLimit ([TimeSpan]::Zero)
|
|
$principal = New-ScheduledTaskPrincipal -UserId "$env:USERDOMAIN\$env:USERNAME" `
|
|
-RunLevel Highest -LogonType Interactive
|
|
|
|
Unregister-ScheduledTask -TaskName $taskName -Confirm:$false -ErrorAction SilentlyContinue
|
|
Register-ScheduledTask -TaskName $taskName -Action $action -Trigger $trigger `
|
|
-Settings $settings -Principal $principal `
|
|
-Description "nodeagent - cross-machine AI takeover agent" | Out-Null
|
|
Write-Ok "Scheduled task '$taskName' registered (auto-start on logon)"
|
|
|
|
# 7. Start now
|
|
Write-Step "Starting agent..."
|
|
Start-ScheduledTask -TaskName $taskName
|
|
Start-Sleep -Seconds 2
|
|
$state = (Get-ScheduledTask -TaskName $taskName).State
|
|
Write-Ok "Task state: $state"
|
|
|
|
# 8. Print connection info
|
|
$ips = @()
|
|
try {
|
|
$ips = (Get-NetIPAddress -AddressFamily IPv4 -ErrorAction SilentlyContinue |
|
|
Where-Object { $_.IPAddress -notlike '127.*' -and $_.PrefixOrigin -ne 'WellKnown' } |
|
|
Select-Object -ExpandProperty IPAddress)
|
|
} catch { }
|
|
|
|
$scheme = if ($NoTls) { "ws" } else { "wss" }
|
|
|
|
Write-Host ""
|
|
Write-Host " Installation complete" -ForegroundColor Green
|
|
Write-Host " ---------------------" -ForegroundColor DarkGray
|
|
Write-Host " Node ID : $NodeId"
|
|
Write-Host " Listen : 0.0.0.0:$Port ($scheme)"
|
|
Write-Host " Local IP : $($ips -join ', ')"
|
|
Write-Host " Node.js : $nodeExe"
|
|
Write-Host " Config : $cfgPath"
|
|
Write-Host ""
|
|
Write-Host " Pre-shared key (copy this to the Mac side):" -ForegroundColor Yellow
|
|
Write-Host " $Key" -ForegroundColor White
|
|
Write-Host ""
|
|
Write-Host " On the Mac, run:" -ForegroundColor Cyan
|
|
$insecureFlag = if ($NoTls) { "" } else { " --insecure" }
|
|
Write-Host " nodeagent connect <THIS-IP> --port $Port --key $Key$insecureFlag"
|
|
Write-Host ""
|