DSH Qoder Connect
⚠️ 免责声明：本项目为非官方第三方插件，与 Qoder 官方无任何关联，未获其授权或认可。
仅供个人学习研究，只驱动使用者本人已登录的 Qoder 账号；使用者需自行遵守 Qoder 的服务条款。
把 Qoder（qoder.com 桌面端）的模型接入 DeepSeek Harness 的模型选择器。
两种登录方式，零 API Key 配置：本机装有 Qoder 桌面端时直接复用其登录态；没有桌面端也可以在设置卡片里一键设备码登录。
可交互预览：preview/qoder-card-interactive.html —— 单文件零依赖，双击浏览器打开即可体验全部界面（账号卡片 / 资源明细 / 模型开关 / 用量统计）。
功能
账号卡片（v0.3.0，多账号形态）
- 账号信息：头像圆圈（
avatar_url 优先显示，加载失败或缺失时回退首字母 + 按名字确定性取色的淡底）+ 账号名 / 邮箱（超长省略号截断）。
- 剩余 Credits：卡片 header 独立一列大数字（订阅 + 资源包余额加总，来自 quota API）。
- 令牌到期三态 chip：正常 → 绿色（显示到期日期）；不足 7 天 → 橙色「N 天后过期」；已过期 → 红色「已过期」。悬停始终有完整日期。
- 签到状态：读取
/sash/api/v1/me/campaigns，三态——可领取（按钮打开 Qoder 官方活动页）/ 今日已领 / 暂无活动。明确说明：不做一键领取——Qoder 的领取动作在官方网页 iframe 内完成，第三方代点既不可靠也不合规。
- 当前 / 备选：当前账号显示绿色「当前」pill；「设为当前」按钮为多账号存储预留（UI 已按多账号设计，后端暂为单账号）。
资源明细（点击账号卡片展开）
- 订阅版本的资源：当前计划的月度配额与使用情况——
已使用 / 总量 大数字 + 百分比 + 进度条 + 剩余数。
- 个人资源包：通过活动或购买获得的包总量与使用情况；子项列表（包名(总计:N) + 剩余 credits + 有效期）。
- 数据来自
/api/v2/quota/usage（协议 §5.1 VERIFIED）；查询失败时显示「数据不可用」而不是假装 0。
用量统计 tab
- 四格数字卡：今日消耗 / 近 7 天 / 本月 / 累计总计（含单日峰值提示）。
- credits 条形图：最近 14 天逐日消耗（数据来自
/sash/api/v1/ai-conversations/credits-heatmap，实测 200 VERIFIED）。
模型目录与 gate 探测
- 三层模型目录（17 个模型，永不空选）：按信息新旧依次取用，任何一层失败自动落到下一层：
- 本地缓存：Qoder 桌面端自己缓存的服务器目录（
~/.qoder/.models/<uid>/catalog-v6，AES-GCM 加密，密钥即账号 uid）。插件从本机 Qoder 安装里提取 Qoder 自带的 qoder_auth_wasm_bg.wasm，在进程内原样解密——不联网、不签名、不改写任何文件。本机有 Qoder 客户端登录过时这是最新鲜的一层。
- 随包快照（
lib/qoder/catalog-snapshot.json）：一份解密后的服务器目录已随包分发，没有 Qoder 桌面端也能看到完整 17 模型目录（auto / ultimate / performance / efficient / smodel(Sonus) / cmodel(Cantus) / qmodel 系列 / kmodel 系列 / gmodel 系列 / dmodel 系列 / mmodel(MiniMax-M3)）。
- 内置最小集：10 个逐个实测被网关接受的键，快照也读不到时兜底——目录出任何问题都不允许把 provider 整个弄失效。
- 每账号 gate 自动探测：服务器目录是"全账号"视角，聊天网关却按账号放行。插件在后台用当前凭据对每个模型做一轮 1 token 的轻量探测（间隔 300ms），结果按账号缓存在
$DSH_HOME/.qoder-cli-gate-cache.json，24h 有效；到期后台重新探测，从不阻塞。探测结果动态修正 degraded 标记：本账号 accepted 的模型会清掉快照时代的降级备注，rejected 的标"不可用"。探测失败静默——快照时代的标记继续兜底。
模型选择与显示
- 模型开关（iOS 样式）：绿色药丸 + 滑动 knob 的 toggle，决定该模型是否出现在选择器；一个都不开 = 全部提供。已固定某模型的既有会话不受开关影响（继续可用，不中断）。
- 每模型选项（目录里有的才显示）：
- 思考档位：关闭 / 低 / 中 / 高 / 极高 / 最大，服务器声明的档位阶梯与默认档自动带入；
- 上下文档位：200K / 400K / 1M 等带标签的窗口阶梯，默认档预选；
- 积分倍率：
×N.NN 徽章显示该模型的服务器计费倍率（priceFactor）；
- 促销徽章：服务器促销（夜间免费/限时免费等）以绿色徽章显示，悬停看说明；
- 不可用标记：gate 探测或快照标记 degraded 的模型灰显标注，不隐藏。
- 真实 SSE 流式输出：Qoder 网关本身就是 OpenAI Chat Completions 形态的 SSE。
凭据 failover（v0.3.0）
主凭据请求失败（401/403/模型被拒）时，插件自动遍历所有可发现的备用凭据——IDE 桌面端 store（DPAPI）→ CLI 设备流 store（WASM AES）→ QODER_CLI_AUTH_FILE 显式文件——每个候选先做一次 1 token 真实探测，通过者记忆为进程级凭据（后续请求跳过遍历）。全部失败时原始错误原样上抛，不吞错。
主题适配（v0.3.0）
全部中性色（边框 / 次要文字 / hover 衬底 / 错误文字）走 --dsw-alias-* 主题 token，跟随 DSH 的亮 / 暗 / 彩色主题；每个 token 均带降级种子，主题缺失时视觉不劣化。语义色（成功绿 / 警告琥珀 / 错误红 / 头像六色）保持固定，不跟随品牌色。
两种登录方式
- 复用 Qoder 登录态：直接读取 Qoder 桌面端自己的加密凭据（
%APPDATA%\com.qoder.app.stable\auth.v1.dat），在 Qoder 里重新登录后自动跟随。从不改写 Qoder 的任何文件。
- 卡片内设备码登录：设置 → 插件 → DSH Qoder Connect 卡片 → 网页登录添加账号，浏览器打开 qoder.com 完成登录，插件经 PKCE 设备码流（与 Qoder 桌面端同款流程）自动取回令牌，存入插件自己的凭据文件（
$DSH_HOME/.qoder-cli-auth.json）。无需安装 Qoder 桌面端。
安装
# 1. 打包
cd <本仓库目录>
npm pack
# 2. 装进 web profile（用 tarball，不要用 link:，见下方「为什么不能用 link」）
dsh plugin --profile web add <路径>\dsh-qoder-cli-<版本>.tgz
# 3. 重启 DSH（插件在启动时加载）
装完后：模型选择器里会出现 Qoder 的模型；设置页会出现配置卡片。
⚠️ 为什么不能用 link: / pnpm add <目录>
实测：dsh plugin --profile web add link:<目录> 会装出一个 junction，
而 Node 解析模块时会跟随 junction 到真实路径。那里没有 DSH 的内部依赖，
于是 @deepseek-ai/schemastery 等全部解析失败，插件在启动时加载不了。
用 tarball 安装时，pnpm 会把包实体放进 profile 自己的 .pnpm 目录内，
向上查找能命中 profile 的 node_modules，依赖才解析得到。
配置
设置 → 插件 → DSH Qoder Connect（点击标题行展开）：
| 项 | 说明 |
|---|
| 网页登录添加账号 / 刷新 | 设备码登录入口与账号数据刷新（tab 栏上方，常驻可见） |
| 账号卡片 | 头像 / 账号名 / 邮箱 / 剩余 Credits / 令牌到期三态 chip / 签到 / 当前状态；点击卡片展开资源明细 |
| 可选模型 tab | 每模型一行 iOS 样式开关 + 思考档位 + 上下文档位下拉；带积分倍率 ×N.NN 与促销徽章 |
| 用量统计 tab | 今日 / 近 7 天 / 本月 / 累计四格数字卡 + 最近 14 天 credits 条形图 |
命令行
dsh plugin --profile web exec dsh-qoder-cli status # 登录状态（--json 机器可读）
它是怎么工作的
DSH ──(OpenAI SSE, 无自定义头)──▶ 本机回环 shim ──(补 Cosy-* 头)──▶ api2-v2.qoder.sh
为什么必须有一个 shim：Qoder 网关要求每个请求都带 Cosy-ClientType /
Cosy-Version / Cosy-MachineId 这几个头，而 pi-ai 的 provider 描述符只能设静态头，
没有"每请求注入动态头"的钩子。所以插件在本机起一个回环 HTTP 服务，把请求接住、补齐头、再转发。
shim 的安全边界：只绑 127.0.0.1 随机端口；每次调用都要带进程内随机生成的 bearer
（常数时间比较）；Host 与 Origin 都必须是回环，挡住 DNS rebinding。
凭据是怎么读出来的
Qoder 桌面端用 Electron safeStorage 存凭据。Windows 上的形态是：
Local State → os_crypt.encrypted_key（base64，前 5 字节是 DPAPI）- 去掉前缀后交给 DPAPI
CryptUnprotectData(CurrentUser) → 32 字节 AES 密钥
auth.v1.dat = v10(3B) + nonce(12B) + ciphertext + tag(16B)，AES-256-GCM 解密- 得到 JSON：
{schemaVersion, token, refreshToken, expiresAt, refreshTokenExpiresAt, user}
DPAPI 是用 koffi 在进程内调的。不从进程外调 PowerShell，因为 DSH 运行时拒绝与子进程
之间走管道 stdio，那种设计在终端里能跑、在 harness 里跑不了。
设备码登录（不依赖桌面端）：与 Qoder 桌面端同款的 PKCE 流程——
生成 verifier（64 字符，RFC 7636 非保留字符集）→ challenge = base64url(sha256(verifier))
→ 浏览器打开 https://qoder.com/device/selectAccounts?challenge=…&challenge_method=S256&nonce=…&machine_id=…&client_id=…
→ 插件每 1 秒轮询 https://openapi.qoder.sh/api/v1/deviceToken/poll（404 = 未完成，5 分钟超时）
→ 成功后再取 GET /api/v1/userinfo 组装凭据文档。verifier 只存在于宿主进程内存，
浏览器永远接触不到令牌材料。端点与参数均从 Qoder 桌面版 bundle 实测提取，
证据见 docs/QODER-PROTOCOL.md §2.6。
已知限制
- 主测环境是 Windows + Web profile。 macOS / Linux 的候选目录写了但未实测。
- 令牌刷新未实现：
refreshCredential() 原样返回。设备码登录给出的 token 距到期有 30 天，
桌面端登录态更长；刷新端点的请求体已从 bundle 挖出（docs/QODER-PROTOCOL.md §2.5）但未实测过，
不猜协议。过期后表现为一次正常的 401，重开 Qoder 端或在卡片里重新登录即可。
efficient 可能无后端：网关认得这个键（不是 invalid_model_error），
但实测中多次回 429 provider_error / All backends failed。卡片上标「不可用」，
gate 探测会按账号动态修正这一标记。- 模型目录不是实时拉取的：Qoder 的
/api/v2/model/list 列表端点无法直接联网拉取——
api2-v2.qoder.sh 上实测 404；端点选举出的 api3.qoder.sh 上返回 403 Signature invalid
（见下「故障排查」对该错误的分析）。目录来自上面说的三层结构（本地缓存解密 →
随包快照 → 内置最小集）；快照时代无法逐账号核实的键以 gate 探测的实测结果修正
（见「每账号 gate 自动探测」）。
- 未测图片输入：所有模型只声明
text。没有实测过任何一次图片请求，
声明 image 会让 DSH 把图片发给可能拒收的模型。
故障排查
- Qoder 状态显示「未登录」，但 Qoder IDE 里明明已登录：
IDE 与 CLI/插件用的是两套独立凭据存储——IDE 走
%APPDATA%\com.qoder.app.stable\auth.v1.dat（Electron safeStorage 加密），
CLI 设备流存储在 ~/.qoder/.auth/user，插件自己的凭据在
$DSH_HOME/.qoder-cli-auth.json；三者互不自动同步。
解决：在设置卡片点一次「登录 Qoder」（设备码登录）即可。
- 模型标注「不可用」：模型目录是服务器全量视角，但 chat 网关按账号灰度放行，
部分模型（快照时代实测 8 个 rejected、
efficient 429）对本账号直连被拒。
解决：等灰度放开——每账号 gate 探测会自动按账号修正标记（24h 缓存）；
或在任一装了 Qoder 的机器上重跑 node tools/gate-catalog.mjs 刷新探测与快照；
期间可在 Qoder 客户端内使用该模型。
Signature invalid（403）：仅影响 model/list 在线拉取实验（三层目录链不依赖它，
不影响插件正常使用）。COSY 签名已能产出且与 endpoint 绑定——对 A host 计算的签名
拿去请求 B host 必然 403。但实验已证明这不是"缺材料"：端点选举复刻本身 200 成功
（匿名 sign 模式即可通过网关验签，证明 WASM 签名链路完整），且 umid 设备指纹
（阿里聚安全 sgsdk.dll）已被证伪为嫌疑——WASM 签名上下文没有 umid 通道，
官方客户端同样不带。当前结论：模型列表路由策略未公开，该路径对复刻通道不开放
（官方 bundle 的 transport 层还注入了复刻面之外的特征）。实验数据见
docs/experiment-endpoint-election.md。- 设置卡片里的模型开关在操作时变灰：这是正常的 busy 禁用态视觉反馈
（写入请求进行中开关临时禁用），操作完成即恢复，不是故障。
文档
目录结构（二次开发）
lib/
├── index.js Cordis 插件入口：settings schema、shim 启动、provider 注册、catalog 引导
├── client.js 浏览器端设置卡片（账号卡片 / 模型行 / 用量统计）
└── qoder/
├── constants.js 端点 / 路由 / 命名空间常量（全部带 VERIFIED 注释）
├── models.js 模型目录三层链 + degraded 标记 + allowlist 过滤
├── catalog-reader.js 本地目录解密（Qoder 官方 WASM 进程内调用）
├── catalog-snapshot.json 随包目录快照（三层链第 2 层）
├── quota.js quota / usage / credits heatmap API 客户端（失败静默 null）
├── campaign.js 签到活动状态（/sash/api/v1/me/campaigns）
├── gate-cache.js 每账号 gate 探测缓存（24h TTL、原子写）
├── credential-failover.js 凭据多源遍历 + 1 token probe + 进程级 memo
├── credentials.js IDE 桌面端凭据解析（safeStorage / DPAPI / AES-GCM，koffi 进程内）
├── wasm-credential-reader.js CLI 凭据 WASM 解密（库化封装）
├── device-login.js 设备码登录（PKCE 全流程）
├── store.js 凭据存储（插件自有副本 vs 发现凭据取新者）
├── wire.js 请求线格式（URL / Cosy-* 头 / body 规范化 / SSE 帧解析）
├── relay.js 上游客户端（错误分类：auth_error / rate_limit / server_error）
├── shim.js OpenAI 兼容回环 shim（安全边界见「它是怎么工作的」）
└── web.js HTTP 路由（status 聚合 / 开关写入 / 登录 / 数据源并发拉取）
模块职责与数据流的完整说明见 docs/ARCHITECTURE.md。
开发
npm pack # 打包 tgz
node test\run-all.mjs # 全量测试（离线套件必须全绿；live 套件需本机有 Qoder 登录态，缺失时显式 SKIP）
node test\verify-loads.mjs # 宿主加载结构验证（必须在 DSH profile 环境下跑）
node tools\snapshot-refresh.mjs # 刷新随包目录快照
免责声明
仅供个人学习研究，只驱动使用者本人已登录的 Qoder 账号。使用者需自行遵守 Qoder 的服务条款。
本项目与 Qoder 官方无任何关联，未获其授权或认可。
License
GPL-3.0
