Sever Agent

🚀 v1.0.0 — Initial Release

English

• /ai command system (server-side only; works in single-player / LAN / dedicated servers, no client mod required):
  • /ai <message> and /ai ask <message> — chat with the AI
  • /ai status — view config, rate-limit & queue status
  • /ai reload — hot-reload config from disk (admin)
  • /ai config set <key> <value> — change config at runtime, no restart needed (admin)
  • /ai ban <player> / /ai unban <player> — ban/unban AI access (admin)
• Config system: NeoForge native TOML (config/severagent-server.toml) — API key, rate-limit window (1/5/10 min), max requests per window, global cooldown, thinking display, custom system prompt.
• Smart queue & rate limiting: server-wide FIFO queue with a single worker thread; sliding-window rate limiting + global cooldown.
• Private-message delivery: waits for the complete (non-streamed) response, then sends via private message; long replies are auto-split.
• Prompt engineering: system prompt declares the Minecraft-server AI assistant, tags the asking player ({player_name}), and enforces stateless history isolation.
• Admin ban list: persisted to config/severagent-bans.json (case-insensitive).
• Friendly error messages delivered via private message when the API fails.
• Languages: Simplified Chinese (zh_cn) & English (en_us).

中文

• /ai 指令系统（仅服务端部署，兼容单人游戏 / 局域网 / 专用服务器，客户端无需安装）：
  • /ai <内容> 与 /ai ask <内容> — 与 AI 对话
  • /ai status — 查看配置、限流与队列状态
  • /ai reload — 从磁盘热重载配置（管理员）
  • /ai config set <键> <值> — 运行时改配置，无需重启（管理员）
  • /ai ban <玩家> / /ai unban <玩家> — 封禁/解封 AI 访问（管理员）
• 配置系统：NeoForge 原生 TOML（config/severagent-server.toml）——API 密钥、限流窗口（1/5/10 分钟）、窗口内最大次数、全局冷却、思考过程展示、自定义系统提示词。
• 智能队列与限流：全服共享 FIFO 队列 + 单一工作线程；滑动时间窗口限流 + 全局冷却。
• 私信回传：非流式等待完整响应后再发送；超长回复自动分片。
• Prompt 工程：系统提示词声明「Minecraft 服务器 AI 助手」、标注提问玩家（{player_name}）、强制隔离历史消息（无状态）。
• 管理员封禁名单：持久化于 config/severagent-bans.json（不区分大小写）。
• API 异常时通过私信返回友好错误提示。
• 语言：简体中文（zh_cn）与英语（en_us）。