dsh-model-doctor 0.3.0

package/README.md

@@ -0,0 +1,75 @@
+# dsh-model-doctor · 模型医生
+
+DSH 桌面客户端插件：在对话输入区的**模型选择菜单**里，为每个模型选项追加两枚按钮。
+
+| 按钮 | 功能 |
+| --- | --- |
+| ⟳ 连通检测 | 宿主直连该模型的网关发一次 1-token 探测，行内徽章显示结果：`✓ 832ms`（连通）/ `✗ 402 鉴权/欠费` / `✗ 429 额度/限流` / `✗ 404 不存在` / `✗ 网络/超时`；悬停徽章看完整报错原文 |
+| 🗑 删除 | 两段式确认（先点变「确认删除?」再点执行），从 `llm-pi-ai` 用户配置里移除该模型；写配置前自动备份配置文档（保留最近 5 份 `.dsh-model-doctor-*.bak`） |
+
+菜单顶部是「⚡ 全部检测」条：并发（4 路）探测菜单里出现的**全部**模型，汇总「N 通 / M 异常」，
+并显示 siliconflow 与 DeepSeek 官方的**账户余额**。
+
+## 结果会保留
+
+- 检测结果（含单模型 ⟳ 的结果）落盘为单个快照文件：
+  `%USERPROFILE%\.dsh\model-doctor-results.json`
+- **关掉菜单再打开**：自动回填徽章，状态条显示 `上次结果：X 通 / Y 异常（共 N）· 14:32`
+- **重启软件**：客户端启动时读快照，开菜单即回填，无需重新检测
+- **只保留最近一次**：单文件覆盖写，每次检测直接盖掉上一次，更早的自动消失
+
+## 探测范围与欠费判定
+
+1. `cordis.patch.yml` 里 `llm-pi-ai` 配置的供应商（智谱 / 硅基流动 / 阿里云百炼…）；
+2. **DeepSeek 官方**（不在 llm-pi-ai 配置里，走内置兜底路由
+   `https://api.deepseek.com/v1` + 凭据 `DEEPSEEK_API_KEY`）。
+
+状态码含义：`200` 连通；`401/402/403` 鉴权失败或欠费（余额不足）；`429` 额度耗尽或限流；
+`404` 模型不存在；`5xx` 服务端错误；无响应记为超时。
+密钥从 `~/.dsh/.credentials.yaml` 的 refs 段或进程环境解析，只在内存里拼进请求头，不落盘、不打印。
+
+## 依赖与适配
+
+- 模型菜单本体由 **dsh-reasoning-effort** 插件渲染（`.re-model-*` 行结构）。本插件是
+  行内 DOM 增强：在既有行上追加自持元素并 `stopPropagation`，不替换任何 React 节点、
+  不抢 `conversation.input.model` 座位。禁用 dsh-reasoning-effort 后按钮不出现（安全无副作用）。
+- 宿主↔浏览器通道走 `ctx.connection.fetch.register` 注册到共享 `/api` 通道
+  （客户端裸 `fetch('/api/model-doctor/...')`），这是桌面端实测可达的机制。
+- `package.json` 的 `dsh.client.immediately: true` 必须保留：客户端脚本包默认懒加载，
+  没有它纯 DOM 增强插件永远不会被激活。
+
+## 安装
+
+本目录即完整插件（无构建步骤、零依赖、无需 npm install）。
+
+**方式一（从本包安装）**：把 `dsh-model-doctor` 整个目录放进
+`C:\Users\lxy33\.dsh\profiles\desktop\node_modules\`，并在 profile 的
+`C:\Users\lxy33\.dsh\profiles\desktop\cordis.patch.yml` 末尾追加：
+
+```yaml
+- insert:
+    - id: model-doctor
+      name: 'dsh-model-doctor'
+```
+
+⚠️ 必须是 `insert:` 列表格式；写成 `- id: model-doctor / name: dsh-model-doctor`
+（config 覆盖格式）会被装载器**静默忽略**，插件不会装载且没有任何报错。
+
+宿主半热加载即时生效；客户端半刷新 GUI 页面（`Ctrl+R`）后生效。
+
+**方式二（从桌面 zip）**：解压 `dsh-model-doctor-v0.3.0.zip` 后按方式一放置即可。
+
+## 恢复误删的模型
+
+- 打开 `C:\Users\lxy33\.dsh\profiles\desktop\cordis.patch.yml.dsh-model-doctor-*.bak`
+  （时间戳最新的一份），把对应模型条目复制回 `models:` 列表；
+- 或在 DSH 设置 → 模型供应商里重新添加；
+- 官方内置目录（如 DeepSeek 官方）的模型不受配置文件管辖，点 🗑 会提示无法删除——这是预期行为。
+
+## 版本
+
+- v0.3.0 — 检测结果持久化（跨菜单开关与重启保留，只留最近一次）
+- v0.2.1 — 按钮放大到 27px
+- v0.2.0 — 修复结果回填映射（重扫重新入表 + 模型 id 兜底匹配）、按钮钉在选项右侧、
+  探测范围扩展到权威目录、新增 DeepSeek 官方兜底路由与余额
+- v0.1.2/0.1.3 — 切换到 `/api` 共享通道；修复 `llm.listProviders()` 同步返回被误挂 `.catch`

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# dsh-model-doctor bundle patch: mounts the plugin into a profile layer stack.
+- insert:
+    - id: model-doctor
+      name: 'dsh-model-doctor'

package/lib/client/index.js

@@ -0,0 +1,556 @@
+/**
+ * dsh-model-doctor — 浏览器半（无框架，纯 DOM 增强）。
+ *
+ * 监听模型选择菜单（dsh-reasoning-effort 渲染的 .re-model-menu）的出现，
+ * 在每个模型选项行末尾追加两枚小按钮：
+ *   ⟳  连通检测 —— 经回环 RPC 让 Host 直连网关探测该模型（连通/欠费/限流/鉴权），
+ *      结果以行内小徽章呈现（悬停看完整报错）；
+ *   🗑  删除 —— 两段式确认后让 Host 从 llm-pi-ai 配置移除该模型（Host 自动备份
+ *      配置文档），随后立即移除该行，菜单重开时即为新目录。
+ *
+ * 菜单顶部追加「全部检测」按钮与供应商余额展示（siliconflow）。
+ * 本半不替换任何 React 节点、不与 dsh-reasoning-effort 抢座位：全部增强都在
+ * 既有行内追加自持元素，事件上 stopPropagation 阻止冒泡到选项本身。
+ *
+ * @module dsh-model-doctor/client
+ */
+
+window.__ModuleLoader__.load({
+  id: 'dsh-model-doctor',
+  factory: (require) => {
+    const module = { exports: {} }
+    const exports = module.exports
+
+    const API_BASE = '/api/model-doctor'
+    const MENU_SEL = '.re-model-menu'
+    const PANE_SEL = '.re-model-pane'
+    const ROW_SEL = '.re-model-option'
+    const NAME_SEL = '.re-model-option-name'
+    const TITLE_SEL = '.re-model-group-title'
+    const DIRECTORY_TTL_MS = 30000
+    const DIRECTORY_RETRY_MS = 10000
+
+    /** 客户端半不需要上下文服务：宿主通道走 /api 裸 fetch。 */
+    const inject = []
+
+    const KIND_LABEL = {
+      ok: '连通',
+      auth: '鉴权/欠费',
+      quota: '额度/限流',
+      notfound: '不存在',
+      badrequest: '请求被拒',
+      server: '服务端错误',
+      network: '网络/超时',
+      config: '未配置',
+      unsupported: '无法探测',
+      channel: '通道异常',
+    }
+
+    const CSS = `
+.dmd-actions{position:absolute;right:8px;top:50%;transform:translateY(-50%);display:inline-flex;align-items:center;gap:5px;z-index:2}
+.dmd-btn{width:27px;height:27px;line-height:26px;text-align:center;font-size:16px;border-radius:8px;cursor:pointer;user-select:none;color:inherit;background:color-mix(in srgb,currentColor 8%,transparent);opacity:.72;flex-shrink:0}
+.dmd-btn:hover{opacity:1;background:color-mix(in srgb,currentColor 18%,transparent)}
+.dmd-btn.dmd-refresh.is-busy{opacity:1;animation:dmd-spin 0.9s linear infinite}
+.dmd-btn.dmd-delete:hover{color:#e5484d}
+.dmd-btn.is-armed{width:auto;padding:0 9px;color:#e5484d;opacity:1;font-size:12px;font-weight:600;line-height:26px}
+@keyframes dmd-spin{from{transform:rotate(0deg)}to{transform:rotate(360deg)}}
+.dmd-chip{font-size:11px;line-height:17px;padding:0 7px;margin-left:7px;border-radius:999px;white-space:nowrap;vertical-align:middle;display:inline-block}
+.dmd-chip.is-ok{color:#2fa96e;background:color-mix(in srgb,#2fa96e 16%,transparent)}
+.dmd-chip.is-bad{color:#e5484d;background:color-mix(in srgb,#e5484d 14%,transparent)}
+.dmd-chip.is-warn{color:#d08700;background:color-mix(in srgb,#d08700 16%,transparent)}
+.dmd-allbar{display:flex;align-items:center;gap:8px;padding:6px 12px;margin:2px 6px;font-size:11px;border-radius:8px;background:color-mix(in srgb,currentColor 6%,transparent)}
+.dmd-allbar button{font:inherit;font-size:11px;line-height:16px;padding:2px 9px;border-radius:6px;border:1px solid color-mix(in srgb,currentColor 25%,transparent);background:transparent;color:inherit;cursor:pointer}
+.dmd-allbar button:disabled{opacity:.45;cursor:default}
+.dmd-allbar .dmd-status{opacity:.65}
+.dmd-allbar .dmd-balance{color:#2fa96e}
+`
+
+    /** 调用宿主半的 /api 路由（与 dsh-memory-board 同款裸 fetch 机制）；失败也返回结构化结果。 */
+    function makeDoctor() {
+      const call = async (endpoint, payload) => {
+        try {
+          const response = await fetch(`${API_BASE}/${endpoint}`, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(payload ?? {}),
+          })
+          if (!response.ok) return { ok: false, error: `HTTP ${response.status}` }
+          const result = await response.json()
+          if (result && typeof result === 'object' && 'ok' in result) {
+            return result.ok ? result.value : { ok: false, error: result.error?.message ?? '请求失败' }
+          }
+          return { ok: false, error: '响应格式异常' }
+        } catch (error) {
+          return { ok: false, error: error instanceof Error ? error.message : String(error) }
+        }
+      }
+      return {
+        directory: () => call('directory'),
+        check: (provider, model) => call('check', { provider, model }),
+        checkAll: () => call('checkAll'),
+        deleteModel: (provider, model) => call('deleteModel', { provider, model }),
+        resultsLoad: () => call('resultsLoad'),
+        resultsSave: (snapshot) => call('resultsSave', snapshot),
+      }
+    }
+
+    /* ---------------------------------------------------------------- */
+    /* 增强状态                                                          */
+    /* ---------------------------------------------------------------- */
+
+    let doctor = null
+    let ctxRef = null
+    let styleEl = null
+    let observer = null
+    let rafId = 0
+    let disposed = false
+
+    /** 权威目录缓存：{ providers: [{id,name,models:[{id,name}]}] } */
+    let directory = null
+    let directoryAt = 0
+    let directoryFailedAt = 0
+    /** 最近一次目录获取失败的原文（透出到状态条，便于定位卡点）。 */
+    let directoryError = ''
+
+    /** 最近一次检测结果快照 { results, balances, at }；跨菜单开关与软件重启保留。 */
+    let lastRun = null
+    /** 全部检测进行中：状态条不被缓存回填覆盖。 */
+    let barBusy = false
+
+    /** 行键 -> 模型行元素，供全部检测回填徽章。 */
+    const rowByKey = new Map()
+    /** 模型 id -> 行元素（全表唯一时可用）：供应商 id 空间对不上时的兜底匹配。 */
+    const rowByModel = new Map()
+    /** 本页会话内已删除的模型键，防目录未刷新时行又冒出来。 */
+    const deletedKeys = new Set()
+
+    const keyOf = (provider, model) => `${provider}::${model}`
+
+    function fetchDirectory(force = false) {
+      if (doctor === null) return Promise.resolve()
+      const now = Date.now()
+      if (!force && directory !== null && now - directoryAt < DIRECTORY_TTL_MS) return Promise.resolve()
+      if (!force && directoryFailedAt !== 0 && now - directoryFailedAt < DIRECTORY_RETRY_MS) return Promise.resolve()
+      return doctor.directory().then((result) => {
+        if (disposed) return
+        if (result && result.ok !== false && Array.isArray(result.providers)) {
+          directory = result
+          directoryAt = Date.now()
+          directoryFailedAt = 0
+          directoryError = ''
+          scheduleEnhance()
+        } else {
+          directoryFailedAt = Date.now()
+          directoryError = typeof result?.error === 'string' ? result.error : '响应里没有 providers'
+        }
+      }).catch((error) => {
+        directoryFailedAt = Date.now()
+        directoryError = error instanceof Error ? error.message : String(error)
+      })
+    }
+
+    /* ---------------------------------------------------------------- */
+    /* 结果快照：加载 / 保存 / 回填                                       */
+    /* ---------------------------------------------------------------- */
+
+    function timeLabel(at) {
+      try {
+        return new Date(at).toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit' })
+      } catch {
+        return ''
+      }
+    }
+
+    function summarize(results) {
+      let ok = 0
+      let bad = 0
+      for (const value of Object.values(results ?? {})) {
+        if (value && value.ok === true) ok += 1
+        else bad += 1
+      }
+      return { ok, bad, total: ok + bad }
+    }
+
+    function updateBar(text) {
+      if (barBusy) return
+      document.querySelectorAll('.dmd-allbar .dmd-status').forEach((node) => { node.textContent = text })
+    }
+
+    function updateBalance(balances) {
+      if (!isRecord(balances)) return
+      const parts = Object.entries(balances)
+        .map(([providerId, value]) => `${providerLabel(providerId)}: ¥${value}`)
+      document.querySelectorAll('.dmd-allbar .dmd-balance').forEach((node) => { node.textContent = parts.join(' · ') })
+    }
+
+    /** 把上次结果回填到当前菜单的行与状态条上；返回回填的行数。 */
+    function paintLastRun(prefix) {
+      if (barBusy || lastRun === null || !isRecord(lastRun.results)) return 0
+      let painted = 0
+      for (const [key, single] of Object.entries(lastRun.results)) {
+        const separator = key.lastIndexOf('::')
+        const modelId = separator >= 0 ? key.slice(separator + 2) : key
+        const row = rowByKey.get(key) ?? rowByModel.get(modelId) ?? null
+        if (row === null) continue
+        paintChip(row, single)
+        painted += 1
+      }
+      if (painted > 0) {
+        const { ok, bad, total } = summarize(lastRun.results)
+        const when = timeLabel(lastRun.at)
+        updateBar(`${prefix}${ok} 通 / ${bad} 异常（共 ${total}）${when ? ` · ${when}` : ''}`)
+        updateBalance(lastRun.balances)
+      }
+      return painted
+    }
+
+    /** 记住一次检测结果（覆盖式：永远只保留最近一次）并落盘。 */
+    function rememberResults(results, balances) {
+      lastRun = { results, balances: isRecord(balances) ? balances : {}, at: Date.now() }
+      if (doctor !== null) void doctor.resultsSave(lastRun)
+    }
+
+    function loadResults() {
+      if (doctor === null) return Promise.resolve()
+      return doctor.resultsLoad().then((snapshot) => {
+        if (disposed) return
+        if (snapshot && isRecord(snapshot.results)) {
+          lastRun = snapshot
+          scheduleEnhance()
+        }
+      })
+    }
+
+    /* ---------------------------------------------------------------- */
+    /* 行内元素构造                                                      */
+    /* ---------------------------------------------------------------- */
+
+    function chipOf(result) {
+      const chip = document.createElement('span')
+      if (!result || typeof result !== 'object' || result.ok === undefined) {
+        chip.className = 'dmd-chip is-bad'
+        chip.textContent = '✗ 通道异常'
+        return chip
+      }
+      if (result.ok === true) {
+        chip.className = 'dmd-chip is-ok'
+        chip.textContent = `✓ ${Number.isFinite(result.ms) ? result.ms : '?'}ms`
+        chip.title = '连通正常（1-token 探测）'
+        return chip
+      }
+      const kind = typeof result.kind === 'string'
+        ? result.kind
+        : (typeof result.error === 'string' ? 'channel' : 'unsupported')
+      const label = KIND_LABEL[kind] ?? '失败'
+      const code = typeof result.status === 'number' && result.status > 0 ? ` ${result.status}` : ''
+      chip.className = 'dmd-chip is-bad'
+      chip.textContent = `✗${code} ${label}`
+      const detail = typeof result.message === 'string' && result.message.length > 0
+        ? ` · ${result.message}`
+        : (typeof result.error === 'string' ? ` · ${result.error}` : '')
+      chip.title = `HTTP ${result.status || '-'}${detail}`
+      return chip
+    }
+
+    function wireDelete(button, provider, model, row) {
+      let armed = false
+      let timer = 0
+      const disarm = () => {
+        armed = false
+        button.classList.remove('is-armed')
+        button.textContent = '🗑'
+        button.title = '从列表删除该模型（二次点击确认）'
+      }
+      button.addEventListener('click', (event) => {
+        event.stopPropagation()
+        event.preventDefault()
+        if (doctor === null) return
+        if (!armed) {
+          armed = true
+          button.classList.add('is-armed')
+          button.textContent = '确认删除?'
+          clearTimeout(timer)
+          timer = window.setTimeout(disarm, 2600)
+          return
+        }
+        clearTimeout(timer)
+        button.classList.remove('is-armed')
+        button.textContent = '…'
+        doctor.deleteModel(provider, model).then((result) => {
+          if (disposed) return
+          if (result && result.ok === true) {
+            deletedKeys.add(keyOf(provider, model))
+            const section = row.closest('section')
+            row.remove()
+            if (section !== null && section.querySelectorAll(ROW_SEL).length === 0) section.remove()
+            fetchDirectory(true)
+          } else {
+            const message = result && typeof result.error === 'string' ? result.error : '删除失败'
+            const chip = document.createElement('span')
+            chip.className = 'dmd-chip is-bad'
+            chip.textContent = '✗ 删除失败'
+            chip.title = message
+            button.replaceWith(chip)
+            window.setTimeout(() => chip.remove(), 4000)
+            disarm()
+          }
+        })
+      })
+      button.addEventListener('mousedown', (event) => event.stopPropagation())
+      button.addEventListener('keydown', (event) => event.stopPropagation())
+    }
+
+    /** 把结果徽章插到模型名后面（随文字行内排，不占右侧按钮的位置）。 */
+    function paintChip(row, result) {
+      row.querySelectorAll('.dmd-chip').forEach((chip) => chip.remove())
+      const chip = chipOf(result)
+      const name = row.querySelector(NAME_SEL)
+      if (name !== null && name.parentNode !== null) name.parentNode.insertBefore(chip, name.nextSibling)
+      else row.appendChild(chip)
+      return chip
+    }
+
+    function enhanceRow(row, providerId, model) {
+      const key = keyOf(providerId, model.id)
+      if (deletedKeys.has(key)) {
+        row.remove()
+        return
+      }
+      // 映射登记放在早退之前：已挂过按钮的行每次扫描也要重新入表。
+      rowByKey.set(key, row)
+      const previous = rowByModel.get(model.id)
+      if (previous === undefined) rowByModel.set(model.id, row)
+      else if (previous !== row) rowByModel.set(model.id, null)
+      if (row.querySelector('.dmd-actions') !== null) return
+
+      // 按钮钉在选项右侧：行本身需要是定位上下文，并留出右侧空间。
+      const computed = window.getComputedStyle(row)
+      if (computed.position === 'static') row.style.position = 'relative'
+      if (Number.parseFloat(computed.paddingRight) < 88) row.style.paddingRight = '88px'
+
+      const actions = document.createElement('span')
+      actions.className = 'dmd-actions'
+      actions.dataset.dmdKey = key
+
+      const refresh = document.createElement('span')
+      refresh.className = 'dmd-btn dmd-refresh'
+      refresh.setAttribute('role', 'button')
+      refresh.textContent = '⟳'
+      refresh.title = '检测该模型连通状况 / 是否欠费'
+      refresh.addEventListener('click', (event) => {
+        event.stopPropagation()
+        event.preventDefault()
+        if (doctor === null || refresh.classList.contains('is-busy')) return
+        refresh.classList.add('is-busy')
+        row.querySelectorAll('.dmd-chip').forEach((chip) => chip.remove())
+        doctor.check(providerId, model.id).then((result) => {
+          if (disposed) return
+          refresh.classList.remove('is-busy')
+          paintChip(row, result)
+          rememberResults({ ...(lastRun?.results ?? {}), [key]: result }, lastRun?.balances)
+        })
+      })
+      refresh.addEventListener('mousedown', (event) => event.stopPropagation())
+
+      const del = document.createElement('span')
+      del.className = 'dmd-btn dmd-delete'
+      del.setAttribute('role', 'button')
+      del.textContent = '🗑'
+      del.title = '从列表删除该模型（二次点击确认）'
+      wireDelete(del, providerId, model.id, row)
+
+      actions.appendChild(refresh)
+      actions.appendChild(del)
+      row.appendChild(actions)
+    }
+
+    /* ---------------------------------------------------------------- */
+    /* 「全部检测」条                                                    */
+    /* ---------------------------------------------------------------- */
+
+    function ensureAllBar(pane, hint) {
+      const existing = pane.querySelector('.dmd-allbar')
+      if (existing !== null) {
+        if (hint) {
+          const status = existing.querySelector('.dmd-status')
+          if (status !== null && status.textContent === '') status.textContent = hint
+        }
+        return
+      }
+      const firstSection = pane.querySelector('section')
+      if (firstSection === null) return
+      const bar = document.createElement('div')
+      bar.className = 'dmd-allbar'
+      const button = document.createElement('button')
+      button.type = 'button'
+      button.textContent = '⚡ 全部检测'
+      button.title = '并发探测列表里全部模型的连通状况与额度'
+      const status = document.createElement('span')
+      status.className = 'dmd-status'
+      const balance = document.createElement('span')
+      balance.className = 'dmd-balance'
+      button.addEventListener('click', (event) => {
+        event.stopPropagation()
+        event.preventDefault()
+        if (doctor === null || button.disabled) return
+        button.disabled = true
+        barBusy = true
+        status.textContent = '探测中…'
+        balance.textContent = ''
+        rowByKey.forEach((row) => {
+          row.querySelectorAll('.dmd-chip').forEach((chip) => chip.remove())
+        })
+        doctor.checkAll().then((result) => {
+          if (disposed) return
+          button.disabled = false
+          barBusy = false
+          if (!result || result.ok === false || !isRecord(result.results)) {
+            status.textContent = `失败：${result && typeof result.error === 'string' ? result.error : '通道异常'}`
+            return
+          }
+          rememberResults(result.results, result.balances)
+          let okCount = 0
+          let badCount = 0
+          let unmatched = 0
+          const entries = Object.entries(result.results)
+          for (const [key, single] of entries) {
+            const separator = key.lastIndexOf('::')
+            const modelId = separator >= 0 ? key.slice(separator + 2) : key
+            const row = rowByKey.get(key) ?? rowByModel.get(modelId) ?? null
+            if (row === null) unmatched += 1
+            else paintChip(row, single)
+            if (single && single.ok === true) okCount += 1
+            else badCount += 1
+          }
+          const suffix = unmatched > 0 ? ` · 未匹配 ${unmatched}` : ''
+          const when = timeLabel(lastRun?.at ?? Date.now())
+          status.textContent = `完成：${okCount} 通 / ${badCount} 异常（共 ${entries.length}）${suffix}${when ? ` · ${when}` : ''}`
+          if (isRecord(result.balances)) {
+            const parts = Object.entries(result.balances)
+              .map(([providerId, value]) => `${providerLabel(providerId)}: ¥${value}`)
+            balance.textContent = parts.join(' · ')
+          }
+        })
+      })
+      button.addEventListener('mousedown', (event) => event.stopPropagation())
+      bar.appendChild(button)
+      bar.appendChild(status)
+      bar.appendChild(balance)
+      if (hint) status.textContent = hint
+      firstSection.parentNode.insertBefore(bar, firstSection)
+    }
+
+    function providerLabel(providerId) {
+      const provider = directory?.providers?.find((p) => p.id === providerId)
+      return provider?.name ?? providerId
+    }
+
+    /* ---------------------------------------------------------------- */
+    /* 菜单增强主逻辑                                                    */
+    /* ---------------------------------------------------------------- */
+
+    function enhance() {
+      if (disposed) return
+      const menu = document.querySelector(MENU_SEL)
+      if (menu === null) return
+
+      if (directory === null || Date.now() - directoryAt >= DIRECTORY_TTL_MS) {
+        void fetchDirectory()
+      }
+
+      rowByKey.clear()
+      rowByModel.clear()
+      const panes = menu.querySelectorAll(PANE_SEL)
+      panes.forEach((pane) => {
+        const sections = pane.querySelectorAll('section')
+        if (sections.length === 0) return
+        let wired = 0
+        sections.forEach((section) => {
+          const title = section.querySelector(TITLE_SEL)?.textContent?.trim()
+          if (title === undefined || title.length === 0) return
+          const rows = Array.from(section.querySelectorAll(ROW_SEL))
+          const group = directory?.providers?.find((p) => p.name === title || p.id === title)
+          if (group !== undefined && rows.length === group.models.length) {
+            rows.forEach((row, index) => {
+              const model = group.models[index]
+              const name = row.querySelector(NAME_SEL)?.textContent?.trim()
+              if (name !== undefined && name !== model.name) return
+              enhanceRow(row, group.id, model)
+              wired += 1
+            })
+            return
+          }
+          // 兜底：供应商显示名对不上时，按「模型显示名在全目录里唯一」反查
+          rows.forEach((row) => {
+            const name = row.querySelector(NAME_SEL)?.textContent?.trim()
+            if (name === undefined || name.length === 0) return
+            const hits = []
+            for (const provider of directory?.providers ?? []) {
+              for (const model of provider.models) {
+                if (model.name === name) hits.push({ provider, model })
+              }
+            }
+            if (hits.length !== 1) return
+            enhanceRow(row, hits[0].provider.id, hits[0].model)
+            wired += 1
+          })
+        })
+        let hint = ''
+        if (directory === null) {
+          hint = directoryFailedAt !== 0
+            ? `模型医生：目录获取失败 · ${directoryError || '与宿主半通信异常'}`
+            : '模型医生：目录获取中…'
+        } else if (wired === 0) {
+          hint = '模型医生：未匹配到模型行（目录与菜单不一致）'
+        }
+        ensureAllBar(pane, hint)
+        if (wired > 0) paintLastRun('上次结果：')
+      })
+    }
+
+    function scheduleEnhance() {
+      if (rafId !== 0 || disposed) return
+      rafId = window.requestAnimationFrame(() => {
+        rafId = 0
+        enhance()
+      })
+    }
+
+    /* ---------------------------------------------------------------- */
+    /* apply                                                            */
+    /* ---------------------------------------------------------------- */
+
+    function isRecord(value) {
+      return typeof value === 'object' && value !== null && !Array.isArray(value)
+    }
+
+    function apply(ctx) {
+      ctxRef = ctx
+      doctor = makeDoctor()
+
+      ctx.effect(() => {
+        styleEl = document.createElement('style')
+        styleEl.dataset.plugin = 'dsh-model-doctor'
+        styleEl.textContent = CSS
+        document.head.appendChild(styleEl)
+        return () => styleEl?.remove()
+      }, 'model-doctor: styles')
+
+      ctx.effect(() => {
+        observer = new MutationObserver(scheduleEnhance)
+        observer.observe(document.body, { childList: true, subtree: true })
+        scheduleEnhance()
+        return () => {
+          disposed = true
+          observer?.disconnect()
+          if (rafId !== 0) window.cancelAnimationFrame(rafId)
+        }
+      }, 'model-doctor: observer')
+
+      void loadResults()
+    }
+
+    module.exports = { apply, inject }
+    return module.exports
+  },
+})