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] 标题 — 来源+ 链接。
• 询问用户想要总结多少条（例如，“总结3条”或“总结id为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 根目录）。