dsh-modelscope-pool 0.10.0 → 0.10.1

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.1 起这几个慢操作（刷新额度 / 测试全部 / 重新拉取模型 / 添加 Key）改成先回一个「正在刷新额度」的等待态，结果异步回来，最多 60 秒。如果你还在 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

@@ -728,11 +728,26 @@ const modelRowOf = (entry, current, t) => {
         }
     }
 
+    // 点按必须在 3 秒内返回，否则 App 会提示「没有响应」。
+    // 刷新额度 / 测试全部 / 拉模型 / 校验 Key 都要联网，所以先回 pending，结果走延后效果。
+    const defer = (label, work) => ({
+      pending: { label, timeoutMs: 60_000 },
+      result: async () => {
+        const value = await work()
+        refreshPanel()
+        refreshStrip()
+        return value
+      },
+    })
+
     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 defer(t('pendingRefresh'), async () => {
+            await refreshQuota(true)
+            await refreshCatalog(true)
+            return { toast: t('toastQuotaUpdated') }
+          })
         },
         async 'pick-model'(scope, event) {
           const t = makeT(event?.locale)
@@ -742,12 +757,13 @@ 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。
           // 真正会校验令牌的是额度接口，而且查额度不扣魔粒。
+          return defer(t('pendingTest'), async () => {
           const rows = await quota.refresh(
             keys.map((k) => ({ id: k.id, key: k.key, region: k.region })),
             { force: true },
@@ -774,6 +790,7 @@ const modelRowOf = (entry, current, t) => {
           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(' · ') }) }
+          })
         },
         'restore-all': async (scope, event) => {
           const t = makeT(event?.locale)
@@ -853,20 +870,24 @@ 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 defer(t('pendingAdd'), async () => {
+            const result = await addKey(raw, event?.locale)
+            return { toast: 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 defer(t('pendingModels'), async () => {
+            await refreshCatalog(true)
+            return { toast: t('toastModelsReloaded') }
+          })
         },
     }
 

package/package.json

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