前言¶
DeepSeek Harness (DSH) 是一个插件化的模型推理框架。对于同时使用 Qoder 国内版与国际版订阅的用户，手动管理两条产品线的模型列表、额度与上下文窗口较为繁琐。masknull/dsh-qoder-connect 插件提供了统一的接入方式，支持双变体独立配置、PAT 实时校验与即时保存，将 Qoder 的模型直接集成进 DSH。
核心功能¶
双变体独立配置¶
插件同时服务两条 Qoder 产品线，各自一张设置卡片、一个 provider、一套凭证与模型目录，互不混用。
- 国内版：provider id 为 qoder，生成 PAT 需在 qoder.com.cn。
- 国际版：provider id 为 qoder-global，生成 PAT 需在 qoder.com。
未保存 PAT 的变体不显示模型分组，另一版完全不受影响。
PAT 实时校验与即时保存¶
在插件设置卡片中粘贴 PAT 点“保存”，插件会先对该变体的区域实时校验，通过后才落盘，模型分组立即出现，无需重启 DSH。支持“更换 PAT”（新令牌校验通过才覆盖）与“清除 PAT”。
模型目录三级降级¶
模型列表来源具有优先级：
1. live：实时拉取。
2. saved：本账号上次成功目录（重启或断网后顶上来）。
3. fallback：编译进插件的兜底名单。
最近一次拉取失败时附带原因，并支持手动“刷新模型列表”。
上下文窗口一键切换¶
卡片列出每个模型的容量（默认值与最大值），并各自提供“使用上游声明的最大上下文窗口”开关（默认勾选）。
- 勾选：按最大窗口（如 Qwen3.8-Max 的 1M）发请求。
- 不勾选：按默认窗口（200K）。
两版开关状态独立保存。
模型自由开关与批量管理¶
提供“模型开关”页，可自由开启或关闭指定模型。关闭的模型将自动从 DeepSeek Harness 的模型选择器中隐藏，避免误选与列表冗长。支持按名称/ID 搜索，以及全选与一键“批量开启”/“批量关闭”。
每日自动签到与日志明细¶
支持每天自动签到领取 100 Credits 算力额度，签到时刻可在卡片上自定义（默认 10:00 UTC+8）。配备双端开关与开机防漏补签机制。卡片常驻“签到日志”面板，提供执行流水记录与快捷操作。
侧栏额度展示与倍率显示¶
- 侧栏额度：开启后侧栏底部出现该变体的额度小卡，点击可在中间面板打开“Qoder 额度”明细，查看各资源包的剩余/总量与进度条。
- 倍率显示：模型名后直接拼上游报价的价格倍率（如
某模型 · x0.79），来自目录接口的price_factor字段。
安装与前置条件¶
需 DSH 核心 0.1.7-rc.1 及以上，以及 Node.js ^22.19.0 或 >=24.0.0。
使用官方 CLI 安装：
dsh plugin --profile web add github:masknull/dsh-qoder-connect
指定 profile（如 desktop 或 tui）需替换 --profile web。
配置与使用¶
- 生成 PAT：登录 qoder.com.cn（国内版）或 qoder.com（国际版），在账号设置中生成 Personal Access Token。
- 保存 PAT：在 DSH 的插件设置卡片中，将 PAT 粘贴到对应变体的输入框，点击“保存”。
- 管理模型：在“模型开关”页批量管理模型，或在“上下文窗口”页调整最大上下文窗口开关。
- 自定义签到：在设置卡片中自定义每日签到时间。
注意事项¶
- 使用即表示自行承担账号被限制的风险，插件仅供个人学习研究。
- 双变体配置独立，互不混用。
结尾¶
通过该插件，DSH 用户可以直接使用 Qoder 的算力资源进行模型推理。更多细节与源码请参考 GitHub 仓库。
