@lark-apaas/miaoda-cli 0.1.5-alpha.156c7a1 → 0.1.5-beta.27ede41

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

@@ -6,7 +6,7 @@ const index_1 = require("../../../cli/handlers/app/index");
 const error_1 = require("../../../utils/error");
 function registerAppCommands(program, opts = {}) {
     const description = opts.includeInit
-        ? '应用元数据管理：查看 / 修改 / 初始化 / 升级平台资产'
+        ? '应用元数据管理：查看 / 修改 / 初始化'
         : '应用元数据管理：查看 / 修改';
     const appCmd = program.command('app').description(description);
     appCmd.action(() => {
@@ -21,57 +21,8 @@ function registerAppCommands(program, opts = {}) {
     registerAppUpdate(appCmd);
     if (opts.includeInit) {
         registerAppInit(appCmd);
-        registerAppSync(appCmd);
     }
 }
-function registerAppSync(parent) {
-    const cmd = parent
-        .command('sync')
-        .alias('upgrade')
-        .description('一站式同步：按 stack 的 SyncRule 全套 apply + 按钉死版本表升 @lark-apaas/* deps + npm install')
-        .option('--dir <path>', '项目目录，默认 cwd（需含 .spark/meta.json）')
-        .addHelpText('after', `
-别名
-  miaoda app sync 与 miaoda app upgrade 等价（upgrade 是历史别名，新调用方请用 sync）。
-
-流程
-  1. 按 stack 的 SyncRule[] 全套 apply（src/config/sync-configs/<stack>.ts 定义）：
-       directory      → 整个目录拷贝（.sh 自动 +x）
-       file           → 单文件覆盖（可选 onlyIfExists / overwrite）
-       merge-json     → JSON deep merge（可选 arrayMerge by key 去重）
-       add-script     → npm script 不存在时添加（overwrite=false 默认不覆盖）
-       patch-script   → npm script 以指定前缀开头时改写（守护用户自定义）
-       add-line       → 行不存在时追加到文件
-       remove-line    → 行存在时移除
-       delete-file/delete-directory → 删除
-     沙箱里跑的 fullstack-cli sync 走同一套 rule 类型，行为对齐；miaoda app sync 在此之上
-     补 dev:local 等本地开发独有规则。
-  2. 平台 deps 钉版本：按 handlers/app/sync.ts 里 PINNED_PLATFORM_VERSIONS 升 user app 已装的
-     @lark-apaas/* 包；表外 / 未装的不动。
-  3. activateGitHooks：core.hooksPath 一次性指向 .githooks/。
-  4. npm install --no-audit --no-fund --ignore-scripts。--ignore-scripts 是为绕开
-     action-plugin postinstall 在 npm install 时缺平台 env 的卡点（需要时再
-     FORCE_AUTHN_INNERAPI_DOMAIN=... npm install 手动跑一次）。
-
-JSON 输出
-  {"data": {"stack": "...",
-            "appliedRules": [{"type": "...", "action": "...", "path": "...", "detail": "..."}],
-            "syncedFiles": [...],
-            "mergedJsonFiles": [{"path": "...", "keys": [...]}],
-            "patchedScripts": [...],
-            "upgradedPackages": [{"name": "...", "from": "...", "to": "...", "section": "..."}]}}
-
-示例
-  $ miaoda app sync
-  $ miaoda app sync --dir /path/to/app
-  $ miaoda app upgrade        # 等价于 miaoda app sync
-`);
-    cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
-        await (0, index_1.handleAppSync)({
-            dir: rawOpts.dir,
-        });
-    }));
-}
 function registerAppGet(parent) {
     const cmd = parent
         .command('get')
@@ -119,28 +70,20 @@ JSON 输出
 function registerAppInit(parent) {
     const cmd = parent
         .command('init')
-        .description('初始化应用代码：抓 template 渲染、同步 upgrade/templates、装 .agent/steering/ skills、写 .spark/meta.json。.spark/meta.json 已存在则直接退出')
+        .description('初始化应用代码：抓 template 渲染、装 .agent/steering/ skills、写 .spark/meta.json。.spark/meta.json 已存在则直接退出')
         .option('--template <stack>', `技术栈短名（${index_1.SUPPORTED_STACKS.join(' / ')}）`)
         .option('--conf <json>', 'init 配置 JSON。支持 {"version": "<template 版本>"} / {"steeringVersion": "<steering 版本>"}，均默认 latest')
         .option('--skip-install', '跳过依赖安装', false)
-        .addOption((0, shared_1.appIdOption)())
         .addHelpText('after', `
 幂等
   .spark/meta.json 已存在时直接退出（initialized=false, reason=already_initialized），
-  不再触发 template 渲染、不重新跑 upgrade/templates 同步、不重新拉 skills、不安装依赖。
+  不再触发 template 渲染、不重新拉 skills、不安装依赖。
   meta.json 在 init 流程最后才写，写了 = 已完整成功一次；
   上一次失败留下半渲染状态时（package.json 在但 meta.json 没在）允许重跑。
 
-应用身份（app_id）
-  --app-id <id>（或 MIAODA_APP_ID env）提供时写入 .spark/meta.json 的 app_id 字段；
-  未提供则不写。运行端命令（deploy / file / plugin 等）仍优先读 MIAODA_APP_ID env，
-  env 未设置时回退到 meta.json.app_id。
-
-平台同步（upgrade/templates）
-  init 内嵌一次 upgrade/templates 同步（跟 app upgrade 共用同一份 util）：
-  从 miaoda-cli 自带的 upgrade/templates/<stack>/ 同步 files/（覆盖）+ patches/
-  （JSON deep merge，含 scripts.dev:local 等）。目标 stack 未纳入 upgrade/templates/
-  时跳过（不报错）。后续要升 @lark-apaas/* 平台包到最新 alpha，跑 'miaoda app upgrade'。
+应用身份（appId）
+  init 不再持久化 appId。运行端命令（deploy / file / plugin 等）始终从 MIAODA_APP_ID env 读，
+  init 阶段也无需感知 appId。
 
 依赖安装
   默认：npm install --no-audit --no-fund
@@ -154,12 +97,10 @@ function registerAppInit(parent) {
 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": "...", ...}}
 
 示例
   $ 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-alpha.1"}'
   $ miaoda app init --template vite-react --conf '{"steeringVersion": "0.1.0"}'
   $ miaoda app init --template vite-react --skip-install
@@ -171,7 +112,6 @@ JSON 输出
             template: rawOpts.template,
             conf,
             skipInstall: rawOpts.skipInstall,
-            appId: rawOpts.appId,
         });
     }));
 }

package/dist/cli/commands/index.js

@@ -9,59 +9,24 @@ const index_4 = require("../../cli/commands/app/index");
 const index_5 = require("../../cli/commands/deploy/index");
 const modern_1 = require("../../cli/commands/deploy/modern");
 const index_6 = require("../../cli/commands/skills/index");
-// scene 跟 dispatcher(MIAODA_APP_TYPE)同语义层级 —— app 业务类型维度,
-// 对齐后端 devops app_common.AppType 枚举:
-//   3 = AppType_APPLICATION(全栈应用,当前仅 nestjs-react-fullstack 一个 stack)
-//   4 = AppType_DESIGN(design-stack,SSR 渲染、无业务逻辑、无数据库)
-//   7 = miaoda-cli 自定义 modern 占位(后端枚举无 7,沙箱目前不传)
-//   其它(0/1/2/5/6 / 未设)→ default(命令全开,本地 dev / CI / 兼容回退)
-// stack 维度(nestjs-react-fullstack / vite-react / ...)是正交的,
-// skills sync 内部按 .spark/meta.json.stack 拉对应 coding-steering/steering/<stack>/ 子目录。
 function resolveScene(appType, _archType) {
     if (appType === '7')
         return 'modern';
-    if (appType === '3')
-        return 'application';
-    if (appType === '4')
-        return 'design';
     return 'default';
 }
 const SCENE_REGISTRARS = {
     default: (p) => {
-        // init / upgrade / skills 都挂出来：本地用户不需要 export MIAODA_APP_TYPE=3
-        // 就能跑 `miaoda app init` / `miaoda app upgrade` / `miaoda skills sync`。
-        // 其它 scene 的差异（design 裁 db/file，modern 拆 deploy）仍按 MIAODA_APP_TYPE 路由
-        (0, index_4.registerAppCommands)(p, { includeInit: true });
+        (0, index_4.registerAppCommands)(p);
         (0, index_5.registerDeployCommands)(p);
         (0, index_2.registerDbCommands)(p);
         (0, index_1.registerFileCommands)(p);
         (0, index_3.registerObservabilityCommands)(p);
-        (0, index_6.registerSkillsCommands)(p);
     },
     modern: (p) => {
         (0, index_4.registerAppCommands)(p, { includeInit: true });
         (0, modern_1.registerDeployCommandsModern)(p);
         (0, index_6.registerSkillsCommands)(p);
     },
-    // application scene(AppType_APPLICATION=3):
-    // 在 default 命令集基础上加 skills(按 meta.json.stack 拉对应 stack 技能)
-    // + app init(新一代应用走 init 写 .spark/meta.json)
-    application: (p) => {
-        (0, index_4.registerAppCommands)(p, { includeInit: true });
-        (0, index_5.registerDeployCommands)(p);
-        (0, index_2.registerDbCommands)(p);
-        (0, index_1.registerFileCommands)(p);
-        (0, index_3.registerObservabilityCommands)(p);
-        (0, index_6.registerSkillsCommands)(p);
-    },
-    // design scene(AppType_DESIGN=4):design-stack 仅 SSR 渲染、无后端业务逻辑、
-    // 无数据库、无 UGC 文件。命令集裁掉 db / file,保留 deploy / observability / app(init) / skills。
-    design: (p) => {
-        (0, index_4.registerAppCommands)(p, { includeInit: true });
-        (0, index_5.registerDeployCommands)(p);
-        (0, index_3.registerObservabilityCommands)(p);
-        (0, index_6.registerSkillsCommands)(p);
-    },
 };
 function readEnv(name) {
     const v = process.env[name]?.trim();

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

@@ -1,15 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SUPPORTED_STACKS = exports.handleAppUpgrade = exports.handleAppSync = exports.handleAppInit = exports.handleAppUpdate = exports.handleAppGet = void 0;
+exports.SUPPORTED_STACKS = exports.handleAppInit = exports.handleAppUpdate = exports.handleAppGet = void 0;
 var get_1 = require("./get");
 Object.defineProperty(exports, "handleAppGet", { enumerable: true, get: function () { return get_1.handleAppGet; } });
 var update_1 = require("./update");
 Object.defineProperty(exports, "handleAppUpdate", { enumerable: true, get: function () { return update_1.handleAppUpdate; } });
 var init_1 = require("./init");
 Object.defineProperty(exports, "handleAppInit", { enumerable: true, get: function () { return init_1.handleAppInit; } });
-var sync_1 = require("./sync");
-Object.defineProperty(exports, "handleAppSync", { enumerable: true, get: function () { return sync_1.handleAppSync; } });
-Object.defineProperty(exports, "handleAppUpgrade", { enumerable: true, get: function () { return sync_1.handleAppUpgrade; } });
 // commands 层渲染 help 时需要这份枚举；从 handler barrel 转发，避免 commands → services 越界
 var index_1 = require("../../../services/app/init/index");
 Object.defineProperty(exports, "SUPPORTED_STACKS", { enumerable: true, get: function () { return index_1.SUPPORTED_STACKS; } });

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

@@ -8,17 +8,13 @@ const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const index_1 = require("../../../services/app/init/index");
 const coding_steering_1 = require("../../../utils/coding-steering");
-const logger_1 = require("../../../utils/logger");
-const githooks_1 = require("../../../utils/githooks");
-const sync_1 = require("../../../cli/handlers/app/sync");
 const error_1 = require("../../../utils/error");
 const output_1 = require("../../../utils/output");
 /**
  * miaoda app init
  *
- * 一站式本地脚手架：render template → upgrade/templates sync → skills sync → install deps，把
- * {stack, version, archType, app_id?} 写入 .spark/meta.json。--app-id（或 MIAODA_APP_ID）提供时
- * 持久化 app_id；运行端命令仍优先读 env，未设置时回退到 meta.json。
+ * 只负责本地脚手架：render template、sync skills、install deps，把 {stack, version, archType}
+ * 写入 .spark/meta.json。appId 不在此处持久化——deploy 等运行端通过 MIAODA_APP_ID env 拿。
  *
  * 幂等：.spark/meta.json 存在即表示已完整成功一次，直接退出，不重跑任何子步骤。
  * 半渲染状态（package.json 在但 meta.json 不在）会重新跑完整流程。
@@ -54,52 +50,24 @@ async function handleAppInit(opts) {
     const version = opts.conf?.version;
     const projectName = node_path_1.default.basename(targetDir);
     const tplResult = (0, index_1.renderTemplate)({ stack, version, targetDir, projectName });
-    // sync 紧跟 template 渲染之后，赶在 install 之前：
-    // 这样 directory / merge-json / add-script 等 rule 都已落地，install 出来的 lockfile
-    // 与最终态对齐；patches 还能覆盖 template 提供的同名文件。
-    const syncRunResult = (0, sync_1.runStackSync)(stack, targetDir, 'init');
-    const syncSummary = (0, sync_1.summarizeSyncResults)(syncRunResult);
-    // template 渲染下来的 @lark-apaas/* 版本可能落后 PINNED 表，赶在 install 之前钉到表版本，
-    // 这样一次 npm install 就直接装最终版本，不需要 install 完再补一遍。
-    const upgradedPackages = (0, sync_1.upgradePlatformDeps)(targetDir, 'init');
-    // skills 同步软失败：拉不到 coding-steering 包不该阻断 writeSparkMeta /
-    // activateGitHooks（之前会让 .spark/meta.json 没写，下次 init 半渲染状态又得重跑全套）。
-    let steeringResult;
-    let steeringError;
-    try {
-        steeringResult = (0, coding_steering_1.syncCodingSteering)({
-            stack,
-            targetDir,
-            version: opts.conf?.steeringVersion,
-            logPrefix: 'init',
-        });
-    }
-    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 };
-    }
+    const steeringResult = (0, coding_steering_1.syncCodingSteering)({
+        stack,
+        targetDir,
+        version: opts.conf?.steeringVersion,
+        logPrefix: 'init',
+    });
     const 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, {
         stack,
         version: tplResult.version,
         archType: tplResult.archType,
-        app_id: opts.appId,
-        steeringVersion: steeringResult.version,
     });
-    const syncedSummary = syncRunResult.stackFound
-        ? syncRunResult.rulesApplied.length > 0
-            ? `${syncRunResult.rulesApplied.length.toString()} rule(s)`
-            : 'legacy'
-        : 'skipped';
     if (!(0, output_1.isJsonMode)()) {
-        process.stdout.write(`✓ Initialized ${stack} (template ${tplResult.version}, steering ${steeringResult.version}, sync ${syncedSummary}, install ${installResult.source}) in ${targetDir}\n`);
+        process.stdout.write(`✓ Initialized ${stack} (template ${tplResult.version}, steering ${steeringResult.version}, install ${installResult.source}) in ${targetDir}\n`);
     }
     (0, output_1.emit)({
         data: {
@@ -109,24 +77,12 @@ async function handleAppInit(opts) {
             templateVersion: tplResult.version,
             steeringVersion: steeringResult.version,
             archType: tplResult.archType,
-            appId: opts.appId,
             syncedSkills: steeringResult.syncedSkills,
             techSynced: steeringResult.techSynced,
-            steeringError,
-            // sync 流程的产出：rule-driven 时 appliedRules + 一系列汇总字段；fallback 到旧 platform-sync
-            // 时只填 platformSyncedFiles / platformMergedJsonFiles；stack 不识别时全空且 platformStackFound=false。
-            platformStackFound: syncRunResult.stackFound,
-            appliedRules: syncSummary.appliedRules,
-            platformSyncedFiles: syncSummary.syncedFiles,
-            platformMergedJsonFiles: syncSummary.mergedJsonFiles,
-            patchedScripts: syncSummary.patchedScripts,
-            upgradedPackages,
-            gitHooks: hookActivation.action,
             installed: installResult.installed,
             installSource: installResult.source,
             installHash: installResult.hash,
             cacheZip: installResult.cacheZip,
-            installError: installResult.error,
         },
     });
 }

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

@@ -10,10 +10,10 @@ const spark_meta_1 = require("../../../utils/spark-meta");
 const error_1 = require("../../../utils/error");
 const output_1 = require("../../../utils/output");
 /**
- * miaoda skills sync [version] [--dir <path>]
+ * miaoda skills sync [--dir <path>] [--version <ver>]
  *
- * 从 .spark/meta.json 读 stack（+ 默认 steeringVersion），把 coding-steering 包内对应 stack
- * 的 skills + tech.md 同步到 <dir>/.agent/steering/。需要先跑过 `miaoda app init`。
+ * 从 .spark/meta.json 读 stack，把 coding-steering 包内对应 stack 的 skills + tech.md
+ * 同步到 <dir>/.agent/steering/。需要先跑过 `miaoda app init`。
  */
 async function handleSkillsSync(opts) {
     await Promise.resolve();
@@ -22,22 +22,15 @@ async function handleSkillsSync(opts) {
     if (meta.stack === undefined || meta.stack === '') {
         throw new error_1.AppError('SKILLS_META_INCOMPLETE', '.spark/meta.json missing stack — run `miaoda app init` first');
     }
-    const version = opts.version ?? meta.steeringVersion;
-    const versionSource = opts.version
-        ? 'cli-arg'
-        : meta.steeringVersion
-            ? 'meta.json'
-            : 'default-latest';
     const result = (0, coding_steering_1.syncCodingSteering)({
         stack: meta.stack,
         targetDir,
-        version,
+        version: opts.version,
     });
     (0, output_1.emit)({
         data: {
             stack: meta.stack,
             version: result.version,
-            versionSource,
             syncedSkills: result.syncedSkills,
             techSynced: result.techSynced,
         },

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

@@ -44,31 +44,18 @@ function installDependencies(opts) {
                 return { installed: true, source: 'cache', hash, cacheZip };
             }
             (0, logger_1.log)('init', 'Cache zip extracted but node_modules/ missing or empty; falling back to npm install');
-            return runInstallSoft(opts.targetDir, childStdio, hash);
+            runNpmInstall(opts.targetDir, childStdio);
+            return { installed: true, source: 'npm', hash };
         }
         (0, logger_1.log)('init', `Cache miss for ${hash}.zip, falling back to npm install`);
-        return runInstallSoft(opts.targetDir, childStdio, hash);
+        runNpmInstall(opts.targetDir, childStdio);
+        return { installed: true, source: 'npm', hash };
     }
     if (cacheDir && !hasPkg) {
         (0, logger_1.log)('init', `${DEP_CACHE_ENV} set but no package.json in target; running npm install`);
     }
-    return runInstallSoft(opts.targetDir, childStdio);
-}
-/**
- * 跑 npm install；失败不抛错，返回 source='failed' 让上层 init handler 继续走 writeSparkMeta
- * 等后续步骤（避免 install 挂了 .spark/meta.json 没写出来，下次 init 看到半渲染状态又得重跑全套）。
- * 失败信息通过 stderr 直出 + emit data.installError 透传给用户。
- */
-function runInstallSoft(targetDir, stdio, hash) {
-    try {
-        runNpmInstall(targetDir, stdio);
-        return { installed: true, source: 'npm', hash };
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        (0, logger_1.log)('init', `⚠ npm install failed (continuing init): ${msg}`);
-        return { installed: false, source: 'failed', hash, error: msg };
-    }
+    runNpmInstall(opts.targetDir, childStdio);
+    return { installed: true, source: 'npm' };
 }
 function nodeModulesUsable(targetDir) {
     const nm = node_path_1.default.join(targetDir, 'node_modules');
@@ -104,5 +91,11 @@ function extractZip(zipPath, targetDir, stdio) {
 }
 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 });
+    try {
+        (0, node_child_process_1.execFileSync)('npm', ['install', '--no-audit', '--no-fund'], { cwd: targetDir, stdio });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new error_1.AppError('NPM_INSTALL_FAILED', `npm install 失败: ${msg}`);
+    }
 }

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.SUPPORTED_STACKS = exports.TEMPLATE_PINNED_VERSION_BY_STACK = exports.TEMPLATE_PACKAGE_BY_STACK = void 0;
+exports.SUPPORTED_STACKS = exports.TEMPLATE_PACKAGE_BY_STACK = void 0;
 exports.renderTemplate = renderTemplate;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
@@ -14,28 +14,13 @@ const logger_1 = require("../../../utils/logger");
 exports.TEMPLATE_PACKAGE_BY_STACK = {
     'vite-react': '@lark-apaas/coding-template-vite-react',
     html: '@lark-apaas/coding-template-html',
-    'nestjs-react-fullstack': '@lark-apaas/coding-template-nestjs-react-fullstack',
-};
-/**
- * 短名 → template 包钉死版本。renderTemplate 默认按这张表取版本号，表外 stack 走 npm latest。
- *
- * 钉死稳定版本而非跟 alpha dist-tag —— alpha 通道被多团队共享，外部 prerelease 时常打过去，
- * 自动跟 alpha 会把回归版本拉进 user app。每次升基线人工 review 一次再改这里。
- * 用户显式传 `--conf '{"version": "..."}'` 仍 override 此默认值。
- */
-exports.TEMPLATE_PINNED_VERSION_BY_STACK = {
-    'nestjs-react-fullstack': '0.1.0-alpha.5',
-    // vite-react / html 暂不钉版，跟 latest dist-tag（新版正常迭代后再纳入钉版）
 };
 exports.SUPPORTED_STACKS = Object.keys(exports.TEMPLATE_PACKAGE_BY_STACK);
-// template/ 内以下划线开头的占位文件名在渲染时改名。
-// 原因：
-//   1. npm pack 强制剥的：.npmrc（防 auth token 泄露）
-//   2. 沙箱平台特殊处理的：.gitignore（避免与平台仓库 .gitignore 冲突）
-// .env 通过 negation pattern 例外直接 ship；.env.local 完全由 lark-cli +env-pull
-// 运行时下发，模板里不再放占位文件。
+// template/ 内以下划线开头的占位文件名在渲染时改名（npm publish 会把 .gitignore / .npmrc 吞掉，
+// 模板里用 _gitignore / _npmrc 提交，渲染时再改回）。
 const RENAME_FILES = {
     _gitignore: '.gitignore',
+    '_env.local': '.env.local',
     _npmrc: '.npmrc',
 };
 function renderTemplate(opts) {
@@ -45,14 +30,8 @@ function renderTemplate(opts) {
             next_actions: [`可用 stack：${exports.SUPPORTED_STACKS.join(', ')}`],
         });
     }
-    // 默认按 TEMPLATE_PINNED_VERSION_BY_STACK 取钉版（避免 npm latest 碰外部 prerelease 回归）；
-    // 表外 stack fallback 到 'latest'；用户显式传 --conf.version 仍 override 钉版。
-    const pinned = Object.prototype.hasOwnProperty.call(exports.TEMPLATE_PINNED_VERSION_BY_STACK, opts.stack)
-        ? exports.TEMPLATE_PINNED_VERSION_BY_STACK[opts.stack]
-        : undefined;
-    const effectiveVersion = opts.version ?? pinned ?? 'latest';
-    (0, logger_1.log)('init', `Fetching ${packageName}@${effectiveVersion}...`);
-    const fetched = (0, npm_pack_1.fetchNpmPackage)({ packageName, version: effectiveVersion });
+    (0, logger_1.log)('init', `Fetching ${packageName}@${opts.version ?? 'latest'}...`);
+    const fetched = (0, npm_pack_1.fetchNpmPackage)({ packageName, version: opts.version });
     try {
         const templateDir = node_path_1.default.join(fetched.extractDir, 'template');
         if (!node_fs_1.default.existsSync(templateDir)) {

package/dist/utils/coding-steering.js

@@ -9,31 +9,19 @@ const node_path_1 = __importDefault(require("node:path"));
 const npm_pack_1 = require("../utils/npm-pack");
 const logger_1 = require("../utils/logger");
 const STEERING_PACKAGE = '@lark-apaas/coding-steering';
-// 钉死稳定 alpha 版本而非跟 `alpha` dist-tag —— alpha 通道被多个团队共享，外部 prerelease
-// 时常打过去，自动跟 alpha 会把回归版本拉进 user app。维护这个常量比维护 alpha 通道可控。
-// 用户显式传具体版本（如 `miaoda skills sync 0.2.0`）仍 override 这个默认值。
-// 升基线时：跑端到端 smoke（init → skills sync → 看 skills 内容）→ 改这个常量。
-const DEFAULT_PINNED_VERSION = '0.1.6-alpha.10';
 /**
- * 把 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。
- *
- * skills_local 是 stack 的"本地变体"目录(方案 wiki WQ29w9d7pizhBmksWRIcEXzkndb):云端沙箱
- * 走另一条 update-skills.sh 链路只取 skills/，本地走 miaoda-cli 这条链路时叠加 skills_local
- * 覆盖同名 — 让 coding-guide / code-fix 这种"云端版含 ddl_sql / plugin_instance 等沙箱工具
- * 引用"的 skill 能在本地拿到去掉这些引用的本地变体。
+ * 把 coding-steering 包内 _common/skills + <stack>/skills 同步到 <targetDir>/.agent/steering/skills/，
+ * 同名 stack 子目录覆盖 _common。tech.md 存在时也同步到 .agent/steering/tech.md。
  *
  * 纯本地 atom（pull npm package + 拷贝文件），不属于任何 cli 域；放在 utils 让
  * app init handler 与独立 skills sync handler 都能复用。
  */
 function syncCodingSteering(opts) {
     const logPrefix = opts.logPrefix ?? 'skills';
-    const effectiveVersion = opts.version ?? DEFAULT_PINNED_VERSION;
-    (0, logger_1.log)(logPrefix, `Fetching ${STEERING_PACKAGE}@${effectiveVersion}...`);
+    (0, logger_1.log)(logPrefix, `Fetching ${STEERING_PACKAGE}@${opts.version ?? 'latest'}...`);
     const fetched = (0, npm_pack_1.fetchNpmPackage)({
         packageName: STEERING_PACKAGE,
-        version: effectiveVersion,
+        version: opts.version,
     });
     try {
         const steeringRoot = node_path_1.default.join(fetched.extractDir, 'steering');
@@ -52,24 +40,27 @@ function syncCodingSteering(opts) {
             techSynced = true;
         }
         const synced = [];
-        // 顺序拷贝,后者覆盖前者:_common/skills → <stack>/skills → <stack>/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` },
-        ];
-        for (const layer of layers) {
-            if (!node_fs_1.default.existsSync(layer.dir))
-                continue;
-            for (const name of node_fs_1.default.readdirSync(layer.dir)) {
-                const src = node_path_1.default.join(layer.dir, name);
+        // 先拷 _common/skills/，再拷 <stack>/skills/。stack 同名覆盖 common
+        if (node_fs_1.default.existsSync(commonSkillsDir)) {
+            for (const name of node_fs_1.default.readdirSync(commonSkillsDir)) {
+                const src = node_path_1.default.join(commonSkillsDir, name);
+                if (!node_fs_1.default.statSync(src).isDirectory())
+                    continue;
+                copyDir(src, node_path_1.default.join(dstSkillsDir, name));
+                synced.push(`_common/skills/${name}`);
+            }
+        }
+        const stackSkillsDir = node_path_1.default.join(stackDir, 'skills');
+        if (node_fs_1.default.existsSync(stackSkillsDir)) {
+            for (const name of node_fs_1.default.readdirSync(stackSkillsDir)) {
+                const src = node_path_1.default.join(stackSkillsDir, name);
                 if (!node_fs_1.default.statSync(src).isDirectory())
                     continue;
                 const dst = node_path_1.default.join(dstSkillsDir, name);
                 if (node_fs_1.default.existsSync(dst))
                     node_fs_1.default.rmSync(dst, { recursive: true, force: true });
                 copyDir(src, dst);
-                synced.push(`${layer.label}/${name}`);
+                synced.push(`${opts.stack}/skills/${name}`);
             }
         }
         (0, logger_1.log)(logPrefix, `Synced ${String(synced.length)} skill(s), tech.md ${techSynced ? 'yes' : 'no'}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.5-alpha.156c7a1",
+  "version": "0.1.5-beta.27ede41",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {
@@ -10,11 +10,10 @@
     "access": "public"
   },
   "files": [
-    "LICENSE",
-    "README.md",
     "bin",
     "dist",
-    "upgrade"
+    "README.md",
+    "LICENSE"
   ],
   "keywords": [
     "miaoda",
@@ -28,7 +27,6 @@
   "dependencies": {
     "@lark-apaas/http-client": "^0.1.5",
     "commander": "^13.1.0",
-    "jsonc-parser": "^3.3.1",
     "ora": "^5.4.1",
     "picocolors": "^1.1.1"
   },