Qoder 模型接入 dingminhua/dsh-connect-qoder

dsh-connect-qoder

把 Qoder（通义灵码国内版 / 国际版）的模型接入 DeepSeek Harness，并提供账号池、每日签到、积分读数与模型管理。

English ·安装 ·工作原理 ·配置 ·账号池 ·更新日志 ·问题反馈

一个独立的 DeepSeek Harness (DSH) 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 之下再把正文分成三栏。账号栏是账号池、积分读数开关与关于凭据的每一条说明（点一下即生效）；模型栏是勾选、上下文档位、思考强度与逐模型测试（草稿，点「保存」才落地）——两者的提交语义本来就不同，分开之后保存按钮就挨着它保存的东西。切栏不重新拉取、不丢未保存的草稿（非活动栏仍挂载）。诊断栏是一张只读的事实表：区域、上游域名（与真正发请求的主机名同一处事实）、服务账号、凭据来源、积分读取时刻、目录模型数、已启用数、账号池开关，以及上游最近一次错误的原文——它存在的唯一理由是被整段贴进问题反馈，所以里面没有任何会改设置的控件。
- 可单独关闭任一版本供应商 —— 每个 tab 右侧有一个勾选框（默认都勾选）。取消勾选即把该供应商从 DSH 模型选择器里彻底撤掉（不是只藏起 tab）：它的路由与「设置 → 模型」页的目录条目一并摘除。PAT、用量与勾选全部保留，重新勾选即完整恢复。注意：若某会话此前选中的正是被关闭供应商的模型，该会话再调用会报 NO_ADAPTER。
- 模型管理 —— 从上游刷新完整模型目录，逐项勾选启用或禁用；模型行显示倍率（(0.50x)）、上下文/输出上限、思考强度档位与免费标记，行右有「图片」「可关闭思考」开关、上下文档位选择器与「测试」按钮。勾选状态写入本地配置，立即同步到模型选择器。目录里有几个模型就排几行，列表自己不设高度上限、不出内滚动条——这条列表的用途是「看见并勾选模型」，只露七八行、把其余的藏进第二条滚动条（面板本身已经在滚）会让「有这个模型吗」变成一个需要先发现、再去拖的动作；要看全就滚页面。上游的 auto 不列出来：它是该区的默认路由，网关在请求时才决定把它解析成哪个模型，所以价格与上下文都由别人临时决定，插件无法如实描述——它不是模型，不该占一行让你勾选。

- 活动优惠徽标 —— 上游在模型目录里自带活动规则（promotion：文案、时段、时区），模型行就在名字旁画一枚小胶囊，如「错峰 4 折」。文案原样来自上游（中文界面取 badge.zh，英文界面取 badge.en），插件不翻译也不改写；悬停给出上游的说明、时段与时区，以及活动文档链接原文。什么时候画由渲染时刻决定：有上游声明的墙钟时段（支持跨零点、按上游时区算）就按时段现算，没有时段才退回上游的 active——所以夜里读到的目录不会把徽标冻结到第二天早上，早上启动的进程也不会因此整晚不显示；没有活动字段的模型什么都不画。同一枚徽标也画在宿主的模型选择器里（conversation.input.model.label 槽位，issue #12）——选择器才是做选择的地方，与卡片共用同一套判定、文案与样式。取证与判定规则见 docs/PROMO_BADGE.md。

