🔔 AstrBot GitHub 动态监听插件

通过 GitHub 公开的 RSS (Atom Feed) 定时获取用户动态、仓库 Release 和 Commit 信息，自动推送到绑定的聊天会话中。

✨ 功能特性

• 📡 用户动态监听 — Star、Fork、创建仓库、Push 等公开事件
• 📦 仓库 Release 监听 — 新版本发布提醒
• 📝 仓库 Commit 监听 — 最新提交推送
• ⏱️ 定时轮询 — 可自定义轮询间隔（默认 30 分钟，最低 60 秒）
• 🌐 多会话推送 — 支持绑定多个聊天会话
• 🕐 时区转换 — 自动将 GitHub 时间转为本地时区
• 🔒 权限控制 — 关键指令仅管理员可用
• 🚀 并发拉取推送 — 多目标并行处理，高效不阻塞
• 🛡️ 输入校验 — 用户名/仓库名合法性检查，防止无效请求
• 🔐 并发安全 — 配置写入加锁，避免竞态条件

📋 可用指令

指令	权限	说明
/gh_list	所有人	列出所有监听项和绑定会话数
/gh_check <用户名>	管理员	立即查看某用户的最新动态
/gh_check <owner/repo>	管理员	立即查看某仓库的最新 Release
/gh_check <owner/repo> commit	管理员	立即查看某仓库的最新 Commit
/gh_bindhere	管理员	将当前会话绑定为推送目标
/gh_unbindhere	管理员	解绑当前会话

⚙️ 配置项

在 AstrBot WebUI 插件配置页面可设置：

配置项	类型	默认值	说明
poll_interval	int	1800	轮询间隔（秒），建议不低于 600 秒
max_entries	int	5	每次推送的最大条目数，设为 0 不限制
watch_users	list	[]	监听的 GitHub 用户名列表
watch_repos	list	[]	监听 Release 的仓库（owner/repo 格式）
watch_repos_commits	list	[]	监听 Commit 的仓库（owner/repo 格式）
timezone	string	Asia/Shanghai	时间显示时区
bound_sessions	list	[]	推送目标会话（也可用 /gh_bindhere 绑定，或通过 /sid 获取 UMO 手动填写）

🚀 快速开始

1. 安装插件后，在 WebUI 配置中填写要监听的用户或仓库
2. 在聊天中发送 /gh_bindhere 绑定当前会话为推送目标
3. 插件将按设定间隔自动检查并推送新动态
4. 使用 /gh_check <目标> 可随时手动查看最新动态

📦 安装

在 AstrBot 中搜索 astrbot_plugin_listen_github 安装，或手动克隆：

cd AstrBot/data/plugins
git clone https://github.com/aliveriver/astrbot_plugin_listen_github.git

要求：AstrBot >= 4.9.2

📄 更新日志

详见 CHANGELOG.md

📄 许可证

GPL-3.0

欢迎 Issue 与 PR

---

快去视奸你好友的 GitHub 动态吧）