dsh-modelscope-pool 0.10.0 → 0.10.2

package/README.md

@@ -1,5 +1,6 @@
 # dsh-modelscope-pool
 
+[![npm](https://img.shields.io/npm/v/dsh-modelscope-pool.svg)](https://www.npmjs.com/package/dsh-modelscope-pool)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![dsh](https://img.shields.io/badge/dsh-%3E%3D0.2.1--rc.2-4D6BFE.svg)](https://github.com/deepseek-ai/deepseek-harness)
 [![Node](https://img.shields.io/badge/node-%3E%3D20-5FA04E.svg)](https://nodejs.org/)
@@ -117,29 +118,53 @@
 - Node.js ≥ 20
 - 一个魔搭账号和它的 API Key（`ms-` 开头），在 <https://modelscope.cn/my/myaccesstoken> 或 <https://modelscope.ai> 生成
 
-### 作为 dsh-go 原生插件安装
+### 方式一：从 npm 安装（推荐）
 
 ```bash
-# 1. 把仓库放进 dsh-go 的本地插件目录
-#    目录名必须叫 dsh-modelscope-pool（与 package.json 的 name 一致）
+dsh plugin --profile web add dsh-modelscope-pool@0.10.0
+```
+
+一条命令搞定。装好后重启 App（或让插件重新加载），网关会在 `127.0.0.1:8899` 起来。
+
+升级就是换版本号重装：
+
+```bash
+dsh plugin --profile web add dsh-modelscope-pool@<新版本>
+```
+
+> 建议写死精确版本。npm 上其他包常见的 `latest`、`^` 范围在这里没有好处——插件会监听端口、读写本机文件，版本变化值得你自己看一眼。
+
+只想要包本身、不需要 dsh 帮你装：
+
+```bash
+npm i dsh-modelscope-pool
+```
+
+> 每个版本的改动见 [Releases](https://github.com/Yizutt/dsh-modelscope-pool/releases)。
+
+### 方式二：从源码安装（要改代码时用）
+
+```bash
+# 目录名要和 package.json 的 name 一致
 mkdir -p "$DSH_HOME/dsh-go/plugins"
 cd "$DSH_HOME/dsh-go/plugins"
 git clone https://github.com/Yizutt/dsh-modelscope-pool.git dsh-modelscope-pool
 
-# 2. 装进当前 profile
 dsh plugin --profile web add "$DSH_HOME/dsh-go/plugins/dsh-modelscope-pool"
 ```
 
-装好后重启 App，或让插件重新加载。网关会在 `127.0.0.1:8899` 起来。
+装的是指向这个目录的链接，所以**目录不能删**。改完 `lib/` 里的代码需要在 App 的「引擎」页重启引擎才生效。
 
-### 只想用网关、不装 App
+### 方式三：只挂到 Harness（网页版 / 桌面版）
 
-插件本身就是一个 Cordis bundle（`package.json` 里的 `dsh.bundle.patch` 指向 `cordis.patch.yml`），所以也可以直接挂到 Harness 的 profile 里：
+插件本身就是一个 Cordis bundle（`package.json` 里的 `dsh.bundle.patch` 指向 `cordis.patch.yml`），所以不装 dsh-go 也能用：
 
 ```bash
 dsh plugin --profile web add /path/to/dsh-modelscope-pool
 ```
 
+网页版的管理页在 `http://127.0.0.1:3080/modelscope-pool`，见[网页版与桌面版](#网页版与桌面版)。
+
 ---
 
 ## 配置
@@ -308,6 +333,9 @@ dsh-go 里更进一步：这个插件会把自己注册成一个叫 **魔搭 Key
 **Key 一直不自动恢复？**
 看看是不是被「手动禁用」了（`manual` 标记）。手动禁用不会被自动恢复流程放开，需要点「恢复」。
 
+**点「刷新额度」提示「魔搭 Key 池没有响应」？**
+App 要求点按在 3 秒内返回，而刷新额度要联网逐个查所有 Key 的额度，早就超过 3 秒了。0.10.2 起这几个慢操作（刷新额度 / 测试全部 / 重新拉取模型 / 添加 Key）不再在点按里等：点一下立刻在**面板顶部**显示「正在刷新额度」，**3 秒后自动收起**（操作不会中断），跑完再把结果挂上去 3 秒。如果你还在 0.10.0 或更早，升级即可。
+
 **端口被占用？**
 改 `config.json` 的 `port`，同时把客户端和供应商配置里的地址一起改掉。
 

package/lib/i18n.js

@@ -129,6 +129,12 @@ const S = {
   trailingCurrent: ['当前', 'Current'],
   trailingUse: ['使用', 'Use'],
 
+  // 慢操作：点按后先回 pending，App 会显示等待
+  pendingRefresh: ['正在刷新额度', 'Refreshing quota'],
+  pendingTest: ['正在测试全部', 'Testing all'],
+  pendingModels: ['正在拉取模型', 'Loading models'],
+  pendingAdd: ['正在校验 Key', 'Checking keys'],
+
   // 操作反馈
   toastQuotaUpdated: ['额度已更新', 'Quota refreshed'],
   toastModelSet: ['默认模型：{model}', 'Default model: {model}'],

package/lib/index.js

@@ -300,14 +300,16 @@ const modelRowOf = (entry, current, t) => {
     const routing = router.snapshot()
     const routed =
       routing.blockedPairs > 0 ? ` ${t('routed', { n: routing.blockedPairs })}` : ''
+    const busy = noticeNow()
     const hint =
-      s.total === 0
+      busy ||
+      (s.total === 0
         ? t('hintNoKeys')
         : s.cooling > 0
           ? `${t('hintCooling')}${routed}`
           : model
             ? `${t('hintModel', { model })}${routed}`
-            : `${t('hintIdle')}${routed}`
+            : `${t('hintIdle')}${routed}`)
 
     // 扇形图：Key 池的状态分布（可用 / 额度不足 / 令牌无效 / 其他冷却）
     const order = [
@@ -515,6 +517,7 @@ const modelRowOf = (entry, current, t) => {
       title: t('poolTitle'),
       accent: 'teal',
       children: [
+        { type: 'callout', tone: 'info', text: { $: 'data.hint' } },
         {
           type: 'row',
           children: [
@@ -531,7 +534,6 @@ const modelRowOf = (entry, current, t) => {
           caption: { $: 'data.magic.brief' },
           tone: 'good',
         },
-        { type: 'callout', tone: 'info', text: { $: 'data.hint' } },
         { type: 'text', text: { $: 'data.keyTitle' }, style: { size: 'title', weight: 'bold' } },
         { type: 'list', items: { $: 'data.keys' } },
         {
@@ -728,11 +730,45 @@ const modelRowOf = (entry, current, t) => {
         }
     }
 
+    // 点按必须 3 秒内返回，否则 App 会提示「没有响应」。
+    // 联网的慢操作因此不在点按里等：先把一句话挂到面板顶部（data.hint），
+    // 3 秒后自动收起，真正的活儿在后台继续跑，跑完再挂一句结果，同样 3 秒收起。
+    let notice = ''
+    let noticeUntil = 0
+    const setNotice = (text, ms = 3000) => {
+      notice = String(text ?? '')
+      noticeUntil = notice ? Date.now() + ms : 0
+      refreshPanel()
+      refreshStrip()
+    }
+    const noticeNow = () => (noticeUntil > Date.now() ? notice : '')
+    const running = new Set()
+    const runInBackground = (key, label, work) => {
+      if (running.has(key)) return { toast: label }
+      running.add(key)
+      setNotice(label)
+      void (async () => {
+        let message = ''
+        try {
+          message = String((await work()) ?? '')
+        } catch (error) {
+          message = String(error?.message ?? error ?? '')
+        } finally {
+          running.delete(key)
+        }
+        setNotice(message)
+      })()
+      return { refresh: true }
+    }
+
     const panelActions = {
-        async refresh(scope, event) {
+        refresh(scope, event) {
           const t = makeT(event?.locale)
-          await Promise.all([refreshQuota(true), refreshCatalog(true)])
-          return { toast: t('toastQuotaUpdated'), refresh: true }
+          return runInBackground('refresh', t('pendingRefresh'), async () => {
+            await refreshQuota(true)
+            await refreshCatalog(true)
+            return t('toastQuotaUpdated')
+          })
         },
         async 'pick-model'(scope, event) {
           const t = makeT(event?.locale)
@@ -742,38 +778,38 @@ const modelRowOf = (entry, current, t) => {
             ? { toast: t('toastModelSet', { model }), refresh: true }
             : { toast: t('toastModelBad') }
         },
-        async 'test-all'(scope, event) {
+        'test-all'(scope, event) {
           const t = makeT(event?.locale)
-          const keys = pool ? [...pool.keys] : []
-          if (keys.length === 0) return { toast: t('toastNoKeys') }
-          // 注意不能用 /v1/models 验 Key：那个接口是公开的，什么令牌都返回 200。
-          // 真正会校验令牌的是额度接口，而且查额度不扣魔粒。
-          const rows = await quota.refresh(
-            keys.map((k) => ({ id: k.id, key: k.key, region: k.region })),
-            { force: true },
-          )
-          for (const [i, row] of rows.entries()) {
-            const k = keys[i]
-            if (row.state?.region) await pool.setRegion(k.id, row.state.region)
-            if (!row.state?.ok) {
-              pool.markFailure(k.id, '令牌无效', String(row.state?.error ?? '').slice(0, 80))
-              continue
-            }
-            if (row.state.available < QUOTA_FLOOR) {
-              pool.markFailure(k.id, '额度不足', `剩余 ${row.state.available} 魔粒`, nextQuotaResetAt())
-              continue
+          return runInBackground('test', t('pendingTest'), async () => {
+            const keys = pool ? [...pool.keys] : []
+            if (keys.length === 0) return t('toastNoKeys')
+            // 注意不能用 /v1/models 验 Key：那个接口是公开的，什么令牌都返回 200。
+            // 真正会校验令牌的是额度接口，而且查额度不扣魔粒。
+            const rows = await quota.refresh(
+              keys.map((k) => ({ id: k.id, key: k.key, region: k.region })),
+              { force: true },
+            )
+            for (const [i, row] of rows.entries()) {
+              const k = keys[i]
+              if (row.state?.region) await pool.setRegion(k.id, row.state.region)
+              if (!row.state?.ok) {
+                pool.markFailure(k.id, '令牌无效', String(row.state?.error ?? '').slice(0, 80))
+                continue
+              }
+              if (row.state.available < QUOTA_FLOOR) {
+                pool.markFailure(k.id, '额度不足', `剩余 ${row.state.available} 魔粒`, nextQuotaResetAt())
+                continue
+              }
+              pool.restore(k.id)
             }
-            pool.restore(k.id)
-          }
-          refreshPanel()
-          refreshStrip()
-          const ok = rows.filter((r) => r.state?.ok && r.state.available >= QUOTA_FLOOR).length
-          const invalid = rows.filter((r) => !r.state?.ok).length
-          const short = rows.length - ok - invalid
-          const parts = [t('partOk', { ok, total: keys.length })]
-          if (short > 0) parts.push(t('partShort', { n: short }))
-          if (invalid > 0) parts.push(t('partInvalid', { n: invalid }))
-          return { toast: t('toastTestDone', { parts: parts.join(' · ') }) }
+            const ok = rows.filter((r) => r.state?.ok && r.state.available >= QUOTA_FLOOR).length
+            const invalid = rows.filter((r) => !r.state?.ok).length
+            const short = rows.length - ok - invalid
+            const parts = [t('partOk', { ok, total: keys.length })]
+            if (short > 0) parts.push(t('partShort', { n: short }))
+            if (invalid > 0) parts.push(t('partInvalid', { n: invalid }))
+            return t('toastTestDone', { parts: parts.join(' · ') })
+          })
         },
         'restore-all': async (scope, event) => {
           const t = makeT(event?.locale)
@@ -853,23 +889,26 @@ const modelRowOf = (entry, current, t) => {
           })
           return { toast: t('toastDeleted', { id }), refresh: true }
         },
-        'add-form': async (scope, event) => {
+        'add-form'(scope, event) {
+          const t = makeT(event?.locale)
           const value = event?.value
           const raw = typeof value === 'string' ? value : value?.newKey ?? value?.value ?? ''
-          const result = await addKey(raw, event?.locale)
-          return { ...result, refresh: true }
+          return runInBackground('add', t('pendingAdd'), async () => {
+            const result = await addKey(raw, event?.locale)
+            return result?.toast ?? t('toastNoNew')
+          })
         },
         'key-back'() {
           return { open: 'panel:pool' }
         },
-        async 'refresh-models'(scope, event) {
+        'refresh-models'(scope, event) {
           const t = makeT(event?.locale)
-          await refreshCatalog(true)
-          refreshPanel()
-          return { toast: t('toastModelsReloaded'), refresh: true }
+          return runInBackground('models', t('pendingModels'), async () => {
+            await refreshCatalog(true)
+            return t('toastModelsReloaded')
+          })
         },
     }
-
     dshGo.panel('pool', { view: viewPool, data: panelData(buildPoolData), actions: panelActions })
     dshGo.panel('key', { view: viewKey, data: panelData(buildKeyData), actions: panelActions })
     dshGo.panel('models', { view: viewModels, data: panelData(buildModelsData), actions: panelActions })
@@ -911,11 +950,14 @@ const modelRowOf = (entry, current, t) => {
       },
     })
 
-    dshGo.on('addkey', async (scope, event) => {
+    dshGo.on('addkey', (scope, event) => {
+      const t = makeT(event?.locale)
       const text = String(scope.clipboard ?? '').trim()
-      if (!text) return { toast: makeT(event?.locale)('toastNoClipboard') }
-      const result = await addKey(text, event?.locale)
-      return { ...result, refresh: 'pool' }
+      if (!text) return { toast: t('toastNoClipboard') }
+      return runInBackground('add', t('pendingAdd'), async () => {
+        const result = await addKey(text, event?.locale)
+        return result?.toast ?? t('toastNoNew')
+      })
     })
 
     dshGo.on('open-pool', () => ({ open: 'panel:pool' }))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-modelscope-pool",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "description": "魔搭多 Key 聚合网关：无感路由（模型不变，Key 遇限流/额度不足/无权限/不存在自动换下一个）；自动识别国际版/国内版令牌；单个 Key 可禁用/停用/恢复/删除/查看；全部密钥分页浏览；模型实际拉取国际版+国内版合并成简化名、按站点分组；额度低于 2 停用到次日 00:01、多 Key 轮换、限流临时失败冷却 5 分钟，并注册为 DSH 模型供应商",
   "license": "MIT",
   "author": "Yizutt",