dsh-model-autoconfig

Readme

# dsh-model-autoconfig

自动修正 dsh 模型的**思考模式**和**模型能力**。

适用于官方 API 和 Coding Plan、硅基流动、火山方舟、阿里百炼、OpenRouter，以及常见中转站。

## 为什么需要这个插件

dsh 自带的模型目录并不完整，部分模型的思考档位和能力配置会缺失或写错。

以当前 pi-ai 模型目录为例：

```text
模型总数          1290
声明了思考档位     543
缺少 off 档        151
```

缺少 `off` 会让 dsh 错误判断模型的思考状态，可能导致：

- 思考模式无法正确开启或关闭
- 思考档位显示错误
- 长输出被意外截断

插件会补上正确的 `off` 和思考档位，避免这些问题。

## 插件会做什么

1. **修正思考模式**
   - 模型是否支持思考
   - 思考能否关闭
   - 支持哪些档位，例如 Low、High、Max
   - 按模型记住你最后选择的思考档位

2. **自动配置模型**
   - 根据模型厂商的官方资料填写正确参数
   - 支持官方服务、第三方平台和中转站

3. **补全模型能力**
   - 是否支持图片输入
   - 上下文长度
   - 最大输出长度

4. **检查错误配置**
   - 无效或虚假的思考档位
   - 漏掉的视觉能力
   - 会被 dsh 拒绝的配置

## 安装

```bash
dsh plugin --profile web add dsh-model-autoconfig
```

安装后重启 dsh web。

## 使用

1. 打开 dsh 的 **Settings → Models**
2. 添加模型服务，填写 API 地址和 API Key
3. 获取模型列表或手动填写模型 ID，然后保存

插件会自动完成其余配置，不需要手动修改 `settings.yaml`。

你为某个模型选择思考档位后，插件会在当前浏览器中记住它。以后切回该模型，会自动恢复上次档位。

## 没有模型列表怎么办

部分中转站没有模型列表接口，直接手动填写模型 ID 即可。

插件会尝试识别模型。无法确认的模型会原样保留，不会添加未经确认的能力。

## 如何确认生效

重新打开模型选择器：

- 思考模型会显示正确的思考档位
- 支持视觉的模型可以发送图片
- 上下文和最大输出长度会被正确设置

如果没有立即更新，请刷新网页或重启 dsh web。

## 卸载

```bash
dsh plugin --profile web remove dsh-model-autoconfig
```

卸载后重启 dsh web。