[Bug] 缺少'astrbot.core.agent.message' 插件服务未就绪

[vroyde]

Plugin Version

Next-2.0.6

AstrBot Version

v4.19.2

Database Type

SQLite (default)

Operating System

Windows

Bug Description

未能正常运行插件

Steps to Reproduce

1.启动AstrBot等待插件启动
2.出现错误

Expected Behavior

正常运行插件

Error Logs

[18:49:42] [Core] [ERRO] [core.plugin_lifecycle:269]: 服务层初始化过程中发生未知错误: No module named 'astrbot.core.agent.message' 
Traceback (most recent call last):
  File "G:\BOT\AstrBotLauncher-0.1.5.6\AstrBot\data\plugins\astrbot_plugin_self_learning\core\plugin_lifecycle.py", line 168, in bootstrap
    from ..services.hooks.llm_hook_handler import LLMHookHandler
  File "G:\BOT\AstrBotLauncher-0.1.5.6\AstrBot\data\plugins\astrbot_plugin_self_learning\services\hooks\llm_hook_handler.py", line 16, in <module>
    from astrbot.core.agent.message import TextPart
ModuleNotFoundError: No module named 'astrbot.core.agent.message'
 [18:49:42] [Core] [ERRO] [astrbot_plugin_self_learning.main:137]: 插件服务编排失败，部分功能将不可用: 插件初始化失败: No module named 'astrbot.core.agent.message' 
Traceback (most recent call last):
  File "G:\BOT\AstrBotLauncher-0.1.5.6\AstrBot\data\plugins\astrbot_plugin_self_learning\core\plugin_lifecycle.py", line 168, in bootstrap
    from ..services.hooks.llm_hook_handler import LLMHookHandler
  File "G:\BOT\AstrBotLauncher-0.1.5.6\AstrBot\data\plugins\astrbot_plugin_self_learning\services\hooks\llm_hook_handler.py", line 16, in <module>
    from astrbot.core.agent.message import TextPart
ModuleNotFoundError: No module named 'astrbot.core.agent.message'

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "G:\BOT\AstrBotLauncher-0.1.5.6\AstrBot\data\plugins\astrbot_plugin_self_learning\main.py", line 133, in __init__
    self._lifecycle.bootstrap(
    ~~~~~~~~~~~~~~~~~~~~~~~~~^
        self.plugin_config, self.context, self.group_id_to_unified_origin
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    )
    ^
  File "G:\BOT\AstrBotLauncher-0.1.5.6\AstrBot\data\plugins\astrbot_plugin_self_learning\core\plugin_lifecycle.py", line 272, in bootstrap
    raise SelfLearningError(
        StatusMessages.INIT_FAILED_GENERIC.format(error=str(e))
    ) from e
data.plugins.astrbot_plugin_self_learning.exceptions.SelfLearningError: 插件初始化失败: No module named 'astrbot.core.agent.message'

Relevant Configuration

Additional Context

No response

[github-actions]

🤖 Issue 审查报告

优先级: 🟠 high

📋 用户处理意见

问题摘要: 当前插件版本（Next-2.0.6）依赖 AstrBot 的新内部模块路径 astrbot.core.agent.message，而你使用的 AstrBot v4.19.2 中不存在该模块，导致插件在服务层 bootstrap 阶段直接初始化失败。

问题分类: 环境问题

建议操作：

1. 升级 AstrBot 到包含 astrbot.core.agent.message 的版本（建议更新到 AstrBot 最新稳定版/开发版；更新完成后重启 AstrBot 再观察是否仍报同样的 ModuleNotFoundError）。
2. 如果你必须停留在 AstrBot v4.19.2：请将自学习插件切换/回退到与 v4.19.2 兼容的插件版本（不要使用 Next-2.0.6 分支/版本）；回退后重启 AstrBot。
3. 验证：在 AstrBot 的 Python 环境中检查模块是否存在（可选）。进入 AstrBot 的运行环境后执行 python -c "import astrbot.core.agent.message"，能正常 import 才说明版本匹配。

---

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

技术摘要: 插件在 services/hooks/llm_hook_handler.py 硬编码依赖 astrbot.core.agent.message.TextPart，导致在 AstrBot v4.19.2（该模块不存在）上启动即崩溃；需要做 AstrBot 版本兼容导入/降级策略，并避免 ImportError 使整个插件 bootstrap 失败。

相关模块: services/hooks, core/plugin_lifecycle, core/plugin

相关文件: services/hooks/llm_hook_handler.py, core/plugin_lifecycle.py, main.py

根因分析: 在 services/hooks/llm_hook_handler.py 第 16 行：from astrbot.core.agent.message import TextPart，该导入在 AstrBot v4.19.2 下触发 ModuleNotFoundError。异常在 core/plugin_lifecycle.py:168 bootstrap 阶段 import LLMHookHandler 时抛出，最终导致 main.py 初始化失败（插件服务编排失败）。

修复建议: 1) 为 AstrBot API 变动做兼容层：新增例如 utils/astrbot_compat.py，提供 get_text_part_class() 或 TextPart 的 try-import：

• try: from astrbot.core.agent.message import TextPart
• except ImportError: 尝试旧路径（需根据 v4.19.2 实际路径确认，比如 astrbot.core.agent.messages/astrbot.core.message 等），或退化为本插件内部的最小 TextPart 协议（仅使用 .text/content）。
  然后在 services/hooks/llm_hook_handler.py 改为从 compat 模块导入。

2. 降级启动策略：在 core/plugin_lifecycle.py 的 bootstrap 中对 LLMHookHandler 的导入/初始化单独捕获 ImportError（或更宽泛 Exception），记录 warning 并禁用 LLM hook 相关功能，但允许插件其余模块继续启动（避免整个插件不可用）。

3. 明确版本约束：在 README/发布说明/插件元信息中标注最小 AstrBot 版本；如 Next-2.0.6 确实要求 >= 某版本，则在启动时做版本检测并给出明确提示（替代当前的 ModuleNotFoundError）。

---

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

[NickCharlie]

@vroyde 收到，正在排查问题