discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens
BloretCrew/CrewRouter · source

Snapshot 0 · 2026-11-04T12:47:28Z · JavaScript · GPL-3.0
Content fingerprint
341092ecd3b968e9d5be21669eb3ea20b23d4c3d48d48e4cb39f0328a3b951ba
GitHub description at capture

Your Team with AI, AI with provider.
README at capture

<img src="ico.png" width="160" height="160" alt="CrewRouter" align="left" />
<div align="center">
  <h1>CrewRouter</h1>
  <p>
    一个 API 端点，接入所有 AI 模型。<br>
    智能路由、精细管控、实时洞察，为团队而生。
  </p>
</div>

<br clear="all" />

<div align="center">

[![Build & Release](https://github.com/BloretCrew/CrewRouter/actions/workflows/build-docker.yml/badge.svg)](https://github.com/BloretCrew/CrewRouter/actions/workflows/build-docker.yml)
![仓库大小](https://img.shields.io/github/repo-size/BloretCrew/CrewRouter?style=social&label=%E4%BB%93%E5%BA%93%E5%A4%A7%E5%B0%8F)
![星标数](https://img.shields.io/github/stars/BloretCrew/CrewRouter?style=social&label=%E6%98%9F%E6%A0%87)
![许可证](https://img.shields.io/github/license/BloretCrew/CrewRouter?label=License)
[![最新正式版](https://img.shields.io/github/v/release/BloretCrew/CrewRouter?label=%E6%9C%80%E6%96%B0%E6%AD%A3%E5%BC%8F%E7%89%88)](https://github.com/BloretCrew/CrewRouter/releases)
![Docker](https://img.shields.io/badge/Docker-detritalw%2Fcrewrouter-2496ED?logo=docker&logoColor=white)

**团队级 AI 模型统一网关** · OpenAI / Anthropic 双协议 · 自托管

[演示控制台](https://crewrouter.bloret.net/) · [部署指南](docs/deployment.md) · [架构说明](docs/ARCHITECTURE.md) · [API 文档](docs/API.md)

</div>

---

## Personal / Team Edition

安装首次打开 `/setup` 时必须选择 `personal` 或 `team`，选择会写入实例数据库并永久固定，界面和 `CR_EDITION` 不能修改已初始化的版本。无人值守安装可在首次启动前设置 `CR_EDITION=personal` 或 `CR_EDITION=team`；已有实例若没有 edition 记录，需明确完成一次选择，含团队数据的旧库不会被自动标记为 Personal。Personal 版保留核心网关、个人 Key、用量和 Playground，团队管理接口返回 `team_edition_required`；Team 版保留现有团队管理能力。Edition 不是许可或安全边界，后端授权检查始终有效。正式页面品牌区的 `LOCAL` / `PERSONAL` / `TEAM` badge 仅展示实例状态：Desktop 本地运行时显示 `LOCAL`，服务端依据实例 edition 显示 `PERSONAL` 或 `TEAM`；它不是运行时切换控件。本地 runtime 与服务端 edition 是两个不同维度，`runtime=desktop-local` 优先于 edition。Desktop Local 使用 Bloret PassPort 登录，首次授权绑定本地账户；模型配置、API Key 和用量数据仍保存在本机。退出后需要重新登录，Desktop Token 仅标识应用请求来源。

使用 PassPort 登录的 Server 或 Desktop Local 需要配置独立应用的 ID 和 Secret。程序不再提供共享应用凭据，旧版公开的共享 Secret 也不再接受。Server 使用 `passport.appId/appSecret` 或 `CR_PASSPORT_APP_ID/CR_PASSPORT_APP_SECRET`；Desktop 的配置方式见 [Desktop 说明](CrewRouter-Desktop/README.md)。缺少配置时登录保持关闭，请先完成配置并重新启动。

## 隔离开发测试

请使用仓库外临时 `config.json`、临时端口（例如 `20103`）和独立 PostgreSQL 数据库运行测试，禁止使用生产端口 `20003`、Show 端口 `20004` 或生产 `config.json`/数据库。

`npm run test:usage-write` 验证 Token 归一化及写入保护，数据库回归自动创建仅监听临时 Unix socket 的独立 PostgreSQL 集群，需要本机提供 `initdb`、`pg_ctl`，以 root 运行时还需 `postgres` 用户和 `runuser`。新版本启动时为用量、消息分析和请求尝试安装写入保护：拒绝负数、异常时间及必填关联缺失，修正新用量记录的时间默认值；不回填历史记录，也不阻止历史坏字段未发生改变的其他更新。Token 数字字符串先转整数再求和，非法值及超出数据库整数范围的值直接拒绝，不静默清零。

写入保护与非空约束修补在同一连接、同一事务中安装：仅对当前没有空值的必填列恢复 `NOT NULL`，保留历史缺失字段，不自动补零、补关联或猜测时间。消息分析的必填字段、非负计数、分析时间以及请求的流式标志、用量质量均校验；`analyzed_at` 的默认值固定为上海墙钟，避免其他时区连接产生偏移。安装失败整体回滚，已有坏字段未改变的其他更新仍可执行。

历史用量时间恢复：先备份全库，再运行 `node server/scripts/repair-usage-timestamps.js` 只读预览；确认后使用 `--apply --backup-dir /绝对路径/尚不存在的私有目录` 实际修复。只恢复消息分析表中唯一 `usage_id`、相同用户且时间有效的原始时间副本，保留已有同毫秒时间的微秒精度，不推算 Token、金额或缺失关联。全部更新在同一事务中分批执行并核对行数，提交前将原值、来源及 SHA-256 同步写入权限受限的目录；失败整体回滚，提交结果不明时保留证据并需重新核查。`npm run test:usage-repair` 在独立 PostgreSQL 中验证恢复、回滚和幂等性。备份含业务数据，不应提交到 Git；原值可能包含坏时间，回退时须先处理写入保护，不能直接覆盖在线数据库。

## 它是什么

CrewRouter 把多家上游模型供应商收成 **一个 OpenAI / Anthropic 兼容端点**。团队成员只拿网关下发的 Key，用 Claude Code、Codex、Cursor、OpenCode、Cherry Studio 等工具时，只需改 `base_url`。供应商密钥留在网关里，成员有使用权、没有所有权。

应用 → **CrewRouter** → OpenAI / Anthropic / DeepSeek / 更多…

## 核心功能

- [x] **多供应商聚合** — OpenAI、Anthropic、DeepSeek 等，一个端点全部接入
- [x] **协议自动转换** — OpenAI ↔ Anthropic 双向转换，用 OpenAI SDK 调 Claude，或反过来
- [x] **智能路由** — 按团队分配模型，支持别名、上游映射和自定义规则
- [x] **Fusion 模式** — 同一请求并发多个模型，裁判模型评估并综合最优回答
- [x] **实时统计** — 请求量、Token、延迟、成本；按模型 / Key / 时间下钻
- [x] **API Key 管理** — 时间调度、模型绑定、自定义签名、独立 Fusion 配置
- [x] **多因素认证** — TOTP、WebAuthn PassKey、飞书 / PassPort 登录（按实例认证模式提供）
- [x] **动态密钥刷新** — 供应商 Key 可用脚本定时轮换并缓存
- [x] **代理池** — 每供应商独立代理，支持订阅导入，应对跨境与 429
- [x] **团队与权限** — 个人 / 默认 / 前沿团队分层，配合用户组限额
- [x] **灵活计费** — Token 倍率、兑换码、余额告警、可退款余额
- [x] **密钥隔离** — 上游地址与 Key 对成员和本地工具不可见
- [x] **Playground** — 控制台内交互调试与会话历史
- [x] **开箱向导** — 首次启动 OOBE 完成数据库与管理员配置
- [x] **深浅色主题** — 跟随系统或手动切换
- [x] **插件系统** — 沙箱插件框架：网关钩子、页面/插槽/路由扩展、主题插件，全能力面覆盖
- [x] **插件商店** — 浏览、评分、一键安装、更新检测（demo 模式 / 自托管可配置源）
- [x] **全站国际化** — 中英双语，译文托管实时拉取
- [x] **注入提示词** — 按 key/全局条目化，Claude Code 风格注入，响应自动净化
- [x] **客户端事件上报** — CrewRouterHelper 上报 + 实时活动看板
- [x] **OAuth 2.0 授权服务** — PKCE 授权码、刷新令牌与 AI 客户端授权
- [x] **模型库增强** — 收藏、全局搜索、Key 拖拽排序、队列回退
- [x] **自定义提示词指纹** — 调用记录标记 CLAUDE.md/AGENTS.md 等
- [x] **会话总结** — 会话标签、生成总结

## 兼容的客户端

只需更换 `base_url`，无需改业务代码：

Claude Code · Claude Desktop · Codex · OpenCode · OpenClaw · Hermes Agent · Grok Build · DeepSeek Harness · Kilo Code · Cline · Cherry Studio · Qwen Code · Cursor · 以及一切走 OpenAI Chat Completions / OpenAI Responses/ Anthropic Messages 协议的工具，以及安装了对应插件的任意客户端

```bash
# 只需更换 base_url
curl https://your-host/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -d '{
    "model": "gpt-4.1",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
```

```python
from openai import OpenAI

client = OpenAI(
    base_url="https://your-host/v1",
    api_key="sk-your-key",
)
resp = client.chat.completions.create(
    model="gpt-4.1",
    messages=[{"role": "user", "content": "Hello!"}],
)
```

## 快速开始

### 方式一：一键包（推荐）

从 **[GitHub Releases](https://github.com/BloretCrew/CrewRouter/releases)** 下载 `crewrouter-direct-v*.tar.gz`（由 CI 自动构建），上传到服务器后：

```bash
tar xzf crewrouter-direct-v*.tar.gz
cd crewrouter-direct
./start.sh
```

`start.sh` 会在首次运行时自动安装依赖、引导配置数据库（支持自动安装 PostgreSQL 或连接已有实例）并生成 `config.json`，随后自动启动服务。浏览器打开 `http://your-server:20003` 即可使用。

> [!TIP]
> 一键包支持管理后台**一键更新**：进入 管理后台 → 系统设置 → 版本与更新，点击检查更新并确认后自动拉取官方更新包、覆盖程序并重启，`config.json` 与数据库均保留。详见 [docs/deployment.md](docs/deployment.md)。

### 方式二：Docker

```bash
cp .env.example .env   # 填写 CR_SESSION_SECRET、CR_DB_PASSWORD 等
docker compose up -d
```

浏览器打开 `http://localhost:20003`，按开箱向导完成初始化。

镜像：[`detritalw/crewrouter`](https://hub.docker.com/r/detritalw/crewrouter)，亦可使用 CI 推送的 `ghcr.io` 镜像。Docker 部署不支持容器内一键更新，升级请拉取新镜像后 `docker compose up -d`。

### 方式三：源码运行

需要 **Node.js ≥ 16**（建议 20 LTS）和 **PostgreSQL ≥ 14**。

```bash
npm install
cp config.example.json config.json   # 填写数据库与 sessionSecret
# 创建数据库用户与库，例如：
#   CREATE USER crewrouter WITH PASSWORD '...';
#   CREATE DATABASE crewrouter OWNER crewrouter;
npm run init-db
npm start          # 开发可用 npm run dev
```

默认监听配置中的端口（示例为 `20003`）。生产部署、systemd 托管见 **[docs/deployment.md](docs/deployment.md)**。

> [!NOTE]
> 演示站可在管理员开启 `demo` 后访问公开展示页与只读控制台，无需注册即可浏览界面。自托管默认 `demo: false`。

## 配置要点

`config.json`（或 Docker 环境变量 `CR_*`）中最常改的几项：

| 项 | 说明 |
|----|------|
| `app.port` / `CR_APP_PORT` | 监听端口，默认 `20003` |
| `app.sessionSecret` | 会话密钥，生产环境必须更换 |
| `CR_ENABLE_KEY_SCRIPTS` | 供应商密钥刷新脚本默认禁用；审阅数据库中的脚本与外发目标后设为 `1` 才执行 |
| `CR_ENABLE_CUSTOM_QUOTA_SCRIPTS` | 自定义额度查询配置默认禁用；审阅其中的请求地址与密钥发送方式后设为 `1` 才执行 |
| `database.*` / `CR_DB_*` | PostgreSQL 连接 |
| `initialProviders` / `initialModels` | 首次初始化写入的供应商与模型 |
| `feishu` / GitHub OAuth | 可选企业登录 |
| `email` | 可选 SMTP（余额告警等） |
| `statsReport.*` / `CR_STATS_REPORT_*` | 统计上报开关、地址、间隔与粒度（见下） |

完整字段见 `config.example.json` 与 [docs/deployment.md](docs/deployment.md)。

### 统计信息上报（可选）

自建实例默认**不**上报任何数据；当首次进入控制台的管理员在授权弹窗中允许（或在管理后台 → 系统设置中开启「统计信息上报」后），实例会按 `interval`（默认每 1 小时）向官方服务器发送一次**匿名聚合**的使用统计：请求量、Token 消耗、成本、活跃用户/密钥数、请求类型分布，以及可选的模型/供应商分布（`granularity`）。

不包含任何隐私信息：无用户名/邮箱/IP、无 API/上游密钥、无请求与回复正文。隐私优先，可在管理后台或 `config.json` 的 `statsReport.enabled: false` 随时关闭。**演示模式（`demo: true`）下既不询问也不上报。**

| 配置 | 说明 |
|------|------|
| `statsReport.enabled` / `CR_STATS_REPORT_ENABLED` | 总开关，默认 `true`（仅为配置级强制，实际仍需管理员授权才上报）；`false` 时强制关闭 |
| `statsReport.url` / `CR_STATS_REPORT_URL` | 上报地址，默认 `https://crewrouter.bloret.net/api/stats-report` |
| `statsReport.token` / `CR_STATS_REPORT_TOKEN` | 可选共享令牌，配置后接收端才校验 |
| `statsReport.interval` / `CR_STATS_REPORT_INTERVAL` | 上报间隔（秒），默认 `3600` |
| `statsReport.granularity` / `CR_STATS_REPORT_GRANULARITY` | `detailed`（默认，含模型/供应商明细）或 `counts`（仅聚合计数） |

## 文档

| 文档 | 内容 |
|------|------|
| [docs/deployment.md](docs/deployment.md) | 直接运行 / Docker / 更新 |
| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | 目录结构、路由与适配器 |
| [docs/API.md](docs/API.md) | HTTP API |
| [docs/integration-guide.md](docs/integration-guide.md) | 接入现有应用 |
| [LOG_SPEC.md](LOG_SPEC.md) | 运行日志约定 |

## 技术栈

- **运行时** Node.js · Express
- **数据** PostgreSQL
- **前端** 原生 HTML / CSS / JS（控制台、管理后台、Playground、Showcase），含 i18n 与插件运行时
- **服务端** OAuth 授权服务与插件商店
- **安全** Session、TOTP、WebAuthn、OAuth、SSRF 校验

## 开源许可

本项目以 **GNU General Public License v3.0** 发布。

- 你可以自由使用、修改和分发
- 衍生作品须同样以 GPL-3.0 发布
- 详见 [LICENSE](./LICENSE)

## 星标历史

<a href="https://www.star-history.com/?repos=BloretCrew%2FCrewRouter&type=date&legend=top-left">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=BloretCrew/CrewRouter&type=date&theme=dark&legend=top-left&sealed_token=gDkqatDM5Ka6TX7FpWQMrcOXfNeET4bgBmkENnA7yEBWsOIy2qQqiWZwxph9Ef7FB14DjI78qHbm8FgyMZbeYnv5aVqd__pUj32lYzFtF-4yZ8kSe4ce9xeKhuzIxfi0UD771HT8j-BywaTEI2IprhWPnprvfdiYImjrIGHQ_IOYdVc2qx9KROMEJzEG" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=BloretCrew/CrewRouter&type=date&legend=top-left&sealed_token=gDkqatDM5Ka6TX7FpWQMrcOXfNeET4bgBmkENnA7yEBWsOIy2qQqiWZwxph9Ef7FB14DjI78qHbm8FgyMZbeYnv5aVqd__pUj32lYzFtF-4yZ8kSe4ce9xeKhuzIxfi0UD771HT8j-BywaTEI2IprhWPnprvfdiYImjrIGHQ_IOYdVc2qx9KROMEJzEG" />
   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=BloretCrew/CrewRouter&type=date&legend=top-left&sealed_token=gDkqatDM5Ka6TX7FpWQMrcOXfNeET4bgBmkENnA7yEBWsOIy2qQqiWZwxph9Ef7FB14DjI78qHbm8FgyMZbeYnv5aVqd__pUj32lYzFtF-4yZ8kSe4ce9xeKhuzIxfi0UD771HT8j-BywaTEI2IprhWPnprvfdiYImjrIGHQ_IOYdVc2qx9KROMEJzEG" />
 </picture>
</a>

## 相关链接

[CrewRouter - Github](https://github.com/BloretCrew/CrewRouter) [CrewRouter](https://crewrouter.bloret.net/) [QQ Discuss](https://qm.qq.com/q/kEt8fb41wc) [LinuxDo](https://linux.do/)
# 模型归因引擎

模型归因已接入 [Ikaleio/lm-detector](https://github.com/Ikaleio/lm-detector)，在本地执行数字指纹检测，支持 60 个候选模型。接入方式、结果限制及资源更新见 [模型归因说明](docs/lm-detector.md)。