麦麦机器人：QQ 群聊 AI 助手部署实战
如果你想在 QQ 群里引入一个能真正'聊天'的智能助手，麦麦机器人是个不错的选择。它不只是简单的关键词匹配，而是基于大语言模型构建的上下文感知系统。
为什么选择它
核心在于拟人化交互。它能理解群聊氛围，从严肃讨论切换到轻松调侃，还能记住群友的偏好。这种记忆能力让它不像机器，更像一位老群友。
环境前置检查
动手前先核对一下环境，缺了这些跑不起来：
- Python 3.8+
- MongoDB 数据库
- NapCat QQ 协议端
快速上手
Linux 环境下最省事的方式是运行项目根目录下的脚本：
./scripts/run.sh
脚本会引导你完成配置。如果报错说没权限，记得先给脚本加个执行许可。
配置要点
数据库连接
这是机器人的'记忆库'。编辑 template/bot_config_template.toml，填入 MongoDB 的连接串。别急着跑，先确认数据库服务是通的。
模型接入
去 src/config/ 下找配置文件，把大模型厂商的 API Key 和端点填进去。这一步决定了它的智商上限。
调优建议
内存占用
src/memory_system/ 里有个记忆检索模块。别把所有聊天记录都存着，设个合理的保留时间，不然内存容易爆。
响应延迟
src/chat/frequency_control/ 里的参数可以限制触发频率。太频繁会卡，太慢又没体验，得自己摸索个平衡点。
避坑指南
启动失败
多半是 NapCat 的问题。看看 QQ 号有没有掉线，再翻翻 log_viewer/ 里的日志，具体报错通常都在那儿。
回答太傻
可能是模型选错了，或者 Prompt 没写好。试试换个大模型，或者改改 src/llm_models/ 里的模板。
二次开发
想加新功能？看 plugins/hello_world_plugin/ 这个例子。做个插件得有个 _manifest.json 来声明依赖关系。
还有 depends-data/ 里的资源，可以用来喂给它一些特定领域的知识，让它在你的圈子里更懂行。
搞定这些，基本就能跑起来了。剩下的就是根据实际需求慢慢打磨。
