前言¶

在 DeepSeek Harness（DSH）里做智能体或日常对话，模型来源通常是云端 API Key 或自建反代。若你已经在本机安装 Qoder 并用 qoderclicn login 完成登录，模型能力其实在 CLI 里，却未必能直接出现在 DSH 的模型选择器里。自己再搭一层 HTTP 反代，还要处理鉴权与协议对齐，成本不低。

下面介绍社区插件 DSH Qoder Connect（仓库 chilianxiao/dsh-qoder-connect）：它不另起 OAuth，也不把请求转发到上游 HTTP，而是把本机 qoderclicn 的登录态包装成 OpenAI 兼容 Provider，让 Qoder 模型以「Qoder」分组出现在 DSH 中。插件由维护者 chilianxiao 发布，在 SkillHub 目录中归类为「模型推理」；反代核心移植自 1416277987/proxy-hub 的 adapters/qoder.js，插件结构参照 corrinehu/dsh-workbuddy-connect（MIT）。

这是什么¶

一句话：复用本机 Qoder CLI 的登录态与调用路径，在 DSH 里以标准聊天补全接口使用 Qoder 模型，零额外 OAuth 配置。

本机已登录的 CLI 就是「上游」；插件负责探测登录态、拉取模型列表、把 DSH 请求翻译成 qoderclicn 子进程调用，并在 Web 端提供设置卡片与模型选择器集成。

核心功能¶

登录态与 CLI 解析¶

• 复用 qoderclicn login 落盘凭证，无需插件单独走登录流程。
• 自动识别多种登录态路径：~/.qoderworkcn/.auth-cn/user、~/.qoder-cn/.auth/user、~/.qoder/.auth/user；也可使用环境变量 QODERCN_PERSONAL_ACCESS_TOKEN。
• CLI 不在 PATH 时，按 PATH → 默认安装目录（如 ~/.qoder-cn/bin/qoderclicn、~/.qoder/bin/qodercli）解析；Windows 下 .cmd shim 通过 shell 启动。

模型列表与分组¶

• 启动时执行一次 qoderclicn --list-models；之后在设置卡片点「重新拉取模型」才会再拉。Qoder 新增模型一般无需更新插件即可出现在选择器。
• 拉取失败时保留上次成功结果（已落盘），分组不会整体消失；设置卡片会标明列表来自 CLI、上次保存还是内置兜底。
• 未安装 CLI 或未登录时「Qoder」分组隐藏；登录后无需重启 DSH 即可出现。
• DSH 内模型 id 为 qoder- + CLI 名小写化；显示名沿用 CLI 拼写。

推理档位与官方目录¶

• 模型选择器支持按模型展示推理等级（如 low / medium / high / xhigh / max），逐次请求映射为 CLI 的 --reasoning-effort；各模型只显示官方目录声明的有效档位。
• 插件读取 Qoder 官方客户端缓存的加密模型目录（QMC v1），解密后用于展示 price_factor、错峰促销、逐模型推理档位与上下文窗口声明——不依赖本机实测反推系数。
• 设置卡片可配置全局推理等级、思考模式、思考预算；单次请求在选择器里选的档位优先于全局项。全局推理等级可填选择器没有的值（如 auto、ultracode），会原样下发且不经逐模型校验，模型不支持时会静默回落默认档。

图片、上下文与模型开关¶

• 官方目录标记 is_vl 的模型在选择器中声明图片能力；图片以 data URL 经 --attachment 交给 CLI，不发起远程图片 HTTP 请求。
• 「使用上游声明的最大窗口」开关：开启时按目录声明的最大上下文请求；关闭时使用官方客户端默认（通常 200K）。
• 设置卡片可对单个模型开关，配合搜索与「全部开启 / 全部关闭」。

流式、超时与用量账本¶

• 支持 /v1/chat/completions 流式与非流式；客户端断开或超时（默认 600s，可用 QODER_TIMEOUT_MS 调整）会终止 CLI 子进程。
• 对话结束后尽力将 CLI 自报的 total_credits 写入 $DSH_HOME/qoder-credits/ledger.jsonl，可配合 dsh-qoder-credits 悬浮窗查看趋势；账本写入失败不影响对话本身。

安装与启用¶

前置条件：本机已安装 Qoder，并至少执行过一次 qoderclicn login（或配置 QODERCN_PERSONAL_ACCESS_TOKEN）。

从 GitHub 安装（README 推荐方式）：

dsh plugin --profile web add github:chilianxiao/dsh-qoder-connect
dsh web

安装后需把 dsh-qoder-connect 加入对应 profile 的 package.json 里 dsh.profile.bundles 列表（dsh plugin add 只完成 pnpm 装包，bundles 需手动维护），再启动或重启 Web 界面。

版本说明：插件按 DSH 0.1.6-alpha.2 起的接口编写；设置卡片依赖 DSH 0.1.7 起的 settings API，在 0.1.6 上卡片可能无法保存。当前插件版本为 0.2.1（见仓库 package.json）。

注意：npm 上另有作者 masknull 的同名包 dsh-qoder-connect，实现不同；本插件请使用上述 GitHub 安装方式，不要用 npm add dsh-qoder-connect 代替。

典型用法¶

1. 完成 Qoder CLI 登录后，按上一节安装并启用 bundle，启动 dsh web。
2. 打开 设置 → 插件 → Qoder 卡片，确认 CLI 路径、登录方式、登录态文件与模型列表；未就绪时按卡片提示修复。
3. 在模型选择器中选择「Qoder」分组下的模型；需要时设置推理档位、附件图片，或在该卡片调整全局推理/思考参数。
4. 若官方客户端已更新模型目录，可在卡片点击「重新拉取模型」同步列表与系数展示。

常用环境变量与设置项（完整表见 README）：

适用场景与注意¶

适合谁： 已在本机使用 Qoder CLI 订阅或额度，希望在 DSH Web 界面里统一选模型、调推理档位、看图对话，并顺带记录 total_credits 账本的用户。

运行权限： 插件随当前 DSH 进程运行，会启动本机 qoderclicn 子进程并读取用户目录下的登录态与官方模型缓存。安装前请自行审阅 仓库源码 与 MIT 许可证，确认符合你的安全与合规要求。

生态说明： DSH 采用「一切皆插件」的扩展方式；SkillHub 插件目录 为社区站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

DSH Qoder Connect 把「本机已登录的 Qoder CLI」直接接到 DSH 的模型 Provider 层：无额外 OAuth、模型列表跟 CLI 走、推理档位与价目系数跟官方目录走。若你正在 DSH 里编排智能体，又希望复用现有 Qoder 账号，可以从目录页与 GitHub 获取插件并按 README 安装。

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