feat: add OPML auto-clean and sync workflow

Author: VerseOS

.github/workflows/opml-sync.yml

@@ -0,0 +1,76 @@
+name: OPML Sync
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  check:
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Run unit tests
+        run: python -m unittest discover -s tests -v
+
+      - name: Run OPML check mode
+        run: |
+          python scripts/opml_sync.py \
+            --mode check \
+            --tiny tiny.opml \
+            --full CyberSecurityRSS.opml \
+            --fallback-category Misc \
+            --timeout 10 \
+            --retries 3
+
+  apply:
+    if: github.event_name == 'push' && github.actor != 'github-actions[bot]'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Run unit tests
+        run: python -m unittest discover -s tests -v
+
+      - name: Run OPML apply mode
+        run: |
+          python scripts/opml_sync.py \
+            --mode apply \
+            --tiny tiny.opml \
+            --full CyberSecurityRSS.opml \
+            --fallback-category Misc \
+            --timeout 10 \
+            --retries 3
+
+      - name: Commit and push changes
+        run: |
+          if git diff --quiet; then
+            echo "No OPML changes detected."
+            exit 0
+          fi
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add tiny.opml CyberSecurityRSS.opml
+          git commit -m "chore: auto-clean OPML feeds and sync from tiny [skip ci]"
+          git push

README.md

@@ -53,11 +53,21 @@ Use the same way as Usage 1
 
 ![7.png](https://i.loli.net/2021/02/10/pHdIEztoOUeVxv3.png)
 
+## Automation
+
+This repository uses GitHub Actions to keep OPML files healthy and synced:
+
+1. On `pull_request` to `master`, workflow runs in `check` mode and fails when OPML drift is detected.
+2. On `push` to `master`, workflow runs in `apply` mode:
+   - Validate RSS/Atom feed URLs in `tiny.opml` and `CyberSecurityRSS.opml`.
+   - Remove dead feed entries and deduplicate by `xmlUrl`.
+   - Sync valid feeds from `tiny.opml` into `CyberSecurityRSS.opml` (missing categories fall back to `Misc`).
+   - Auto-commit OPML changes with `[skip ci]`.
+
 ## Contribution
 
 If you find a great site, please submit an issue or pr
 
 ## Sponsor
 
 [![Powered by DartNode](https://dartnode.com/branding/DN-Open-Source-sm.png)](https://dartnode.com "Powered by DartNode - Free VPS for Open Source")
-

README.zh-CN.md

@@ -53,11 +53,21 @@ cp tiny.opml tiny.xml
 
 ![7.png](https://i.loli.net/2021/02/10/pHdIEztoOUeVxv3.png)
 
+## 自动化工作流
+
+仓库已配置 GitHub Actions 自动维护 OPML：
+
+1. `pull_request -> master` 触发 `check` 模式，只校验不改文件；如发现需要变更会直接失败。
+2. `push -> master` 触发 `apply` 模式，自动执行：
+   - 校验 `tiny.opml` 与 `CyberSecurityRSS.opml` 的 RSS/Atom 链接可访问性。
+   - 删除失效订阅，并按 `xmlUrl` 自动去重。
+   - 将 `tiny.opml` 中有效且大表缺失的链接同步到 `CyberSecurityRSS.opml`。
+   - 若分类不存在则归入 `Misc`，并自动提交修复结果（commit 含 `[skip ci]`）。
+
 ## 附录
 
 others.md中是我一般会主动浏览的站点并且一些站点没有提供rss的都写在了里面。
 
 ## 贡献
 
 如果大家还有很棒的站点欢迎提issue
-