jev-accounts-hub

TypeSafe / Jev 的多账户管理器和 API 网关。

把多个官方 TypeSafe 账户收进一个池子，统一鉴权、配额、用量和故障切换。下游继续用官方 System One 协议，只需要把 Base URL 指到本服务。

调用方
  TYPESAFE_BASE_URL = http://127.0.0.1:8080
  TYPESAFE_API_KEY  = sk-jev-xxxxxxxx   ← 本服务签发的用户 Key
        │
        ▼
   jev-accounts-hub
   账户池 / 鉴权 / RPM / token 配额 / 429 换号
        │
        ▼
   api.typesafe.ai
   POST /v1/systemone
   GET  /v1/models

协议保持官方原样：POST /v1/systemone、GET /v1/models。不是 OpenAI chat/completions 兼容层。

• 多账户池：按权重轮询，429 / 529 / 5xx / 401 自动换号
• 出站代理池：HTTP / HTTPS / SOCKS5，账号可绑固定代理，不绑则从池轮询，池空才直连
• 用户 Key：RPM、token 配额、备注、过期与停用
• 上游 Key 落库 AES-256 加密，管理台只显示掩码
• 调用日志、用量统计、探活、试玩
• 原生 System One，官方 SDK 只改 base_url

任选一种运行方式：

• Docker Engine 24+ 和 Docker Compose
• Go 1.24+

另外需要：

• 能访问 https://api.typesafe.ai
• 至少一个 TypeSafe API Key（jev_… 或 ts_…），在 TypeSafe 控制台复制
• 空闲端口 8080（或自行修改 JEVPROXY_LISTEN）
• 可写的数据目录，默认 ./data

多账户可以一起导入。Key 只存在服务端，管理台显示形如 jev_****abcd。

官方当前能力（以 TypeSafe 文档为准，可能会变）：

git clone https://github.com/<you>/jev-accounts-hub.git
cd jev-accounts-hub
docker compose up --build

或本地运行：

go run ./cmd/jevproxy

首次启动会在 ./data/ 生成：

打开 http://127.0.0.1:8080 登录。公开注册默认关闭（JEVPROXY_OPEN_REGISTER=1 才开放）。库里还没有账号时，仍可以注册第一个管理员，之后注册的是普通用户。data/admin.token（或 JEVPROXY_ADMIN_TOKEN）仍可应急进入，权限等同管理员。这不是 TypeSafe 的 jev_ Key。改密码会使该账号全部会话失效。停用账号会踢下线，并停用其用户 Key。登录、注册、兑换按 IP 限流。

然后：

1. 导入 TypeSafe 账户：单条粘贴，或批量每行一个 jev_…（可写 名称 jev_…）
2. 点探活，确认账户能打到官方接口
3. 签发用户 Key：明文只显示一次，立刻复制
4. 打开试玩，用账户池打一发 System One
5. 把用户 Key 和网关 Base URL 发给调用方

生产请备份 data/，不要提交 git。这些文件已在 .gitignore 中排除。

官方 Python SDK：

from typesafe import TypeSafeClient, Noul

client = TypeSafeClient(
    api_key="sk-jev-你的用户Key",
    base_url="http://127.0.0.1:8080",
)
resp = client.system_one(
    state="Stripe linking has failed for days.",
    questions={"urgent": Noul("The note signals time pressure")},
)
print(resp.answers["urgent"].noul)

curl：

curl -s http://127.0.0.1:8080/v1/systemone \
  -H "Authorization: Bearer sk-jev-你的用户Key" \
  -H "Content-Type: application/json" \
  -d '{
    "state": "hello",
    "model": "jev-latest",
    "questions": {
      "ok": {"type": "noul", "instructions": "This is a greeting"}
    }
  }'

拉模型列表（官方结构，字段是 models[].name，不是 OpenAI 的 data[].id）：

curl -s http://127.0.0.1:8080/v1/models \
  -H "Authorization: Bearer sk-jev-你的用户Key"

请求里 model 可写：

打开 http://127.0.0.1:8080 ，用账号登录。管理员看全部页面。普通用户只能看自己的用户 Key 和调用日志，并能自己创建 Key。

1 积分 = $1 调用额度。管理员在「账号积分」里给任意账号加减整数积分，也可以在「兑换积分」里按面额批量生成兑换码。用户在同一页输入兑换码，面额加进自己的余额。码只在生成时显示一次，用过即失效。新建 Key 必须挂到一个有余额的账号上，调用扣这个账号的积分。普通用户只能挂自己，配额固定为不限，创建后可以把 RPM 改到 1–120。管理员和应急口令签发时要选归属账号，可以另设 token 配额。余额到 0 后，已有 Key 调用返回 402。调用按官方价 $42 / 十亿 input tokens 扣，output 免费。

应急口令是 data/admin.token（或 JEVPROXY_ADMIN_TOKEN），不是登录账号。用它进后台时没有积分余额，也不能兑换，也不能签发不挂账号的 Key。

上游出站走代理：账号可绑固定代理；不绑则从活跃池轮询；池空才直连。绑定代理不可用时不会回退直连（避免 IP 关联）。批量导入支持：

socks5://user:pass@10.0.0.1:1080
http://1.2.3.4:8080
us-east socks5://10.0.0.2:1080
1.2.3.4:3128:user:pass

批量导入每行一条，支持空格、逗号，或 ---- 分隔：

jev_xxxx
prod-1 jev_yyyy
name,ts_zzzz
user@example.com----apikey_xxxx----key_yyyy----auto

---- 行里，邮箱当名称，只导入 apikey_ / jev_ / ts_。同行的 key_、auto 会忽略。重复 Key 会跳过。调用和试玩都记入日志，并写下这次扣掉的积分。试玩必须登录账号，扣的是这个账号自己的积分，日志里用户显示为这个账号。应急口令没有账号，不能试玩。转发前会先占 1 微积分，成功后按实际 input tokens 结清，失败则退回。余额只够一次时，并发的第二次直接 402。

• 按上游返回的 usage.input_tokens 记账。output 官方免费，不向用户加收
• 用户 Key 可设 RPM 和 token 配额（0 = 不限）。普通用户自建的 Key 配额固定为不限，创建后可把 RPM 改到 1–120，额度看账号积分
• 上游账户可设权重、RPM；遇 429 / 529 / 5xx / 401 自动换号重试
• 用户 422（schema 错）原样返回，不换号空打

见 .env.example。常用：

JEVPROXY_LISTEN=:8080
JEVPROXY_DATA_DIR=./data
JEVPROXY_ADMIN_TOKEN=     # 留空则自动生成
JEVPROXY_MASTER_KEY=      # 64 位 hex，留空则自动生成
JEVPROXY_UPSTREAM=https://api.typesafe.ai
JEVPROXY_TIMEOUT=15s

This repository includes a small stdio MCP bridge at cmd/jev-mcp. The user-level Codex MCP entry named jev exposes its jev_decide tool from any project, so Codex can ask Jev for narrow typed judgments while keeping its normal coding model and tool execution unchanged.

The bridge sends the native POST /v1/systemone request to the local gateway. It reads TYPESAFE_API_KEY and TYPESAFE_BASE_URL from the process environment; when those are absent, it falls back to ~/.codex/.env (or the path in TYPESAFE_DOTENV). No credentials are stored in this repository.

Start the gateway first, then open a new Codex task (or reopen an existing one) so its MCP tool catalog is reloaded. The bridge is intentionally a decision tool, not an OpenAI-compatible model provider.

QQ 群：1102910606

欢迎 Issue 和 PR。

MIT