@easyai-canvas/canvas-plugin-sdk 0.1.7 → 0.1.8

package/README.md

@@ -4,6 +4,8 @@
 
 SDK 为商业专有软件。npm 公开下载不自动授予使用或再分发许可，具体权限以 EasyAI 客户协议为准。
 
+开发、构建和运行插件需使用 Node 22.22.0 或更新的 Node 22。请先切换 Node 版本，再运行以下初始化命令；`init` 会自动安装项目依赖，无需先在空目录执行 `npm i @easyai-canvas/canvas-plugin-sdk`。若依赖已在其他 Node 主版本下安装，切换后在项目目录运行 `npm ci`，以重装原生依赖。
+
 ```bash
 npx @easyai-canvas/canvas-plugin-sdk init my-plugin
 cd my-plugin

package/bin/easyai-plugin.mjs

@@ -18,7 +18,9 @@ const args = process.argv.slice(3);
 function fail(message) { throw new Error(message); }
 function nodeVersion() {
   const [major, minor] = process.versions.node.split('.').map(Number);
-  if (major !== 22 || minor < 22) fail('请使用 Node 22.22.0 或更新的 Node 22 版本');
+  if (major !== 22 || minor < 22) {
+    fail(`当前 Node ${process.versions.node} 不支持 SDK（要求 ${metadata.engines.node}）。请先切换 Node 版本，再安装依赖或运行命令。`);
+  }
 }
 function safeName(value) {
   const name = value.toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/^-+|-+$/g, '');
@@ -121,6 +123,7 @@ async function init() {
   if (!['node', 'action', 'combined'].includes(template)) fail('模板只支持 node、action 或 combined');
   const targetArg = args.find((arg, index) => !arg.startsWith('--') && args[index - 1] !== '--template');
   if (!targetArg) fail('用法：easyai-plugin init <目录> [--template node|action|combined] [--no-install]');
+  nodeVersion();
   const target = resolve(targetArg);
   if (existsSync(target) && (await readdir(target)).length) fail('目标目录非空，不会覆盖已有文件');
   const slug = safeName(basename(target));
@@ -131,6 +134,7 @@ async function init() {
   const spec = process.env.EASYAI_SDK_INSTALL_SPEC ?? metadata.version;
   const project = {
     name: slug, version: '0.1.0', private: true, type: 'module',
+    engines: { node: metadata.engines.node },
     scripts: { dev: 'easyai-plugin dev', 'test:contract': 'easyai-plugin test:contract',
       build: 'easyai-plugin build', start: 'easyai-plugin start', doctor: 'easyai-plugin doctor' },
     dependencies: { [metadata.name]: spec, vue: '3.5.21' },
@@ -281,7 +285,13 @@ async function contractTest() {
 async function doctor() {
   const checks = [];
   const [major, minor] = process.versions.node.split('.').map(Number);
-  checks.push({ name: 'Node 22.22+', ok: major === 22 && minor >= 22 });
+  const nodeCheck = `Node ${metadata.engines.node}（当前 ${process.versions.node}）`;
+  if (major !== 22 || minor < 22) {
+    console.log(`✗ ${nodeCheck}`);
+    process.exitCode = 1;
+    return;
+  }
+  checks.push({ name: nodeCheck, ok: true });
   const entries = await pluginEntries().catch(() => []);
   checks.push({ name: `插件入口（${entries.length} 个）`, ok: entries.length > 0 });
   checks.push({ name: '插件 ID 唯一', ok: entries.length > 0 && (await build().then(() => true).catch(() => false)) });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@easyai-canvas/canvas-plugin-sdk",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "EasyAI 画布插件开发工具与运行时",
   "type": "module",
   "engines": {