Qoder 服务商 CARVIN94/dsh-router-qoder

dsh-router-qoder

dsh-router 的 Qoder 族服务商插件（国内版 + 国际版）

快速安装 ·两个供应商 ·取 PAT ·能力 · dsh-router 核心

为 dsh-router 提供 Qoder（阿里 AI 编码平台）的两个服务商（PAT 认证，cosy 签名网关）。单独装它没用——它只是向核心注册服务商，面板、账号池、组合回退、模型管理都在核心里。

两个供应商

| 供应商 id | 面板名 | 网关 | openapi | uid 前缀 |
| qoder | Qoder | gateway.qoder.com.cn | openapi.qoder.com.cn | qd |
| qoder-global | Qoder Global | api1.qoder.sh | openapi.qoder.sh | qdg |

两个区域同协议同契约（cosy 签名、jobToken 交换、同一套 chat/models 端点），所以共用同一份实现（src/core.ts），差异只在 src/cn.ts / src/global.ts 的 profile 与 QODER_REGIONS 的主机表。

两个 id 同时是凭证与配置的存储键（credentials.sqlite 的 supplier 列、 supplier-config.json 的键）——改 id = 已添加的账号全部消失。

src/
core.ts 共享实现 —— 供应商契约、账号/积分缓存、chatOnce、签到、addApiKey cosy.ts cosy 协议原语 —— 自定义 base64、请求签名、RSA/AES 会话、设备指纹 messages.ts OpenAI 请求 → Qoder 请求体（模板 + 消息/工具转换） upstream.ts Qoder HTTP 客户端 —— jobToken 交换、模型目录、SSE 聊天、用量、活动/领取 sse.ts Qoder SSE → OpenAI SSE（核心只接受 OpenAI 格式的字节） cn.ts qoder profile（区域、图标、uid 前缀、弹窗提示文案） global.ts qoder-global profile icon.ts 内联 SVG data URI（面板图标不依赖另一个服务活着） index.ts 插件入口（host 半，一次注册两个供应商） contract.ts 供应商契约（自含，与 dsh-router 契约同步，含 addApiKey/apiKeyHint） types.ts 通用类型 cordis.patch.yml bundle patch，把插件插入 DSH cordis bundle stack

与 CodeBuddy 族的两处不同

1. 认证是 PAT，不是 OAuth。 粘贴一个 pt-… 就完事，没有浏览器登录、没有回调、没有 refresh token。所以本插件实现的是契约里的 addApiKey 那条路，不是 generateLoginUrl/completeLogin。添加时会真的交换一次 jobToken 校验——打错一个字符的 PAT 不会存进去。
2. 上游不是 OpenAI 兼容端点。 Qoder 官方没有 OpenAI 兼容接口，chat 直连它的 agent_chat_generation：请求体是私有模板 + cosy 编码加密，响应是「信封套一层 OpenAI 形状」的 SSE。sse.ts 把这层拆开重新包成 OpenAI SSE 交给核心。

快速安装

需要 DSH 0.2.0 及以上。先装核心，再装本插件，然后重启 dsh web：

dsh plugin --profile web add dsh-router-core
dsh plugin --profile web add dsh-router-qoder

dsh plugin add 会在 profile 里 pnpm add，并自动把声明了 dsh.bundle.patch 的包加入 dsh.profile.bundles（本插件即声明了，即 cordis.patch.yml）。

本地开发版：不用 npm，直接 dependencies 加 "dsh-router-qoder": "link:/path/to/dsh-router-qoder" 指向本地仓库（本机 profile 就是这么装的，改完 pnpm build 再重启 dsh web 即生效）。

重启后本插件以 cordis service router.suppliers 向 dsh-router 注册两个供应商，面板「供应商」出现 Qoder 与 Qoder Global 两张卡片。

能力

