在任意 Windows / Linux / macOS 机器上运行 FreeX AI Server 后， ZCode、Claude、Cursor 等 AI 客户端通过一条加密实时通道，即可 执行命令、部署应用、安装数据库、监控资源、自动巡检—— 所有操作受安全策略约束，全程留痕可审计。
不是给 SSH 套壳，而是从协议、安全到审计都面向 AI 重新设计——LLM 一次示例即可学会，人类始终握有刹车。
单条长连接承载三种语义：请求-响应、命令输出流式回传（AI 边跑边看，长安装不阻塞）、监控数据订阅推送。协议字段不到 10 个，JSON 文本帧对 LLM 天然友好。
自带标准 MCP 桥，AI 客户端加一段配置即获得 48 个 freex_ 工具，无需写一行集成代码。
Windows / Linux / macOS 同一份代码；apt、dnf、brew、winget、choco、npm、pip 等 10 种包管理器自动探测适配。
token 鉴权 + admin/viewer 角色、命令黑白名单、文件路径沙箱、超时强杀进程树、限流——六层防护默认全开。
每条指令的时间、角色、IP、参数摘要、结果与耗时都写入审计日志；confirm 模式下高危命令进审批队列、人点允许才执行；删除类操作前自动快照，30 秒一键回滚。这是「敢把服务器交给 AI」的前提。
仅需 Node.js ≥ 18，无数据库、无外部依赖。
一条命令安装启动，首次运行自动生成带随机 token 的配置。Windows 有一键就绪脚本，Linux 可注册 systemd 服务。
在 ZCode / Claude / Cursor 的 MCP 配置中加入桥接程序地址与 token，重启后 48 个 freex_ 工具即刻出现。
「看下服务器状态」「装个 MongoDB 并给我连接串」「每天 3 点备份站点」——AI 自主拆解执行，高危操作请你审批。
从命令执行到数据库安装、从浏览器自动化到审批流——新增能力 = 新增一个模块文件，模块作者无需写任何安全代码。
操作系统、CPU、内存、运行时长；命令可用性探测
shell 命令流式回传，超时强杀进程树，策略拦截
目录/读写/建删，路径沙箱约束；大文件走 HTTP 通道
CPU / 内存 / 磁盘 / 网络 / Top 进程，轻量采样订阅推送
按 CPU 排序列出进程；结束整个进程树
自动探测 10 种包管理器，安装/卸载自动提权
docker compose 编排、systemd/Windows 服务、pm2 应用
CPU/内存/磁盘阈值规则，webhook 推送 + 历史记录 + 冷却防抖
标准 crontab 表达式，任务即命令，执行入审计、失败可告警
高危操作前自动打包留档，一键回滚；回滚前再留档
对象式存储池，AI 产出自动归档；签名外链到期失效
一条指令装好 MongoDB（绿色装数据盘、仅绑本机），自动生成连接串
服务器端 Playwright：打开网页、填表、截图、取文本、存 PDF
截取服务器桌面，远程查看 GUI 软件状态，操作留审计
控制台账密登录（scrypt 哈希）、角色管理、免手工填 token
confirm 模式下高危命令进队列，人批准才执行，超时自动拒绝
FreeX 的本质是把服务器能力变成 AI 可调用的结构化接口——围绕它，这些事情今天就能做。
告警规则引擎盯盘 → AI 采集诊断 → 按剧本修复（重启服务、清理磁盘、拉起进程）→ 生成报告推送到企业微信/钉钉。凌晨网站挂了，你先于客户知道——甚至客户永远不会知道。
预配置云开发机，开发者用 ZCode / Cursor 经 MCP 直连：AI 直接在远端跑测试、装依赖、管数据库与服务，本地只留一个编辑器。环境随开随用，永不「在我机器上是好的」。
「装个 MongoDB 然后接入使用」——绿色安装到数据盘、仅绑本机、自动生成连接串，你的应用直接连；docker compose 一句话拉起 WordPress、n8n、Redis，返回可访问地址。给客户 5 分钟起一个系统。
巡检报告、截图、打包文件写入云存储池即自动获得签名外链，直接发给客户；链接到期失效，无需登录即可下载。临时大文件中转、素材库同理。
服务器端 Playwright 让 AI 打开网页、登录后台取数、竞品截图监控、自动填单、把网页存成 PDF 报告。会话保持、无人值守，截图经外链即可查看。
Windows 收银机、Linux 云服务器、NAS、工控机、校园混合机房——跨平台 agent 主动反连控制面，目标机零入站端口暴露，NAT 后也能纳管。AI 批量巡检、批量修复。
安全不是配置项，而是默认架构：六层防护开箱即开，权限矩阵是代码里唯一事实来源，模块作者不需要写任何安全代码。
WS/HTTP 均需 token，支持多 token 多角色（admin 全权 / viewer 只读）；IP 白名单；无效 token 立即断开。
blocklist 默认拦截 rm -rf /、mkfs、dd、格式化等；allowlist 严格模式仅放行白名单；confirm 模式高危命令人工审批。
fsRoot 可把所有文件操作锁在指定目录内，路径越界直接拒绝；禁止删除受控根。
命令超时强杀整个进程树（POSIX 进程组 / Windows taskkill /T）；输出与上传大小上限；每连接请求限流。
生产置于 Caddy/Nginx 反代后启用 TLS（wss）；也支持 SSH 隧道，公网零端口暴露。
每条指令落 JSONL 审计日志（时间/角色/IP/参数摘要/结果/耗时）；删除前自动快照，一键回滚。
默认模式：拦截已知破坏性命令，其余放行。适合可信网络里的日常使用。
仅放行白名单命令，高危动作进审批队列；配合快照回滚，无人值守也安心。
容器沙箱执行 + 每租户独立 token 与 fsRoot，面向 SaaS 化的隔离形态。
LLM 原生擅长生成 JSON——所以协议本身就是 JSON。错误也是结构化数据，AI 会自己换方案重试。
// 加到 ZCode / Claude / Cursor 的 MCP 配置，重启即可 { "mcpServers": { "freex-ai-server": { "command": "node", "args": ["mcp/freex-mcp.mjs"], "env": { "FREEX_WS_URL": "wss://your-server/ws", "FREEX_TOKEN": "<admin token>" } } } }
模块化设计让每一步都平滑生长：v1 的模块代码在未来 agent 中原样复用。
WebSocket 实时协议（req/stream/push）+ 7 大核心模块（命令/文件/包/进程/监控/部署/系统）+ MCP 桥 + Web 控制台 + 21 项冒烟测试。
告警通知、定时任务、快照回滚、云存储外链、数据库一键安装（MongoDB）、浏览器自动化、桌面截屏、账号体系、操作审批——工具数从 18 增至 48。
云端控制面 + agent 主动反向连接，目标机零入站端口；机器分组、标签、批量指令、统一审计。连锁门店、设备群运维的基础。
告警 → AI 诊断 → 按 playbook 自动修复 → 工单报告的无人值守闭环；桌面只读监控之上的受控远控输入（强安全门）。
租户隔离、按操作量/机器数计量计费、控制台白标——AI 运维托管服务的商业化底座。