@lark-apaas/miaoda-cli 0.1.4-alpha.abaa17f → 0.1.4-alpha.dbe45ea

package/README.md

@@ -54,7 +54,7 @@ miaoda file ls --output json
 ## 环境变量
 
 - `MIAODA_APP_ID`：默认应用 ID，等价于 `--app-id`。
-- `MIAODA_CANARY_HEADER`：设置后所有 HTTP 请求自动带上 `x-tt-env: <值>` 小流量头（例：`export MIAODA_CANARY_HEADER=boe_xxx`）。
+- `MIAODA_CANARY_HEADER`：HTTP 请求的 `x-tt-env` 小流量头取值。未设置时默认 `boe_miaoda_doubao`；设为空字符串则不带该头（例：`export MIAODA_CANARY_HEADER=boe_xxx`）。值形如 `ppe_xxx` 时额外带上 `x-use-ppe: 1`。
 
 ## 输出契约
 

package/dist/api/deploy/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NodeStatus = exports.nodeStatusFromText = exports.nodeStatusText = exports.errorJobSchema = exports.deployGetSchema = exports.deployHistorySchema = exports.batchSavePluginInstances = exports.LocalReleaseStatus = exports.getModernLastPublishedVersion = exports.getModernReleaseStatus = exports.createModernRelease = exports.updateLocalRelease = exports.createLocalRelease = exports.preRelease = exports.queryPipelineInstance = exports.getErrorLog = exports.listPipelineInstances = exports.createRelease = void 0;
+exports.NodeStatus = exports.nodeStatusFromText = exports.nodeStatusText = exports.errorJobSchema = exports.deployGetSchema = exports.deployHistorySchema = exports.batchSavePluginInstances = exports.LocalReleaseStatus = exports.getModernLastPublishedVersion = exports.getModernReleaseStatus = exports.createModernRelease = exports.callbackStatic = exports.updateLocalRelease = exports.createLocalRelease = exports.preRelease = exports.queryPipelineInstance = exports.getErrorLog = exports.listPipelineInstances = exports.createRelease = void 0;
 var api_1 = require("./api");
 Object.defineProperty(exports, "createRelease", { enumerable: true, get: function () { return api_1.createRelease; } });
 Object.defineProperty(exports, "listPipelineInstances", { enumerable: true, get: function () { return api_1.listPipelineInstances; } });
@@ -10,6 +10,7 @@ var modern_1 = require("./modern");
 Object.defineProperty(exports, "preRelease", { enumerable: true, get: function () { return modern_1.preRelease; } });
 Object.defineProperty(exports, "createLocalRelease", { enumerable: true, get: function () { return modern_1.createLocalRelease; } });
 Object.defineProperty(exports, "updateLocalRelease", { enumerable: true, get: function () { return modern_1.updateLocalRelease; } });
+Object.defineProperty(exports, "callbackStatic", { enumerable: true, get: function () { return modern_1.callbackStatic; } });
 Object.defineProperty(exports, "createModernRelease", { enumerable: true, get: function () { return modern_1.createRelease; } });
 Object.defineProperty(exports, "getModernReleaseStatus", { enumerable: true, get: function () { return modern_1.getReleaseStatus; } });
 Object.defineProperty(exports, "getModernLastPublishedVersion", { enumerable: true, get: function () { return modern_1.getLastPublishedVersion; } });

package/dist/api/deploy/modern.js

@@ -13,6 +13,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.preRelease = preRelease;
 exports.createLocalRelease = createLocalRelease;
 exports.updateLocalRelease = updateLocalRelease;
+exports.callbackStatic = callbackStatic;
 exports.createRelease = createRelease;
 exports.getReleaseStatus = getReleaseStatus;
 exports.getLastPublishedVersion = getLastPublishedVersion;
@@ -48,6 +49,13 @@ async function updateLocalRelease(req) {
     const url = `/v1/devops/app/${encodeURIComponent(appID)}/local_publish/update_release`;
     await (0, http_1.postInnerApi)(url, body, envelopeOpts('Failed to update local release'));
 }
