前言¶
DeepSeek Harness（DSH）采用插件化架构，扩展功能通常通过修改配置文件或直接注入 Bundle 实现。在管理模型能力时，有时需要针对特定模型配置输入模态（如是否支持图像）或推理努力级别。dsh-model-modality 插件通过修改 DSH 的 Web Models 设置页面，提供了可视化的配置入口，直接写入 input 和 reasoningEfforts 字段，无需手动编辑配置文件。
插件定位¶
该插件由开发者 hmtxj 维护，旨在为 DSH 的 Models 设置页面增加针对单个模型的控制能力。它作用于由 @deepseek-ai/dsh-llm-pi-ai 适配器管理的 Provider，将原本只能在配置文件中体现的模型能力声明，下沉到 UI 界面进行操作。
安装与启用¶
安装插件需要通过 CLI 命令执行，安装后需重启对应的 DSH Profile。
dsh plugin --profile web add github:hmtxj/dsh-model-modality
安装完成后，重启目标 Profile，在 Web 界面进入 Settings → Models 即可看到相关控制项。
功能说明¶
插件主要提供两类配置功能，分别作用于 Provider 卡片和模型编辑对话框。
1. 输入模态配置¶
在 Settings → Models 页面，每个 Provider 卡片下会列出该 Provider 提供的模型。
- 默认状态：Text（文本）输入默认启用且无法取消勾选。
- 启用图像：勾选 Image 选项后，插件会向配置写入
input: [text, image]。 - 禁用图像：取消勾选 Image 选项后，配置将写入
input: [text]，明确声明该模型仅支持文本，而非继承 Catalog 默认值。 - 保存：输入类型的修改会立即保存。
2. 推理努力级别配置¶
在 Provider 的 Edit 对话框中，展开具体的模型行，在上下文和输出限制旁边会出现推理控制。
- 可选值：支持
off、minimal、low、medium、high、xhigh、max七个级别。 - 映射规则：
- 选择某个级别后，配置会以
{ "high": "high", "max": "max" }的形式写入，即“选择即映射”。 off映射为null。- 继承配置：若清空所有选择，将移除显式声明，恢复为 Catalog 的默认配置。
- 拒绝项：仅选择
off会被拒绝，因为适配器不接受该配置。 - 保存：需通过对话框的常规保存动作提交，该操作会更新或创建显式的
models列表。
注意事项¶
使用该插件需注意以下限制与环境要求：
- 适配器限制：仅适用于由
pi-ai适配器家族管理的 Provider，其他适配器不受影响。 - Bundle 写入权限：推理控制功能需要对已安装的 Models UI Bundle 具有写入权限。插件在 Profile 加载时会自动对 Bundle 进行 Patch。
- 反向代理兼容性：输入类型的 API 在当前构建版本中要求
Host头为 Loopback（回环地址）。如果通过反向代理转发外部 Host 头，可能会收到403错误。 - 兼容版本：已验证兼容 DSH
0.1.5-rc.1（配合 Models UI0.1.5-rc.2）和0.2.0-rc.2。后续版本若 UI 结构变更（如ModelRow组件变化），插件可能无法识别布局。 - 插件移除：移除插件不会自动恢复已被 Patch 的 Bundle。如果需要恢复，只能删除该 Bundle 并重新安装，或手动恢复与该 Bundle 版本对应的备份文件（
client.js.pre-thinking-patch）。
总结¶
dsh-model-modality 通过 UI 扩展简化了 DSH 中模型模态和推理级别的配置流程。它不生成新的能力，而是声明现有的能力。对于需要精细化管理模型配置的开发者，该插件提供了比直接编辑 YAML 文件更直观的操作方式。
