DSH Plugins Marketplace

DSH Plugins

Plugins

/

Models & Providers

/

dsh-model-capability-detector

d

dsh-model-capability-detector

Manifest valid

Fills model context, output, vision and reasoning settings for third-party API providers in DSH.

UI (client)hasBundlePatch

dsh-model-capability-detector

在 DSH 中添加或保存第三方 API 渠道时,自动补全模型的上下文长度、最大输出、识图能力和推理等级,不必逐个手填。

English: README.en.md

功能

  • 点击「获取可用模型」时,立刻为每个模型补全能力,并交给编辑草稿。这一步本身不保存配置。
  • 保存或修改渠道、重载配置、启动数秒后,在后台为空字段补值。
  • 只补空字段。你手填的值不会被改动。
  • 设置页提供检测报告,告诉你每个字段的值来自哪里,没填上的原因是什么。

安装

在 DSH「插件」页的安装输入框填写:

https://github.com/BunnySakura/dsh-model-capability-detector

要固定版本,在地址末尾加 #<标签>,例如 #1.4.0,该标签必须已在 GitHub 上。也可以安装本地目录(绝对路径)或 .tgz 压缩包。安装影响当前 profile 的全部会话。

需要 Node.js 20.3.0 或更高版本,以及满足包内声明的 DSH 版本。无需编译,也不执行安装脚本。

设置

打开「插件」页,进入本插件的详情页,所有选项都在页面里,保存后立即生效,只有「启动延迟」要等下次启动。点「重置」可让某个字段回到默认值。

此外还可以在 profile 的 cordis.patch.yml 里为本插件写 config。取值优先级从低到高:内置默认值、config、设置页保存的值。设置页保存的值写在 $DSH_HOME/model-capability-detector/settings.json,只含下表的选项,不含密钥。

选项默认值说明
enabledtrue关闭后停止后台检测和模型页增强
settingsNsllm-pi-ai保存渠道配置的设置命名空间
discoveryTriggertrue在「获取可用模型」时补全草稿
overwritefalse用新结果覆盖已有值
dryRunfalse只计算不写入,配合日志查看计划
timeoutMs15000单次渠道模型列表请求的超时
maxResponseBytes4194304渠道响应大小上限,超过即取消
debounceMs800合并短时间内连续的渠道改动
startupDelayMs3000启动后多久做一次兜底扫描
catalogFallbacktrue允许使用公开来源,关闭后连内置规格也不用
catalogNumberstrue允许公开来源补上下文和最大输出
catalogNumericStrategyofficialofficial 为分档取值;minimum、consensus 为旧版兼容模式
thirdPartySourcestrue允许参考 OpenRouter 和 LiteLLM
reasoningPresetnone来源一致认为模型会推理、却没有等级时自动填入的预设(openai、extended、deepseek、toggle),none 为不填。换一套预设会替换上一套填过、且没被改过的等级
probeEnabledfalse在检测报告里提供「探测渠道」按钮,会向渠道发少量计费请求,从不自动运行
openrouterUrlhttps://openrouter.ai/api/v1/modelsOpenRouter 模型列表地址。默认地址访问不了时可改成镜像,只接受不含凭据的 http(s)
litellmUrlLiteLLM 仓库里的 model_prices_and_context_window.jsonLiteLLM 模型表地址,规则同上
upgradeWrittentrue出现更强来源时升级插件早先写入的值
modelAliases{}模型名别名,格式见下文
catalogUrlhttps://models.dev/api.jsonmodels.dev 目录地址,只接受不含凭据的 http(s)
catalogTimeoutMs30000目录请求超时
catalogMaxBytes16777216目录大小上限
catalogTtlMs604800000公开来源缓存有效期,7 天
loggingfalse向 DSH 日志输出脱敏的诊断信息
logFile""诊断日志路径,须以 .log 结尾;相对路径基于 DSH 主目录,非空时也启用日志;在设置页保存时须位于主目录内
updateCheckOnStartupfalse启动约 10 秒后检查一次新版本

写在 cordis.patch.yml 里的例子:

- id: dsh-model-capability-detector
  name: dsh-model-capability-detector
  config:
    timeoutMs: 20000
    modelAliases:
      my-gateway-gpt: gpt-4o