+// ── callbackStatic（PaaS Storage 静态资源上传完成回调） ──
+/** POST /v1/storage/app/:appID/bucket/:bucketID/object/callbackStatic */
+async function callbackStatic(req) {
+    const { appID, bucketID, uploadID } = req;
+    const url = `/v1/storage/app/${encodeURIComponent(appID)}/bucket/${encodeURIComponent(bucketID)}/object/callbackStatic`;
+    return (0, http_1.postInnerApi)(url, { uploadID }, envelopeOpts('Failed to callback static upload'));
+}
 // ── release（远端部署，B / C 链路；本期不导出，类型骨架已就绪） ──
 /** POST /v1/devops/app/:appID/remote_publish/release */
 async function createRelease(req) {

package/dist/api/deploy/plugin-instances-types.js

@@ -1,6 +1,6 @@
 "use strict";
 // plugin_instances batch_save 接口的请求 / 响应类型。
 //
-// 与 modern deploy 其它接口走的 lark.apaas.devops PSM 不同，
-// 本接口走 lark.apaas.studio_server，响应信封形态也不一样（BaseResp 而非 status_code）。
+// 后端已统一到 InnerEnvelope（`{data, status_code, message}`），与 modern deploy
+// 其它接口一致；旧的 BaseResp 形态已下线，类型也不再保留。
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/deploy/plugin-instances.js

@@ -1,30 +1,22 @@
 "use strict";
 // studio_server 的 plugin_instances 批量保存接口。
-// 与 modern deploy 其余接口（走 devops PSM、InnerEnvelope）信封不同，
-// 这里走 studio_server PSM、BaseResp 信封，故自行解析。
+//
+// 后端已统一到 InnerEnvelope（`{data, status_code, message}`）信封；不再手撸
+// 旧 BaseResp 解析，直接复用 utils/http.ts 的 postInnerApi，verbose 下也能拿到
+// `→ POST` / `body:` / `resp:` 的完整日志。
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.batchSavePluginInstances = batchSavePluginInstances;
 const http_1 = require("../../utils/http");
-const error_1 = require("../../utils/error");
 const URL_PATH = '/api/v1/studio/innerapi/plugin_instances/batch_save';
 /**
  * POST /api/v1/studio/innerapi/plugin_instances/batch_save
  *
  * 把发布版本的 capability 集合注册到 studio_server。
- * 失败时抛 AppError("DEPLOY_PLUGIN_BATCH_SAVE_FAILED")，带 BaseResp 错误信息。
+ * 失败时抛 AppError("DEPLOY_PLUGIN_BATCH_SAVE_FAILED")，错误信息来自 envelope.message。
  */
 async function batchSavePluginInstances(req) {
-    const response = await (0, http_1.getHttpClient)().post(URL_PATH, req);
-    if (!response.ok) {
-        throw new error_1.HttpError(response.status, URL_PATH, `Failed to save plugin instances: ${String(response.status)} ${response.statusText}`);
-    }
-    const body = (await response.json());
-    const baseResp = body.BaseResp;
-    if (baseResp?.StatusCode !== 0) {
-        const msg = baseResp?.StatusMessage ?? baseResp?.KStatusMessage ?? 'unknown error';
-        const code = baseResp?.KStatusCode !== undefined && baseResp.KStatusCode !== ''
-            ? baseResp.KStatusCode
-            : String(baseResp?.StatusCode ?? 'unknown');
-        throw new error_1.AppError('DEPLOY_PLUGIN_BATCH_SAVE_FAILED', `Failed to save plugin instances: status_code=${code} message=${msg}`);
-    }
+    await (0, http_1.postInnerApi)(URL_PATH, req, {
+        errPrefix: 'Failed to save plugin instances',
+        defaultErrCode: 'DEPLOY_PLUGIN_BATCH_SAVE_FAILED',
+    });
 }

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,8 +21,35 @@ function registerAppCommands(program, opts = {}) {
     registerAppUpdate(appCmd);
     if (opts.includeInit) {
         registerAppInit(appCmd);
+        registerAppSync(appCmd);
     }
 }
+function registerAppSync(parent) {
+    const cmd = parent
+        .command('sync')
+        .description('按 stack 同步 platform-controlled/ 下的平台管控内容(scripts / package.json 字段等)到项目')
+        .option('--dir <path>', '项目目录，默认 cwd（需含 .spark/meta.json）')
+        .addHelpText('after', `
+流程
+  1. 读 .spark/meta.json.stack 决定从 platform-controlled/<stack>/ 拉取
+  2. files/   → 按相对路径覆盖到 <dir>(.sh 自动 +x)
+  3. patches/ → 每个 .json 文件按相对路径 deep merge 到 <dir>/<rel-path>
+                (支持任意 JSON:package.json / tsconfig.json / nest-cli.json / ...)
+
+JSON 输出
+  {"data": {"stack": "...", "syncedFiles": [...],
+            "mergedJsonFiles": [{"path": "...", "keys": [...]}]}}
+
+示例
+  $ miaoda app sync
+  $ miaoda app sync --dir /path/to/app --json
+`);
+    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')
@@ -71,7 +98,6 @@ function registerAppInit(parent) {
     const cmd = parent
         .command('init')
         .description('初始化应用代码：抓 template 渲染、装 .agent/steering/ skills、写 .spark/meta.json。.spark/meta.json 已存在则直接退出')
-        .addOption((0, shared_1.appIdOption)().hideHelp())
         .option('--template <stack>', `技术栈短名（${index_1.SUPPORTED_STACKS.join(' / ')}）`)
         .option('--conf <json>', 'init 配置 JSON。支持 {"version": "<template 版本>"} / {"steeringVersion": "<steering 版本>"}，均默认 latest')
         .option('--skip-install', '跳过依赖安装', false)
@@ -82,6 +108,10 @@ function registerAppInit(parent) {
   meta.json 在 init 流程最后才写，写了 = 已完整成功一次；
   上一次失败留下半渲染状态时（package.json 在但 meta.json 没在）允许重跑。
 
+应用身份（appId）
+  init 不再持久化 appId。运行端命令（deploy / file / plugin 等）始终从 MIAODA_APP_ID env 读，
+  init 阶段也无需感知 appId。
+
 依赖安装
   默认：npm install --no-audit --no-fund
   --skip-install: 跳过
@@ -104,10 +134,8 @@ JSON 输出
   $ MIAODA_DEP_CACHE_DIR=/tmp/dep-cache miaoda app init --template vite-react
 `);
     cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
-        (0, shared_1.rejectCliOverride)(cmd, 'appId');
         const conf = parseInitConf(rawOpts.conf);
         await (0, index_1.handleAppInit)({
-            appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
             template: rawOpts.template,
             conf,
             skipInstall: rawOpts.skipInstall,

package/dist/cli/commands/deploy/modern.js

@@ -20,7 +20,8 @@ function registerDeployCommandsModern(program) {
 不要用异步模式或后台模式调用 deploy，否则调用可能提前结束，Agent 会误判发布已完成。
 
 前置要求
-  - 项目已 init（.spark/meta.json 含 appId / template）
+  - 项目已 init（.spark/meta.json 含 stack）
+  - MIAODA_APP_ID 已设置（应用身份从 env 读，不再从 meta.json 读）
   - node_modules 已安装
   - package.json 含 build script
   - 沙箱内预装 tosutil（用于把构建产物上传到 TOS）
@@ -42,6 +43,7 @@ JSON 输出（stdout）
     deployCmd.action((0, shared_1.withHelp)(deployCmd, async (rawOpts) => {
         await (0, modern_1.handleDeployModern)({
             dir: rawOpts.dir ?? '.',
+            appId: (0, shared_1.resolveAppId)({}),
             skipBuild: rawOpts.skipBuild,
         });
     }));

package/dist/cli/commands/index.js

@@ -8,9 +8,22 @@ const index_3 = require("../../cli/commands/observability/index");
 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 = {
@@ -24,6 +37,26 @@ const SCENE_REGISTRARS = {
     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) {

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

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSkillsCommands = registerSkillsCommands;
+const shared_1 = require("../../../cli/commands/shared");
+const index_1 = require("../../../cli/handlers/skills/index");
+/**
+ * miaoda skills：本地 agent skills 维护。
+ *
+ * 当前仅 steering 一类子集（coding-steering 包内的 _common/skills + <stack>/skills + tech.md）；
+ * 后续如有更多 skill 类型再加 --type。`app init` 会一次性同步装上，独立 `skills sync` 用于
+ * 后续单独升级 / pin 版本，不必走完整 init。
+ */
+function registerSkillsCommands(program) {
+    const skillsCmd = program.command('skills').description('本地 agent skills（含 steering）维护');
+    skillsCmd.action(() => {
+        skillsCmd.outputHelp();
+    });
+    registerSkillsSync(skillsCmd);
+    registerSkillsStatus(skillsCmd);
+}
+function registerSkillsSync(parent) {
+    const cmd = parent
+        .command('sync')
+        .description('同步 coding-steering（latest 或指定版本）到 .agent/steering/')
+        .argument('[version]', 'coding-steering 包版本或 dist-tag，缺省 latest')
+        .option('--dir <path>', '项目目录，默认当前目录', '.')
+        .addHelpText('after', `
+前置要求
+  当前目录（或 --dir）已走过 'miaoda app init'（.spark/meta.json 含 stack）
+
+JSON 输出
+  {"data": {"stack": "...", "version": "...", "syncedSkills": [...], "techSynced": true|false}}
+
+示例
+  $ miaoda skills sync
+  $ miaoda skills sync 0.2.0
+  $ miaoda skills sync --dir ./my-app
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (version, rawOpts) => {
+        await (0, index_1.handleSkillsSync)({
+            dir: rawOpts.dir,
+            version,
+        });
+    }));
+}
+function registerSkillsStatus(parent) {
+    const cmd = parent
+        .command('status')
+        .description('查看本地 .agent/steering/ 的当前状态（不联网）')
+        .option('--dir <path>', '项目目录，默认当前目录', '.')
+        .addHelpText('after', `
+JSON 输出
+  {"data": {"present": true|false, "skills": [...], "techSynced": true|false}}
+
+示例
+  $ miaoda skills status
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
+        await (0, index_1.handleSkillsStatus)({
+            dir: rawOpts.dir,
+        });
+    }));
+}

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

@@ -1,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SUPPORTED_STACKS = exports.handleAppInit = exports.handleAppUpdate = exports.handleAppGet = void 0;
+exports.SUPPORTED_STACKS = exports.handleAppSync = 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; } });
 // 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

@@ -7,15 +7,22 @@ exports.handleAppInit = handleAppInit;
 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 error_1 = require("../../../utils/error");
 const output_1 = require("../../../utils/output");
-/** miaoda app init [--template <stack>] [--conf <json>] */
+/**
+ * miaoda app init
+ *
+ * 只负责本地脚手架：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 不在）会重新跑完整流程。
+ */
 async function handleAppInit(opts) {
     await Promise.resolve();
     const targetDir = opts.targetDir ?? process.cwd();
     const metaPath = node_path_1.default.join(targetDir, '.spark', 'meta.json');
-    // 幂等：.spark/meta.json 是 init 流程最后才写的，存在即代表"已完整成功一次"。
-    // 用 package.json 判幂等会让 install 失败、CWD 留下半渲染状态的应用永远 init 不了。
     if (node_fs_1.default.existsSync(metaPath)) {
         if (!(0, output_1.isJsonMode)()) {
             process.stdout.write(`Already initialized: ${metaPath}\n`);
@@ -43,10 +50,11 @@ 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 });
-    const steeringResult = (0, index_1.syncSteering)({
+    const steeringResult = (0, coding_steering_1.syncCodingSteering)({
         stack,
         targetDir,
         version: opts.conf?.steeringVersion,
+        logPrefix: 'init',
     });
     const installResult = (0, index_1.installDependencies)({
         targetDir,
@@ -54,14 +62,9 @@ async function handleAppInit(opts) {
         quietStdout: (0, output_1.isJsonMode)(),
     });
     (0, index_1.writeSparkMeta)(targetDir, {
-        appId: opts.appId,
-        template: stack,
-        templatePackage: tplResult.packageName,
-        templateVersion: tplResult.version,
-        steeringVersion: steeringResult.version,
+        stack,
+        version: tplResult.version,
         archType: tplResult.archType,
-        installSource: installResult.source,
-        installHash: installResult.hash,
     });
     if (!(0, output_1.isJsonMode)()) {
         process.stdout.write(`✓ Initialized ${stack} (template ${tplResult.version}, steering ${steeringResult.version}, install ${installResult.source}) in ${targetDir}\n`);
@@ -69,7 +72,6 @@ async function handleAppInit(opts) {
     (0, output_1.emit)({
         data: {
             initialized: true,
-            appId: opts.appId,
             template: stack,
             templatePackage: tplResult.packageName,
             templateVersion: tplResult.version,

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

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleAppSync = handleAppSync;
+const node_path_1 = __importDefault(require("node:path"));
+const platform_sync_1 = require("../../../utils/platform-sync");
+const spark_meta_1 = require("../../../utils/spark-meta");
+const error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+/**
+ * miaoda app sync [--dir <path>]
+ *
+ * 从 platform-controlled/<stack>/ 同步平台管控内容到项目:
+ *   - files/         → 按相对路径覆盖
+ *   - package.json   → deep merge patch
+ *
+ * 需要 .spark/meta.json 已含 stack(走过 `miaoda app init`)。
+ * 不动 .agent/skills/(那是 `miaoda skills sync` 的事)。
+ */
+async function handleAppSync(opts) {
+    await Promise.resolve();
+    const targetDir = node_path_1.default.resolve(opts.dir ?? process.cwd());
+    const meta = (0, spark_meta_1.readSparkMeta)(targetDir);
+    if (meta.stack === undefined || meta.stack === '') {
+        throw new error_1.AppError('SYNC_META_INCOMPLETE', '.spark/meta.json missing stack — run `miaoda app init` first');
+    }
+    const result = (0, platform_sync_1.syncPlatformControlled)({
+        stack: meta.stack,
+        targetDir,
+    });
+    if (!result.stackFound) {
+        throw new error_1.AppError('SYNC_STACK_NOT_SUPPORTED', `platform-controlled/${meta.stack}/ not found — 该 stack 暂未纳入 app sync 范围`, {
+            next_actions: ['在 miaoda-cli 仓 platform-controlled/ 下添加该 stack 目录,然后重新发版'],
+        });
+    }
+    (0, output_1.emit)({
+        data: {
+            stack: meta.stack,
+            syncedFiles: result.syncedFiles,
+            mergedJsonFiles: result.mergedJsonFiles,
+        },
+    });
+}

package/dist/cli/handlers/deploy/modern.js

@@ -16,6 +16,7 @@ async function handleDeployModern(opts) {
     const projectDir = node_path_1.default.resolve(opts.dir);
     const result = await (0, index_1.runModernDeploy)({
         projectDir,
+        appId: opts.appId,
         skipBuild: opts.skipBuild ?? false,
     });
     (0, output_1.emit)({

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSkillsStatus = exports.handleSkillsSync = void 0;
+var sync_1 = require("./sync");
+Object.defineProperty(exports, "handleSkillsSync", { enumerable: true, get: function () { return sync_1.handleSkillsSync; } });
+var status_1 = require("./status");
+Object.defineProperty(exports, "handleSkillsStatus", { enumerable: true, get: function () { return status_1.handleSkillsStatus; } });

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

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSkillsStatus = handleSkillsStatus;
+const node_path_1 = __importDefault(require("node:path"));
+const index_1 = require("../../../services/skills/index");
+const spark_meta_1 = require("../../../utils/spark-meta");
+const output_1 = require("../../../utils/output");
+/**
+ * miaoda skills status [--dir <path>]
+ *
+ * 从 .spark/meta.json 读 stack，扫描 <dir>/.agent/steering/<stack>/，
+ * 给出当前装了哪些 skills、tech.md 是否在。纯本地操作，不联网。
+ * meta 缺 stack 时返回 present=false（不抛错，方便和 init 的引导分开）。
+ */
+async function handleSkillsStatus(opts) {
+    await Promise.resolve();
+    const targetDir = node_path_1.default.resolve(opts.dir ?? process.cwd());
+    const meta = (0, spark_meta_1.readSparkMeta)(targetDir);
+    const status = (0, index_1.readSkillsStatus)({ targetDir, stack: meta.stack });
+    (0, output_1.emit)({
+        data: {
+            stack: meta.stack ?? null,
+            present: status.present,
+            skills: status.skills,
+            techSynced: status.techSynced,
+        },
+    });
+}

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

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSkillsSync = handleSkillsSync;
+const node_path_1 = __importDefault(require("node:path"));
+const coding_steering_1 = require("../../../utils/coding-steering");
+const spark_meta_1 = require("../../../utils/spark-meta");
+const error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+/**
+ * miaoda skills sync [--dir <path>] [--version <ver>]
+ *
+ * 从 .spark/meta.json 读 stack，把 coding-steering 包内对应 stack 的 skills + tech.md
+ * 同步到 <dir>/.agent/steering/。需要先跑过 `miaoda app init`。
+ */
+async function handleSkillsSync(opts) {
+    await Promise.resolve();
+    const targetDir = node_path_1.default.resolve(opts.dir ?? process.cwd());
+    const meta = (0, spark_meta_1.readSparkMeta)(targetDir);
+    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 result = (0, coding_steering_1.syncCodingSteering)({
+        stack: meta.stack,
+        targetDir,
+        version: opts.version,
+    });
+    (0, output_1.emit)({
+        data: {
+            stack: meta.stack,
+            version: result.version,
+            syncedSkills: result.syncedSkills,
+            techSynced: result.techSynced,
+        },
+    });
+}

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

@@ -1,12 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.installDependencies = exports.writeSparkMeta = exports.readSparkMeta = exports.syncSteering = exports.TEMPLATE_PACKAGE_BY_STACK = exports.SUPPORTED_STACKS = exports.renderTemplate = void 0;
+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; } });
 Object.defineProperty(exports, "TEMPLATE_PACKAGE_BY_STACK", { enumerable: true, get: function () { return template_1.TEMPLATE_PACKAGE_BY_STACK; } });
-var steering_1 = require("./steering");
-Object.defineProperty(exports, "syncSteering", { enumerable: true, get: function () { return steering_1.syncSteering; } });
 var spark_meta_1 = require("../../../utils/spark-meta");
 Object.defineProperty(exports, "readSparkMeta", { enumerable: true, get: function () { return spark_meta_1.readSparkMeta; } });
 Object.defineProperty(exports, "writeSparkMeta", { enumerable: true, get: function () { return spark_meta_1.writeSparkMeta; } });

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

@@ -10,17 +10,18 @@ const node_path_1 = __importDefault(require("node:path"));
 const npm_pack_1 = require("../../../utils/npm-pack");
 const error_1 = require("../../../utils/error");
 const logger_1 = require("../../../utils/logger");
-/** 短名 → 包名映射。新增 stack 时改这里。 */
+/** 短名 → 包名映射。新增 stack 时改这里。archType 由 template 包自报，CLI 不维护。 */
 exports.TEMPLATE_PACKAGE_BY_STACK = {
     'vite-react': '@lark-apaas/coding-template-vite-react',
     html: '@lark-apaas/coding-template-html',
 };
 exports.SUPPORTED_STACKS = Object.keys(exports.TEMPLATE_PACKAGE_BY_STACK);
-// template/ 内以下划线开头的占位文件名在渲染时改名（npm publish 会把 .gitignore 吞掉，
-// 模板里用 _gitignore 提交，渲染时再改回）。
+// template/ 内以下划线开头的占位文件名在渲染时改名（npm publish 会把 .gitignore / .npmrc 吞掉，
+// 模板里用 _gitignore / _npmrc 提交，渲染时再改回）。
 const RENAME_FILES = {
     _gitignore: '.gitignore',
     '_env.local': '.env.local',
+    _npmrc: '.npmrc',
 };
 function renderTemplate(opts) {
     const packageName = exports.TEMPLATE_PACKAGE_BY_STACK[opts.stack];
@@ -37,12 +38,13 @@ function renderTemplate(opts) {
             throw new error_1.AppError('TEMPLATE_INVALID', `包 ${packageName}@${fetched.version} 缺少 template/ 目录`);
         }
         const pkgJsonPath = node_path_1.default.join(fetched.extractDir, 'package.json');
-        let archType = '';
+        let archType;
         if (node_fs_1.default.existsSync(pkgJsonPath)) {
             const pkgJson = JSON.parse(node_fs_1.default.readFileSync(pkgJsonPath, 'utf-8'));
-            archType = pkgJson.miaodaTemplate?.archType ?? '';
+            archType = pkgJson.miaodaTemplate?.archType;
         }
-        if (!archType) {
+        // 用显式 null/undefined/'' 判，避免把合法值 0 / false 当成"缺失"误抛
+        if (archType === undefined || archType === null || archType === '') {
             throw new error_1.AppError('TEMPLATE_INVALID', `包 ${packageName}@${fetched.version} 缺少 package.json.miaodaTemplate.archType`);
         }
         (0, logger_1.log)('init', `Rendering template to ${opts.targetDir}...`);

package/dist/services/deploy/modern/atoms/build.js

@@ -6,13 +6,14 @@ const error_1 = require("../../../../utils/error");
 const logger_1 = require("../../../../utils/logger");
 const protocol_1 = require("../protocol");
 /**
- * 给 CDN 前缀补 https:// 协议头：
+ * 给 RESOURCE_CDN_PREFIX 补 https:// 协议头：
  *   - 已带 http:// 或 https:// → 原样返回
  *   - 以 / 开头（绝对路径）→ 原样返回
  *   - 不含 dot（看起来不像域名，比如纯路径 app_xxx/2）→ 原样返回
  *   - 其它（典型：lf-xxx.bytetos.com/...）→ 前缀 https://
  *
  * template 的 build script 直接拿来当 vite base / asset URL 用，必须是合法 URL。
+ * STATIC_CDN_PREFIX 由 runtime 同域提供（相对路径），不走这里。
  */
 function ensureHttpsScheme(v) {
     if (/^https?:\/\//i.test(v))
@@ -28,17 +29,21 @@ function ensureHttpsScheme(v) {
  *   MIAODA_APP_ID / MIAODA_VERSION / MIAODA_STACK
  *   MIAODA_RESOURCE_CDN_PREFIX / MIAODA_STATIC_CDN_PREFIX
  *
- * CDN 前缀缺 scheme 时由 CLI 自动补 https://，template 不用关心。
+ * MIAODA_STATIC_CDN_PREFIX 取自 output_static_paas_storage_credential.downloadURLPrefix，
+ * 是 runtime 同域相对路径（例如 /app/<appId>/runtime/api/v1/storage/object/<bucket>/），
+ * 不补 https scheme，原样注入。顶层 static_cdn_prefix 不再下发。
+ *
  * build 失败抛 AppError（execSync 自身会 throw，捕获后包一层加错误码）。
  */
 function runBuild(opts) {
+    const staticCred = (0, protocol_1.parsePaasStorageCredential)((0, protocol_1.requireDataKey)(opts.data, protocol_1.DataKey.OUTPUT_STATIC_PAAS_STORAGE_CREDENTIAL), protocol_1.DataKey.OUTPUT_STATIC_PAAS_STORAGE_CREDENTIAL);
     const buildEnv = {
         ...process.env,
         MIAODA_APP_ID: opts.appId,
         MIAODA_VERSION: opts.version,
         MIAODA_STACK: opts.templateKey,
         MIAODA_RESOURCE_CDN_PREFIX: ensureHttpsScheme((0, protocol_1.requireDataKey)(opts.data, protocol_1.DataKey.RESOURCE_CDN_PREFIX)),
-        MIAODA_STATIC_CDN_PREFIX: ensureHttpsScheme((0, protocol_1.requireDataKey)(opts.data, protocol_1.DataKey.STATIC_CDN_PREFIX)),
+        MIAODA_STATIC_CDN_PREFIX: staticCred.downloadURLPrefix,
     };
     (0, logger_1.log)('deploy', 'Building...');
     try {