nonebot-plugin-trumpwatcher

✨ 监控特朗普 Truth Social 动态并推送到订阅群 ✨

📖 介绍

一个用于监控特朗普 Truth Social 动态的 NoneBot2 插件,支持自动拉取、群组订阅推送和 AI 翻译总结。

💿 安装

nb plugin install nonebot-plugin-trumpwatcher

pip install nonebot-plugin-trumpwatcher

pdm add nonebot-plugin-trumpwatcher

poetry add nonebot-plugin-trumpwatcher

conda install nonebot-plugin-trumpwatcher

plugins = ["nonebot_plugin_trumpwatcher"]

🎉 数据源

• CNN Truth Social Archive
• 免费公开接口,无需代理,约每 5 分钟更新一次

📝 依赖

• NoneBot2 >= 2.4.0
• nonebot-adapter-onebot >= 2.4.0
• nonebot-plugin-orm >= 0.8.0
• nonebot-plugin-apscheduler >= 0.4.0

注意: 本插件不指定 NoneBot2 驱动器依赖，请根据你的需求在主项目中配置驱动器。

例如，在 .env 文件中配置：

DRIVER=~fastapi+~httpx+~websockets

并在主项目的 pyproject.toml 中安装对应的驱动器包（如果使用 poetry）：

poetry add nonebot2[fastapi,websockets]

⚙️ 配置

在 NoneBot2 项目的 .env 文件中添加以下配置项（未配置则使用默认值）:

基础配置

AI 翻译总结配置

内容过滤配置

自动推送配置

配置示例

# 基础配置
TRUMPWATCHER_FETCH_LIMIT=20
TRUMPWATCHER_TIMEOUT=20.0

# 启用 AI 翻译总结
TRUMPWATCHER_AI_SUMMARY_ENABLED=true
TRUMPWATCHER_AI_API_KEY=your_api_key_here
TRUMPWATCHER_AI_MODEL=qwen-plus

# 启用自动推送（每 5 分钟）
TRUMPWATCHER_AUTO_FETCH_ENABLED=true
TRUMPWATCHER_AUTO_FETCH_CRON=*/5 * * * *

🎮 使用

命令列表

使用流程

1. 订阅推送: 在需要接收推送的群中发送 trump社媒订阅
2. 查看状态: 发送 trump社媒状态 查看当前群订阅状态
3. 管理订阅: SUPERUSER 发送 trump社媒订阅列表 查看所有订阅群
4. 手动拉取: 发送 trump社媒拉取 立即拉取最新动态
5. 自动推送: 配置 TRUMPWATCHER_AUTO_FETCH_ENABLED=true 启用定时自动推送
6. 取消订阅: 发送 trump社媒取消订阅 停止接收推送

🔧 数据库迁移

首次启用或升级表结构后执行:

nb orm upgrade

涉及表:

• trumpwatcher_post_archive: 动态归档
• trumpwatcher_notify_group: 订阅群列表

💡 AI 翻译总结说明

• 默认使用千问（Qwen）兼容接口
• 启用后会在转发内容前插入 AI 生成的标题和概要
• 支持多模态图片输入（需模型支持）
• 如果模型不支持图片，会自动降级为纯文本总结
• AI 输出解析失败自动重试 3 次，仍失败则使用时间戳作为标题
• 请求失败时自动降级为仅发送原始消息，不影响主流程

📄 许可证

本项目使用 MIT 许可证。

📦 发布信息

• PyPI: https://pypi.org/project/nonebot-plugin-trumpwatcher/
• GitHub: https://github.com/StuGRua/nonebot-plugin-trumpwatcher

🔧 开发者须知

如果你想参与开发或了解插件的最佳实践，请查看 MAINTENANCE.md。

🙏 致谢

• 数据源: CNN Truth Social Archive
• 框架: NoneBot2