订阅摘要(免费版)

获取、扫描、筛选、阅读。四步完成订阅内容摘要。

无需复杂配置，通过 feed CLI 即可获取订阅源最新内容，智能筛选高价值条目，生成精炼摘要。免费版聚焦轻量场景，帮助用户应对信息过载.

概述

免费版订阅摘要工具为个人用户提供基础的RSS订阅内容管理能力。通过 feed 命令行工具，获取最新条目、扫描未读、筛选高价值内容、生成摘要，让阅读更高效.

核心定位

核心能力

1. 获取最新内容

输入格式

import subprocess
import json
# ...
class FeedFetcher:
    """订阅内容获取器（免费版）"""
# ...
    def __init__(self, cli_path="feed"):
        self.cli = cli_path
# ...
    def fetch(self):
        """获取所有订阅源的最新内容"""
        result = subprocess.run(
            [self.cli, "fetch"],
            capture_output=True, text=True, timeout=60, encoding="utf-8"
        )
        if result.returncode == 0:
            return {"success": True, "output": result.stdout}
        return {"success": False, "error": result.stderr}
# ...
    def get_entries(self, limit=50, feed_id=None):
        """获取未读条目"""
        cmd = [self.cli, "get", "entries", "--limit", str(limit)]
        if feed_id:
            cmd.extend(["--feed", feed_id])
# ...
            cmd, capture_output=True, text=True, timeout=30, encoding="utf-8"
        )
        if result.returncode == 0:
            return result.stdout
        return f"获取失败：{result.stderr}"
# ...
    def get_entry(self, entry_id):
        """获取单条目全文（Markdown格式）"""
            [self.cli, "get", "entry", str(entry_id)],
            capture_output=True, text=True, timeout=30, encoding="utf-8"
        )
        if result.returncode == 0:
# ...
    def get_feeds(self):
        """获取所有订阅源列表"""
            [self.cli, "get", "feeds"],
            capture_output=True, text=True, timeout=10, encoding="utf-8"
        )
stdout if result.returncode == 0 else f"获取失败：{result.stderr}"
# ...
    def get_stats(self):
        """获取数据库统计"""
            [self.cli, "get", "stats"],
            capture_output=True, text=True, timeout=10, encoding="utf-8"
        )
stdout if result.stderr}"
# ...
fetcher = FeedFetcher()
# ...
print("=== 获取最新内容 ===")
fetcher.fetch()
# ...
print("\n=== 订阅源列表 ===")
print(fetcher.get_feeds())
# ...
print("\n=== 未读条目 ===")
print(fetcher.get_entries(limit=50))

处理: 解析获取最新内容的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回获取最新内容的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

2. 智能筛选

详细代码示例已移至 references/detail.md

处理: 解析智能筛选的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回智能筛选的响应数据,包含状态码、结果和日志.

3. 摘要生成

处理: 解析摘要生成的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回摘要生成的响应数据,包含状态码、结果和日志.

4. 标记已读

class ReadStatusManager:
    """已读状态管理（免费版）"""
# ...
    def __init__(self, cli_path="feed"):
        self.cli = cli_path
# ...
    def mark_read(self, entry_ids):
        """标记条目为已读"""
        if not entry_ids:
            return False
# ...
        cmd = [self.cli, "update", "entries", "--read"] + [str(id) for id in entry_ids]
            cmd, capture_output=True, text=True, timeout=30, encoding="utf-8"
        )
        if result.returncode == 0:
            print(f"已标记 {len(entry_ids)} 条为已读")
            return True
        print(f"标记失败：{result.stderr}")
        return False
# ...
    def search(self, query):
        """全文搜索"""
            [self.cli, "search", query],
            capture_output=True, text=True, timeout=30, encoding="utf-8"
        )
stdout if result.returncode == 0 else f"搜索失败：{result.stderr}"
# ...
manager = ReadStatusManager()
# ...
entry_ids = [entry['id'] for entry in filtered]
manager.mark_read(entry_ids)

处理: 解析标记已读的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回标记已读的响应数据,包含状态码、结果和日志. 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：订阅摘要免费版、RSS、订阅获取、未读扫描、基础分类与摘要生、订阅摘要助手免费、版是面向个人用户、的轻量、订阅摘要工具、四步流程、从订阅源中筛选高、价值内容生成摘要、Use、when、模型调用、智能对话、Agent、LLM、应用时使用、不适用于需要、确定性的关键决策、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

使用场景

场景一：每日订阅速览

场景描述：每天早上获取订阅源最新内容，快速浏览高价值条目.

fetcher = FeedFetcher()
filterer = FeedFilter(limit=10)
generator = DigestGenerator()
manager = ReadStatusManager()
# ...
print("正在获取最新内容...")
fetcher.fetch()
# ...
entries_text = fetcher.get_entries(limit=50)
# ...
filtered = filterer.filter_entries(entries_text)
# ...
digest = generator.generate(filtered, fetcher)
print(digest)
# ...
entry_ids = [e['id'] for e in filtered]
manager.mark_read(entry_ids)

场景二：个人阅读管理

场景描述：管理个人订阅，控制信息过载.

fetcher = FeedFetcher()
# ...
print("=== 订阅统计 ===")
print(fetcher.get_stats())
# ...
print("\n=== 订阅源 ===")
print(fetcher.get_feeds())
# ...
print("\n=== 某订阅源未读 ===")
print(fetcher.get_entries(limit=20, feed_id="feed_id_xxx"))

场景三：高价值内容筛选

场景描述：从大量未读中筛选最值得阅读的内容.

