nonebot-plugin-trumpwatcher-legacy 1.0.4

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

nonebot-plugin-trumpwatcher

�?监控特朗�?Truth Social 动态并推送到订阅�?✨

📖 介绍

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

💿 安装

使用 nb-cli 安装（推荐）

�?NoneBot2 项目的根目录下打开命令�?输入以下指令即可安装:

nb plugin install nonebot-plugin-trumpwatcher

使用包管理器安装

�?NoneBot2 项目的插件目录下,打开命令�?根据你使用的包管理器,输入相应的安装命�?

pip

pip install nonebot-plugin-trumpwatcher

pdm

pdm add nonebot-plugin-trumpwatcher

poetry

poetry add nonebot-plugin-trumpwatcher

conda

conda install nonebot-plugin-trumpwatcher

打开 NoneBot2 项目根目录下�?pyproject.toml 文件,�?[tool.nonebot] 部分追加写入:

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 文件中添加以下配置项（未配置则使用默认值）:

基础配置

配置�?	类型	默认�?	说明
TRUMPWATCHER_SOURCE_URL	str	https://ix.cnn.io/data/truth-social/truth_archive.json	数据源地址
TRUMPWATCHER_FETCH_LIMIT	int	20	每次拉取并比对的最大条数（1-100�?
TRUMPWATCHER_TIMEOUT	float	20.0	拉取数据超时（秒�?
TRUMPWATCHER_FORWARD_USER_ID	int	10000	合并转发节点显示�?QQ �?
TRUMPWATCHER_FORWARD_NICKNAME	str	特朗普观察员	合并转发节点显示昵称

AI 翻译总结配置

配置�?	类型	默认�?	说明
TRUMPWATCHER_AI_SUMMARY_ENABLED	bool	false	是否启用 AI 翻译总结
TRUMPWATCHER_AI_SUMMARY_MAX_POSTS	int	3	每次拉取最多对�?N 条追�?AI 总结�?-100�?
TRUMPWATCHER_AI_PROVIDER	str	qwen	AI 服务提供方标�?
TRUMPWATCHER_AI_API_BASE	str	https://dashscope.aliyuncs.com/compatible-mode/v1	AI API Base URL
TRUMPWATCHER_AI_API_KEY	str	""	AI API Key（开�?AI 时必填）
TRUMPWATCHER_AI_MODEL	str	qwen-plus	AI 模型�?
TRUMPWATCHER_AI_TIMEOUT	float	20.0	AI 请求超时（秒�?
TRUMPWATCHER_AI_TEMPERATURE	float	0.2	AI 生成温度�?-2�?
TRUMPWATCHER_AI_MAX_CHARS	int	2000	单条动态送入 AI 的最大字符数�?00-20000�?
TRUMPWATCHER_AI_MULTIMODAL_ENABLED	bool	true	是否启用图片多模态输�?
TRUMPWATCHER_AI_MULTIMODAL_MAX_IMAGES	int	3	单条动态最多传入的图片 URL 数量�?-10�?

自动推送配�?

配置�?	类型	默认�?	说明
TRUMPWATCHER_AUTO_FETCH_ENABLED	bool	false	是否启用自动拉取并推�?
TRUMPWATCHER_AUTO_FETCH_CRON	str	*/10 * * * *	自动拉取 cron�? �?crontab 表达式）
TRUMPWATCHER_AUTO_FETCH_TIMEZONE	str	Asia/Shanghai	自动拉取时区

配置示例

# 基础配置
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 * * * *

🎮 使用

命令列表

命令	别名	权限	说明
trump社媒拉取	trump / trump_fetch / trumpwatcher_fetch	任意群成�?	拉取最新动态、归档并推送到所有订阅群
trump社媒订阅	trump_sub / trumpwatcher_sub	群管理员/群主/SUPERUSER	当前群加入推送列�?
trump社媒取消订阅	trump_unsub / trumpwatcher_unsub	群管理员/群主/SUPERUSER	当前群移出推送列�?

使用流程

1. **订阅推�?*: 在需要接收推送的群中发�?trump社媒订阅
2. 手动拉取: 发�?trump社媒拉取 立即拉取最新动�?
3. **自动推�?*: 配置 TRUMPWATCHER_AUTO_FETCH_ENABLED=true 启用定时自动推�?
4. 取消订阅: 发�?trump社媒取消订阅 停止接收推�?

🔧 数据库迁�?

首次启用或升级表结构后执�?

nb orm upgrade

涉及�?

• trumpwatcher_post_archive: 动态归�?
• trumpwatcher_notify_group: 订阅群列�?

💡 AI 翻译总结说明

• 默认使用千问（Qwen）兼容接�?
• 启用后会在转发内容后追加"AI翻译总结"
• 支持多模态图片输入（需模型支持�?
• 如果模型不支持图�?会自动降级为纯文本总结
• 请求失败时自动降级为仅发送原始消�?不影响主流程

📄 许可�?

本项目使�?MIT 许可证�?

📦 发布信息

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

🔧 开发者须�?

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

🙏 致谢

• 数据�? CNN Truth Social Archive
• 框架: NoneBot2