DSH Connect Qoder

dsh-connect-qoder

把本机已登录的 Qoder 模型（国内版 / 国际版）接入 DeepSeek Harness，零配置用你的账号额度。

安装 · 工作原理 · 更新日志 · 问题反馈

把本机已登录的 Qoder 模型接入 DeepSeek Harness， 零配置即可在 DSH 的模型选择器里使用你的 Qoder 账号额度。

国内版 Qoder CN 与国际版 Qoder 是两个并行的 provider（qoder-cn / qoder）， 装哪个就出现哪一组模型，两个都装就两组并存，各自使用自己的账号与额度。

输入框旁的用量胶囊：工具栏上的 Qoder CN · 2,222 是区域前缀加主额度剩余 Credits， 点开就是同一份用量面板——套餐内额度与剩余、今日经本客户端的请求数与 token 消耗（含缓存命中）、 7 天用量趋势，以及今日签到状态——与 Plugins 页卡片同款（同一套读数与阈值）。

名册里出现了本机此前没记过的模型时，胶囊会多出第三段 · 3 新模型（没有就不画，宽度与从前 一致），点开面板能看到名字。这个「新」的口径是本机第一次见到，不是上游的上架时间：目录里 没有这个字段，插件能证明的只有「本机上次记下的名册里没有它」。所以首次运行只播种不宣布， 只列最近 7 天内首见的，见 docs/issues/25。

工作原理

DSH PiAiAdapter（每个区域一套）
  -> 安全 loopback shim（随机端口 + 进程内随机 secret）
  -> COSY 签名 + 自定义 base64 编码
  -> 国内版 https://gateway.qoder.com.cn/
  -> 国际版 https://api3.qoder.sh/
  -> Qoder 双层包装 SSE
  -> OpenAI SSE
  -> DSH 本地执行工具并回传结果

Qoder 不是 OpenAI 兼容端点，所以需要三样东西：

1. COSY 签名头 —— 每个网关请求都带 Cosy-* 头与 Authorization: Bearer COSY.<payload>.<sig>， 签名是对 base64 负载、RSA 包装的 AES 密钥、时间戳、请求体与签名路径做 MD5。
2. 置换 base64 请求体 —— 查询串里的 Encode=1 表示 JSON 体要先 base64、再按换过的字母表 逐字符替换、最后按三分之一旋转。
3. 双层 SSE —— 每个 data: 帧是一个信封对象，它的 body 字段本身又是 JSON 字符串， 里面才是 OpenAI 风格的 chunk。

凭据来源

插件有三个凭据来源，按优先级依次尝试（桌面应用优先）：

1. Qoder 桌面应用自己的登录状态（下面几段描述的解密过程）。只要它在且没过期，用的就是它： 应用运行时自己保持登录新鲜，本机没有比它更新的凭据。
2. 插件自己的设备登录。在浏览器里批准一个码，插件把换回来的可刷新令牌存进 $DSH_HOME/.qoder-auth.<region>.json。这是没装桌面端（或不想装）的机器零配置登录的路径 —— 详见 凭据安全 与 docs/issues/21-device-login-credential-source.md。
3. 环境变量 PAT（QODERCN_PAT 等）。最后的兜底，需要用户自己到后台造一个长期令牌。

桌面端那条过期了就不算数（2026-10-20）：过期的 access token 什么都干不了——每个带它签名的 请求都会被拒，这个版本本身也不会被注册（region-gate 直接按"登录已过期"跳过发布）。所以它 不再压住后面两条：插件会继续往设备登录、再往 PAT 找一条还能用的凭据。只有三条都拿不出 东西时，那条过期的桌面端登录才作为"本机真实发生过的事"被报出去，而不是被一句含糊的"没登录" 盖过去。

无论走哪一条，都不写入应用的文件：桌面端的凭据文件始终以只读方式打开。

卡片按"真正在服务这个版本的是谁"说话（2026-10-20）：宿主把桌面端登录与插件自有登录并列 上报（两条凭据两种寿命，不合并），但账号卡要回答的其实只有一个问题——"这个版本登录了吗"。 所以当插件自有凭据在服务、而桌面端那条不在服务（过期、读不到、或只是环境变量 PAT 在服务）时， 这个版本读作**"已登录"**，并配一句"当前用的是插件自有登录（浏览器登录）——不需要桌面端 客户端"；此时那条"本地登录信息读不到"的红字不再出现——它描述的是桌面端，不是这个版本能不能用。 只签浏览器登录的用户也因此第一次有了「在线校验登录」按钮可点（以前按钮只在 source 有值时 出现，而插件自有登录在账号行里没有 source）。

