前言¶
在 DeepSeek Harness（DSH）的生态中，开发者常需配置非官方或自定义的模型提供方。这些提供方往往缺少推理级别、上下文窗口、输出上限以及图片模态等关键参数。手动配置不仅繁琐，还容易出错。
插件介绍¶
dsh-model-reasoning 是一个由 TikaFlow 维护的 DSH 插件。它通过读取 models.dev 的数据，自动为非官方提供方的模型填充推理级别、最大上下文、输出上限与图片模态，解决了配置缺失的问题。
核心功能¶
- 自动参数填充
自动填充缺失的推理级别（reasoningEfforts）、最大上下文（contextWindow）、输出上限（maxTokens）与图片模态（input）。 - 路由级兼容性配置
默认为所有api: openai-completions的提供方写入路由级兼容性配置，禁用developer角色（compat.supportsDeveloperRole: false）。 - 提供方排除
支持通过列表排除特定提供方，对它们完全跳过填充与更新操作。 - 离线支持
内置缓存支持，插件启动时即可离线使用。
安装与启用¶
通过命令行安装：
dsh plugin --profile web add github:TikaFlow/dsh-model-fix
安装后进入 DSH，插件即自动生效，无需额外操作。
典型用法¶
自动生效¶
插件启动时利用内置缓存自动填充模型参数。随后会自动保持数据最新。
手动调整¶
进入 Web 设置 →「模型」→ 页面底部调整参数，或手动编辑 settings.yaml 中的 tikaflow-model-fix 配置段。
排除特定提供方¶
在配置中列出不想被插件接管的提供方 ID。
适用场景与注意¶
本插件适用于需要快速配置非官方模型提供方的场景。使用时需注意宿主版本依赖（DSH 0.1.2-rc.1）。
注意事项¶
- 数据源为
models.dev。 - 依赖 DSH 宿主版本 0.1.2-rc.1。
- 启动时已填充的模型参数会自动恢复备份（重启即重建）。
- 本插件已被
awesome-dsh-plugin收录。
总结¶
该插件通过自动化参数填充和兼容性配置，降低了非官方模型接入的门槛。
