名称： rssaurus-cli
描述： "使用 RSSaurus 命令行客户端（Go 二进制程序 rssaurus）在终端中与 https://rssaurus.com 交互：身份验证（rssaurus auth login/whoami）、列出订阅源/条目、打印条目 URL 用于管道操作、打开 URL，以及执行分类操作（标记已读/未读、批量标记已读、保存/取消保存）。当需要从 CLI 自动化 RSSaurus 任务、调试令牌/配置问题或演示命令用法时使用。"

RSSaurus CLI

使用本机已安装的 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>

打开 URL

rssaurus open https://example.com

标记已读/未读

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

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

批量标记已读：

rssaurus mark-read --all
# 或
rssaurus mark-read --ids 1,2,3
# 可选
rssaurus mark-read --all --feed-id 3

保存 / 取消保存

rssaurus save https://example.com --title "可选标题"

# 取消保存需要 ID（可通过 API 响应的 --json 输出或未来的已保存条目列表获取）
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