dsh-models-dev
使用实时的 models.dev 目录保持 DSH 提供商模型目录最新：自动更新每个提供商的模型（新增模型和现有模型），同步更新模态和思考级别，也可在 Models 页面通过一个刷新按钮完成。/ 保持实时的
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-models-dev@0.1.10Models Dev 以 dsh-models-dev 发布，当前版本为 0.1.10。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Keep DSH provider model catalogs current with the living models.dev catalog. (README.zh.md)
Configured providers in DeepSeek Harness carry model rows whose modalities (image
input) and thinking levels drift stale between releases, and new models never
appear. This plugin refreshes the models array of the providers you already use
— new models appended, existing models updated in place, hand-added models left
alone. It registers no routes of its own: no duplicated providers.
https://models.dev/api.json (24h TTL cache in
$DSH_HOME/plugins/dsh-models-dev/models.dev.json, offline fallback).models entries:
modalities.input → input (image checkbox), reasoning_options effort
values → reasoningEfforts (thinking levels with their wire spellings).providers.<route>.models with the settings
seam's path ops and revision fencing — the same write the Models page's
capability editor performs.The route's api/baseURL (its wire endpoint) are handled far more
conservatively than the model rows, because they decide which endpoint — and
which bill — a call lands on. An absent field is left absent: llm-pi-ai's
installed catalog usually resolves it already, and pinning a models.dev endpoint
over that resolution is how a working route gets re-pointed at the wrong flavor
(models.dev's zai is the Z.AI open platform, while pi-ai's zai route is
the Z.AI Coding Plan — pinning the open-platform endpoint turns every call
into 429 Insufficient balance or no resource package). The wire values are
written only when llm-pi-ai's strict validation refuses the write without them
(needs an api / needs a baseURL), and a pin left by 0.1.5–0.1.7 is repaired
once sources names the models.dev provider your route actually subscribes to.
Upgrading from 0.1.5–0.1.7: if a route stopped working with a billing-shaped 429 after those releases, check its
baseURLin Settings → Models → (provider) Edit → Customized settings. Those versions pinned the same-named models.dev endpoint; for a GLM Coding Plan key, addsources: { zai: zai-coding-plan }below (or set the Base URL tohttps://api.z.ai/api/coding/paas/v4) and the next refresh repairs it.
refreshHours for
everything hooked up (autoSync).opencode-go: +2/~28), or an error
card carrying the failure, the host log and the stack trace. Pressing it
refreshes that provider's rows immediately.POST /api/dsh-models-dev/refresh body: { "route": "opencode-go" } # or {} for all
The endpoint is loopback-fenced like the other in-box /api routes (a trusted
LAN request is replayed as loopback by dsh-lan).
Requires DSH >= 0.1.7. The plugin's configuration is no longer a
~/.dsh/settings.yaml section: 0.1.7 renders the form from the plugin's own
config schema (Settings → plugins → dsh-models-dev) and keeps the values in
the active profile patch (profiles/<name>/cordis.patch.yml). Same keys as the
entry's config: block:
dsh-models-dev:
refreshHours: 24 # automatic sweep period (h)
autoSync: true # the automatic check at startup and on the timer
modelsDevUrl: https://models.dev/api.json # optional
cachePath: ... # optional catalog cache override
sources: # optional route -> models.dev provider id overrides
my-gateway: opencode-go
zai: zai-coding-plan # GLM Coding Plan keys: models.dev's `zai` is the open platform
An edit applies live (the fields are volatile): the next sweep runs against the new values without restarting the plugin.
Scope: the llm-pi-ai family rows (settingsNs: llm-pi-ai) — the model shape
this plugin writes (input, reasoningEfforts) is that family's schema. Other
adapters (e.g. the DeepSeek one) declare different shapes and are left alone.
A bootstrap trace is kept in $DSH_HOME/plugins/dsh-models-dev/bootstrap.log
(module import → apply → each step → failure stacks), because a deployment with
no logger exporter would otherwise hide every failure behind a "Running" fiber.
npm install
npm run verify # syntax + unit tests + live smoke
npm run bootstrap # replay the host composition against a stub ctx