dsh-plugin-effort-declare
中文 ·
English
这是 DeepSeek Harness（DSH）的设置插件：为手工添加的 OpenAI 兼容模型声明推理档位与图片输入。声明之后，对话输入框才会出现 Effort 行，并允许附加图片；未声明则按纯文本模型处理。
社区维护的第三方 DSH 插件，并非 DeepSeek 官方项目，亦未经官方背书。要求 DeepSeek Harness 0.1.2-alpha.2；更早的客户端 API（含此前对接的 0.1.0-rc.8）不再支持。
作用
在「模型」页手工添加的第三方提供方，默认不会声明 reasoningEfforts 与 input。DeepSeek Harness 据此决定是否展示 Effort 选择器、是否接受图片附件。本插件在设置中增加 推理档位 页，向官方 llm-pi-ai 命名空间写入这两项能力。每轮选用哪一档、请求如何发往网关，仍由 Harness 处理。本插件不修改 API 密钥、端点或模型名单。
- 不改写用户尚未保存的模型
- 不改写当前或默认推理档
- 不替换官方「模型」页
- 不拦截模型流，也不替换适配器
功能
| 功能 | 说明 |
|---|
| 推理档位 | 按模型勾选可选档位；网关拼写不同时可改写线上名称 |
| 图片输入 | 按模型声明是否接受图片。勾选写入 input: ['text', 'image']；取消则删除该键，不写空列表 |
| 预设 | DeepSeek 兼容、OpenAI 兼容、仅开/关。预设替换当前协议方言，而非叠加 |
| 与「模型」页 | 「模型」页管理端点、密钥与模型名单；本页只声明推理档位与图片输入 |
| 版本页脚 | 页面底部显示打包时写入的插件版本与版权年；启动 Harness 不会更新日期 |
安装
不要使用 npm install。在终端执行：
dsh plugin --profile web add dsh-plugin-effort-declare
若使用第三方发行的 DeepSeek Harness，必须先设置 DSH_HOME，否则会装到另一目录。步骤见 安装说明。更新已安装的 npm 包：
dsh plugin --profile web update dsh-plugin-effort-declare
或 add dsh-plugin-effort-declare@latest。详见 安装说明 的「更新」。
安装后重启 DSH，打开 设置 → 推理档位。页脚可核对已安装版本。请先在「模型」页添加第三方提供方。从 GitHub、本地文件夹安装以及卸载，见 安装说明。
使用
- 打开对应提供方卡片，或先应用一套预设。
- 勾选应出现在选择器中的推理档。网关名称不同时修改线上拼写。关闭思考（Off）可以：不提供、提供但不发送参数，或发送
none 等字符串。
- 若该模型支持视觉，勾选 支持图片输入。仅在模型确实接受图片时勾选：误声明会使图片进入会话历史，随后被网关拒绝。
- 「高级」协议选项通常可保持折叠。
- 保存。未选择任何思考档、或只开启 Off 时，错误显示在该卡片上。只修改图片输入、不改档位，也可以保存。清除档位声明不会清除图片输入。
设置为只读时无法保存。
限制
- 仅适用于在「模型」页手工添加、协议为 OpenAI Completions 的提供方
- 官方 DeepSeek、目录自带模型、Anthropic 接口不在本页编辑
- 「清除本模型声明」只移除
reasoningEfforts，Effort 行随之隐藏；图片声明需单独取消勾选
- 不会为标题生成、压缩等后台请求默认打开思考
- 不会为整条路由或全部模型自动打开图片输入
开发
修改代码、提交 Pull Request、发布到 npm：见 CONTRIBUTING.md。
License
MIT © 2026 Stardust
