agent-park/docs/integrations/n8n/workflows/01-topic-discovery.md

Topic项目计划新增

• Registry ID: topic-discovery
• n8n Workflow ID: iw9vx9ih5Lt0Mobk
• Status: external-upstream
• 角色: 从 GitHub Search API 按 topic 和关键词发现候选仓库，经过去重与 AI 筛选后，写入 discovery 任务队列。

触发方式

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

外部输入

• GitHub Search API
• 预设 topic / keyword watchlist
• AI 保留或丢弃判断

主流程

1. 组合 topic 与关键词查询 GitHub 仓库。
2. 提取候选仓库 URL、基础描述和来源信息。
3. 调用 discovery 去重接口判断是否应该继续创建任务。
4. 使用 LLM 对候选项目做保留或丢弃判断。
5. 把保留结果写入 discovery 任务队列。
6. 当召回偏低时发出低召回告警。

输出结果

• tasks[].sourceUrl
• tasks[].sourceType
• dedupe shouldCreate
• task creation result
• low recall alert

与仓库的关系

这条流程不直接写当前仓库的 projects 表。它的作用是“发现项目并造任务”，后续由 项目分析入库（多源） 消费任务并完成入库。

当前仓库内最终会消费它产出的结果：

• route.ts
• route.ts

系统边界

当前仓库没有实现以下接口，这部分应视为外部上游系统：

• POST /api/discovery/check-duplicates
• POST /api/discovery/tasks

因此，这条流程在仓库侧属于 external-upstream，不是应用内路由。

已确认要点

• 已通过 live n8n MCP 核查 workflow 元数据与职责。
• 该流程围绕 agent / infra / observability / evaluation / MCP 等方向搜索仓库。
• 任务入队后，真实入库并不在当前流程内完成。

维护要求

• GitHub 搜索 query、topic watchlist、保留规则变更时，同步更新 registry.json。
• 若未来 discovery 服务代码并入当前仓库，应把这里的外部边界改成具体路由映射。