RSS Merge for Gitea Actions

用一个 Python 脚本合并多个 RSS/Atom 源，并由 Gitea Actions 每 4 小时更新一次。生成结果保存在 public/*.xml，可以直接通过 Gitea Raw URL 订阅。

使用

1. 编辑 feeds.yml，替换示例订阅源并按需增加分组。
2. 在 Gitea 仓库的 Actions Secrets 中创建 RSSHUB_ACCESS_KEY，值为 RSSHub 访问密钥。
3. 将仓库推送到 Gitea。
4. 在仓库设置中启用 Actions，并确保实例上已有可用的 act_runner。
5. 在 Actions 页面手动运行一次 Update RSS，确认 public/*.xml 被提交。

订阅地址格式：

https://git.example.com/{owner}/{repo}/raw/branch/main/public/all.xml

计划任务写在 .gitea/workflows/update.yml，0 */4 * * * 表示按 UTC 每 4 小时运行一次。修改 feeds.yml、脚本或依赖也会立即触发更新。

配置

每个 groups 条目会生成一个 RSS 文件，默认路径为 public/{分组名}.xml：

groups:
  tech:
    title: Tech News
    description: My technology feeds
    max_items: 100
    self_url: https://git.example.com/me/rss/raw/branch/main/public/tech.xml
    sources:
      - https://hnrss.org/frontpage
      - url: https://example.com/feed.xml
        name: Optional source name

• settings.allow_partial：默认是 true。部分源抓取失败时，仍使用成功获取的源生成输出；一个分组的所有源都失败时才跳过该分组。
• settings.user_agent：默认使用 Chrome User-Agent，也可以自行替换。
• output：可为分组指定仓库内的相对输出路径。

凡是主机名为 rsshub.yuzhen.pub 的订阅源，请在 feeds.yml 中填写不带访问密钥的原始 URL。脚本会读取 RSSHUB_ACCESS_KEY，自动改用 HTTPS 并添加或替换 URL 中的 key 参数；密钥不会写入生成的 XML 或普通日志。其他域名不会附加该参数。

同一个 URL 被多个分组引用时只会请求一次。输出按发布时间倒序排列并截取 max_items 条，不进行过滤或去重。内容不变时不会重写文件，也就不会制造空提交。

本地运行

python -m venv .venv
python -m pip install -r requirements.txt
RSSHUB_ACCESS_KEY=your-key python merge.py
python -m unittest discover -s tests -v

如果配置中没有 rsshub.yuzhen.pub，本地运行时无需设置这个环境变量。

首次成功运行后会创建 public/ 目录。请将生成的 XML 一并提交，后续源临时不可用时阅读器仍可访问最近一次结果。