@aiot-nexus/plugin-sdk 2.0.0 → 2.0.1

package/README.md

@@ -1,5 +1,7 @@
 # @aiot-nexus/plugin-sdk
 
+> 版本适用性：当前包版本为 `2.0.1`，只面向 Framework API `2.0.0` 的 v2 worker/RPC 模型。1.x SDK 和同步 Host API 已停止适用，但其历史语义保留在本文末尾和 [v1 到 v2 迁移说明](../docs/plugin-framework-v1-v2-migration.md)；2.x 不提供 1.x 运行模型兼容层。
+
 AIoT Nexus 独立插件开发包，包含公开 TypeScript 契约、PluginFrame 浏览器客户端和 `nexus-plugin` 命令行工具。
 
 ## 环境
@@ -35,7 +37,7 @@ SDK 提供两层非阻塞版本检查：
 - `nexus-plugin` 启动时先读取缓存。缓存新鲜期为 24 小时；缓存缺失或过期时在后台检查，不等待网络，不改变命令退出码。检测到普通更新时会显示：
 
   ```text
-  npm notice Update available for @aiot-nexus/plugin-sdk: 2.0.0 -> 2.1.0
+  npm notice Update available for @aiot-nexus/plugin-sdk: 2.0.1 -> 2.1.0
   npm notice Run npm install --save-dev @aiot-nexus/plugin-sdk@latest
   ```
 
@@ -64,7 +66,7 @@ nexus-plugin create my-frame-plugin \
 - 目标目录非空时命令以返回码 `2` 拒绝覆盖。生成或安装失败返回 `1`。
 - 两套模板均读取宿主 `PluginRendererContext.language` 和 `themeMode`，通过 `onContextChanged` 在同一 iframe 内响应运行时语言与主题切换，并内置 `zh-CN` / `en-US` renderer 文案；manifest 使用相同文化资源本地化宿主入口。模板页面自身不提供语言或主题选择控件。
 
-默认来源从 npm registry 安装。离线开发时先执行 `npm run pack:sdk`，再通过 `--sdk-source /path/to/aiot-nexus-plugin-sdk-2.0.0.tgz` 指定本地包；CLI 会把本地包一并放入生成工程。
+默认来源从 npm registry 安装。离线开发时先执行 `npm run pack:sdk`，再通过 `--sdk-source /path/to/aiot-nexus-plugin-sdk-2.0.1.tgz` 指定本地包；CLI 会把本地包一并放入生成工程。
 
 ## 独立调试
 
@@ -117,6 +119,21 @@ npm run dev:nexus -- --host D:\prj\tmp\aiot-nexus\dist\electron\nexus-win32-x64\
 | --- | --- |
 | `src/renderer/**` | 只运行 `build:web` 并替换 renderer；宿主 PID 不变，iframe 重新完成 `ready/init`。 |
 | `src/manifest.json` 的展示、贡献点等安全字段 | 构建 renderer、原子替换 manifest 后重扫插件目录；宿主 PID 不变。 |
-| `src/main.ts`、依赖、原生模块或主进程相关 manifest 字段 | 完整构建成功后先停止插件 worker，原子替换完整插件包，再在同一 Nexus 进程中启动新 worker；宿主 PID 不变。 |
+| `src/main.ts`、依赖、原生模块或 worker 相关 manifest 字段 | 完整构建成功后先停止插件 worker，原子替换完整插件包，再在同一 Nexus 进程中启动新 worker；宿主 PID 不变。 |
 
 更新构建或 worker 重载失败时保留上一个可运行部署，并回滚插件包后重新激活旧 worker。`mainEntry` 不通过清理 `require.cache` 热替换；每次包更新都执行 `deactivate`、替换包和新的 worker 激活，但不重启整个 Nexus。默认打开 Renderer DevTools；可传 `--no-devtools`。`--inspect[=<port>]` 和 `--inspect-brk[=<port>]` 调试的是插件 worker，贡献点选择支持 `--surface` 与 `--contribution-id`。按 `Ctrl+C` 停止 CLI 时，CLI 会先请求插件 worker 关闭，再关闭其启动的正式宿主。
