@lark-apaas/miaoda-cli 0.1.5-alpha.156c7a1 → 0.1.5-alpha.2f1e0ff

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

@@ -21,18 +21,33 @@ function registerSkillsCommands(program) {
 function registerSkillsSync(parent) {
     const cmd = parent
         .command('sync')
-        .description('同步 coding-steering（latest 或指定版本）到 .agent/steering/')
+        .description('同步 coding-steering（latest 或指定版本）到 user app')
         .argument('[version]', 'coding-steering 包版本或 dist-tag，缺省 latest')
         .option('--dir <path>', '项目目录，默认当前目录', '.')
+        .option('--local', '走本地 dev / agent 输出形态：拷到 .agents/skills 平铺 + 创建 .claude/skills 软链。' +
+        '不传时退回老形态：拷到 .agent/skills/steering/<stack>/skills/（跟沙箱端 update-skills.sh 对齐）', false)
         .addHelpText('after', `
 前置要求
   当前目录（或 --dir）已走过 'miaoda app init'（.spark/meta.json 含 stack）
 
+输出形态（--local 切换）
+  默认（不传 --local）：
+    .agent/skills/steering/<stack>/skills/<skill>/...
+    .agent/skills/steering/<stack>/tech.md
+    （老链路，沙箱端 update-skills.sh 也输出这套结构）
+
+  传 --local：
+    .agents/skills/<skill>/...      ← 平铺，无 stack 命名空间
+    .agents/tech.md
+    .claude/skills → ../.agents/skills（软链，让 Claude Code 识别同一份）
+
 JSON 输出
-  {"data": {"stack": "...", "version": "...", "syncedSkills": [...], "techSynced": true|false}}
+  {"data": {"stack": "...", "version": "...", "syncedSkills": [...], "techSynced": true|false,
+            "claudeSkillsLink": "created|updated|noop|conflict"  // 仅 --local 时}}
 
 示例
   $ miaoda skills sync
+  $ miaoda skills sync --local           # 本地 dev / agent 用
   $ miaoda skills sync 0.2.0
   $ miaoda skills sync --dir ./my-app
 `);
@@ -40,6 +55,7 @@ JSON 输出
         await (0, index_1.handleSkillsSync)({
             dir: rawOpts.dir,
             version,
+            local: rawOpts.local,
         });
     }));
 }

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

@@ -31,13 +31,13 @@ const logger_1 = require("../../../utils/logger");
  * 改这张表请同步把 user app 端到端 smoke 跑一次（init → sync → npm run dev）。
  */
 const PINNED_PLATFORM_VERSIONS = {
-    '@lark-apaas/express-core': '1.0.4-alpha.6',
-    '@lark-apaas/fullstack-nestjs-core': '1.1.52-alpha.0',
-    '@lark-apaas/fullstack-vite-preset': '1.0.24-alpha.8',
-    '@lark-apaas/http-client': '0.1.7-alpha.7',
-    '@lark-apaas/fullstack-cli': '1.1.48-alpha.8',
-    '@lark-apaas/fullstack-rspack-preset': '1.0.56-alpha.7',
-    '@lark-apaas/db-schema-sync': '0.1.6-alpha.0',
+    '@lark-apaas/express-core': '1.0.4-alpha.7',
+    '@lark-apaas/fullstack-nestjs-core': '1.1.52-alpha.1',
+    '@lark-apaas/fullstack-vite-preset': '1.0.24-alpha.9',
+    '@lark-apaas/http-client': '0.1.7-alpha.8',
+    '@lark-apaas/fullstack-cli': '1.1.49-alpha.0',
+    '@lark-apaas/fullstack-rspack-preset': '1.0.56-alpha.8',
+    '@lark-apaas/db-schema-sync': '0.1.6-alpha.2',
 };
 /**
  * miaoda app sync [--dir <path>]

package/dist/cli/handlers/skills/sync.js

@@ -32,6 +32,7 @@ async function handleSkillsSync(opts) {
         stack: meta.stack,
         targetDir,
         version,
+        outputLayout: opts.local === true ? 'flat' : 'nested',
     });
     (0, output_1.emit)({
         data: {
@@ -40,6 +41,9 @@ async function handleSkillsSync(opts) {
             versionSource,
             syncedSkills: result.syncedSkills,
             techSynced: result.techSynced,
+            ...(result.claudeSkillsLink !== undefined
+                ? { claudeSkillsLink: result.claudeSkillsLink }
+                : {}),
         },
     });
 }

package/dist/config/fullstack-cli-pin.js

@@ -14,4 +14,4 @@ exports.FULLSTACK_CLI_PIN_SPEC = void 0;
  *     **保持一致**（前者用于 user app dependencies dep bump，后者用于 npm script 里 npx 调用）
  *   - 一旦 latest fullstack-cli 稳定且 token 鉴权回归 OK，可以去掉版本钉，让 npx 走 latest
  */
