@aiot-nexus/plugin-sdk 3.1.0 → 3.1.1

package/README.md

@@ -1,6 +1,6 @@
 # @aiot-nexus/plugin-sdk
 
-> 当前 SDK 包版本为 `3.1.0`，Framework API 为 `3.1.0`，manifest schema 保持 `1`。Framework 3 将可信插件的 `mainEntry` 直接加载到 Nexus Electron 主进程；它不是安全沙箱。PluginFrame iframe 仍保持 sandbox、无 Node/Electron 访问。宿主运行模型见 [Framework v3 架构](../docs/plugin-framework-v3-architecture.md)。
+> 当前 SDK 包版本为 `3.1.1`，Framework API 为 `3.1.0`，manifest schema 保持 `1`。Framework 3 将可信插件的 `mainEntry` 直接加载到 Nexus Electron 主进程；它不是安全沙箱。PluginFrame iframe 仍保持 sandbox、无 Node/Electron 访问。宿主运行模型见 [Framework v3 架构](../docs/plugin-framework-v3-architecture.md)。
 
 本包提供公开 TypeScript 契约、PluginFrame 浏览器客户端和 `nexus-plugin` CLI。v2 项目升级前请先阅读 [v2 到 v3 迁移说明](../docs/plugin-framework-v2-v3-migration.md)。完整开发流程见 [独立插件开发指南](../docs/standalone-plugin-development-guide.md)。
 
@@ -8,7 +8,7 @@
 
 | 项目 | 固定值 |
 | --- | --- |
-| SDK | `3.1.0` |
+| SDK | `3.1.1` |
 | Framework API | `3.1.0` |
 | Manifest schema | `1` |
 | Node 安装和构建 | `>=16.20.0 <17` |
@@ -48,15 +48,15 @@ npm run publish:sdk
 registry 升级与只读预检：
 
 ```bash
-npx --package=@aiot-nexus/plugin-sdk@3.1.0 nexus-plugin upgrade . --check
-npx --package=@aiot-nexus/plugin-sdk@3.1.0 nexus-plugin upgrade .
+npx --package=@aiot-nexus/plugin-sdk@3.1.1 nexus-plugin upgrade . --check
+npx --package=@aiot-nexus/plugin-sdk@3.1.1 nexus-plugin upgrade .
 ```
 
 发布前或本地 tgz：
 
 ```bash
-npx --package=./aiot-nexus-plugin-sdk-3.1.0.tgz nexus-plugin upgrade . \
-  --sdk-source ./aiot-nexus-plugin-sdk-3.1.0.tgz
+npx --package=./aiot-nexus-plugin-sdk-3.1.1.tgz nexus-plugin upgrade . \
+  --sdk-source ./aiot-nexus-plugin-sdk-3.1.1.tgz
 ```
 
 CI 可以追加 `--json` 获得 `up-to-date`、`upgrade-available`、`upgraded`、`rolled-back` 或 `blocked`。`--allow-major` 只解除 major 保护，不会改写业务源码；跨 major 必须先阅读迁移指南。`--skip-project-checks` 只跳过项目 typecheck/build，安装后的 SDK、package 和 lockfile 一致性仍会验证。
@@ -67,7 +67,7 @@ CI 可以追加 `--json` 获得 `up-to-date`、`upgrade-available`、`upgraded`
 
 安装或项目验证失败时恢复备份，并在原 lockfile 存在时运行 `npm ci`。没有原 lockfile 时会运行 `npm install` 并恢复原 SDK，但无法证明完整传递依赖树与升级前一致，因此返回 `blocked` 并保留恢复数据。标准脚手架 build 的 `dist/<pluginId>` 在回滚范围内；自定义 typecheck/build 若修改其他路径，这些副作用不属于升级事务，项目必须自行管理。
 
-SDK `3.0.2` 升级到 `3.1.0` 后，原有 `hostApiVersion: 3.0.0` 可以保持不变。只有实际使用 `showHostStatusBar` 等 3.1 专属字段时，才把 manifest 声明提升到 `3.1.0`。
+SDK `3.0.2` 或 `3.1.0` 升级到 `3.1.1` 后，原有 `hostApiVersion: 3.0.0` 可以保持不变。只有实际使用 `showHostStatusBar` 等 3.1 专属字段时，才把 manifest 声明提升到 `3.1.0`。SDK 3.1.1 修复了 registry 升级时把裸版本号误传给 `npm install` 的问题；全局安装 3.1.0 的用户应先把全局 CLI 更新到 3.1.1。
 
 ## 创建插件
 
@@ -90,7 +90,7 @@ nexus-plugin create my-frame-plugin \
 
 ```bash
 npm run pack:sdk
-nexus-plugin create my-frame-plugin --sdk-source ./package/aiot-nexus-plugin-sdk-3.1.0.tgz --install
+nexus-plugin create my-frame-plugin --sdk-source ./package/aiot-nexus-plugin-sdk-3.1.1.tgz --install
 ```
 
 生成插件后，可以在 `src/manifest.json` 的业务入口中静态控制 Nexus 宿主状态栏。相关 manifest 片段如下，其余必填字段沿用脚手架生成值：

package/dist/src/sdk-info.d.ts

@@ -1,4 +1,4 @@
-export declare const PLUGIN_SDK_VERSION = "3.1.0";
+export declare const PLUGIN_SDK_VERSION = "3.1.1";
 export declare const PLUGIN_SDK_NODE_ENGINE = ">=16.20.0 <17";
 export declare const PLUGIN_SDK_NPM_ENGINE = ">=6.13.4";
 export declare const PLUGIN_SDK_ELECTRON_VERSION = "22.3.27";

package/dist/src/sdk-info.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPluginSdkInfo = exports.PLUGIN_SDK_TYPES_NODE_VERSION = exports.PLUGIN_SDK_TYPESCRIPT_VERSION = exports.PLUGIN_SDK_ELECTRON_VERSION = exports.PLUGIN_SDK_NPM_ENGINE = exports.PLUGIN_SDK_NODE_ENGINE = exports.PLUGIN_SDK_VERSION = void 0;
 const plugin_framework_version_1 = require("../.generated/plugin-framework-version");
-exports.PLUGIN_SDK_VERSION = "3.1.0";
+exports.PLUGIN_SDK_VERSION = "3.1.1";
 exports.PLUGIN_SDK_NODE_ENGINE = ">=16.20.0 <17";
 exports.PLUGIN_SDK_NPM_ENGINE = ">=6.13.4";
 exports.PLUGIN_SDK_ELECTRON_VERSION = "22.3.27";

package/dist/src/upgrade.js

@@ -225,7 +225,7 @@ function applyUpgrade(inspection, options, runtime) {
             "install",
             saveFlag,
             "--save-exact",
-            inspection.normalizedSource.dependencySpec,
+            inspection.normalizedSource.installSpec,
         ], result.projectDirectory);
         if (!commandSucceeded(installResult)) {
             throw new Error(commandFailure("npm install", installResult));
@@ -455,7 +455,11 @@ function normalizeSdkSource(value, workingDirectory, projectDirectory, runtime,
         else {
             addCheck(result, "SDK source", "passed", "Using exact registry version " + version + ".");
         }
-        return { display: version, dependencySpec: version };
+        return {
+            display: version,
+            dependencySpec: version,
+            installSpec: sdkPackageName + "@" + version,
+        };
     }
     let localArchivePath;
     if (source.startsWith("file:")) {
@@ -471,14 +475,18 @@ function normalizeSdkSource(value, workingDirectory, projectDirectory, runtime,
     }
     if (!localArchivePath) {
         addCheck(result, "SDK source", "failed", "SDK source must be an exact X.Y.Z version or a local .tgz path.");
-        return { display: source, dependencySpec: source };
+        return { display: source, dependencySpec: source, installSpec: source };
     }
     try {
         assertRegularFile(localArchivePath, "Local SDK archive", ".tgz");
     }
     catch (error) {
         addCheck(result, "SDK source", "failed", errorMessage(error));
-        return { display: localArchivePath, dependencySpec: source };
+        return {
+            display: localArchivePath,
+            dependencySpec: source,
+            installSpec: source,
+        };
     }
     const archiveInfo = runtime.runNpm([
         "pack",
@@ -520,6 +528,7 @@ function normalizeSdkSource(value, workingDirectory, projectDirectory, runtime,
     return {
         display: localArchivePath,
         dependencySpec: "file:" + vendoredRelativePath,
+        installSpec: "file:" + vendoredRelativePath,
         localArchivePath,
         vendoredArchivePath: path.join(projectDirectory, ...vendoredRelativePath.split("/")),
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiot-nexus/plugin-sdk",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "description": "Types, PluginFrame client, and CLI for AIoT Nexus independent plugins.",
   "license": "UNLICENSED",
   "publishConfig": {