Qoder 把登录信息放在 Chromium OSCrypt 格式的凭据文件里（v10 + nonce + 密文 + tag，AES-256-GCM）。 新版（0.3.x）的凭据直接保存在 <userData>/auth.v1.dat，旧版（0.2.x 及更早）则放在 VS Code 风格的 state.vscdb SQLite 数据库里。两种布局都支持，新版优先尝试。 密文用的密钥保存在应用的 Local State 中，由操作系统 keystore 包裹 —— Windows 上是当前用户 作用域的 DPAPI，因此同一用户下的进程都能解开它。 Node 没有内置 DPAPI 绑定，这一步交给 PowerShell，并通过临时文件交换结果（不使用管道）， 这样在禁止管道 stdio 的沙箱里同样可用。

没有桌面应用登录时，可以用官方文档的 PAT 兜底：设置 QODERCN_PAT（国内版）或 QODER_PAT（国际版），插件会用它换取 job token。

平台边界：读桌面端登录态那条路径只在 Windows 成立。 解密链路是 PowerShell + DPAPI （Crypt32.dll），src/host/ 里没有任何 macOS / Linux 解包分支——在其它平台上应用目录 找得到（应用数据根目录已按平台解析，见下），但凭据读不出来（loadCredential 返回 undefined）。非 Windows 上的失败说的是真话：runUnwrap 在 spawn 之前就判平台， 记下的是"这个版本只在 Windows 上读得到登录"，而不是一条在 Mac 上显示的 Windows 路径； 账号面板的提示也随之改为指向在哪个平台都成立的路子（先「浏览器登录」，再 PAT）， 而不是让一个已经装了客户端的用户去确认"客户端在不在"。

但那些平台已经不再只有 PAT 一条路：插件自己的设备登录（上面「凭据来源」的第 2 条） 不读桌面端任何东西——在浏览器里批准一次，凭据就落在本机，平台无关。所以第 1 项 keystore 从"必须补"变成"可选"。诚实的限定：设备登录这条路径只在 Windows 上真机跑过（两区各 一次授权闭环，见 probe/qoder-device-login.mjs），它用到的 都是跨平台 API，但"在 macOS / Linux 上也确实能用"仍属下面第 2 项那类实机验证。

这不是"没有跨平台客户端"，而是客户端已跨平台、插件尚未跟上：Qoder 桌面版在 macOS 12+ / Linux (.deb/.rpm) / HarmonyOS 上都有下载（qoder.com.cn/download）， 但 src/host/ 只实现了 Windows 这一条解密链。缺口在两处，全部登记在 docs/KNOWN_GAPS.md 第 6 条（跨平台凭据链未实现）：

1. OS keystore 封装（含 key 派生）：Windows 走 DPAPI；macOS 需 Keychain（security）， 且 Chromium 在 macOS 上对 encrypted_key 还要做 PBKDF2-HMAC-SHA1 派生（"peanuts" 常量 + 1003 次迭代）——与 DPAPI 直解是两种算法，不是换个命令；Linux 需 libsecret（secret-tool） 或 Chromium 在 Linux 上的 peanuts 硬编码 key 兜底。
2. 跨平台 CI 与实机验证：GitHub Actions 的 macos / ubuntu runner 可以编译并跑单测，但 Keychain 弹窗、签名打包、secret-tool 的 D-Bus session 都得在实机或 runner 上验。

已修的两项（原缺口共四处）：应用数据根目录现在按平台解析（Windows %APPDATA、 macOS ~/Library/Application Support、Linux $XDG_CONFIG_HOME/~/.config）——此前直接读 process.env.APPDATA，而该变量在 macOS 上不存在，于是探测得到空串、把"应用装着但读不出密钥" 谎报成"您没登录"；MACHINE_OS 也补上了 darwin 档（本机实测过网关对 x86_64_darwin / aarch64_darwin 一律正常应答）。