- 模型可用性测试 —— 每个模型行有一个「测试」按钮，直达上游确认该模型此刻能否使用：限流（429）报「被限流」、凭据无效报「凭据无效」、内容审核拒绝报「内容被审核拒绝」、额度耗尽报「额度已耗尽」，其余上游瞬时故障如实分类。探测在后台发起，凭据不会传到页面；结果不写入设置，也不改变你已保存的勾选。它发的是真实请求（会消耗少量上游额度），因此只能按单个模型手工点，没有「测试已勾选」这类批量按钮。
- 每日签到 —— Qoder 有官方每日签到活动（个人用户每天可领 100 Credits，30 天有效）。账号池提供「一键签到所有账号」：逐账号领取、已领过的按幂等处理（不重复领取、不算失败），签到后积分自动刷新。国内版与国际版都已接通（国际版需要本机 Qoder 客户端的设备风控组件，取不到时如实报错而不是假装「今天没有活动」）。
- 活动（只读） —— 卡片在区域作用域内、额度读数之下多一条「活动」列表，逐条列出上游当前下发的活动：每日 100 Credits 签到行（带额度与「可领取 / 已领取」状态）与「1024 创造力集结」「首月订阅 Credits 翻倍」这类 banner（VIEW_DETAILS）。标题与描述原样来自上游（按界面语言取 zh / en，缺哪边用另一边），「查看详情」是真正的链接（上游的 detailUrl，缺失时退回活动落地页）；只读，不签到、不改账号。上游没下发就显示「当前没有活动」，读不到则显示原因（不是装作没有）。此前本插件只读签到用的那一小片活动数据，banner 行被整行跳过（用户实拍 2026-10-25），现已整份读取。
- 积分（只读） —— 账号池逐账号显示剩余积分与最近积分包的到期时间（来自 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.<region>.json（0600），把设置 PAT、环境变量与 vault 账号三源去重合并；卡片可新增（粘贴 pt-…，经 JobToken 交换校验并取显示名，也可自填备注名）/ 改名账号，也可显式选择某一账号服务（regions.<region>.accountId，留空自动按 settings → env → vault 选取）。移出池与删除是两件事：移出池 = 在池表格里取消勾选并保存（凭据留着，随时勾回）；删除 = 池表格行内的「删除」按钮，二次确认后抹掉 vault 里的 PAT 并自动退出池与区域选择（不可恢复；设置/环境变量里的 PAT 不归本插件管，不提供删除按钮）。
- 按实测排序与自动换号 —— 「一键测试所有账号」对池内每个成员发真实请求（目标模型默认自动挑本区域倍率为 0 的免费模型），结果落 $DSH_HOME/.qoder-pool.<region>.json；开启账号池后，聊天流在首字节前按 rankPool（可用性 → 快过期的积分优先 → 到期最近 → 积分高 → id）选出服务账号，失败时依次换下一个可用账号重试，失败回写 live-request 探测。关掉开关则插件不替你选、也不替你换，失败如实报错。上游报额度耗尽必显示：对话路径上一旦上游的业务码命中配额族（110 当日用量 / 113 配额 / 118 Credits 耗尽等），该区域卡片就出现一条「上游报额度耗尽」通知（最近一次时刻 + 业务码，悬停是脱敏后的上游原文）——与账号池开关无关，因为逐账号的 out-of-credit 明细只活在池视图里，池关着时这条通知是那次失败唯一可见的出口（0.7.x 的「今日额度疑似已用尽」胶囊拆掉后留下的缺口）。限流（HTTP 429 短窗）不会被标成耗尽——那是冷却，不是没额度。
- 账号转移（导入 / 导出） —— 按区域把 vault 账号导出为传输文件，预览后按索引导入；跨区域域名（qoder.com.cn / qoder.sh）正向匹配，不匹配的记录计入 skipped。
- 思考强度与上下文预算 —— 上游按模型声明 thinking_config.efforts，卡片只列出真实存在的档位（Qwen 系 low/medium/xhigh、DeepSeek/GLM 系 low/high/max），选定即保存、每个请求自动带上（与 Qoder 客户端同一发送字段，双写顶层与 parameters）；上下文档位同样只来自上游 context_config 声明的档位，未声明时不渲染控件、不编造选项。
- 诚实的模型能力 —— 上游的 is_vl 是平台的图片输入声明而非模型原生能力，且它对几乎每个模型都是 true，所以本插件不拿它当能力答案，只认一张按精确 model id 键控的核对表：核对过的才预勾选，没核实的（含全新模型）一律不勾，并在开关 tooltip 里说明「为什么没勾」。表的依据是厂商文档 + 真机实测：2026-10-29 用「发一张画着数字 7 的图、问是哪个数字」逐个测了两个区域目录并集里的全部 14 个模型，全部读图成功，因此当前目录里没有纯文本模型（此前按命名推断的「code 系模型应是纯文本」被实测推翻）。「关闭思考」同样只对上游显式声明、且不在已知拒绝集里的模型提供。宁可少给一个选项，也不要让用户按下去就失败。
- 缓存命中如实上报 —— 上游的 usage 带 prompt_tokens_details.cached_tokens，插件把它一路透传到宿主，所以 GUI 轮次统计里的「缓存命中」是真实比例（修复前这里恒显 0%：字段在归一路径上被丢掉了，那个 0% 是不可信的读数，不是缓存没生效的证据）。命中数是 prompt_tokens 的子集，不是额外增量——所以它不会被加进总数（那会把命中的前缀算两遍）。上游没报这个字段时就不写，不会用 0 顶替「不知道」。
- composer 积分读数（位置可选） —— 会话输入区按区域显示 QD CN / QD AI 与当前计费账号的余额（如 QD CN · 92；池接管时是接管者的余额，悬停写明归属），点开是逐账号的余额表，点某一行即切换到该账号；受每区域「在对话框显示积分」开关控制（默认开，opt-out）。读数可放在两个位置之一（卡片上的二选一下拉，每区域独立，默认不变）：输入框工具栏（conversation.input.left，更近、更易扫一眼）或输入框下方（conversation.composer.dock，即 shell 渲染轮次 / tok/s / token / 缓存命中那一行的常驻栏，读数是追加在自带统计之后）。之所以可选：输入框工具栏是共享的 list 插槽，另一个把东西停在那里的插件可能把读数挤到看不见——此时切到「输入框下方」即可（对齐 workbuddy issue #62）。

