搬史插件 (ForwardPlugin)

Caution

目前手机端无法查看转发的聊天记录

任何漏洞、疑问或功能建议请提出issue或联系我，qq:1523640161

插件简介

该插件可以自动从指定来源转发聊天记录到目标群聊或私聊

功能特性

• 自动转发指定来源的消息
• 支持群聊和私聊消息转发
• 可自定义转发规则，使用大模型辅助判断消息是否适合转发
• 支持多种消息类型（聊天记录、图片、文本等）

配置说明

配置文件结构

配置文件为 config.toml，主要包含以下部分：

# 插件基本信息
[plugin]
config_version = "1.1.0"  # 配置文件版本
enabled = true            # 是否启用插件

# 转发消息配置
[forward]
allow = ["seglist", "image"]  # 允许转发的类型(seglist:聊天记录，image:图片，text：文本)
judge_model = "utils"     # 判断是否适合转发的模型，从Maibot的model_config自动获取，可为replyer、tool_use等
judge_rule = "1.来源可信：确保重大信息经可靠信源证实，非匿名或可疑来源。\n2.合法性评估：信息无淫秽、引战、辱骂信息。\n3.娱乐为先：对于奇怪有趣的消息适当放宽标准"  # 判断规则
disable_judge = false     # 是否取消大模型判断，进行无条件转发（谨慎使用）
sources = ["xxxxx", "xxxxx"]   # 要转发的源头群聊或用户ID
target_groups = ["xxxxx", "xxxxx"]  # 目标群ID
target_users = ["xxxxx", "xxxxx"]  # 目标用户ID
interval = 0              # 转发冷却（秒）

使用方法

1. 配置需要转发消息的来源群号或用户QQ号到 sources 列表中
2. 配置需要转发消息的目标群号到 target_groups 列表中
3. 配置需要转发消息的目标用户QQ号到 target_users 列表中
4. 设置允许转发的消息类型到 allow 配置项（"seglist":聊天记录，"image":图片，"text":文本）
5. 如源头群内只有史，修改 disable_judge 为 true
6. 如需修改判断规则，编辑 judge_rule 配置项

工作原理

1. 插件监听所有消息事件
2. 当接收到消息时，首先判断是否为转发消息且消息类型在 allow 列表中
3. 检查消息是否来自配置的来源群或用户
4. 如果启用了大模型判断，使用配置的规则判断消息是否适合转发
5. 等待冷却时间结束后进行转发
6. 将符合条件的消息转发到所有配置的目标群和用户

注意事项

• 配置文件中的列表项必须使用英文逗号分隔，不能使用中文顿号
• 使用大模型判断功能需要确保模型配置正确
• 合理设置 interval 参数，防止因频繁转发被平台限制
• 配置 allow 参数可以控制插件处理的消息类型
• 遵守相关法律法规，不得转发违规内容

鸣谢

MaiBot

灵感来源anka-afk/astrbot_sowing_discord