Home

WindyAgent Wiki

面向 Minecraft 服务器运营的自主 AI Agent

一个 jar 同时是 Velocity 与 Bukkit 插件，自然语言运维、主动巡检告警、按计划执行任务。

---

导航

页面	说明
快速开始	从零搭建：构建 jar → 放配置 → 启动验证
部署指南	三种部署形态详解（provider / standalone / hub）
配置参考	windyagent-config.yml 全部配置项说明
技能系统	用 SKILL.md 给 Agent 加能力：纯文字 / Groovy 脚本 / 多阶段工作流 / 对话式创建
插件集成	CMI 等插件的结构化 API 集成（经济/传送/封禁/礼包）
日志监控	日志异常自动检测 → AI 诊断 → 多方案审批 → 执行
工具清单	Agent 所有可用工具一览
FAQ	常见问题与故障排除
Roadmap	已完成 / 进行中 / 待做

特性概览

• 🤖 自然语言运维 — !ai 把刷屏的 Steve 踢了，ReAct / Plan-Execute 双 Agent 自动路由
• ⚡ 确定性命令 — 首词命中即执行，零 token、可复现
• 🛰️ 主动运维哨兵 — 定时巡检 TPS / 内存 / 在线，异常出诊断建议
• 📋 日志监控 + AI 诊断 — 自动检测 ERROR/Exception → AI 分析根因 → 生成多方案 → 审批执行
• 🧪 技能扩展 — 服主说人话 → AI 生成 SKILL.md + Groovy → 编译检查 + dry-run → 保存
• 🔗 多阶段工作流 — steps 按序执行，支持并行、条件跳转、循环、变量传递、失败重试
• 💾 技能状态持久化 — state.xxx 跨次执行保留数据
• 🧩 插件集成 — CMI 经济/传送/封禁/礼包，结构化 API 调用
• 🔄 LLM 故障转移 — 主 Provider 挂了自动切备用，对话不中断
• 🖥️ Web 控制台 — 运维总览 / 对话 / 看板 / 知识库 / 定时任务 / 审批
• 🛡️ 安全闸 — 高危命令人工审批，AI 生成代码验证链
• 🧠 长期记忆 — 跨会话共享
• 📊 行为分析 — 防卡采集 + 规则画像 + 分群 + 词云
• 💰 物品估值 — EMC 式种子 + 全图传播

架构

flowchart TD
    Admin["👤 管理员 · !ai"] --> Center
    Web["🖥️ 网页控制台"] --> Center
    Center["🧠 Velocity 中心 · Agent 大脑<br/>ReAct / Plan-Execute 路由<br/>安全闸 · 记忆 · 哨兵 · 调度"]
    Center --> Bus{{"跨进程总线<br/>Socket 中枢 / Redis"}}
    Bus --> E["子服 earth<br/>provider · CMI · 日志监控"]
    Bus --> L["子服 lobby<br/>provider · CMI · 日志监控"]
    Bus --> N["子服 N<br/>provider · 执行+采集"]

Loading

模块结构

模块	职责	Java
core	Agent / LLM / 安全闸 / 记忆 / 知识库 / 技能 / 日志监控	8
bus	跨进程总线（Socket 中枢 / Redis / 进程内）	8
behavior	玩家行为数据平台	8
web	Web 控制台后端	8
bukkit	子服载体 / 嵌入式 Agent / 插件集成	8
velocity	中心载体，产出通用单 jar	11