剩下的是实机工作：service 名、PBKDF2 参数、Linux 的变体都必须实测确认，写出来就是盲代码。 macOS / Linux 用户现在可以走设备登录（零配置），或 PAT 兜底，或自行从本仓库移植解密链。

CI 的 Ubuntu 绿灯说明测试在那边能跑，不等于零配置在 Linux 上存在。

安装

从 npm 安装（推荐）

dsh plugin --profile web add @eghrhegpe/dsh-connect-qoder

从 DSH 市场安装（DSH 桌面用户）

本仓库是 hdhgsysh/dsh-connect-qoder 的 fork。

可在 DSH 的「插件市场」里粘贴这个源：

github:eghrhegpe/dsh-connect-qoder

github: 源是零配置的：宿主产物 lib/（host + client bundle）随仓库提交，克隆即可加载， 安装过程不需要批准构建脚本、也不需要拉 devDependencies。若 DSH 反而提示该包有待批准的构建 脚本，说明它拿到了一份缺 lib/ 的旧克隆——删掉重装即可（lib/ 自 docs/issues/19 起必须 入库，CI 有新鲜度门禁）。

注意：npm 上不带 scope 的 dsh-connect-qoder 由上游发布，装到的是上游那份； 本 fork 自己发的是 scoped 包 @eghrhegpe/dsh-connect-qoder（上面那条），二者不是同一个包。 npm 安装每次发布都会现场重建产物（prepack），同版本号下 npm 的产物比仓库提交里更新的 可能性更大——追新走 npm，github: 源装的是对应提交时刻的产物。

或本地开发模式：

dsh plugin --profile web add <本仓库路径>

本地开发时 lib/ 对应的是提交时刻的源码：改过 src/ 后先 npm install && npm run build，再让 DSH 指向本目录，否则跑的还是旧产物。

安装后需要重启 DSH 进程：bundle 的 patch 在启动时读取。

凭据安全

来源不同，插件是否在本机留下东西也不同：

• 桌面应用的凭据：只读打开（新版 auth.v1.dat / 旧版 state.vscdb，不做任何写入）， 不存储、不复制。解密主密钥会在 %TEMP% 短暂明文落盘，回收窗口见 docs/issues/02。
• 设备登录换来的令牌：这是插件自己持有的唯一凭据，因此也是唯一会被写下来的 —— 存在 $DSH_HOME/.qoder-auth.<region>.json，0600 + 临时文件改名写入（不会留下半写文件）， 按 region 分文件（两个版本互不影响）。面板上的「退出插件登录」删的就是这个文件；它不影响 桌面端的登录，也不影响环境变量里的 PAT。令牌过期时插件用同一次的刷新令牌换新，换新失败 会在面板上说明原因，而不是装作还登录着。
• 环境变量 PAT：只读，插件不写入任何地方。
• 进程内随机 bearer token 绑定 loopback 端口；Qoder 真实的 RSA 包装 key 与 session key 不会离开本插件的沙箱。

已知行为

