# RSS Merge for Gitea Actions

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

## 使用

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

订阅地址格式：

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

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

## 配置

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

```yaml
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` 条，不进行过滤或去重。内容不变时不会重写文件，也就不会制造空提交。

## 本地运行

```bash
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 一并提交，后续源临时不可用时阅读器仍可访问最近一次结果。