[Bug] 创建消息收集器失败: No module named 'cachetools'

[Asmalldevelopers]

Plugin Version

Next-2.0.6

AstrBot Version

v4.18.3

Database Type

SQLite (default)

Operating System

Linux

Bug Description

无法启动插件

Steps to Reproduce

1.更新至最新版本；
2.重载插件

Expected Behavior

正常装载插件

Error Logs

[2026-03-10 22:51:33.064] [Core] [INFO] [star.star_manager:555]: 正在载入插件 astrbot_plugin_self_learning ...
[2026-03-10 22:51:33.105] [Core] [INFO] [star.star_manager:634]: Plugin astrbot_plugin_self_learning (Next-2.0.6) by NickMo: SELF LEARNING 自主学习插件 — 让 AI 聊天机器人自主学习对话风格、理解群组黑话、管理社交关系与好感度、自适应人格演化，像真人一样自然对话。(使用前必须手动备份人格数据)
[2026-03-10 22:51:33.105] [Plug] [INFO] [astrbot_plugin_self_learning.main:81]: 使用用户自定义数据路径 (从Storage_Settings.data_dir): ./data/self_learning_data
[2026-03-10 22:51:33.106] [Plug] [INFO] [astrbot_plugin_self_learning.main:91]: 最终插件数据目录: /AstrBot/data/self_learning_data
[2026-03-10 22:51:33.106] [Plug] [INFO] [astrbot_plugin_self_learning.config:214]:  [配置加载] Model_Configuration原始数据: {'filter_provider_id': 'deepseek/deepseek-chat', 'refine_provider_id': 'moonshot/kimi-k2.5', 'reinforce_provider_id': 'moonshot/kimi-k2.5'}
[2026-03-10 22:51:33.106] [Plug] [INFO] [astrbot_plugin_self_learning.config:215]:  [配置加载] filter_provider_id: deepseek/deepseek-chat
[2026-03-10 22:51:33.106] [Plug] [INFO] [astrbot_plugin_self_learning.config:216]:  [配置加载] refine_provider_id: moonshot/kimi-k2.5
[2026-03-10 22:51:33.106] [Plug] [INFO] [astrbot_plugin_self_learning.config:217]:  [配置加载] reinforce_provider_id: moonshot/kimi-k2.5
[2026-03-10 22:51:33.106] [Plug] [INFO] [astrbot_plugin_self_learning.config:236]:  [配置加载] Goal_Driven_Chat_Settings原始数据: {'enable_goal_driven_chat': False, 'goal_session_timeout_hours': 24, 'goal_auto_detect': True, 'goal_max_conversation_history': 40}
[2026-03-10 22:51:33.107] [Plug] [INFO] [astrbot_plugin_self_learning.config:237]:  [配置加载] enable_goal_driven_chat: False
[2026-03-10 22:51:33.107] [Plug] [INFO] [astrbot_plugin_self_learning.main:94]: [插件初始化] Provider配置已加载：
[2026-03-10 22:51:33.107] [Plug] [INFO] [astrbot_plugin_self_learning.main:95]:  - filter_provider_id: deepseek/deepseek-chat
[2026-03-10 22:51:33.107] [Plug] [INFO] [astrbot_plugin_self_learning.main:96]:  - refine_provider_id: moonshot/kimi-k2.5
[2026-03-10 22:51:33.107] [Plug] [INFO] [astrbot_plugin_self_learning.main:97]:  - reinforce_provider_id: moonshot/kimi-k2.5
[2026-03-10 22:51:33.494] [Plug] [INFO] [core.patterns:321]: 注册服务: database_manager
[2026-03-10 22:51:33.494] [Plug] [INFO] [core.factory:254]: 创建数据库管理器成功 (实现: SQLAlchemyDatabaseManager)
[2026-03-10 22:51:33.501] [Plug] [ERRO] [v4.18.3] [core.factory:114]: 导入消息收集器失败: No module named 'cachetools'
Traceback (most recent call last):
  File "/AstrBot/data/plugins/astrbot_plugin_self_learning/core/factory.py", line 105, in create_message_collector
    from ..services.core_learning import MessageCollectorService
  File "/AstrBot/data/plugins/astrbot_plugin_self_learning/services/core_learning/__init__.py", line 5, in <module>
    from .v2_learning_integration import V2LearningIntegration
  File "/AstrBot/data/plugins/astrbot_plugin_self_learning/services/core_learning/v2_learning_integration.py", line 40, in <module>
    from ...utils.cache_manager import get_cache_manager
  File "/AstrBot/data/plugins/astrbot_plugin_self_learning/utils/cache_manager.py", line 9, in <module>
    from cachetools import TTLCache, LRUCache, Cache
ModuleNotFoundError: No module named 'cachetools'
[2026-03-10 22:51:33.506] [Plug] [ERRO] [v4.18.3] [core.plugin_lifecycle:259]: 自学习服务初始化失败: 创建消息收集器失败: No module named 'cachetools'
[2026-03-10 22:51:33.506] [Plug] [ERRO] [v4.18.3] [astrbot_plugin_self_learning.main:137]: 插件服务编排失败，部分功能将不可用: 创建消息收集器失败: No module named 'cachetools'
Traceback (most recent call last):
  File "/AstrBot/data/plugins/astrbot_plugin_self_learning/core/factory.py", line 105, in create_message_collector
    from ..services.core_learning import MessageCollectorService
  File "/AstrBot/data/plugins/astrbot_plugin_self_learning/services/core_learning/__init__.py", line 5, in <module>
    from .v2_learning_integration import V2LearningIntegration
  File "/AstrBot/data/plugins/astrbot_plugin_self_learning/services/core_learning/v2_learning_integration.py", line 40, in <module>
    from ...utils.cache_manager import get_cache_manager
  File "/AstrBot/data/plugins/astrbot_plugin_self_learning/utils/cache_manager.py", line 9, in <module>
    from cachetools import TTLCache, LRUCache, Cache
