dsh-cliproxyapi-pro 1.5.0 → 1.5.1

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to this plugin. Versions follow [Semantic Versioning](https://semver.org/).
 
+## 1.5.1 — 2026-10-19
+
+### Fixed
+- A missing update endpoint (page updated but DSH still running the previous host code) is no longer reported as "invalid version information": 404/405/501 answers now map to a dedicated "update service unavailable" message that names the real cause and says DSH must be restarted, not merely refreshed.
+
 ## 1.5.0 — 2026-10-19
 
 ### Added

package/README.en.md

@@ -49,7 +49,7 @@ The plugin is published on npm as [`dsh-cliproxyapi-pro`](https://www.npmjs.com/
    dsh-cliproxyapi-pro
    ```
 
-   To pin a version, write `dsh-cliproxyapi-pro@1.5.0`.
+   To pin a version, write `dsh-cliproxyapi-pro@1.5.1`.
 4. Click **Install**. When it finishes, the dialog offers to enable the plugin right away — accept it.
 
 > If downloads are slow in mainland China, open **Registry** next to the input and choose **the mainland China mirror**.
@@ -78,7 +78,7 @@ In **Add plugin**, or as the `plugin_manager` `target`, you can also enter:
 
 | Source | What to enter |
 |---|---|
-| A released version | `git+https://github.com/TinyBOOOOM/dsh-cliproxyapi-pro.git#v1.5.0` |
+| A released version | `git+https://github.com/TinyBOOOOM/dsh-cliproxyapi-pro.git#v1.5.1` |
 | Latest development version | `git+https://github.com/TinyBOOOOM/dsh-cliproxyapi-pro.git#main` |
 | Offline package | Download [`dsh-cliproxyapi-pro.tgz`](https://github.com/TinyBOOOOM/dsh-cliproxyapi-pro/releases/latest/download/dsh-cliproxyapi-pro.tgz) (always the latest release) and enter its absolute local path |
 | Local source (development) | Absolute path of a cloned repository; installed as a link, so code changes go live when the plugin reloads |
@@ -327,7 +327,7 @@ Current DSH versions reject replacing an installed plugin while running. To avoi
 A channel is usable only after the maintainer publishes its npm dist-tag. Stable is never presented as an unpublished Beta / Dev build. A channel version no newer than the running version does not offer a downgrade download either.
 
 **The update card says "update service unavailable" or "network error"?**
-The collapsed row names the actual cause. **Update service unavailable** means the page runs newer client code than the host plugin (disable and re-enable this plugin on the Plugins page, then refresh the page). **Network error** means requests to npmjs or the Mainland China mirror failed; switch the download region and check proxies/firewalls. **Channel unpublished** means that channel has no matching release yet. Expand the card for the matching explanation.
+The collapsed row names the actual cause. **Update service unavailable** means the page runs newer client code than the running host plugin: after installing or upgrading, **restart DSH** (refreshing the page or reloading the plugin is not enough). **Network error** means requests to npmjs or the Mainland China mirror failed; switch the download region and check proxies/firewalls. **Channel unpublished** means that channel has no matching release yet. Expand the card for the matching explanation.
 
 **Downloaded the update and restarted, but the version did not change?**
 Downloading and verification do not install anything. Exit DSH, run the card's upgrade command, then start it again. Linked installations do not receive that command; update their source manually to keep the link. If a plugin reload clears the download notice, the offline file remains in the profile's `updates` directory.

package/README.md

@@ -49,7 +49,7 @@
    dsh-cliproxyapi-pro
    ```
 
-   需要固定版本时可以写成 `dsh-cliproxyapi-pro@1.5.0`。
+   需要固定版本时可以写成 `dsh-cliproxyapi-pro@1.5.1`。
 4. 点击 **安装**，完成后点击 **立即启用**。
 
 > 在中国大陆下载慢，可以点输入框旁的 **安装源**，切换到 **中国大陆镜像源**。
@@ -78,7 +78,7 @@ dsh plugin --profile <profile 名称> add dsh-cliproxyapi-pro
 
 | 来源 | 填写内容 |
 |---|---|
-| 某个发布版本 | `git+https://github.com/TinyBOOOOM/dsh-cliproxyapi-pro.git#v1.5.0` |
+| 某个发布版本 | `git+https://github.com/TinyBOOOOM/dsh-cliproxyapi-pro.git#v1.5.1` |
 | 最新开发版 | `git+https://github.com/TinyBOOOOM/dsh-cliproxyapi-pro.git#main` |
 | 离线安装包 | 下载 [`dsh-cliproxyapi-pro.tgz`](https://github.com/TinyBOOOOM/dsh-cliproxyapi-pro/releases/latest/download/dsh-cliproxyapi-pro.tgz)（始终是最新版），填写它的本地绝对路径 |
 | 本地源码（开发用） | 克隆后的仓库目录绝对路径；以链接方式安装，改代码后重载插件即生效 |
@@ -325,7 +325,7 @@ DSH 使用的 pnpm 可能设置了新版本发布后的等待期（`minimumRelea
 只有维护者发布对应 npm dist-tag 后才可使用；插件不会把稳定版伪装成 Beta / 开发版。若通道版本不高于当前版本，也不会提供降级下载。
 
 **更新卡片显示「更新服务未就绪」或「网络异常」？**
-收起状态会直接给出原因：**更新服务未就绪** 表示页面是新版但宿主插件代码尚未重载（升级或修改后需在插件页停用再启用本插件，然后刷新页面）；**网络异常** 表示本机到 npm 官方源或国内镜像的请求失败，可切换下载区域、检查代理/防火墙后重试；**通道未发布** 则表示该通道还没有对应版本。展开卡片可看到对应说明。
+收起状态会直接给出原因：**更新服务未就绪** 表示页面已是新版，但运行中的插件宿主代码仍是旧版——安装或升级后必须**重启 DSH**（只刷新页面或重载插件不够）；**网络异常** 表示本机到 npm 官方源或国内镜像的请求失败，可切换下载区域、检查代理/防火墙后重试；**通道未发布** 则表示该通道还没有对应版本。展开卡片可看到对应说明。
 
 **已经下载，重启后为什么版本没变？**
 下载和校验并不安装。应先退出 DSH、执行卡片提供的升级命令，再启动；本地链接安装不提供该命令，保留链接方式需手动更新源码。若重载插件后下载提示消失，离线包仍在 profile 的 `updates` 目录里。

package/lib/client.js

@@ -131,7 +131,8 @@ window.__ModuleLoader__.load({
       updateCompactStatusUnavailable: "更新服务未就绪",
       updateCompactErrorNetwork: "网络异常",
       updateCompactErrorChannel: "通道未发布",
-      updateStatusUnavailableHint: "无法读取更新服务，可能是插件宿主代码尚未重载：重载插件后刷新页面，或检查更新接口是否可用。",
+      updateStatusUnavailableHint: "无法读取更新服务，可能是插件宿主代码尚未重载：重启 DSH（仅刷新页面不够），或检查更新接口是否可用。",
+      updateServiceUnavailableError: "更新服务未就绪：当前运行的插件宿主代码仍是旧版，可能尚未重启 DSH。重启 DSH 后重试。",
       updateSubtitle: "仅更新 CLIProxyAPI 插件自身，不更新 CPA 服务或 DSH 宿主。设置修改后立即保存。",
       updateNewVersion: "新版本",
       updateVersionSummary: "当前版本 {current} · 最新版本 {latest}",
@@ -302,7 +303,8 @@ window.__ModuleLoader__.load({
       updateCompactStatusUnavailable: "Update service unavailable",
       updateCompactErrorNetwork: "Network error",
       updateCompactErrorChannel: "Channel unpublished",
-      updateStatusUnavailableHint: "Could not reach the update service; the host plugin code may not be reloaded yet. Reload the plugin and refresh the page, or check that the update endpoint is registered.",
+      updateStatusUnavailableHint: "Could not reach the update service; the running host plugin code may still be the previous version. Restart DSH (refreshing the page is not enough), or check that the update endpoint is registered.",
+      updateServiceUnavailableError: "The update service is not ready: the running host plugin code is still the previous version, so DSH may not have been restarted. Restart DSH and retry.",
       updateSubtitle: "Updates this CLIProxyAPI plugin only, not the CPA server or DSH. Changes to update settings are saved immediately.",
       updateNewVersion: "New Version",
       updateVersionSummary: "Current {current} · Latest {latest}",
@@ -985,10 +987,12 @@ window.__ModuleLoader__.load({
         : "dcpa-dot dcpa-dot-idle";
     }
 
+    const SERVICE_UNAVAILABLE_STATUS = new Set([404, 405, 501]);
     const UPDATE_ERROR_KEYS = {
       "network-error": "updateNetworkError",
       "invalid-metadata": "updateMetadataError",
       "invalid-response": "updateMetadataError",
+      "service-unavailable": "updateServiceUnavailableError",
       "channel-unavailable": "updateChannelUnavailable",
       "unavailable-channel": "updateChannelUnavailable",
       "integrity-error": "updateIntegrityError",
@@ -1039,7 +1043,9 @@ window.__ModuleLoader__.load({
         body = await res.json();
       } catch {
         const failure = new Error("Invalid update response");
-        failure.updateCode = "invalid-response";
+        // A missing route (host plugin not reloaded) answers 404/405 with no
+        // update payload; that is "service unavailable", not bad metadata.
+        failure.updateCode = !res.ok && SERVICE_UNAVAILABLE_STATUS.has(res.status) ? "service-unavailable" : "invalid-response";
         if (!res.ok) failure.httpStatus = res.status;
         throw failure;
       }
@@ -1047,7 +1053,8 @@ window.__ModuleLoader__.load({
       if (!res.ok || body?.ok === false || !validState ||
           payload !== undefined && (body.update.error || body.update.errorCode)) {
         const failure = new Error("Update request failed");
-        failure.updateCode = body?.errorCode || body?.update?.errorCode || (!validState ? "invalid-response" : null);
+        failure.updateCode = body?.errorCode || body?.update?.errorCode ||
+          (!validState ? (!res.ok && SERVICE_UNAVAILABLE_STATUS.has(res.status) ? "service-unavailable" : "invalid-response") : null);
         failure.httpStatus = !res.ok ? res.status : null;
         failure.updateState = validState ? body.update : null;
         throw failure;
@@ -1192,6 +1199,7 @@ window.__ModuleLoader__.load({
       const compactErrorKey = error
         ? error.source === "status" ? "updateCompactStatusUnavailable" : "updateCompactError"
         : failureCode === "network-error" ? "updateCompactErrorNetwork"
+        : failureCode === "service-unavailable" ? "updateCompactStatusUnavailable"
         : failureCode === "channel-unavailable" ? "updateCompactErrorChannel"
         : "updateCompactError";
       const compactText = loading ? t("updateLoading") : downloading ? t("updateDownloading") : checking ? t("updateChecking") :

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cliproxyapi-pro",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "Auto-discovery CLIProxyAPI provider and management UI for DeepSeek Harness — multiple accounts, dynamic model sync, capability detection, and visual settings.",
   "keywords": [
     "dsh",