@ponydev/dsh-model-usage 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 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',
@@ -335,6 +343,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 +1120,77 @@ 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: 11, fontFamily: 'var(--dsh-font-mono,monospace)',
+        background: 'var(--dsw-alias-bg-base,#f2f4f7)', padding: '8px 10px',
+        borderRadius: 8, wordBreak: 'break-all', whiteSpace: 'pre-wrap', margin: 0,
+      }
+      const dotColor = info && info.updateAvailable ? 'var(--dsw-alias-state-warn-primary,#f79009)' : 'var(--dsw-alias-label-tertiary,#98a2b3)'
+      return h('span', { className: 'dmu-row', style: { gap: 8 } },
+        info && info.updateAvailable ? h('span', { style: { width: 6, height: 6, borderRadius: 999, background: dotColor } }) : null,
+        h('span', { style: { fontSize: 11, color: 'var(--dsw-alias-label-tertiary,#98a2b3)' } },
+          'v' + ((info && info.current) || '—')),
+        h(P.Button, { variant: 'ghost', size: 'sm', onClick: check, disabled: busy },
+          busy ? tr('checkingUpdate') : tr('checkUpdate')),
+        open && info && h(P.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: 10 } },
+            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: 11, color: 'var(--dsw-alias-label-tertiary,#98a2b3)', marginBottom: 4 } }, tr('manualUpdateTitle')),
+              h('div', { style: { fontSize: 11, color: 'var(--dsw-alias-label-secondary,#637182)', marginBottom: 6 } }, tr('manualUpdateNote')),
+              h('div', { style: { display: 'flex', gap: 8, 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 +1202,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-row', style: { gap: 10, marginBottom: 10 } },
+          h('h2', { style: { margin: 0 } }, tr('nav')),
+          h('span', { style: { marginLeft: 'auto' } }, 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.0",
   "description": "DSH Web 插件：实时显示模型供应商额度与用量（DeepSeek / GLM Coding Plan / OpenRouter / Kimi Coding Plan + 自定义适配器）",
   "keywords": [
     "dsh",