把 Qoder(通义灵码国内版 / 国际版)的模型接入 DeepSeek Harness,并提供账号池、每日签到、积分读数与模型管理。
English · 安装 · 工作原理 · 配置 · 账号池 · 更新日志 · 问题反馈
一个独立的 [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness) bundle 插件。它把 Qoder 账号的模型接到 DSH 的模型选择器,同时提供模型管理与只读的用量概览。**国内版与国际版是两个并行的供应商(`qoder` / `qoder-global`),可同时使用**;插件设置卡片以 tab 区分两者,方便统一管理。 > Qoder 官方不提供 OpenAI 兼容端点(其官方 SDK 只是 agent 启动器),因此本插件直连 Qoder 的 cosy 网关,实现了协议的最小客户端,无需在 Qoder 桌面端登录——只需一个 PAT(Personal Access Token)。 ## 功能特性 - **双供应商并行接入(国内版 + 国际版)** —— 国内版注册为 `qoder` provider(`gateway.qoder.com.cn`),国际版注册为 `qoder-global` provider(`api1.qoder.sh`)。**配置了 PAT 的区域其模型会出现在 DSH 模型选择器里**:两个区域都有 PAT 时两组同时可选,不同会话可以各选一边,互不干扰。**没有 PAT 的区域不列出任何模型**(一个请求也发不出去,列出来只会点到就失败);配置 PAT 后「刷新模型」即可让模型自动出现——provider 本身始终注册着,因为它的设置卡片正是配置入口。模型名内嵌上游积分倍率(如 `Qwen3.8-Flash · x0.00`),与 Qoder 自身模型菜单一致。
- **插件卡片 tab 切换** —— 设置卡片顶部为「国内版 / 国际版」两个 tab,各含独立的 PAT、模型管理与用量概览;每个 tab 的目录、勾选与状态完全隔离。
- **可单独关闭任一版本供应商** —— 每个 tab 右侧有一个勾选框(默认都勾选)。**取消勾选即把该供应商从 DSH 模型选择器里彻底撤掉**(不是只藏起 tab):它的路由与「设置 → 模型」页的目录条目一并摘除。PAT、用量与勾选**全部保留**,重新勾选即完整恢复。注意:若某会话此前选中的正是被关闭供应商的模型,该会话再调用会报 `NO_ADAPTER`。
- **模型管理** —— 从上游刷新完整模型目录,逐项勾选启用或禁用;模型行显示倍率(`(0.50x)`)、上下文/输出上限、思考强度档位与免费标记,行右有「图片」「可关闭思考」开关、上下文档位选择器与「测试」按钮。勾选状态写入本地配置,立即同步到模型选择器。
- **模型可用性测试** —— 每个模型行有一个「测试」按钮,直达上游确认该模型此刻能否使用:限流(429)报「被限流」、凭据无效报「凭据无效」、内容审核拒绝报「内容被审核拒绝」、额度耗尽报「额度已耗尽」,其余上游瞬时故障如实分类。探测在后台发起,**凭据不会传到页面**;结果不写入设置,也不改变你已保存的勾选。**它发的是真实请求**(会消耗少量上游额度),因此只能按单个模型手工点,没有「测试已勾选」这类批量按钮。
- **每日签到** —— Qoder 有官方每日签到活动(个人用户每天可领 100 Credits,30 天有效)。账号池提供「一键签到所有账号」:逐账号领取、已领过的按幂等处理(不重复领取、不算失败),签到后积分自动刷新。国内版与国际版都已接通(国际版需要本机 Qoder 客户端的设备风控组件,取不到时如实报错而不是假装「今天没有活动」)。
- **积分(只读)** —— 账号池逐账号显示剩余积分与最近积分包的到期时间(来自 Qoder 的 `sash/api/v2/me/usage`,凭 `jt-` jobToken 查询);临期的积分包会高亮。查询是**只读**的、不消耗积分;读不到时(凭据被拒 / 上游未响应)如实说明原因并给出路,不留一片空白。
- **安全 loopback shim** —— 每区域一个随机端口 + 进程内随机 secret,真实 Qoder PAT **不交给 pi-ai**:pi-ai 只与本地 shim 对话,shim 用 cosy 会话(jobToken)做上游请求。
- **多账号池(PAT)** —— 每区域一个本地 vault `$DSH_HOME/.qoder-accounts.
- **命令行诊断与现场验证** —— `dsh-connect-qoder doctor|status|logout [--json] [--region cn|global]`:`doctor` 报 PAT 来源、cosy 指纹派生、pi-ai 代际、宿主心跳存活与 vault 账号计数;`status` 报凭据来源、上游可达性与当前剩余积分;`logout` 清除指定区域的 vault 账号与账号池测量副本。另有 `pnpm run probe:cosy`(不依赖宿主直连 cosy 链路验证)与 `pnpm run probe:vault`(只读 dump vault / 账号池测量,PAT 只显示掩码)。
## 工作原理
```text
DSH PiAiAdapter(每个 provider 一套)
-> 安全 loopback shim(每区域一个随机端口 + 进程内随机 secret)
-> QoderUpstreamClient(cosy 协议最小客户端)
-> 国内版 https://gateway.qoder.com.cn/algo/api/v2/...
-> 国际版 https://api1.qoder.sh/algo/api/v2/...
-> Qoder SSE(OpenAI 形状增量)
-> DSH 本地执行工具并回传结果
```
国内版与国际版各持一套完整的运行时栈——上游客户端、模型 catalog、回环 shim、adapter——按区域配置(网关 / openapi / 目录路径)隔离,所以**两个区域的模型可以同时可选、被不同会话使用**。
凭据是 PAT(设置卡片 `regions.