dsh-connect-qpcm-gateway

dsh-connect-qpcm-gateway

把 https://ai.qpcmqam.cn/v1 这个 OpenAI 兼容网关接成 DSH 的模型来源，并给出一块可以在 Web UI 里操作的面板。

可以接多组：每组有自己的端点、Key 和模型清单，同时出现在模型选择器里。

安装

一条命令，不需要 git、不需要放行构建脚本、不需要装任何工具：

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

桌面版用户也可以在 设置 → 插件 → 安装 bundle 里直接粘贴同一个 .tgz 地址。

装完打开 插件 → 模型网关接入工具，粘一次你的 API Key，点「保存并验证」。 目录拉通之后插件会自动接入，模型立刻出现在模型选择器里，不用重启，也不用 再去拨那个开关。

为什么用 .tgz 而不是 github: 地址

git 方式仍然可用，适合想跟最新提交的人：

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

改过本插件的 Host 侧代码后，要把它关掉再打开一次才会重新加载：HMR 默认忽略 **/node_modules，而插件正好装在那里。

依赖

本插件不自带 pi-ai 与 dsh-llm-pi-ai，它用的是 Host 里已有的那两份 （peerDependencies，且全部标为 optional）。这也意味着它必须跑在装有 @earendil-works/pi-ai 的 DSH 上——正常的桌面版都满足。

多组 API

面板最上面是分组列表。添加一组之后，这一组有自己的：

• Base URL（各组的端点互相独立）
• API Key（存在各自的凭据引用里，互不串用）
• 模型清单（各自的 /models 结果与勾选）
• 接入开关（可以只开其中一组）

各组的模型同时出现在模型选择器里，以路由 id 区分——模型选择器里看到的是 分组名 / 模型名。默认第一组的 id 是 qpcm-gateway（v0.3.x 就用这个， 所以老会话里的模型引用不会失效），之后新建的按你填的名字派生。

最多 8 组。这个上限是刻意的：每一组都会往模型选择器里塞条目，没有上限会把那里 淹掉。

一组的 Key 只有存进它自己的凭据引用才生效。删除一组会保留它的 Key 引用 （不删你磁盘上的密钥），但不再使用。

它做什么

• 在 插件 → 模型网关接入工具 里填 Base URL、存 API Key、拉取模型目录、勾选要提供的模型。
• 打开「接入」开关后，被勾选的模型直接出现在模型选择器里，走 POST {baseURL}/responses（OpenAI Responses 协议，含工具调用、流式、推理档位）。
• 每个模型可以单独调上下文窗口、最大输出 token、输入模态，见下一节。
• 在 设置 → 模型 里，每条连接以它自己的路由 id 出现，和手写 llm-pi-ai 的那几条并列。

按模型自定义

网关的 /models 只给 id 和名字，不给窗口和上限——所以这些数字原本是本插件写死的 兜底值。现在每个模型后面都有一行设置：

改完点那一行的保存才生效；有覆盖的模型会带一个「已自定义」标记，点恢复默认可以撤掉。

三个字段都真的影响请求，不是摆设：

• maxTokens 会经 pi-ai 的 clampMaxTokensToContext(model, context, maxTokens) 落到 max_output_tokens， 并且被上下文窗口反向截断——窗口设得比输出上限还小的时候，实际发出去的数字 会比填的小。
• input 决定带图请求能不能发。默认开启；某个模型带图报错时，把那一行的收图 关掉即可（改动只影响该模型）。

「最大输出」留空是有意的：网关没声明上限，猜一个数字等于把「平台没说」写成 「平台说了」。填了就是明确告诉 DSH 你希望的上限。

设置存在插件自己的状态文件里（~/.dsh/state/<profile>/dsh-connect-qpcm-gateway/state.json）， 不写进你的 llm-pi-ai 配置。

为什么走 /responses 而不是 /chat/completions

这个网关两个端点都通，但 /responses 在实测里多出三样东西：

1. 推理内容以独立 reasoning 条目回来（带 encrypted_content，可整条回放）。
2. reasoning.effort 真的能调：high 在难题上稳定产出 reasoning_tokens 与明文推理摘要，medium 次之。
3. 多轮回放被接受：把上一轮的 reasoning / output_text 原样放回 input， 再追加新输入，实测 200；带不带 encrypted_content 都接受。

文本、工具调用、流式、多轮对话、系统提示在 /responses 上逐项验证通过。

推理档位：off 到 max 全开，外加自动档

thinkingLevelMap 声明整条阶梯，全部可选：

不声明 defaultEffort，模型选择器里就会多出一项「provider default」——那就是 自动档：请求里不带 reasoning 参数，跟手动选档位是两条不同的路径。

七个发送值在两条路由上都逐个实测过，全部 HTTP 200（deepseek-v4-pro 与 gpt-6.1-sol）。也就是说选了不会报错；至于每个后端会不会因为换档而真的改变 思考量，取决于那个后端自己——早期实测里 minimal / low 在不少模型上 reasoning_tokens 为 0。

档位名由 DSH 的 pi-ai 适配器按 id 自动生成（Off / Minimal / … / Max）， 插件无法改写成「Ultra」之类的自定义文案；最高档就是 max，显示为 Max。

推理明文不是每轮都有

网关的明文推理走 SSE 的 response.reasoning_summary_text.delta，且只在流式请求 里发；非流式请求只回 encrypted_content（加密）。即使流式，它也按模型和请求 波动——同一模型同一档位两次请求，一次有摘要、一次没有。因此面板不承诺「每轮都 看得见思考过程」；reasoning_tokens 在 usage 里始终可靠。

它不做什么

• 不改 profile 里已有的 llm-pi-ai 配置。本插件注册的路由 id 是 qpcm-gateway，与 gpt-2610 / ds-v41-flash / zai 不冲突——registerAdapter 对已占用路由整组拒绝，所以这一点是硬要求。
• 不把 API Key 写进配置、状态文件或日志。Key 只落 owner-only 的 ~/.dsh/.credentials.yaml，引用名默认 QPCM_API_KEY。
• 不提供图像模型。gpt-image-2.5-flare 与 -sunburst 在 /responses 上稳定 502，只在 /images/generations 上 200；而 DSH 的 LLM 接缝没有图像生成能力 （PiAiAdapter 上有 prepareCall / stream，没有 generateImages；dsh-llm 里也搜不到相关接口）。列出来只会让模型选择器里出现一个必然失败的条目，所以 这些 id 在目录里标为「不是对话模型」，不进候选。它们在 /chat/completions 上同样是 400。

配置怎么分层

生效值 = 状态文件里有的字段覆盖出厂默认，没有的字段继续跟随 patch。这样面板写路径 不会因为写配置而重载本插件（重载会打断正在跑的请求）。

cordis.patch.yml 里的字段

enabledIds 的三态

裸 [] 已经被「全部」占了，所以「全不选」必须走哨兵。Host 与客户端读同一个字面量。

面板能做什么

• 源站地址：改 Base URL，或一键恢复默认。改地址会丢掉旧目录（换端点等于换了一个目录）。
• API Key：保存即验证——存完立刻拉一次 /models，成功与否当场显示；也能清除。
• 模型目录：显示 id、显示名、能不能当对话模型用；全选 / 全不选 / 逐个勾选。
• 接入开关：开 / 关 provider 注册，不需要重装插件、不需要重启。

排障

面板里的每一次写操作都是同源请求；Host 侧对 Host / Origin 有围栏，跨站页面 拿不到这块面板的读写面。

许可证

MIT