MaiBot 0.7.0 一键包常见问题解答
📋 目录
🔧 配置相关
私聊白名单设置
文件位置： maibot → maibot-napcat-adapter → config.toml
配置路径： [Chat] → #黑白名单功能 → 第 6 行
toml
private_list = [此处填写你的QQ号] # 私聊名单处修改示例：
toml
private_list = [123456789, 987654321] # 支持多个QQ号🎨 资源文件
📱 表情包
存放路径： maibot → data → emoji
将表情包文件放入此目录即可使用。
📚 知识库
存放路径： maibot → data → lpmm_raw_data
使用方法： 直接将知识文件拖入该文件夹即可
支持格式： 文本文件、文档等
🌐 NapCat 错误处理
🔗 浏览器页面无法访问（拒绝连接）
「有头」模式
⚠️ 重要提示： 确保在简易麦麦控制台启动时弹出的登录界面中登录 QQ，不要使用日常登录的 QQ
解决步骤：
- 启动简易麦麦控制台
- 等待登录界面弹出
- 在弹出的界面中重新登录 QQ
- 避免使用已经登录的 QQ 账户
「无头」模式
注：使用次数较少，具体解决方案需要进一步测试
📊 API 错误代码
🚫 错误代码说明
| 错误代码 | 错误类型 | 解决方案 |
|---|---|---|
| 409 | 请求 API 次数过多 | 💡 耐心等待，稍后重试 |
| 401 | API Key 错误 | 🔍 检查 API 密钥是否有效 |
🛠️ 故障排除
- 409 错误： 通常是因为短时间内发送了过多请求，等待一段时间后会自动恢复
- 401 错误： 检查配置文件中的 API Key 是否正确填写
🗄️ SQLiteStudio 使用指南
📍 启动 SQLiteStudio
文件位置： Maibot → SQLiteStudio → SQLiteStudio.exe
🌏 修改为中文界面
操作步骤：
- 点击上方 Tools 菜单
- 选择 Open Configuration Dialog
- 进入 Look & Feel 设置页面
- 找到 Language（语言设置）选项
- 下滑找到中文选项并选择
📁 导入数据库
详细步骤：
打开添加数据库对话框
- 点击左上角 数据库 菜单
- 选择 添加数据库
配置数据库类型
- 数据类型：选择 SQLite 3（默认选项）
- 文件选择：选择 Select an existing database file（第一选项）
选择数据库文件
- 点击文件夹图标
- 按以下路径导航：
Maibot → data → MaiBot.db - 选中文件后点击 选择
完成导入
- 名称将自动填写
- 点击 OK 完成导入
👀 查看数据库
操作方法：
- 点击左上角 视图 菜单
- 选择 数据库 选项
- 选择对应表并双击打开
- 在右侧窗口上段选择数据选项卡
- 即可查看已导入的数据库的内容
📞 技术支持
如遇到其他问题，请：
- 检查日志文件获取详细错误信息
- 确认配置文件格式是否正确
- 重启相关服务后重试
📝 文档版本：v1.0 | 更新日期：2025 年 6 月 5 日