Skip to content

Releases

v0.3.2 · 妙手账号面板粘贴导入

Choose a tag to compare

@xitihangto xitihangto released this 14 Nov 07:15

妙手账号也能"粘贴"了

之前 LongCat-2.0(妙手)通道的 token 只能靠本机 cmd/login 解密,或者把 accounts.json 从 Mac 拷到 NAS —— 容器化场景很别扭。

0.3.2 起和 longcat 通道一致:面板粘贴即可。

三种粘贴形态都认

  1. 裸 token:AgGF…
  2. 带鉴权头的 Copy as cURL 整段:access-token: / X-Auth-Token: / Authorization: Bearer
  3. 含 "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

Choose a tag to compare

@xitihangto xitihangto released this 14 Nov 07:09

修了什么

升级到 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 消失

修复

  1. 解码前清空 Models.Catalog / Models.Alias,杜绝合并
  2. fill() 改成按名字合并内置目录:保留你的自定义项(缺 provider 补 catpaw),
    再补上内置新增项(LongCat-2.5 → longcat-web);别名以文件为准、缺的补齐
  3. 面板「可用账号」改名「妙手账号」,并说明 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 · 国际站默认 + 双通道 + 轻量登录态导入

Choose a tag to compare

@xitihangto xitihangto released this 14 Nov 06:20

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> → 频道卡片:

  1. ① 打开 longcat.ai(新标签,自己登录)
  2. ② 粘贴 Cookie —— 支持整串 Cookie、Cookie: 前缀、右键 Copy as cURL 整段
  3. ③ 校验并保存 —— 调上游 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

Choose a tag to compare

@xitihangto xitihangto released this 14 Nov 05:31

新增:免费 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

已知限制(务必看)

  1. 网页通道不吃 tools / function calling —— 只能当文本补全用,不能当 agent 后端(Claude Code 那种工具执行要官方 API)。
  2. 游客配额很小:连续十来次就 429 操作太快啦,冷却可能十几分钟。想稳定请填 Cookie。
  3. 上游 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-channel

v0.1.2 · 版本可观测 + 面板 key 提示

Choose a tag to compare

@xitihangto xitihangto released this 14 Nov 04:49

为什么需要这版

上一版排查「/panel?key= 不生效」时,无法判断容器跑的是哪个版本 —— 面板 UI 和 /healthz 都不带版本号,
结果在旧镜像上试新功能,白折腾。

改动

  • GET /healthz(无需鉴权)新增:
    • version:当前网关版本
    • api_key_required:是否启用了 api_key
    • panel_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 · 面板鉴权体验修复

Choose a tag to compare

@xitihangto xitihangto released this 14 Nov 04:40

修复:面板 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 兼容网关

Choose a tag to compare

@xitihangto xitihangto released this 14 Nov 04:17

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

注意

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