RSSaurus 命令行界面

使用本机已安装的rssaurus二进制文件来与 RSSaurus 交互。

快速检查（当出现故障时）

1. 确认二进制文件存在：

which rssaurus
rssaurus --version || true

2. 确认认证有效：

rssaurus auth whoami

隐私说明

• 请不要打印（例如使用cat命令）RSSaurus CLI 配置文件的内容；其中可能包含 API 令牌。
• 如果认证失败，建议重新认证（使用rssaurus auth login命令）或请用户仅粘贴非敏感信息（错误输出、主机地址等）。

常见任务

列出订阅源

rssaurus feeds
rssaurus feeds --json

列出条目

默认显示未读条目：

rssaurus items --limit 20

按订阅源筛选：

rssaurus items --feed-id 3 --limit 20

机器友好的 URL 输出（每行一个）：

rssaurus items --limit 20 --urls

光标分页：

rssaurus items --limit 50 --cursor <cursor>

打开一个网址

rssaurus open https://example.com

标记为已读/未读

这些操作需要项目ID（可通过--json获取）。

rssaurus items --limit 5 --json
rssaurus read <item-id>
rssaurus unread <item-id>

批量标记为已读：

rssaurus mark-read --all
# or
rssaurus mark-read --ids 1,2,3
# optional
rssaurus mark-read --all --feed-id 3

保存 / 取消保存

rssaurus save https://example.com --title "Optional title"

# unsave requires an id (obtain via --json output from the API response or future saved-items listing)
rssaurus unsave <saved-item-id>

输出约定（隐私）

• 默认的人类可读输出会避免打印内部数据库ID。
• 当脚本或写操作需要ID时，请使用--json输出。

参考链接

• CLI仓库：https://github.com/RSSaurus/rssaurus-cli
• Homebrew tap：https://github.com/RSSaurus/tap
• 令牌创建：https://rssaurus.com/api_tokens/new