AutoDetector 是一个面向 Windows 设备的轻量级远程文件管理工具，由一个 Web Server 和多个 Windows Agent 组成。
它适合内网、实验室、机房、受控办公环境等场景。管理端通过浏览器登录后台，查看在线设备、浏览磁盘、下载和编辑文件、执行基础命令，并对常见缓存目录做智能清理分析。
- 密码登录的 Web 后台
- 实时显示在线 Agent、主机名和磁盘列表
- 浏览本地盘、可移动盘、网络盘和光驱
- 下载文件，支持中文文件名
- 在线新建和编辑 UTF-8 文本文件
- 在线删除文件或文件夹
- 后台主动断开指定 Agent
- 远程执行基础
cmd.exe /c命令 - 智能清理分析：扫描常见缓存、下载目录和用户目录
- 前端可直接配置智能清理所用的大模型参数
- Agent 无控制台窗口、无任务栏窗口、无托盘图标
- Agent 采用单实例锁，重复启动不会再生成第二个 Agent 进程
- Agent 断线自动重连，Server 通过心跳识别离线
- 可选长期启动：首次运行后安装到当前用户目录并设置开机自启
Browser
-> AutoDetector Server
-> Web API
-> WebSocket /ws/ui
-> WebSocket /ws/agent
-> Windows Agent
-> 文件系统操作
-> 命令执行
-> 存储扫描
AutoDetector
├─ server.js
├─ src/
│ ├─ app.js
│ ├─ routes.js
│ ├─ agent-registry.js
│ ├─ session-store.js
│ ├─ simple-websocket.js
│ ├─ ws-handlers.js
│ ├─ config.js
│ ├─ storage-assistant.js
│ ├─ storage-ai-settings.js
│ └─ http-utils.js
├─ public/
│ ├─ index.html
│ ├─ login.html
│ ├─ app.js
│ ├─ login.js
│ └─ styles.css
├─ build-agent.ps1
├─ Dockerfile
└─ docker-compose.yml
Server 端：
- Node.js 20+，或 Docker
Agent 生成端：
- Windows
- .NET Framework 4.x 自带的
csc.exe
Agent 运行端：
- Windows
这个项目的 Server 只使用 Node.js 内置模块，不需要 npm install。
启动服务：
node server.js --host 0.0.0.0 --port 5000 --password "your-password"打开后台：
http://SERVER_IP:5000
生成 Agent：
.\build-agent.ps1Server WebSocket 请填写：
ws://SERVER_IP:5000/ws/agent
如果你是通过域名访问后台，例如：
http://your-domain.com
那么 Agent 应填写：
ws://your-domain.com/ws/agent
先修改 docker-compose.yml 里的后台密码：
environment:
AUTODETECTOR_PASSWORD: "your-password"启动：
docker compose up -d --build打开后台：
http://SERVER_IP:5000
如果 Agent 连接 Docker 部署的服务，WebSocket 地址写成：
ws://SERVER_IP:5000/ws/agent
node server.js `
--host 0.0.0.0 `
--port 5000 `
--password "your-password" `
--agent-timeout-ms 15000 `
--storage-ai-base-url https://lucen.run `
--storage-ai-model gpt-5.4 `
--storage-ai-api-key "your-api-key" `
--storage-ai-timeout-ms 45000 `
--storage-ai-config-path "storage-ai.settings.json"也支持环境变量：
$env:AUTODETECTOR_PASSWORD = "your-password"
$env:AUTODETECTOR_STORAGE_AI_BASE_URL = "https://lucen.run"
$env:AUTODETECTOR_STORAGE_AI_MODEL = "gpt-5.4"
$env:AUTODETECTOR_STORAGE_AI_API_KEY = "your-api-key"
$env:AUTODETECTOR_STORAGE_AI_TIMEOUT_MS = "45000"
node server.js --host 0.0.0.0 --port 5000参数说明：
--port：Server 监听端口，默认建议使用5000--password：后台登录密码--agent-timeout-ms：Agent 心跳超时判定时间，默认15000--storage-ai-base-url：模型服务地址--storage-ai-model：模型 ID--storage-ai-api-key：模型 API Key--storage-ai-timeout-ms：模型请求超时--storage-ai-config-path：模型配置文件保存路径
Dockerfile 和 docker-compose.yml 已经准备好，容器内默认监听 5000 端口。
持久化目录：
./data -> /app/data
当前会持久化前端保存的模型配置文件：
/app/data/storage-ai.settings.json
查看状态：
docker compose ps
docker compose logs -f更新：
git pull
docker compose up -d --build在 Windows 上运行：
.\build-agent.ps1也可以直接传参数：
.\build-agent.ps1 `
-Server ws://SERVER_IP:5000/ws/agent `
-OutputDir .\dist\agent `
-LongTermStartup 否 `
-ScanIntervalSeconds 2 `
-ReconnectSeconds 5 `
-MaxDownloadBytes 268435456参数说明：
-Server：Agent 要连接的 WebSocket 地址-OutputDir：生成 EXE 的输出目录-LongTermStartup：是或否-ScanIntervalSeconds：磁盘状态上报间隔-ReconnectSeconds：断线重连间隔-MaxDownloadBytes：单文件读取上限，默认256 MB
默认输出：
dist\agent\AutoDetectorAgent.exe
- 启动 Server
- 浏览器访问后台并登录
- 在目标 Windows 机器上运行
AutoDetectorAgent.exe - 等设备出现在左侧在线列表
- 选择设备和磁盘后开始文件管理
支持的主要操作：
- 浏览目录
- 下载文件
- 编辑文本文件
- 新建文本文件
- 删除文件或目录
- 断开设备
- 执行远程命令
- 智能清理分析
- 模型配置与连接测试
- 智能清理会调用 Agent 的
storage_scan命令 - 扫描阶段是只读的，不会自动删除
- 绿灯项通常是缓存或临时文件，可直接清理
- 黄灯项和红灯项建议先打开目录人工确认
- 如果模型配置为空，页面仍会展示本地规则分析结果
- 如果模型服务不兼容
POST /v1/chat/completions，需要按实际协议调整 src/storage-assistant.js
Agent 日志路径：
%APPDATA%\AutoDetector\tray-agent.log
如果开启长期启动，Agent 安装位置为：
%LOCALAPPDATA%\AutoDetector\AutoDetectorAgent.exe
- 后台能打开但没有设备：确认 Agent 的
Server WebSocket地址填写正确 - 设备频繁掉线：检查目标机器网络、日志文件，以及
--agent-timeout-ms是否过小 - 智能清理很慢：目标机器目录很多时扫描可能持续较久，反向代理要允许较长超时
- 模型测试失败：优先检查地址、模型 ID、API Key，以及接口是否兼容 OpenAI 格式
- 无法覆盖生成 Agent：通常是旧的
AutoDetectorAgent.exe仍在运行
这个项目具备远程文件管理和命令执行能力，不建议直接裸露到公网。至少应做到：
- 使用强密码
- 仅在可信网络中使用
- 按需限制来源 IP
- 谨慎保管生成后的 Agent 程序