nonebot-plugin-github-release 0.1.0__tar.gz

nonebot_plugin_github_release-0.1.0/.env.example

@@ -0,0 +1,33 @@
+# ============ GitHub 发布推送 ============
+
+# 监控哪些仓库（owner/repo 格式）。留空也可以，直接在群里用 /gh订阅 加更灵活
+GH_WATCH_REPOS=[]
+
+# 默认接收推送的群：与上面的仓库做组合，等价于「这些群都订阅这些仓库」
+GH_WATCH_GROUPS=[]
+
+# 轮询间隔（分钟），默认 10
+GH_WATCH_INTERVAL_MINUTES=10
+
+# 是否连 alpha / beta / rc 一起推，默认 True
+GH_WATCH_INCLUDE_PRERELEASE=True
+
+# 没有正文的 release 不算公告，默认 True
+GH_WATCH_REQUIRE_BODY=True
+
+# 可选：GitHub Token（匿名限额 60 次/小时且按出口 IP 共享，多仓库建议配上）
+GH_WATCH_GITHUB_TOKEN=
+
+# 可选：代理，服务器直连 GitHub 不稳时使用
+GH_WATCH_PROXY=
+
+# 文本推送 / 查询时的正文上限
+GH_WATCH_MAX_CHARS=600
+GH_WATCH_QUERY_MAX_CHARS=1200
+
+# 是否发送卡片图片（需要 nonebot-plugin-htmlrender + chromium）
+GH_WATCH_SEND_IMAGE=True
+GH_WATCH_CARD_WIDTH=900
+GH_WATCH_CARD_MAX_HEIGHT=1500
+GH_WATCH_CARD_MAX_CHARS=2400
+GH_WATCH_CARD_SHOW_REACTIONS=True

nonebot_plugin_github_release-0.1.0/.gitattributes

@@ -0,0 +1,6 @@
+# 服务器是 Linux，统一用 LF，避免 CRLF 混进部署目录
+* text=auto eol=lf
+
+*.png binary
+*.jpg binary
+*.ico binary

nonebot_plugin_github_release-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,35 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python -m pip install build
+      - run: python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    # 必须和 PyPI 待发布者里填的 Environment name 一致
+    environment: pypi
+    permissions:
+      # Trusted Publishing 靠这个，不需要任何密钥
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

nonebot_plugin_github_release-0.1.0/.gitignore

@@ -0,0 +1,25 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv/
+venv/
+
+# 测试与缓存
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# 本地配置与运行数据
+.env
+.env.*
+!.env.example
+data/
+
+# 编辑器 / 系统
+.idea/
+.vscode/
+.DS_Store
+Thumbs.db

