在 DeepSeek Harness (DSH) 中，当你在「模型」页手工添加第三方提供方时，系统默认不会声明 reasoningEfforts（推理档位）与 input（图片输入）能力。这导致对话界面无法显示 Effort 选择器，或者无法上传图片。dsh-plugin-effort-declare 插件用于解决这一问题，它通过在设置中增加「推理档位」页面，向官方 llm-pi-ai 命名空间写入这两项能力。声明之后，对话输入框才会出现 Effort 行，并允许附加图片；未声明则按纯文本模型处理。
这是什么¶
这是一个社区维护的 DSH 插件，由 zimodzh 开发，遵循 MIT 许可证。它不修改 API 密钥、端点或模型名单，也不替换官方的「模型」页或拦截流。它仅作用于在「模型」页手工添加、协议为 OpenAI Completions 的提供方，帮助开发者手动声明模型的能力边界。
核心功能¶
该插件主要提供以下能力：
- 推理档位：按模型勾选可选档位；若网关对档位的拼写要求不同，可在此修改线上名称。
- 图片输入：按模型声明是否接受图片。勾选时写入
input: ['text', 'image']，取消则删除该键。 - 预设：提供 DeepSeek 兼容、OpenAI 兼容等协议方言预设，用于替换当前协议，而非叠加。
- 版本页脚：页面底部显示打包时写入的插件版本与版权年份。
安装与启用¶
该插件要求 DeepSeek Harness 0.1.2-alpha.2 及以上版本。在终端执行以下命令安装：
dsh plugin --profile web add dsh-plugin-effort-declare
若使用第三方发行的 DSH，必须先设置 DSH_HOME 环境变量，否则包可能被安装到错误目录。安装完成后，重启 DSH 并进入 设置 → 推理档位 页面。页面底部会显示当前安装的版本。
典型用法¶
- 打开模型卡片：在「模型」页找到需要配置的第三方提供方。
- 配置推理档位：勾选应出现在选择器中的推理档。若需关闭思考（Off），可配置为不提供、提供但不发送参数，或发送
none等字符串。 - 配置图片输入：若该模型确实支持视觉，勾选 支持图片输入。仅勾选此项也可独立保存。
- 保存设置：点击保存。若未选择任何思考档或只开启 Off，错误会显示在该卡片上。
- 处理清除：点击「清除本模型声明」只会移除
reasoningEfforts，图片输入的声明需单独取消勾选。
适用场景与注意¶
- 适用范围：仅适用于在「模型」页手工添加、协议为 OpenAI Completions 的提供方。
- 排除项：官方 DeepSeek、目录自带模型、Anthropic 接口不在本页编辑。
- 权限安全：插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
- 限制：设置为只读时无法保存；不会为标题生成或后台请求默认打开思考；不会为整条路由自动打开图片输入。