RSSaurus - Agent-Friendly RSS Feed Reader

核心用法

RSSaurus CLI 是 RSSaurus 阅读服务的官方命令行客户端，基于 Go 编写，提供完整的 RSS 订阅终端管理能力。核心工作流包括：身份验证（auth login/whoami）、订阅源浏览（feeds）、条目筛选与阅读（items 支持 --unread 过滤与分页）、批量操作（mark-read/save/unsave）以及 URL 管道输出（--urls 配合 open 命令）。

显著优点

• 开发者友好：纯 CLI 设计，支持 --json 机器可读输出，便于与 jq、xargs 等工具链集成
• 工作流自动化：--urls 参数可直接管道至浏览器或其他工具，批量标记已读支持 --all 与 --feed-id 组合筛选
• 配置灵活：支持 XDG_CONFIG_HOME 标准路径，环境变量覆盖（RSSAURUS_HOST/RSSAURUS_TOKEN）便于多账户或自托管场景

潜在局限

• 功能边界：作为客户端工具，完全依赖 RSSaurus 服务端 API，离线不可用；unsave 操作需要内部 ID 而非 URL，增加脚本复杂度
• 生态依赖：需手动维护 Homebrew tap 安装，非主流包管理器覆盖
• 隐私设计：默认隐藏内部 DB ID，脚本场景必须显式使用 --json，增加学习成本

适合人群

• 重度 RSS 用户中的开发者/运维人员
• 需要自动化 RSS triage（筛选、标记、归档）的工作流构建者
• 偏好终端效率工具的 power user

常规风险

• Token 安全：配置文件明文存储 API token，多用户系统需确保 ~/.config/rssaurus/ 权限隔离
• 误操作不可逆：mark-read --all 无二次确认，建议在脚本中加入 --dry-run 逻辑或备份状态
• API 依赖：服务端变更可能导致 CLI 功能异常，需关注官方仓库更新

核心用法

RSSaurus CLI 是一个纯文档型 Skill，用于指导用户通过本地安装的 rssaurus 二进制文件与 RSSaurus 服务（https://rssaurus.com）进行交互。主要功能包括：

认证管理：rssaurus auth login/whoami 进行身份验证，配置存储于 ~/.config/rssaurus/config.json。

订阅源与文章管理：

• 列出订阅源：rssaurus feeds [--json]
• 浏览文章：rssaurus items --limit N [--feed-id ID] [--urls]
• 分页获取：--cursor 参数支持游标分页

文章操作：

• 标记已读/未读：rssaurus read/unread <item-id>
• 批量标记：rssaurus mark-read --all 或 --ids 1,2,3
• 保存文章：rssaurus save <URL> --title "标题"

输出友好：默认人类可读格式，使用 --json 获取机器可处理的 ID 和数据。

显著优点

• 纯文档零风险：仅 Markdown 说明，无嵌入代码，100% 透明可查
• 标准 CLI 模式：遵循 POSIX 风格命令设计，管道友好（--urls 输出）
• 隐私保护设计：默认隐藏内部 DB ID，需显式启用 JSON 模式
• 环境变量覆盖：支持 RSSAURUS_HOST/RSSAURUS_TOKEN 临时配置

局限与注意事项

• 依赖外部二进制：需预先安装 rssaurus CLI（Go 编译产物），Skill 本身不提供安装
• 需有效 Token：所有写操作（mark-read, save）依赖 API 认证
• ID 获取间接：部分命令需先通过 --json 获取 item-id，非直接 URL 操作
• 保存文章反查不便：unsave 需 saved-item-id，列表查询功能待完善

适合人群

• 已使用 RSSaurus 服务的开发者与技术用户
• 偏好终端工作流、需要批量处理 RSS 数据的自动化场景
• 需要将 RSS 阅读整合到脚本工作流中的高级用户

风险说明

• 低风险：纯文档无执行代码，无恶意模式检出
• 配置安全：Token 存储于本地配置文件，需确保 ~/.config/rssaurus 权限正确（建议 0600）
• 网络通信：仅与官方 rssaurus.com 及 GitHub 交互，TLS 加密
• 误操作可能：mark-read --all 为批量操作，执行前建议确认范围