ModuleNotFoundError: No module named 'cachetools'

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/AstrBot/data/plugins/astrbot_plugin_self_learning/main.py", line 133, in __init__
    self._lifecycle.bootstrap(
  File "/AstrBot/data/plugins/astrbot_plugin_self_learning/core/plugin_lifecycle.py", line 51, in bootstrap
    p.message_collector = p.service_factory.create_message_collector()
                          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/AstrBot/data/plugins/astrbot_plugin_self_learning/core/factory.py", line 34, in wrapper
    result = func(self, *args, **kwargs)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/AstrBot/data/plugins/astrbot_plugin_self_learning/core/factory.py", line 115, in create_message_collector
    raise ServiceError(f"创建消息收集器失败: {str(e)}")
data.plugins.astrbot_plugin_self_learning.exceptions.ServiceError: 创建消息收集器失败: No module named 'cachetools'
[2026-03-10 22:51:33.512] [Plug] [INFO] [astrbot_plugin_self_learning.main:141]: 自学习插件初始化完成
[2026-03-10 22:51:33.512] [Plug] [INFO] [core.plugin_lifecycle:314]: 开始执行 on_load 方法
[2026-03-10 22:51:33.512] [Plug] [INFO] [core.plugin_lifecycle:323]: 尝试启动数据库管理器 (第 1/3 次)
[2026-03-10 22:51:33.513] [Plug] [INFO] [database.sqlalchemy_database_manager:66]: [DomainRouter] 开始启动…
[2026-03-10 22:51:33.514] [Plug] [INFO] [database.engine:62]: [DatabaseEngine] 数据库引擎初始化成功
[2026-03-10 22:51:33.514] [Plug] [INFO] [database.sqlalchemy_database_manager:74]: [DomainRouter] 数据库引擎已创建
[2026-03-10 22:51:33.622] [Plug] [INFO] [database.engine:239]: [DatabaseEngine] 数据库表结构同步完成
[2026-03-10 22:51:33.793] [Plug] [INFO] [database.sqlalchemy_database_manager:131]: [DomainRouter] 11 个领域 Facade 已初始化
[2026-03-10 22:51:33.793] [Plug] [INFO] [database.sqlalchemy_database_manager:82]: [DomainRouter] 数据库启动成功
[2026-03-10 22:51:33.793] [Plug] [INFO] [core.plugin_lifecycle:326]: 数据库管理器启动完成
[2026-03-10 22:51:33.793] [Plug] [INFO] [core.plugin_lifecycle:401]: 自学习插件加载完成

Relevant Configuration

Additional Context

No response

[github-actions]

🤖 Issue 审查报告

优先级: 🔴 critical

📋 用户处理意见

问题摘要: 插件在初始化消息收集器时导入 utils/cache_manager.py 依赖的第三方库 cachetools 失败，导致服务创建中断。

问题分类: 缺少依赖

建议操作：

1. 进入 AstrBot 运行环境（若使用 Docker/容器，请先 exec 进容器）：cd /AstrBot
2. 确认正在使用的 Python 与 AstrBot 主进程一致：python -V 或 python3 -V
3. 安装缺失依赖：python -m pip install -U cachetools （若是 python3：python3 -m pip install -U cachetools）
4. 如果你使用 venv/conda，请在激活对应环境后再执行上述 pip 安装
5. 重载/重启 AstrBot 后再次加载插件

---

🔧 开发者修复建议（点击展开）

技术摘要: 插件硬依赖 cachetools，但未被打包/声明为安装依赖，导致在干净环境或未预装依赖的 AstrBot 环境中启动失败。

相关模块: message capture, core_learning, utils.cache_manager, service factory

相关文件: utils/cache_manager.py, services/core_learning/v2_learning_integration.py, services/core_learning/__init__.py, core/factory.py, core/plugin_lifecycle.py

根因分析: utils/cache_manager.py 第 9 行 from cachetools import TTLCache, LRUCache, Cache 是强导入；该模块在 services/core_learning/v2_learning_integration.py 第 40 行被导入（from ...utils.cache_manager import get_cache_manager），进而在 core/factory.py:create_message_collector() 初始化阶段触发 ModuleNotFoundError，最终被包装成 ServiceError 导致“创建消息收集器失败”。

修复建议: 1) 在项目依赖声明中显式加入 cachetools（例如 requirements.txt / pyproject.toml / 插件的依赖清单，视本仓库发布方式而定），并在 README/安装文档补充。2) 为提高鲁棒性，可在 utils/cache_manager.py 对 cachetools 做可选导入：导入失败时回退到简单的纯 Python 缓存实现（或直接禁用缓存并打 warning），避免插件整体无法启动；同时在 core/factory.py:create_message_collector() 捕获该异常时给出更明确的提示（例如“请安装 cachetools”）。

---

_{🤖 此报告由 AI 自动生成，已分析仓库源码，仅供参考。开发者会尽快审阅您的 issue。}

[NickCharlie]

参考 #62 该issue的解决方案解决即可