dsh-model-params 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-subagent-conductor contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+# dsh-model-params
+
+## English
+
+**Current release: 0.1.0** — models.dev parameter assistant inside the official DeepSeek Harness Models settings page.
+
+For every configured `llm-pi-ai` provider card (custom OpenAI-compatible gateways such as the ones you add under Settings → Models), a `models.dev 参数` control fetches the official models.dev records for the provider's configured model ids and proposes the metadata pi-ai needs: context window, max output tokens, and reasoning-effort levels. One click writes the merged `models` array back to that provider profile through the official revision-aware Settings API.
+
+Safety boundaries:
+
+- The control never auto-writes. You open the panel, review the per-model diff, then click **应用并写入该 provider** — it writes only that provider's `models` array in the `llm-pi-ai` namespace.
+- Default policy fills **missing** parameters only; tick **覆盖已有值** to also replace differing ones.
+- Nothing leaves the machine except the models.dev catalog request (Host side, optional `HTTPS_PROXY`), and no credentials are ever sent.
+- Models whose id models.dev does not know are reported as 未收录 and left untouched.
+
+models.dev model ids may collide across catalog providers; the matcher prefers the record whose provider id relates to the model id's vendor prefix and otherwise takes the first metadata-bearing record.
+
+## 中文
+
+面向 DeepSeek Harness Web 官方 **设置 → 模型** 页的 models.dev 参数助手。每个已配置的 `llm-pi-ai` provider 卡片内提供 `models.dev 参数` 入口：按该 provider 的模型 id 在 models.dev 官方目录中匹配，预览上下文窗口 / max 输出 / 推理档位，确认后一次性写回该 provider 的 `models` 配置（官方 revision-aware Settings API，仅写 `llm-pi-ai` 命名空间下当前 provider 的数组）。
+
+- 默认仅补缺失参数；勾选「覆盖已有值」才替换差异值。
+- Host 只负责拉取并缓存 models.dev 目录（6 小时，支持 `HTTPS_PROXY`），不接触任何 LLM 配置与凭据。
+- models.dev 未收录的模型 id 会明确标记，不写入。
+
+## Development
+
+From this directory run:
+
+```powershell
+npm test
+npm run check
+npm pack --dry-run
+```
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# dsh-model-params bundle patch.
+# Host-plane single instance: do not copy this row into an agent preset.
+- insert:
+    - id: model-params
+      name: 'dsh-model-params'

package/lib/client.js

