前言¶

在 DeepSeek Harness（DSH）里接外部模型，常见做法是改 llm-pi-ai 配置或手写路由。若你用的是 QPCM 提供的 OpenAI 兼容网关（默认端点 https://ai.qpcmqam.cn/v1），还要自己处理 Base URL、API Key、模型清单和 provider 注册，步骤分散在配置文件和凭据里。

下面介绍社区插件 dsh-connect-qpcm-gateway（维护者 llersakuya）：在 Web UI 里完成网关接入，并把勾选的模型直接挂进 DSH 模型选择器，分类为「模型推理」。

这是什么¶

dsh-connect-qpcm-gateway 是 DSH 的 connect bundle：把 QPCM 网关当作 DSH 的 LLM 来源，并提供 插件 → QPCM 网关接入 设置页，用于填写 Base URL、保存 API Key、拉取 /models、勾选要提供的模型，以及开关「接入」。

插件不自带 pi-ai 与 dsh-llm-pi-ai，依赖 Host 里已有的 peer 包（@earendil-works/pi-ai 等）；须运行在已安装这些组件的 DSH 上，桌面版通常满足。当前 bundle 版本为 0.4.3，许可证 MIT。

核心功能¶

网关接入与多组 API¶

• 默认 Base URL 为 https://ai.qpcmqam.cn/v1；请求走 OpenAI Responses 协议：POST {baseURL}/responses，支持工具调用、流式与推理档位（相对 /chat/completions，README 记载实测上 reasoning 条目、reasoning.effort 与多轮回放更完整）。
• 面板支持多组配置（最多 8 组）：每组独立的 Base URL、API Key（凭据引用互不串用）、模型清单与「接入」开关；各组模型同时出现在选择器中，显示为 分组名 / 模型名。默认第一组路由 id 为 qpcm-gateway。
• API Key 写入 owner-only 的 ~/.dsh/.credentials.yaml，引用名默认 QPCM_API_KEY；不写进配置、状态文件或日志。

按模型自定义¶

网关 /models 只返回 id 与名称，上下文与输出上限由插件面板补齐并可覆盖：

设置保存在 ~/.dsh/state/<profile>/dsh-connect-qpcm-gateway/state.json，不写入 llm-pi-ai 配置。

推理档位¶

插件对外只声明 off / medium / high（minimal / low 在多数模型上实测几乎无 reasoning_tokens，故不提供）。明文推理摘要依赖流式 SSE，非流式多为加密内容；面板不保证每轮都可见思考过程，reasoning_tokens 在 usage 中仍可用。

明确不做的事¶

• 不修改 profile 里已有的 llm-pi-ai 配置；注册路由 id 与内置 gpt-2610 等并列且不冲突。
• 不提供图像生成模型（如 gpt-image-2.5-flare 在 /responses 上 502，DSH LLM 接缝无图像生成接口），目录中相关 id 标为「不是对话模型」且不进候选。

安装与启用¶

推荐用发布包 .tgz 安装，无需本机 git、无需放行 pnpm 构建脚本：

dsh plugin --profile desktop add https://github.com/llersakuya/dsh-connect-qpcm-gateway/releases/download/v0.4.3/dsh-connect-qpcm-gateway-0.4.3.tgz

桌面版也可在 设置 → 插件 → 安装 bundle 中粘贴同一 .tgz 地址。

装完后打开 插件 → QPCM 网关接入，粘贴 API Key，点「保存并验证」。目录拉通后插件会自动接入，模型出现在模型选择器里，无需重启，也无需再单独拨「接入」开关（若你关闭过接入，需在面板重新打开）。

若希望跟踪仓库 main，仍可用 git 方式（需本机有 git，且可能受 pnpm allowBuilds 影响）：

dsh plugin --profile desktop add github:llersakuya/dsh-connect-qpcm-gateway

改过插件 Host 侧代码后，需关闭再打开插件一次才会重新加载（HMR 默认忽略 node_modules 下的插件）。

典型用法¶

1. 安装 bundle（见上一节命令）。
2. 在 QPCM 网关接入 中确认或修改 源站地址（默认可一键恢复 https://ai.qpcmqam.cn/v1）。
3. 填写 API Key 并「保存并验证」——成功后会拉取模型目录；失败时常见为 HTTP 401（密钥错误）或 MISSING_CREDENTIAL（未保存密钥）。
4. 在模型目录中 全选 / 全不选 / 逐个勾选 要提供的对话模型；确认 接入 开关为开。
5. 在会话的模型选择器里选 分组名 / 模型名 即可对话；需要时在每行模型设置里调整上下文、最大输出或「收图」（多数 QPCM 模型不收图，默认关闭）。
6. 需要第二套端点或密钥时，在面板顶部 添加一组，最多 8 组。

出厂默认与面板状态分层：cordis.patch.yml 在安装时写入 profile patch；面板改动的字段进 state.json，避免写配置触发插件重载打断进行中的请求。enabledIds 为空数组表示不过滤目录中全部 chat 模型；全不选需使用哨兵 __hide_all__。

适用场景与注意¶

适合谁：已在用或打算用 QPCM 网关（ai.qpcmqam.cn）作为 OpenAI 兼容后端的 DSH 用户，希望用 UI 管理 Key、模型白名单和多组端点，而不是手改 llm-pi-ai。

使用前请知悉：

• 插件以当前 DSH 进程权限运行；安装前建议阅读 GitHub 仓库 源码与 MIT 许可证，并自行评估将 API Key 交给插件凭据存储是否可接受。
• 社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系；插件归属维护者 llersakuya。
• 若选择器无模型：检查「接入」是否开启，或勾选清单是否为「全不选」；若 Host 报 peer 相关 provider.failed，说明缺少 @earendil-works/pi-ai 或 @deepseek-ai/dsh-llm-pi-ai。

结尾¶

dsh-connect-qpcm-gateway 把 QPCM OpenAI 兼容网关收成一块可操作的 DSH 模型来源：安装 bundle、在面板验 Key 与选模型，即可在 Harness 里走 /responses 完成对话与推理档位调用。

• 目录页：https://www.skillhub.cn/plugins/llersakuya/dsh-connect-qpcm-gateway
• 源码与 README：https://github.com/llersakuya/dsh-connect-qpcm-gateway