- 命令行诊断与现场验证 —— 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 只显示掩码）。

工作原理

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.<region>.pat 或环境变量，见配置），设置项优先。每次会话按需惰性交换 jobToken：PAT 只在这个交换请求里使用一次，之后的对外请求全部携带 cosy bearer（自定义 Base64 载荷 + MD5 签名）与「机器指纹」会话头。PAT 从不进入 pi-ai，也从不外发到网关之外；本插件不读不写 Qoder 桌面端的本地登录文件。 模型侧 cosy 编码与签名细节（自定义字母表、n/3 重排、cosy&<SECRET>&<date> 签名、RSA/AES 会话封装）见 src/cosy.ts 头部注释；错误分类（内容审核 / 限流 / 额度耗尽 / 瞬时故障）与 DSH 重试语义的对应见 src/upstream.ts。

安装

从发布包安装（推荐）

dsh plugin --profile desktop add @dmh2002/dsh-connect-qoder # Desktop
dsh plugin --profile web add @dmh2002/dsh-connect-qoder # Web

装完重启该 profile 的 DSH 进程（bundle 的 host 半边在启动时加载）。也可以在 DSH 的「插件市场 / Bundles」里搜 dsh-connect-qoder 一键安装。

dsh 命令报 Cannot find module .../DSH NEXT.app/...？ 那是宿主换代留下的旧 shim：宿主 app 目录名已从 DSH NEXT.app 变为 DeepSeek Harness.app，而 ~/.local/bin/dsh 仍指向被移除的旧路径。把 shim 改指新宿主自带的 CLI 入口即可：

exec "/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" "$@"

新入口内部以 ELECTRON_RUN_AS_NODE 运行 app.asar 里的 dsh/lib/bin.js，profile 仍由 --profile 决定。

npm 包名带 @dmh2002/ 作用域。插件在 DSH 内的配置标识不带作用域——设置命名空间、/plugins/dsh-connect-qoder/… 路由与命令行程序名都仍是 dsh-connect-qoder，所以 0.2.0 之前装过的用户升级后配置照旧生效，不用重填 PAT。但浏览器 bundle 的模块 id、以及设置卡片两个槽位的 key 都按带作用域的包名建（plugins.bundle.config 用裸包名，plugins.row.config 用 <包名>#<行 id>，行 id 仍不带作用域），这几处由构建期从 package.json 注入，改包名不会漏下它们。

从源码构建（开发）

git clone https://github.com/dingminhua/dsh-connect-qoder.git
cd dsh-connect-qoder
pnpm install
pnpm run check # typecheck + test + build 全绿后再安装

以 link: 安装进当前 profile，改码后重启 DSH 即生效（不会重装依赖树）：

dsh plugin --profile desktop add /Users/dmh2002/DshProject/dsh-connect-qoder

验证安装

- 打开「设置 → 插件」应能看到 dsh-connect-qoder 的配置卡片（国内版 / 国际版两个 tab）。
- 在该 profile 目录里 pnpm exec dsh-connect-qoder doctor 应输出两个区域的 PAT 状态与指纹派生。
- 配置 PAT 后，「从 Qoder 刷新」应拉出该区域的真实模型清单；模型选择器出现 Qoder / Qoder Global 两个分组。

配置

PAT（Personal Access Token）

在 Qoder 账户设置里创建 PAT（pt-… 开头）。两种提供方式，设置卡片优先于环境变量：

| 区域 | 发证入口 | 设置项 | 环境变量 |
| 国内版（qoder.com.cn） | 控制台 → 设置 → API 令牌 | 卡片「国内版」tab → 添加 PAT | QODERCN_PERSONAL_ACCESS_TOKEN |
| 国际版（qoder.sh） | 控制台 → Settings → Personal Access Tokens | 卡片「国际版」tab → 添加 PAT | QODER_PERSONAL_ACCESS_TOKEN |

- PAT 只保存到本地插件配置（regions.<region>.pat），从不上传、不进入任何网络请求。
- 未配置 PAT 的区域不列出任何模型；doctor 命令会指出哪个区域缺 PAT。
- 逐步操作说明见 docs/PAT.md（含创建流程、验证机制、优先级与常见问题）。

区域启停

卡片每个 tab 右侧的勾选框控制该区域是否参与模型选择（opt-out：显式取消勾选才停用）。停用只摘除路由与目录条目，配置全部保留。

多账号池与凭据来源

除设置 PAT 与环境变量外，每区域还有一个本地 vault（$DSH_HOME/.qoder-accounts.<region>.json，权限 0600）保存多个 PAT 账号。三源按 settings → env → vault 的优先级去重合并（同一个 PAT 只在最高优先级的来源里列出一次）。

- 卡片可新增（粘贴 pt-…，经 JobToken 交换校验并取回显示名，也可自填备注名）/ 改名 vault 账号，也可显式选择某一账号服务（regions.<region>.accountId，留空自动）。删除 vault 账号在池表格的行内「删除」按钮（需二次确认）；取消勾选并保存只是把它移出轮换，PAT 仍留在本地。
- 选中的凭据只用于会话的 jobToken 交换与后续 cosy 请求，从不进入 pi-ai 或页面。
- logout [--region cn|global] 会清除指定区域的 vault 账号与账号池测量副本（$DSH_HOME/.qoder-accounts.<region>.json 与 .qoder-pool.<region>.json）。
- 勾选成员、一键签到、一键测试与自动换号的规则见账号池。

账号池

一台机器上往往有多个 Qoder 账号（多个 PAT）。账号池把这些账号收成一次点击：勾进池子，然后「一键签到所有账号」或「一键测试所有账号」；再打开启用账号池，插件就会在请求失败时自动换号接着跑。
每个区域（国内版 / 国际版）各有独立的一池：成员、目标模型、积分与签到状态互不影响——两边的账号本来就属于不同的服务商。两个区域都有每日签到：国际版的签到活动只下发给带设备风控头的请求，插件按区域读取本机 Qoder 客户端自带的设备身份组件；取不到时如实报错，不会把「拿不到设备身份」伪装成「今天没有活动」。

自动换号（开启账号池即生效）

- 谁来服务由排序决定：开启后每一次请求都发给池内排序最靠前的可用账号，所以「当前使用」显示的是排序的结果，不一定是你手动选的那个。
- 失败时继续往下试：某个请求在上游失败时，插件依次用池内其他可用账号重试，直到有一个接手、或全部不可用为止才把错误报出来。
- 哪些失败会换号：429 限流、额度耗尽、401/403 凭据被拒、5xx 网关与网络故障——这些都是某个账号的状态，换一个很可能就过了。
- 哪些不会：请求本身不合法（HTTP 400）——同一个请求体换谁都是同样的 400，重试只是让你多等几轮；流已开始之后也不会重放（字节已经发出去了）。
- 已知不可用的账号会被跳过：处于限流冷却期内、或凭据已被上游拒绝的成员不参与选择。从没测过的账号按「默认可用」参与——刚添加的账号不该因为「还没测」就被排除。
- 手动选择从不被改写：池子通过运行时覆盖决定「谁服务」，不写回你保存的选择；关掉开关，你选定的账号立刻完全生效。
- 失败会被记下来：一次失败会写成该账号的测量（含上游报文中给出的恢复时间），下一个请求直接从可用账号开始，不必每次先撞一遍同一个限流账号。
- 换号会告诉你：换号是插件替你做的决定，所以它会说出来——回答开头带一条引用块提示，例如 > [dsh-connect-qoder] 「450702134816」被限流，已改用池中另一个账号回答。。提示说的是失败的那个账号（你选中的那个），不点名接管者；连换多次只写一条，说的是紧邻换号的那次失败。没换号就一个字都不写。

