前言¶

DeepSeek Harness（DSH）通过插件体系扩展能力。在 DSH 的模型选择器里，目前只有 @deepseek-ai/dsh-llm-pi-ai 这类原生插件会根据模型的 reasoningEfforts 字段暴露推理等级。而自建或第三方中转站通常也支持 reasoning_effort 参数，但 DSH 的原生插件不会自动为这些中转站模型暴露这些选项，需要手动为每个模型声明。

手动声明意味着重复工作：每增加一个模型就要写七行配置，模型列表更新后又要重做。dsh-relay-reasoning 插件的作用是让这些中转站的推理等级直接出现在 DSH 的模型选择器中，无需手动配置。

这是什么¶

dsh-relay-reasoning 是一个 DSH 插件，为 llm-pi-ai 配置项下的所有模型写入 reasoningEfforts 字段，使 DSH 的模型选择器能够展示推理等级选项。插件由 wuwan911-cell 维护，分类为「模型推理」。

插件默认为每个模型提供五档推理等级：off、low、medium、high、max。它通过监听配置重载事件，自动更新缺失的声明，因此添加中转站或模型时无需重启 DSH。

核心功能¶

• 自动注入推理等级：为指定配置项下的所有模型写入 reasoningEfforts 字段，使模型选择器可见相应选项。
• 随配置自动同步：插件在激活时执行首次写入，并在每次配置重载（添加中转站、添加模型、编辑路由）时再次检查并补充缺失的声明。
• 幂等写入：若模型已声明与当前配置一致的等级，插件不会重复写入，避免不必要的配置变动。
• 灵活的等级选择：可通过配置项 levels 自定义发布的等级组合，支持从 off 到 max 的任意子集，忽略不生效的等级。

安装与启用¶

插件可通过 DSH 工作台安装，也可以直接使用命令行安装：

plugin_manager install_bundle → dsh-relay-reasoning

从本地检出安装开发构建：

plugin_manager install_bundle → <路径>

安装后，在 DSH 设置 → 工作台 → 插件中启用插件。

典型用法¶

插件在插件行中接受可选的 YAML 配置。默认配置会为 llm-pi-ai 配置项下的所有提供者的所有模型注入 off、low、medium、high、max 五档等级。

- insert:
    - id: relay-reasoning
      name: dsh-relay-reasoning
      config:
        target: llm-pi-ai                 # 要配置的配置项 ID
        providers: []                     # 空表示该配置项下的所有提供者
        levels: [off, low, medium, high, max]  # 发布的等级，按升序排列
        force: false                      # true 表示在激活时强制重写，即使已正确
        debugLog: ""                      # 可选的诊断日志路径

如果中转站不支持 max 等级，可以在 levels 中将其移除，例如：

levels: [off, low, medium, high]

插件接受任意子集，如 [off, max] 等，未知名称会被过滤。

适用场景与注意¶

• 适用于所有在 llm-pi-ai 配置项下声明的 OpenAI 兼容中转站，不限于单一中转。
• 插件在 DSH 进程内运行，建议在安装前检查源码与许可证（MIT）。
• 需要满足 DSH 版本要求：>=0.2.1-rc.1。
• 插件不覆盖 llm-pi-ai 整行配置，而是通过路径级操作写入 providers.<name>.models[i].reasoningEfforts。

结尾¶

dsh-relay-reasoning 让你为 OpenAI 兼容中转站一键注入推理等级，无需重复配置。更多细节与源码可在 GitHub 查看：https://github.com/wuwan911-cell/dsh-relay-reasoning