Miniflux News

核心用法

Miniflux News 是一个面向 RSS 聚合服务 Miniflux 的轻量级工具，允许用户通过命令行脚本查询未读条目、获取完整文章内容、按分类筛选，并支持批量标记已读。核心工作流为：配置 API 凭证 → 拉取条目列表 → 按需摘要或阅读全文 → 显式标记已读。

显著优点

• 专注未读管理：默认只展示未读条目，减少信息噪声
• 灵活的输出格式：支持人类可读的列表、JSON 机器格式，以及 HTML 原文输出
• 分类级操作：可按 RSS 分类（如 "News" "Tech"）批量筛选和标记
• 安全的设计：标记已读操作需显式 --confirm 参数，防止误操作
• 凭证管理友好：支持配置文件持久化与环境变量覆盖，兼顾日常与 CI 场景

潜在缺点与局限性

• 依赖自建服务：必须拥有 Miniflux 实例（自建或托管），无公共数据源
• 功能边界清晰：仅支持读取与标记已读，无添加订阅源、修改分类等管理功能
• 摘要质量受限：若 Miniflux 抓取内容不完整，摘要仅能基于标题和片段生成
• 无自动同步机制：需手动触发脚本更新，非实时推送

适合人群

• 使用 Miniflux 作为 RSS 阅读器的进阶用户
• 希望在工作流中集成 RSS 摘要的开发者/自动化爱好者
• 需要批量处理未读条目、生成日报/周报的场景

常规风险

• 凭证泄露风险：API token 存储于本地明文 JSON 文件，需确保 ~/.config/clawdbot/ 目录权限正确（建议 700）
• 误标记已读：虽需 --confirm，但批量操作（mark-read-category）仍可能因分类名错误导致大范围标记
• API 限流：高频调用可能触发 Miniflux 实例的速率限制，建议合理设置 --limit
• 内容完整性依赖上游：摘要质量取决于 Miniflux 抓取成功率，部分网站全文抓取可能失败

核心用法

miniflux-news 是一款面向 Miniflux 自托管 RSS 阅读器的 CLI 工具，通过 REST API 获取、筛选和摘要未读条目。支持按分类过滤、JSON/文本输出、批量标记已读（需显式确认）。

典型工作流

1. 配置凭证：写入 ~/.config/clawdbot/miniflux-news.json（权限 0o600）或通过环境变量覆盖
2. 拉取条目：entries --limit 20 --category "News"
3. 获取全文：entry 123 --full --format text
4. 标记已读：mark-read 123 124 --confirm（必须显式确认）

显著优点

• 零依赖安全：纯 Python 标准库实现，无供应链攻击风险
• 权限最小化：敏感操作强制 --confirm，配置文件强制用户独占权限
• 隐私优先：数据仅在本地与自有 Miniflux 实例间传输，无第三方介入
• 灵活配置：支持 XDG 规范、环境变量覆盖，适配 CI/本地多场景

潜在局限

• 无内置 HTTPS 强制验证（依赖用户配置正确 URL）
• 无 Token 格式预校验，配置错误时延迟暴露
• 无请求重试机制，弱网环境可能失败

适合人群

• 自托管 Miniflux 用户，追求隐私可控的 RSS 工作流
• 开发者/运维人员需在自动化脚本中安全集成 RSS 数据
• 对第三方 SaaS RSS 服务存疑、偏好本地优先方案的用户

常规风险

• 凭证泄露风险：需确保配置文件权限正确（工具自动设置 0o600）
• 误操作风险：批量标记已读需显式确认，但仍建议配合 --limit 使用
• 实例安全风险：Miniflux 服务端 HTTPS 配置不当可能导致 Token 暴露

安全认证亮点

S+ 评级（98/100），T2 可信来源。核心优势：静态分析 95 分（无注入风险）、依赖审计满分（零第三方库）、隐私合规 97 分（数据不出用户环境）。