| 能力 | 说明 |
| 添加账号（PAT） | 弹窗粘贴 pt-…。先交换 jobToken 校验，成功才落盘，昵称取上游下发的账号名；同一 PAT 不会重复建号。粘贴时带 Bearer 前缀也能识别（会被剥掉）。 |
| 模型列表 | 「获取模型」从 GET /algo/api/v2/model/list 实时拉取。面板显示上游的 display_name、请求仍用上游 key（对照表见使用）。上游的 auto 不列出来：它是该区的默认路由（请求时才决定解析成哪个模型），不是可描述的模型。没有 PAT 时列表为空——这是正确状态，不是故障。 |
| 对话 | 直连 cosy 网关：请求体走 Qoder 私有模板（chat_context/model_config/business/session_id），body 经自定义 base64 加密后参与签名；响应 SSE 转成 OpenAI SSE（含 reasoning_content、tool_calls、usage、[DONE]）。usage 里的 prompt_tokens_details.cached_tokens 原样透传，宿主的缓存命中率因此是真实读数。 |
| 图文输入 | 请求里出现 image_url / input_image 时把 model_config.is_vl 置真，否则置假——图片能力按这次请求决定，不靠一张静态能力表。 |
| 思考强度 | 核心给的推理等级按上游约定的两处同时写（顶层 reasoningEffort + parameters.reasoning_effort）——官方客户端如此，只写一个可能被某个区域忽略。auto/空/none/off 一律不下发，用模型自己的默认档。 |
| 积分显示 | 面板账号积分 = sash/api/v2/me/usage 的剩余量（基础包 userQuota + 加量包 addOnQuota + 企业包 orgResourcePackage 的 remaining 求和），内存缓存 10 分钟。读不到报 -1（不是 0），核心据此保留上次持久化的值。 |
| 每日签到 | 走活动接口（/sash/api/v1/me/campaigns → …/{id}/claim），路径里没有「签到」二字。CLAIMED 与 409 都算「今日已领」（幂等，不是失败）；上游今日没下发可领活动时如实说明。 |
| 多账号池 | 核心按池顺序/策略选号回退，本插件只报单个账号的成败与语义状态。 |

取 PAT

本插件只认 PAT（Personal Access Token，pt- 开头）。两个区域各签发一份、互不通用：

| 用哪个卡片 | 控制台 | 入口 |
| Qoder（国内版） | qoder.cn（同 qoder.com.cn） | 设置 → 个人访问令牌（旧页面/旧文档写作「API 令牌」）→ 创建令牌 |
| Qoder Global（国际版） | qoder.com | Settings → Personal Access Tokens → Create token |

创建时填名称（只是给你自己看的备注），有效期按需选；完整令牌只在创建那一刻显示一次，当场复制。漏了就只能删掉重建。

官方原文（令牌格式与作用域说明）：

- 国内版：docs.qoder.cn · 认证
- 国际版：docs.qoder.com · Authentication

三件容易踩的事：

- 国际版的控制台不是 qoder.sh。那只是网关与开放 API 的主机名（api1.qoder.sh / openapi.qoder.sh），没有网页控制台，域名本身也不解析。发 PAT 的是 qoder.com。
- 区域对不上一定被拒：国内版的 pt-… 贴进国际版卡片（或反之）交换 jobToken 就失败，这不是插件坏了、也不是令牌过期。
- 别把令牌提交进仓库或贴进 issue：它等价于你的账号权限，谁拿到都能以你的身份调接口。

使用

1. 重启 dsh web
2. 面板 → 供应商 → Qoder / Qoder Global 卡片 → 添加 API key → 粘贴 PAT （从哪个入口拿见上一节）
3. 点「获取模型」从上游拉目录，勾选要用的模型
4. 请求模型可写 qmodel_38max，或带别名前缀 qoder/qmodel_38max（插件自动剥前缀）

模型名：显示用名字，请求用 key。 上游的 key 是内部标识（qmodel_38max、 kmodel_latest），人读的是它同时下发的 display_name（Qwen3.8-Max、 Kimi-K3.1-Pro）。插件把两者都报给核心：面板、搜索、组合挑选显示可读名，组合里存的与请求里发的仍是 key——拿显示名去请求上游只会 404。
面板每行的 key 以小号淡字跟在名字后面，hover 也有完整说明。

2026-10-28 国内版实测快照（会随上游变，以面板为准）：

