Miniflux News

# Miniflux News

使用附带的脚本获取条目，然后整理成清晰的列表，并可选择写入摘要。

## 设置（凭据）

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

### 配置文件（推荐）

路径： - `~/.config/clawdbot/miniflux-news.json`

格式： ```json { "url": "https://your-miniflux.example", "token": "<api-token>" } ```

使用该脚本创建/更新配置：

```bash python3 skills/miniflux-news/scripts/miniflux.py configure \ --url "https://your-miniflux.example" \ --token "<api-token>" ```

### 环境变量（覆盖）

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

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

Token 范围：具有读取权限的 Miniflux API token。

## 获取最新条目

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

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

按分类（名称）筛选：

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

如果你需要机器可读的输出：

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

### 响应格式

- 返回紧凑的项目符号列表：**[id] 标题 — 订阅源** + 链接。 - 询问用户想要总结多少条（例如，“summarize 3” 或 “summarize ids 123,124”）。

## 查看完整内容

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

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

如果你想要 Miniflux 存储的原始 HTML：

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

## 分类

列出分类：

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

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

此技能**绝不能**隐式地将任何内容标记为已读。仅当用户明确要求将特定 id 标记为已读时才执行。

将特定 id 标记为已读：

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

将某个分类下的所有未读条目标记为已读（仍然是显式操作，需要 `--confirm`；包含安全限制 `--limit`）：

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

## 总结条目

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

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

总结规则： - 最多使用 3-6 个要点。 - 用一句话说明“其意义何在”。 - 如果内容为空或被截断，请说明这一点，并根据标题 + 可用片段进行总结。 - 不要虚构事实；如果存在关键数字/名称，请引用它们。

## 故障排除

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