前言¶

DeepSeek Harness (DSH) 的推理强度（Effort）来源于适配器声明的元数据。如果适配器未声明推理强度，DSH 会直接拒绝任何未声明的请求。对于第三方模型，尤其是 llm-pi-ai 路由下的模型，往往缺少这些声明，导致无法开启推理功能。

dsh-custom-reasoning 插件通过在适配器元数据中补全推理等级声明，解决了这一问题。安装后，该插件会自动为符合条件的第三方模型挂载标准五档推理强度，之后由 DSH 官方推理等级选择器接管控制。

它是什么¶

dsh-custom-reasoning 是一个由 3likofj 维护的 DSH 插件。它专为 llm-pi-ai 路由设计，负责自动为官方未提供推理强度选项的第三方模型补全 reasoningEfforts 声明，并管理相关的 compat 字段。

插件的核心逻辑是“自动补全”与“兼容性接管”：

自动补全五档推理等级
插件监听模型切换，检测当前模型是否属于 llm-pi-ai 且没有任何推理元数据。如果是，它会自动为该模型声明 off/low/medium/high/max 五个等级。这一过程无需手动操作，选择器出现后即可直接使用。
管理 compat 字段
插件会根据用户选择的线格式（如 openai、deepseek、qwen 等），自动写入 compat 字段：
- 写入 supportsReasoningEffort: true
- 写入对应的 thinkingFormat（如 “openai”）
这样可以确保 pi-ai provider 能正确解析并转发推理参数。
持久化与回退
插件通过 remote.settings.mutate 将声明写入宿主设置，落点到当前 profile 的 Cordis patch。这意味着声明会持久保存，关闭插件后失效。如果模型声明了 compat 字段，插件会逐字段保留原有配置。

安装需要使用官方插件管理命令。安装前请确保环境满足 Node >= 20，并在 dsh.profile.bundles 中启用了该 bundle。

dsh plugin --profile <profile> add github:3likofj/dsh-custom-reasoning

若需钉住特定版本，可在末尾添加提交哈希。

安装完成后，可以通过项目自带的验证脚本检查插件逻辑是否正确执行：

node test/verify.mjs

该插件的使用有明确的边界条件：

dsh-custom-reasoning 通过补全元数据，消除了第三方模型使用官方推理强度选择器的障碍。对于使用 llm-pi-ai 路由的开发者，这是一个降低配置成本、统一交互体验的有效工具。