dsh-dmxapi

配置体验与密钥保护

三种 DMXAPI 预设已填好各自的模型清单；也可选择 新建自定义服务商。选择预设时，插件优先打开 ID 和协议相符的已有服务商；如果存在历史副本，可明确选择要编辑的路由。展开模型卡可以检查图片输入、思考选项和容量，新增、修改或移除模型后保存。模型仍由 Harness 原生聊天菜单选择，图片仍通过原生附件按钮上传。

编辑已有路由时，插件只更新其模型列表及表单中调整的默认思考等级，保留服务商 ID、API Key 引用、API 地址、协议与其他服务商。需要另一份服务商时，明确选择 新建独立配置，插件才会分配 dmxapi-chat-2、dmxapi-chat-3 等可用标识；手动填写已有标识作为新配置时会拒绝新增。新建自定义服务商和 YAML 导入仍作为独立新增，不会覆盖同名旧配置。安装或升级插件不会自动迁移或改写已有模型配置。

首次新建服务商时，填写 API Key 会生成独立的随机凭据引用，不替换任何旧引用中的密钥。输入框留空时，仅保留草稿中显式导入的凭据引用，不读写凭据。编辑已有服务商的模型时无需重新输入 Key，也不会写入或读取旧密钥。新建保存成功后输入框清空并恢复隐藏；切换预设或取消修改也会清空当前输入。如果新建配置成功但密钥写入失败，“重试密钥”只重试本次创建的密钥，并检查创建版本和引用，不重复写模型配置；也可选择“继续新建”，稍后在原生模型页补充。

新建草稿中的模型可以独立设置文本/图片、上下文、输出上限和思考选项。技术传输方式与 YAML 放在折叠的高级配置中。不要把密钥填进 YAML，也不要在配置中写 apiKey。密钥由 Harness 凭据服务保存，apiKeyEnv 仅作为引用。导入只读环境变量引用也不限制填写新密钥：填写时为新服务商独立保存，原引用保持不变。