nonebot_plugin_github_release-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ns
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nonebot_plugin_github_release-0.1.0/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.5
+Name: nonebot-plugin-github-release
+Version: 0.1.0
+Summary: 监控任意 GitHub 仓库的 release，把新版本推送到 QQ 群
+Project-URL: Homepage, https://github.com/NSQX13579/nonebot-plugin-github-release
+Project-URL: Repository, https://github.com/NSQX13579/nonebot-plugin-github-release
+Author-email: ns <102937666+NSQX13579@users.noreply.github.com>
+License: MIT License
+        
+        Copyright (c) 2026 ns
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: github,nonebot,nonebot2,release,watch
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.26
+Requires-Dist: nonebot-adapter-onebot>=2.4.0
+Requires-Dist: nonebot-plugin-apscheduler>=0.5.0
+Requires-Dist: nonebot-plugin-localstore>=0.7.0
+Requires-Dist: nonebot2>=2.4.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: tzdata; sys_platform == 'win32'
+Provides-Extra: image
+Requires-Dist: nonebot-plugin-htmlrender>=0.6.7; extra == 'image'
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# nonebot-plugin-github-release
+
+监控任意 GitHub 仓库的 release，把新版本推送到 QQ 群。按群订阅，每个群只收自己关心的仓库。
+
+本插件由 [nonebot-plugin-dsh-release](https://github.com/NSQX13579/nonebot-plugin-dsh-release) 改进而得。
+
+## 安装
+
+```bash
+pip install nonebot-plugin-github-release
+playwright install chromium        # 卡片图片需要，不装会自动回退纯文本
+```
+
+依赖 `nonebot-plugin-apscheduler`（定时）和 `nonebot-plugin-localstore`（数据目录），装包时会一并带上。
+
+## 配置
+
+`.env`（完整模板见 `.env.example`）：
+
+```dotenv
+# 监控哪些仓库（留空也行，直接在群里 /gh订阅 更灵活）
+GH_WATCH_REPOS=[]
+GH_WATCH_GROUPS=[]
+
+# 可选：匿名 API 限额 60 次/小时且按出口 IP 共享，多仓库建议配上
+GH_WATCH_GITHUB_TOKEN=
+```
+
+插件不带任何默认仓库——用群里的 `/gh订阅 owner/repo` 加，或者把上面的列表填上。
+
+## 指令
+
+| 指令 | 权限 | 说明 |
+| --- | --- | --- |
+| `/gh订阅 owner/repo` | 群管 | 本群订阅某个仓库 |
+| `/gh退订 owner/repo` | 群管 | 取消订阅 |
+| `/gh列表` | 所有人 | 看本群订阅了哪些仓库 |
+| `/gh公告 owner/repo` | 所有人 | 最新一条 release 全文 |
+| `/gh公告 owner/repo 5` | 所有人 | 列最近 5 条（最多 10） |
+| `/gh公告 owner/repo v1.2` | 所有人 | 按版本号检索 |
+| `/gh状态` | 所有人 | 推送状态 |
+| `/gh检查` | 超管 | 立刻检查一次，不等下一轮 |
+
+## 消息长什么样
+
+![示例](docs/card-example.png)
+
+图下面另附一行带链接的文字——图片里的地址点不了。卡片上的头像、发布时间、版本号、正文、表情计数都是 GitHub 的真实数据。
+
+**渲染出任何问题都会回退纯文本**（没装 htmlrender、没装 chromium、超时都算），只打一条警告日志，推送不受影响。
+
+## 行为说明
+
+- 数据源：Releases API 为主，被限流时自动切到不限流的 `releases.atom`
+- 首次运行只建推送基线，不会把历史 release 刷进群
+- 以 tag 去重，失败的不写进已推送列表，下一轮自然重试
+- 中英双语正文默认只保留中文段，`GH_WATCH_BODY_LANGUAGE=all` 可改成两段都留
+- `GH_WATCH_INCLUDE_PRERELEASE=False` 则只推正式版
+
+## License
+
+MIT

nonebot_plugin_github_release-0.1.0/README.md

@@ -0,0 +1,62 @@
+# nonebot-plugin-github-release
+
+监控任意 GitHub 仓库的 release，把新版本推送到 QQ 群。按群订阅，每个群只收自己关心的仓库。
+
+本插件由 [nonebot-plugin-dsh-release](https://github.com/NSQX13579/nonebot-plugin-dsh-release) 改进而得。
+
+## 安装
+
+```bash
+pip install nonebot-plugin-github-release
+playwright install chromium        # 卡片图片需要，不装会自动回退纯文本
+```
+
+依赖 `nonebot-plugin-apscheduler`（定时）和 `nonebot-plugin-localstore`（数据目录），装包时会一并带上。
+
+## 配置
+
+`.env`（完整模板见 `.env.example`）：
+
+```dotenv
+# 监控哪些仓库（留空也行，直接在群里 /gh订阅 更灵活）
+GH_WATCH_REPOS=[]
+GH_WATCH_GROUPS=[]
+
+# 可选：匿名 API 限额 60 次/小时且按出口 IP 共享，多仓库建议配上
+GH_WATCH_GITHUB_TOKEN=
+```
+
+插件不带任何默认仓库——用群里的 `/gh订阅 owner/repo` 加，或者把上面的列表填上。
+
+## 指令
+
+| 指令 | 权限 | 说明 |
+| --- | --- | --- |
+| `/gh订阅 owner/repo` | 群管 | 本群订阅某个仓库 |
+| `/gh退订 owner/repo` | 群管 | 取消订阅 |
+| `/gh列表` | 所有人 | 看本群订阅了哪些仓库 |
+| `/gh公告 owner/repo` | 所有人 | 最新一条 release 全文 |
+| `/gh公告 owner/repo 5` | 所有人 | 列最近 5 条（最多 10） |
+| `/gh公告 owner/repo v1.2` | 所有人 | 按版本号检索 |
+| `/gh状态` | 所有人 | 推送状态 |
+| `/gh检查` | 超管 | 立刻检查一次，不等下一轮 |
+
+## 消息长什么样
+
+![示例](docs/card-example.png)
+
+图下面另附一行带链接的文字——图片里的地址点不了。卡片上的头像、发布时间、版本号、正文、表情计数都是 GitHub 的真实数据。
+
+**渲染出任何问题都会回退纯文本**（没装 htmlrender、没装 chromium、超时都算），只打一条警告日志，推送不受影响。
+
+## 行为说明
+
+- 数据源：Releases API 为主，被限流时自动切到不限流的 `releases.atom`
+- 首次运行只建推送基线，不会把历史 release 刷进群
+- 以 tag 去重，失败的不写进已推送列表，下一轮自然重试
+- 中英双语正文默认只保留中文段，`GH_WATCH_BODY_LANGUAGE=all` 可改成两段都留
+- `GH_WATCH_INCLUDE_PRERELEASE=False` 则只推正式版
+
+## License
+
+MIT

nonebot_plugin_github_release-0.1.0/nonebot_plugin_github_release/__init__.py

@@ -0,0 +1,69 @@
+"""nonebot-plugin-github-release
+
+监控任意 GitHub 仓库的 release，把新版本推送到 QQ 群。
+
+- 数据源：Releases API 为主，被限流时自动切到不限流的 `releases.atom`
+- 推送形式：默认发一张类 GitHub 卡片的图片，渲染失败自动回退纯文本
+- 按群订阅：`/gh订阅 owner/repo`，每个群只收自己关心的仓库
+"""
+
+from datetime import datetime, timedelta
+
+from nonebot import require
+
+require("nonebot_plugin_apscheduler")
+
+from nonebot.log import logger  # noqa: E402
+from nonebot.plugin import PluginMetadata  # noqa: E402
+from nonebot_plugin_apscheduler import scheduler  # noqa: E402
+
+from . import commands as _commands  # noqa: E402,F401
+from .config import Config, load_config  # noqa: E402
+from .watch import check_once  # noqa: E402
+
+__all__ = ["Config", "check_once"]
+
+__plugin_meta__ = PluginMetadata(
+    name="GitHub 发布推送",
+    description="监控 GitHub 仓库的 release，把新版本推送到 QQ 群",
+    usage=(
+        "/gh订阅 owner/repo 让本群订阅（群管）\n"
+        "/gh公告 owner/repo 看最新 release\n"
+        "/gh状态 看推送状态"
+    ),
+    type="application",
+    homepage="https://github.com/NSQX13579/nonebot-plugin-github-release",
+    config=Config,
+    supported_adapters={"~onebot.v11"},
+)
+
+_JOB_ID = "github_release_watch"
+
+plugin_config: Config = load_config()
+
+
+async def _scheduled_check() -> None:
+    result = await check_once(plugin_config)
+    logger.debug(f"[gh-release] 定时检查：{result.status} | {result.detail}")
+
+
+scheduler.add_job(
+    _scheduled_check,
+    "interval",
+    minutes=max(1, plugin_config.gh_watch_interval_minutes),
+    # 启动 30 秒后先跑一轮，不用干等一个完整间隔
+    next_run_time=datetime.now() + timedelta(seconds=30),
+    id=_JOB_ID,
+    replace_existing=True,
+    coalesce=True,
+    max_instances=1,
+    misfire_grace_time=300,
+)
+
+if plugin_config.gh_watch_repos or plugin_config.gh_watch_groups:
+    logger.info(
+        f"[gh-release] 已启动：每 {plugin_config.gh_watch_interval_minutes} 分钟检查 "
+        f"{len(plugin_config.gh_watch_repos)} 个仓库"
+    )
+else:
+    logger.info("[gh-release] 尚未配置仓库，可在群里用 /gh订阅 owner/repo 添加")