介绍
# RSSaurus CLI
使用本机上已安装的 `rssaurus` 二进制文件与 RSSaurus 进行交互。
## 快速检查（当出现问题时）
1) 确认二进制文件存在：
```bash which rssaurus rssaurus --version || true ```
2) 确认认证有效：
```bash rssaurus auth whoami ```
### 隐私说明
- **不要**打印（例如使用 `cat`）RSSaurus CLI 配置文件的内容；其中可能包含 API 令牌。 - 如果认证失败，建议重新进行认证（`rssaurus auth login`）或请用户仅粘贴非敏感详细信息（错误输出、主机等）。
## 常见任务
### 列出订阅源
```bash rssaurus feeds rssaurus feeds --json ```
### 列出条目
默认为未读：
```bash rssaurus items --limit 20 ```
按订阅源筛选：
```bash rssaurus items --feed-id 3 --limit 20 ```
机器友好的 URL 输出（每行一个）：
```bash rssaurus items --limit 20 --urls ```
游标分页：
```bash rssaurus items --limit 50 --cursor <cursor> ```
### 打开 URL
```bash rssaurus open https://example.com ```
### 标记为已读/未读
这些操作需要条目 ID（通过 `--json` 获取）。
```bash rssaurus items --limit 5 --json rssaurus read <item-id> rssaurus unread <item-id> ```
批量标记为已读：
```bash rssaurus mark-read --all # or rssaurus mark-read --ids 1,2,3 # optional rssaurus mark-read --all --feed-id 3 ```
### 保存 / 取消保存
```bash 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