@lark-apaas/miaoda-cli 0.1.17-alpha.0 → 0.1.17-alpha.ddef3e9

package/dist/cli/commands/app/index.js

@@ -166,6 +166,7 @@ function registerAppInit(parent) {
         .option('--template <stack>', `技术栈短名（${index_1.SUPPORTED_STACKS.join(' / ')}）`)
         .option('--conf <json>', 'init 配置 JSON。支持 {"version": "<template 版本>"}，默认 latest')
         .option('--skip-install', '跳过依赖安装', false)
+        .option('--async-install', '派发后台进程装依赖并立即返回（与 --skip-install 互斥）', false)
         .addOption((0, shared_1.appIdOption)())
         .addHelpText('after', `
 幂等
@@ -194,17 +195,31 @@ function registerAppInit(parent) {
     为空都会 fallback npm install。
   JSON 模式下子进程 stdout 重定向到 stderr，避免污染最终 emit 的 JSON。
 
+异步安装（--async-install）
+  跳过同步 npm install，派发一个 detached 后台进程装依赖后立即返回。
+  .spark/meta.json 在返回前写出（= 脚手架就绪），install 真实结果由 event marker 表达。
+  仅沙箱（SANDBOX_ID 非空）写 marker（presence 定成败，content 给排障）：
+    成功 → /tmp/event/WORKSPACE_READY
+    失败 → /tmp/event/WORKSPACE_FAILED
+  安装日志：/tmp/async_install_dep.std.log
+  失败恢复：靠后续 'miaoda app sync'（dev.sh 入口 / 沙箱 pod 启动会跑）兜底，init 不重试。
+  与 --skip-install 互斥。
+
 JSON 输出
   已初始化：{"data": {"initialized": false, "reason": "already_initialized", "targetDir": "..."}}
   新初始化：{"data": {"initialized": true, "template": "...", "templateVersion": "...", "steeringVersion": "...",
                      "appId": "...", "platformStackFound": true, "platformSyncedFiles": [...],
                      "installed": true, "installSource": "cache|npm|skipped", "installHash": "...", ...}}
+  async 模式：{"data": {"initialized": true, "asyncInstall": true, "installed": false,
+                      "installSource": "async", "installPid": 123, "installLogPath": "...",
+                      "eventReadyPath": "...", "eventFailedPath": "..."}}
 
 示例
   $ miaoda app init --template vite-react
   $ miaoda app init --template nestjs-react-fullstack --app-id app_xxx
   $ miaoda app init --template vite-react --conf '{"version": "0.1.0"}'
   $ miaoda app init --template vite-react --skip-install
+  $ miaoda app init --template vite-react --async-install
   $ MIAODA_DEP_CACHE_DIR=/tmp/dep-cache miaoda app init --template vite-react
 `);
     cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
@@ -214,6 +229,7 @@ JSON 输出
             conf,
             skipInstall: rawOpts.skipInstall,
             appId: rawOpts.appId,
+            asyncInstall: rawOpts.asyncInstall,
         });
     }));
 }

package/dist/cli/handlers/app/init.js

@@ -60,6 +60,9 @@ async function handleAppInit(opts) {
             next_actions: [`可用 stack：${index_1.SUPPORTED_STACKS.join(', ')}`],
         });
     }
+    if (opts.asyncInstall && opts.skipInstall) {
+        throw new error_1.AppError('ARGS_INVALID', '--async-install 与 --skip-install 互斥');
+    }
     const version = opts.conf?.version;
     const projectName = node_path_1.default.basename(targetDir);
     const tplResult = (0, index_1.renderTemplate)({ stack, version, targetDir, projectName });
@@ -86,13 +89,17 @@ async function handleAppInit(opts) {
         (0, logger_1.log)('init', `⚠ skills sync failed (continuing init): ${steeringError}`);
         steeringResult = { version: 'unknown', syncedSkills: [], techSynced: false };
     }
