RelayWatch 是一个面向 AI API 中转站生态的聚合监控平台，用来把分散的中转站信息整理成可搜索、可比较、可追踪的目录。它支持全网站点发现、NewAPI/Sub2API 站点采集、模型价格对比、公告流、官方 API 状态、AI 热点资讯、在线对话和接口可用性检测。
在线演示：http://relaywatch.online/
English keywords: AI relay dashboard, NewAPI, Sub2API, model price comparison, API status monitor, announcement feed, AI news aggregator.
项目亮点
| 能力 |
说明 |
| 全网站点聚合 |
整理公开可访问的 AI 中转站入口，记录状态、模型数量、最低倍率、供应商、分组和公告。 |
| NewAPI / Sub2API 生态适配 |
面向常见中转站接口结构做采集、归一化、去重、探活和比价展示。 |
| 模型比价 |
按模型维度对比不同站点的输入、输出、缓存价格、成功率、延迟和 TPS。 |
| 公告监测 |
聚合维护通知、价格调整、活动优惠、风险提醒，并保留时间线。 |
| 官方 API 状态 |
汇总 OpenAI、Claude、Gemini、DeepSeek 等官方状态页，辅助判断上游波动。 |
| 模型检测 |
使用自己的 API Key 对指定站点和模型做协议检测、质量检测和实时调用验证。 |
| AI 资讯 |
聚合 AI 资讯、模型动态、教程文章、社区讨论和开源项目。 |
| 双存储模式 |
支持本地 JSON 快速运行，也支持 PostgreSQL 分代导入和原子切换。 |
运行截图
站点聚合
模型比价
模型检测
公告流
AI 资讯
关于本站
功能模块
- 站点聚合：展示中转站状态、模型数量、最低倍率、公告、供应商和可用分组。
- 模型比价：按模型维度对比不同站点的输入、输出、缓存价格、成功率、延迟和 TPS。
- 模型检测：使用自己的 API Key 对指定站点和模型做协议检测、质量检测和实时调用验证。
- 在线对话：支持 OpenAI 兼容接口，自动获取模型列表并流式输出。
- 公告流：聚合站点公告、维护通知、价格调整和活动优惠，支持搜索和标签筛选。
- 官方 API 状态：汇总 OpenAI、Claude、Gemini、DeepSeek 等官方状态页。
- AI 资讯：采集 AI 资讯、模型动态、教程文章、社区讨论和开源项目。
- 数据入库：支持本地 JSON 模式，也支持 PostgreSQL 分代导入和原子切换。
技术栈
| 层级 |
技术 |
| 后端 |
Python, FastAPI, Uvicorn |
| 前端 |
React, Vite, lucide-react, react-markdown |
| 数据处理 |
JSON 归一化、增量刷新、站点探活、价格标准化 |
| 数据库 |
JSON 文件模式 / PostgreSQL 分代存储 |
| 部署 |
Uvicorn, systemd, Docker 或反向代理 |
目录结构
relaywatch/
server.py FastAPI 应用和 API 接口
normalize_data.py 将采集结果归一化为站点、模型和公告 JSON
refresh_sites.py 站点探活与增量刷新
load_json_to_db.py 将 JSON 数据导入 PostgreSQL
incremental_import.py 增量导入辅助逻辑
db_schema.sql PostgreSQL 表结构
web/ React + Vite 前端源码
static/ 前端构建输出目录
data/ 运行时数据目录，真实数据不提交到仓库
快速启动
安装 Python 依赖：
cd relaywatch
python -m pip install -r requirements.txt
安装并构建前端：
cd web
npm install
npm run build
cd ..
准备本地 JSON 数据：
python normalize_data.py --input ../api_config_results.json --out-dir data
启动服务：
python -m uvicorn server:app --host 127.0.0.1 --port 8765
访问：
http://127.0.0.1:8765
环境变量
复制 .env.example 为 .env，按需填写自己的配置。真实密钥、数据库密码、Cookie、采集平台 Key 不要提交到仓库。
| 变量 |
说明 |
DATABASE_URL |
设置后启用 PostgreSQL 模式 |
RELAYWATCH_ADMIN_TOKEN |
后台维护接口管理员口令 |
RELAYWATCH_DETECTOR_BASE_URL |
模型检测服务地址 |
GITHUB_TOKEN / RELAYWATCH_GITHUB_TOKEN |
提高 GitHub 项目采集限额 |
RELAYWATCH_LINUXDO_COOKIE |
可选，用于访问受 Cloudflare 保护的信息源 |
RELAYWATCH_AI_NEWS_TTL |
AI 资讯缓存时间 |
RELAYWATCH_OFFICIAL_STATUS_TTL |
官方状态缓存时间 |
数据存储
RelayWatch 支持两种运行方式：
- JSON 模式：读取
data/sites.json、data/models.json、data/announcements.json、data/summary.json。
- PostgreSQL 模式：设置
DATABASE_URL 后，从数据库读取分代数据，适合线上长期运行和大数据量检索。
PostgreSQL 导入示例：
export DATABASE_URL='postgresql://relaywatch:[email protected]:5432/relaywatch'
python load_json_to_db.py \
--data-dir data \
--schema db_schema.sql \
--kind json_import
导入脚本会创建新的数据 generation，写入完成后再原子切换到最新版本。如果导入失败，旧版本仍然可用。
API 示例
| 方法 |
路径 |
说明 |
GET |
/api/summary |
首页统计 |
GET |
/api/sites |
站点列表 |
GET |
/api/sites/{site_id} |
站点详情 |
GET |
/api/models |
模型比价列表 |
GET |
/api/model-sites |
指定模型的站点价格 |
GET |
/api/announcements |
公告流 |
GET |
/api/official-status |
官方 API 状态 |
GET |
/api/ai-news |
AI 资讯 |
POST |
/api/chat/models |
获取模型列表 |
POST |
/api/chat/proxy |
在线对话代理 |
POST |
/api/detections |
创建检测任务 |
开源说明
仓库只包含源码、示例配置和说明文档。以下内容默认忽略：
.env 和真实密钥- 采集平台 Key、API Key、Cookie、管理员口令
- PostgreSQL 连接密码、数据库 dump
data/*.json 等生成数据- 日志、缓存、构建产物和
node_modules
如果你要公开自己的 fork，请先做密钥扫描，确认没有泄露私人数据。
鸣谢
感谢 LINUX DO 社区提供的交流氛围与开源推广支持。
使用规范与免责声明
本项目仅对公开可访问的渠道、商品和价格信息进行整理、聚合与比价展示，不参与任何实际交易，也不对第三方渠道、账号、订阅、商品质量、库存、售后或退款提供担保。
本项目不提供批量注册、自动化注册、账号生成或攻击服务，也不授权任何人利用项目展示的站点链接、注册入口或公开信息实施以下行为：
- 批量或自动创建账号，刷取注册赠送、试用额度、优惠权益，或规避第三方风控；
- 未经许可的压力测试、漏洞利用、凭证攻击、流量攻击、恶意请求或服务干扰；
- 违反第三方服务条款、注册规则或适用规定的其他操作。
任何使用者访问第三方站点时均应遵守该站点的规则，并对自己的行为独立负责。收到有效滥用投诉后，项目维护者可采取限制访问、隐藏或下架入口、保留必要日志以及配合相关服务商核查等措施。
完整条款、滥用举报和站点下架说明见 DISCLAIMER.md。安全问题请按 SECURITY.md 私下报告。
License
MIT License. See LICENSE.
评论