Repository navigation
v0.1.0 · 妙手(CatPaw) → OpenAI 兼容网关
把 妙手(CatPaw / LongCat)桌面客户端的登录态反代成 OpenAI 兼容 API 的自托管网关。首个可用版本。
能做什么
POST /v1/chat/completions:流式(真增量,不缓冲整段)+ 非流式GET /v1/models、GET /healthz、GET /panel内置运维面板- 妙手登录态一键导入:
go run ./cmd/login解密客户端catx-credential.json(AES-256-GCM)+ 校验 + 入库 - 账号池:在途最少选号、401/429/额度分类熔断冷却、状态持久化、失败换号重试
- 容器友好:环境变量覆盖配置;
-token/LONGCAT_TOKEN启动即注入账号
镜像(linux/amd64 + linux/arm64)
| 源 | 地址 |
|---|---|
| GHCR | ghcr.io/xitihangto/longcat2api:0.1.0 |
| 1ms.run | ghcr.1ms.run/xitihangto/longcat2api:0.1.0 |
| 南京大学 | ghcr.nju.edu.cn/xitihangto/longcat2api:0.1.0 |
| dockerproxy | ghcr.dockerproxy.net/xitihangto/longcat2api:0.1.0 |
快速开始
git clone https://github.com/xitihangto/longcat2api && cd longcat2api
cp .env.example .env # 填 LONGCAT_API_KEY
cp config.example.json config/config.json
./scripts/pull-image.sh # 自动挑可用的镜像源(国内建议)
docker compose up -d
curl -N http://127.0.0.1:8090/v1/chat/completions \
-H 'Authorization: Bearer sk-xxx' -H 'Content-Type: application/json' \
-d '{"model":"longcat","messages":[{"role":"user","content":"你好"}],"stream":true}'协议
客户端逆向笔记见 docs/PROTOCOL.md:
三域名三套鉴权(nocode.cn / catx.nocode.cn / ai.catpaw.meituan.com)、
chat/create → agent-stream → stream/connect 三步、SSE 增量帧与重连去重。
已验证
- 非流式 / 流式对话端到端通过(流式 18 帧真增量)
- 离线 e2e 测试覆盖:首连断流 → 重连历史回放去重 → 终态帧主动断开
- 四个镜像源均能取到双架构索引(
0.1.0/v0.1.0/sha-*/latest)
注意
仅供本人账号、本机/私有环境自用。请勿批量注册、对外售卖额度或二次分发。
非官方客户端可能违反上游条款,账号风险自担。