name: miniflux-news
description: 通过 REST API 使用 API 令牌从 Miniflux 实例获取并筛选最新的未读 RSS/新闻条目。当用户要求获取最新的 Miniflux 未读条目、列出带标题/链接的近期条目或生成特定 Miniflux 条目的简短摘要时使用。包含一个捆绑脚本，用于使用来自 ~/.config/clawdbot/miniflux-news.json（或环境变量 MINIFLUX_URL 和 MINIFLUX_TOKEN）的凭据查询 Miniflux（/v1/entries 和 /v1/entries/{id}）。

Miniflux 新闻

使用捆绑脚本获取条目，然后格式化为简洁列表，并可选择性地撰写摘要。

设置（凭据）

默认情况下，此技能从本地配置文件读取 Miniflux 凭据。

配置文件（推荐）

路径：
- ~/.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>"

环境变量（覆盖）

您可以覆盖配置文件（适用于 CI 环境）：

export MINIFLUX_URL="https://your-miniflux.example"
export MINIFLUX_TOKEN="<api-token>"

令牌权限：需要具有读取权限的 Miniflux API 令牌。

获取最新条目

列出最新未读条目（默认）：

python3 skills/miniflux-news/scripts/miniflux.py entries --limit 20

按类别名称筛选：

python3 skills/miniflux-news/scripts/miniflux.py entries --category "News" --limit 20

如需机器可读的输出：

python3 skills/miniflux-news/scripts/miniflux.py entries --limit 50 --json

响应格式

• 返回紧凑的要点列表：[id] 标题 — 订阅源 + 链接。
• 询问用户希望摘要多少条目（例如，“summarize 3” 或 “summarize ids 123,124”）。

查看完整内容

显示 Miniflux 中存储的完整文章内容（适用于阅读或生成更佳摘要）：

python3 skills/miniflux-news/scripts/miniflux.py entry 123 --full --format text

如需 Miniflux 存储的原始 HTML：

python3 skills/miniflux-news/scripts/miniflux.py entry 123 --full --format html

类别

列出所有类别：

python3 skills/miniflux-news/scripts/miniflux.py categories

标记条目为已读（仅限显式操作）

此技能绝不隐式标记任何条目为已读。仅在用户明确要求标记特定 ID 为已读时执行。

标记特定 ID 为已读：

python3 skills/miniflux-news/scripts/miniflux.py mark-read 123 124 --confirm

标记类别中所有未读条目为已读（仍需显式操作，需 --confirm；包含安全限制 --limit）：

python3 skills/miniflux-news/scripts/miniflux.py mark-read-category "News" --confirm --limit 500

摘要条目

获取特定条目 ID 的完整内容（机器可读格式）：

python3 skills/miniflux-news/scripts/miniflux.py entry 123 --json

摘要规则：
- 优先使用 3–6 个要点，最多不超过此数。
- 首句点明“核心要点”。
- 若内容为空或被截断，需说明情况，并基于标题和可用片段进行摘要。
- 不虚构事实；若存在关键数字/名称，应直接引用。

故障排除

• 若脚本提示缺少凭据：请设置 MINIFLUX_URL/MINIFLUX_TOKEN 或创建 ~/.config/clawdbot/miniflux-news.json。
• 若收到 HTTP 401 错误：令牌错误或已过期。
• 若收到 HTTP 404 错误：基础 URL 错误（应为 Miniflux Web 根目录）。