• 始终思考的模型：部分模型（如 GLM-5.3-Flash、Kimi-K3）声明了推理档位但不允许关闭思考， 对它们发送 enable_thinking: false 会被上游以 provider_error 1210 拒绝。插件从模型目录 识别这类模型并完全省略该字段，让模型使用自己的默认档位。
• 上游错误可见：上游失败时返回的是普通 200 帧里的错误对象，而不是 chunk。插件把它翻译成 一条可读的错误，而不是让用户看到一个空的助手回合。
• 今日请求次数用完（不是"排队"）：Qoder 每天有请求次数上限，用满后上游会带一个以小时计的 重试提示（约两小时）把它伪装成排队。此前插件照单全收，显示成"重试延迟：7350 毫秒"， 而这个等待怎么等都没用——次数要到日期切换才重置，不是排队排空的。现在它是一个独立状态： 不重试、不显示误导性的延迟，明确告知约几小时后重置，并指出仍然有效的两条路： 22:00-08:00 的错峰价（折后价，通常不计入或少计日次数）与每日签到。 状态码也从此前的 502（"Qoder 坏了"）改为 429（"今天用完了"）。判别点在 src/host/errors.ts 的 classifyUpstreamError：先认 110、再认队列标记—— 顺序是承重的，因为这个报文本身带着全部队列标记，由 test/daily-limit.test.js 钉住。
• 国际版额度：国际版的试用额度可能已用尽（isQuotaExceeded），此时目录请求会返回 403 Login expired，该区域就不会显示模型；国内版不受影响。
• 账号状态四档与卡片重读：插件入口读不出登录凭据的区域不注册 provider（启动日志会说 原因）。卡片顶部的「当前账号」面板收敛成版本条（对齐 WorkBuddy 的 tab 条）：每个 区域一个胶囊——状态点（ok 绿 / expired 红 / needs-app 琥珀 / signed-out 中性）+ 区域名 +「模型」开关；点哪个胶囊，账号详情、用量与模型列表都只看那一版，区域名因此 在卡片上只出现一次（模型行的区域 badge 已随之移除）。身份详情只带 name / email / 到期日，不带任何凭据（判定在 src/host/account-state.ts，纯本地证据、可注入可直测）。 两个按钮各管一件事：「重读登录」 让宿主丢弃凭据缓存、重读应用存储，并把启动时未能上线的区域现在就上线（重建并重新 注册 adapter，失败时回滚到原注册，不影响已在服务的区域）——重新登录后不必再重启 DSH； 面板每次渲染只读已缓存的密钥，不会同步起 PowerShell（那会阻塞整个 DSH 进程，最坏 30 s）， 所以解不开的机器也能立刻看到"读不到"和原因；即便真的需要解包（点「重读登录」时）也是 异步等待——本机实测调用 29 ms 就返回、等待期间 DSH 照常响应别的请求，而同步版本会冻结 490 ms；「重读登录」是您主动点的，那一次是真读，不受缓存与失败窗口限制。 密钥缓存与 Local State 文件绑定，Qoder 重装换掉主密钥后插件会立刻重新解包，不必重启 DSH； 「在线确认」是账号流程里唯一的联网调用（fetchUserInfo），回答「上游现在还认不认 这个登录」，失败按 classifyUpstreamError 分档（sign-in-expired / 其他）。
• 每一版的模型可以单独关掉（enabledRegions，版本条上的「模型」开关，对齐 WorkBuddy 的 per-tab 供应商开关）：取消勾选的一版向 DSH 提供零个模型，它的 模型组按「空目录即隐藏」的同一条规则从选择器消失，但登录、用量与模型筛选全部 保留，重新勾选即恢复，无需重启 DSH；卡片模型列表与选择器用同一个 regionEnabledFor 谓词过滤，两个界面不会打架。
• 刷新失败会说出来，而不是留着旧数据装作没事：
  • 上游当前没有模型（账号被收窄 / 模型全部下线）是结果不是故障——插件会照实把目录清空， 并把该版本的模型组从选择器撤下。此前这两种情况走同一条静默路径，于是旧名单永远留着， 点"刷新计费"也不可能有任何变化。
  • 抓取失败（网络、凭据、上游 5xx）保留上一份好数据，并把卡片上的时间标成 「上次更新：X（刷新失败）」，而不是给一个全新的时间假装刚更新过。
  • Qoder 改了接口格式（HTTP 200 但返回的信封不认识，例如分组改名）是一档独立状态， 卡片直接说"请更新插件（重新登录没有用）"，且不显示时间戳——它不会被当成"排队"慢慢重试。 判别边界取自实测（probe/model-shape.mjs，两端真实账号）：空分组用 [] 表达， 所以"0 个模型"是可信结果、必须落盘，而"分组键缺失/类型变了"才是格式变化。
