前言¶
DeepSeek Harness (DSH) 在展示模型推理（思考）级别控制时，要求模型具备 reasoning 或 reasoningEfforts 能力声明。官方内置的模型列表已包含这些声明，因此使用官方提供商时无需额外配置。
对于通过自定义网关或中转（如 pptoken、one-api、LiteLLM）使用的模型，其 ID 往往不在 DSH 的内置目录中。当目录不包含描述时，DSH 默认不显示推理级别选择器。本插件通过在 settings.yaml 中写入缺失的声明，让这些自定义网关模型也能被选择推理强度。
核心功能¶
该插件为 GPT、Codex、Gemini 和 OpenAI 兼容模型声明推理级别，主要能力如下：
- 声明推理级别：支持
off、minimal、low、medium、high、xhigh六个级别。 - 写入配置映射：将推理级别映射写入
settings.yaml中的reasoningEfforts字段，供主机 (dsh-llm-pi-ai) 转换使用。 - 图像模型标记：将
gpt-image-*开头的图像模型标记为非推理模型 (reasoningEfforts: false)。 - Gemini 特殊处理：为
gemini-*模型添加特定映射。 - 通用模型支持：支持
gpt-*、codex-*、claude-*等通用模型 ID 及任意自定义 ID。 - 设置说明区：在设置中添加 “Reasoning adapter” 区域，说明映射关系（目前为信息展示）。
- 辅助脚本：提供 PowerShell 脚本用于批量启用或禁用声明。
安装与启用¶
插件通过 DSH 的插件系统安装。安装后不会自动修改配置，需手动运行辅助脚本。
- 安装插件
从 npm 安装：
dsh plugin add dsh-more-models-thinking-level
或从 GitHub 仓库安装：
dsh plugin add https://github.com/Henta111/dsh-more-models-thinking-level
- 启用功能
安装完成后，必须手动运行辅助脚本来写入settings.yaml。以下命令默认针对desktop配置文件：
powershell -ExecutionPolicy Bypass -File "$HOME\.dsh\profiles\desktop\node_modules\dsh-more-models-thinking-level\enable-capabilities.ps1"
运行脚本后，需重启 DSH 使配置生效。
工作原理¶
插件不会修改 DSH 核心文件，也不在运行时拦截请求。其核心作用是充当“安装器”和“说明文档”：
- 声明能力：通过辅助脚本将
reasoningEfforts映射写入settings.yaml。主机检测到该声明后，会在界面上渲染推理级别选择器。 - 逻辑转换：主机 (
dsh-llm-pi-ai) 负责将用户选择的逻辑级别转换为网关原生参数。 - 入口点：插件主入口 (
lib/index.js) 的apply方法仅记录日志，不执行实际的参数转换逻辑。
注意事项与限制¶
安装前请阅读以下限制，部分限制可能影响使用效果：
- 市场列表不可见：由于相关 PR 尚未合并，该插件不会出现在
dsh plugin search结果中，需通过名称或 URL 安装。 - 非自动执行：安装或启用插件不会自动运行辅助脚本，必须手动执行。
- 手动清理：辅助脚本会持久编辑
settings.yaml。如果卸载插件或不再需要，需手动清理脚本注入的配置项。 - 能力猜测：辅助脚本通过正则表达式从模型 ID 猜测能力。如果中转暴露了非推理模型（如嵌入模型或纯视觉模型）的 ID，它们仍会被标记为推理模型，可能导致网关拒绝请求。
- 网关依赖：声明仅让级别“可选”，网关是否实际接受
reasoning参数由网关决定。严格的网关可能会拒绝未在 Schema 中定义的字段（如input[x].status）。 - 系统限制：辅助脚本仅支持 Windows PowerShell 和
desktop配置文件，其他系统或配置文件需手动适配。 - 设置界面仅为信息：界面中的 “Reasoning adapter” 部分仅用于展示映射说明，不具备编辑器功能，无法在界面上微调。
结语¶
该插件解决了自定义网关模型在 DSH 中无法选择推理级别的问题。它通过写入配置文件的方式实现功能，适合需要精细控制推理强度的开发者。请确保了解网关对参数的限制后再启用。