@@ -0,0 +1,267 @@
+// dsh-model-params — client half (official __ModuleLoader__ web bundle)
+//
+// Renders a compact "models.dev 参数" affordance inside every official
+// llm-pi-ai provider card on the Models settings page
+// (settings.models.provider-card, keyed by the pi-ai settings namespace).
+// It reads the current provider profile from the official llm-pi-ai Settings
+// scope, asks the Host for the matching models.dev records, previews the
+// proposed context / max-output / reasoning-effort values per model, and —
+// only on an explicit "应用" click — writes the merged models array back
+// through the revision-aware official Settings API. Default policy fills
+// missing parameters only; "覆盖已有值" also replaces differing ones.
+// The plugin never auto-writes, never touches other providers/namespaces,
+// and never sends credentials anywhere.
+
+window.__ModuleLoader__.load({
+  id: 'dsh-model-params',
+  factory: (require) => {
+    const module = { exports: {} }
+    const exports = module.exports
+    const React = require('react')
+    const e = React.createElement
+
+    const PI_NS = 'llm-pi-ai'
+    const API = '/api/model-params/lookup'
+    const FETCH_TIMEOUT_MS = 20000
+    const CSS_ID = 'dsh-model-params/style'
+    const LEVELS = ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max']
+
+    const CSS = [
+      '.dpmRow{display:flex;align-items:center;gap:8px;margin:2px 0}',
+      '.dpmButton{appearance:none;font:inherit;cursor:pointer;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:4px 12px;font-size:12px;line-height:1.5;background:var(--dsw-alias-bg-layer-3);color:var(--dsw-alias-label-secondary)}',
+      '.dpmButton:hover:not(:disabled){border-color:var(--dsw-alias-label-dimmed);color:var(--dsw-alias-label-primary)}',
+      '.dpmButton:disabled{opacity:.5;cursor:default}',
+      '.dpmWrap{position:relative;display:inline-flex}',
+      '.dpmPanel{position:absolute;z-index:30;left:0;top:calc(100% + 6px);width:min(480px,calc(100vw - 48px));max-height:min(420px,calc(100vh - 120px));overflow:auto;display:flex;flex-direction:column;gap:6px;padding:10px;border:1px solid var(--dsw-alias-border-inverted);border-radius:12px;background:var(--dsw-specific-menu);box-shadow:var(--dsw-shadow-lv3);color:var(--dsw-alias-label-primary);font-size:12px;line-height:1.5}',
+      '.dpmPanel h4{margin:0;font-size:13px}',
+      '.dpmHint{color:var(--dsw-alias-label-tertiary);margin:0;font-size:11px;line-height:1.5}',
+      '.dpmErr{color:var(--dsw-alias-state-error-primary);margin:0;font-size:11px;word-break:break-all}',
+      '.dpmList{display:flex;flex-direction:column;gap:6px}',
+      '.dpmItem{border:1px solid var(--dsw-alias-border-l2);border-radius:10px;padding:8px;background:var(--dsw-alias-bg-layer-3)}',
+      '.dpmItemHead{display:flex;align-items:baseline;gap:8px}.dpmItemId{font-weight:600;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.dpmItemTag{flex:none;color:var(--dsw-alias-label-tertiary);font-size:11px}',
+      '.dpmFields{display:flex;flex-direction:column;gap:2px;margin-top:4px;color:var(--dsw-alias-label-secondary)}',
+      '.dpmFieldRow{display:flex;gap:8px;flex-wrap:wrap}.dpmFieldRow b{color:var(--dsw-alias-label-secondary);font-weight:600}',
+      '.dpmNoMatch{color:var(--dsw-alias-state-warn-primary)}',
+      '.dpmFoot{display:flex;align-items:center;gap:10px;justify-content:flex-end;border-top:1px solid var(--dsw-alias-border-l2);margin-top:2px;padding-top:8px}',
+      '.dpmFoot label{display:inline-flex;align-items:center;gap:6px;color:var(--dsw-alias-label-secondary);margin-right:auto;cursor:pointer}',
+      '.dpmSaved{color:var(--dsw-alias-state-success-primary);margin:0;font-size:11px}',
+      '.dpmPrimary{background:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-3);border-color:transparent}',
+    ].join('')
+
+    function ensureStyles() {
+      if (typeof document === 'undefined') return
+      if (document.querySelector('style[data-plugin-css=' + JSON.stringify(CSS_ID) + ']')) return
+      const tag = document.createElement('style')
+      tag.dataset.pluginCss = CSS_ID
+      tag.textContent = CSS
+      document.head.appendChild(tag)
+    }
+    function removeStyles() {
+      if (typeof document === 'undefined') return
+      const tag = document.querySelector('style[data-plugin-css=' + JSON.stringify(CSS_ID) + ']')
+      if (tag && tag.parentNode) tag.parentNode.removeChild(tag)
+    }
+
+    const clean = (value) => typeof value === 'string' && value.trim() ? value.trim() : undefined
+    const intersectLevels = (values) => (values || []).filter((value) => LEVELS.includes(value))
+
+    function paramLine(label, value) {
+      if (value === undefined || value === null || value === '') return null
+      return e('span', { key: label }, label + ': ' + value)
+    }
+
+    function ModelParamsExtension(props) {
+      const row = props.provider
+      const entry = row && row.entry && typeof row.entry === 'object' ? row.entry : row
+      const route = entry && (entry.provider || row && row.provider)
+      const settingsNs = entry && entry.settingsNs
+      const api = props.api
+      const scope = props.scope
+      const [open, setOpen] = React.useState(false)
+      const [busy, setBusy] = React.useState(false)
+      const [failed, setFailed] = React.useState('')
+      const [saved, setSaved] = React.useState('')
+      const [overwrite, setOverwrite] = React.useState(false)
+      const [result, setResult] = React.useState(null) // { matched: [], unmatched: [] }
+      const ref = React.useRef(null)
+
+      React.useEffect(() => {
+        if (!open) return undefined
+        const outside = (event) => { if (!ref.current || !ref.current.contains(event.target)) setOpen(false) }
+        const key = (event) => { if (event.key === 'Escape') setOpen(false) }
+        document.addEventListener('mousedown', outside)
+        document.addEventListener('keydown', key)
+        return () => {
+          document.removeEventListener('mousedown', outside)
+          document.removeEventListener('keydown', key)
+        }
+      }, [open])
+
+      if (!route || settingsNs !== PI_NS) return null
+
+      const snap = scope && typeof scope.getSnapshot === 'function' ? scope.getSnapshot() : { status: 'unavailable' }
+      const value = snap.status === 'ready' && snap.value && typeof snap.value === 'object' ? snap.value : {}
+      const profile = value.providers && value.providers[route] && typeof value.providers[route] === 'object' ? value.providers[route] : null
+      const models = Array.isArray(profile && profile.models) ? profile.models : []
+      const writable = snap.status === 'ready' && snap.writable === true && !!api && !!api.settings
+
+      async function load() {
+        if (!models.length || busy) return
+        setBusy(true)
+        setFailed('')
+        setSaved('')
+        setResult(null)
+        const controller = new AbortController()
+        const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS)
+        try {
+          const ids = models.map((model) => model.id).filter(Boolean)
+          const response = await fetch(API + '?ids=' + encodeURIComponent(ids.join(',')), { cache: 'no-store', signal: controller.signal })
+          const data = await response.json()
+          if (!data || data.ok !== true) throw new Error((data && data.error) || 'lookup failed')
+          setResult({ matched: data.matched || [], unmatched: data.unmatched || [] })
+        } catch (error) {
+          setFailed(String((error && error.name === 'AbortError') ? '请求超时' : (error && error.message) || error))
+        } finally {
+          clearTimeout(timer)
+          setBusy(false)
+        }
+      }
+
+      function mergeModel(existing, found, index) {
+        const next = { ...existing }
+        const from = result.matched.find((match) => match.requested === existing.id) || found
+        if (!from) return null
+        const apply = (key, foundValue) => {
+          if (foundValue === undefined) return
+          if (next[key] === undefined || next[key] === null) next[key] = foundValue
+          else if (overwrite && next[key] !== foundValue) next[key] = foundValue
+        }
+        apply('contextWindow', from.context)
+        apply('maxTokens', from.maxOutput)
+        if (!next.name) next.name = from.name
+        const offered = intersectLevels(from.efforts)
+        if (offered.length) {
+          const current = next.reasoningEfforts && typeof next.reasoningEfforts === 'object' && !Array.isArray(next.reasoningEfforts) ? next.reasoningEfforts : {}
+          const merged = { ...current }
+          let changed = false
+          for (const level of offered) {
+            if (merged[level] === undefined || overwrite) {
+              if (merged[level] !== level) changed = true
+              merged[level] = level
+            }
+          }
+          if (overwrite) {
+            for (const key of Object.keys(merged)) {
+              if (!offered.includes(key) && LEVELS.includes(key)) delete merged[key]
+            }
+            changed = true
+          }
+          if (changed || Object.keys(merged).length !== Object.keys(current).length) next.reasoningEfforts = merged
+          if (Object.keys(next.reasoningEfforts || {}).length === 0 && !current) delete next.reasoningEfforts
+        }
+        void index
+        return next
+      }
+
+      async function applyAll() {
+        if (!writable || busy || !result) return
+        const byRequested = new Map(result.matched.map((match) => [match.requested, match]))
+        const nextModels = models.map((model) => {
+          const found = byRequested.get(model.id)
+          return found ? (mergeModel(model, found) || model) : model
+        })
+        const touched = nextModels.some((model, index) => model !== models[index])
+        if (!touched) { setSaved('没有可写入的变更（仅补缺失且无缺失）。'); return }
+        setBusy(true)
+        setFailed('')
+        setSaved('')
+        try {
+          const payload = { ns: PI_NS, ops: [{ op: 'set', path: ['providers', route, 'models'], value: nextModels }], ...(snap.revision === undefined ? {} : { expectedRevision: snap.revision }) }
+          const response = await api.settings.mutate(payload)
+          if (!(response && response.result && response.result.ok)) {
+            const detail = response && response.result && response.result.error && response.result.error.message
+            throw new Error(detail || '设置被拒绝')
+          }
+          setSaved('已写入 provider "' + route + '" 的模型参数。')
+          setResult(null)
+        } catch (error) {
+          setFailed(String((error && error.message) || error))
+        } finally {
+          setBusy(false)
+        }
+      }
+
+      const displayName = entry && entry.displayName ? entry.displayName : route
+      const hasModels = models.length > 0
+      const summary = result && result.matched ? result.matched.length + '/' + models.length + ' 匹配' : ''
+
+      return e('div', { className: 'dpmWrap', ref },
+        e('button', { type: 'button', className: 'dpmButton', disabled: !hasModels, 'aria-haspopup': 'dialog', 'aria-expanded': open, onClick: () => { setOpen((v) => !v); if (!open) load() } },
+          busy ? '查询中…' : ('models.dev 参数' + (summary ? ' · ' + summary : ''))),
+        open && e('div', { className: 'dpmPanel', role: 'dialog', 'aria-label': displayName + ' models.dev 参数' },
+          e('h4', null, displayName + ' · models.dev 官方参数'),
+          failed && e('p', { className: 'dpmErr', role: 'alert' }, failed),
+          saved && e('p', { className: 'dpmSaved', role: 'status' }, saved),
+          !hasModels && e('p', { className: 'dpmHint' }, '该 provider 的 models 列表为空；先在官方页添加模型条目后再获取参数。'),
+          result && e('div', { className: 'dpmList' }, result.matched.length === 0 && result.unmatched.length === 0
+            ? e('p', { className: 'dpmHint' }, '没有可匹配的模型。')
+            : models.map((model) => {
+              const found = result.matched.find((match) => match.requested === model.id)
+              const currentEfforts = model.reasoningEfforts && typeof model.reasoningEfforts === 'object' && !Array.isArray(model.reasoningEfforts)
+                ? Object.keys(model.reasoningEfforts).join('/')
+                : undefined
+              const propose = found ? mergeModel(model, found) : null
+              const change = propose && (
+                (model.contextWindow === undefined && propose.contextWindow !== undefined) ||
+                (model.maxTokens === undefined && propose.maxTokens !== undefined) ||
+                (model.contextWindow !== undefined && propose.contextWindow !== undefined && overwrite && model.contextWindow !== propose.contextWindow) ||
+                (model.maxTokens !== undefined && propose.maxTokens !== undefined && overwrite && model.maxTokens !== propose.maxTokens) ||
+                (propose.reasoningEfforts && JSON.stringify(propose.reasoningEfforts) !== JSON.stringify(model.reasoningEfforts))
+              )
+              return e('div', { key: model.id, className: 'dpmItem' },
+                e('div', { className: 'dpmItemHead' },
+                  e('span', { className: 'dpmItemId' }, model.id),
+                  found
+                    ? e('span', { className: 'dpmItemTag' }, found.providerName + ' · ' + found.name + (change ? ' · 将更新' : ' · 完整'))
+                    : e('span', { className: 'dpmItemTag dpmNoMatch' }, 'models.dev 未收录'),
+                ),
+                found && e('div', { className: 'dpmFields' },
+                  e('div', { className: 'dpmFieldRow' }, paramLine('上下文', found.context), paramLine('max 输出', found.maxOutput), paramLine('推理档位', found.efforts && found.efforts.length ? found.efforts.join('/') : undefined)),
+                  e('div', { className: 'dpmFieldRow' },
+                    paramLine('当前上下文', model.contextWindow),
+                    paramLine('当前 max', model.maxTokens),
+                    currentEfforts && paramLine('当前推理', currentEfforts),
+                  ),
+                ),
+              )
+            })),
+          result && e('div', { className: 'dpmFoot' },
+            e('label', null, e('input', { type: 'checkbox', checked: overwrite, onChange: (ev) => setOverwrite(ev.target.checked) }), '覆盖已有值（默认仅补缺失）'),
+            e('button', { type: 'button', className: 'dpmButton dpmPrimary', disabled: !writable || busy, onClick: applyAll }, '应用并写入该 provider'),
+          ),
+        ),
+      )
+    }
+
+    function apply(ctx) {
+      ensureStyles()
+      ctx.effect(() => () => removeStyles(), 'dsh-model-params: styles')
+      // Fine-grained remote settings through @deepseek-ai/dsh-api-remotes
+      // (ctx.remote); the legacy connection API no longer exists on rc.1.
+      const remote = ctx.get('remote')
+      const api = remote && remote.settings
+        ? { settings: { mutate: (payload) => remote.settings.mutate(payload.ns, payload.ops, payload.expectedRevision).then((result) => ({ result })) } }
+        : undefined
+      const scope = ctx.settingsScope.bind({ namespace: PI_NS })
+      return ctx.slots.inject('settings.models.provider-card', () => ctx.slots.register(
+        { name: 'settings.models.provider-card', key: PI_NS },
+        (props) => e(ModelParamsExtension, { ...props, api, scope }),
+      ))
+    }
+
+    exports.name = 'dsh-model-params'
+    exports.inject = ['slots', 'settingsScope', 'remote', 'remote.settings']
+    exports.apply = apply
+    return module.exports
+  },
+})

