核心用法
Miniflux Skill 提供了一个命令行接口（CLI），用于与 Miniflux 自托管 RSS 阅读器交互。用户可通过环境变量或配置文件完成一次性认证后，执行文章列表查询、内容获取、阅读状态管理、订阅源维护等操作。
主要命令体系：
list— 按状态（已读/未读）、订阅源、分类、关键词筛选文章，支持 brief/summary/full/JSON 四种输出格式get— 获取单篇文章全文，支持 offset/limit 分页读取长文mark-read/mark-unread— 批量标记阅读状态feeds/categories— 管理订阅源与分类stats— 查看文章统计（字数、阅读时长）或全局未读计数refresh— 触发订阅源更新search— 关键词搜索别名
配置优先级： CLI 参数 > 环境变量 > ~/.local/share/miniflux/config.json（首次运行自动生成）
显著优点
1. 灵活输出控制：brief（标题速览）、summary（摘要）、full（全文）、JSON（机器处理）四档粒度，适配不同场景
2. 长文友好：内置字数统计与分页读取机制（--offset/--limit），支持 >5000 词文章分段处理
3. 批处理能力：支持多 ID 批量标记、JSON 管道输出，便于自动化脚本集成
4. 自托管优先：对接 Miniflux 私有实例，数据主权可控，无第三方服务依赖
潜在局限
1. 依赖预部署：需自行搭建 Miniflux 服务端并获取 API Key，门槛高于 SaaS RSS 服务
2. 纯 CLI 交互：无内置 TUI/GUI，重度浏览场景需配合终端工具链（如 fzf）
3. uv 运行时依赖：要求本地安装 uv 包管理器，Windows 环境支持待验证
4. 无离线缓存：所有操作实时调用 API，弱网环境体验受限
适合人群
- 已有 Miniflux 实例的技术用户，追求终端原生工作流
- 需将 RSS 阅读与自动化脚本/AI Agent 集成的开发者
- 注重数据隐私、拒绝商业 RSS 平台的信息重度消费者
常规风险
- 凭证管理：API Key 以明文形式存储于本地 JSON 或环境变量，需确保文件权限（建议
~/.local/share/miniflux/目录 700 权限） - API 限流：高频批量操作可能触发 Miniflux 服务端速率限制，建议增加间隔或错峰执行
- 内容安全风险：RSS 源内容未经沙箱过滤，直接渲染 HTML 可能存在 XSS 隐患（取决于 Miniflux 服务端配置）
- 数据一致性：
mark-read等操作不可逆，批量执行前建议先--brief确认目标条目