Check CX

Check CX 是一个用于监控 AI 模型 API 可用性与延迟的健康面板。项目基于 Next.js App Router 与 Supabase，通过后台轮询持续采集健康结果，并提供可视化 Dashboard 与只读状态 API，适合团队内部状态墙、供应商 SLA 监控与多模型对比。

功能概览

• 统一的 Provider 健康检查（OpenAI / Gemini / Anthropic），支持 Chat Completions 与 Responses 端点
• 实时延迟、Ping 延迟与历史时间线，支持 7/15/30 天可用性统计
• 分组视图与分组详情页（group_name + group_info），支持分组标签与官网链接
• 维护模式与系统通知横幅（支持 Markdown，多条轮播）
• 官方状态轮询（当前支持 OpenAI 与 Anthropic）
• 多节点部署自动选主（数据库租约保证单节点执行轮询）
• 安全默认：模型密钥仅保存在数据库，服务端使用 service role key 读取

快速开始

1. 环境准备

• Node.js 18 及以上（建议 20 LTS）
• pnpm 10
• Supabase 项目（PostgreSQL）

2. 安装依赖

pnpm install

3. 配置环境变量

cp .env.example .env.local

填写 .env.local：

SUPABASE_URL=...
SUPABASE_PUBLISHABLE_OR_ANON_KEY=...
SUPABASE_SERVICE_ROLE_KEY=...
CHECK_NODE_ID=local
CHECK_POLL_INTERVAL_SECONDS=60
HISTORY_RETENTION_DAYS=30
OFFICIAL_STATUS_CHECK_INTERVAL_SECONDS=300
CHECK_CONCURRENCY=5

4. 初始化数据库

• 全新项目：执行 supabase/schema.sql（如需开发 schema，请执行 supabase/schema-dev.sql）。
• 已存在数据库：按顺序执行 supabase/migrations/ 目录中的迁移文件；如使用 dev schema，同步执行 *_dev.sql 迁移。

5. 添加最小配置

INSERT INTO check_configs (name, type, model, endpoint, api_key, enabled)
VALUES ('OpenAI GPT-4o',
        'openai',
        'gpt-4o-mini',
        'https://api.openai.com/v1/chat/completions',
        'sk-your-api-key',
        true);

6. 启动开发服务器

pnpm dev

访问 http://localhost:3000 查看 Dashboard。

运行与部署

pnpm dev    # 本地开发
pnpm build  # 生产构建
pnpm start  # 生产运行
pnpm lint   # 代码检查

部署时将 .env.local 中的变量注入到部署平台（Vercel、容器或自建服务器）。

配置说明

环境变量

变量	必需	默认值	说明
SUPABASE_URL	是	-	Supabase 项目 URL
SUPABASE_PUBLISHABLE_OR_ANON_KEY	是	-	Supabase 公共访问 Key
SUPABASE_SERVICE_ROLE_KEY	是	-	Service Role Key（服务端使用，勿暴露）
CHECK_NODE_ID	否	local	节点身份，用于多节点选主
CHECK_POLL_INTERVAL_SECONDS	否	60	检测间隔（15–600 秒）
CHECK_CONCURRENCY	否	5	最大并发（1–20）
OFFICIAL_STATUS_CHECK_INTERVAL_SECONDS	否	300	官方状态轮询间隔（60–3600 秒）
HISTORY_RETENTION_DAYS	否	30	历史保留天数（7–365）

Provider 配置要点

• check_configs.type 目前支持 openai / gemini / anthropic。
• endpoint 必须是完整端点：
  • /v1/chat/completions 使用 Chat Completions
  • /v1/responses 使用 Responses API
• request_header 与 metadata 允许注入自定义请求头与请求体参数。
• is_maintenance = true 会保留卡片但停止轮询；enabled = false 则完全不纳入检测。

API 概览

• GET /api/dashboard?trendPeriod=7d|15d|30d：Dashboard 聚合数据（带 ETag）。返回完整时间线与可用性统计。
• GET /api/group/[groupName]?trendPeriod=7d|15d|30d：分组详情数据。
• GET /api/v1/status?group=...&model=...：对外只读状态 API。

更详细的接口与数据结构见文档。

文档

• 架构说明：docs/ARCHITECTURE.md
• 运维手册：docs/OPERATIONS.md
• Provider 扩展：docs/EXTENDING_PROVIDERS.md

许可证

MIT