# 前沿信号聚合（多源+AI Agent过滤）

- Registry ID: `signals-aggregation`
- n8n Workflow ID: `bAxNZKGq2ApUUiw9`
- Status: `confirmed`
- 角色: 聚合多源讨论与发布内容，筛出 AI Agent 相关信号，结构化后写入 AgentPark 的 `signals` 数据流。

## 触发方式

- 定时触发
- 当前已核查行为：多源周期抓取

## 数据来源

- Hacker News
- GitHub
- arXiv
- Reddit
- Product Hunt
- Hugging Face

## 主流程

1. 从 6 类外部源抓取候选讨论或发布内容。
2. 做基础规则过滤与去重。
3. 使用 LLM 判断是否属于 AI Agent 相关前沿信号。
4. 生成中英双语标题、摘要、主题、标签、sections 和热度字段。
5. 调用仓库 webhook 写入 `signals`。
6. 从保留结果中抽取 GitHub 仓库链接，回流 discovery 系统继续发现项目。

## 输入契约

- `apiKey`
- `signals[].source`
- `signals[].sourceUrl`
- `signals[].title`
- `signals[].titleEn`
- `signals[].summary`
- `signals[].summaryEn`
- `signals[].topic`
- `signals[].topicEn`
- `signals[].tags`
- `signals[].sections`
- `signals[].engagement`
- `signals[].hotScore`
- `signals[].isHot`
- `signals[].publishedAt`
- `signals[].isActive`

## 输出契约

- `success`
- `processed`
- `created`
- `updated`
- `failed`
- `errors[].index`
- `errors[].field`
- `errors[].message`

## 与仓库的关系

仓库内直接接点：

- [auth.ts](D:/Code/AI/agent-park/src/lib/auth.ts)
- [route.ts](D:/Code/AI/agent-park/src/app/api/webhook/signals/route.ts)
- [route.ts](D:/Code/AI/agent-park/src/app/api/signals/route.ts)
- [validations.ts](D:/Code/AI/agent-park/src/lib/validations.ts)
- [schema.prisma](D:/Code/AI/agent-park/prisma/schema.prisma)

## 下游影响

- Signals 页面内容
- 热门信号排序与过滤
- 从信号反向发现 GitHub 项目的回流链路

## 已确认要点

- 已通过 live n8n MCP 核查 workflow 元数据与 webhook 写入方向。
- 该流程会向 `/api/webhook/signals` 写入结构化 signals。
- 它还会触发外部 discovery 去重与任务创建，因此不只是“信号展示流”，也是项目发现的旁路入口。
- workflow 当前在 HTTP body 中携带共享密钥，仓库侧应视为待治理项，后续改为 n8n credential 或环境变量注入。

## 维护要求

- 字段结构、验证 schema、热度算法变更时，同步更新：
  - [registry.json](D:/Code/AI/agent-park/docs/integrations/n8n/registry.json)
  - [validations.ts](D:/Code/AI/agent-park/src/lib/validations.ts)
  - [route.ts](D:/Code/AI/agent-park/src/app/api/webhook/signals/route.ts)