前言¶
在 DeepSeek Harness（DSH）的 Web 客户端中，当用户通过 Settings -> Models 页面配置第三方提供商时，页面自带的表单刻意隐藏了两个关键字段：每个模型接受的输入模态（是否允许图片）以及推理级别。这通常迫使开发者直接编辑 YAML 配置文件或依赖适配器的默认行为。dsh-models-input-modalities 插件通过在 Web 界面直接暴露这些字段，解决了这一配置痛点。
这是什么¶
该插件由 DamonBao 维护，是一个 DSH Web 客户端插件。它为 Settings -> Models 页面上的每个第三方（pi-ai）提供商卡片添加了一个“模型能力”折叠面板。该面板允许用户声明每个模型接受的输入模态和推理级别，而无需手动编辑配置文件。
核心功能¶
- 输入模态选择器：提供三种选择：提供商默认、仅文本 或 文本和图片。插件会根据选择写入适配器所需的语义。选择“仅文本”写入
input: [text]，选择“文本和图片”写入input: [text, image]，选择“提供商默认”则移除该字段。 - 推理级别选择器：提供三种选择：目录默认、非推理模型 或 声明级别。展开“声明级别”后，提供七个选项：off, minimal, low, medium, high, xhigh, max。插件会将选中的级别写入
reasoningEfforts字典。适配器会验证声明的集合，拒绝无效设置（例如没有值的级别）。 - 冲突处理：使用 revision-fenced writes。当打开折叠面板读取数据时，插件会记录当前的 revision。写入时会以该 revision 为依据。如果发生并发编辑，会触发冲突通知并重新加载，而不是静默覆盖。
- 本地化支持：界面支持英文和中文，与 Web UI 的语言设置保持一致。
- 设置迁移：支持将旧版
llm-pi-ai配置迁移到新的 pi-ai 结构中。
安装与启用¶
插件需要通过 DSH 的插件管理器进行安装。
1. 在 DSH 的插件列表中找到该插件。
2. 执行安装操作。
3. 安装完成后，重启 dsh web 进程。
典型用法¶
- 打开 DSH，导航至
Settings -> Models。 - 找到对应的第三方提供商卡片，展开“模型能力”折叠面板。
- 针对特定模型，选择输入模态（例如：文本和图片）。
- 选择推理级别（例如：声明级别，并勾选 high）。
- 点击保存。配置将写入用户层文件
$DSH_HOME/profiles/<profile>/cordis.patch.yml。
适用场景与注意¶
- 适用场景：当你需要为特定模型启用图片输入，或者需要精确控制推理级别（特别是当适配器需要特定参数映射时），该插件提供了比手动编辑 YAML 更直观的方式。
- 注意：
- 插件不预先写入提供商配置（如 API Key、模型列表等），这些仍需通过标准表单创建。
- 适配器会拒绝无效的声明集合（例如只勾选了
off但没有拼写，或者有其他级别但没有拼写）。 - 插件会防止覆盖未保存的草稿。
- 在升级 DSH 前请备份
DSH_HOME。
短结尾¶
该插件通过在 Web 界面直接管理原本隐藏的模型能力字段，为 DSH 用户提供了更精细的配置控制。源码与文档可在 GitHub 查阅。
