agent-park/docs/integrations/n8n/workflows/04-github-star-refresh.md

GitHub Star 每日刷新

• Registry ID: github-star-refresh
• n8n Workflow ID: ewx9Gs6cjrTXvwD0
• Status: confirmed
• 角色: 每日刷新项目的 GitHub Star 数，保证排序、排行和展示的时效性。

触发方式

• 定时触发
• 当前已核查行为：每日约 04:00 运行

数据来源

• projects
• external_links
• GitHub Repository API

主流程

1. 从数据库读取活跃项目及其 GitHub 外链。
2. 解析 GitHub 仓库 owner/repo。
3. 调用 GitHub Repository API 获取最新 star 数。
4. 直接写回 projects.githubStars 与 projects.githubStarsUpdatedAt。

直接写入字段

• projects.githubStars
• projects.githubStarsUpdatedAt

与仓库的关系

这条流程不是调用仓库 API，而是直接维护数据库中的展示字段。当前仓库内受其影响的消费面包括：

• schema.prisma
• route.ts
• useProjects.ts

下游影响

• 首页排行
• 项目列表按 star 排序
• AI 搜索结果中的 stars_desc / stars_asc

已确认要点

• 已通过 live n8n MCP 核查 workflow 元数据与职责。
• 该流程直接读写 Postgres，而不是走 Next.js API。
• 所以如果星标不更新，优先排查 n8n 与数据库连接，而不是先看前端排序代码。

维护要求

• 如果 external_links 的 GitHub 链接筛选规则改变，要同步更新这里和 registry.json。
• 如果后续改成走仓库 API 写入，应把“直接 DB 写”改成“仓库 API 触点”。