| 面板显示 | 上游 key（请求/组合用） | 上下文 | 倍率 |
| Qwen3.8-Max | qmodel_38max | 180K | 0.5× |
| Qwen3.8-Flash | qfmodel | 180K | 免费 |
| DeepSeek-V4-Pro | dmodel | 96K | 0.5× |
| DeepSeek-Flash | dfmodel | 180K | 免费 |
| GLM-5.3 | gmodel | 180K | 0.8× |
| GLM-5.3-Flash | gfmodel | 1000K | 0.1× |
| Kimi-K3.1-Pro | kmodel_latest | 180K | 1× |
| Kimi-K2.8-Preview | kmodel | 180K | 0.8× |
| MiniMax-M3.1-Flash | mmodel | 180K | 0.1× |

命名规律只是巧合（q=Qwen、d=DeepSeek、g=GLM、k=Kimi、m=MiniMax，f 后缀 =Flash、_latest=同族较新），不要照规律猜 key——猜错就是 404。

上游

国内版（https://gateway.qoder.com.cn + https://openapi.qoder.com.cn）：

- chat：POST /algo/api/v2/service/pro/sse/agent_chat_generation?FetchKeys=llm_model_result&AgentId=agent_common&Encode=1
- 模型：GET /algo/api/v2/model/list?Encode=1 → chat[]（key / display_name / max_input_tokens / price_factor / thinking_config.efforts）
- jobToken：POST /algo/api/v3/user/jobToken?Encode=1（旧式签名：date + signature；body 整体 cosy 编码，personalToken 与 refreshToken 二选一）
- sash 令牌：POST {openapi}/api/v1/jobToken/exchange（{personal_token} → token）
- 用量：GET /sash/api/v2/me/usage（sash 面，Bearer <jt-…>）
- 签到：GET /sash/api/v1/me/campaigns?forceRefresh=true → POST …/{campaignId}/claim
- 凭证：核心的 credentials.sqlite，supplier='qoder'，blob 为 {nickname, pat, userId?}

国际版（https://api1.qoder.sh + https://openapi.qoder.sh）—— 路径逐字相同，差异只有一个：sash 面（积分/签到）需要设备风控头（见「已知限制」）。
凭证存在同一张表，supplier='qoder-global'。

与核心的分工

本插件只管对单个账号调通上游：PAT 校验、cosy 会话、chat、模型目录、积分、签到。

策略全在核心（AccountPool）：选号、冷却、禁用、连续错误累计、遍历回退、响应写入。所以：

- chatOnce(uid, lv, req) 一次只服务一个账号，不遍历账号、不维护冷却表、不写响应
- 失败时返回语义状态（rate_limit / quota / session_dead / unavailable / transport / unknown / no_such_model / bad_request），由核心决定冷却多久、是否禁用、要不要换号
- status() 只报「现在状态」（凭证 + 积分），冷却/禁用由核心叠加后给面板
- 积分只报值，不落盘（持久化归核心 supplier-config.json）：拿不到时报 -1 （不是 0），核心保留上次持久化的值
- 非流式请求也走同一条路：本插件只产出 OpenAI SSE，客户端要 JSON 时由核心聚合成整包（协议错配由核心吸收，插件不做第二套出口）

完整契约见 dsh-router 的 docs/suppliers.md。

错误分类（一个重要细节）

业务码优先于 HTTP 状态。Qoder 对「当日用量用尽」回的是 HTTP 403 {"code":"110","Billing daily count exceeded"} —— 只看状态会判成「凭据被拒」，于是「今天用满、明天自愈」的号会被要求换 PAT。所以：

| 上游信号 | 归类 | 后果 |
| code 110/113/115/116/117/118/119/122/402/6004（额度族） | quota | 不判账号死，等周期重置或补额度 |
| code 105 / HTTP 401 / HTTP 403（无业务码） | session_dead | 凭据失效，需要换 PAT |
| HTTP 429 | rate_limit | 短冷换号 |
| code 406 / 内容审核标记 | bad_request | 请求级（同一请求对每个号都一样），不惩罚账号 |
| code 416/430/80411/80412 / HTTP 400 | bad_request | 请求形态问题（范围/能力/过长/媒体过多） |
| code 500/10408/10500/10605 | rate_limit | 瞬时（失败/超时/模型内部错/排队），换号确实管用 |

