前言¶
DeepSeek Harness (DSH) 是一个以插件为核心架构的智能体开发环境。dsh-qoder-connect 插件旨在解决 Qoder CN(阿里 Qoder 国内版桌面 App)的订阅模型无法直接在 DSH 中调用的问题。该方案通过读取 PAT 凭据,绕过桌面 App 的加密凭据,以 OpenAI 兼容接口的形式将 Qoder 模型接入 DSH,属于个人自用方案。
核心功能¶
插件实现了以下功能,以适配 Qoder CN 的私有协议:
- OpenAI 兼容接口:在 DSH 中以标准 OpenAI 格式暴露 Qoder CN 模型。
- Provider 注册:注册
llm-qoderprovider id,渠道名为qoder1。 - 凭据流转:读取 PAT 并交换为短期
jobToken。 - 协议适配:实现 Qoder 自研的 COSY 签名、请求体自定义编码以及双层 SSE 解析。
安装与启用¶
在使用前,需在 Qoder CN 官网生成 PAT 并完成配置。
- 生成 PAT:登录 https://qoder.com.cn/account/integrations 生成 PAT。
- 配置凭据:将 PAT 写入
$DSH_HOME/qoder/pat文件(权限 0600),或设置环境变量(优先级:QODERCN_PAT>QODERCN_PERSONAL_ACCESS_TOKEN>QODERCN_API_KEY)。 - 执行安装:使用以下命令安装插件(根据你的 DSH 版本选择 profile)。
dsh plugin --profile web add github:yembors64632/dsh-qoder-connect
安装完成后,插件会注册 llm-qoder provider,不改动 profile 当前的默认模型。
使用方法¶
安装并配置完成后,即可在 DSH 中使用 Qoder 模型。
- 在 DSH 的模型选择器中选择渠道名
qoder1。 - 插件会自动读取 PAT 并获取 jobToken 进行对话。
注意:该插件读取的是原作者生成的 PAT,只对原作者账号有效。若要在自己环境运行,需根据 README 指示修改硬编码的路径、端点和身份字段。
适用场景与注意¶
- 版本兼容性:DSH 核心版本需匹配
0.1.5/0.1.6/0.1.7alpha 线,否则启动失败。依赖 Node.js^22.19.0 || >=24.0.0。 - 凭据维护:PAT 过期不会自动续期,需手动重新生成。
- 使用范围:仅供个人学习与研究,需遵守 Qoder 服务条款。上游协议为私有实现,存在失效风险。
结语¶
该插件为 DSH 提供了接入 Qoder CN 订阅模型的可行路径。相关目录与源码可参考下方链接。
- 插件目录:https://www.skillhub.cn/plugins/yembors64632/dsh-qoder-connect
- GitHub 仓库:https://github.com/yembors64632/dsh-qoder-connect