Kilacraft-AI v1.4.5

专为 Minecraft 服务器打造的轻量级 AI Agent 插件，零依赖、低内存、高性能。

⚠️ 重要版本声明：v1.4.5 是 Kilacraft-AI 的重大架构升级版本，引入了全新的流式输出系统、AI 响应管线重构、Folia 线程安全兼容等核心功能。以往所有版本的发行版已全部废弃，强烈建议所有用户升级至 v1.4.5 或更高版本。旧版本将不再获得功能更新和安全修复支持。

📥 下载说明

服主/管理员请使用：

Kilacraft-AI-1.4.5.jar - 主插件，放入服务器 plugins/ 目录即可

第三方插件开发者请使用：

Kilacraft-Skill-API-1.4.5.jar - Skill SPI API，compileOnly 依赖，用于开发自定义 Skill
Kilacraft-AI-1.4.5.jar - 运行时依赖（由服务器提供，无需打包进你的插件）

⚠️ 注意：服主只需要下载主插件 JAR；开发者需要下载 API JAR 进行编译，但运行时由服务器提供主插件。

✨ v1.4.5 核心更新

🔒 非合作式 Skill 安全拦截器

Value 扫描 + 消毒机制：保护玩家数据隔离，拦截器始终运行不可跳过
智能权限校验：直接扫描 entities 中所有 Value，匹配在线玩家名则校验权限
自动消毒处理：校验不通过时自动替换为当前玩家名，Skill 继续执行而非阻断
白名单机制：config.yml 配置允许操作其他玩家的 Skill/动作
事件驱动缓存：PlayerJoin/Quit 事件驱动的在线玩家名缓存，异步线程安全读取
前置过滤优化：Minecraft 玩家名正则校验，不符合格式的值直接跳过
内置 Skill 白名单：cmi.send_tp_request、AFKTask.create_task、command.execute_command

🎵 BukkitFXSkill 音效与粒子效果

2 种特效动作：play_sound（播放音效）、spawn_particle（显示粒子）
自然语言触发：任务完成庆祝、警告提示、氛围营造等场景自动触发
YML 配置驱动：支持热重载，仅调用者听到/看到特效
AI 回复音效功能：AI 开始回复时自动播放提示音效，增强沉浸式体验
全场景支持：普通对话/技能结果/任务结果/挂机回调均支持音效触发

💬 全新流式输出功能

实时逐字显示：LLM 响应逐字实时显示，消除等待焦虑
占位符即时反馈：请求发起后立即显示"生成中…"占位符，解决首字延迟问题
5 种配置化载体：CHAT/ACTION_BAR/BOSS_BAR/TITLE/SIDEBAR 自由选择
流式完成保留：流式完成后可选保留最终结果到默认载体
配置化开关：output.stream.enabled 控制启用/禁用

🔄 AI 响应统一输出管线

架构重构：重构 AI 回复输出架构，支持场景级载体配置
5 种输出载体：CHAT（聊天栏）、ACTION_BAR（物品栏上方）、BOSS_BAR（顶部横条）、TITLE（屏幕中央）、SIDEBAR（右侧边栏）
独立场景配置：普通对话/技能结果/任务结果/挂机回调/错误消息可独立配置载体
配置即契约：选择什么载体就用什么，不会隐式降级
公屏广播配置化：public_reply=true 时遵循 default_channel 配置

🧠 LLM 二次分析统一协调器

统一中间层：全新中间层统一调度所有 LLM 分析输出
封装完整流程：封装分析+输出完整流程，调用方无需关心流式/非流式细节
灵活占位符控制：支持挂机任务回调不显示占位符，主动请求显示占位符
消除重复逻辑：所有模块通过协调器统一调用，代码更简洁

🔍 意图识别阶段知识库检索

知识库增强：意图识别时启用知识库增强，提升技能识别准确率
智能输入提取：智能提取用户真实输入，排除提示词模板干扰
服务器文档辅助：结合服务器文档（命令说明/规则/玩法）辅助意图判断

📊 Scoreboard Sidebar 输出载体

全新右侧边栏：完美支持长文本 AI 回复的输出方式
多行分页支持：支持最多 15 行，每行最多 128 字符（Minecraft 1.13+）
自动分页机制：超过 15 行时自动拆分多页
视野友好：不遮挡游戏视野，适合长文本 AI 回复（200-1500字符）
标题自动同步：直接使用 ai_prefix 配置作为边栏标题

🧵 Folia/lophine 线程安全兼容

区域化线程调度：完整支持 Folia 及其分支的区域化线程调度
Player API 自动适配：Player 相关 API 自动在玩家所属区域线程执行
Spigot 端零影响：完全向后兼容，Spigot 端无任何性能损失

⚙️ 思考消息独立配置

独立载体控制：output.thinking_channel 可独立控制"正在思考"提示的输出载体
灵活配置：可与最终回复使用不同的输出载体

🔧 优化改进

📦 内置配置文件管理优化

ConfigResourceUtil 工具类：封装统一的配置文件读取和初始化逻辑
日志输出统一：全面使用 PluginLogger 替代分散的日志调用，结构化标签输出

🎯 Bukkit API 数据返回标准化

字段命名规范：统一所有 API 返回字段命名规范
物品名称翻译：物品名称自动翻译为中文，提升用户体验

🗑️ 移除意图分类器

彻底移除 BM25 意图分类器：所有请求直接进入 LLM 意图识别，提升准确率
简化处理流程：减少预分类环节，降低系统复杂度

🏗️ Handler 架构重构

接口实现优化：各 Handler 直接实现 AIResponseHandler 接口，职责更清晰
包结构重组：按功能重新组织代码（enums/manager/output/handler）

⚙️ 配置精简优化

流式输出配置统一：统一流式输出配置到 output.stream.*
移除冗余配置：删除 output.broadcast.* 和 settings.enable_stream_output

🚀 快速开始（服主）

下载 Kilacraft-AI-1.4.5.jar
放入服务器 plugins/ 目录
启动服务器，编辑 config.yml 配置 LLM API Key
重启服务器，使用 /kila 你好 测试

⚠️ v1.4.5 升级提示：本次更新新增 output/ 配置段（包含 stream/default_channel/scenarios/boss_bar/title/sidebar/thinking_channel），首次启动时自动创建。建议使用 /kilacraft reload 重新加载配置以启用新功能。

👨‍💻 开发者快速开始

查看 Skill SPI 接入文档了解如何开发自定义 Skill。

⚠️ 兼容性说明

最低 Java 版本：Java 17+
服务端核心：完全兼容 Spigot 1.16.5+ 及衍生核心 (Paper/Purpur/Leaf/Folia)
向后兼容：现有功能完全兼容，无需更改任何配置
新增配置段：output/ 配置段（包含 stream/default_channel/scenarios/boss_bar/title/sidebar/thinking_channel）
新增 SIDEBAR 输出载体：右侧边栏输出方式
删除配置项：output.broadcast.* 配置段（公屏广播改用 default_channel）、settings.enable_stream_output 配置项
默认配置保持：默认配置保持 CHAT 载体，确保平滑升级
Folia 完全兼容：完整支持 Folia/lophine 区域化线程调度

🔗 相关链接

发布日期: 2026-04-18
适用服务端: Paper/Purpur/Spigot/Leaf/Folia 1.16.5 - 1.21.x
Java 版本要求: Java 17+
开源协议: MIT License