FreshRSS Reader

核心用法

FreshRSS 技能通过 Google Reader 兼容 API 查询自建 RSS 阅读器中的订阅内容。用户需预先配置 FRESHRSS_URL、FRESHRSS_USER 及 FRESHRSS_API_PASSWORD 三个环境变量完成认证。主要功能包括：

• 获取头条：headlines 命令支持 --count 指定数量（默认20）、--hours 限定最近N小时、--category 按分类过滤、--unread 仅显示未读
• 浏览结构：categories 和 feeds 命令分别列出订阅分类与全部源地址
• 组合筛选：多重条件可叠加使用，如同时限定分类、时间窗口与阅读状态

输出格式清晰，包含日期、来源、标题、链接及分类标签，便于快速扫读。

显著优点

• 数据主权完全自主：RSS 内容存储于用户自有服务器，无第三方平台依赖
• 信息过滤精准：时间窗口+分类+已读状态三维筛选，避免信息过载
• 轻量高效：命令行交互，适合开发者与效率用户快速获取资讯
• 开放标准兼容：基于成熟的 Google Reader API 规范，扩展性良好

局限与风险

• 前置成本较高：需自行部署 FreshRSS 实例并完成 SSL、域名等配置
• 认证信息暴露：API 密码以环境变量形式存储，多用户系统存在泄露风险
• 功能边界明确：仅限读取操作，不支持标星、分享、全文抓取等高级功能
• 无内容缓存机制：依赖 FreshRSS 实例在线状态，网络中断时完全不可用

适合人群

自建 RSS 服务的技术用户、隐私敏感型资讯消费者、需要将阅读器与工作流（如终端、脚本）集成的开发者。

常规风险

API 密码泄露可导致订阅数据被爬取；自建服务若暴露公网且未加固，存在被扫描攻击的可能。建议配合 VPN/内网访问，定期轮换 API 密钥。

核心用法

FreshRSS Skill 是一个用于连接自托管 FreshRSS RSS阅读器的客户端工具。用户需先配置三个环境变量（FRESHRSS_URL、FRESHRSS_USER、FRESHRSS_API_PASSWORD），即可通过命令行查询订阅源和文章。

主要功能命令：

• headlines — 获取最新文章标题，支持 --count 数量限制、--hours 时间范围、--category 分类筛选、--unread 仅未读
• categories — 列出所有订阅分类
• feeds — 列出所有订阅源

过滤器可组合使用，如同时指定分类、时间窗口、数量和未读状态。

显著优点

1. 隐私优先设计：数据完全存储在用户自托管的实例上，不经过第三方服务器
2. 零依赖架构：纯 Shell 脚本实现（131行），无第三方库依赖，CVE风险为零
3. 灵活的筛选能力：支持多维度的文章过滤，包括时间窗口、分类、阅读状态
4. 标准化API：采用Google Reader兼容API，生态成熟稳定
5. 配置透明：环境变量方式配置，用户完全掌控连接参数

潜在缺点与局限性

1. 自托管门槛：要求用户已部署FreshRSS实例，对非技术用户有前置成本
2. 无可视化界面：纯命令行输出，阅读体验较原生Web界面简陋
3. 分类名敏感：category参数大小写敏感，需先查询确认准确名称
4. 单向只读：当前仅支持查询，不支持标记已读、收藏、添加订阅等操作
5. 网络依赖：功能完全依赖FreshRSS实例在线状态，无本地缓存机制

适合人群

• 隐私敏感用户：不愿使用商业RSS服务，坚持数据自托管的技术爱好者
• 效率工具用户：偏好命令行工作流，希望快速扫阅标题而非沉浸式阅读
• 开发者/运维人员：已部署FreshRSS作为团队信息聚合工具，需脚本化获取数据
• 信息筛选重度用户：需要按分类、时间窗口精准筛选大量订阅源

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| 配置错误风险 | 用户可能配置错误的HTTP URL或无效凭证 | 文档已强调HTTPS必需，建议增加URL格式校验 |

| 凭证泄露风险 | 环境变量可能在shell历史或进程列表中暴露 | 使用.env文件并加入.gitignore，避免命令行直接export |

| 中间人攻击 | 若使用自签名证书或HTTP连接，存在窃听风险 | 强制HTTPS验证，定期更新证书 |

| 实例不可用 | 自托管服务可能因维护、网络故障中断 | 建议设置合理的超时重试机制 |