前言¶
DeepSeek Harness (DSH) 的设计理念是「一切皆插件」。在使用 DSH 接入 Qoder CN 的模型服务时，开发者需要处理 COSY 签名和 WAF 编码等协议细节。minglu6/dsh-provider-qoder 插件旨在封装这些连接层面的配置问题，使开发者能直接通过 DSH 访问 Qoder CN 的模型。
插件介绍¶
该插件由用户 minglu6 维护，是 DeepSeek Harness 的一个适配器插件。它主要负责以下工作：
- 安装路由：在 DSH 中注册
qoder-cn提供者路由。 - 流式传输：处理与
gateway.qoder.com.cn之间的 COSY 签名和 WAF 编码流式传输。 - 模型目录：从 Qoder 的
/algo/api/v2/model/list接口获取签名的实时模型目录。 - 认证管理：将 PAT 存储在模型页面，并在进程间交换为短期作业令牌。
安装与启用¶
安装过程依赖已安装 dsh 的环境。
- 执行安装命令：
dsh plugin --profile web add github:minglu6/dsh-provider-qoder
- 启动 Web 服务：
dsh web
启动后，在设置界面添加提供者 qoder-cn，并粘贴 PAT 即可完成基础配置。
配置与使用¶
插件注册了 llm-qoder 设置命名空间。
公共云使用：
仅需在设置 -> 模型中添加 qoder-cn 提供者，并粘贴 PAT。连接端点无需配置。
企业 VPC 使用：
在 settings.yaml 中设置 llm-qoder.vpcInstance。
模型目录与覆盖：
除非配置了 models 字段，否则插件会从 Qoder 拉取实时目录。models 是一个可选的静态覆盖配置，用于完全替换实时发现功能，而非扩展它。新发布的模型（如 gmodel）无需更新插件即可通过实时目录出现。
认证机制：
PAT 存储在 DSH 的模型页面，插件会在进程运行时将其交换为短期作业令牌。若当前 DSH 构建版本不支持将未知适配器家族视为 API 密钥卡，可导出环境变量 QODERCN_PERSONAL_ACCESS_TOKEN 作为临时方案。
注意事项¶
- 该插件以当前 DSH 进程的权限运行，安装前建议检查源码与许可证。
- 模型列表默认为动态获取，静态配置
models会覆盖此行为。 - 若遇到认证或目录加载问题，需确认 DSH 版本是否支持未知适配器家族的处理逻辑。
结语¶
该插件通过处理底层的签名与编码逻辑，简化了在 DeepSeek Harness 中接入 Qoder CN 的流程。相关源码与文档可访问其 GitHub 仓库。
