前言¶

在代理网关或自定义 provider 上调用模型时，有些 API 不暴露 reasoning effort 档位，但请求仍能成功。DeepSeek Harness 的官方 composer 只在模型声明了推理等级时才渲染“推理强度”行，导致这些网关在界面上完全看不到该选项。

dsh-official-reasoning-effort 是一个插件，它通过官方组件提供推理强度控制，而非重新实现 UI。默认四档 Off / Low / High / Max，使用官方 drill-down 选择器渲染，并针对未声明档位的模型给出提示。

插件定位¶

• 名称：dsh-official-reasoning-effort
• 维护者：Ayowait
• 版本：0.3.1
• 许可证：MIT
• 分类：模型推理
• 核心价值：为未声明推理强度的 gateway/provider 提供统一档位，同时保持对官方 UI 的完全兼容。

工作原理¶

插件不绘制自己的 UI，只做两件事：

1. Host 半：为缺少 reasoningEfforts 的模型添加 off / low / high / max 档位。已存在声明（包括 false）不会被覆盖。模型携带该字段后，llm-pi-ai 会报告 reasoning: true 并列出档位，官方 ModelSelect composer 自动渲染推理等级行。

2. Browser 半：通过官方 aria-label 定位模型选择面板，对使用通用档位的 provider+model 对，在面板底部用 CSS ::after 添加提示行：

上游未声明思考强度，此处为通用档位，上游可能忽略或拒绝。

真正由上游声明的模型不显示该提示。匹配基于 data-provider-id / data-model-id，同一模型由不同推理能力 provider 时不会被误标。

档位与默认值¶

• 默认四档：off / low / high / max，对应官方 Off / Low / High / Max。
• 若只声明 reasoningEfforts 而未设置 defaultEffort，官方菜单会多出一行“Default”，共五行。插件对已填充档位的 provider 写入 reasoning: high（官方默认平衡档），避免额外 Default 行。显式配置的 reasoning 不会被覆盖。

安装¶

dsh plugin --profile <your-profile> add github:Ayowait/dsh-official-reasoning-effort

• lib/ 已预构建，无需本地构建。
• 客户端打包步骤不需要，浏览器半是纯副作用模块。

配置¶

默认零配置：自动发现所有 llm-pi-ai provider，为未声明档位的模型填充通用档位。

需要覆盖或排除时，在配置中插入插件条目：

- insert:
    - id: dsh-official-reasoning-effort
      name: dsh-official-reasoning-effort
      config:
        efforts:
          high: reasoning_high
        providers:
          special-gateway:
            efforts:
              max: max_reasoning
            models:
              non-reasoning-model:
                disabled: true
          excluded-provider:
            disabled: true

配置字段：

• auto：自动发现所有 provider（默认 true），设为 false 时仅处理 providers 下列出的 provider。
• efforts：全局档位到 wire 值的映射（默认 off/low/high/max 映射到同名）。
• defaultEffort：为已填充档位的 provider 写入的默认档位（默认 high）。
• syncDefaultEffort：设为 false 以跳过写入默认档位，菜单将显示额外 Default 行。
• providers.<id>.efforts：对指定 provider 覆盖 wire 值映射。
• providers.<id>.disabled：排除某个 provider。
• providers.<id>.models.<model>.efforts：对指定模型覆盖 wire 值映射。
• providers.<id>.models.<model>.disabled：标记模型为不使用推理档位（reasoningEfforts: false）。

安全默认与兼容性¶

• 已有 reasoningEfforts（包括 false）不会被覆盖。
• 重复注入幂等：与插件通用档位相同的值会被识别为自身写入，提示继续显示；上游真实声明不会被干扰。
• 迁移：对 0.2.x 写入的 {low, medium, high} 集合自动升级为 off / low / high / max。
• 不影响其他字段：不添加 provider 凭证、请求、工具或遥测。
• Host 半无依赖：不导入 @deepseek-ai/*，避免破坏整个 host bundle。
• 提供只读接口 GET /dsh-official-reasoning-effort/api/injected，返回被填充的 provider\0model 键，浏览器据此决定是否显示提示。

适用场景与注意¶

适合使用非官方或未声明推理档位的 gateway/provider，希望以官方 UI 统一展示 Off / Low / High / Max 的开发者。插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。

小结¶

dsh-official-reasoning-effort 为 DeepSeek Harness 提供了统一推理强度控制：对未声明档位的模型填充通用档位，使用官方 UI 渲染，并给出清晰提示。无需额外依赖，零配置即可使用，适合需要跨 provider 统一推理强度档位的场景。

• 插件目录：https://www.skillhub.cn/plugins/Ayowait/dsh-official-reasoning-effort
• GitHub：https://github.com/Ayowait/dsh-official-reasoning-effort