[Feature Request] 插件主动消息保存到对话历史 / WebUI 记录

[fqf060420]

Description / 描述

功能描述

希望为插件提供 API，将主动发送的消息（如定时任务、邮件推送）保存到对话历史中，使：

1. WebUI "对话数据" 页面能显示这些消息
2. LLM 在后续对话中能感知这些消息内容

使用场景

开发了一个邮件推送插件（EmailNotixion），通过 context.send_message() 或 target_event.send() 向用户推送邮件摘要。但存在以下问题：

• WebUI 不显示：推送的消息在 WebUI 对话历史中完全不可见
• LLM 无上下文：用户后续询问"刚才那封邮件是谁发的"，LLM 不知道邮件内容
• 无法持久化：插件侧修改 conversation.history 后没有 save() 方法，重启后丢失

已尝试的方案

方案 1：直接修改 conversation.history

conversation = self.context.get_conversation(uid)
history = json.loads(conversation.history)
history.append({"role": "user", "content": "..."})
history.append({"role": "assistant", "content": "..."})
conversation.history = json.dumps(history)

结果：修改仅存在于内存，重启后丢失。Conversation 对象没有 save() 方法。

方案 2：ConversationManager.update_conversation()

await conv_mgr.update_conversation(conversation)

结果：抛出 TypeError: unhashable type: 'Conversation'，API 参数类型不匹配。

方案 3：context.send_message()

await self.context.send_message(umo, message)

结果：消息能发送给用户，但不保存到对话历史（设计行为）。

期望的解决方案
提供以下任一 API：
1.conversation.save() 或 await conversation.persist()
将内存中的 history 变更同步到数据库
2.await context.add_message_pair(umo, user_message, assistant_message)
类似于内部使用的 add_message_pair，但暴露给插件
3.修改 context.send_message() 行为
增加参数 save_to_history=True，允许插件选择是否保存

环境信息
AstrBot 版本：v4.26.5
部署方式：Docker / proot-distro Debian

相关日志
[EmailNotixion] !! DIAG: update_conversation FAILED: TypeError: unhashable type: 'Conversation'
[EmailNotixion] !! DIAG: reloaded has inject=False
[EmailNotixion] !! DIAG: reloaded len=28535 # 与修改前相同，未持久化

补充
类似需求可能适用于所有"主动推送"类插件：
邮件/日历提醒
系统监控告警
定时任务报告
如果已有解决方案请指出，感谢！
数据库：SQLite（默认）

Use Case / 使用场景

邮件推送、定时任务等插件主动发送的消息

Willing to Submit PR? / 是否愿意提交PR？

• Yes, I am willing to submit a PR. / 是的，我愿意提交 PR。

Code of Conduct

• I have read and agree to abide by the project's Code of Conduct. /

[Sjshi763]

既然是插件的需求，我认为应该插件解决，其他的插件也有定期编排上下文，也许可以类似这样实现？

[fqf060420]

既然是插件的需求，我认为应该插件解决，其他的插件也有定期编排上下文，也许可以类似这样实现？

@Sjshi763 感谢回复！我需要澄清一下需求：

这不是"临时注入上下文"的问题，而是"插件主动消息无法持久化到对话历史"的框架级限制。

我已经尝试过插件侧的所有方案：

1. 直接修改 conversation.history

   history = json.loads(conversation.history)
   history.append({"role": "user", "content": "..."})
   conversation.history = json.dumps(history)

结果：修改仅存在于内存，重启后丢失。Conversation 对象没有 save() 方法。
ConversationManager.update_conversation()

await conv_mgr.update_conversation(conversation)

结果：TypeError: unhashable type: 'Conversation'，API 参数类型不匹配。
context.send_message()
结果：消息能发送给用户，但设计行为就是不保存到历史。
其他插件的"定期编排上下文"（如记忆插件） 通常是在每次 LLM 请求前动态注入 prompt，这确实可以工作，但：
不保存到数据库
WebUI 对话记录中看不到这些消息
用户无法回溯"机器人主动推送了什么"
期望：类似 conversation.save() 或 context.add_message_to_history(umo, role, content) 的 API，让插件能把主动消息（如定时邮件推送、系统告警）写入持久化历史。
请问当前框架是否有我遗漏的 API？如果没有，是否可以作为 enhancement 考虑？