Kilacraft-AI v1.4.3

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

📥 下载说明

服主/管理员请使用：

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

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

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

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

---

🎯 v1.4.3 核心更新

🤖 AFK 挂机任务系统

• 11 种事件监听器：玩家上线/下线/死亡/传送/等级变化/切换世界、进入床/离开床/重生/物品损坏、天气变化
• 双模式支持：纯通知模式（直接提醒）+ 回调模式（自动执行多步骤任务）
• 智能管理：玩家下线自动取消任务，任务完成自动清理，支持 /kilacraft afk 查询和取消

🔧 二次分析架构升级

• 统一 LLM 二次分析：所有技能执行结果（包括单意图）都经过 LLM 二次分析，回复更自然、能关联上下文
• AnalysisSummary 统一摘要对象：单意图和多步骤任务共享同一结构化格式，便于 LLM 理解和关键词提取
• Markdown 自动转换：LLM 输出的 Markdown 格式（加粗、斜体、代码）自动转换为 Minecraft 颜色代码

🛡️ 多步骤任务错误保障

• 容错机制增强：即使部分步骤失败，也不会中断整个流程，继续执行后续步骤
• 依赖检查强化：不仅检查依赖步骤是否存在，还检查依赖步骤是否执行成功
• 占位符解析容错：解析失败时跳过该步骤，避免整个任务链崩溃

📊 Bukkit API 大幅扩展

• API 总数从 37 个扩展至 58 个：新增 21 个 API（玩家 31 个、世界 20 个、服务器 6 个）
• 盔甲装备查询：获取玩家全套盔甲（头盔、胸甲、护腿、靴子），支持多步骤数据传递
• 药水效果查询：查询当前所有药水效果（类型、等级、持续时间）
• 目标方块查询：获取玩家视线指向的方块信息
• 移动状态检测：蹲下/奔跑状态实时查询
• 世界详情查询：生物群系、温度、湿度、海平面、实体统计、袭击事件、天气持续时间、世界时间详情
• 多步骤数据传递增强：API 返回值自动提取到 dataMap，支持后续步骤通过 {step_x.field} 引用

🎨 回复体验优化

• system_prompt 风格定位：热情有趣的玩家朋友风格，回复更生动自然
• 连续对话规则增强：新增【实时数据重新获取规则】和【多步骤任务重复规则】，解决代词指代和多步骤截断问题
• 回复长度控制：max_tokens 调整为 500，普通 AI 对话限制 200 汉字

🔍 知识库检索优化

• 三层关键词提取策略：原始查询 + 分词结果 + TF-IDF 关键词，兼容短文本和长文档
• 单字查询优化：支持"弓"、"剑"等单字物品名查询，通过自定义词典和停用词检查
• 内置词汇表加载：从 JAR 包的 internal/vocabulary/ 目录加载词汇文件
• 关键词提取降噪：精准提取用户输入 + 执行结果数据，去除 step_id、状态标签、颜色代码等结构性噪音

⚙️ 代码重构与优化

• 插件入口类重构：onEnable() 从平铺代码提取为 6 个语义清晰的私有方法，严格保持初始化顺序
• GenericBukkitAPISkill 增强：新增 6 个格式化方法（formatArmorContents, formatPotionEffects, formatBlock, formatBiome, formatRaids, formatWorldTime）
• 安全审查：移除服务器网络信息 API（port, IP, view_distance, idle_timeout），防止敏感信息泄露
• Spigot 1.16.5 兼容性验证：所有 API 基于官方文档验证

---

🚀 快速开始（服主）

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

💡 v1.4.3 升级提示：本次更新新增 21 个 Bukkit API 配置，首次启动时自动创建。建议使用 /kilacraft reload 重新加载配置以启用新功能。

---

👨‍💻 开发者快速开始

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

---

⚠️ 兼容性说明

• 最低 Java 版本：Java 17+
• 服务端核心：完全兼容 Spigot 1.16.5+ 及衍生核心 (Paper/Purpur/Leaf/Folia)
• 向后兼容：现有功能完全兼容，无需更改任何配置
• 新增权限节点：kilacraft.api.player.status（盔甲、药水效果等）、kilacraft.afk（默认所有玩家可用）
• 配置文件更新：config.yml 中 analysis_prompt_suffix 和 system_prompt 配置更新，intent_prompts.yml 新增连续对话处理规则
• API 总数：从 37 个扩展至 58 个，支持通过 /kilacraft reload 热重载 API 配置

---

🔗 相关链接

• 完整更新日志
• 服主指南
• AFK 挂机任务系统详解
• SPI 接入文档
• GitHub 镜像

---

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