remote-executor-core

Windows Remote Executor v3.5 核心接口

服务地址: http://<host>:8765

核心端点

配置管理

GET  /config              # 获取配置（log_dir, log_retention_days, upload_dir）
POST /config              # 更新配置 {log_dir, log_retention_days}
POST /config/cleanup-now  # 手动清理旧日志

任务执行（异步）

POST /run
Content-Type: application/json

{"script_path": "D:\\script.py", "args": [], "cwd": "...", "python_path": "D:\\venv\\Scripts\\python.exe"}

返回: {"task_id": "xxx", "status": "started", "log_file": "..."}

python_path 可选，不传默认用系统 PATH 的 python。

同步执行（短任务）

POST /run-sync
Content-Type: application/json

{"script_path": "D:\\script.py", "args": [], "cwd": "...", "timeout": 30, "python_path": null}

返回: {"stdout": "...", "stderr": "...", "returncode": 0}

任务管理

GET    /status/{task_id}      # 任务状态
GET    /log/{task_id}?max_lines=200  # 任务日志
POST   /stop/{task_id}        # 停止任务
GET    /tasks                 # 列出所有任务
POST   /tasks/clear-finished  # 清理已完成任务

PowerShell（异步）

POST /powershell
Content-Type: application/json

{"command": "Get-Process | Select-Object -First 5", "timeout": 60}

返回: {"task_id": "xxx", "status": "started", "log_file": "..."}

PowerShell（同步）

POST /powershell-sync
Content-Type: application/json

{"command": "...", "timeout": 60}

返回: {"stdout": "...", "stderr": "...", "returncode": 0}

文件上传/下载

POST /upload                # multipart: file + target_path
POST /batch/upload          # multipart: files[] + target_dir
POST /download              # {path} JSON body，支持大文件和中文路径
POST /list                  # {path, pattern}

审计日志

GET /audit?limit=100

服务管理

控制 executor 自身的 Windows 服务。

POST /service/restart       # 重启服务（延迟2秒执行）
POST /service/stop          # 停止服务（延迟2秒执行）
GET  /service/autostart     # 获取开机自启状态
POST /service/autostart?enable=true   # 开启开机自启
POST /service/autostart?enable=false  # 关闭开机自启
GET  /service/info          # 服务信息（版本、PID、任务数）
GET  /health                # 健康检查