@lark-apaas/miaoda-cli 0.1.26 → 0.1.27

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

@@ -60,11 +60,16 @@ async function handleAppInit(opts) {
     const tplResult = (0, index_1.renderTemplate)({ stack, version, targetDir, projectName });
     // source_path 导入：当前仅 app_type=modern_html 生效。渲染完模板后、装依赖前叠加进 src/。
     const sourceImport = applySourcePathImport(opts, targetDir);
+    // 本地脚手架门禁：沙箱内所有栈照旧同步（nested，产出 .agent/）；本地只有 LOCAL_STEERING_STACKS
+    // 白名单栈（nestjs-react-fullstack / vite-react）才落地 steering（.claude/.agents）与 logs/。
+    // html / design-html 是纯静态 / 设计产物，本地不需要这套 agent skills 脚手架，整段跳过。
+    const sandbox = (0, env_1.isSandboxEnv)();
+    const scaffoldSteering = sandbox || index_1.LOCAL_STEERING_STACKS.has(stack);
     // 先建 logs/,防止 user 跑 dev 之前 AI/工具 redirect 到 logs/*.log 因为父目录不存在直接挂
     // (dev.js / dev-local.js 自己也建 logs/,但只在它启动后;启动前的 shell redirect 会先于此)。
-    // 仅本地开发需要：沙箱环境由平台 supervisor 拉起 dev,无 init 前的 shell redirect 场景,
-    // 不预建 logs/ 以免在沙箱工作区留空目录。
-    if (!(0, env_1.isSandboxEnv)()) {
+    // 仅本地白名单栈需要：沙箱环境由平台 supervisor 拉起 dev,无 init 前的 shell redirect 场景;
+    // 非白名单栈本地不落 steering 脚手架,也无需预建 logs/。
+    if (!sandbox && scaffoldSteering) {
         (0, logs_dir_1.ensureLogsDir)(targetDir);
     }
     // skills 同步软失败：拉不到 coding-steering 包不该阻断 writeSparkMeta /
@@ -74,21 +79,28 @@ async function handleAppInit(opts) {
     //     跟沙箱端 update-skills.sh 链路对齐
     //   - 本地 → flat (.agents/skills + .claude/skills 软链),
     //     Agent / Claude Code 用同一份;nrf 在本地是主战场,vite-react 等也一样适用
-    const outputLayout = (0, env_1.isSandboxEnv)() ? 'nested' : 'flat';
-    let steeringResult;
+    const outputLayout = sandbox ? 'nested' : 'flat';
+    // 默认空结果：非白名单栈跳过 steering 同步时（scaffoldSteering=false）直接沿用，
+    // 与"拉不到 coding-steering 包"软失败路径共用同一份占位，emit / meta 落盘不受影响。
+    let steeringResult = {
+        version: 'unknown',
+        syncedSkills: [],
+        techSynced: false,
+    };
     let steeringError;
-    try {
-        steeringResult = (0, coding_steering_1.syncCodingSteering)({
-            stack,
-            targetDir,
-            logPrefix: 'init',
-            outputLayout,
-        });
-    }
-    catch (err) {
-        steeringError = err instanceof Error ? err.message : String(err);
-        (0, logger_1.log)('init', `⚠ skills sync failed (continuing init): ${steeringError}`);
-        steeringResult = { version: 'unknown', syncedSkills: [], techSynced: false };
+    if (scaffoldSteering) {
+        try {
+            steeringResult = (0, coding_steering_1.syncCodingSteering)({
+                stack,
+                targetDir,
+                logPrefix: 'init',
+                outputLayout,
+            });
+        }
+        catch (err) {
+            steeringError = err instanceof Error ? err.message : String(err);
+            (0, logger_1.log)('init', `⚠ skills sync failed (continuing init): ${steeringError}`);
+        }
     }
     // 依赖安装：async 模式留到 meta 落盘后派发后台进程（不等装完），同步模式当场装。
     // 同步：装模板钉死的依赖。不带 <pkg>@latest 位置参数,因此 npm 不会改写 package.json/lockfile

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

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ASYNC_INSTALL_LOG = exports.runAsyncInstallWorker = exports.dispatchAsyncInstall = exports.resolveNpmInstallRegistry = exports.installDependencies = exports.writeSparkMeta = exports.readSparkMeta = exports.IMPORT_SKIP_FILES = exports.IMPORT_SKIP_DIRS = exports.importSourceSrc = exports.TEMPLATE_PACKAGE_BY_STACK = exports.STACK_BY_APP_TYPE = exports.APP_TYPES = exports.SUPPORTED_STACKS = exports.resolveStack = exports.renderTemplate = void 0;
+exports.ASYNC_INSTALL_LOG = exports.runAsyncInstallWorker = exports.dispatchAsyncInstall = exports.resolveNpmInstallRegistry = exports.installDependencies = exports.writeSparkMeta = exports.readSparkMeta = exports.IMPORT_SKIP_FILES = exports.IMPORT_SKIP_DIRS = exports.importSourceSrc = exports.TEMPLATE_PACKAGE_BY_STACK = exports.STACK_BY_APP_TYPE = exports.APP_TYPES = exports.LOCAL_STEERING_STACKS = exports.SUPPORTED_STACKS = exports.resolveStack = exports.renderTemplate = void 0;
 var template_1 = require("./template");
 Object.defineProperty(exports, "renderTemplate", { enumerable: true, get: function () { return template_1.renderTemplate; } });
 Object.defineProperty(exports, "resolveStack", { enumerable: true, get: function () { return template_1.resolveStack; } });
 Object.defineProperty(exports, "SUPPORTED_STACKS", { enumerable: true, get: function () { return template_1.SUPPORTED_STACKS; } });
+Object.defineProperty(exports, "LOCAL_STEERING_STACKS", { enumerable: true, get: function () { return template_1.LOCAL_STEERING_STACKS; } });
 Object.defineProperty(exports, "APP_TYPES", { enumerable: true, get: function () { return template_1.APP_TYPES; } });
 Object.defineProperty(exports, "STACK_BY_APP_TYPE", { enumerable: true, get: function () { return template_1.STACK_BY_APP_TYPE; } });
 Object.defineProperty(exports, "TEMPLATE_PACKAGE_BY_STACK", { enumerable: true, get: function () { return template_1.TEMPLATE_PACKAGE_BY_STACK; } });

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

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.APP_TYPES = exports.STACK_BY_APP_TYPE = exports.SUPPORTED_STACKS = exports.TEMPLATE_PINNED_VERSION_BY_STACK = exports.TEMPLATE_PACKAGE_BY_STACK = void 0;
+exports.APP_TYPES = exports.STACK_BY_APP_TYPE = exports.LOCAL_STEERING_STACKS = exports.SUPPORTED_STACKS = exports.TEMPLATE_PINNED_VERSION_BY_STACK = exports.TEMPLATE_PACKAGE_BY_STACK = void 0;
 exports.resolveStack = resolveStack;
 exports.renderTemplate = renderTemplate;
 const node_fs_1 = __importDefault(require("node:fs"));
@@ -27,6 +27,13 @@ exports.TEMPLATE_PACKAGE_BY_STACK = {
  */
 exports.TEMPLATE_PINNED_VERSION_BY_STACK = {};
 exports.SUPPORTED_STACKS = Object.keys(exports.TEMPLATE_PACKAGE_BY_STACK);
+/**
+ * 本地开发（非沙箱）需要落地 agent skills 脚手架（.claude/.agents）与 logs/ 的 stack 白名单。
+ * 只有这些全栈 / 前端框架栈在本地才需要 coding-steering 的 skills；html / design-html 是纯
+ * 静态 / 设计产物，本地无需这套脚手架，init 直接跳过 syncCodingSteering 与 logs 创建。
+ * 沙箱环境不受此白名单约束（所有栈照旧走 nested 同步，产出 .agent/）。
+ */
+exports.LOCAL_STEERING_STACKS = new Set(['nestjs-react-fullstack', 'vite-react']);
 /**
  * app_type（业务类型）→ stack 短名映射。仅在调用方未显式传 --template 时用于解析 stack。
  * 与 src/api/app/types.ts 的 AppType 枚举无关，是独立的业务类型概念。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.26",
+  "version": "0.1.27",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {