核心用法
Miniflux Skill 是一个用于管理现代极简RSS阅读器 Miniflux 的命令行工具集。通过调用 Miniflux REST API，用户可以在终端完成完整的RSS订阅生命周期管理，包括：
- 订阅管理：创建/删除/更新Feed订阅，自动发现网站RSS源
- 内容浏览：按状态（已读/未读）、分类、Feed筛选文章，支持关键词搜索
- 阅读标记：单篇或批量标记文章已读/未读，整站一键标已读
- 分类组织：创建自定义分类，按主题整理订阅源
- 数据刷新：手动刷新全部或指定Feed，获取最新内容
典型工作流
# 发现并订阅新源 bash miniflux.sh discover --url "https://example.com" bash miniflux.sh create-feed --url "https://example.com/feed.xml" --category 1 # 每日阅读 bash miniflux.sh entries --status unread --limit 20 bash miniflux.sh mark-read --entry-ids 123,456 # 批量整理 bash miniflux.sh refresh-all bash miniflux.sh mark-feed-read --feed-id 42
显著优点
1. 终端原生体验：无需打开浏览器，在熟悉的Shell环境高效处理RSS
2. API完整覆盖：支持Miniflux全部核心端点，功能与Web端等价
3. 灵活筛选：10+种entries过滤参数，支持时间范围、搜索、 starred 等维度
4. 批量操作：支持多ID批量标记、整站刷新，适合自动化脚本集成
5. 自托管友好：适配私有部署场景，通过环境变量灵活配置多实例
潜在局限
- 依赖外部服务：必须拥有Miniflux实例（自托管或托管服务），无法独立运行
- 无本地缓存：每次操作实时API调用，离线场景不可用
- 无阅读渲染：仅返回元数据，需配合其他工具查看原文（API返回原始HTML/内容）
- Python依赖：需Python 3.8+及miniflux库，非纯Shell实现
- 令牌安全：API Token以环境变量存储，共享环境存在泄露风险
适合人群
- 已有Miniflux部署的RSS重度用户
- 偏好终端工作流的开发者/运维人员
- 需要自动化RSS处理（如定时清理、自动分类）的脚本编写者
- 多设备同步场景下需要快速CLI操作的效率用户
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 凭证泄露 | MINIFLUX_TOKEN明文存储于环境变量 | 使用专用Secret管理工具，避免提交到代码仓库 |
| 误操作数据丢失 | `delete-feed`、`delete-category`不可逆 | 执行删除前先用`counters`、`feeds`确认 |
| API限流 | 高频刷新可能触发实例限流 | 合理设置定时任务间隔，避免滥用`refresh-all` |
| 网络依赖 | API调用失败时操作中断 | 脚本已加入错误码1退出，可配合重试逻辑 |
| 实例安全 | HTTP实例存在中间人风险 | 优先使用HTTPS，验证证书配置 |
扩展建议
可与fzf结合实现交互式选择，或与cron搭配定时同步阅读状态，构建个人RSS自动化工作流。