@lark-apaas/miaoda-cli 0.1.37 → 0.1.39-alpha.76f8fd5

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

@@ -18,7 +18,14 @@ function registerDeployCommandsModern(program) {
         .option('--dir <path>', '项目目录', '.')
         .option('--skip-build', '跳过 build 步骤（已构建好时使用）', false)
         .option('--skip-release', '不创建/更新本地发布单，发布单状态由外部托管', false)
-        .option('--conf <json>', '关联元信息 JSON，仅识别 checkPointVersion / commitID 两字段')
+        .option('--conf <json>', '关联元信息 JSON，仅识别 checkPointVersion / commitID / sessionID / marker 四字段')
+        // 这三个 flag 只在父命令声明一份，deploy 与 deploy patch 共用。
+        // 不能在 patch 上再声明一遍：commander 遇到父子同名 option 会把值判给父命令，
+        // 子命令拿到空数组，`deploy patch --create x` 会静默失效（deploy-patch-wiring 测试可复现）。
+        // patch 从 deployCmd.opts() 读，与它今天读 --dir 的方式一致。
+        .option('--create <relpath>', '新增文件（可重复）', shared_1.collectRepeatedOption, [])
+        .option('--update <relpath>', '修改文件（可重复）', shared_1.collectRepeatedOption, [])
+        .option('--delete <relpath>', '删除文件（可重复）', shared_1.collectRepeatedOption, [])
         .addHelpText('after', `
 不要用异步模式或后台模式调用 deploy，否则调用可能提前结束，Agent 会误判发布已完成。
 
@@ -41,14 +48,24 @@ function registerDeployCommandsModern(program) {
   外部据 stdout 返回的 version / preReleaseID 自行建单，并据本命令的
   退出码决定把发布单翻成 Finished 还是 Failed —— 失败态由外部负责，CLI 不再兜底。
   该模式下 releaseID / url 输出为 null（CLI 未建单，无从得知）。
-  注意：--conf 的 checkPointVersion / commitID 唯一消费者是 createLocalRelease，
+  注意：--conf 的四个字段唯一消费者是 createLocalRelease，
   本模式下不生效（静默忽略，不报错），需要关联请在外部建单时自行传递。
 
+--create / --update / --delete（变更文件清单）
+  可重复，值为工程根相对路径（禁绝对路径与 ".."）。deploy patch 消费它做增量发布；
+  在 deploy 下当前是预留口子——只校验路径并记一行日志，不改变上传行为：
+  deploy 仍然全量上传产物，latest 每次被重建为工作区的精确镜像（prune 清理远端多余对象），
+  以此保证 git 仓库与 TOS 资源不会不一致。
+  后续若实现增量上传，从这里取「要 PUT 哪些文件」即可，调用方无需改动；
+  删除仍交给 prune，因为 prune 比对的是完整本地清单，与上传了哪些文件无关。
+
 --conf（关联元信息透传）
-  值为 JSON string，只识别两个字段，其余 key 忽略：
+  值为 JSON string，只识别四个字段，其余 key 忽略：
     checkPointVersion  关联的 checkpoint 版本
     commitID           关联的代码 commit ID
-  两字段均可选；非法 JSON / 非对象 / 字段值非字符串会报错。
+    sessionID          发起本次发布的页面会话 ID，原样透传不做净化
+    marker             本次发布的变更说明，落发布单 description
+  四字段均可选；非法 JSON / 非对象 / 字段值非字符串会报错。
 
 JSON 输出（stdout）
   {"data": {"appId": "...", "version": <n>, "url": "...", "releaseID": "...", "preReleaseID": "..."}}
@@ -60,6 +77,8 @@ JSON 输出（stdout）
   $ miaoda deploy --skip-build
   $ miaoda deploy --skip-release
   $ miaoda deploy --conf '{"checkPointVersion":"v3","commitID":"a1b2c3d"}'
+  $ miaoda deploy --conf '{"commitID":"a1b2c3d","sessionID":"<uuid>","marker":"编辑保存：修改 index.html"}'
+  $ miaoda deploy --update index.html --create assets/new.js --delete old.html
 `);
     deployCmd.action((0, shared_1.withHelp)(deployCmd, async (rawOpts) => {
         await (0, modern_1.handleDeployModern)({
@@ -68,17 +87,18 @@ JSON 输出（stdout）
             skipBuild: rawOpts.skipBuild,
             skipRelease: rawOpts.skipRelease,
             conf: rawOpts.conf,
+            creates: rawOpts.create,
+            updates: rawOpts.update,
+            deletes: rawOpts.delete,
         });
     }));
     const patchCmd = deployCmd
         .command('patch')
         .description('design-html 增量发布：按文件 create/update/delete，.html 变动时同步 routes.json')
-        .option('--create <relpath>', '新增文件（可重复）', shared_1.collectRepeatedOption, [])
-        .option('--update <relpath>', '覆盖已有文件（可重复）', shared_1.collectRepeatedOption, [])
-        .option('--delete <relpath>', '删除文件（可重复）', shared_1.collectRepeatedOption, [])
         .option('--session-id <id>', '会话 ID，发布时透传给下游（可选）')
         .addHelpText('after', `
---dir 为项目目录（与 deploy 同名参数，默认当前目录）。
+--dir / --create / --update / --delete 声明在父命令 deploy 上，本命令共用，用法不变。
+--dir 为项目目录，默认当前目录。
 仅支持 design-html（design_local_deploy）。路径为工程根相对路径（= 服务端 latest 下 key），
 禁绝对路径与 ".."。--create/--update 的本地文件必须存在。改动里含任意 .html（增 / 改 / 删）
 时自动重算并随包更新 routes.json；纯非 .html 改动不动 routes.json。
@@ -98,9 +118,9 @@ JSON 输出
         await (0, index_1.handleDeployPatch)({
             appId: (0, shared_1.resolveAppId)({}),
             dir: deployCmd.opts().dir ?? '.',
-            creates: rawOpts.create,
-            updates: rawOpts.update,
-            deletes: rawOpts.delete,
+            creates: deployCmd.opts().create,
+            updates: deployCmd.opts().update,
+            deletes: deployCmd.opts().delete,
             sessionID: rawOpts.sessionId,
         });
     }));

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

@@ -4,14 +4,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseDeployConf = parseDeployConf;
+exports.parseChangedFiles = parseChangedFiles;
 exports.handleDeployModern = handleDeployModern;
 const node_path_1 = __importDefault(require("node:path"));
 const output_1 = require("../../../utils/output");
 const error_1 = require("../../../utils/error");
 const index_1 = require("../../../services/deploy/modern/index");
-const CONF_EXPECTED = '期望形如 {"checkPointVersion":"...","commitID":"..."} 的 JSON 对象';
+const index_2 = require("../../../services/deploy/modern/patch/index");
+const logger_1 = require("../../../utils/logger");
+const CONF_EXPECTED = '期望形如 {"checkPointVersion":"...","commitID":"...","sessionID":"...","marker":"..."} 的 JSON 对象';
 /**
- * 解析 `--conf` JSON string，只取 checkPointVersion / commitID 两个白名单字段。
+ * 解析 `--conf` JSON string，只取 checkPointVersion / commitID / sessionID / marker 四个白名单字段。
  * - 未传 → 返回 {}（行为不变）。
  * - 非法 JSON / 非 object / 字段值非 string → 抛 DEPLOY_CONF_INVALID。
  * - 空串字段视为未提供（不进 body，保持可选语义）；未知 key 忽略。
@@ -31,7 +34,7 @@ function parseDeployConf(raw) {
     }
     const source = parsed;
     const conf = {};
-    for (const key of ['checkPointVersion', 'commitID']) {
+    for (const key of ['checkPointVersion', 'commitID', 'sessionID', 'marker']) {
         const value = source[key];
         if (value === undefined)
             continue;
@@ -43,6 +46,29 @@ function parseDeployConf(raw) {
     }
     return conf;
 }
+/**
+ * 解析 `--create` / `--update` / `--delete`，校验路径后组成 PatchChangeSet。
+ *
+ * 复用 deploy patch 的 normalizeRel（同一套校验：禁绝对路径、禁 ".."、统一为 posix 相对路径），
+ * 保证两条链路对「变更文件」的接受范围完全一致，调用方从 patch 迁移不会遇到收紧或放宽。
+ *
+ * 当前是预留口子：deploy 仍然全量上传，这里只校验并记一行日志，不参与上传决策。
+ * 三个参数都没传 → 返回 undefined（与不传时行为完全一致，不产生日志）。
+ */
+function parseChangedFiles(opts) {
+    const cs = {
+        creates: (opts.creates ?? []).map((rel) => (0, index_2.normalizeRel)(rel)),
+        updates: (opts.updates ?? []).map((rel) => (0, index_2.normalizeRel)(rel)),
+        deletes: (opts.deletes ?? []).map((rel) => (0, index_2.normalizeRel)(rel)),
+    };
+    const total = cs.creates.length + cs.updates.length + cs.deletes.length;
+    if (total === 0)
+        return undefined;
+    (0, logger_1.log)('deploy', `收到变更文件提示 ${String(total)} 个（create=${String(cs.creates.length)} ` +
+        `update=${String(cs.updates.length)} delete=${String(cs.deletes.length)}）：` +
+        '当前仍为全量上传，未启用增量');
+    return cs;
+}
 /**
  * miaoda deploy（modern scene 专用，CLI 表面对齐 openclaw-cli）
  *
@@ -58,6 +84,9 @@ async function handleDeployModern(opts) {
         skipRelease: opts.skipRelease ?? false,
         checkPointVersion: conf.checkPointVersion,
         commitID: conf.commitID,
+        sessionID: conf.sessionID,
+        marker: conf.marker,
+        changedFiles: parseChangedFiles(opts),
     });
     (0, output_1.emit)({
         data: {

package/dist/config/sync-configs/index.js

@@ -23,13 +23,15 @@ const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const nestjs_react_fullstack_1 = __importDefault(require("./nestjs-react-fullstack"));
 const design_stack_1 = __importDefault(require("./design-stack"));
+const vite_react_1 = __importDefault(require("./vite-react"));
 /**
- * 已纳入新 sync 机制的 stack 注册表。未在表里的 stack（如老 vite-react / html）走旧的
+ * 已纳入新 sync 机制的 stack 注册表。未在表里的 stack（如 html / design-html）走旧的
  * `upgrade/templates/<stack>/{files,patches}` 机制，由 sync handler 兜底。
  */
 const STACK_REGISTRY = {
     'nestjs-react-fullstack': nestjs_react_fullstack_1.default,
     'design-stack': design_stack_1.default,
+    'vite-react': vite_react_1.default,
 };
 /** 返回该 stack 的 SyncConfig；表里没有时返回 null。 */
 function getSyncConfig(stack) {

package/dist/config/sync-configs/vite-react.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * vite-react sync 规则（镜像 fullstack-cli 的 viteReactProfile）：只同步 build.sh 一支，
+ * 回溯 public/* → dist/output/ 修复。
+ * ⚠️ build.sh 源须与 miaoda-coding 模板、fullstack-cli `templates/vite-react/build.sh` 逐字一致。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SYNC_CONFIG = void 0;
+exports.SYNC_CONFIG = {
+    sync: [
+        // 覆盖 scripts/build.sh：回溯 public/* → dist/output/（同源根 /app/<appId>/*）修复
+        {
+            type: 'file',
+            from: 'scripts/build.sh',
+            to: 'scripts/build.sh',
+            overwrite: true,
+        },
+    ],
+};
+exports.default = exports.SYNC_CONFIG;

package/dist/services/deploy/modern/atoms/local-release.js

@@ -16,6 +16,8 @@ async function createLocalRelease(appId, version, extra) {
         version,
         checkPointVersion: extra?.checkPointVersion,
         commitID: extra?.commitID,
+        sessionID: extra?.sessionID,
+        description: extra?.marker,
     });
 }
 /**

package/dist/services/deploy/modern/patch/actions.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeRel = normalizeRel;
 exports.buildTosActions = buildTosActions;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
@@ -10,7 +11,12 @@ const error_1 = require("../../../../utils/error");
 const index_1 = require("../../../../api/deploy/index");
 const content_1 = require("./content");
 const routes_1 = require("./routes");
-/** 校验相对路径：禁绝对路径、禁含 ".." 段；normalize 成 posix 相对。 */
+/**
+ * 校验相对路径：禁绝对路径、禁含 ".." 段；normalize 成 posix 相对。
+ *
+ * 导出供 `deploy` 的 `--create` / `--update` / `--delete` 复用同一套校验，
+ * 让两条链路对「变更文件」的接受范围一致，避免两处实现漂移。
+ */
 function normalizeRel(rel) {
     if (node_path_1.default.isAbsolute(rel) || rel.startsWith('/')) {
         throw new error_1.AppError('ARGS_INVALID', `文件路径不能是绝对路径：${rel}`);

package/dist/services/deploy/modern/patch/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildTosActions = void 0;
+exports.normalizeRel = exports.buildTosActions = void 0;
 exports.patchDesignDeploy = patchDesignDeploy;
 const spark_meta_1 = require("../../../../utils/spark-meta");
 const error_1 = require("../../../../utils/error");
@@ -10,6 +10,7 @@ const template_key_map_1 = require("../template-key-map");
 const actions_1 = require("./actions");
 var actions_2 = require("./actions");
 Object.defineProperty(exports, "buildTosActions", { enumerable: true, get: function () { return actions_2.buildTosActions; } });
+Object.defineProperty(exports, "normalizeRel", { enumerable: true, get: function () { return actions_2.normalizeRel; } });
 /**
  * design-html 增量发布：读本地文件组 TosFileAction（改动含 .html 时带重算的
  * routes.json），调后端 applyTosDiff 应用到 latest。scope 限 design_local_deploy。

package/dist/services/deploy/modern/pipelines/design-local.js

@@ -28,7 +28,12 @@ async function designLocalPublishPipeline(opts) {
             skipRelease: opts.skipRelease ?? false,
             appId: ctx.appId,
             version: pre.version,
-            extra: { checkPointVersion: opts.checkPointVersion, commitID: opts.commitID },
+            extra: {
+                checkPointVersion: opts.checkPointVersion,
+                commitID: opts.commitID,
+                sessionID: opts.sessionID,
+                marker: opts.marker,
+            },
         });
         try {
             await (0, index_1.uploadDesignArtifacts)({ projectDir: ctx.projectDir, data });

package/dist/services/deploy/modern/pipelines/local.js

@@ -45,7 +45,12 @@ async function localBuildLocalPublishPipeline(opts) {
         skipRelease: opts.skipRelease ?? false,
         appId: ctx.appId,
         version: pre.version,
-        extra: { checkPointVersion: opts.checkPointVersion, commitID: opts.commitID },
+        extra: {
+            checkPointVersion: opts.checkPointVersion,
+            commitID: opts.commitID,
+            sessionID: opts.sessionID,
+            marker: opts.marker,
+        },
     });
     try {
         (0, logger_1.log)('deploy', 'Uploading artifacts...');

package/dist/utils/http.js

@@ -64,13 +64,13 @@ function createClient(opts) {
  * 默认灰度泳道。当前 miaoda CLI 接入的新接口（modern deploy 等）只在该泳道生效，
  * 缺省走这个。MIAODA_CANARY_HEADER 可显式覆盖；设为空字符串则去掉头。
  *
- * ⚠️ TEMP（creative-upgrade 联调用）：默认泳道临时指向开发泳道 boe_debug_detail_lookup，
+ * ⚠️ TEMP（creative-upgrade 联调用）：默认泳道临时指向开发泳道 boe_creative_history，
  * 使 alpha 发版进沙箱镜像后，app export / code-archive 等新接口无需 wrapper 即可命中
  * 尚未合流的 studio_server 改动。
  * 上线前必须还原为 'boe_miaoda_ccm'，或改为由 agent_tool 按请求 x-tt-env 注入
  * MIAODA_CANARY_HEADER（详见 http.ts 的 applyCanaryHeader 与 agent_tool ExecShellCmd）。
  */
-const DEFAULT_CANARY_HEADER = 'boe_debug_detail_lookup';
+const DEFAULT_CANARY_HEADER = 'boe_creative_history';
 /**
  * 注入 x-tt-env 小流量头：env 显式设值 > DEFAULT_CANARY_HEADER。
  *

package/package.json

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

package/upgrade/templates/nestjs-react-fullstack/templates/nest-cli.json

@@ -11,15 +11,6 @@
         "outDir": "dist/server",
         "watchAssets": true
       }
-    ],
-    "plugins": [
-      {
-        "name": "@nestjs/swagger",
-        "options": {
-          "introspectComments": true,
-          "classValidatorShim": true
-        }
-      }
     ]
   }
-}
+}

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

@@ -146,6 +146,11 @@ STEP_START=$(node -e "console.log(Date.now())")
 # 使用 mv 而非 cp：HTML 不能上传到公网 CDN，移走后 dist/client 中不再包含 HTML
 if [ -d "$DIST_DIR/client" ]; then
   mkdir -p "$DIST_DIR/dist/client"
+  # public 先进（顶层 client 打包被排除；server setBaseViewsDir + 中间件同源 serve）
+  if [ -d "$ROOT_DIR/client/public" ]; then
+    cp -R "$ROOT_DIR/client/public/." "$DIST_DIR/dist/client/"
+  fi
+  # 构建产物 HTML 随后 move，覆盖 public 里的同名文件（保证入口页是构建版，不被 public 静默覆盖）
   find "$DIST_DIR/client" -maxdepth 1 -name "*.html" -exec mv {} "$DIST_DIR/dist/client/" \;
 fi
 

package/upgrade/templates/vite-react/templates/scripts/build.sh

@@ -0,0 +1,61 @@
+#!/bin/bash
+set -e
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+OUTPUT="$ROOT/dist/output"
+OUTPUT_RESOURCE="$ROOT/dist/output_resource"
+OUTPUT_STATIC="$ROOT/dist/output_static"
+
+# 映射平台环境变量到 preset 期望的变量名
+#   MIAODA_APP_ID            → /app/<appId> 作为客户端 base path
+#   MIAODA_RESOURCE_CDN_PREFIX → assets (JS/CSS) 的 CDN 前缀
+# CLI 注入约定见 miaoda-cli src/services/deploy/modern/atoms/build.ts
+export CLIENT_BASE_PATH="${MIAODA_APP_ID:+/app/$MIAODA_APP_ID}"
+export ASSETS_CDN_PATH="${MIAODA_RESOURCE_CDN_PREFIX:-/}"
+export STATIC_ASSETS_BASE_URL="${MIAODA_STATIC_CDN_PREFIX}"
+export NODE_ENV="${NODE_ENV:-production}"
+
+# 清理
+rm -rf "$ROOT/dist"
+
+# 1. Vite 构建 → dist/client/（相对于项目根目录输出）
+npx vite build --outDir "$ROOT/dist/client" --emptyOutDir
+
+# 2. public/ 静态资源 + HTML → dist/output/（模型 B：public = 应用根目录，同源 /app/<appId>/*）
+mkdir -p "$OUTPUT"
+# 2a. public/*：vite copyPublicDir 已把 public/* 平铺进 dist/client，但下面白名单只取
+#     *.html/routes.json，其余（favicon / 图片 / 运行时 fetch 的数据文件）会随 dist/client 被删。
+#     从源 public/ 补拷到 output/（同源根），让 fetch('/x') / resolveAppUrl('/x') 线上可用。
+#     先拷 public、再拷 HTML，保证构建产出的 index.html/routes.json 覆盖 public 里的同名文件（若有）。
+if [ -d "$ROOT/public" ]; then
+  cp -R "$ROOT/public/." "$OUTPUT/"
+fi
+# 2b. HTML + routes.json（构建产物）
+find "$ROOT/dist/client" -maxdepth 1 \( -name '*.html' -o -name 'routes.json' \) -exec cp {} "$OUTPUT/" \;
+
+# 3. assets/ → dist/output_resource/（JS/CSS/字体，上传到 CDN）
+if [ -d "$ROOT/dist/client/assets" ]; then
+  mkdir -p "$OUTPUT_RESOURCE"
+  cp -r "$ROOT/dist/client/assets" "$OUTPUT_RESOURCE/"
+fi
+
+# 4. 私有静态资源 → dist/output_static/（排除代码文件）
+if [ -d "$ROOT/shared/static" ]; then
+  mkdir -p "$OUTPUT_STATIC"
+  rsync -a --exclude='*.ts' --exclude='*.tsx' --exclude='*.js' --exclude='*.jsx' "$ROOT/shared/static/" "$OUTPUT_STATIC/"
+fi
+
+# 5. capability 配置 → dist/output_capabilities/
+if [ -d "$ROOT/shared/capabilities" ]; then
+  mkdir -p "$ROOT/dist/output_capabilities"
+  cp -r "$ROOT/shared/capabilities/." "$ROOT/dist/output_capabilities/"
+fi
+
+# 清理中间产物
+rm -rf "$ROOT/dist/client"
+
+echo "Build complete"
+echo "  HTML         → dist/output/"
+[ -d "$OUTPUT_RESOURCE" ] && echo "  Resource     → dist/output_resource/" || true
+[ -d "$OUTPUT_STATIC" ] && echo "  Static       → dist/output_static/" || true
+[ -d "$ROOT/dist/output_capabilities" ] && echo "  Capabilities → dist/output_capabilities/" || true