0746a73bce
这是一个全新的私聊聊天处理器，专为深度情感交互设计，从架构设计到代码实现全部从零完成。 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🏗️ 核心架构 (7个核心模块) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📁 src/plugins/built_in/kokoro_flow_chatter/ ├── chatter.py # 主处理器 - 协调所有组件的核心类 ├── context_builder.py # S4U上下文构建器 - 超融合上下文系统 ├── prompt_generator.py # V6三明治提示词生成器 ├── action_executor.py # 动作执行器 - 解析+执行LLM动作 ├── response_post_processor.py # 回复后处理器 - 分割+错别字 ├── models.py # 数据模型 - Session/情感状态/心理日志 ├── session_manager.py # 会话管理器 - 用户状态持久化 ├── scheduler.py # 调度器 - 主动思考/超时处理 ├── config.py # 配置类 └── plugin.py # 插件注册入口 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✨ 核心特性 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 【V1-V3 基础框架】 - 心理状态驱动的交互模型 (KokoroSession) - 连续时间观念和等待体验 (IDLE→RESPONDING→WAITING状态机) - 心理日志系统 (MentalLogEntry) - 动态情感状态 (EmotionalState) 【V4 动作系统集成】 - 动态动作发现 (复用ChatterActionManager) - 支持所有AFC动作 (reply/emoji/poke_user/set_emoji_like等) - LLM响应JSON解析和验证 【V5 超融合上下文】 - S4U用户中心上下文检索 - 三层记忆系统集成 (感知/短期/长期) - 时间感知块 (时间段+日程+情境) - 人物关系信息注入 - 跨聊天上下文共享 【V6 最终优化】 - 三明治提示词结构 (系统层→上下文层→指令层) - ActionModifier动作筛选器集成 (三阶段预筛选) - 阶段0: 聊天类型过滤 - 阶段2: 关联类型匹配 - 阶段3: go_activate()激活判定 - 回复分割器复用AFC核心逻辑 (split_into_sentences_w_remove_punctuation) - 修复model配置 (使用replyer而非utils) - 修复context_builder异步问题 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🔧 技术细节 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 提示词结构 (V6三明治): ┌─────────────────────────────────────┐ │ 🍞 系统层 (人设/身份/表达风格) │ ├─────────────────────────────────────┤ │ 🥬 上下文层 │ │ ├─ 时间感知块 │ │ ├─ 三层记忆 (感知+短期+长期) │ │ ├─ 人物关系 │ │ ├─ 对话历史 │ │ └─ 用户最新消息 │ ├─────────────────────────────────────┤ │ 🍞 指令层 (JSON输出格式/可用动作) │ └─────────────────────────────────────┘ 动作筛选效果: 13个动作 → 约5-7个 (节省token+提升决策质量) 回复分割: 长消息自动按标点分割成多条发送 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📝 配置项 (bot_config.toml) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ [kokoro_flow_chatter] enable = true max_wait_seconds_default = 300 enable_continuous_thinking = true [kokoro_flow_chatter.proactive_thinking] enabled = true silence_threshold_seconds = 7200 min_affinity_for_proactive = 0.3 min_interval_between_proactive = 1800 enable_morning_greeting = true enable_night_greeting = true ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🎯 设计理念 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ KFC不是独立人格，而是： - 复用全局人设、情感框架和回复模型 - 专注于"体验→决策→行动"的私聊交互模式 - 从"消息响应者"转变为"对话体验者" - 深度情感连接和长期关系维护
🌟 MoFox_Bot
🚀 基于 MaiCore 0.10.0 snapshot.5进一步开发的 AI 智能体，插件功能更强大
📖 项目简介
MoFox_Bot 是一个基于 MaiCore 0.10.0 snapshot.5 的 fork 项目。我们保留了原项目几乎所有核心功能，并在此基础上进行了深度优化与功能扩展，致力于打造一个更稳定、更智能、更具趣味性的 AI 智能体。
[IMPORTANT] 第三方项目声明
本项目Fork后由 MoFox Studio 独立维护，为 MaiBot 的第三方分支，并非官方版本。所有更新与支持均由我们团队负责，后续的更新与 MaiBot 官方无直接关系。
[WARNING] 迁移风险提示
由于我们对数据库结构进行了重构与优化，从官方 MaiBot 直接迁移至 MoFox_Bot 可能导致数据不兼容。请在迁移前务必备份原始数据，以避免信息丢失。
✨ 核心功能
🔧 MaiBot 0.10.0 snapshot.5 原版功能
|
🚀 拓展功能
|
🔧 系统要求
💻 基础环境
| 项目 | 要求 |
|---|---|
| 🖥️ 操作系统 | Windows 10/11、macOS 10.14+、Linux (Ubuntu 18.04+) |
| 🐍 Python 版本 | Python 3.11 或更高版本 |
| 💾 内存 | 建议 ≥ 4GB 可用内存 |
| 💿 存储空间 | 建议 ≥ 4GB 可用空间 |
🛠️ 依赖服务
| 服务 | 描述 |
|---|---|
| 🤖 QQ 协议端 | NapCatQQ 或其他兼容协议端 |
| 🗃️ 数据库 | SQLite（默认）或 MySQL（可选） |
| 🔧 管理工具 | Chat2DB（可选，用于数据库可视化管理） |
🏁 快速开始
📦 安装与部署
Note
详细安装与配置指南请参考官方文档：
⚙️ 配置要点
- 📝 核心配置：编辑
config/bot_config.toml，设置 LLM API Key、Bot 名称等基础参数。 - 🤖 协议端配置：确保使用 NapCatQQ 或兼容协议端，建立稳定通信。
- 🗃️ 数据库配置：选择 SQLite（默认）或配置 MySQL 数据库连接。
- 🔌 插件配置：在
config/plugins/目录中启用或配置所需插件。
🙏 致谢
我们衷心感谢以下开源项目为本项目提供的坚实基础：
| 项目 | 描述 | 贡献 |
|---|---|---|
| 🎯 MaiM-with-u/MaiBot | 原版 MaiBot 框架 | 提供核心架构与设计 |
| 🐱 NapNeko/NapCatQQ | 高性能 QQ 协议端 | 实现稳定通信 |
| 🌌 internetsb/Maizone | 魔改空间插件 | 功能借鉴与启发 |
如果可以的话，请为这些项目也点个 ⭐️ ！(尤其是MaiBot)
⚠️ 重要提示
Caution
请务必阅读以下内容：
- 本项目使用前，请仔细阅读并同意 用户协议 (EULA.md)。
- 本应用生成的内容由 AI 大模型提供，请谨慎甄别其准确性。
- 请勿将 AI 生成内容用于任何违法、违规或不当用途。
- 所有 AI 输出不代表 MoFox Studio 的立场或观点。
📄 开源协议
本项目基于 GPL-3.0 协议开源。
Copyright © 2025 MoFox Studio
Licensed under the GNU General Public License v3.0