DeepSeek Harness (DSH) 通过插件机制支持丰富的模型接入。通义灵码（Qoder）官方不提供 OpenAI 兼容的端点，本插件通过直连 Qoder 的 cosy 网关，为 DSH 提供了模型接入能力，并补充了账号池、每日签到、积分读数与模型管理功能。
核心功能¶
双供应商并行接入¶
插件支持国内版与国际版两个供应商，分别注册为 qoder 和 qoder-global provider。
* 国内版：使用 gateway.qoder.com.cn。
* 国际版：使用 api1.qoder.sh。
配置了 PAT 的区域，其模型会出现在 DSH 的模型选择器中。两个区域的模型可同时存在，不同会话可独立选择。
账号池与 PAT 管理¶
- 多账号池：支持多个 PAT，插件会自动去重合并设置、环境变量与本地 vault 中的凭据。
- 自动换号：开启后，插件会根据实测可用性、积分有效期、余额等规则自动选择账号，请求失败时自动切换重试。
- 导入导出：支持按区域导出和导入账号池配置。
模型管理与积分¶
- 模型管理：可刷新上游模型目录，逐项勾选启用或禁用。模型列表会显示积分倍率、上下文限制、思考强度等。
- 可用性测试：每个模型行提供测试按钮，发送真实请求验证可用性（会消耗少量积分）。
- 积分读数：只读显示各账号剩余积分与积分包到期时间，支持一键签到。
- 安全隔离：采用安全 loopback shim，PAT 仅在本地与 pi-ai 交互，不外发到网关之外。
安装与启用¶
从发布包安装（推荐）：
# Desktop profile
dsh plugin --profile desktop add @dmh2002/dsh-connect-qoder
# Web profile
dsh plugin --profile web add @dmh2002/dsh-connect-qoder
安装后需重启对应 profile 的 DSH 进程以加载插件。
配置¶
创建 PAT¶
在 Qoder 账户设置中创建 Personal Access Token（pt-… 开头）。
添加凭据¶
插件设置卡片提供 PAT 添加入口，优先级高于环境变量。
* 国内版：设置项 regions.cn.pat，环境变量 QODERCN_PERSONAL_ACCESS_TOKEN。
* 国际版：设置项 regions.global.pat，环境变量 QODER_PERSONAL_ACCESS_TOKEN。
添加 PAT 后，在模型管理页点击“从 Qoder 刷新”即可列出可用模型。
工作原理¶
插件在 DSH 内部通过 PiAiAdapter 接入，架构如下：
DSH PiAiAdapter
-> 安全 loopback shim（本地随机端口 + 进程内 secret）
-> QoderUpstreamClient（cosy 协议最小客户端）
-> 国内版 https://gateway.qoder.com.cn/algo/api/v2/...
-> 国际版 https://api1.qoder.sh/algo/api/v2/...
-> Qoder SSE（OpenAI 形状增量）
-> DSH 本地执行工具并回传结果
PAT 仅在获取 jobToken 时使用一次，后续请求携带 cosy bearer 与机器指纹。PAT 不进入 pi-ai，不写入 Qoder 桌面端登录文件。
注意事项¶
- 安全性：PAT 只保存到本地插件配置，不外发。
- 国际版限制：国际版需要本机 Qoder 客户端的设备风控组件支持。
- 测试消耗：模型可用性测试会发送真实请求，消耗少量上游额度。
- 错误处理：插件对凭据无效、内容审核拒绝、额度耗尽等错误会如实分类。
