signalscout-backend/README.md

SignalScout

SignalScout 是一个自动运行的 AI 情报 Agent。它先用动态新闻搜索和 GitHub 官方搜索抓取候选证据，再使用 Grok 通过中转 API 生成最新 AI 新闻、模型发布、Agent 工具、融资动态和 GitHub 热门项目日报，并把结构化情报保存到 MySQL。

主流程

Scheduler
  -> AgentRunner
  -> News Search API 采集近期 AI 新闻候选
  -> GitHub Search API 采集近期热门 AI 项目候选
  -> Grok 研判新闻候选与 GitHub 候选
  -> MySQL signals/reports
  -> Markdown report file

本地配置

复制环境变量：

cp .env.example .env

关键配置：

SIGNALSCOUT_DATABASE_URL=mysql+pymysql://user:password@host:3306/signalscout?charset=utf8mb4
SIGNALSCOUT_LLM_BASE_URL=https://api.zayuapi.com/v1
SIGNALSCOUT_LLM_API_KEY=你的中转站 key
SIGNALSCOUT_LLM_MODEL=grok-4.3
SIGNALSCOUT_NEWS_RECENT_DAYS=3
SIGNALSCOUT_NEWS_MAX_ITEMS=12
SIGNALSCOUT_NEWS_SEARCH_MAX_RECORDS=20
SIGNALSCOUT_GITHUB_RECENT_DAYS=30
SIGNALSCOUT_GITHUB_MIN_STARS=20
SIGNALSCOUT_GITHUB_MAX_PROJECTS=5
SIGNALSCOUT_AGENT_INTERVAL_MINUTES=30

本机运行

按项目规则，本机 Python 使用：

D:\Python\Python39\python.exe

在 WSL shell 中对应命令已经写进 Makefile：

make install
make migrate
make seed
make run

后端启动后访问：

http://127.0.0.1:8010/health
http://127.0.0.1:8010/docs

API

• GET /health：服务健康检查
• GET /agent/runs：查看最近运行记录
• GET /signals：查看结构化情报
• GET /reports/latest：查看最新日报
• GET /dashboard：获取仪表盘数据
• POST /topics：新增 Agent 跟踪主题
• GET /topics：查看 Agent 跟踪主题
• GET /logs/recent：查看最近运行日志

部署

部署文件使用和 agent-desk 一致的 Gitea + Jenkins 流水线结构：

• Gitea 仓库：https://gitea.jaycode.online/gitadmin/signalscout-backend
• Jenkins Job：signalscout-backend
• 源码目录：/opt/signalscout-source
• 发布目录：/opt/signalscout
• 部署脚本：deployment/jenkins/deploy_backend.sh
• systemd 服务：deployment/systemd/signalscout.service
• Jenkins 流水线：Jenkinsfile

默认域名：

https://signalscout.jaycode.online/
https://gitea.jaycode.online/
https://jenkins.jaycode.online/