前言¶
在 DeepSeek Harness 里接第三方模型聚合服务，常见做法是手写服务商 YAML、配环境变量里的 API Key，或在多处重复建同一家服务商。DMXAPI 用一把 Key 覆盖多种协议与模型，但路由 ID、上下文上限、思考参数和图片能力仍要逐项对齐 Harness 的配置格式。
下面介绍维护者 YV919 发布的 DMXAPI-DSH 配置工具（仓库 YV919/dmxapi-dsh，SkillHub 分类为 admin-security）。它在 Harness 桌面端与 Web 工作台提供表单化配置：选接口预设、填密钥、增改模型，保存后仍在原生聊天界面选模型，无需把密钥写进 YAML。
这是什么¶
DMXAPI-DSH 配置工具（npm 包名 dsh-dmxapi，当前 Release 0.2.1，MIT 许可证）是面向 DMXAPI 的 Harness 插件。官方说明：在 DeepSeek Harness 桌面和 Web 工作台配置模型、密钥，并编辑已有服务商的模型。
插件 0.2.1 适用于 DeepSeek Harness Desktop / Web 0.2.0-rc.2，并已通过 0.2.1-alpha.2 SDK / runtime 兼容验证。仍使用旧 Harness Web 0.1.5-rc.2 的用户需保留插件 v0.1.9。
核心功能¶
三种 DMXAPI 接口预设¶
可按协议分别配置：
- DMXAPI · Chat（OpenAI Chat Completions）
- DMXAPI · Responses（OpenAI Responses）
- DMXAPI · Anthropic（Anthropic Messages）
同一服务商内添加模型时共用该服务商的协议；需要另一种请求格式时，切换到对应协议的预设即可。
12 个模型预设¶
插件按接口预填模型 ID，以及图片输入、上下文、输出上限和适用的思考选项；数值可在表单中核对和调整。可用模型、账号权限与计费以你的 DMXAPI 账号及 DMXAPI 模型目录 为准。
| 格式 | 模型 ID | 图片 | 上下文 / 最大输出 | 默认可选思考等级 |
|---|---|---|---|---|
| Chat | deepseek-v4.1-flash |
是 | 1M / 384K | off / low / high / max |
| Chat | glm-5.3 |
否 | 1M / 128K | low / high / max |
| Chat | glm-5.3-flash |
是 | 1M / 128K | low / high / max |
| Chat | qwen3.8-max |
是 | 1M / 131072 | off / medium / xhigh |
| Chat | qwen3.8-max-0902 |
是 | 1M / 131072 | off / medium / xhigh |
| Chat | mimo-v2.6-pro |
是 | 1M / 128K | 关闭 / 开启 |
| Responses | gpt-6-astra |
是 | 1050K / 128K | low / high / max |
| Responses | gpt-6-sol |
是 | 1050K / 128K | off / low / high / max |
| Responses | gpt-6-luna |
是 | 1050K / 128K | off / low / high / max |
| Anthropic | claude-fable-5-1-cc |
是 | 1M / 128K | low / high / max |
| Anthropic | claude-opus-5-5-cc |
是 | 1M / 128K | low / high / max |
| Anthropic | claude-sonnet-5-cc |
是 | 1M / 128K | off / low / high / max |
DMXAPI 对具体 ID 的路由、账号权限及参数支持仍需用自己的 Key 验证；名称带 -cc 的 Claude 路由 ID 为 DMXAPI 侧标识，不应去掉 -cc 后当作 Anthropic 原生模型 ID 发送。
密钥与已有服务商¶
- API Key 在插件内填写，默认隐藏，可切换显示；保存时交给 Harness 凭据服务，无需写入 YAML 或配置环境变量。
- 选择预设时，插件优先打开 ID 和协议相符的已有服务商；增改模型后点 保存模型修改，不重建服务商，也不改动已有密钥、地址和协议。
- 需要另一份配置时，可明确选择 新建独立配置（会分配
dmxapi-chat-2等标识），或 新建自定义服务商，以及导入、导出单服务商 YAML。YAML 中不要写apiKey；密钥由凭据服务保存，apiKeyEnv仅作引用。
思考等级与多模态¶
Qwen 预设使用原生 off / medium / xhigh；MiMo 在表单与聊天菜单中显示 关闭 / 开启；其他模型只展示各自预设支持的选项。模型仍由 Harness 原生聊天菜单选择，图片仍通过原生附件按钮上传。
安装与启用¶
经过下面的步骤，可在 Harness 工作台安装预构建包 0.2.1。
- 左侧打开 插件 → 添加插件，粘贴 Release 安装包地址：
https://github.com/YV919/dmxapi-dsh/releases/download/v0.2.1/dsh-dmxapi-0.2.1.tgz
- 点击 安装，完成后 立即启用；若 Harness 提示重启，按提示操作。
- 打开 插件 → DMXAPI-DSH配置工具，选择接口预设。首次创建服务商时填写 DMXAPI API Key 并 新增配置；已有同 ID、同协议服务商时，直接增改模型并 保存模型修改。
Windows 用户可下载 v0.2.1 安装 ZIP，解压后在完全退出桌面端托盘后运行 ./install.ps1（默认 desktop profile）。Web 用户运行 ./install.ps1 -Profile web，需 Node.js ^22.19.0 或 >=24.0.0。更细的步骤见仓库 QUICKSTART.md。
GitHub Release 提供公开安装包；社区插件市场收录状态以 awesome-dsh-plugin 相关 PR 与市场目录为准，与 DeepSeek / 幻方无官方从属关系。
典型用法¶
- 安装并启用插件后，进入 DMXAPI-DSH配置工具。
- 在 DMXAPI · Chat、Responses 或 Anthropic 中选一种接口预设；若已有同协议服务商，表单会优先打开该路由。
- 首次：填写 API Key → 新增配置。已有服务商：展开模型卡检查图片、思考选项与容量，新增或修改模型 → 保存模型修改（无需重填 Key）。
- 回到聊天，从原生模型菜单选择刚保存的模型；需要换协议格式时，回到插件选择另一预设，而不是在同一服务商里混用协议。
配置前建议对照 DMXAPI 模型列表查询说明 中的 supported_endpoint_types，确认模型支持的接口格式。表单保存成功只表示通过 Harness 配置校验，不能代替真实接口验收。
接口地址（DMXAPI 预设）¶
插件对精确匹配 DMXAPI 预设根地址或 /v1 的配置，会按协议修正地址：
| 协议 | DMXAPI 配置地址 | SDK 请求路径 |
|---|---|---|
| OpenAI Chat Completions | https://www.dmxapi.cn/v1 |
/v1/chat/completions |
| OpenAI Responses | https://www.dmxapi.cn/v1 |
/v1/responses |
| Anthropic Messages | https://www.dmxapi.cn |
/v1/messages |
Anthropic 使用根地址可避免 SDK 拼出 /v1/v1/messages。密钥需与所在站点域名匹配，详见 DMXAPI 地址说明。
适用场景与注意¶
适合谁： 已在或计划使用 DMXAPI 统一 Key 的 Harness 用户，希望在 GUI 里维护 Chat / Responses / Anthropic 三类路由和模型列表，并减少手写 YAML 与环境变量。
安装前建议： 插件在 Harness 进程权限下运行，安装前应查看 源码与 MIT 许可证，确认符合你对 admin-security 类插件的信任要求。安装或升级插件不会自动迁移或改写已有模型配置；编辑已有路由时仅更新模型列表及表单中调整的默认思考等级。
结尾¶
DMXAPI-DSH 配置工具把 DMXAPI 的三类协议、12 组模型预设和 Harness 凭据服务接到同一套表单流程里：装包、选预设、填 Key 或改模型、回到原生聊天选用。目录与详情见 SkillHub 插件页，源码与 Release 见 GitHub：YV919/dmxapi-dsh。
