dsh-model-config

#dsh #deepseek-harness #model-config #reasoning #multimodal

DSH 模型设置页插件，用于管理提供方和模型目录，并配置模型容量、输入类型与思考能力。插件运行在 DSH Web 客户端，不需要修改 DSH 核心代码。

功能

• 管理提供方：查看 API 密钥状态、编辑和删除提供方，也可以添加自定义提供方。
• 管理模型目录：添加、删除模型，编辑模型 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。

使用

1. 打开「设置 → 模型」，选择提供方并点击「编辑」。
2. 展开模型行，编辑模型信息、容量、输入类型和思考设置。
3. 点击「保存」应用更改。模型目录为空时，可以手动添加模型，或使用「拉取可用模型」。
4. 回到会话，在模型选择器中选择模型，查看对应的输入能力和推理等级选项。

官方 DeepSeek 的思考开关与等级位于提供方配置中；llm-pi-ai 的思考设置位于各自模型行内。

配置行为

配置	llm-pi-ai	官方 DeepSeek
思考开关与等级	每个模型的 reasoningEfforts	提供方级 thinking 与 reasoningEffort
输入类型	模型的 input 字段	模型的 inputModalities 字段
未选择输入类型	删除 input，由适配器默认值继承	删除 inputModalities，按仅文本处理
模型容量	模型的 contextWindow、maxTokens	模型的 contextWindow、maxTokens

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。