fix(message_manager): 修复初始化方法中的格式问题

fix(message_repository): 将警告日志级别更改为调试
docs: 添加 MoFox Core 重构架构文档
This commit is contained in:
Windpicker-owo
2025-12-14 22:34:04 +08:00
parent dd0dd94e76
commit 962a50217d
3 changed files with 106 additions and 2 deletions

104
MoFox 重构指导总览.md Normal file
View File

@@ -0,0 +1,104 @@
# MoFox Core 重构架构文档
MoFox src目录将被严格分为三个层级
kernel - 内核/基础能力 层 - 提供“与具体业务无关的技术能力”
core - 核心层/领域/心智 层 - 用 kernel 的能力实现记忆、对话、行为等核心功能,不关心插件或具体平台
app - 应用/装配/插件 层 - 把 kernel 和 core 组装成可运行的 Bot 系统,对外提供高级 API 和插件扩展点
## kernel层
包含以下模块:
db底层数据库接口
__init__.py导出
core数据库核心
__init__.py导出
dialect_adapter.py数据库方言适配器
engine.py数据库引擎管理
session.py数据库会话管理
exceptions.py数据库异常定义
optimization数据库优化
__init__.py导出
backends缓存后端实现
cache_backend.py缓存后端抽象基类
local_cache.py本地缓存后端
redis_cache.pyRedis缓存后端
cache_manager.py多级缓存管理器
api操作接口
crud.py统一的crud操作
query.py高级查询API
vector_db底层向量存储接口
__init__.py导出工厂函数初始化并返回向量数据库服务实例。
base.py向量数据库的抽象基类 (ABC),定义了所有向量数据库实现必须遵循的接口
chromadb_impl.pychromadb的具体实现遵循 VectorDBBase 接口
config底层配置文件系统
__init__.py导出
config_base.py配置项基类
config.py配置的读取、修改、更新等
llm底层llm网络请求系统
__init__.py导出
utils.py基本工具如图片压缩格式转换
llm_request.py与大语言模型LLM交互的所有核心逻辑
exceptions.pyllm请求异常类
client_registry.pyclient注册管理
model_clientclient集合
base_client.pyclient基类
aiohttp_gemini_clinet.py基于aiohttp实现的gemini client
bedrock_client.pyaws client
openai_client.pyopenai client
payload标准负载构建
message.py标准消息构建
resp_format.py标准响应解析
tool_option.py标准工具负载构建
standard_prompt.py标准promptsystem等
logger日志系统
__init__.py导出
core.py日志系统主入口
cleanup.py日志清理/压缩相关
metadata.py日志元数据相关
renderers.py日志格式化器
config.py配置相关的辅助操作
handlers.py日志处理器console handler、file handler等
concurrency底层异步管理
__init__.py导出
task_manager.py统一异步任务管理器
watchdog.py全局看门狗
storage本地持久化数据管理
__init__.py导出
json_store.py统一的json本地持久化操作器
## core层
包含以下模块:
components基本插件组件管理
__init__.py导出
base组件基类
__init__.py导出
action.py
adapter.py
chatter.py
command.py
event_handler.py
router.py
service.py
plugin.py
prompt.py
tool.py
managers组件应用管理实际能力调用
__init__.py导出
action_manager.py动作管理器
adapter_manager.py适配器管理
chatter_manager.py聊天器管理
event_manager.py事件管理器
service_manager.py服务管理器
mcp_managerMCP相关管理
__init__.py导出
mcp_client_manager.pyMCP客户端管理器
mcp_tool_manager.pyMCP工具管理器
permission_manager.py权限管理器
plugin_manager.py插件管理器
tool_manager工具相关管理
tool_histoty.py工具调用历史记录
tool_use.py实际工具调用器
types.py组件类型
registry.py组件注册管理
state_manager.py组件状态管理

View File

@@ -30,7 +30,7 @@ logger = get_logger("message_manager")
class MessageManager:
"""消息管理器"""
def __init__(self, check_interval: float = 5.0):
def __init__(self, check_interval: float = 5.0):
self.check_interval = check_interval # 检查间隔(秒)
self.is_running = False
self.manager_task: asyncio.Task | None = None

View File

@@ -111,7 +111,7 @@ async def find_messages(
# 统一做上限保护,防止无限制查询导致内存暴涨
if limit <= 0:
capped_limit = SAFE_FETCH_LIMIT
logger.warning(
logger.debug(
f"find_messages 未指定 limit自动限制为 {capped_limit} 行以避免内存占用过高",
)
else: