aerince/dsh-models-dev-reasoning

为未配置的第三方DeepSeek Harness模型添加models.dev推理级别。

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness, designed to fill in reasoning effort configurations for third-party or custom models from models.dev. It enables the llm-pi-ai model selector to display the reasoningEfforts option correctly. To install the plugin, you can use the official DSH CLI with the command dsh plugin --profile <profile> add <source>, where Desktop users use the default web profile. After installation completes, you only need to restart DSH for the plugin to take effect. It will not overwrite any existing configurations, only adding the setting for models that do not have it yet.

The plugin runs its workflow right after DSH starts. It waits for the settings module to become available, then fetches the model list from the models.dev API. If the API request fails, it falls back to the tarball of the dev branch of models.dev on GitHub. It then matches models under the llm-pi-ai provider and fills in the missing reasoning effort configuration. Finally, it caches the model list to your system temporary directory, and the cache expires after 24 hours. This plugin is for DSH users who use custom or third-party models and need the reasoning effort selector to work properly.

This plugin is released under the open source MIT license. It is a zero-build JavaScript package, so it does not have a prepare install script, and you do not need to add it to pnpm’s allowBuilds configuration. The only prerequisites for installation are a working installation of DSH, pnpm, and git on your system. The plugin only accesses models.dev and the GitHub fallback address, writes an optional cache to the system temporary directory, and even if cache writing fails, it will not stop the plugin from running. It does not request any extra permissions, and does not modify any existing model configurations.

这是一个专为 DeepSeek Harness 开发的原生插件,核心功能是从 models.dev 补齐 DSH 中第三方或自定义模型的思考档位配置,适用于手填模型、代理模型和 NewAPI 等多种场景,让 llm-pi-ai 的模型选择器能够正常显示 reasoningEfforts 选项。插件仅处理尚未设置 reasoningEfforts 的模型,不会覆盖已有配置,同时会将 models.dev 的 none 映射为 DSH 的 off,可通过 DSH 官方 CLI 完成安装,安装后重启 DSH 即可生效。

插件的工作流程为:DSH 启动后等待 settings 配置可用,再读取 models.dev 的 API 接口获取模型列表,如果请求失败则回退到 GitHub 上的 models.dev dev 分支压缩包,接着匹配 llm-pi-ai 提供者下的模型补全推理档位,最后将模型列表缓存到系统临时目录,缓存有效期为 24 小时。该插件主要面向需要显示思考档位的自定义/第三方模型用户。

本插件采用 MIT 许可协议开源,是零构建的 JavaScript 包,没有 prepare 安装脚本,也不需要额外配置 pnpm allowBuilds,安装前提是已有可用的 dsh、pnpm 和 git。插件只会补写缺失的 reasoningEfforts,访问 models.dev 和 GitHub 回退地址,将可选缓存写入系统临时目录,缓存写入失败也不会阻止插件运行,无额外权限要求。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 4 stars - very few users, little community feedback星标只有 4,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

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

把 aerince/dsh-models-dev-reasoning 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-models-dev-reasoning

从 models.dev 补齐 DeepSeek Harness 中第三方或自定义模型的思考档位,让 llm-pi-ai 的模型选择器也能显示 reasoningEfforts。

插件只处理尚未设置 reasoningEfforts 的模型;已有配置不会覆盖。models.dev 的 none 会映射为 DSH 的 off。

适用于手填模型、代理模型和 NewAPI 等场景。

工作方式

  1. DSH 启动后等待 settings 可用。

  2. 读取 https://models.dev/api.json,失败时回退到 models.dev 的 GitHub dev tarball。

  3. 匹配 llm-pi-ai provider 下的模型并补写推理档位。

  4. 将目录缓存到系统临时目录,有效期 24 小时。

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

安装

官方 CLI 的正确格式是 dsh plugin --profile <profile> add <source>。Desktop 默认使用 web profile;其他 profile 请替换 web。

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

# 可复现安装:v0.1.0 release
dsh plugin --profile web add github:aerince/dsh-models-dev-reasoning#v0.1.0

# 不可变 commit pin
dsh plugin --profile web add github:aerince/dsh-models-dev-reasoning#0893e91cbe7bdc684eaf1ed52767b8ca3289c751

本包是零构建 JavaScript,没有 prepare,不需要为它添加 pnpm allowBuilds。安装前提是可用的 dsh、pnpm 和 git。安装后重启 DSH。

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

验证与卸载

dsh --profile web --dump-config

配置树中应出现 models-dev-reasoning。打开一个 models.dev 标记为 reasoner 的自定义模型,检查模型选择器是否出现思考档位;已有 reasoningEfforts 的模型应保持不变。

卸载

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

DSH 官方安装对照

本仓库按 DSH 当前官方基线(deepseek-ai/deepseek-harness commit 47f943859bef60e4160492346772ded9b24f765a)核对:

官方要求 本项目
普通 package entry package.json → index.js
dsh.bundle.patch 已配置 ./cordis.patch.yml
YAML patch 的 name 可解析 dsh-models-dev-reasoning 与 package name 一致
Git source 可直接安装 零构建 JS,无 prepare
profile 安装命令 使用 dsh plugin --profile web add github:...
安装后验证 使用 dsh --profile web --dump-config

官方参考:https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/develop/basic/publish.zh.md、https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/cli/src/plugin.ts。

网络、文件与权限

插件注入 settings,只写入 llm-pi-ai 下缺失的 reasoningEfforts。它会访问 models.dev 和 GitHub 回退地址,并在系统临时目录写入可选缓存;缓存写失败不会阻止插件运行。没有 prepare 安装脚本。

License

MIT

← 上一个 Prev dsh-plugin-mermaid 下一个 Next dsh-tradingagents →