这个开关到底控制什么

它只控制「插件要不要自己决定」，不控制「你能不能操作」。

| | 账号池 开启 | 账号池 关闭 |
| 谁服务 | 由排序自动选出（可用优先 → 积分包快过期 → 到期最近 → 积分高 → id） | 你在设置区的「使用哪个账号」里选定 |
| 请求失败 | 自动换下一个可用账号重试 | 不换号，如实报错 |
| 一键签到 / 一键测试 | 可用 | 仍然可用 |
| 目标测试模型 | 可改 | 仍然可改 |

最后两行是刻意的：签到与测试是手动动作，作用于你勾选的成员，与「插件是否自动路由」是两件事。

唯一的硬约束：池里一个成员都没勾选时，批量动作一律拒绝。空的池绝不退化成「那就对全部账号执行」——那是唯一会花掉你没授权过的积分的解读。

重试预算可以调（regions.<region>.retry）

宿主有一个「原地重试」环：一次请求失败但值得再试时，它等一小段时间再发一次。等待阶梯由插件声明、宿主执行，默认跟随宿主（不填就是宿主的默认值，升级不会改变你现在的行为）。

Qoder 上游偶尔会回 RESOURCE_LIMIT（业务码 10605）并自己申报「请等 N 秒再来」。插件现在会把这个值写进给宿主的失败文案（形如 [upstream retry-after 5s]），你能直接看出上游只要求等多久，而不是只看到「上游报了个 4xx」。

想改预算就配这三个数字（都在区域级，两个区域各配各的）：

regions:
cn:
retry:
maxRetries: 4 # 最多重试几次（0 = 跟随宿主默认） initialDelayMs: 5000 # 首次退避毫秒（0 = 跟随宿主默认） maxDelayMs: 30000 # 退避上限毫秒（0 = 跟随宿主默认）

上面的 5000 → 30000 兼顾了上游两种常见形态：瞬时限流（申报 5 秒）与 queueType:p2 排队（约 30 秒）。三个 0 表示跟随宿主默认，所以留空与不写这个配置等价。

此前这一项只能是宿主的默认值，想调就得改 node_modules 里的构建产物 —— 而那会在升级时静默还原。

排序规则（开启账号池后决定谁服务）

1. 可用优先 —— 被测量判定为不可用（限流未到恢复时间、凭据被拒等）的排到最后；
2. 积分高者优先 —— 只在有新鲜读数时参与（卡片轮询、批量测试或保存时读到的那份，10 分钟内有效）：请求路径不会为了排序去打上游，否则一页对话就变成 N 个额外请求；
3. 快过期的积分包优先 —— 3 天内到期的先花，过期即作废；
4. 最后按账号 id 收尾，保证顺序是全序、可复现。

两个批量动作

- 一键签到所有账号 —— 逐个账号领取当日的官方签到活动。先查状态再领取，已领过的直接标「已签到」而不发写入请求（幂等，不重复领取）；任何单个账号失败只标记该行，不中断整批。签到会改变余额，因此批次结束后作废该区域的积分缓存，卡片不会继续显示领取前的数字。
- 一键测试所有账号 —— 对每个成员发一次真实请求，得出「这个账号此刻能不能用这个模型」。目标模型默认由「自动」挑本区域倍率为 0 的免费模型（多个候选取上下文窗口最大的），你也可以显式指定——但在免费模型出现之前测试保持关闭，避免在你不知情的情况下花掉积分。测试走的是与模型行同一套探测，因此有真实成本。

两种批量动作都不锁住界面：按钮自己变成「签到中… / 测试中…」，每处理完一个账号，那一行立刻落位、活动日志也逐条写下（时间戳是各自完成的那一刻，不是整批结束的那一秒）；其余界面照常可用。只有保存配置与删除账号会挡一道——前者在写盘、后者不可逆。

设置卡片的排布：顶部是两格独立的服务商卡片（国内版 / 国际版），每格自带边框与底色、右端有自己的开关，选中的那格描品牌色边——一格就是一个单位，点名字切 tab、点开关启用该服务商。再往下是「在对话框显示积分」与「显示位置」两行（整行可点，主标题下一行是说明），然后是账号池、模型管理。那两行管的是积分读数显不显示、显示在哪里，立即生效，不需要点保存。

不提供自动签到：签到会真实领取奖励，只在你点按钮时执行。

命令行诊断

在已装本插件的配置档目录里跑（推荐，无需全局安装）：

cd ~/.dsh/profiles/desktopbash
pnpm exec dsh-connect-qoder doctor # PAT 来源 + cosy 指纹派生 + pi-ai 代际 + 心跳 + vault 计数（纯本地，不发请求）
pnpm exec dsh-connect-qoder status # 每区域凭据来源 + 上游模型目录可达性 + 剩余积分（需 PAT）
pnpm exec dsh-connect-qoder logout --region cn # 清除指定区域的 vault 账号与账号池测量副本
pnpm exec dsh-connect-qoder doctor --json # 机器可读输出

status 会真实交换一次 jobToken 并拉取模型目录（随后只读查询一次用量），因此需要对应区域的环境变量或 vault PAT；doctor 完全离线。

两条实测过的注意事项：
1. 别用 node node_modules/dsh-connect-qoder/lib/bin.js 这种裸路径——0.3.0 起包名带作用域，软链在 node_modules/@dmh2002/dsh-connect-qoder，写旧路径只会得到 MODULE_NOT_FOUND（缺的是入口文件，不是 peer）。
2. CLI 依赖宿主提供的 peer 包（@deepseek-ai/dsh-atomic-write / dsh-home-paths）。本机实测：pnpm 会随包把它们装进 profile 的依赖树，pnpm exec 与 npm 装的 tarball 都能跑通。但这取决于 pnpm 版本与 auto-install-peers 配置——如果在你机器上报 Cannot find package '@deepseek-ai/dsh-atomic-write'，那是这一层没装上；设置卡片与 provider 不受影响（它们在宿主进程内，宿主自己解析这些名字）。同族 workbuddy 的 issue #47 是同一个形状，其修复方案（宿主优先、按需回落自带实现）适用于本项目，尚未移植。

平台支持

| 平台 | 状态 |
| macOS | ✅ 已验证（开发与 CI） |
| Windows | ✅ CI 测试通过（上游请求走标准 fetch，无平台专属路径） |
| Linux | ✅ CI 测试通过 |

受支持的宿主范围

| 宿主 | peer 范围 |
| DSH（@deepseek-ai/） | >=0.1.7-rc.1 <0.2.0-0 \|\| >=0.2.0-rc.1 <0.3.0-0 \|\| >=0.2.1-rc.1 <0.3.0-0 |
| @earendil-works/pi-ai | >=0.85.0 <0.88.0 \|\| >=1.0.0 <2.0.0 |
| Node.js | ^22.19.0 \|\| >=24.0.0 |

范围由 tests/dsh-line.spec.ts 强制。DSH 至今只发预发布，而 node-semver 只有当范围里某个比较符与该版本的 major.minor.patch 元组完全一致、且自身也带预发布标签时，才会放行预发布版本。所以每开一条新线就得加一条分支：只写 >=0.1.7-rc.1 <0.3.0-0 会静默排除整条 0.2.0-rc.（0.2.0-rc.2 曾是 latest），同理 >=0.2.0-rc.1 这一支不含 0.2.1-rc.1（桌面端 0.2.1-rc.1 已发布）。上界仍须带 -0（<0.3.0 不挡任何东西）。

两套语义并存（1.1.2 实测更正）：npm / pnpm 安装走 node-semver 标准语义，新补丁号的 rc（如 0.2.2-rc.1）确实仍需手工追加一条分支 —— UNGATED_PRERELEASES 就是这份可见的待办表。但宿主的插件兼容门禁不是标准语义：dsh-app-boot 用 semver.satisfies(v, range, { includePrerelease: true })，在这个语义下 >=0.2.1-rc.1 <0.3.0-0 一支就覆盖整条 0.2.x 线（0.2.2-rc.1、0.2.9 都放行），0.3.0-rc.1 仍被上界拦住。1.1.0/1.1.1 曾断言「没有任何静态范围能覆盖任意 0.2.x 预发布」，那句话只对 npm 成立，对宿主门禁不成立，已更正。GA 版本（如 0.2.1）对既有分支本来就判 true。

