Repository navigation
Releases
v0.3.2 · 妙手账号面板粘贴导入
妙手账号也能"粘贴"了
之前 LongCat-2.0(妙手)通道的 token 只能靠本机 cmd/login 解密,或者把 accounts.json 从 Mac 拷到 NAS —— 容器化场景很别扭。
0.3.2 起和 longcat 通道一致:面板粘贴即可。
三种粘贴形态都认
- 裸 token:
AgGF… - 带鉴权头的 Copy as cURL 整段:
access-token:/X-Auth-Token:/Authorization: Bearer - 含
"access_token":"…"的 JSON
用法
面板 http://<NAS>:8090/panel?key=<key> → 顶部「妙手账号」卡片 → 粘贴 → 校验并导入
- 校验走上游
current-user,成功立即入池生效(不重启) - 同
uid或同 token 会更新原记录,重复导入不会堆积 - 顺带把
cmd/login -token也升级成同样宽松的解析
token 从哪来
Mac 上跑一次 go run ./cmd/login,然后从 data/accounts.json 复制 token 字段即可(一次性,长期有效)。
升级
docker compose pull && docker compose up -d # image tag 改成 0.3.2镜像:ghcr.io/xitihangto/longcat2api:0.3.2(amd64 + arm64)
v0.3.1 · 修复老配置升级后模型列表缺 2.5
修了什么
升级到 0.3.0 后 客户端拉不到 LongCat-2.5(/v1/models 里只剩一条畸形模型)。
根因
老版本生成的 config.json 里 models.catalog 只有 LongCat-2.0、且没有 provider 字段。
Load() 的实现是 cfg := Default() 后再 json.Unmarshal,而 Go 把 JSON 解到已预填的切片
时会复用底层数组并逐字段合并:
默认项0: {LongCat-2.5, provider=longcat-web} ← 底层数组
默认项1: {LongCat-2.0, provider=catpaw}
文件项: {LongCat-2.0, desc="旧配置"} ← 覆盖到 默认项0,provider 没写 → 继承 longcat-web
结果: {LongCat-2.0, provider=longcat-web} ← 串味,2.5 消失
修复
- 解码前清空
Models.Catalog/Models.Alias,杜绝合并 fill()改成按名字合并内置目录:保留你的自定义项(缺 provider 补catpaw),
再补上内置新增项(LongCat-2.5→longcat-web);别名以文件为准、缺的补齐- 面板「可用账号」改名「妙手账号」,并说明 Cookie 属通道凭据、不计入账号池
(所以粘了 Cookie 账号池还是 1,是正常的)
升级后自检
curl -s http://<NAS>:8090/v1/models -H 'Authorization: Bearer <key>'
# 应看到 LongCat-2.0(catpaw) + LongCat-2.5(longcat-web)升级
docker compose pull && docker compose up -d # image tag 改成 0.3.1镜像:ghcr.io/xitihangto/longcat2api:0.3.1
v0.3.0 · 国际站默认 + 双通道 + 轻量登录态导入
v0.3.0 要点
1. 默认走国际站(longcat.ai)
| 站点 | 定位 | 登录方式 |
|---|---|---|
longcat.ai/chat(默认) |
国际站(页面有「国际站」徽标) | passport.mykeeta.com,Continue with email |
longcat.chat |
国内站 | passport.meituan.com,微信/手机号扫码 |
两者是同一套服务、游客配额是两个独立池(实测 .chat 被 429 时 .ai 仍可用)。
2. 模式命名修正
| 旧名 | 新名 | 含义 |
|---|---|---|
oversea |
guest |
免登录游客接口,网页配额,限流凶 |
cn |
auth |
带 Cookie 的登录态接口,走账号额度 |
旧值仍可解析(自动归一),但面板与文档不再出现这条黑话 —— 模式名与站点无关。
3. 登录态:轻量三步
面板 /panel?key=<api_key> → 频道卡片:
- ① 打开 longcat.ai(新标签,自己登录)
- ② 粘贴 Cookie —— 支持整串 Cookie、
Cookie:前缀、右键 Copy as cURL 整段 - ③ 校验并保存 —— 调上游
user-current验证,成功即热生效并写入config.json(不用重启)
Mac 上懒得找 Cookie:node scripts/import-chrome-cookie.mjs 直接从 Chrome 解密(无依赖)。
4. 移除内置浏览器
上一版试过 Playwright + Chromium 侧车(面板内嵌远程浏览器扫码),代价是 1.8GB 镜像 + 帧率低。
一次性登录不值这个体积,已整条移除:代码、compose 服务、配置项、面板弹窗全部删除。主镜像仍是 ~30MB。
5. 修复
uid为 JSON 数字时被格式化成科学计数法(9.9887766e+07→99887766)- 面板文案硬编码
longcat.chat→ 全部跟随配置推导(国际站显示 .ai,国内站显示 .chat)
升级
# 把 image tag 换成 0.3.0 后
docker compose pull && docker compose up -d镜像:ghcr.io/xitihangto/longcat2api:0.3.0(linux/amd64 + linux/arm64)
国内加速:ghcr.nju.edu.cn / ghcr.1ms.run / ghcr.dockerproxy.net 前缀。
模型
| 客户端填 | 通道 | 说明 |
|---|---|---|
LongCat-2.5 / 2.5 |
longcat 网页通道 | 免费;未填 Cookie 时走游客配额 |
LongCat-2.0 / longcat |
妙手 CatPaw | 需要 go run ./cmd/login 导入妙手登录态 |
v0.2.0 · 双通道:免费 LongCat-2.5 + 妙手 LongCat-2.0
新增:免费 LongCat-2.5 通道
除了妙手(LongCat-2.0),现在多了一条 longcat.chat 网页通道,返回 LongCat-2.5,免登录、免费。
模型怎么选
| 想用 | 客户端里填 | 走哪条通道 | 凭据 |
|---|---|---|---|
| 2.5(新) | LongCat-2.5、longcat-2.5、2.5、web |
longcat.chat 网页 | 免登录 |
| 2.0(原) | LongCat-2.0、longcat、catpaw |
妙手账号池 | 妙手登录态 |
GET /v1/models 现在会同时列出两个,带 provider 字段。
特性
- 真实 token 用量:网页通道上游返回
tokenInfo,usage不再是估算值 - 限流保护:请求串行 + 最小间隔(默认 1500ms)+ 命中 429 本地冷却 90s
- 自动回落:2.5 被限流时按配置回落妙手 2.0(
longcat_web.fallback_to_catpaw),
响应头X-Longcat-Channel: catpaw(fallback)标明实际通道,绝不静默骗你 - 可选 Cookie:填
LONGCAT_WEB_COOKIE(登录 longcat.chat 后复制)走cn模式,额度和稳定性都更好 /healthz新增channels字段,含longcat_web.cooldown_left_s
已知限制(务必看)
- 网页通道不吃
tools/ function calling —— 只能当文本补全用,不能当 agent 后端(Claude Code 那种工具执行要官方 API)。 - 游客配额很小:连续十来次就
429 操作太快啦,冷却可能十几分钟。想稳定请填 Cookie。 - 上游
promptTokens基线约 449,是服务端自己的 agent 系统提示词,不是你的输入。
升级
# 把 image tag 改成 0.2.0
docker compose pull && docker compose up -d镜像:ghcr.io/xitihangto/longcat2api:0.2.0
(国内:ghcr.nju.edu.cn / ghcr.1ms.run / ghcr.dockerproxy.net 前缀)
验证
curl -s http://127.0.0.1:8090/healthz | python3 -m json.tool # 看 channels
curl -s -H 'Authorization: Bearer <key>' -H 'Content-Type: application/json' \
http://127.0.0.1:8090/v1/chat/completions \
-d '{"model":"2.5","messages":[{"role":"user","content":"你好"}]}' -D - | grep -i x-longcat-channelv0.1.2 · 版本可观测 + 面板 key 提示
为什么需要这版
上一版排查「/panel?key= 不生效」时,无法判断容器跑的是哪个版本 —— 面板 UI 和 /healthz 都不带版本号,
结果在旧镜像上试新功能,白折腾。
改动
GET /healthz(无需鉴权)新增:version:当前网关版本api_key_required:是否启用了 api_keypanel_key_hint:面板直达链接模板
- 所有响应新增
X-Longcat-Version响应头 - 面板标题显示版本徽标(
longcat2api v0.1.2) - 面板启动先读
/healthz:未填 key 时立即提示;key 不对时明确提示「当前填的 key 不对」
自检一行命令
curl -s http://127.0.0.1:8090/healthz- 有
"version":"0.1.2"→ 镜像已更新 - 只有
status/service/accounts/time→ 还是旧镜像
升级
# 把 image 的 tag 改成 0.1.2 后
docker compose pull && docker compose up -d镜像:ghcr.io/xitihangto/longcat2api:0.1.2
(国内加速:ghcr.nju.edu.cn / ghcr.1ms.run / ghcr.dockerproxy.net 前缀)
v0.1.1 · 面板鉴权体验修复
修复:面板 401 时不知道该填什么 key
飞牛/容器部署后设了 LONGCAT_API_KEY,打开 /panel 只看到「加载失败:/panel/api/overview → HTTP 401」,
输入框占位文案还写着「本地调试可留空」——完全没有引导。
改动
- 面板识别 401:高亮输入框 + 自动聚焦 + 顶部提示条,明确说明 key 就是 compose 里的
LONGCAT_API_KEY
(或config.json的api_key),填好点「保存并刷新」 - 支持
/panel?key=<api_key>直达:自动写入 localStorage 并从地址栏抹掉,可存成书签 - 启动日志提示面板入口(不打印 key 本身)
- 版本号
0.1.1
升级
# 飞牛 / compose
docker compose pull && docker compose up -d
# 或固定版本:把 image 的 tag 改成 0.1.1镜像:ghcr.io/xitihangto/longcat2api:0.1.1(国内可用 ghcr.nju.edu.cn / ghcr.1ms.run / ghcr.dockerproxy.net 前缀)
不用升级也能用
0.1.0 上面板本来就能用,只是没提示:把 LONGCAT_API_KEY 填进输入框 → 点「保存并刷新」即可。
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)
注意
仅供本人账号、本机/私有环境自用。请勿批量注册、对外售卖额度或二次分发。
非官方客户端可能违反上游条款,账号风险自担。