网站订阅源（Site Feeds）

本技能帮助 AI 智能体通过 airsstool CLI 工具从网站获取更新与内容。

适用场景

当用户出现以下情况时，可使用本技能：

• 希望查看某网站或平台（如 YouTube、GitHub、Instagram、Reddit 等）的最新内容
• 提出类似“……上有什么新内容？”或“展示……的更新”等请求
• 希望追踪热门内容、新闻、博客文章、视频等
• 需要在特定平台上监控指定用户、主题或分类
• 希望设置周期性检查以获取内容更新
• 询问某个具体网站支持获取哪些内容/信息

安装说明

使用 airsstool 前，请确保满足以下前提条件。必要时（例如通过 Docker 部署 RSSHub、选择 Python 运行环境、设置环境变量），需向用户征得许可。

1. 部署 RSSHub（如尚未运行）

请先确认用户本地是否已运行 RSSHub Docker 容器。若未运行：

1. 告知用户需在本地部署 RSSHub
2. 获得用户确认后，在合适位置创建 rsshub 文件夹
3. 参照 RSSHub 官方部署文档中的“Docker Compose 部署”指南，将 docker-compose.yml 文件下载至 rsshub 文件夹中
4. 创建 .env 文件用于配置环境变量
5. 如需 Puppeteer 支持，请修改 docker-compose.yml，并在 rsshub 服务中添加 env_file: - .env
6. 执行 docker compose up -d

2. 安装 airsstool

请参考 https://github.com/heqi201255/airsstool 中的安装说明

询问用户是否希望在特定虚拟环境中安装 Python 依赖。若确认，则每次使用前需确保该环境已激活。

3. 初始化数据库

安装完成后，运行初始化命令（耗时约 1 分钟）：

airsstool init

默认会在 ~/.airsstool/airsstoolDB.db 创建数据库。如需自定义路径，请使用 --db-path 参数。

完成安装并验证功能正常后，可从此文件中删除本安装说明章节。

可用 CLI 命令

初始化命令

发现类命令

获取类命令

订阅管理类命令

常见工作流

查找订阅源

1. 按分类浏览（若已知内容类型）：

   airsstool list categories
   airsstool list websites --category programming --page-size 10
   

2. 按网站名称搜索（支持模糊匹配）：

   airsstool list routes github  # 返回所有 GitHub 订阅源
   

3. 查看订阅源详情（了解所需参数）：

   airsstool check github trending
   # 显示路径模板：/github/trending/{params}
   

获取内容

基础获取：

airsstool fetch /github/trending/daily/any/en

带过滤器获取：

airsstool fetch /youtube/user/@MrBeast --filter "MrBeast|Beast"

格式转换输出：

airsstool fetch /hackernews/best --format rss    # 返回原始 RSS 格式
airsstool fetch /instagram/user/instagram --brief 100     # 返回精简文本

分页获取：

airsstool fetch /github/trending/daily/any/en --limit 5 --offset 2

管理订阅

创建订阅组：

airsstool add-subscription -U your_name -S tech_news

向订阅组添加内容源：

airsstool subscribe -U your_name -S tech_news -P /github/trending/daily/any/en -D "GitHub Trending"

获取整个订阅组内容：

airsstool fetch -U your_name -S tech_news --limit 10

获取命令参数说明

列表类选项

过滤类选项

输出类选项

高效使用提示

1. 支持模糊搜索：例如 airsstool list routes gthub 将提示“GitHub”

2. 路径格式规范：路径必须以 / 开头，例如 /github/trending/daily/any/en

3. 优先查看路由详情：使用 airsstool check 掌握所需参数

4. 默认输出为 Markdown：内容已解析并格式化，便于阅读；如需原始 RSS，请使用 --format rss

5. 订阅持久化：所有订阅信息均保存于 SQLite 数据库中，具备持久性

交互示例

用户：“帮我找一些编程类新闻订阅源”

airsstool list websites --category programming --page-size 5
# 返回热度最高的编程类网站

airsstool list routes github
# 返回 GitHub 支持的所有路由

airsstool check github trending
# 展示路径构造方式

用户：“获取最新的 JavaScript 趋势仓库”

airsstool fetch /github/trending/daily/any/en --limit 10
# 返回格式化后的 Markdown，含仓库详细信息

用户：“为我创建一个每日科技阅读订阅”

airsstool add-subscription -U user -S daily_tech

airsstool subscribe -U user -S daily_tech -P /github/trending/daily/any/en -D "GitHub Trending JS"
airsstool subscribe -U user -S daily_tech -P /hackernews/best -D "Hacker News"

airsstool fetch -U user -S daily_tech --limit 5

用户：“从我的订阅中移除某个特定内容源”

airsstool list paths -U user -S daily_tech
# 展示该订阅组内所有内容源

airsstool remove-subscription -U user -S daily_tech -P /hackernews/best
# 仅移除 Hacker News，其余内容源保留

用户：“删除我的整个订阅组”

⚠️ 此操作不可撤销，请在执行前向用户确认：

airsstool unsubscribe -U user -S daily_tech
# 删除该订阅组及其全部内容源

错误处理

• 若网站未找到，模糊搜索将提供备选建议
• 若路由未找到，请首先核对网站名称拼写
• 若部分网站无法成功获取内容，请运行 airsstool check 查看是否存在 RequireConfig 提示。若存在，表明该网站需配置环境变量。请在线搜索对应环境变量的获取方式，并向用户寻求协助。获取后将其添加至 .env 文件，并重启 RSSHub 服务
• 若仍无法获取，可能是路径无效，或当前 RSSHub 实例已宕机
• 可在 airsstool subscribe 命令中使用 --force 参数跳过连通性检查