Skip to content

v0.1.0 · 妙手(CatPaw) → OpenAI 兼容网关

Choose a tag to compare

@xitihangto xitihangto released this 14 Nov 04:17
· 15 commits to main since this release

把 妙手(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)

注意

仅供本人账号、本机/私有环境自用。请勿批量注册、对外售卖额度或二次分发。
非官方客户端可能违反上游条款,账号风险自担。