Numen QQ桥

Numen QQ桥

将您的 Numen AI 伴侣绑定到 QQ 账户：在 QQ 上与它聊天，它会在 Minecraft 中执行任务并向您汇报。

在QQ上指挥你的Minecraft AI伙伴

当你离开键盘时，你的世界仍在运行。在QQ上给你的Numen伙伴发送消息——"收割家里的麦子"——它会规划任务，在游戏中完成工作，然后回复你："已收获64组，存放在箱子中。"

本模组通过NapCatQQ（OneBot 11协议）将QQ聊天与Numen AI伙伴连接起来。

特性

  • 私聊模式 — 将伙伴绑定到QQ机器人账号；白名单用户通过私聊命令它；
  • 群聊模式 — 将机器人添加到QQ群，让朋友也能指派伙伴工作；它会在群内汇报结果；
  • 回复由AI自行决定 — 发送QQ消息被注册为伙伴的一个工具，与挥动镐头同等地位。任务完成后，它知道该说什么、该对谁说：私聊请求回复私聊，群聊请求回复群聊；
  • 默认拒绝的白名单 — 空白的白名单不接受任何请求。未经明确允许的用户发送的消息会在桥接层被丢弃，永远不会到达模型，因此不会消耗你的API配额；
  • 零第三方依赖 — 仅使用JDK内置的WebSocket和Gson；未嵌入任何机器人框架。

要求

  1. 安装Numen（必需依赖，版本0.0.4或更新）；
  2. 部署NapCatQQ并登录专用QQ机器人账号，启用正向WebSocket服务器；
  3. 填写config/numen/qq_bridge.json（端点、令牌、白名单）；
  4. 使用你的账号将机器人添加为QQ好友，然后开始聊天。

详细的逐步设置、完整配置参考和问题排查表，请参阅GitHub README。

注意事项

  • 客户端模组 — 与Numen一起安装在玩家客户端上；
  • Numen本身需要您自己的兼容OpenAI的LLM API密钥；
  • 白名单中的每个人都会消耗你的API配额——只授权给你信任的人；
  • QQ是中国主要使用的聊天平台；本桥接器最适合拥有QQ账号的玩家。