1b8876c4bb
本次提交对亲和流聊天器（AFC）的计划与决策核心进行了重大重构和功能增强，旨在提升其响应的灵活性、鲁棒性和可观测性。
主要变更包括：
1. **多动作支持与解析重构**:
- `PlanFilter` 现在能够正确解析并处理 LLM 返回的动作列表（`"actions": [...]`），而不仅限于单个动作，这使得机器人能够执行更复杂的组合行为。
- 增强了动作解析的鲁棒性，当找不到 `target_message_id` 时会优雅降级（如 `reply` 变为 `no_action`），并会根据当前实际可用的动作列表对 LLM 的选择进行验证。
2. **提示词工程与思考模式优化**:
- 重新设计了核心 Planner 提示词，将 `thinking` 字段定义为“思绪流”，引导 LLM 生成更自然、更符合角色的内心独白，而非简单的决策理由，从而提升决策质量和角色扮演的沉浸感。
- 强制要求 LLM 为需要目标消息的动作提供 `target_message_id`，提高了动作执行的准确性。
3. **上下文构建与鲁棒性增强**:
- 在 `PlanFilter` 中增加了上下文回退机制，当内存中缺少历史消息时（如冷启动），会自动从数据库加载最近的消息记录，确保决策所需上下文的完整性。
- 简化了提供给 LLM 的未读消息格式，移除了兴趣度分数等内部信息，并加入了用户昵称，使其更易于理解和处理。
4. **可观测性与日志改进**:
- 在 AFC 的多个关键节点（消息接收、决策、动作执行）增加了彩色的详细日志，使其决策流程像 HFC 一样清晰可见，极大地方便了调试。
- 将系统中多个模块（视频分析、兴趣度匹配、情绪管理）的常规日志级别从 `INFO` 调整为 `DEBUG`，以减少在生产环境中的日志噪音。
5. **动作描述优化**:
- 优化了 `set_emoji_like` 和 `emoji` 等动作的描述，使其意图更清晰，帮助 LLM 做出更准确的动作选择。
🌟 MoFox_Bot
🚀 基于 MaiCore 的增强版 AI 智能体，提供更完善的功能和更好的使用体验
📖 项目介绍
MoFox_Bot 是一个基于 MaiCore 0.10.0 snapshot.5 版本的增强型 fork 项目。
我们在保留原版所有功能的基础上，进行了一系列的改进和功能拓展，致力于提供更强的稳定性、更丰富的功能和更流畅的用户体验
Important
第三方项目声明
本项目是由 MoFox Studio 独立维护的第三方项目，并非 MaiBot 官方版本。 所有后续更新和维护均由我们团队负责，与 MaiBot 官方无直接关系。
Warning
迁移风险提示
由于我们对数据库结构进行了重构和优化，从 MaiBot 官方版本直接迁移到 MoFox_Bot 可能会遇到数据不兼容的问题。 在迁移前，请务必做好数据备份。
✨ 功能特性
🔧 原版功能（全部保留）
|
🚀 拓展功能
|
🔧 系统要求
💻 基础环境
| 项目 | 要求 |
|---|---|
| 🖥️ 操作系统 | Windows 10/11, macOS 10.14+, Linux (Ubuntu 18.04+) |
| 🐍 Python 版本 | Python 3.10 或更高版本 |
| 💾 内存 | 建议 4GB 以上可用内存 |
| 💿 存储空间 | 至少 2GB 可用空间 |
🛠️ 依赖服务
| 服务 | 描述 |
|---|---|
| 🤖 QQ 协议端 | NapCatQQ 或其他兼容协议端 |
| 🗃️ 数据库 | SQLite (内置) 或 MySQL (可选) |
| 🔧 管理工具 | Chat2DB (可选，用于数据库管理) |
🏁 快速开始
📦 安装与部署
Note
详细的安装和配置步骤，请务必参考我们的官方文档：
- Windows 用户部署指南: https://mofox-studio.github.io/MoFox-Bot-Docs/docs/guides/deployment_guide.html
bot_config.toml究极详细教程: https://mofox-studio.github.io/MoFox-Bot-Docs/docs/guides/bot_config_guide.html
⚙️ 配置要点
- 📝 核心配置: 修改
config/bot_config.toml中的基础设置，如 LLM API Key 等。 - 🤖 协议端配置: 设置 NapCatQQ 或其他兼容的 QQ 协议端，确保通信正常。
- 🗃️ 数据库配置: 根据需求选择 SQLite 或配置你的 MySQL 服务器。
- 🔌 插件配置: 在
config/plugins/目录下按需配置插件。
🙏 致谢
我们衷心感谢以下优秀的开源项目，没有它们，就没有 MoFox_Bot。
| 项目 | 描述 | 贡献 |
|---|---|---|
| 🎯 MaiM-with-u/MaiBot | 原版 MaiBot 项目 | 提供优秀的基础框架 |
| 🐱 NapNeko/NapCatQQ | 基于 NTQQ 的 Bot 协议端 | 现代化的 QQ 协议实现 |
| 🌌 internetsb/Maizone | 魔改空间插件 | 插件部分功能借鉴 |
⚠️ 注意事项
Caution
重要提醒
- 使用本项目前，你必须阅读并同意 📋 用户协议 (EULA.md)。
- 本应用生成的内容来自人工智能大模型，请仔细甄别其准确性，并请勿用于任何违反法律法规的用途。
- AI 生成的所有内容不代表本项目团队的任何观点和立场。
📄 开源协议
本项目基于 GPL-3.0 协议开源。
Copyright © 2025 MoFox Studio
Licensed under the GNU General Public License v3.0