• 卡片接口只接受同源请求（安全）：十二条路由里七条是 POST 且能改状态——「签到领积分」 （真实账号变更）、「保存模型勾选与图像模式」（__save）、「重读登录」、「在线确认」， 以及设备登录那一组的三条写路由：「开授权页」、「取消」、「登出并删掉本插件存的凭据」。 逐条方法、能否改状态、谁在调用见 docs/ROUTES.md （本仓路由的唯一清单；改路由必须同步那张表）。这些接口此前只按"来源主机名是不是 本机"判断，因此本机任意端口上的任意 HTTP 服务都能让它的网页代为调用（浏览器会挡跨域 读响应，但操作已经发生）。现在要求来源的地址与端口与请求实际拨到的地址一致 （比对请求自己的 Host 头，所以不写死端口、DSH 换端口也不用改），且必须是回环地址。 判定在 src/host/routes.ts 的 loopbackRequest，由 test/route-gates.test.js 覆盖。
• 依赖 Qoder 客户端接口（非官方开放 API），Qoder 更新后插件可能需要随之调整。
• 设置命名空间由宿主决定，不能自选（0.2 代起）：describe() 用 Loader 条目 id 作为 ns（本 bundle 是 llm-qoder，不是 dsh-connect-qoder），而「设置 → 模型」 页按精确匹配查 namespaces.get(entry.settingsNs)。若插件宣告的命名空间与宿主实际 服务的不一致，该 provider 会被判为「未配置」，整行从页面上消失——不报错、不灰显， 而插件本身仍在正常注册和应答，非常难查。因此 settingsNs 一律经 settingsNamespaceOf(ctx) 从 ctx.fiber.entry.options.id 推导，常量只作为宿主不暴露 条目 id 时的回落值（对齐 WorkBuddy 2.1.0 的同款修复）。
• 设置保存走插件的 __save 主机端点 + 读回校验（对齐 WorkBuddy 同修）：DSH 0.2 代的 客户端设置 scope set() 在原子写重试耗尽后会静默返回成功而不落盘，卡片改为「主机端点 权威写、本地写仅作镜像、写后读回确认」，保存按钮只会显示真实结果。在宿主未为本插件注册设置 命名空间行的环境（如 link: 开发安装）下端点会 503，卡片如实显示失败而不是假"已保存"； 正式（registry）安装下该端点可用。
• 每日签到：Qoder 每天 10:00（UTC+8）给每个账号发一轮 CLAIM_BENEFIT 活动，一轮只能领一次， 重复领取是幂等的（replayed，不再发放）。卡片在「我的用量」右侧放一张签到小卡片 + 三态按钮 （立即签到 / 签到中… / 今日已签到）——只有你点才会领，插件不会自动签到。每次点击都先重读一次 活动列表取当轮 id，绝不复用渲染时的旧 id（一天一轮，旧 id 就是上一轮的）；领取后用量缓存作废 重读，因为 Credits 落在同一块面板显示的 Add-on 资源包里。两个过滤器是照真实返回加的：同一账号 下的另一个 VIEW_DETAILS 活动同样带着 claimStatus: "CLAIMED" 却没有 benefit，只按状态挑会对 它去领；而列表顶层的 claimable 在「已领过」和「没有活动」时都是 false，不能当判据。 卡片右上角大字是主机解析出的当轮额度（checkin.amount，来自活动自身的 benefit），领过之后 仍然显示——签到卡片因此不是「一行两段短文案占满整行」，而是与用量面板并排的一张卡；窄卡片下 自动换行到面板下方。额度落在 addOnQuota 里，是因为国内版免费层的计划额度为 0，签到攒的资源包 是它唯一的额度。
• 国际版签到行需要 umid 机器身份：国际版 GET /sash/api/v1/me/campaigns 把每日 CLAIM_BENEFIT 轮次按机器身份下发——请求须携带桌面应用 umid 服务的 Cosy-MachineToken/Code/Type 头，否则只回常驻的 VIEW_DETAILS 横幅，签到卡片按 active: false 设计不渲染。插件在 OpenAPI 请求上自动附加这组头（Windows 上定位安装 目录的 resources\umid\runtime-info.exe 读取，失败静默降级为原头组；国内版与 PAT 不受影响；发现与验证记录在 docs/KNOWN_GAPS.md 第 8 条（国际版 campaigns 端点按 umid 机器身份门控每日签到））。

文档

