前言¶

在 DeepSeek Harness（DSH）里使用第三方或自定义模型时，一个常见情况是：模型已经在 llm-pi-ai 中可用，但没有 reasoningEfforts，模型选择器里看不到思考档位。

dsh-models-dev-reasoning 插件用来处理这个问题：它从 models.dev 补齐尚未设置思考档位的模型，不覆盖已有配置。

这是什么¶

dsh-models-dev-reasoning 由 aerince 维护，许可证为 MIT。

它为 DeepSeek Harness 中尚未设置 reasoningEfforts 的第三方或自定义模型添加 models.dev 推理档位，使 llm-pi-ai 的模型选择器能显示思考档位。

核心功能¶

• 从 models.dev 补齐 DSH 中第三方或自定义模型的思考档位。
• 让 llm-pi-ai 的模型选择器显示 reasoningEfforts。
• 只处理尚未设置 reasoningEfforts 的模型；已有配置不会覆盖。
• models.dev 的 none 会映射为 DSH 的 off。
• 读取 https://models.dev/api.json；失败时回退到 models.dev 的 GitHub dev tarball。
• 将目录缓存到系统临时目录，有效期 24 小时。

工作方式¶

插件启用后，DSH 启动时会按下面步骤处理：

1、等待 settings 可用。

2、读取 https://models.dev/api.json。

3、如果读取失败，回退到 models.dev 的 GitHub dev tarball。

4、匹配 llm-pi-ai 下的模型，并补写缺失的推理档位。

5、把目录缓存到系统临时目录，有效期 24 小时。

该插件没有插件配置项，也没有 prepare 安装脚本。

安装与启用¶

安装前需要可用的 dsh、pnpm 和 git。

本包要求 Node.js 版本满足：

node ^22.19.0 || >=24.0.0

它是零构建 JavaScript，不需要为它添加 pnpm allowBuilds。

下面使用 web profile 安装：

dsh plugin --profile web add github:aerince/dsh-models-dev-reasoning

如果你需要固定版本安装：

dsh plugin --profile web add github:aerince/dsh-models-dev-reasoning#v0.1.0

如果你需要固定 commit 安装：

dsh plugin --profile web add github:aerince/dsh-models-dev-reasoning#0893e91cbe7bdc684eaf1ed52767b8ca3289c751

安装后重启 DSH。

DSH 会把插件写入 $DSH_HOME/profiles/<profile>；请确认 CLI 与 Desktop 使用的是同一个 DSH home。

验证与卸载¶

安装后先查看配置：

dsh --profile web --dump-config

配置树中应出现 models-dev-reasoning。

再打开一个此前没有 reasoningEfforts 的第三方或自定义模型，检查模型选择器是否出现思考档位；已有 reasoningEfforts 的模型应保持不变。

如果不需要这个插件，可以移除：

dsh plugin --profile web remove dsh-models-dev-reasoning

适用场景与注意¶

适合使用 DSH 管理第三方或自定义模型、并且希望统一显示思考档位的人。

使用时注意：

• 插件只会写入 llm-pi-ai 下缺失的 reasoningEfforts，不会覆盖已有配置。
• 插件会访问 models.dev 和 GitHub 回退地址。
• 插件会在系统临时目录写入可选缓存；缓存写失败不会阻止插件运行。
• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。

获取¶

• GitHub：dsh-models-dev-reasoning
• 插件目录：可按插件名 dsh-models-dev-reasoning 在 DSH 插件目录中查找