dsh-model-config
#dsh #deepseek-harness #model-config #reasoning #multimodal
DSH 模型设置页插件，用于管理提供方和模型目录，并配置模型容量、输入类型与思考能力。插件运行在 DSH Web 客户端，不需要修改 DSH 核心代码。
功能
- 管理提供方：查看 API 密钥状态、编辑和删除提供方，也可以添加自定义提供方。自定义提供方（不在内置目录中的
llm-pi-ai 路由）可以编辑显示名称和 API 协议（openai-completions、openai-responses、anthropic-messages）。
- 管理模型目录：添加、删除模型，编辑模型 ID、显示名称、上下文窗口和最大输出 token；支持从提供方拉取模型。
- 设置容量：上下文窗口提供
8K 到 1M 的常用预设，最大输出 token 提供 4K 到 384K 的预设，也可以手动输入数字或 K / M 值。
- 配置输入类型：选择文本和图片，可同时选择。
- 配置思考能力：为
llm-pi-ai 的每个模型设置思考模式与档位；为官方 DeepSeek 提供方设置思考开关与思考等级。
- API 密钥通过 DSH 凭据服务保存，不写入模型目录字段。
界面预览
1. 提供方列表与状态指示
展示各提供方的 API 密钥配置状态（绿色正常/红色缺失），支持快捷添加、编辑与删除提供方。
提供方列表与状态指示
2. 模型容量、输入类型与思考档位配置
展开模型即可直观配置上下文窗口、最大输出 token 预设，勾选文本/图片输入多模态支持，并设置思考开启状态与回传档位映射。
模型容量、输入类型与思考档位配置
安装
将插件安装到 DSH 正在使用的 profile。桌面端通常使用 desktop，Web 版通常使用 web。
# 方式一：GitHub 直装（推荐）
# DSH 桌面端
dsh plugin --profile desktop add github:lsdt45/dsh-model-config
# DSH Web
dsh plugin --profile web add github:lsdt45/dsh-model-config
# 方式二：克隆后本地安装（便于二次开发）
git clone https://github.com/lsdt45/dsh-model-config.git
cd dsh-model-config
dsh plugin --profile desktop add .
# 或 DSH Web:
# dsh plugin --profile web add .
安装完成后重启 DSH。
更新
从 Git 安装的插件可按 profile 更新：
dsh plugin --profile desktop update dsh-model-config
如果使用的是 Web profile，将 desktop 替换为 web。更新后重启 DSH。
使用本地源码预览
将路径替换为本地仓库的绝对路径：
dsh plugin --profile desktop add /absolute/path/to/dsh-model-config
本地目录会以 link 依赖加入该 profile。修改源码后重启 DSH，即可加载本地版本。Web profile 同理，将 desktop 改为 web。
卸载
dsh plugin --profile desktop remove dsh-model-config
卸载后重启 DSH，设置页会显示 DSH 自带的模型页面。Web profile 请使用 --profile web。
使用
- 打开「设置 → 模型」，选择提供方并点击「编辑」。
- 展开模型行，编辑模型信息、容量、输入类型和思考设置。
- 点击「保存」应用更改。模型目录为空时，可以手动添加模型，或使用「拉取可用模型」。
- 回到会话，在模型选择器中选择模型，查看对应的输入能力和推理等级选项。
官方 DeepSeek 的思考开关与等级位于提供方配置中；llm-pi-ai 的思考设置位于各自模型行内。
配置行为
| 配置 | llm-pi-ai | 官方 DeepSeek |
|---|
| 思考开关与等级 | 每个模型的 reasoningEfforts | 提供方级 thinking 与 reasoningEffort |
| 输入类型 | 模型的 input 字段 | 模型的 inputModalities 字段 |
| 未选择输入类型 | 删除 input，由适配器默认值继承 | 删除 inputModalities，按仅文本处理 |
| 模型容量 | 模型的 contextWindow、maxTokens | 模型的 contextWindow、maxTokens |
| API 协议 | 自定义提供方的 api；内置目录提供方不在此修改 | 不适用 |
llm-pi-ai 的思考档位包括关、极低、低、中、高、超高和最高。开启思考时，除「关」以外至少选择一个档位，并为已选档位填写提供方需要的回传值；「关」的回传值可以留空。选择「适配器默认」会移除模型级的思考配置。
官方 DeepSeek 的思考等级为关、高、最高。inputModalities 用于声明模型的输入能力，供 DSH 的模型发现和展示使用。
运行要求
- 使用支持 Web 设置页的 DSH profile。
- 客户端需提供模型设置、语言和 remote 服务。依赖模块见 package.json 的
dsh.client.inject。
- 对设置拥有写入权限；只读设置无法保存。
问题排查
- 设置页没有插件界面：确认插件已安装到当前正在使用的 profile，并重启 DSH。
- 安装或更新失败：确认 Git 仓库访问权限，以及
dsh plugin 命令指定的 profile 是否正确。
- 保存失败：确认设置可写，并检查模型 ID 是否为空或重复、容量值是否为数字或带
K / M 后缀。
- 拉取模型失败：检查 API 地址、协议和密钥是否正确；部分提供方不支持模型发现时，可手动添加模型。
参与贡献
欢迎提交 Issue 或 Pull Request。插件结构和静态包约定见 package.json、index.mjs、client.js 与 cordis.patch.yml。
