Shabao AI Companion

沙包 AI v0.1.0

Minecraft 1.21.1 Fabric Mod：一个会思考、会规划、会自己做决定的常驻 AI 伙伴。

主要功能

• 🧠 常驻 Agent：进服自动召唤；本地技能自动执行跟随 / 插火把 / 危险警戒（零模型调用），只有值得动脑的事才唤醒大模型
• 🏗️ 一句话建造：build_plan + shape 指令（地基 / 墙体 / 楼板 / 门窗 / 楼梯），自动夷平地形，开工前绿色预览
• 🪜 专业楼梯工程：2×2 紧凑螺旋楼梯 / 直线 / 回转楼梯 + verify_path 3D 可达性自检
• 🗺️ 结构定位：村庄 / 要塞 / 海底神殿 / 林地府邸 / 远古城市 / 试炼密室 / 废弃矿井 / 废弃传送门，找到后可带路或传送
• 💬 聊天 + 语音：按住 V 说话（ASR），AI 用声音回复（TTS）；语音端点可自定义（默认 MiMo，也支持任意 OpenAI 兼容语音端点）
• 💑 长期关系：从朋友到伴侣，牵手 / 拥抱 / 亲吻真实身体互动，互动权限可配置
• 🧠 三层记忆：建筑记忆 + 情景记忆（自然语言跨会话检索）+ 对话上下文，落盘不丢
• 🛡️ 安全护栏：参数化指令工具 + 白名单 + 覆盖确认 + 方块预算 + 权限降级执行

安装

1. 下载本 JAR
2. 与 Fabric Loader、Fabric API、ModMenu、Cloth Config 一起放入 mods/ 文件夹
3. 进游戏，在 模组列表 → 沙包 AI → 配置 填入你的 LLM Key（任意 OpenAI 兼容端点）
4. 进入世界后 AI 伙伴自动生成，直接跟它说话即可

配置无需手动编辑文件，全部可在游戏内模组菜单完成。