pi-ai 单独列一行是因为它换了主版本：0.2.1-rc.1 宿主把 pi-ai 从 0.85 换到 1.x，而两代的上下文契约不同（1.x 在 Models 层归一化）。声明与检测必须一致，否则就是 1.1.0 修掉的那个静默丢工具缺陷 —— 详见 docs/DSH-0.2.1-RC1-FOLLOWUP.md。

当前宿主基线：0.2.1-rc.3（2026-10-24 实测）

宿主升到 0.2.1-rc.3（DeepSeek Harness.app，nightly 通道；app.asar 内全部 @deepseek-ai/dsh-* 均为 0.2.1-rc.3，内置 pi-ai 1.1.0）。本插件不需要任何运行时代码改动，理由逐条如下：

| 检查项 | 结论 |
| 插件依赖的宿主包（dsh-llm / dsh-llm-pi-ai / dsh-settings / dsh-atomic-write / dsh-attachment / dsh-host-webserver / dsh-home-paths / dsh-client-ui-slots / dsh-client-ui-settings / dsh-client-ui-settings-plugins / dsh-client-ui-renderer / dsh-client-locale） | 与 rc.2 逐字节相同（仅 package.json 的版本号不同） |
| rc.3 的客户端改动 | 全部增量：View 标签页置顶与 conversation.session.header.views.actions 新槽位、草稿接管新增 whenDraftExists（replace / append / keep）、primitives 的 Tooltip 支持 left 与自动翻转、Menu 新增 current 与 minWidthFromAnchor、新增两个图标。插件用到的槽位与 owner props 没有一条被改动 |
| peer 范围 | >=0.2.1-rc.1 <0.3.0-0 在 npm 标准语义与宿主门禁语义下都放行 0.2.1-rc.3（宿主门禁用 includePrerelease: true，覆盖整条 0.2.x 线） |
| 插件在 rc.3 上的实际加载 | Config 目录里 include:dsh-connect-qoder 状态 schema；客户端 conversation.input.model.label 槽位由 dsh-connect-qoder-client（priority -1）占据，conversation.input.left 槽位有 dsh-connect-qoder-composer-credits —— 宿主 dsh plugin list 不再对本插件报兼容性告警 |
| 回归 | pnpm run typecheck 与 pnpm test（948 passed / 8 skipped）全绿 |

rc.3 带来的环境变化（不是插件的问题）：宿主 app 目录名从 DSH NEXT.app 变为 DeepSeek Harness.app，旧路径上的 dsh shim 会失效 —— 见安装一节的说明。

安全说明

- PAT 只写入本地插件配置（或环境变量），从不进入任何网络请求；对外请求一律使用 cosy 会话令牌（jobToken）+ 机器指纹头。
- 本地 shim 用随机端口的 loopback 服务 + 进程内 secret 鉴权，并校验 Host / Origin / Content-Type，请求体有 64MB 上限。
- 本插件只读你显式提供的 PAT；不读取、不修改 Qoder 桌面端的本地登录/凭据文件。
- 诊断输出（doctor / status 与卡片探测）均脱敏，不打印任何令牌样式的字符串。

市场收录与展示

本插件声明了可安装的 dsh.bundle manifest（dsh.bundle.patch: ./cordis.patch.yml），因此可以用 dsh plugin add 安装。社区市场通常从 Awesome DSH Plugin 注册表同步条目；仓库内的提交草稿位于 awesome-dsh-plugin-submission/dingminhua__dsh-connect-qoder.yml。

收录目录规范（依据 contributing.md）：

- 每个插件一个 YAML：data/plugins/<owner>__<repo>.yml，字段为 url（与仓库地址完全一致）、name（owner/repo）、category（有效值之一，本项目为 model）、description.en（必填，以句号结尾）/ description.zh（可选）；描述中含 : 必须加引号。
- 仓库需声明 dsh.bundle manifest、被 dsh-plugin topic 标记、创建满 1 天且处于活跃维护；描述必须属实、不带营销词——它会被逐条对照代码核对。
- 注册表的两个 README 由脚本生成，不得手工编辑；修改 YAML 后在其仓库执行 npm ci + node scripts/generate-readme.mjs 重新生成。
- 一个 PR 最多收录 3 条；只改自己的条目。