-exports.FULLSTACK_CLI_PIN_SPEC = '@lark-apaas/fullstack-cli@1.1.48-alpha.7';
+exports.FULLSTACK_CLI_PIN_SPEC = '@lark-apaas/fullstack-cli@1.1.49-alpha.0';

package/dist/config/sync-configs/design-stack.js

@@ -86,7 +86,7 @@ exports.SYNC_CONFIG = {
             ifStartsWith: 'npm run upgrade && ',
         },
         // ===== miaoda-cli 本地开发新增规则 =====
-        // M1. scripts.dev:local —— 本地用户绕过 IS_SANDBOX 分发直接跑本地链路（npm run dev:local）。
+        // M1. scripts.dev:local —— 本地用户绕过 SANDBOX_ID 分发直接跑本地链路（npm run dev:local）。
         {
             type: 'add-script',
             name: 'dev:local',

package/dist/config/sync-configs/nestjs-react-fullstack.js

@@ -129,8 +129,9 @@ exports.SYNC_CONFIG = {
             ifStartsWith: 'concurrently ',
         },
         // 10. 把老 `npm run upgrade && ./scripts/dev.sh` 形式迁移到 `./scripts/dev.sh`，
-        //     让本地 `npm run dev` 不再前置跑 fullstack-cli sync；fullstack-cli sync 现在由
-        //     新版 dev.sh 内部按 IS_SANDBOX 分支决定是否跑（沙箱跑、本地跳）。
+        //     让本地 `npm run dev` 不再前置跑 fullstack-cli sync。新版 dev.sh 按 SANDBOX_ID 是否非空
+        //     判分支：沙箱直接 exec dev.js（脚本同步由平台 pod 启动时做过，dev 入口不再 upgrade）；
+        //     本地走 miaoda app sync 兜底 + dev-local.sh。
         {
             type: 'patch-script',
             name: 'dev',
@@ -153,8 +154,8 @@ exports.SYNC_CONFIG = {
             ifStartsWith: 'npx -y @lark-apaas/fullstack-cli sync',
         },
         // ===== miaoda-cli 本地开发新增规则（fullstack-cli sync 不会执行） =====
-        // M1. scripts.dev:local —— 本地用户绕过 IS_SANDBOX 分发直接跑本地链路（npm run dev:local）。
-        //     dev.sh 在 IS_SANDBOX 时跑 dev.js（沙箱保活）、否则 exec dev-local.sh；显式 dev:local
+        // M1. scripts.dev:local —— 本地用户绕过 SANDBOX_ID 分发直接跑本地链路（npm run dev:local）。
+        //     dev.sh 在 SANDBOX_ID 非空时跑 dev.js（沙箱保活）、否则 exec dev-local.sh；显式 dev:local
         //     用于 agent 在本地稳定调试，不受任何 env 影响。
         {
             type: 'add-script',

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

@@ -102,7 +102,22 @@ function extractZip(zipPath, targetDir, stdio) {
         });
     }
 }
