@ponydev/dsh-model-usage 1.1.0 → 1.2.1

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 1.2.1 — 2026-10-20
+
+### 变更（UI 对齐 DSH 设置页规范）
+- 版本/检查更新改为**原生设置行**（16px 标签 + 44px 行高 + 细分割线 + 右侧控件）
+- 设置内容去掉重复大标题（section 名称已由设置导航提供）
+- 卡片圆角统一 12px、列表改为无卡片底的 44px 行 + 细线（对齐 通用设置/模型 页）
+- 字号规范化：正文 12px、行标签 16px、卡片标签 12px，去掉 10.5px 等非规范字号
+- 分组标题由 10.5px 大写间距改为 13px/600 常规字重
+
+## 1.2.0 — 2026-10-20
+
+### 新增
+- **检查更新**：设置 → 模型用量 标题右侧显示当前版本 `vX.Y.Z`，点击「检查更新」查询 npm registry 最新版本；有新版本时显示橙点与更新提示
+- 弹窗展示 运行版本 / 最新版本 / 一键复制手工更新命令（`dsh plugin --profile web add <pkg>@<ver> --registry=...`）
+- RPC `update-check`（10 分钟缓存；registry 固定 npmjs，不返回凭据）
+
+### 说明
+- 自动更新需 DSH profile 包管理器介入，本插件只提供「检查 + 命令复制」，执行后重启 DSH Web 生效
+
 ## 1.1.0 — 2026-10-20
 
 ### 新增

package/README.md

@@ -9,6 +9,7 @@
 - 官方 Logo：DeepSeek / GLM(Z.ai) / Kimi / OpenRouter / MiniMax / OpenCode / OpenAI / Anthropic / Gemini / xAI / Qwen / Mistral / Groq / GitHub Copilot 等 25+
 - 设置 → 模型用量：KPI、趋势图、供应商/模型聚合、请求日志、CSV 导出
 - 设置 → 模型：页面底部显示各供应商额度
+- 版本检查：设置 → 模型用量 右上角「检查更新」（对比 npm 最新版，可复制更新命令）
 - 只用**真实数据**：额度来自服务商接口，用量来自本机会话日志（逐 token 一致），不做金额估算
 
 ![侧边栏额度卡片](https://raw.githubusercontent.com/PonyDevAI/dsh-model-usage/main/docs/screenshots/01-sidebar.png)

package/lib/client.js

@@ -44,6 +44,10 @@ window.__ModuleLoader__.load({
       shortAccount: '账号', remainCompact: '剩 {n}%', remainPrefix: '剩 ', remainSuffix: '', statsError: '统计加载失败', retry: '重试', emptyData: '暂无数据', emptyUsage: '今天还没有调用记录',
       kpiRequests: '模型调用', kpiTokens: '消耗 Tokens', kpiCacheHit: '缓存命中率',
       limitMcp: '每月 MCP 工具', limitMonthly: '每月限额', remainCalls: '剩余 {n}/{m} 次',
+      versionLabel: '版本', currentVersion: '运行版本', latestVersion: '最新版本', checkUpdate: '检查更新', checkingUpdate: '检查中…', upToDate: '已是最新版本',
+      updateAvailableHint: '发现新版本 {v}', updateFailed: '检查失败：{msg}',
+      manualUpdateTitle: '手工更新', manualUpdateNote: '插件由 DSH profile 管理：在终端执行以下命令，然后重启 DSH Web。',
+      copyCommand: '复制命令', copied: '已复制',
       groupCurrent: '当前会话在用', groupSub: '订阅窗口', groupApi: 'API 余额', groupWallet: '账号钱包', groupOther: '其他',
       trendTitle: '使用趋势',
       thProvider: '供应商', thModel: '模型', thRequests: '请求数', thTokens: 'Tokens',
@@ -80,6 +84,10 @@ window.__ModuleLoader__.load({
       shortAccount: 'Account', remainCompact: '{n}% left', remainPrefix: '', remainSuffix: ' left', statsError: 'Failed to load stats', retry: 'Retry', emptyData: 'No data', emptyUsage: 'No calls today yet',
       kpiRequests: 'Model calls', kpiTokens: 'Tokens', kpiCacheHit: 'Cache hit rate',
       limitMcp: 'MCP tools / month', limitMonthly: 'Monthly', remainCalls: '{n}/{m} calls left',
+      versionLabel: 'Version', currentVersion: 'Running', latestVersion: 'Latest', checkUpdate: 'Check for updates', checkingUpdate: 'Checking…', upToDate: 'Up to date',
+      updateAvailableHint: 'New version {v}', updateFailed: 'Check failed: {msg}',
+      manualUpdateTitle: 'Manual update', manualUpdateNote: 'Plugins are managed by the DSH profile: run this in a terminal, then restart DSH Web.',
+      copyCommand: 'Copy command', copied: 'Copied',
       groupCurrent: 'In use this session', groupSub: 'Subscription windows', groupApi: 'API balance', groupWallet: 'Account wallet', groupOther: 'Other',
       trendTitle: 'Usage trend',
       thProvider: 'Provider', thModel: 'Model', thRequests: 'Requests', thTokens: 'Tokens',
@@ -115,7 +123,7 @@ window.__ModuleLoader__.load({
 .dmu-footcard .metric b{font-weight:650}
 .dmu-mwin{margin-top:8px}
 .dmu-mwin:first-child{margin-top:9px}
-.dmu-mwin .t{display:flex;font-size:10.5px;color:var(--dsw-alias-label-secondary,#637182);margin-bottom:3px}
+.dmu-mwin .t{display:flex;font-size:11.5px;color:var(--dsw-alias-label-secondary,#637182);margin-bottom:3px}
 .dmu-mwin .t b{margin-left:auto;color:var(--dsw-alias-label-primary,#191f28);font-variant-numeric:tabular-nums}
 .dmu-mwin .track{height:6px;border-radius:4px;background:var(--dsw-alias-bg-base,#e4e8ee);overflow:hidden}
 .dmu-mwin .fill{height:100%;border-radius:4px;transition:width .4s ease}
@@ -142,58 +150,64 @@ window.__ModuleLoader__.load({
 .dmu-mbody .dmu-pcard:first-child{margin-top:0}
 .dmu-mbody .dmu-kicker{margin:12px 0 0}
 .dmu-sumhead{display:flex;align-items:center;gap:8px}
-.dmu-sumhead .k{font-size:10.5px;font-weight:700;letter-spacing:1px;color:var(--dsw-alias-label-tertiary,#98a2b3)}
+.dmu-sumhead .k{font-size:12px;font-weight:600;letter-spacing:0;color:var(--dsw-alias-label-tertiary,#98a2b3)}
 .dmu-summrow{display:flex;align-items:flex-end;gap:26px;margin-top:11px}
-.dmu-sumstat .k{font-size:10.5px;color:var(--dsw-alias-label-secondary,#637182)}
+.dmu-sumstat .k{font-size:12px;color:var(--dsw-alias-label-secondary,#637182)}
 .dmu-sumstat .v{margin-top:3px;font-size:16px;font-weight:700;color:var(--dsw-alias-label-primary,#191f28);font-variant-numeric:tabular-nums;line-height:1}
 .dmu-spark{display:flex;align-items:flex-end;gap:3px;height:22px;width:120px;margin-left:auto}
 .dmu-spark i{flex:1;background:var(--dsw-alias-state-business-primary,#4176E6);border-radius:2px 2px 0 0;min-height:2px;display:block;opacity:.85}
-.dmu-sumtext{margin-top:9px;font-size:10.5px;color:var(--dsw-alias-label-tertiary,#98a2b3)}
-.dmu-kicker{font-size:10.5px;font-weight:700;letter-spacing:1px;color:var(--dsw-alias-label-tertiary,#98a2b3);margin:6px 0 6px}
-.dmu-pcard{background:var(--dsw-alias-settings-card-fill,var(--dsw-alias-bg-layer-1,#fff));border:1px solid var(--dsw-alias-settings-card-stroke,var(--dsw-alias-border-l1,#e3e7ed));border-radius:var(--dsw-radius-lg,14px);padding:13px 15px}
+.dmu-sumtext{margin-top:10px;font-size:12px;color:var(--dsw-alias-label-tertiary,#98a2b3)}
+.dmu-kicker{font-size:13px;font-weight:600;letter-spacing:0;color:var(--dsw-alias-label-secondary,#637182);margin:20px 0 8px}
+.dmu-pcard{background:var(--dsw-alias-settings-card-fill,var(--dsw-alias-bg-layer-1,#fff));border:1px solid var(--dsw-alias-settings-card-stroke,var(--dsw-alias-border-l1,#e3e7ed));border-radius:12px;padding:14px 16px}
 .dmu-pcard.crit{border-top:2px solid var(--dsw-alias-state-error-primary,#f04438)}
 .dmu-pcard .ph{display:flex;align-items:center;gap:8px;font-size:var(--dsh-content-font-size-secondary,13px);font-weight:600;color:var(--dsw-alias-label-primary,#191f28);white-space:nowrap}
 .dmu-pcard .ph .dmu-pill{white-space:nowrap}
-.dmu-pcard .route{font-size:10.5px;color:var(--dsw-alias-label-tertiary,#98a2b3);font-weight:400;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;max-width:26%}
+.dmu-pcard .route{font-size:12px;color:var(--dsw-alias-label-tertiary,#98a2b3);font-weight:400;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;max-width:26%}
 .dmu-big{margin-top:11px;font-size:28px;font-weight:700;letter-spacing:-.5px;line-height:1;color:var(--dsw-alias-label-primary,#191f28);font-variant-numeric:tabular-nums}
 .dmu-big small{font-size:13px;font-weight:600;color:var(--dsw-alias-label-secondary,#637182);margin-left:3px;letter-spacing:0}
-.dmu-cap{margin-top:6px;font-size:11px;color:var(--dsw-alias-label-secondary,#637182)}
+.dmu-cap{margin-top:6px;font-size:12px;color:var(--dsw-alias-label-secondary,#637182)}
 .dmu-seg{display:flex;height:10px;border-radius:var(--dsw-radius-sm,6px);overflow:hidden;margin-top:12px;background:var(--dsw-alias-bg-base,#e4e8ee)}
 .dmu-seg span{height:100%}
 .dmu-legend{display:flex;gap:14px;margin-top:8px;font-size:10.5px;color:var(--dsw-alias-label-secondary,#637182)}
 .dmu-legend i{width:8px;height:8px;border-radius:3px;display:inline-block;margin-right:5px;vertical-align:-1px}
 .dmu-pcard .winrow{margin-top:12px;display:flex;flex-direction:column;gap:12px}
-.dmu-pcard .win .t{display:flex;align-items:baseline;font-size:11.5px;color:var(--dsw-alias-label-secondary,#637182);margin-bottom:5px}
+.dmu-pcard .win .t{display:flex;align-items:baseline;font-size:12.5px;color:var(--dsw-alias-label-secondary,#637182);margin-bottom:5px}
 .dmu-pcard .win .t .lb{font-weight:600;color:var(--dsw-alias-label-primary,#191f28);margin-right:8px}
 .dmu-pcard .win .t b{margin-left:auto;font-size:12.5px;color:var(--dsw-alias-label-primary,#191f28);font-variant-numeric:tabular-nums}
 .dmu-pcard .win .track{height:10px;border-radius:var(--dsw-radius-sm,6px);background:var(--dsw-alias-bg-base,#e4e8ee);overflow:hidden}
 .dmu-pcard .win .fill{height:100%;border-radius:var(--dsw-radius-sm,6px);transition:width .4s ease}
-.dmu-pcard .win .f{display:flex;margin-top:5px;font-size:10.5px;color:var(--dsw-alias-label-tertiary,#98a2b3)}
+.dmu-pcard .win .f{display:flex;margin-top:6px;font-size:12px;color:var(--dsw-alias-label-tertiary,#98a2b3)}
 .dmu-pcard .win .f .wh{margin-left:auto;font-weight:600}
-.dmu-errline{display:flex;gap:8px;align-items:flex-start;font-size:11px;color:var(--dsw-alias-state-error-primary,#f04438);background:color-mix(in srgb,var(--dsw-alias-state-error-primary,#f04438) 8%,transparent);border:1px solid color-mix(in srgb,var(--dsw-alias-state-error-primary,#f04438) 25%,transparent);padding:7px 10px;border-radius:var(--dsw-radius-md,10px);margin-top:10px;word-break:break-all}
-.dmu-warnline{color:var(--dsw-alias-state-warn-primary,#f79009);font-size:11px;margin-top:10px}
-.dmu-mutedline{color:var(--dsw-alias-label-tertiary,#98a2b3);font-size:11px;margin-top:10px}
-.dmu-settings{padding:4px 2px}
+.dmu-errline{display:flex;gap:8px;align-items:flex-start;font-size:12px;color:var(--dsw-alias-state-error-primary,#f04438);background:color-mix(in srgb,var(--dsw-alias-state-error-primary,#f04438) 8%,transparent);border:1px solid color-mix(in srgb,var(--dsw-alias-state-error-primary,#f04438) 25%,transparent);padding:7px 10px;border-radius:var(--dsw-radius-md,10px);margin-top:10px;word-break:break-all}
+.dmu-warnline{color:var(--dsw-alias-state-warn-primary,#f79009);font-size:12px;margin-top:10px}
+.dmu-mutedline{color:var(--dsw-alias-label-secondary,#637182);font-size:12px;margin-top:10px}
+.dmu-settings{padding:0}
+.dmu-setrow{display:flex;align-items:center;gap:12px;min-height:44px;padding:10px 0;border-bottom:1px solid var(--dsw-alias-border-l1,#e3e7ed)}
+.dmu-setrow .label{font-size:16px;line-height:22px;color:var(--dsw-alias-label-primary,#191f28);white-space:nowrap}
+.dmu-setrow .sub{font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary,#637182);margin-top:2px}
+.dmu-setrow .after{margin-left:auto;display:flex;align-items:center;gap:10px}
+.dmu-setrow .ver{font-size:14px;line-height:22px;color:var(--dsw-alias-label-secondary,#637182);font-variant-numeric:tabular-nums}
+.dmu-main-tabs{margin:18px 0 0}
 .dmu-settings h2{font-size:16px;font-weight:650;margin:0 0 2px;color:var(--dsw-alias-label-primary,#191f28)}
-.dmu-settings .desc{font-size:11.5px;color:var(--dsw-alias-label-tertiary,#98a2b3);margin-bottom:14px}
+.dmu-settings .desc{font-size:12px;color:var(--dsw-alias-label-secondary,#637182);margin-bottom:16px}
 .dmu-settings .list{display:flex;flex-direction:column;gap:12px}
 .dmu-empty{padding:18px 12px;text-align:center;font-size:11.5px;color:var(--dsw-alias-label-tertiary,#98a2b3)}
 .dmu-settings,.dmu-mbody{--dmu-violet:#7c5cf0}
 @media (prefers-reduced-motion:reduce){.dmu-pcard .win .fill,.dmu-mwin .fill{transition:none}}
 .dmu-kpis{display:flex;gap:10px;flex-wrap:wrap}
-.dmu-kpi{flex:1;min-width:120px;background:var(--dsw-alias-settings-card-fill,var(--dsw-alias-bg-layer-1,#fff));border:1px solid var(--dsw-alias-settings-card-stroke,var(--dsw-alias-border-l1,#e3e7ed));border-radius:var(--dsw-radius-lg,14px);padding:12px 14px}
-.dmu-kpi .k{font-size:10.5px;color:var(--dsw-alias-label-tertiary,#98a2b3)}
-.dmu-kpi .v{margin-top:5px;font-size:22px;font-weight:700;letter-spacing:-.3px;color:var(--dsw-alias-label-primary,#191f28);font-variant-numeric:tabular-nums}
+.dmu-kpi{flex:1;min-width:120px;background:var(--dsw-alias-settings-card-fill,var(--dsw-alias-bg-layer-1,#fff));border:1px solid var(--dsw-alias-settings-card-stroke,var(--dsw-alias-border-l1,#e3e7ed));border-radius:12px;padding:14px 16px}
+.dmu-kpi .k{font-size:12px;color:var(--dsw-alias-label-secondary,#637182)}
+.dmu-kpi .v{margin-top:6px;font-size:20px;font-weight:600;letter-spacing:-.2px;color:var(--dsw-alias-label-primary,#191f28);font-variant-numeric:tabular-nums}
 .dmu-kpi .v small{font-size:11px;font-weight:600;color:var(--dsw-alias-label-secondary,#637182);margin-left:2px}
-.dmu-chart{background:var(--dsw-alias-settings-card-fill,var(--dsw-alias-bg-layer-1,#fff));border:1px solid var(--dsw-alias-settings-card-stroke,var(--dsw-alias-border-l1,#e3e7ed));border-radius:var(--dsw-radius-lg,14px);padding:14px 16px 10px;margin-top:12px}
+.dmu-chart{background:var(--dsw-alias-settings-card-fill,var(--dsw-alias-bg-layer-1,#fff));border:1px solid var(--dsw-alias-settings-card-stroke,var(--dsw-alias-border-l1,#e3e7ed));border-radius:12px;padding:16px 18px 12px;margin-top:16px}
 .dmu-chart .bars{display:flex;align-items:flex-end;gap:3px;height:120px}
 .dmu-chart .bar{flex:1;border-radius:3px 3px 1px 1px;background:var(--dsw-alias-state-business-primary,#4176E6);min-height:2px;position:relative}
 .dmu-chart .bar:hover{opacity:.75}
 .dmu-chart .labels{display:flex;gap:3px;margin-top:5px}
-.dmu-chart .labels span{flex:1;text-align:center;font-size:9px;color:var(--dsw-alias-label-tertiary,#98a2b3);overflow:visible;white-space:nowrap}
-.dmu-table{width:100%;border-collapse:collapse;font-size:12px;margin-top:12px;background:var(--dsw-alias-settings-card-fill,var(--dsw-alias-bg-layer-1,#fff));border:1px solid var(--dsw-alias-settings-card-stroke,var(--dsw-alias-border-l1,#e3e7ed));border-radius:var(--dsw-radius-lg,14px);overflow:hidden}
-.dmu-table th{ text-align:left;font-size:10.5px;font-weight:600;color:var(--dsw-alias-label-tertiary,#98a2b3);padding:9px 12px;border-bottom:1px solid var(--dsw-alias-border-l1,#e3e7ed)}
-.dmu-table td{padding:9px 12px;border-bottom:1px solid var(--dsw-alias-border-l1,#e3e7ed);color:var(--dsw-alias-label-primary,#191f28);font-variant-numeric:tabular-nums}
+.dmu-chart .labels span{flex:1;text-align:center;font-size:10px;color:var(--dsw-alias-label-tertiary,#98a2b3);overflow:visible;white-space:nowrap}
+.dmu-table{width:100%;border-collapse:collapse;font-size:13px;margin-top:16px}
+.dmu-table th{text-align:left;font-size:12px;font-weight:500;color:var(--dsw-alias-label-secondary,#637182);padding:0 12px 8px;border-bottom:1px solid var(--dsw-alias-border-l1,#e3e7ed)}
+.dmu-table td{height:44px;padding:0 12px;border-bottom:1px solid var(--dsw-alias-border-l1,#e3e7ed);color:var(--dsw-alias-label-primary,#191f28);font-variant-numeric:tabular-nums}
 .dmu-table tr:last-child td{border-bottom:none}
 .dmu-table .num{text-align:right;font-variant-numeric:tabular-nums}
 .dmu-table th.num{text-align:right}
@@ -335,6 +349,7 @@ window.__ModuleLoader__.load({
         sessionProvider: (sessionId) => unwrap('session-provider', { sessionId }),
         stats: (opts) => unwrap('stats', opts || {}),
         config: () => unwrap('config', {}),
+        updateCheck: (force) => unwrap('update-check', { force: !!force }),
       }
     }
 
@@ -1111,6 +1126,79 @@ window.__ModuleLoader__.load({
               summaryOf({ providers: [p] }, tr))))))
     }
 
+    // ---------------------------------------------------------------- 版本 / 检查更新
+    function VersionBadge({ api, tr }) {
+      const [info, setInfo] = useState(null)
+      const [busy, setBusy] = useState(false)
+      const [open, setOpen] = useState(false)
+      const [copied, setCopied] = useState(false)
+      useEffect(() => {
+        let alive = true
+        api.updateCheck(false).then((v) => { if (alive) setInfo(v) }).catch(() => {})
+        return () => { alive = false }
+      }, [])
+      const check = async () => {
+        setBusy(true)
+        try {
+          setInfo(await api.updateCheck(true))
+        } catch (e) {
+          setInfo({ current: '—', latest: null, error: String((e && e.message) || e), updateAvailable: false })
+        } finally {
+          setBusy(false)
+          setOpen(true)
+        }
+      }
+      const copy = () => {
+        try {
+          navigator.clipboard.writeText((info && info.command) || '').then(() => {
+            setCopied(true)
+            setTimeout(() => setCopied(false), 1500)
+          })
+        } catch {}
+      }
+      const stat = (label, value) => h('div', { className: 'dmu-mstat' },
+        h('div', { className: 'k' }, label),
+        h('div', { className: 'v' }, value))
+      const cmdStyle = {
+        flex: 1, fontSize: 12, fontFamily: 'var(--dsh-font-mono,monospace)',
+        background: 'var(--dsw-alias-bg-base,#f2f4f7)', padding: '10px 12px',
+        borderRadius: 10, wordBreak: 'break-all', whiteSpace: 'pre-wrap', margin: 0,
+      }
+      return [
+        info && info.updateAvailable
+          ? h('span', { key: 'dot', style: { width: 6, height: 6, borderRadius: 999, background: 'var(--dsw-alias-state-warn-primary,#f79009)' } })
+          : null,
+        h('span', { key: 'ver', className: 'ver' }, 'v' + ((info && info.current) || '—')),
+        h(P.Button, { key: 'btn', variant: 'outline', size: 'sm', onClick: check, disabled: busy },
+          busy ? tr('checkingUpdate') : tr('checkUpdate')),
+        open && info && h(P.Modal, {
+          key: 'modal',
+          open: true,
+          onClose: () => setOpen(false),
+          title: tr('checkUpdate'),
+          closeLabel: tr('close'),
+          footer: h('div', { className: 'dmu-row', style: { justifyContent: 'flex-end' } },
+            h(P.Button, { variant: 'primary', size: 'sm', onClick: () => setOpen(false) }, tr('close'))),
+        },
+          h('div', { style: { display: 'flex', flexDirection: 'column', gap: 14 } },
+            h('div', { className: 'dmu-row', style: { gap: 28 } },
+              stat(tr('currentVersion'), info.current ? 'v' + info.current : '—'),
+              stat(tr('latestVersion'), info.latest ? 'v' + info.latest : '—')),
+            info.error
+              ? h('div', { className: 'dmu-warnline', style: { margin: 0 } }, tr('updateFailed', { msg: info.error }))
+              : info.updateAvailable
+                ? h('div', { className: 'dmu-warnline', style: { margin: 0 } }, tr('updateAvailableHint', { v: 'v' + info.latest }))
+                : h('div', { className: 'dmu-mutedline', style: { margin: 0 } }, tr('upToDate')),
+            h('div', null,
+              h('div', { style: { fontSize: 13, fontWeight: 600, color: 'var(--dsw-alias-label-primary,#191f28)', marginBottom: 4 } }, tr('manualUpdateTitle')),
+              h('div', { style: { fontSize: 12, color: 'var(--dsw-alias-label-secondary,#637182)', marginBottom: 8 } }, tr('manualUpdateNote')),
+              h('div', { style: { display: 'flex', gap: 10, alignItems: 'flex-start' } },
+                h('code', { style: cmdStyle }, info.command || ''),
+                h(P.Button, { variant: 'outline', size: 'sm', onClick: copy },
+                  copied ? tr('copied') : tr('copyCommand')))))),
+      ]
+    }
+
     // ---------------------------------------------------------------- 入口 2：设置页
     function SettingsEntry(props) {
       const { api } = props
@@ -1122,7 +1210,9 @@ window.__ModuleLoader__.load({
         { value: 'log', label: tr('tabLog'), id: 'dmu-tab-log', panelId: 'dmu-panel-log' },
       ]
       return h('div', { className: 'dmu-settings' },
-        h('h2', null, tr('nav')),
+        h('div', { className: 'dmu-setrow' },
+          h('div', null, h('div', { className: 'label' }, tr('versionLabel'))),
+          h('div', { className: 'after' }, h(VersionBadge, { api, tr }))),
         h(P.SegmentedTabs, {
           items: tabs,
           value: tab,

package/lib/index.js

@@ -5,14 +5,67 @@
 //   （不走 connection.rpc.handle：其内部对 connection fiber 的 webServer 访问
 //    在 web 组合下会抛 without inject —— 参见 dsh-api-gateway 的同类做法）
 // - 凭据只在 Host 进程内存中出现；TTL 缓存 + 单飞 + 指数退避
-import { adapterFor, safeMsg } from './adapters.js'
+import { adapterFor, fetchT, safeMsg } from './adapters.js'
 import { createLedger } from './ledger.js'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { readFile } from 'node:fs/promises'
+import { readFileSync } from 'node:fs'
 import { homedir } from 'node:os'
 
-const ASSETS_DIR = join(dirname(fileURLToPath(import.meta.url)), '..', 'assets', 'logos')
+const PKG_DIR = join(dirname(fileURLToPath(import.meta.url)), '..')
+const ASSETS_DIR = join(PKG_DIR, 'assets', 'logos')
+const REGISTRY = 'https://registry.npmjs.org/'
+const PKG_NAME = '@ponydev/dsh-model-usage'
+
+/** 自身版本（读 package.json；失败返回 '0.0.0'） */
+let SELF_VERSION = '0.0.0'
+try {
+  SELF_VERSION = JSON.parse(readFileSync(join(PKG_DIR, 'package.json'), 'utf8')).version || '0.0.0'
+} catch {}
+
+/** 检查 npm 最新版本（10 分钟缓存；force 跳过缓存） */
+let updateCache = { at: 0, data: null }
+async function checkUpdate(force) {
+  const now = Date.now()
+  if (!force && updateCache.data && now - updateCache.at < 10 * 60 * 1000) return updateCache.data
+  const url = REGISTRY + PKG_NAME.replace('/', '%2F') + '/latest'
+  let latest = null
+  let error = null
+  try {
+    const res = await fetchT(url, { headers: { accept: 'application/json' } }, 8000)
+    if (res.ok) {
+      const body = await res.json()
+      latest = typeof body.version === 'string' ? body.version : null
+      if (!latest) error = 'registry 未返回 version'
+    } else {
+      error = 'HTTP ' + res.status
+    }
+  } catch (e) {
+    error = safeMsg(e)
+  }
+  const data = {
+    current: SELF_VERSION,
+    latest,
+    updateAvailable: !!(latest && latest !== SELF_VERSION && cmpVersion(latest, SELF_VERSION) > 0),
+    registry: REGISTRY,
+    name: PKG_NAME,
+    command: 'dsh plugin --profile web add ' + PKG_NAME + (latest ? '@' + latest : '') + ' --registry=' + REGISTRY,
+    error,
+    checkedAt: now,
+  }
+  if (latest) updateCache = { at: now, data }
+  return data
+}
+function cmpVersion(a, b) {
+  const pa = String(a).split(/[.-]/).map((x) => parseInt(x, 10) || 0)
+  const pb = String(b).split(/[.-]/).map((x) => parseInt(x, 10) || 0)
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const x = pa[i] || 0, y = pb[i] || 0
+    if (x !== y) return x > y ? 1 : -1
+  }
+  return 0
+}
 
 /** 用户自定义 logo 目录（$DSH_HOME/model-usage/logos） */
 function userLogosDir() {
@@ -176,6 +229,8 @@ export function apply(ctx, rawConfig) {
         return ok(publicConfig())
       case 'stats':
         return ok(ledger.stats({ days: payload && payload.days }))
+      case 'update-check':
+        return ok(await checkUpdate(!!(payload && payload.force)))
       default:
         return fail('model-usage/unknown-endpoint', 'unknown endpoint: ' + String(endpoint))
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ponydev/dsh-model-usage",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "DSH Web 插件：实时显示模型供应商额度与用量（DeepSeek / GLM Coding Plan / OpenRouter / Kimi Coding Plan + 自定义适配器）",
   "keywords": [
     "dsh",