package/lib/index.js

@@ -0,0 +1,136 @@
+// dsh-model-params — Host half.
+//
+// One loopback/same-origin fenced endpoint:
+//   GET /api/model-params/lookup?ids=a,b,c
+// Loads https://models.dev/api.json (6h in-memory cache, optional HTTPS_PROXY
+// fallback), matches each requested model id and returns the metadata-bearing
+// entries (context / max output / reasoning effort values). The Client half
+// renders the official provider-card extension; it never sends credentials
+// and the Host never touches user LLM settings — writes happen on the Client
+// through the official Settings scope of the provider namespace.
+
+import { ProxyAgent } from 'undici'
+import { lookupModels, parseModelsDevCatalog } from './modelsdev.js'
+
+export const name = 'dsh-model-params'
+export const inject = ['webServer']
+
+const MODELS_DEV_URL = 'https://models.dev/api.json'
+const FETCH_TIMEOUT_MS = 30_000
+const CACHE_TTL_MS = 6 * 60 * 60 * 1000
+const MAX_IDS = 100
+const MAX_ID_LENGTH = 240
+
+let cache = null // { at: number, index: Map, fetchedAt: string }
+
+function proxyUrl() {
+  return process.env.HTTPS_PROXY || process.env.https_proxy
+}
+
+async function fetchCatalog() {
+  const now = Date.now()
+  if (cache && now - cache.at < CACHE_TTL_MS) return cache
+  if (cache && cache.pending) {
+    await cache.pending
+    return cache
+  }
+  const pending = (async () => {
+    const options = {
+      headers: { accept: 'application/json' },
+      signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+    }
+    const proxy = proxyUrl()
+    const attempt = async (dispatcher) => {
+      const response = await fetch(MODELS_DEV_URL, dispatcher ? { ...options, dispatcher } : options)
+      if (!response.ok) throw new Error(`models.dev HTTP ${response.status}`)
+      return response.json()
+    }
+    try {
+      const document = await attempt()
+      const index = parseModelsDevCatalog(document)
+      cache = { at: now, index, fetchedAt: new Date().toISOString(), pending: undefined }
+      return cache
+    } catch (error) {
+      if (proxy) {
+        try {
+          const dispatcher = new ProxyAgent(proxy)
+          try {
+            const document = await attempt(dispatcher)
+            cache = { at: now, index: parseModelsDevCatalog(document), fetchedAt: new Date().toISOString(), pending: undefined }
+            return cache
+          } finally {
+            void dispatcher.close().catch(() => {})
+          }
+        } catch (proxyError) {
+          throw new Error(`models.dev fetch failed (direct and via proxy): ${String(error?.message || error)} / ${String(proxyError?.message || proxyError)}`)
+        }
+      }
+      throw error
+    }
+  })()
+  if (!cache) cache = { at: now, index: undefined, fetchedAt: undefined, pending }
+  try {
+    await pending
+  } finally {
+    if (cache && cache.pending === pending) cache.pending = undefined
+  }
+  return cache
+}
+
+function parseIds(query) {
+  const raw = typeof query === 'string' ? query : ''
+  if (raw.length > 8000) throw Object.assign(new Error('query too large'), { status: 413 })
+  const ids = raw.split(',').map((value) => value.trim()).filter(Boolean)
+  if (ids.length > MAX_IDS) throw Object.assign(new Error('too many ids'), { status: 400 })
+  if (ids.some((id) => id.length > MAX_ID_LENGTH)) throw Object.assign(new Error('id too long'), { status: 400 })
+  return ids
+}
+
+function originAllowed(req) {
+  const origin = req.headers.origin
+  if (!origin) return true
+  const host = req.headers.host || ''
+  const base = /^https?:\/\/([^/]+)/i.exec(origin)
+  return !!base && base[1] === host
+}
+
+function hostAllowed(req) {
+  let host = String(req.headers.host || '').split(':')[0].toLowerCase()
+  host = host.replace(/^\[|\]$/g, '')
+  return host === '127.0.0.1' || host === 'localhost' || host === '::1'
+}
+
+function json(res, status, payload) {
+  const body = JSON.stringify(payload)
+  res.writeHead(status, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' })
+  res.end(body)
+}
+
+export function apply(ctx) {
+  const ws = ctx.webServer
+  ctx.effect(() => ws.register({
+    kind: 'exact',
+    path: '/api/model-params/lookup',
+    handler: async (req, res) => {
+      if (!originAllowed(req) || !hostAllowed(req)) {
+        json(res, 403, { ok: false, error: 'forbidden' })
+        return
+      }
+      try {
+        const ids = parseIds(req.url ? new URL(req.url, 'http://local').searchParams.get('ids') : '')
+        const current = await fetchCatalog()
+        if (!current.index) throw new Error('models.dev catalog unavailable')
+        const result = lookupModels(current.index, ids)
+        json(res, 200, {
+          ok: true,
+          fetchedAt: current.fetchedAt,
+          matched: result.matched,
+          unmatched: result.unmatched,
+        })
+      } catch (error) {
+        const status = Number(error && error.status) || 500
+        json(res, status, { ok: false, error: String((error && error.message) || error) })
+      }
+    },
+  }), 'dsh-model-params: lookup route')
+}

package/lib/modelsdev.js

@@ -0,0 +1,106 @@
+// dsh-model-params — pure models.dev catalog parsing and matching helpers.
+//
+// models.dev/api.json shape (defensive reads only):
+//   { providers: { <id>: { id, name, models: [ { id, name, limit?: { context?, output? },
+//       reasoning_options?: [ { type: 'effort', values?: string[] } ] } ] } } }
+//
+// A requested model id may carry a vendor prefix ("z-ai/glm-5.3-flash",
+// "deepseek/deepseek-v4-flash"). Matching therefore tries the exact id first
+// and then the segment after the last "/". Reasoning-effort values offered by
+// models.dev are intersected with the pi-ai THINKING_LEVELS key space
+// (off/minimal/low/medium/high/xhigh/max) so a write can never fail schema
+// validation.
+
+export const THINKING_LEVELS = ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max']
+
+const nonEmpty = (value) => typeof value === 'string' && value.trim().length > 0
+const clean = (value) => nonEmpty(value) ? value.trim() : undefined
+const positiveInt = (value) => Number.isSafeInteger(value) && value > 0 ? value : undefined
+
+/** Parse one models.dev catalog document into a detached match index. */
+export function parseModelsDevCatalog(document) {
+  const root = document && typeof document === 'object' ? document : {}
+  const providers = root.providers && typeof root.providers === 'object' && !Array.isArray(root.providers) ? root.providers : {}
+  const byId = new Map()
+  for (const [providerId, provider] of Object.entries(providers)) {
+    if (!provider || typeof provider !== 'object') continue
+    const providerName = clean(provider.name) || clean(provider.id) || providerId
+    const models = Array.isArray(provider.models) ? provider.models : []
+    for (const model of models) {
+      if (!model || typeof model !== 'object') continue
+      const modelId = clean(model.id)
+      if (!modelId) continue
+      const limit = model.limit && typeof model.limit === 'object' ? model.limit : {}
+      const context = positiveInt(limit.context)
+      const output = positiveInt(limit.output)
+      let efforts = []
+      const options = Array.isArray(model.reasoning_options) ? model.reasoning_options : []
+      for (const option of options) {
+        if (!option || option.type !== 'effort' || !Array.isArray(option.values)) continue
+        for (const value of option.values) {
+          const id = clean(value)
+          if (id && !efforts.includes(id)) efforts.push(id)
+        }
+      }
+      if (context === undefined && output === undefined && efforts.length === 0) continue
+      const key = modelId.toLowerCase()
+      const entry = {
+        providerId,
+        providerName,
+        modelId,
+        name: clean(model.name) || modelId,
+        ...(context !== undefined ? { context } : {}),
+        ...(output !== undefined ? { maxOutput: output } : {}),
+        ...(efforts.length ? { efforts } : {}),
+      }
+      const list = byId.get(key)
+      if (list) list.push(entry)
+      else byId.set(key, [entry])
+    }
+  }
+  return byId
+}
+
+/** Prefer the entry whose provider matches a hint; otherwise the first. */
+function pickEntry(entries, hint) {
+  if (entries.length <= 1) return entries[0]
+  const lower = hint ? String(hint).toLowerCase() : ''
+  if (lower) {
+    const preferred = entries.find((entry) =>
+      entry.providerId.toLowerCase().includes(lower) || lower.includes(entry.providerId.toLowerCase()))
+    if (preferred) return preferred
+  }
+  return entries[0]
+}
+
+/**
+ * Look up requested model ids. Returns entries only for ids with at least one
+ * metadata-bearing models.dev record; every other id is reported as unmatched.
+ * @param {Map<string, object[]>} index - output of parseModelsDevCatalog.
+ * @param {string[]} ids - configured model ids (vendor prefixes allowed).
+ * @param {(id: string) => string|undefined} hintFor - optional provider hint per id.
+ * @returns {{ matched: object[], unmatched: string[] }}
+ */
+export function lookupModels(index, ids, hintFor = () => undefined) {
+  const matched = []
+  const unmatched = []
+  for (const raw of ids || []) {
+    const modelId = clean(raw)
+    if (!modelId) continue
+    const exact = index.get(modelId.toLowerCase())
+    const base = modelId.slice(modelId.lastIndexOf('/') + 1)
+    const byBase = base !== modelId ? index.get(base.toLowerCase()) : undefined
+    const entries = byBase && byBase.length && (!exact || byBase.length < exact.length) ? byBase : exact
+    if (!entries || !entries.length) {
+      unmatched.push(modelId)
+      continue
+    }
+    matched.push({ requested: modelId, ...pickEntry(entries, hintFor(modelId)) })
+  }
+  return { matched, unmatched }
+}
+
+/** Restrict raw models.dev effort values to the pi-ai thinking-level space. */
+export function intersectEfforts(efforts, levels = THINKING_LEVELS) {
+  return (efforts || []).filter((value) => levels.includes(value))
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "dsh-model-params",
+  "version": "0.1.0",
+  "description": "EN: models.dev parameter assistant for the official DeepSeek Harness Models page: per-provider one-click context / max-output / reasoning-effort fill. ZH: 官方模型设置页的 models.dev 参数助手：按 provider 一键补全上下文、max 输出与推理档位。",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "check": "node --check lib/index.js && node --check lib/modelsdev.js && node --check lib/client.js",
+    "test": "node --test"
+  },
+  "dependencies": {
+    "undici": "^7.0.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-api-remotes"
+      ]
+    }
+  },
+  "repository": { "type": "git", "url": "git+https://github.com/YrracOwl/dsh-model-params.git" },
+  "homepage": "https://github.com/YrracOwl/dsh-model-params#readme",
+  "bugs": { "url": "https://github.com/YrracOwl/dsh-model-params/issues" },
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  }
+}