DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在配置 pi-ai 路由时,开发者常需手动调整上下文窗口、最大输出 token、图像输入支持以及思考(reasoning)参数。这些参数通常分散在配置文件或 API 调用中,手动维护成本较高,且容易出错。dsh-model-capabilities 插件通过在 DSH Web Host 中新增一个“模型能力”页面,提供可视化的配置界面,解决这些参数的统一管理和修正问题。
核心功能¶
该插件主要包含以下功能:
- 参数编辑:为
llm-pi-ai路由提供可视化的编辑界面,支持配置上下文窗口、最大输出 token、图像输入和思考真实值。 - 自动加载:从 OpenRouter 自动加载模型目录,作为配置数据的参考源。
- 智能匹配:采用智能匹配算法(基于 token 边界和稀有词加权),为新模型或缺失字段生成默认草稿。
- 自定义映射:支持自定义思考值映射,允许将界面选项(如 off/low/high)映射为模型实际接受的字符串(如 none/low/extra)。
- 安全修正:严格遵循“不覆盖已有修正”原则,仅补齐空白字段,保留手动编辑的草稿。
- 浏览器记忆:具备浏览器记忆功能,缓存已处理的模型 6 小时,避免重复操作。
安装与启用¶
安装该插件需要执行以下命令:
dsh plugin --profile web add github:Kalospacer/dsh-model-capabilities#main
安装完成后,需重启 DSH Web Host,然后在设置菜单中找到“模型能力”页面。
典型用法¶
在“模型能力”页面中,操作流程如下:
- 在路由筛选栏选择
llm-pi-ai。 - 浏览模型列表,点击具体模型进入编辑区。
- 检查各项数值(上下文窗口、最大输出 token 等),利用“补齐”按钮填充空白字段。
- 点击“保存此模型”或“保存全部”将配置写入 DSH 设置。
浏览器会记忆已处理过的模型配置,刷新页面后可直接使用,无需重新填入。
适用场景与注意¶
该插件仅对 llm-pi-ai 的配置路由生效。配置写入 DSH 自己的设置中,卸载插件后已保存的配置依然保留,不会丢失。
使用时需注意以下几点:
- 数据源差异:保存前应核对线路实际接受的值,因为 OpenRouter 是聚合目录,不一定保证所有接入线路的原生 API 值一致。
- 思考映射:思考值映射需要明确指定(例如
off: none),非off选项必须有实际发送值。 - 字段继承:数字字段留空表示继承默认值,清空已保存的覆盖值后保存,会删除该字段的覆盖。
- 草稿机制:未保存的修改仅保留在当前页面,刷新或离开页面后会丢失。
该插件通过可视化的方式简化了 DSH 中模型参数的配置流程,适合需要精细化管理 pi-ai 路由参数的开发者。更多细节与源码请访问 GitHub 或 社区目录。