用途:从 Miniflux 实例拉取最新未读 RSS/新闻条目,整理成简洁列表,并按需生成摘要。
主要能力:列出最新未读条目(默认)、按分类名称筛选、输出 JSON、查看单条全文(text 或 html)、列出分类、在用户明确要求时标记指定 id 或某分类条目为已读、对条目做摘要。
配置:默认读取本地配置文件 ~/.config/clawdbot/miniflux-news.json,格式为 {"url": "https://your-miniflux.example", "token": "<api-token>"}。可用脚本写入:python3 skills/miniflux-news/scripts/miniflux.py configure --url "https://your-miniflux.example" --token "<api-token>"。也可用环境变量覆盖:export MINIFLUX_URL="https://your-miniflux.example" 与 export MINIFLUX_TOKEN="<api-token>"。token 需具备读权限。
常用命令:列出未读 python3 skills/miniflux-news/scripts/miniflux.py entries --limit 20;按分类 python3 skills/miniflux-news/scripts/miniflux.py entries --category "News" --limit 20;JSON 输出加 --json;查看全文 python3 skills/miniflux-news/scripts/miniflux.py entry 123 --full --format text;列出分类 python3 skills/miniflux-news/scripts/miniflux.py categories;标记已读 python3 skills/miniflux-news/scripts/miniflux.py mark-read 123 124 --confirm,或 mark-read-category "News" --confirm --limit 500。
摘要规则:最多 3–6 条要点,先用一句话说明“所以呢”;内容为空或截断时说明并基于标题与摘要;不编造事实,保留关键数字与名称。
限制:绝不隐式标记已读,仅当用户明确要求时执行;401 表示 token 错误或过期,404 表示基础 URL 错误(应为 Miniflux 网页根地址);缺少凭据时需设置环境变量或创建配置文件。