npm 包里只有 6 项：lib/、locale/*.json、cordis.patch.yml、icon.svg、README.md、 CHANGELOG.md（即 package.json 的 files；另有 npm 无论如何都会打包的 LICENSE）。 docs/、AGENTS.md、src/、test/、probe/、scripts/、assets/ 都在仓库里、不在包里 ——registry 页面上点这些路径会 404，请到 GitHub 仓库看。本文的截图因此一律写成 raw.githubusercontent.com 绝对地址（相对路径在 registry 页面上是裂图）。

阅读顺序按身份分，别从头读到尾：

目录

docs/docs-qoder-cn/ 是从 Qoder CN 官方文档抓回并清洗的资料（纯 Markdown，源 .txt 已删）， 由根目录的 convert-qoder-docs.ps1 一次性转换而成——它只处理这一批抓取件，不是常规构建步骤； 产物由 test/docs-markdown.test.js 守着，改动转换规则后重跑该测试即可。文档与代码的对应关系 （哪条系数/活动/签到事实落在哪个模块）记录在该目录的 Qoder CN 文档与插件设计佐证.md。

卡片侧的源码在 src/client/（产物是 lib/client.js，react 由宿主提供，产物不打包它）：

| src/client/paths.ts | 卡片用到的十条路由常量（QODER_*_PATH）：四条读、六条写。__save 不在其中——它由 settings-write.ts 以字面量直接 POST；status 只供宿主诊断，卡片不读 | | src/client/styles.ts | 卡片样式与 installStyles（dsm-* 一套与 dsh-connect-workbuddy 逐字一致，原因见文件头） | | src/client/settings-write.ts | 「写入后读回校验」的浏览器半边 | | src/client/controller.ts | 卡片可编辑状态机（staged/saved 三字段、dirty、save、discard 与派生的模型视图）——无 React、无 DOM，可被 node:test 直接测 | | src/client/copy.ts | 卡片文案聚合入口（中/英），index.ts 与 card.tsx 只从这里取 | | src/client/copy-row.ts copy-usage.ts copy-account.ts | 按面板拆分的三段文案：模型行与错峰、用量与签到、账号与区域标签条 | | src/client/card-model.ts | 卡片的浏览器无关决策层：视图模型类型词汇 + 纯规则（offPeakState / rateAt / windowLabelOf / refreshNoticeKey / 格式化 / describeThrown——卡片所有 catch 块给用户看的失败文案都过它）。无 React、无 DOM、无 fetch，因此 Node 测试可直接 import 真规则，而非镜像副本（这是向 sensenova snapshot.ts 对齐的那一刀；describeThrown 也从 card.tsx 挪进来，拆掉装配层与两个容器之间的循环 import） | | src/client/http.ts | 卡片唯一的 fetch 收口：getJson / postJson，模型名册读与两台容器（用量 / 账号）共六道宿主路由 fetch 都只通过这里（向 sensenova http.ts 看齐）；GET / POST 失败都先取宿主的 error 字段（如 loopback origin 检查的 origin-not-trusted），无才回落 HTTP {status}；宿主的 writeError 写的是 {error:{message,type,code}}，故对象形状也取它的 message（否则每道 writeError 拒绝都会退化成一句没有下文的 HTTP 500）；GET 200 但 body 解析失败按 unparseable JSON body 抛出而非当空数据，避免「假 undefined 失败」 | | src/client/usage-panel.tsx | 用量容器 QoderUsagePanel：自有额度读 + 每日签到领取两条 fetch，渲染 RegionUsage / CheckinCard（二者留在 card.tsx 作为无 hook 纯展示件） | | src/client/account-panel.tsx | 账号容器 QoderAccountPanel：区域条 + 选中区域登录卡，四道 fetch（读 / 重读 / 确认 / 开关写），开关写仍带完整 enabledRegions map。按"在服务的是谁"显示：effectiveStateOf() 判出这个版本真正在服务的是桌面端还是插件自有凭据，只有后者在服务时才读作"已登录"、才给「在线校验登录」按钮（桌面端那条在服务时按钮同样在） | | src/client/device-login-panel.tsx | 插件自有登录那一块（第三个凭据来源的卡片半边）：与账号行的 state 并列上报、绝不合并——桌面端登录与插件令牌是两份凭据两种寿命。两层结构（外层无 hook 做门控，device 缺席 = 老宿主 → 什么都不渲染、绝不报「未登录」；内层持全部 hook）。start → window.open 授权页 + 保留可点回退链接 → 每 2s 轮询一次（链式而非 interval，慢响应只会推迟下一次而不会叠请求）；authorized 停并回读，expired/idle/failed 各给不同文案；卸载时若仍在等待就 best-effort cancel（宿主 5 分钟 TTL 是兜底）。每个失败都说出是哪个失败，t/onChanged 由 ref 持有并刻意排除在轮询 effect 依赖外（否则父组件每次渲染都