失败帧会层层套（外层 403 + 内层 10605），所以取码是沿 message 下钻到最深一层认识的码，只剥一层会把「排队一分钟」判成「凭据被拒」。认不出的码继续往里找，最终回落 HTTP 状态分类。

流已经写出字节之后上游才报错（HTTP 200 信封里带业务码）时，插件发一条 OpenAI 形状的 error 帧 + [DONE]，并通过 onLateFailure 把「这个号额度用尽」报给核心——后续请求才会避开它。

已知限制

- 国际版的积分与签到需要本机 Qoder 客户端的设备风控组件（Cosy-Machine 三件套，由 UMID 组件生成）。本插件不伪造它：拿不到时如实报「该区域需要设备组件」，而不是显示「今天没有活动」。国际版的聊天与模型列表不受影响（走 cosy 面）。
- 国内版已用真实 PAT 端到端跑通（2026-10-28 实测）：模型目录 9 条全部带可读名、对话出字（含 reasoning_content 与 usage）、积分读到 400（300 基础 + 100 加量）、活动列表读到当日已领。国际版尚未用真实 PAT 联调——chat 与模型列表与国内版同协议，但设备风控那条只能在你本机试。
- 协议来自社区实测记录（见「致谢」）。单测覆盖编码/签名/请求构造/SSE 转换/错误分类/ 签到状态机；第一次失败建议看 dsh web 日志里 qoder 前缀那几行——它会带上游原文。

架构

通过 cordis service router.suppliers 的共享聚合表向 dsh-router 注册两个供应商工厂：

dsh web (cordis)
├─ dsh-router-core 先 provide 空的 router.suppliers 表 └─ dsh-router-qoder ctx.inject(['router.suppliers']) 等表出现 ├─ 往表里追加 qoder / qoder-global 两个工厂（已存在则跳过，幂等） └─ ctx.emit('internal/service') 让核心重扫 → 面板出现两张卡片

cordis 每个 service name 只允许一个插件 provide，所以这里不能各自 provide，只能等核心先提供表再往里追加；inject + 广播的写法与加载顺序无关，先装谁都能工作。

开发

pnpm install
pnpm build # lib/index.js
pnpm typecheck
pnpm test # 行为回归闸门（node --test，Node 原生 TS 类型剥离）

src/core.test.ts 锁的是协议事实，不是实现细节——那些字节每一个都直接决定网关认不认请求，改错不报编译错、只会得到 401 Signature invalid：

1. cosy 编码/解码可逆、字母表与签名格式逐字固定；
2. 设备指纹对同一凭据稳定、换凭据就变；
3. 添加账号先验一次 jobToken（打错的 PAT 不落盘），重复 PAT 不重复建号；
4. chat 请求是cosy 编码后的密文、带 Bearer COSY. 与 cosy 头；
5. 上游 SSE 信封被转成 OpenAI SSE（含 role/content/usage/[DONE]）；
6. 错误分类：403+code110 是额度耗尽（不是凭据被拒），401 才是凭证失效；
7. 积分读 sash（jt- 令牌）、模型目录过滤上游的 auto 且带上 display_name；
8. 签到走活动接口，CLAIMED 与 409 幂等算成功。

致谢

cosy 协议的实现来自以下 MIT 项目的实测记录（本仓库的 src/cosy.ts / src/messages.ts 移植自第一项，并按本项目风格重写、加注）：

- dingminhua/dsh-connect-qoder（MIT）
- fengyinxia/qoder2api（MIT）—— PAT→jobToken、cosy 签名、自定义 base64、RSA/AES 会话
- x_Zhengyuuuui/qoder2api（Go，MIT）—— 同一协议 + 指纹派生 + 双区域端点
- @qoder-ai/qoder-agent-sdk 的 .d.ts —— 模型/用量字段的官方命名

许可证

MIT

免责声明

本项目仅用于学习与技术研究，请勿用于商业用途。