fetcher = FeedFetcher()
filterer = FeedFilter(limit=5)
# ...
get_entries(limit=100)
# ...
filtered = filterer.filter_entries(entries_text)
# ...
print(f"=== 今日必读 Top {len(filtered)} ===")
for i, entry in enumerate(filtered, 1):
    print(f"\n{i}. {entry['title']}")
    print(f"   来源：{entry.get('feed', '')}")
    print(f"   得分：{entry.get('score', 0)}")
# ...
    full = fetcher.get_entry(entry['id'])
    print(f"   全文长度：{len(full)} 字符")

快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

30秒上手

brew install odysseus0/tap/feed
# ...
feed fetch
# ...
feed get entries --limit 50
# ...
feed get entry 

120秒标准搭建

brew install odysseus0/tap/feed
feed add https://example.com/feed.xml
feed add https://another.com/rss
# ...
feed fetch
# ...
feed get stats
# ...
feed get entries --limit 50
# ...
feed update entries --read   

响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.

配置示例

基础配置

import os
# ...
class FeedConfig:
    """订阅摘要配置（免费版）"""
    CLI_PATH = os.getenv("FEED_CLI", "feed")
    DEFAULT_LIMIT = int(os.getenv("FEED_LIMIT", "50"))
    FILTER_LIMIT = int(os.getenv("FEED_FILTER_LIMIT", "10"))
    SUMMARY_MAX_LENGTH = int(os.getenv("FEED_SUMMARY_LEN", "200"))
# ...
    HIGH_VALUE_KEYWORDS = [
        'AI', '人工智能', '大模型', 'LLM', 'GPT',
        '系统设计', '架构', '性能优化', '分布式',
        '开发工具', 'DevOps', '反直觉', '颠覆', '突破'
    ]
# ...
    SKIP_KEYWORDS = ['广告', '推广', '赞助', 'sponsored']
# ...
    @classmethod
    def show(cls):
        print("=== 订阅摘要配置 ===")
        print(f"CLI路径：{cls.CLI_PATH}")
        print(f"默认限制：{cls.DEFAULT_LIMIT}")
        print(f"筛选限制：{cls.FILTER_LIMIT}")
        print(f"摘要长度：{cls.SUMMARY_MAX_LENGTH}")
# ...
FeedConfig.show()

常用命令速查

feed fetch                              # 拉取所有订阅源最新内容
feed get entries --limit N              # 列出未读条目（表格）
feed get entries --feed  --limit N  # 按订阅源筛选
feed get entry                      # 阅读全文（Markdown）
feed search ""                   # 全文搜索
feed update entries --read   ...  # 批量标记
feed get feeds                          # 列出订阅源（含未读数）
feed get stats                          # 数据库统计

最佳实践

1. 输出格式优化

result = subprocess.run(
    ["feed", "get", "entries", "--limit", "50"],
    capture_output=True, text=True
)

2. 按订阅源筛选

def filter_by_feed(feed_id, limit=20):
    return fetcher.get_entries(limit=limit, feed_id=feed_id)
# ...
feeds = fetcher.get_feeds()

3. 阅读全文

def read_full(entry_id):
    content = fetcher.get_entry(entry_id)
    return content  # Markdown格式
manager.mark_read([entry_id])

常见问题

Q1：免费版需要安装什么？

免费版需要安装 feed CLI工具。安装方式：macOS可使用 brew install odysseus0/tap/feed，其他平台可从源码编译（需Rust环境）.

Q2：订阅源如何添加？

通过 feed add 命令添加RSS/Atom订阅源。支持标准RSS 2.0和Atom 1.0格式。添加后使用 feed fetch 获取最新内容.

Q3：筛选不准确怎么办？

免费版使用基于关键词的简单筛选。如遇筛选不准的情况：(1) 调整 HIGH_VALUE_KEYWORDS 列表；(2) 添加更多领域关键词；(3) 升级专业版使用AI深度筛选（基于LLM的内容理解）.

Q4：未读条目太多怎么办？

建议：(1) 按订阅源筛选 feed get entries --feed ；(2) 减少限制数量 --limit 20；(3) 使用筛选器只看高价值内容；(4) 定期标记已读避免堆积.

Q5：支持Markdown格式输出吗？

支持。feed get entry 返回Markdown格式的全文内容，便于阅读和处理。列表输出默认为表格格式，最节省token.

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux
• Rust: 1.70+（仅编译feed CLI需要）

第三方依赖

API Key 配置

• 免费版无需任何API Key
• 订阅内容基于公开RSS源，不涉及付费API调用
• LLM模型路由由Agent平台内置提供

可用性分类

• 分类: MD+EXEC（Markdown指令+命令行执行）
• 说明: 通过自然语言指令驱动Agent执行订阅内容获取与摘要生成任务

已知限制

本免费体验版限制以下高级功能（需升级至专业版解锁）：

• AI深度摘要（基于LLM的内容理解与摘要生成）
• 多源聚合（跨订阅源主题聚合）
• 定时推送（每日自动推送摘要）
• 团队共享（团队订阅与共享摘要）
• 个性化推荐（基于阅读历史的智能推荐）
• 全文搜索增强（语义搜索）
• 阅读统计与分析（阅读习惯分析）
• 优先技术支持

解锁全部高级能力请使用专业版：feed-digest-tool-pro

错误处理

示例

基本用法

输出：返回执行结果,包含操作状态和输出数据

用户: 执行核心功能
Skill: 正在执行核心功能...
Skill: 执行完成,结果如下: 操作成功

输出格式

{
  "success": true,
  "data": {
    "result": "订阅摘要(免费版)处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "feed digest"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}