在 DeepSeek Harness (DSH) 中配置模型能力通常需要手动编辑 settings.yaml 文件,流程繁琐且容易出错。DSH 插件 dsh-awesome-model-setting 在设置面板新增了“模型能力”页面,允许用户通过图形界面直接声明模型的输入模态、上下文窗口、最大输出 token 及图像配额,无需触碰配置文件。
核心功能¶
- 在设置面板增加“模型能力”页面。
- 图形化编辑模型能力(输入模态、上下文窗口、最大输出 token、图像预算)。
- 显示合并后的生效值(你的设置文档与适配器目录合并)。
- 支持从供应商加载模型列表。
- 支持重置为默认参数。
- 支持恢复路由默认值。
安装与启用¶
1、使用官方安装命令添加插件:
dsh plugin --profile web add github:Kazusa1085/dsh-awesome-model-setting
2、重启 DSH Web 服务。
3、打开设置,进入“模型能力”页面。
典型用法¶
- 获取模型列表:在页面中,每条已注册的路由分组下都有“从供应商加载”按钮。点击后,插件会询问适配器该路由能提供哪些模型。对于适配器自带目录的路由,列表来自本地;对于手工声明的路由(如本地服务器),插件会向
baseURL/models端点发起请求(等待上限 15 秒)获取模型清单。清单中会标记模型状态为“已声明”、“加入”或“目录提供”。 - 编辑能力参数:直接在图形界面修改输入模态、上下文窗口、最大输出 token 或图像预算。保存后,生效值为你的配置与适配器目录的合并结果。
- 使用默认值:数字输入框(上下文窗口、最大输出、图像预算)若留空,表示从文档中移除该字段,改用默认值。此时输入框会显示占位文案“使用路由默认值”,但生效值仍会显示在标签中(如
继承 <value>)。 - 恢复路由默认值:此按钮仅在你声明的输入模态确实与适配器默认不同时出现。点击后会将该模型的能力字段(模态、上下文、输出、图像预算)恢复为路由默认声明。该操作是暂存的,需点击保存后写入。
- 重置为默认参数:此按钮仅出现在适配器自带目录的路由上,点击会将该路由下所有模型的参数重置为默认值。它不会修改模型列表或显示名称。
适用场景与注意事项¶
- 该插件适用于需要精细化管理多模态模型配置的场景,特别是适配器自带目录(如
llm-pi-ai)与手工声明路由并存的情况。 - 显示的数值为“生效值”,即你的配置与适配器目录合并后的结果。
- “恢复路由默认值”按钮仅在你声明的输入模态确实与适配器默认不同时出现。
- “重置为默认参数”仅出现在适配器自带目录的路由上,对手工添加的供应商(本地服务)不显示,因为没有自带默认值可回退。
- 修改能力来自目录声明(显示“路由声明”标签)的模型时,会先弹出确认框询问是否覆盖。
- 插件以当前 DSH 进程权限运行,请确保对源码和许可证(MIT)有了解。
该插件通过图形化界面简化了模型能力的配置流程,将配置项的变更逻辑从文件编辑转化为直观的操作。