前言¶
DeepSeek Harness (dsh) 桌面版原生支持多模态(图片理解),但官方设置页面没有提供声明自定义提供商或第三方模型输入模态(input)的入口。如果添加的模型实际上支持图片,发送图片时仍会报错提示“当前模型不支持图片”。目前的变通方案是手动编辑 settings.yaml 并添加 input: [text, image],这种方式操作繁琐且容易出错。dsh-vision-toggle 插件为此提供了图形化的解决方案。
这是什么¶
这是由 lijian-ui 维护的客户端插件,为 DeepSeek Harness (dsh) 提供按模型的「支持图片」开关,让用户在设置页一键启用/禁用图片输入,无需手动编辑配置文件。
核心功能¶
- 按模型管理视觉输入开关:为每个配置的模型提供独立的图片输入控制。
- 读取路由模型:自动读取
llm-pi-ai提供商路由中的所有模型。 - 即时生效:修改开关后立即生效,无需重启桌面应用。
- 乐观 UI 反馈:界面操作即时响应,若写入失败则自动回滚。
- 国际化支持:支持中英文界面切换。
安装与启用¶
- 确保环境满足 Node.js >= 18。
- 执行安装命令:
dsh plugin add @lijian-ui/dsh-vision-toggle
- 安装完成后,需要重启桌面应用。
典型用法¶
- 打开 dsh 桌面应用。
- 导航至 设置 -> Model Vision。
- 该板块列出所有已配置的模型(按提供商分组)。每个模型旁边都有一个“Support image”开关:
- 开启:模型接受图片输入,现在可以在聊天中附加图片。
- 关闭:模型变为纯文本模式。
适用场景与注意¶
- 适用场景:主要用于通过
llm-pi-ai提供商路由管理的模型,特别是那些实际支持图片但未在配置中声明输入模态的自定义或第三方模型。 - 注意事项:插件仅在
llm-pi-ai提供商路由下工作。安装后必须重启桌面应用才能加载插件。若写入配置失败,开关会自动恢复到之前的状态。