by 运行时依赖
安装命令
点击复制技能文档
GARSS Studio RSS API 项目仓库：https://github.com/zhaoolee/garss。当用户要求 AI 代理从该项目获取 RSS 新闻、总结订阅的 RSS 文章、检查 GARSS Studio 订阅、刷新 feed 或与该项目的后端 API 交互时，使用此技能。
核心规则 仅使用单一公共入口：http://127.0.0.1:25173（除非用户提供其他基 URL），在本地开发环境中。不要直接访问后端容器端口或 RSSHub 容器。如果本地服务未运行且用户需要实时数据，在调用 API 之前先从仓库启动 GARSS Studio。调用受保护端点之前进行身份验证。除非用户明确要求刷新，否则优先使用缓存读取。在用户面前的总结中保留源名称和原始文章链接。
本地启动 当用户要求获取实时 GARSS 数据且 http://127.0.0.1:25173/api/health不可达时，使用以下步骤。
- 进入项目：cd path/to/garss/garss-studio
- 如果仓库不存在，先克隆 https://github.com/zhaoolee/garss，然后进入 garss-studio。
- 确保 env 文件存在：cp .env.example .env（如果 .env 已存在，则跳过此步骤）。
- 启动本地开发栈：docker compose -f docker-compose.dev.yml up --build -d
- 验证服务健康：curl -sS http://127.0.0.1:25173/api/health
身份验证流程 登录：curl -sS -X POST "$BASE_URL/api/auth/login" -H 'Content-Type: application/json' -d '{"accessCode":"banana"}' 从 JSON 响应中读取令牌。使用以下方式调用受保护端点：Authorization: Bearer 如果用户提供包含 ?pw=... 的 URL，则使用该值作为 accessCode。
阅读 RSS 新闻 对于用户的订阅 RSS 新闻，调用：curl -sS "$BASE_URL/api/reader/items" -H "Authorization: Bearer $TOKEN" 这将返回启用订阅的聚合文章，通常按最新排序。仅当用户要求强制刷新时使用 ?refresh=true，因为这将获取实际的上游 RSS 源并更新缓存。 对于单个源：
- 调用 GET /api/subscriptions 以找到订阅 ID。
- 调用 GET /api/reader/subscriptions/{id}。仅在强制刷新时添加 ?refresh=true。
响应处理 阅读器项通常包括 title、link、publishedAt、subscriptionId、subscriptionName、author/content 字段和可选的 HTML 字段。当总结时：
- 根据需要按 publishedAt 降序排序。
- 在有用时按 subscriptionName 分组。
- 包括原始链接。
- 如果存在错误数组，则提及获取错误。
- 不要在最终答案中暴露 Bearer 令牌。
API 参考 有关端点详细信息，请在需要时阅读 references/api.md。正在运行的后端还暴露： Swagger UI：/api/docs OpenAPI JSON：/api/openapi.json