市场卡片中的截图与 GitHub README 徽章是两套机制：

- 市场截图按当前约定由插件自己仓库根目录的 screenshots.json 声明（本项目声明了 screenshots.json）；注册表的 data/screenshots.json 是旧约定下的回退，不再添加新键。
- GitHub 徽章由本 README 顶部的 Shields 图片链接生成；市场图标/占位图由具体市场的展示规则决定，不是 npm 字段，也不是 README 徽章。

已知限制

- 依赖 Qoder 的 cosy 网关与 sash 接口（非官方开放 API），上游变动后插件可能需要随之调整。协议行为参照 Zhengyuuuui/qoder2api，本项目独立实现，不复制其源码。
- 每日签到是 Qoder 面向个人用户的运营活动（企业版账号不参与），规则与额度以官方为准；国际版的签到活动要求请求带本机 Qoder 客户端的设备身份，因此未安装 Qoder 客户端的机器上国际版签到不可用（插件如实报错，不静默降级）。
- 图片输入与「可关闭思考」按已核实的清单给出：清单外的模型一律不预勾选，因此某些其实可用的模型可能需要你手动勾一次。图片开关是白名单——保存过一次选择后，未勾的模型就是关着的；把勾全部取消再保存，它们会保持关闭，不会被默认值重新打开。
- 模型可用性测试与批量测试都会发出真实请求，会消耗少量上游额度；没有「测试已勾选」这类批量按钮，批量动作只作用于你显式勾选进池的账号。
- 独立命令行依赖宿主提供的 peer 包（@deepseek-ai/dsh-atomic-write / dsh-home-paths）。本机实测：pnpm 会随包把它们装进配置档的依赖树，pnpm exec dsh-connect-qoder … 与 npm 装的 tarball 都跑得通；但这取决于 pnpm 版本与 auto-install-peers 配置，若报 Cannot find package '@deepseek-ai/dsh-atomic-write' 就是这一层没装上。服务商注册、设置卡片与对话都不受影响（它们在宿主进程内，宿主负责解析这些名字）。同族 workbuddy 的修复方案（宿主优先、按需回落自带实现）适用于本项目，尚未移植。

免责声明

- 本项目仅供个人学习和研究使用，仅驱动使用者自己的 Qoder 账号在本机调用，请勿用于商业用途或超出个人合理使用的场景。
- 使用者需遵守 Qoder / 通义灵码的服务条款；因使用本项目产生的任何后果（包括但不限于账号被限制、额度被清空、服务中断），由使用者自行承担。
- 本项目作者不对任何因使用或滥用本项目产生的直接或间接损失负责。
- 本项目与阿里巴巴、通义灵码、Qoder、DeepSeek 均无关联，未获其授权或认可；文中出现的名称仅用于描述兼容关系，其商标权利归各自所有。

致谢

本项目建立在他人已公开的工作之上，详见 THIRD_PARTY_NOTICES.md：

- Zhengyuuuui/qoder2api：cosy 协议 wire behavior 的参照实现（编码、签名、会话、指纹、jobToken、SSE 形状、错误分类）。本项目按其行为独立实现为 TypeScript，不复制其源码；该仓库未附独立 LICENSE，其 README 声明源自 wangtufly/QCCG（GPL-3.0）。
- L0NE-6/Qoder-Daily（MIT）：每日签到的协议参照（campaigns / claim 形状、幂等判定、国际版设备风控思路）。本项目按其文档与本机实测行为独立实现，不复制其源码。
- dingminhua/dsh-connect-workbuddy（MIT）：插件工程结构、卡片交互模型、loopback shim 模式与 npm 发布工程的基准。
- dingminhua/dsh-connect-trae（MIT）：经 workbuddy 转引的卡片外观与发布工程基准。
- franksong2702/dsh-codex-connect（Apache-2.0）：经 workbuddy 转引的 DSH 插件结构与 pi-ai 服务商注册参照。
- Qoder 官方 SDK 的类型定义：仅用于 usage/头的形状核对，不随本项目分发。

License

MIT © LaoDing —— 详见 LICENSE。