-    // 装模板钉死的依赖。不带 <pkg>@latest 位置参数,因此 npm 不会改写 package.json/lockfile
+    // 依赖安装：async 模式留到 meta 落盘后派发后台进程（不等装完），同步模式当场装。
+    // 同步：装模板钉死的依赖。不带 <pkg>@latest 位置参数,因此 npm 不会改写 package.json/lockfile
     // —— "升管控包到 latest" 是 sync 的职责,在 dev.sh 入口跑 `miaoda app sync` 时触发。
-    const installResult = (0, index_1.installDependencies)({
-        targetDir,
-        skip: opts.skipInstall,
-        quietStdout: (0, output_1.isJsonMode)(),
-    });
+    let installResult;
+    if (!opts.asyncInstall) {
+        installResult = (0, index_1.installDependencies)({
+            targetDir,
+            skip: opts.skipInstall,
+            quietStdout: (0, output_1.isJsonMode)(),
+        });
+    }
     // template 自带 .githooks/pre-commit；如果用户项目已 git init,顺便设上 core.hooksPath。
     const hookActivation = (0, githooks_1.activateGitHooks)(targetDir);
     (0, index_1.writeSparkMeta)(targetDir, {
@@ -101,8 +108,18 @@ async function handleAppInit(opts) {
         archType: tplResult.archType,
         app_id: opts.appId,
     });
+    // async 模式：meta 已落盘（= 脚手架就绪），再派发后台安装并立即返回（不等装完）。
+    let asyncDispatch;
+    if (opts.asyncInstall) {
+        asyncDispatch = (0, index_1.dispatchAsyncInstall)({ targetDir });
+    }
     if (!(0, output_1.isJsonMode)()) {
-        process.stdout.write(`✓ Initialized ${stack} (template ${tplResult.version}, steering ${steeringResult.version}, install ${installResult.source}) in ${targetDir}\n`);
+        if (opts.asyncInstall && asyncDispatch) {
+            process.stdout.write(`✓ Initialized ${stack} (template ${tplResult.version}, steering ${steeringResult.version}, install dispatched in background pid ${String(asyncDispatch.pid)}) in ${targetDir}\n`);
+        }
+        else if (installResult) {
+            process.stdout.write(`✓ Initialized ${stack} (template ${tplResult.version}, steering ${steeringResult.version}, install ${installResult.source}) in ${targetDir}\n`);
+        }
     }
     (0, output_1.emit)({
         data: {
@@ -117,11 +134,23 @@ async function handleAppInit(opts) {
             techSynced: steeringResult.techSynced,
             steeringError,
             gitHooks: hookActivation.action,
-            installed: installResult.installed,
-            installSource: installResult.source,
-            installHash: installResult.hash,
-            cacheZip: installResult.cacheZip,
-            installError: installResult.error,
+            ...(opts.asyncInstall && asyncDispatch
+                ? {
+                    asyncInstall: true,
+                    installed: false,
+                    installSource: 'async',
+                    installPid: asyncDispatch.pid,
+                    installLogPath: asyncDispatch.logPath,
+                    eventReadyPath: asyncDispatch.eventReadyPath,
+                    eventFailedPath: asyncDispatch.eventFailedPath,
+                }
+                : {
+                    installed: installResult?.installed,
+                    installSource: installResult?.source,
+                    installHash: installResult?.hash,
+                    cacheZip: installResult?.cacheZip,
+                    installError: installResult?.error,
+                }),
         },
     });
 }

package/dist/cli/handlers/app/migrate.js

@@ -134,6 +134,27 @@ async function handleAppMigrate(opts) {
         installError = err instanceof Error ? err.message : String(err);
         (0, logger_1.log)('migrate', `⚠ npm install failed (continuing): ${installError}`);
     }
+    // 沙箱环境下重启 dev process —— scripts/dev.js 被 fullstack 版本覆盖了,但当前正在
+    // 跑的 node 进程仍按老逻辑工作(只起 vite,没起 nest),整体没切到 fullstack 模式。
+    // 通过 pkill 杀掉 dev.js 主进程,依赖沙箱平台 supervisor 自动重新 exec dev.sh → dev.js,
+    // 新进程用新 deps + 新 scripts,正常进入 fullstack 模式。
+    //   - 只在 SANDBOX_ID 非空时做(本地环境用户进程混杂,主动 pkill 风险大)
+    //   - install 挂了不做 —— 新依赖不全, 杀旧 dev 后新 dev 起不来反而更糟,
+    //     留着旧进程让用户先处理 installError
+    //   - 软失败:pkill 无匹配进程退出 1,catch 吞掉
+    let devRestarted = false;
+    if (installError === undefined &&
+        process.env.SANDBOX_ID !== undefined &&
+        process.env.SANDBOX_ID !== '') {
+        (0, logger_1.log)('migrate', '沙箱环境,重启 dev process(平台 supervisor 会自动拉起)...');
+        try {
+            (0, node_child_process_1.execFileSync)('pkill', ['-f', 'node.*scripts/dev\\.js'], { stdio: 'ignore' });
+            devRestarted = true;
+        }
+        catch {
+            // pkill 无匹配进程时退出 1,正常情况(可能 dev 没在跑)
+        }
+    }
     (0, output_1.emit)({
         data: {
             from,
@@ -148,10 +169,17 @@ async function handleAppMigrate(opts) {
             ...summarizeResults(results),
             followLatestPackages: followLatest,
             installError,
-            nextActions: [
-                'git status / git diff 评估改动并 commit',
-                'miaoda skills sync 同步到新 stack 的 agent skills',
-            ],
+            devRestarted,
+            nextActions: process.env.SANDBOX_ID !== undefined && process.env.SANDBOX_ID !== ''
+                ? [
+                    'git status / git diff 评估改动并 commit',
+                    'miaoda skills sync 同步到新 stack 的 agent skills',
+                ]
+                : [
+                    'git status / git diff 评估改动并 commit',
+                    '重启 dev 进程让新 scripts/dev.js + 新依赖生效:重跑 npm run dev(killOrphansByPort 会自动踢掉旧进程)',
+                    'miaoda skills sync 同步到新 stack 的 agent skills',
+                ],
         },
     });
 }

package/dist/config/migrate-configs/vite-react-to-nestjs-react-fullstack.js

@@ -83,6 +83,11 @@ exports.MIGRATE_CONFIG = {
         { type: 'directory', from: 'shared', to: 'shared', overwrite: false },
         // .env fallback（user 没有时用 template 默认）
         { type: 'file', from: '.env', to: '.env', overwrite: false },
+        // ===== 4.5. plugin 实例从 shared/capabilities 搬到 server/capabilities =====
+        // vite-react (jsPage) 时期 plugin 实例 json 放在 shared/capabilities/<id>.json，
+        // fullstack 形态走 server 侧装载,路径约定改成 server/capabilities/<id>.json。
+        // 顺序约束:必须在 server/ 覆盖之后 —— server/ 是 overwrite:true,放前面会被擦掉。
+        { type: 'move-directory', from: 'shared/capabilities', to: 'server/capabilities' },
         // ===== 5. 加 fullstack 形态必需的 scripts =====
         // 这些 scripts 用 user 现有的可能性低（vite-react 没有 nest 相关 script），直接覆盖
         {

package/dist/services/app/init/async-install.js

@@ -0,0 +1,116 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASYNC_INSTALL_LOG = void 0;
+exports.isSandboxEnv = isSandboxEnv;
+exports.runAsyncInstallWorker = runAsyncInstallWorker;
+exports.dispatchAsyncInstall = dispatchAsyncInstall;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const install_1 = require("./install");
+/** event marker 目录，写死；写前 mkdir -p。沙箱里 code server 轮询此目录。 */
+const EVENT_DIR = '/tmp/event';
+/** 安装成功 marker 名 */
+const MARKER_READY = 'WORKSPACE_READY';
+/** 安装失败 marker 名 */
+const MARKER_FAILED = 'WORKSPACE_FAILED';
+/** 后台 worker stdout/stderr 落盘路径 */
+exports.ASYNC_INSTALL_LOG = '/tmp/async_install_dep.std.log';
+/** 沙箱判定：SANDBOX_ID 非空。与 init handler 的 outputLayout 分流口径一致。 */
+function isSandboxEnv() {
+    return process.env.SANDBOX_ID !== undefined && process.env.SANDBOX_ID !== '';
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+function clearStaleMarkers(eventDir) {
+    for (const name of [MARKER_READY, MARKER_FAILED]) {
+        const p = node_path_1.default.join(eventDir, name);
+        if (node_fs_1.default.existsSync(p))
+            node_fs_1.default.rmSync(p, { force: true });
+    }
+}
+function writeMarker(eventDir, name, content) {
+    node_fs_1.default.mkdirSync(eventDir, { recursive: true });
+    node_fs_1.default.writeFileSync(node_path_1.default.join(eventDir, name), JSON.stringify(content) + '\n', 'utf-8');
+}
+/**
+ * 后台 install worker 体：跑 installDependencies，按结果写 marker（仅沙箱）。
+ * 由 dispatchAsyncInstall 通过 `node -e` 在 detached 子进程里调用（见下）。
+ * presence 定成败：成功写 WORKSPACE_READY，失败写 WORKSPACE_FAILED；content 给排障。
+ */
+function runAsyncInstallWorker(opts) {
+    const eventDir = opts.eventDir ?? EVENT_DIR;
+    const sandbox = isSandboxEnv();
+    if (sandbox)
+        clearStaleMarkers(eventDir);
+    const start = Date.now();
+    let result;
+    try {
+        result = (0, install_1.installDependencies)({ targetDir: opts.targetDir, quietStdout: false });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (sandbox) {
+            writeMarker(eventDir, MARKER_FAILED, {
+                ts: nowIso(),
+                error: msg,
+                logPath: exports.ASYNC_INSTALL_LOG,
+            });
+        }
+        return;
+    }
+    if (!sandbox)
+        return;
+    if (result.source === 'failed') {
+        writeMarker(eventDir, MARKER_FAILED, {
+            ts: nowIso(),
+            error: result.error ?? 'npm install failed',
+            logPath: exports.ASYNC_INSTALL_LOG,
+        });
+    }
+    else {
+        writeMarker(eventDir, MARKER_READY, {
+            ts: nowIso(),
+            durationMs: Date.now() - start,
+            source: result.source,
+        });
+    }
+}
+/**
+ * 派发 detached 后台进程跑依赖安装并立即返回。
+ * 用 `node -e` 直接 require 本模块（编译产物）调 runAsyncInstallWorker，
+ * 不挂任何 CLI 子命令、对外不暴露；worker 内复用 installDependencies（cache / registry / fallback）。
+ * 沙箱下派发前清旧 marker；stdout/stderr 重定向到 logPath。
+ */
+function dispatchAsyncInstall(opts) {
+    const eventDir = opts.eventDir ?? EVENT_DIR;
+    const logPath = opts.logPath ?? exports.ASYNC_INSTALL_LOG;
+    const sandbox = isSandboxEnv();
+    if (sandbox)
+        clearStaleMarkers(eventDir);
+    // targetDir 走 argv 传，不拼进代码串（免转义）；只把本模块路径 JSON 内联进去。
+    const workerCode = `require(${JSON.stringify(__filename)}).runAsyncInstallWorker({ targetDir: process.argv[1] })`;
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(logPath), { recursive: true });
+    const fd = node_fs_1.default.openSync(logPath, 'w');
+    try {
+        const child = (0, node_child_process_1.spawn)(process.execPath, ['-e', workerCode, opts.targetDir], {
+            detached: true,
+            stdio: ['ignore', fd, fd],
+        });
+        child.unref();
+        return {
+            pid: child.pid,
+            logPath,
+            eventReadyPath: sandbox ? node_path_1.default.join(eventDir, MARKER_READY) : undefined,
+            eventFailedPath: sandbox ? node_path_1.default.join(eventDir, MARKER_FAILED) : undefined,
+        };
+    }
+    finally {
+        // 父进程关掉自己那份 fd；子进程已通过 stdio dup 持有独立副本。
+        node_fs_1.default.closeSync(fd);
+    }
+}

package/dist/services/app/init/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveNpmInstallRegistry = exports.installDependencies = exports.writeSparkMeta = exports.readSparkMeta = exports.TEMPLATE_PACKAGE_BY_STACK = exports.SUPPORTED_STACKS = exports.renderTemplate = void 0;
+exports.ASYNC_INSTALL_LOG = exports.isSandboxEnv = exports.runAsyncInstallWorker = exports.dispatchAsyncInstall = exports.resolveNpmInstallRegistry = exports.installDependencies = exports.writeSparkMeta = exports.readSparkMeta = exports.TEMPLATE_PACKAGE_BY_STACK = exports.SUPPORTED_STACKS = exports.renderTemplate = void 0;
 var template_1 = require("./template");
 Object.defineProperty(exports, "renderTemplate", { enumerable: true, get: function () { return template_1.renderTemplate; } });
 Object.defineProperty(exports, "SUPPORTED_STACKS", { enumerable: true, get: function () { return template_1.SUPPORTED_STACKS; } });
@@ -11,3 +11,8 @@ Object.defineProperty(exports, "writeSparkMeta", { enumerable: true, get: functi
 var install_1 = require("./install");
 Object.defineProperty(exports, "installDependencies", { enumerable: true, get: function () { return install_1.installDependencies; } });
 Object.defineProperty(exports, "resolveNpmInstallRegistry", { enumerable: true, get: function () { return install_1.resolveNpmInstallRegistry; } });
+var async_install_1 = require("./async-install");
+Object.defineProperty(exports, "dispatchAsyncInstall", { enumerable: true, get: function () { return async_install_1.dispatchAsyncInstall; } });
+Object.defineProperty(exports, "runAsyncInstallWorker", { enumerable: true, get: function () { return async_install_1.runAsyncInstallWorker; } });
+Object.defineProperty(exports, "isSandboxEnv", { enumerable: true, get: function () { return async_install_1.isSandboxEnv; } });
+Object.defineProperty(exports, "ASYNC_INSTALL_LOG", { enumerable: true, get: function () { return async_install_1.ASYNC_INSTALL_LOG; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.17-alpha.0",
+  "version": "0.1.17-alpha.ddef3e9",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {
@@ -17,20 +17,6 @@
     "dist",
     "upgrade"
   ],
-  "scripts": {
-    "build": "bash scripts/build.sh",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
-    "lint": "eslint src/ --max-warnings 0",
-    "format": "prettier --write src/",
-    "format:check": "prettier --check src/",
-    "test": "vitest run --project=unit",
-    "test:watch": "vitest --project=unit",
-    "test:integration": "vitest run --project=integration",
-    "dev": "node --import tsx src/main.ts",
-    "cli": "node --env-file-if-exists=integration/.env --import tsx src/main.ts",
-    "prepare": "husky",
-    "prepublishOnly": "pnpm format:check && pnpm lint && pnpm build && pnpm test"
-  },
   "keywords": [
     "miaoda",
     "cli",
@@ -65,5 +51,16 @@
     "vitest": "^4.1.4",
     "xml2js": "^0.6.2"
   },
-  "packageManager": "pnpm@10.16.1+sha512.0e155aa2629db8672b49e8475da6226aa4bdea85fdcdfdc15350874946d4f3c91faaf64cbdc4a5d1ab8002f473d5c3fcedcd197989cf0390f9badd3c04678706"
-}
+  "scripts": {
+    "build": "bash scripts/build.sh",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "lint": "eslint src/ --max-warnings 0",
+    "format": "prettier --write src/",
+    "format:check": "prettier --check src/",
+    "test": "vitest run --project=unit",
+    "test:watch": "vitest --project=unit",
+    "test:integration": "vitest run --project=integration",
+    "dev": "node --import tsx src/main.ts",
+    "cli": "node --env-file-if-exists=integration/.env --import tsx src/main.ts"
+  }
+}

package/upgrade/templates/design-stack/templates/scripts/dev-local.js

@@ -5,9 +5,10 @@
 //
 // 流程:
 //   1. env pull —— 拉沙箱身份/凭证到 .env.local
-//   2. skills sync —— 同步当前 stack 的 agent skills
-//   3. dotenv 加载 .env / .env.local 到 process.env（含 SUDA_WEBUSER 适配）
-//   4. 起单进程 dev server（design-stack 单进程，无 server/client 拆分）
+//   2. action-plugin init —— 装 user app 在 package.json.actionPlugins 里声明的插件
+//   3. skills sync —— 同步当前 stack 的 agent skills
+//   4. dotenv 加载 .env / .env.local 到 process.env（含 SUDA_WEBUSER 适配）
+//   5. 起单进程 dev server（design-stack 单进程，无 server/client 拆分）
 //
 // 设计同 nestjs-react-fullstack/dev-local.js,SDK 包不需要自己 require('dotenv'),
 // env 加载收敛在启动脚本单点。SUDA_WEBUSER 适配同 nrf 那份。
@@ -26,7 +27,7 @@ function warn(msg) {
 if (!process.env.MIAODA_APP_TYPE) process.env.MIAODA_APP_TYPE = '4';
 process.env.MIAODA_LOCAL_DEV = '1';
 
-console.log('[dev-local] (1/4) env pull...');
+console.log('[dev-local] (1/5) env pull...');
 const hasLarkCli = spawnSync('command', ['-v', 'lark-cli'], { shell: true, stdio: 'ignore' }).status === 0;
 if (hasLarkCli) {
   let appId = '';
@@ -47,15 +48,23 @@ if (hasLarkCli) {
   warn('lark-cli 未安装，跳过 env pull；请确保 .env.local 已就绪');
 }
 
+// action-plugin init —— 装 user app 在 package.json.actionPlugins 里声明的插件。
+console.log('[dev-local] (2/5) action-plugin init...');
+try {
+  execSync('npx -y @lark-apaas/fullstack-cli@latest action-plugin init', { stdio: 'inherit' });
+} catch {
+  warn('action-plugin init 失败，继续启动');
+}
+
 // skills sync —— --local 切 flat layout;不传 --version,handler 默认 coding-steering@latest。
-console.log('[dev-local] (2/4) miaoda skills sync...');
+console.log('[dev-local] (3/5) miaoda skills sync...');
 try {
   execSync('npx -y @lark-apaas/miaoda-cli@latest skills sync --local', { stdio: 'inherit' });
 } catch {
   console.log('  (skills sync 失败，继续启动)');
 }
 
-console.log('[dev-local] (3/4) loading .env / .env.local...');
+console.log('[dev-local] (4/5) loading .env / .env.local...');
 const dotenv = require('dotenv');
 dotenv.config({ path: '.env.local' });
 dotenv.config({ path: '.env' });
@@ -75,7 +84,7 @@ if (process.env.SUDA_WEBUSER) {
   }
 }
 
-console.log('[dev-local] (4/4) npm run dev');
+console.log('[dev-local] (5/5) npm run dev');
 const child = spawn('npm', ['run', 'dev'], { stdio: 'inherit', env: process.env });
 child.on('exit', (code) => process.exit(code ?? 0));
 child.on('error', (err) => {

package/upgrade/templates/nestjs-react-fullstack/templates/scripts/dev-local.js

@@ -5,9 +5,10 @@
 //
 // 流程:
 //   1. env pull —— 拉沙箱身份/凭证到 .env.local
-//   2. skills sync —— 同步当前 stack 的 agent skills
-//   3. dotenv 加载 .env / .env.local 到 process.env（含 SUDA_WEBUSER 适配）
-//   4. 并发起 dev:server + dev:client（子进程继承 process.env）
+//   2. action-plugin init —— 装 user app 在 package.json.actionPlugins 里声明的插件
+//   3. skills sync —— 同步当前 stack 的 agent skills
+//   4. dotenv 加载 .env / .env.local 到 process.env（含 SUDA_WEBUSER 适配）
+//   5. 并发起 dev:server + dev:client（子进程继承 process.env）
 //
 // 关键设计：本脚本在 spawn 子进程之前先把 .env / .env.local 加载到 process.env，
 // 然后 spawn 的 server / client 进程通过 env 继承直接拿到——SDK（fullstack-nestjs-core
@@ -34,7 +35,7 @@ if (!process.env.MIAODA_APP_TYPE) process.env.MIAODA_APP_TYPE = '3';
 process.env.MIAODA_LOCAL_DEV = '1';
 
 // 1. env pull
-console.log('[dev-local] (1/4) env pull...');
+console.log('[dev-local] (1/5) env pull...');
 const hasLarkCli = spawnSync('command', ['-v', 'lark-cli'], { shell: true, stdio: 'ignore' }).status === 0;
 if (hasLarkCli) {
   let appId = '';
@@ -55,20 +56,28 @@ if (hasLarkCli) {
   warn('lark-cli 未安装，跳过 env pull；请确保 .env.local 已就绪');
 }
 
-// 2. skills sync —— --local 切到 flat layout (.agents/skills + .claude/skills 软链),
+// 2. action-plugin init —— 装 user app 在 package.json.actionPlugins 里声明的插件。
+console.log('[dev-local] (2/5) action-plugin init...');
+try {
+  execSync('npx -y @lark-apaas/fullstack-cli@latest action-plugin init', { stdio: 'inherit' });
+} catch {
+  warn('action-plugin init 失败，继续启动');
+}
+
+// 3. skills sync —— --local 切到 flat layout (.agents/skills + .claude/skills 软链),
 // 跟沙箱 nested layout 区分。不传 --version,handler 默认拉 coding-steering@latest,
 // 保证每次本地 npm run dev 都把 skills 升到最新。
-console.log('[dev-local] (2/4) miaoda skills sync...');
+console.log('[dev-local] (3/5) miaoda skills sync...');
 try {
   execSync('npx -y @lark-apaas/miaoda-cli@latest skills sync --local', { stdio: 'inherit' });
 } catch {
   console.log('  (skills sync 失败，继续启动)');
 }
 
-// 3. 加载 .env / .env.local 到 process.env
+// 4. 加载 .env / .env.local 到 process.env
 // dotenv 默认 override:false，先到先得 → 先 .env.local 让它优先于 .env；
 // shell env 已在 process.env，两次 config 都不会覆盖。
-console.log('[dev-local] (3/4) loading .env / .env.local...');
+console.log('[dev-local] (4/5) loading .env / .env.local...');
 const dotenv = require('dotenv');
 dotenv.config({ path: '.env.local' });
 dotenv.config({ path: '.env' });
@@ -89,8 +98,8 @@ if (process.env.SUDA_WEBUSER) {
   }
 }
 
-// 4. 并发起前后端 dev server
-console.log('[dev-local] (4/4) 并发起 dev:server + dev:client');
+// 5. 并发起前后端 dev server
+console.log('[dev-local] (5/5) 并发起 dev:server + dev:client');
 const child = spawn(
   'npx',
   [