Skip to content

Commit 1312b0b

Browse files
VerseOSVerseOS
authored andcommitted
feat: add interactive tiny.opml feed import helper
1 parent 7909c11 commit 1312b0b

File tree

4 files changed

+561
-0
lines changed

4 files changed

+561
-0
lines changed

README.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,6 +89,33 @@ python3 scripts/opml_sync.py \
8989
--retries 3
9090
```
9191

92+
## Add New RSS Into tiny.opml (Interactive)
93+
94+
Use this helper script when you discover a new feed URL:
95+
96+
```bash
97+
uv run python scripts/add_feed_to_tiny.py
98+
```
99+
100+
Default behavior:
101+
102+
- Runs `git pull --ff-only` first to reduce local/remote drift before editing.
103+
- Prints current top-level categories in `tiny.opml`.
104+
- Lets you select a category by number or type a new name (auto-create).
105+
- Fetches feed metadata (title/site link) from your RSS URL, then appends it.
106+
107+
Common options:
108+
109+
```bash
110+
# Non-interactive
111+
uv run python scripts/add_feed_to_tiny.py \
112+
--url "https://example.com/feed.xml" \
113+
--category "ThreatIntel"
114+
115+
# Skip startup git pull
116+
uv run python scripts/add_feed_to_tiny.py --no-git-pull
117+
```
118+
92119
## OPML/XML Compatibility
93120

94121
Some readers only accept a specific extension. You can safely rename files:

README.zh-CN.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,6 +89,33 @@ python3 scripts/opml_sync.py \
8989
--retries 3
9090
```
9191

92+
## 交互式新增 RSS 到 tiny.opml
93+
94+
当你发现新的 RSS 链接时,可以使用下面的脚本:
95+
96+
```bash
97+
uv run python scripts/add_feed_to_tiny.py
98+
```
99+
100+
默认行为:
101+
102+
- 启动先执行 `git pull --ff-only`,尽量减少本地与远程分支漂移。
103+
- 先打印 `tiny.opml` 现有一级分类。
104+
- 你可以输入分类编号,或直接输入新分类名(不存在会自动创建)。
105+
- 脚本会抓取 RSS 元信息(标题/站点链接)并追加到 `tiny.opml`
106+
107+
常用参数:
108+
109+
```bash
110+
# 非交互模式
111+
uv run python scripts/add_feed_to_tiny.py \
112+
--url "https://example.com/feed.xml" \
113+
--category "ThreatIntel"
114+
115+
# 跳过启动时的 git pull
116+
uv run python scripts/add_feed_to_tiny.py --no-git-pull
117+
```
118+
92119
## OPML/XML 兼容说明
93120

94121
部分阅读器仅接受 `.xml``.opml` 后缀,可直接改名使用:

0 commit comments

Comments
 (0)