dsh-reasoning-effort：为 DeepSeek Harness 模型配置推理强度

DeepSeek Harness（DSH）的生态遵循「一切皆插件」的理念。对于需要在模型层面精细控制推理强度（如 reasoning_effort）的场景，手动修改配置文件往往不够直观。dsh-reasoning-effort 插件通过提供可视化的配置入口和协议映射能力，解决了这一问题。

插件简介¶

这个插件由 Mu-scorpio 维护，采用 MIT 许可证。它主要服务于 DSH 中的任意模型，通过 UI 滑块配置推理强度，并在最高档位提供紫色辉光特效。

核心能力¶

通用性：不限制 Provider，只要是已接入 Harness 的模型，均可配置。
自动发现：零配置自动扫描 llm-pi-ai 中的所有现有 Provider。
档位支持：支持 off、minimal、low、medium、high、xhigh、max 七个等级。
配置层级：支持 Provider 级默认值、模型级覆盖，以及协议（wire）值映射。
界面交互：模型选择器按 Provider 分组折叠；滑块为粗轨道、离散档位；最高档位带有紫色辉光、闪烁和拖尾特效。
状态保护：模型切换在前端暂存，关闭选择框时才提交，避免界面闪回。
非破坏性：追加更新 settings，不覆盖已有的 reasoningEfforts。

安装与启用¶

在终端执行以下命令，将预构建的 Bundle 安装到 DSH web profile：

dsh plugin --profile web add -w dsh-reasoning-effort

安装后，重启 Harness 使配置生效。

配置方式¶

插件会自动发现 llm-pi-ai 中的 Provider。若需针对特定 Provider 进行特殊映射或排除，可在 Cordis patch 中添加覆盖配置：

- insert:
    - id: reasoning-effort
      name: dsh-reasoning-effort
      config:
        defaults:
          reasoning: medium
        providers:
          special-provider:
            api: openai-responses
            efforts:
              high: reasoning_high
            models:
              non-reasoning-model:
                disabled: true
          excluded-provider:
            disabled: true

配置字段说明¶

字段	作用
`auto`	是否自动发现全部现有 Provider，默认 `true`。设为 `false` 时仅处理显式列出的项。
`defaults.api`	当 Provider 自身没有 `api` 时使用的协议回退值。
`defaults.reasoning`	为所有 Provider 补充默认推理等级，但不覆盖已有值。
`defaults.efforts`	覆盖所有 Provider 的通用 wire 值映射。
`providers.<id>.api`	为指定 Provider 选择协议默认映射。
`providers.<id>.reasoning`	为指定 Provider 补充默认推理等级。
`providers.<id>.efforts`	覆盖指定 Provider 的 wire 值映射。
`providers.<id>.disabled`	排除指定 Provider。
`providers.<id>.models.<model-id>.efforts`	单独覆盖某个模型的映射。
`providers.<id>.models.<model-id>.disabled`	显式标记某个模型不使用推理强度。

开发与调试¶

如需从源码运行或构建，执行以下步骤：

pnpm install
npm run build
dsh web --patch ./cordis.yml

注意事项¶

安全性：插件以当前 DSH 进程权限运行，安装前建议查看源码与许可证。
兼容性：已存在的 reasoningEfforts 永远不会被覆盖。
功能范围：不新增 Provider 凭据、请求、工具或遥测数据，仅增强 settings 契约。

该插件专注于模型推理强度的配置管理，具体的模型调用仍由 DSH 自身处理。