# 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](D:/Code/AI/agent-park/src/app/api/projects/route.ts)
- [route.ts](D:/Code/AI/agent-park/src/app/api/projects/[slug]/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](D:/Code/AI/agent-park/docs/integrations/n8n/registry.json)。
- 若未来 discovery 服务代码并入当前仓库，应把这里的外部边界改成具体路由映射。