前言¶

在 DeepSeek Harness（DSH）里跑 agent，通常要单独配置各家模型的 API Key 或 Token。若你已经在 Qoder CN 桌面 App 里订阅了 Qwen、DeepSeek、Kimi、GLM、MiniMax 等模型，这些能力默认只能在 Qoder 客户端内使用，官方并未提供把同一套账号接到 DSH 的入口。

社区插件 dsh-qoder-connect（维护者 YSwo-fei，GitHub 仓库 YSwo-fei/dsh-qoder-connect，当前版本 0.5.0，MIT 许可证）做的是：在本机已有 Qoder CN 登录态的前提下，自动发现凭据、续期，并把网关上的模型注册为 DSH 的 qoder provider，对外呈现为 OpenAI Chat Completions 兼容接口。分类上属于 模型推理 类插件。

下面介绍它的定位、能力与安装用法；涉及协议与账号风险的部分，以仓库 README 中的免责声明为准。

这是什么¶

DSH Qoder CN Connect 是一条「零配置」桥接：不填 API Key、不单独登录、不填 PAT。插件读取 Qoder CN 桌面客户端本地的加密凭据文件，配合 WASM 签名与 WAF 编码访问 Qoder 网关，在 DSH 里提供约 14 个模型、大上下文档位、联网搜索与图片上传等能力。

项目与 Qoder、DeepSeek、DeepSeek Harness 官方均无从属关系；实现基于对 Qoder CN 客户端本地文件与网络协议的分析，上游改版可能导致失效。插件以你运行 DSH 的进程权限在本机读写凭据与配置，安装与启用前请自行审阅源码与许可证。

核心功能¶

以下均来自仓库 README 与 package.json 说明。

凭据与模型¶

• 凭据自动发现：解密 %APPDATA%\com.qodercn.app.stable\auth.v1.dat（DPAPI + AES-256-GCM），并在 <DSH_HOME>/.qoder-auth.json 维护自留副本；双源择一、启动镜像、距到期不足 5 分钟自动调用 deviceToken/refresh 续期。
• 14 个模型：从官方目录实时拉取，失败时使用内置兜底；在 DSH 中选 provider qoder 即可使用。
• 上下文档位：目录支持 200K / 400K / 1M，默认可给最大档（配置项 contextTier 可逐模型覆盖）。

Agent 相关能力¶

• 联网搜索：可注册为 DSH 的 web 搜索 provider（默认 webSearch: true），走 Qoder 搜索端点。
• 图片上传：对话中的内联 base64 可上传到 Qoder 图床换 OSS URL，失败可回退（默认 imageUpload: true）。
• 回合身份：重建 business.id / stage，便于 Qoder 积分面板按回合聚合。
• 推理档位探测：实测各模型实际接受的 effort 档位。

账号与界面¶

• 额度 / 签到：查询剩余积分、订阅套餐；支持自动领取每日奖励（默认 30 分钟轮询，autoCheckIn: true）。
• 图形界面：DSH 插件详情页提供账号、额度、模型、档位、搜索、图片等 tab。
• 命令行：status、doctor、models、ask、refresh、logout、credits、checkin、search、upload 等。

环境要求¶

安装与启用¶

仓库 README 提供两种挂载方式，核心都是在 profile 里以本地包形式依赖插件。

方式一：作为 profile bundle（推荐）¶

将插件源码放到本机目录后，编辑 <DSH_HOME>/profiles/<profile>/package.json：

{
  "dependencies": {
    "dsh-qoder-connect": "file:/绝对路径/dsh-qoder-connect"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "dsh-qoder-connect"
      ]
    }
  }
}

在 profile 目录执行 pnpm install，然后重启 DSH。

方式二：放入插件目录¶

将整个插件目录复制到 <DSH_HOME>/.dsh/plugins/dsh-qoder-connect，再按上表在 profile 的 dependencies 与 bundles 中引用。

重启后打开 设置 → 插件 → DSH Qoder CN Connect，应能看到账号与模型列表。

典型用法¶

健康检查与试跑¶

# 四项全绿才算健康
dsh plugin --profile desktop exec dsh-qoder-connect doctor

# 查看模型目录
dsh plugin --profile desktop exec dsh-qoder-connect models

# 直接发起一次推理
dsh plugin --profile desktop exec dsh-qoder-connect ask qfmodel "你好"

在 DSH 对话或 agent 中选 provider qoder，再选具体模型即可。

常用 CLI¶

dsh-qoder-connect status              # 凭据 / 模型 / 额度总览
dsh-qoder-connect doctor [--json]     # 逐项体检
dsh-qoder-connect models [--json]     # 模型目录
dsh-qoder-connect ask <模型> <内容>    # 单次推理
dsh-qoder-connect refresh             # 立即续期
dsh-qoder-connect logout              # 删除自留凭据副本（不动桌面 App 登录）
dsh-qoder-connect credits [--json]    # 额度与套餐
dsh-qoder-connect checkin             # 立即签到
dsh-qoder-connect search "查询内容"    # 联网搜索
dsh-qoder-connect upload ./图片.png    # 上传图片

可选配置¶

可在 DSH 插件配置或 profile 的 cordis.patch.yml 中调整，例如：

uid / token 一般留空即可自动发现；手动指定仅在有特殊需求时使用。

适用场景与注意¶

适合谁：已在 Windows 上使用 Qoder CN 桌面订阅、希望在 DSH 里用同一账号跑 agent / 工具调用 / 联网搜索，且接受非官方桥接方案风险的开发者。

凭据与合规：README 明确说明协议为逆向分析所得，可能违反 Qoder 服务条款；账号限制、积分清零等风险自负。凭据仅在本地解密与续期，请求发往 Qoder 官方域名，但代码公开，需自行审计。lib/wasm_prelude.mjs 来自 Qoder CN 客户端的 WASM 签名模块，版权属 Qoder，介意者可按文档从本机安装目录自行提取。

删掉桌面 App 后：自留副本与自动续期可使插件在桌面 App 卸载后仍工作，直至 refresh token 长期过期（约一年量级）需再在桌面 App 登录一次。

DSH 生态：DSH 采用「一切皆插件」思路；SkillHub 目录页 为社区收录，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-qoder-connect 的价值在于：在 Windows + Qoder CN 已登录的前提下，以最少配置把桌面订阅模型、搜索与图床能力接到 DSH 的 qoder provider。使用前请完整阅读仓库免责声明，并在本机审阅代码后再启用。

• 目录页：https://www.skillhub.cn/plugins/YSwo-fei/dsh-qoder-connect
• GitHub：https://github.com/YSwo-fei/dsh-qoder-connect