config 里的无效值会被忽略并记入日志,不会让插件加载失败。

能力值从哪里来

每个字段按下面的顺序取值,越靠前越优先:

  1. 渠道 API:渠道模型列表里含义明确的字段,如 context_length、max_output_tokens。
  2. 原厂文档:内置的核验记录,以及 models.dev 里带原厂文档域名的原厂记录。
  3. 权威第三方:OpenRouter、LiteLLM、models.dev 三家中至少两家一致才采用。数值相差 5% 以内算一致,取较小的值。
  4. API 参考值:max_input_tokens 和 max_tokens 在各家网关里含义不一,只在前面都没有值时才用。

推理等级只来自渠道 API 和原厂记录。渠道只列 deepseek-v4.1-flash、原厂只登记带日期的 deepseek-v4.1-flash-1017 时,若该厂商所有带日期快照给出相同等级,会据此推断,并在报告里标「同系快照推断」。上下文和最大输出不做这种推断。原厂规格是模型本身的能力,不保证第三方渠道开放同样的上限。

模型名对不上时,可以在设置页「模型名别名」里每行写一条 渠道里的名字 = 标准模型名。别名精确匹配,不嵌套,且只用于查规格,不会修改实际请求 ID。日期快照和 :free 等变体保留身份,不自动套用基础模型的容量;确认相同时再显式配别名。

具体规则见 数据来源与取值规则。

上下文容量与压缩策略应分开设置,参见需求判断与上下文策略。

检测报告

设置页的「检测报告」按渠道和模型列出每个字段的值和来源,没填的会写明原因:

原因含义可以怎么办
没有原厂记录找不到这个模型配别名,或手填
原厂记录未给出记录里没有这一项手填
原厂记录不一致不同原厂记录给出了不同的值手填
没有第三方数据OpenRouter 和 LiteLLM 都没收录配别名,或手填
只有一家第三方来源凑不够两家手填
第三方来源不一致数值相差明显且票数相同手填
公开来源已关闭catalogFallback 为 false打开该选项

「试查模型名」输入一个名字,就能看到它会解析成什么,以及各第三方来源的取值,不改任何配置。「立即重新检测」会马上跑一轮。这三项都不联系你的渠道,也不显示地址、密钥或请求头。

常见问题

为什么设置页没有「更新」按钮,只有一段说明? 当前运行的是链接到开发目录的副本(profile 里写成 link:路径)。让插件管理器更新这样的副本,会替换链接指向的目录,可能删除其中的文件。请在该目录里用 git 拉取对应标签,或把 profile 里的 link: 改成 GitHub 地址安装。

为什么很多模型的推理等级是空的,界面也没有推理选项? DSH 对没有 reasoningEfforts 的自定义模型一律按「不推理」处理。等级只能来自渠道 API 和原厂记录;第三方来源不给等级,不少原厂记录也只写了开关。检测报告里,这类模型会显示来源是否认为它会推理,并提供两个办法:

  • 从预设里选一套手动套用(low/medium/high、low/high/max、只有开关等)。预设是对渠道可接受取值的猜测,用之前确认你的渠道认这些值。
  • 打开「允许探测请求」后点「探测渠道」,让插件向你的渠道试探它接受哪些等级,再决定是否套用。会产生少量计费请求。

也可以在设置里选「等级未知时套用的预设」,让插件对「来源一致认为会推理」的模型自动填入,默认关闭。

为什么「获取可用模型」后上下文和识图有了,推理开关却是关的? 这不是检测失败。DSH 的发现结果只传上下文长度、最大输出和输入类型,没有推理字段,模型页也就没东西可填。插件改为把等级写进已保存的渠道配置:保存这张卡片,或点「立即重新检测」,再重新打开模型页查看。至于能不能查到等级,仍取决于来源。设置页「推理」分组下也有这句说明。等 DSH 在发现结果里加上推理字段后,导入时就能直接带出来。

为什么有的值我没改过却变了? 插件早先用较弱来源写入的值,出现更强来源时会自动升级。你手填或改过的值不会动。即使推理等级恰好等于 DSH 的起始模板,也会保留;只有匹配的插件写入回执才能证明该值可自动升级。在设置里关闭「升级插件写入的值」可禁止这些替换。

怎么让它覆盖已有值? 打开 overwrite,或先清空那个字段再保存。

怎么完全不访问公开来源? 把 catalogFallback 设为 false,只用渠道 API。只想不访问 OpenRouter 和 LiteLLM,把 thirdPartySources 设为 false。

「获取可用模型」没有反应或报错? 插件通过包装 DSH 的 llm.discoverModels 方法接入,DSH 更新后可能不兼容。把 discoveryTrigger 设为 false 关掉这一接入,保存和重载时的后台补全不受影响。

隐私与网络

  • 渠道请求:向你配置的渠道发 GET {baseURL}/models(Anthropic 为 /v1/models)。API key 通过 DSH 的凭据服务即时取用,请求拒绝重定向。
  • 渠道探测:默认关闭。打开「允许探测请求」后,只在你点击某个模型的「探测渠道」时,向该渠道发约 8 个极小的对话请求(POST {baseURL}/chat/completions,固定提示词,每个最多 256 个输出 token,会计费)。结果只含各等级是否被接受,不含回答、地址或密钥。
  • 公开来源:models.dev 目录、openrouter.ai/api/v1/models、GitHub 上 LiteLLM 的 model_prices_and_context_window.json。OpenRouter 和 LiteLLM 的地址可以换成镜像。请求不带任何凭据和用户数据,响应有大小上限。
  • 更新检查:默认关闭。开启后只访问本项目的 GitHub Releases。
  • 本地文件,都在 $DSH_HOME 下,不含密钥、渠道地址和请求头:
    • cache/model-capability-detector/ 里是公开来源缓存和来源回执。回执用来判断某个值是不是插件写的,其中路由名和模型名已做哈希。
    • model-capability-detector/settings.json 保存设置页的取值。
  • 日志默认全部关闭。开启后,URL 里的账号、查询参数和常见凭据格式都会被脱敏。路由名和模型名仍可能暴露你的部署,分享日志前请先检查。

更新

设置页的「检查更新」会读取本项目 GitHub Releases 的最新稳定版。有新版本时,确认后由 DSH 插件管理器完成安装,兼容性检查、脚本授权和是否需要重启都由它决定。Agent 另有只读工具 model_capability_detector_updates,只能查询,不能安装。

版本变化见 更新记录。

文档

许可证

MIT

Comments

Loading…

Similar plugins

dsh-model-fix

by TikaFlow

Auto-fills reasoning-efforts, context windows, output limits and image modality for models from unofficial (custom) providers, with data from models.dev. Also provides setting cards to control plugin'

Models & ProvidersManifest valid

★ 25

MIT

TypeScript

Nov 17, 2026

dsh plugin --profile web add dsh-model-fix

by qingshanjiluo

Model capability editor for DSH: fetch upstream /models, review and save context window, max output and image support

Manifest valid

★ 0

MIT

JavaScript

Oct 24, 2026

dsh plugin --profile web add dsh-model-caps

DSH plugin: matches a model you declared on a custom gateway to the capability metadata it should have — context window, output cap, reasoning levels and image support — by looking the bare model name

Models & ProvidersManifest valid

★ 0

MIT

JavaScript

dsh plugin --profile web add dsh-model-metadata

by yuioi666

Model Capability Manager for DSH Web: thinking levels, context window, output caps, input modalities, gateway compat presets, EN/中文 UI.

Tools & CapabilitiesDevelopment & InfrastructureModels & ProvidersManifest valid

★ 7

↓ 315/wk

MIT

JavaScript

Sep 27, 2026

dsh plugin --profile web add dsh-plugin-model-capability

by AkotaP

DSH web plugin: a Model Capabilities page in Settings — manage per-model Context Window, Max Output, Input Modalities and Reasoning Levels (Default = drop the field), plus global preset lists.

Terminal & ClientsManifest valid

★ 0

MIT

JavaScript

Nov 10, 2026

dsh plugin --profile web add dsh-model-tweaks

by QJAG1024

DSH plugin: auto-fill metadata (context window, output cap, display name, input modalities) for custom-provider models from the Model Metadata Registry (models.dev)

Manifest valid

★ 5

↓ 37/wk

MIT

TypeScript

Aug 16, 2026

dsh plugin --profile web add dsh-model-meta-autofill