+
+## v1 SDK 历史说明（不适用于当前包）
+
+SDK 1.x 对应 Framework API `1.0.0`：`mainEntry` 在 Electron 主进程中加载，Host API 直接返回同步 `NexusResult<T>`，完整插件包变化需要重启 Nexus。旧离线包名使用 `aiot-nexus-plugin-sdk-1.1.1.tgz`，旧调试目标是 `Attach Nexus plugin main (9229)`。
+
+| v1 项目 | 历史行为 | v2 替代 |
+| --- | --- | --- |
+| `npm run dev` | Electron 调试宿主在主进程加载 `mainEntry` | 调试宿主创建独立插件 worker |
+| `npm run dev:debug` | `--inspect-brk=9229` 暂停 Electron 主进程 | inspect 端口连接插件 worker，宿主 UI 可独立启动 |
+| `npm run dev:nexus` 完整包变化 | 退出旧 Nexus、替换包、启动新 Nexus，PID 改变 | 停止目标 worker、替换包、启动新 worker，Nexus PID 不变 |
+| Host API 调用 | 直接获得 `NexusResult<T>` | `await` `Promise<NexusResult<T>>` |
+| Renderer-only 调试 | 不执行 `mainEntry`，`invokeMain` 返回 unsupported | 该限制在 v2 继续成立 |
+| 更新失败 | 恢复旧包并重新启动宿主 | 恢复旧包和旧 worker，不重启 Nexus |
+
+这些约定只用于阅读旧插件和历史报告。迁移到当前 SDK 时必须把 manifest 升到 2.x、异步等待 Host API、实现资源关闭，并改用插件 worker 调试和生命周期；不能只修改 npm 包版本而保留同步调用。

package/dev-host/host.html

@@ -115,6 +115,8 @@
       }
 
       .frame-shell {
+        display: flex;
+        flex-direction: column;
         flex: 1 1 auto;
         min-width: 0;
         padding: 12px;
@@ -123,6 +125,7 @@
 
       iframe {
         display: block;
+        flex: 1 1 auto;
         width: 100%;
         min-height: 360px;
         border: 1px solid var(--border);

package/dist/src/index.d.ts

@@ -1,5 +1,5 @@
 import pluginManifestSchema from "../.generated/plugin-manifest.schema.json";
-export declare const PLUGIN_SDK_VERSION = "2.0.0";
+export declare const PLUGIN_SDK_VERSION = "2.0.1";
 export { pluginManifestSchema };
 export * from "../.generated/plugin-framework-version";
 export * from "./types";

package/dist/src/index.js

@@ -20,7 +20,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.pluginManifestSchema = exports.PLUGIN_SDK_VERSION = void 0;
 const plugin_manifest_schema_json_1 = __importDefault(require("../.generated/plugin-manifest.schema.json"));
 exports.pluginManifestSchema = plugin_manifest_schema_json_1.default;
-exports.PLUGIN_SDK_VERSION = "2.0.0";
+exports.PLUGIN_SDK_VERSION = "2.0.1";
 __exportStar(require("../.generated/plugin-framework-version"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./browser/frame-client"), exports);

package/package.json

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

package/templates/sqlite/src/renderer/index.html

@@ -36,7 +36,7 @@
         <p id="formError" class="error" hidden></p>
       </section>
 
-      <section class="panel">
+      <section class="panel recent-rows-panel">
         <div class="panel-heading">
           <h2 data-i18n="section.recentRows">Recent Rows</h2>
           <span id="statusLog" data-i18n="status.idle">Idle</span>

package/templates/sqlite/src/renderer/plugin.css

@@ -15,13 +15,15 @@
 
 body {
   margin: 0;
-  min-height: 0;
+  min-height: 100vh;
   background: #f3f5f7;
 }
 
 .plugin-shell {
   display: grid;
+  grid-template-rows: auto auto auto minmax(0, 1fr);
   gap: 12px;
+  min-height: 100vh;
   padding: 16px;
 }
 
@@ -100,6 +102,17 @@ h2 {
   padding: 14px 16px;
 }
 
+.recent-rows-panel {
+  display: flex;
+  flex-direction: column;
+  min-height: 0;
+}
+
+.recent-rows-panel .table-wrap {
+  flex: 1 1 auto;
+  min-height: 0;
+}
+
 .entry-form {
   display: grid;
   grid-template-columns: minmax(150px, 1fr) minmax(220px, 2fr) auto;