+/**
+ * 显式钉死 npmmirror。原因：
+ *   - user 全局 `~/.npmrc` 千奇百怪（bnpm / npmjs / 自定义代理），npm config 层叠下
+ *     CLI flag 优先级最高，写在这里能盖掉所有上游配置，行为可预测。
+ *   - 模板 `_npmrc → .npmrc` 虽然项目级 registry 写得是 npmmirror，但只在 cwd 含 .npmrc
+ *     时才生效，env / CLI 层先到先得，落到这里钉死最稳。
+ *   - 字节内网 DNS 会把 npmmirror 域名透明指向公司镜像，外网就是公网阿里源；同一行配置
+ *     在两套环境都拉得到 @lark-apaas/* 私包（内网经公司镜像，外网经阿里同步过去的副本）。
+ *   - 留 `MIAODA_NPM_REGISTRY` env 应急覆盖。
+ */
+const NPM_INSTALL_REGISTRY_DEFAULT = 'https://registry.npmmirror.com/';
 function runNpmInstall(targetDir, stdio) {
     (0, logger_1.log)('init', `npm install in ${targetDir}...`);
-    (0, node_child_process_1.execFileSync)('npm', ['install', '--no-audit', '--no-fund'], { cwd: targetDir, stdio });
+    const registry = process.env.MIAODA_NPM_REGISTRY ?? NPM_INSTALL_REGISTRY_DEFAULT;
+    (0, node_child_process_1.execFileSync)('npm', ['install', '--no-audit', '--no-fund', '--registry', registry], {
+        cwd: targetDir,
+        stdio,
+    });
 }

package/dist/utils/coding-steering.js

@@ -14,15 +14,30 @@ const STEERING_PACKAGE = '@lark-apaas/coding-steering';
 // 用户显式传具体版本（如 `miaoda skills sync 0.2.0`）仍 override 这个默认值。
 // 升基线时：跑端到端 smoke（init → skills sync → 看 skills 内容）→ 改这个常量。
 const DEFAULT_PINNED_VERSION = '0.1.6-alpha.10';
+function inferMode() {
+    // process.env.SANDBOX_ID 非空 → 沙箱；其他（undefined / 空串）→ 本地
+    return process.env.SANDBOX_ID ? 'sandbox' : 'local';
+}
 /**
- * 把 coding-steering 包内 _common/skills + <stack>/skills + <stack>/skills_local 同步到
- * <targetDir>/.agent/steering/skills/。同名优先级 _common < <stack>/skills < <stack>/skills_local。
- * tech.md 存在时也同步到 .agent/steering/tech.md。
+ * 把 coding-steering 包内 <stack>/skills_common + 专有层（skills 或 skills_local）同步到
+ * user app。
+ *
+ * 包内目录约定（每个 stack 三层）：
+ *   <stack>/skills_common  → 沙箱 + 本地都下发的共有层
+ *   <stack>/skills         → 沙箱专有（沙箱端 update-skills.sh / SANDBOX_ID 非空时拿）
+ *   <stack>/skills_local   → 本地专有（本地 dev / agent 环境拿）
+ *
+ * 下发组合（mode）：
+ *   mode='sandbox' → skills_common + skills
+ *   mode='local'   → skills_common + skills_local
  *
- * skills_local 是 stack 的"本地变体"目录(方案 wiki WQ29w9d7pizhBmksWRIcEXzkndb):云端沙箱
- * 走另一条 update-skills.sh 链路只取 skills/，本地走 miaoda-cli 这条链路时叠加 skills_local
- * 覆盖同名 — 让 coding-guide / code-fix 这种"云端版含 ddl_sql / plugin_instance 等沙箱工具
- * 引用"的 skill 能在本地拿到去掉这些引用的本地变体。
+ * 目标路径形态（outputLayout）：
+ *   'nested' (默认，向后兼容)：拷到 .agent/skills/steering/<stack>/skills/，tech.md 同目录
+ *   'flat'：拷到 .agents/skills/（平铺），tech.md → .agents/tech.md，并创建 .claude/skills
+ *           软链指向 ../.agents/skills 让 Claude Code 识别同一份
+ *
+ * 同名 skill 覆盖顺序：common < 专有（专有覆盖 common 同名）。mode 缺省按 SANDBOX_ID env
+ * 推断（沙箱平台运行时注入应用所属沙箱 ID；空 / undefined 则视为本地）。
  *
  * 纯本地 atom（pull npm package + 拷贝文件），不属于任何 cli 域；放在 utils 让
  * app init handler 与独立 skills sync handler 都能复用。
@@ -30,7 +45,9 @@ const DEFAULT_PINNED_VERSION = '0.1.6-alpha.10';
 function syncCodingSteering(opts) {
     const logPrefix = opts.logPrefix ?? 'skills';
     const effectiveVersion = opts.version ?? DEFAULT_PINNED_VERSION;
-    (0, logger_1.log)(logPrefix, `Fetching ${STEERING_PACKAGE}@${effectiveVersion}...`);
+    const mode = opts.mode ?? inferMode();
+    const layout = opts.outputLayout ?? 'nested';
+    (0, logger_1.log)(logPrefix, `Fetching ${STEERING_PACKAGE}@${effectiveVersion} (mode=${mode}, layout=${layout})...`);
     const fetched = (0, npm_pack_1.fetchNpmPackage)({
         packageName: STEERING_PACKAGE,
         version: effectiveVersion,
@@ -38,25 +55,32 @@ function syncCodingSteering(opts) {
     try {
         const steeringRoot = node_path_1.default.join(fetched.extractDir, 'steering');
         const stackDir = node_path_1.default.join(steeringRoot, opts.stack);
-        const commonSkillsDir = node_path_1.default.join(steeringRoot, '_common', 'skills');
-        // steering 落到 .agent/skills/steering/<stack>/。.agent/skills/ 是 agent skills 的
-        // 公共容器，steering 是其中一个 producer，<stack> 再做命名空间隔离。内部仍保留
-        // 包内 steering/<stack>/skills/ 的结构，便于按"包内子目录 → 本地子目录"一一对应排查。
-        const dstRoot = node_path_1.default.join(opts.targetDir, '.agent', 'skills', 'steering', opts.stack);
-        const dstSkillsDir = node_path_1.default.join(dstRoot, 'skills');
+        // 目标路径按 layout 切：
+        //   nested → .agent/skills/steering/<stack>/{skills, tech.md}（老链路、stack 命名空间）
+        //   flat   → .agents/{skills, tech.md}（平铺，无 stack 命名空间，跟 .claude/skills 软链对齐）
+        const { dstSkillsDir, dstTechPath } = layout === 'flat'
+            ? {
+                dstSkillsDir: node_path_1.default.join(opts.targetDir, '.agents', 'skills'),
+                dstTechPath: node_path_1.default.join(opts.targetDir, '.agents', 'tech.md'),
+            }
+            : {
+                dstSkillsDir: node_path_1.default.join(opts.targetDir, '.agent', 'skills', 'steering', opts.stack, 'skills'),
+                dstTechPath: node_path_1.default.join(opts.targetDir, '.agent', 'skills', 'steering', opts.stack, 'tech.md'),
+            };
         node_fs_1.default.mkdirSync(dstSkillsDir, { recursive: true });
         let techSynced = false;
         const techSrc = node_path_1.default.join(stackDir, 'tech.md');
         if (node_fs_1.default.existsSync(techSrc)) {
-            node_fs_1.default.copyFileSync(techSrc, node_path_1.default.join(dstRoot, 'tech.md'));
+            node_fs_1.default.mkdirSync(node_path_1.default.dirname(dstTechPath), { recursive: true });
+            node_fs_1.default.copyFileSync(techSrc, dstTechPath);
             techSynced = true;
         }
         const synced = [];
-        // 顺序拷贝,后者覆盖前者:_common/skills → <stack>/skills → <stack>/skills_local
+        // 顺序拷贝，后者覆盖前者：skills_common 铺底，专有层（skills 或 skills_local）覆盖同名
+        const exclusiveLayer = mode === 'sandbox' ? 'skills' : 'skills_local';
         const layers = [
-            { dir: commonSkillsDir, label: '_common/skills' },
-            { dir: node_path_1.default.join(stackDir, 'skills'), label: `${opts.stack}/skills` },
-            { dir: node_path_1.default.join(stackDir, 'skills_local'), label: `${opts.stack}/skills_local` },
+            { dir: node_path_1.default.join(stackDir, 'skills_common'), label: `${opts.stack}/skills_common` },
+            { dir: node_path_1.default.join(stackDir, exclusiveLayer), label: `${opts.stack}/${exclusiveLayer}` },
         ];
         for (const layer of layers) {
             if (!node_fs_1.default.existsSync(layer.dir))
@@ -72,13 +96,64 @@ function syncCodingSteering(opts) {
                 synced.push(`${layer.label}/${name}`);
             }
         }
-        (0, logger_1.log)(logPrefix, `Synced ${String(synced.length)} skill(s), tech.md ${techSynced ? 'yes' : 'no'}`);
-        return { version: fetched.version, syncedSkills: synced, techSynced };
+        let claudeSkillsLink;
+        if (layout === 'flat') {
+            claudeSkillsLink = ensureClaudeSkillsSymlink(opts.targetDir, logPrefix);
+        }
+        (0, logger_1.log)(logPrefix, `Synced ${String(synced.length)} skill(s), tech.md ${techSynced ? 'yes' : 'no'} (mode=${mode}, layout=${layout})`);
+        return {
+            version: fetched.version,
+            syncedSkills: synced,
+            techSynced,
+            ...(claudeSkillsLink !== undefined ? { claudeSkillsLink } : {}),
+        };
     }
     finally {
         fetched.cleanup();
     }
 }
+/**
+ * flat layout 下创建 `<targetDir>/.claude/skills` 软链 → `../.agents/skills`，让 Claude Code
+ * 默认的 skills 加载路径跟 user app 的 .agents/skills 是同一份内容。
+ *
+ * 用相对路径软链（不是 absolute）—— user app 移动目录 / clone 到别处不会断链。
+ *
+ * 处理 4 种已有状态：
+ *   - 已是软链且指向对的：noop
+ *   - 已是软链但指错地方：删旧的，建新的（updated）
+ *   - 已是普通目录 / 文件：不覆盖，警告并跳过（conflict）—— 用户可能手动放了别的 skills
+ *   - 不存在：建新的（created）
+ */
+function ensureClaudeSkillsSymlink(targetDir, logPrefix) {
+    const linkPath = node_path_1.default.join(targetDir, '.claude', 'skills');
+    const linkTarget = node_path_1.default.join('..', '.agents', 'skills');
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(linkPath), { recursive: true });
+    let existing = null;
+    try {
+        existing = node_fs_1.default.lstatSync(linkPath);
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT')
+            throw err;
+    }
+    if (existing === null) {
+        node_fs_1.default.symlinkSync(linkTarget, linkPath, 'dir');
+        (0, logger_1.log)(logPrefix, `  ✓ .claude/skills → ${linkTarget} (symlink created)`);
+        return 'created';
+    }
+    if (existing.isSymbolicLink()) {
+        const current = node_fs_1.default.readlinkSync(linkPath);
+        if (current === linkTarget) {
+            return 'noop';
+        }
+        node_fs_1.default.unlinkSync(linkPath);
+        node_fs_1.default.symlinkSync(linkTarget, linkPath, 'dir');
+        (0, logger_1.log)(logPrefix, `  ✓ .claude/skills → ${linkTarget} (symlink updated, was → ${current})`);
+        return 'updated';
+    }
+    (0, logger_1.log)(logPrefix, `  ⚠ .claude/skills 已是普通目录/文件，跳过软链创建`);
+    return 'conflict';
+}
 function copyDir(src, dest) {
     node_fs_1.default.mkdirSync(dest, { recursive: true });
     for (const entry of node_fs_1.default.readdirSync(src, { withFileTypes: true })) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.5-alpha.156c7a1",
+  "version": "0.1.5-alpha.2f1e0ff",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {

package/upgrade/templates/design-stack/templates/scripts/dev.sh

@@ -1,17 +1,14 @@
 #!/usr/bin/env bash
-# `npm run dev` 入口；按 IS_SANDBOX 分发：
-#   - IS_SANDBOX=1（沙箱平台注入）→ 先 fullstack-cli sync 同步平台脚本，再跑 dev.js
-#       （保活 / restart loop / 文件日志 —— 沙箱生产形态）
-#   - 否则（本地）→ 跑 dev-local.sh：纯 stdout、崩了就崩、Agent 友好
-# 显式想跑本地路径可用 `npm run dev:local`（绕过 IS_SANDBOX）。
+# `npm run dev` 入口；按 SANDBOX_ID 是否非空判断运行环境：
+#   - SANDBOX_ID 非空（沙箱平台注入应用所属沙箱 ID）→ 直接跑 dev.js
+#       （保活 / restart loop / 文件日志 —— 沙箱生产形态）。脚本同步由平台 pod 启动阶段做过，
+#       dev 入口不再额外 `npm run upgrade`。
+#   - 否则（本地）→ 走 miaoda app sync 兜底 + 跑 dev-local.sh：纯 stdout、崩了就崩、Agent 友好。
+# 显式想跑本地路径可用 `npm run dev:local`（绕过 SANDBOX_ID 判断）。
 set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 
-if [ "${IS_SANDBOX:-}" = "1" ] || [ "${IS_SANDBOX:-}" = "true" ]; then
-  # 沙箱前置同步：fullstack-cli sync 把平台管控的 scripts/ + 部分 package.json 字段同步过来。
-  # 不直接调 `fullstack-cli`，走 `npm run upgrade` 享 package.json 里的入口定义（与 prepublish
-  # 之类的钩子一致）；后续若 upgrade 脚本换实现，dev 路径自动跟随。
-  npm run upgrade
+if [ -n "${SANDBOX_ID:-}" ]; then
   exec node "$SCRIPT_DIR/dev.js" "$@"
 fi
 
@@ -21,7 +18,7 @@ if [ ! -x "$SCRIPT_DIR/dev-local.sh" ]; then
 fi
 
 # 本地启动前先跑一次 miaoda app sync：同步 platform-controlled 内容 + 升 @lark-apaas/* 到
-# 钉版 + 迁移老 npm scripts。沙箱不走这里（IS_SANDBOX 分支已经 return）。
+# 钉版 + 迁移老 npm scripts。沙箱不走这里（SANDBOX_ID 分支已经 exec return）。
 # 走 npx 不依赖用户全局装 miaoda；钉到 @alpha dist-tag 跟随最新发布。
 npx -y @lark-apaas/miaoda-cli@alpha app sync || echo "[dev] miaoda app sync 失败，按现状继续" >&2
 

package/upgrade/templates/nestjs-react-fullstack/templates/scripts/dev.sh

@@ -1,17 +1,14 @@
 #!/usr/bin/env bash
-# `npm run dev` 入口；按 IS_SANDBOX 分发：
-#   - IS_SANDBOX=1（沙箱平台注入）→ 先 fullstack-cli sync 同步平台脚本，再跑 dev.js
-#       （保活 / restart loop / 文件日志 —— 沙箱生产形态）
-#   - 否则（本地）→ 跑 dev-local.sh：纯 stdout、崩了就崩、Agent 友好
-# 显式想跑本地路径可用 `npm run dev:local`（绕过 IS_SANDBOX）。
+# `npm run dev` 入口；按 SANDBOX_ID 是否非空判断运行环境：
+#   - SANDBOX_ID 非空（沙箱平台注入应用所属沙箱 ID）→ 直接跑 dev.js
+#       （保活 / restart loop / 文件日志 —— 沙箱生产形态）。脚本同步由平台 pod 启动阶段做过，
+#       dev 入口不再额外 `npm run upgrade`。
+#   - 否则（本地）→ 走 miaoda app sync 兜底 + 跑 dev-local.sh：纯 stdout、崩了就崩、Agent 友好。
+# 显式想跑本地路径可用 `npm run dev:local`（绕过 SANDBOX_ID 判断）。
 set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 
-if [ "${IS_SANDBOX:-}" = "1" ] || [ "${IS_SANDBOX:-}" = "true" ]; then
-  # 沙箱前置同步：fullstack-cli sync 把平台管控的 scripts/ + 部分 package.json 字段同步过来。
-  # 不直接调 `fullstack-cli`，走 `npm run upgrade` 享 package.json 里的入口定义（与 prepublish
-  # 之类的钩子一致）；后续若 upgrade 脚本换实现，dev 路径自动跟随。
-  npm run upgrade
+if [ -n "${SANDBOX_ID:-}" ]; then
   exec node "$SCRIPT_DIR/dev.js" "$@"
 fi
 
@@ -21,7 +18,7 @@ if [ ! -x "$SCRIPT_DIR/dev-local.sh" ]; then
 fi
 
 # 本地启动前先跑一次 miaoda app sync：同步 platform-controlled 内容 + 升 @lark-apaas/* 到
-# 钉版 + 迁移老 npm scripts。沙箱不走这里（IS_SANDBOX 分支已经 return）。
+# 钉版 + 迁移老 npm scripts。沙箱不走这里（SANDBOX_ID 分支已经 exec return）。
 # 走 npx 不依赖用户全局装 miaoda；钉到 @alpha dist-tag 跟随最新发布。
 npx -y @lark-apaas/miaoda-cli@alpha app sync || echo "[dev] miaoda app sync 失败，按现状继续" >&2
 

package/upgrade/templates/nestjs-react-fullstack/templates/tsconfig.node.json

@@ -1,5 +1,5 @@
 {
-  "watchOptions": {
+  "compilerOptions": {
     "preserveWatchOutput": true
   }
 }