@lark-apaas/miaoda-cli 0.1.24-alpha.5e3d4ef → 0.1.24-alpha.730fb3f

package/dist/api/app/api.js

@@ -5,7 +5,6 @@ exports.updateAppMeta = updateAppMeta;
 exports.getCodeArchive = getCodeArchive;
 const http_1 = require("../../utils/http");
 const devops_error_1 = require("../../utils/devops-error");
-const error_1 = require("../../utils/error");
 const DEFAULT_ERR_CODE = 'INTERNAL_DEVOPS_ERROR';
 function envelopeOpts(errPrefix) {
     return {
@@ -25,66 +24,22 @@ async function updateAppMeta(req) {
     // 路径已带 appID，body 里也保留以匹配 BAM IDL 的 sensitive:"no" 透传约定
     return (0, http_1.postInnerApi)(url, req, envelopeOpts('Failed to update app'));
 }
-function mapExportError(bizCode, message, source) {
-    // token 是敏感令牌，错误信息只截前 8 位辅助定位
-    const sourceDesc = source.sourceAppID
-        ? `应用 ${source.sourceAppID}`
-        : `分享 token ${(source.sourceMetaToken ?? '').slice(0, 8)}...`;
-    switch (bizCode) {
-        // 身份换取失败，或非源应用协作者（服务端 DOWNLOAD 鉴权不过）
-        case devops_error_1.BizErrCode.STUDIO_UNAUTHENTICATED:
-            return new error_1.AppError('EXPORT_PERMISSION_DENIED', `无权导出 ${sourceDesc}：${message}`, {
-                next_actions: [
-                    `确认你是源应用的协作者；不是的话请让应用所有者添加协作者后重试`,
-                    '这是权限问题，不是凭证配置或服务端抖动：不要重复执行本命令，也不要尝试自行签发 token',
-                ],
-            });
-        // meta_token 无效或未绑定妙搭应用（服务端 ResolveAppIDByMetaToken 反查失败）
-        case devops_error_1.BizErrCode.STUDIO_APP_NOT_FOUND:
-            return new error_1.AppError('EXPORT_APP_NOT_FOUND', `${sourceDesc} 未找到对应应用：${message}`, {
-                next_actions: [
-                    '核对分享 token / 链接是否完整（创意应用 URL 形如 https://<tenant>.feishu.cn/page/<token>）',
-                    '确认目标是创意应用（只有创意应用有分享 token）；这是目标不存在问题：不要重复执行本命令，请向用户确认',
-                ],
-            });
-        // 应用不存在（错误 ID）
-        case devops_error_1.BizErrCode.DEVOPS_APP_NOT_FOUND:
-        case devops_error_1.BizErrCode.DEVOPS_APP_NOT_FOUND_ALT:
-            return new error_1.AppError('EXPORT_APP_NOT_FOUND', `${sourceDesc} 不存在或不可访问：${message}`, {
-                next_actions: [
-                    '核对源应用 ID（应用页 URL 形如 /app/app_xxx，该段才是应用 ID）',
-                    '这是目标不存在问题：不要重复执行本命令，请向用户确认正确的应用 ID',
-                ],
-            });
-        default:
-            return (0, devops_error_1.mapDevopsError)(bizCode, message);
-    }
-}
 /**
- * GET /api/v1/studio/innerapi/apps/:appID/code-archive — 导出源应用源码归档。
+ * GET /api/v1/studio/innerapi/apps/:appID/code-archive?sourceAppID=xxx — 导出源应用源码归档。
  * 走 studio_server inner 通道（force 身份，服务侧 force→lark 换取后按 DOWNLOAD 鉴权，
- * 鉴权对象是源应用），与 comment 域同一 inner 信封；创意应用升级链路（app export）消费。
+ * 鉴权对象是 sourceAppID），与 comment 域同一 inner 信封；创意应用升级链路（app export）消费。
  *
  * path :appID 必须是当前沙箱应用：网关 apaas_force_admin_plugin 强校验 URL appID 与沙箱
  * AK 绑定应用一致（不一致 400 "appID in url is illegal"），跨应用导出目标因此走 query。
- * 源应用定位二选一：sourceAppID（app_xxx），或 sourceMetaToken（创意应用分享 URL
- * /page/<token> 的 CCM token，服务端反查 appID 后按同一口径鉴权）。
  */
 async function getCodeArchive(params) {
-    const { appID, sourceAppID, sourceMetaToken, checkpointID } = params;
-    if (!sourceAppID === !sourceMetaToken) {
-        throw new error_1.AppError('ARGS_INVALID', 'sourceAppID 与 sourceMetaToken 必须恰传其一');
-    }
-    const sourceQuery = sourceAppID
-        ? `sourceAppID=${encodeURIComponent(sourceAppID)}`
-        : `sourceMetaToken=${encodeURIComponent(sourceMetaToken ?? '')}`;
-    let url = `/api/v1/studio/innerapi/apps/${encodeURIComponent(appID)}/code-archive?` + sourceQuery;
+    const { appID, sourceAppID, checkpointID } = params;
+    let url = `/api/v1/studio/innerapi/apps/${encodeURIComponent(appID)}/code-archive` +
+        `?sourceAppID=${encodeURIComponent(sourceAppID)}`;
     if (checkpointID !== undefined && checkpointID > 0) {
         url += `&checkPointID=${String(checkpointID)}`;
     }
     return (0, http_1.getInnerApi)(url, {
         errPrefix: 'Failed to export code archive',
-        defaultErrCode: DEFAULT_ERR_CODE,
-        mapErr: (bizCode, message) => mapExportError(bizCode, message, { sourceAppID, sourceMetaToken }),
     });
 }

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

@@ -122,37 +122,32 @@ JSON 输出
 }
 function registerAppExport(parent) {
     const cmd = parent
-        .command('export <app-id-or-token>')
-        .description('导出指定应用的源码到本工程（创意应用升级：拉取创意稿作只读参考物）；接受应用 ID（app_xxx）或创意应用分享 token')
+        .command('export <app-id>')
+        .description('导出指定应用的源码到本工程（创意应用升级：拉取创意稿作只读参考物）')
         .option('--out <dir>', '输出目录（相对当前目录）', 'source_package/creative')
         .option('--checkpoint <n>', '按检查点版本导出；缺省为最新提交（HEAD）')
         .addHelpText('after', `
 说明
-  从服务端导出源应用（可以不是当前应用）的源码归档并解压到 --out 目录，导出完成后写
-  --out/.upgrade-manifest.json（含 sourceAppId / 导出时间 / 文件数），供升级链路幂等
-  判定与 skill 发现使用。调用者须为源应用协作者（服务端 DOWNLOAD 鉴权）。
-  <app-id-or-token> 两种形态等价：应用 ID（app_xxx）或创意应用分享 token。拿到的是
-  分享链接（https://<tenant>.feishu.cn/page/<token>）时，提取其中 /page/ 后的 <token> 段传入。
-  请求以当前应用（MIAODA_APP_ID）为路径主体、源应用走 sourceAppID / sourceMetaToken 参数。
+  从服务端导出 <app-id> 对应应用（源应用，可以不是当前应用）的源码归档并解压到 --out
+  目录，导出完成后写 --out/.upgrade-manifest.json（含 sourceAppId / 导出时间 / 文件数），
+  供升级链路幂等判定与 skill 发现使用。调用者须为源应用协作者（服务端 DOWNLOAD 鉴权）。
+  请求以当前应用（MIAODA_APP_ID）为路径主体、源应用走 sourceAppID 参数。
 
 幂等
-  --out 已存在 manifest 且源定位（sourceAppId / sourceMetaToken）一致时跳过导出
-  （skipped=true），重复调用安全。
+  --out 已存在 manifest 且 sourceAppId 一致时跳过导出（skipped=true），重复调用安全。
 
 JSON 输出
   {"data": {"appId": "...", "out": "source_package/creative", "fileCount": <n>,
             "archiveName": "...", "skipped": false}}
   跳过时：{"data": {"appId": "...", "out": "...", "skipped": true, "reason": "already_exported"}}
-  appId 始终是实际导出的源应用 ID（传 token 时为服务端反查结果）。
 
 失败
   源应用无可导出内容（从未提交过代码）→ EXPORT_EMPTY_ARCHIVE，请先在源应用完成一轮创作。
-  非源应用协作者 → EXPORT_PERMISSION_DENIED，权限问题，重试无效，需应用所有者加协作者。
-  应用 ID 不存在，或 token 未找到对应应用 → EXPORT_APP_NOT_FOUND，核对入参，重试无效。
+  无权限（非源应用协作者）→ 服务端鉴权错误透传。
 
 示例
   $ miaoda app export app_demo_source
-  $ miaoda app export DemoPageTokenAbCdEf123456789
+  $ miaoda app export app_demo_source --out source_package/creative
   $ miaoda app export app_demo_source --checkpoint 3
 `);
     cmd.action((0, shared_1.withHelp)(cmd, async (appId, rawOpts) => {

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

@@ -46,29 +46,6 @@ const api = __importStar(require("../../../api/index"));
 const error_1 = require("../../../utils/error");
 const output_1 = require("../../../utils/output");
 const logger_1 = require("../../../utils/logger");
-/** 妙搭应用 ID 形态：`app_` + 字母数字下划线。非此形态按创意应用分享 token 处理。 */
-const MIAODA_APP_ID_PATTERN = /^app_\w{1,64}$/;
-/** 分享 token 宽松形态：16-128 位字母数字（CCM token 实际 20+ 位）。只拦明显不是 token 的输入（误传 flag / 短串），不追平服务端精确口径。 */
-const META_TOKEN_PATTERN = /^[A-Za-z0-9_-]{16,128}$/;
-/**
- * 解析位置参数为源应用定位：app_xxx → appId；满足 token 宽松形态的串 → metaToken 透传
- * （精确校验交给服务端反查，避免和服务端口径漂移）。不支持直接传分享链接——调用方
- * （上游 agent）自行从链接提取 /page/<token> 段后传 token。
- */
-function parseSourceRef(raw) {
-    if (MIAODA_APP_ID_PATTERN.test(raw)) {
-        return { appId: raw };
-    }
-    if (!META_TOKEN_PATTERN.test(raw)) {
-        throw new error_1.AppError('ARGS_INVALID', `无法识别的源应用定位：${raw}`, {
-            next_actions: [
-                '接受两种形态：应用 ID（app_xxx）或创意应用分享 token（16 位以上字母数字）',
-                '拿到的是分享链接（https://<tenant>.feishu.cn/page/<token>）时，请提取其中 /page/ 后的 <token> 段传入',
-            ],
-        });
-    }
-    return { metaToken: raw };
-}
 /** 导出目录默认值：创意升级链路的参考物约定位置。 */
 exports.DEFAULT_EXPORT_OUT = 'source_package/creative';
 /** 升级 manifest 文件名：前置钩子幂等标记 / skill workspace-contains 锚点 / skill 第 0 步信息源。 */
@@ -120,7 +97,7 @@ function countFiles(dir) {
     return count;
 }
 /**
- * miaoda app export <app-id-or-token> [--out <dir>] [--checkpoint <n>]
+ * miaoda app export <app-id> [--out <dir>] [--checkpoint <n>]
  *
  * 创意应用升级链路：把源应用（创意稿）的源码从服务端导出到本工程，作为只读参考物。
  * 链路：studio_server InnerGetCodeArchive（inner 通道，force 身份鉴权：调用者须为源应用
@@ -128,18 +105,15 @@ function countFiles(dir) {
  * skill workspace-contains 锚点 + skill 第 0 步信息源）。
  *
  * URL 形状：path :appID 是当前沙箱应用（网关强校验其与沙箱 AK 一致），源应用走 query
- * （sourceAppID 或 sourceMetaToken 二选一）—— 跨应用（升级常态：新应用沙箱里导出源
- * 创意应用）必须如此。位置参数接受应用 ID / 分享 token 两种形态。
+ * sourceAppID —— 跨应用（升级常态：新应用沙箱里导出源创意应用）必须如此。
  *
- * 幂等：--out 已存在 manifest 且源定位（sourceAppId / sourceMetaToken）一致时跳过导出
- * 直接返回（重试/多轮不重复拉取）。
+ * 幂等：--out 已存在 manifest 且 sourceAppId 一致时跳过导出直接返回（重试/多轮不重复拉取）。
  */
 async function handleAppExport(opts) {
-    const rawSource = (opts.appId || '').trim();
-    if (!rawSource) {
-        throw new error_1.AppError('ARGS_INVALID', 'app-id-or-token 不能为空');
+    const appId = (opts.appId || '').trim();
+    if (!appId) {
+        throw new error_1.AppError('ARGS_INVALID', 'app-id 不能为空');
     }
-    const source = parseSourceRef(rawSource);
     // 当前沙箱应用：网关 AK 校验要求 path :appID 与沙箱绑定应用一致
     const currentAppId = (opts.currentAppId || '').trim();
     if (!currentAppId) {
@@ -150,24 +124,13 @@ async function handleAppExport(opts) {
     const outRel = normalizeOutDir(opts.out ?? exports.DEFAULT_EXPORT_OUT);
     const outDir = node_path_1.default.resolve(process.cwd(), outRel);
     const manifestPath = node_path_1.default.join(outDir, exports.UPGRADE_MANIFEST_FILENAME);
-    // 幂等：同源应用已导出过则直接复用（前置钩子重试 / 多轮对话不重复拉取）。
-    // token 入参时按 manifest 记录的 sourceMetaToken 比对（导出前拿不到反查后的 appId）。
+    // 幂等：同源应用已导出过则直接复用（前置钩子重试 / 多轮对话不重复拉取）
     if (node_fs_1.default.existsSync(manifestPath)) {
         try {
             const prev = JSON.parse(node_fs_1.default.readFileSync(manifestPath, 'utf-8'));
-            const matched = source.appId
-                ? prev.sourceAppId === source.appId
-                : prev.sourceMetaToken === source.metaToken;
-            if (matched) {
+            if (prev.sourceAppId === appId) {
                 (0, logger_1.log)('export', `Already exported (manifest matched), skip: ${outRel}`);
-                (0, output_1.emit)({
-                    data: {
-                        appId: prev.sourceAppId ?? '',
-                        out: outRel,
-                        skipped: true,
-                        reason: 'already_exported',
-                    },
-                });
+                (0, output_1.emit)({ data: { appId, out: outRel, skipped: true, reason: 'already_exported' } });
                 return;
             }
         }
@@ -175,11 +138,10 @@ async function handleAppExport(opts) {
             // manifest 损坏视为未导出，走覆盖导出
         }
     }
-    (0, logger_1.log)('export', `Fetching code archive of ${source.appId ?? 'meta token source'}...`);
+    (0, logger_1.log)('export', `Fetching code archive of ${appId}...`);
     const resp = await api.app.getCodeArchive({
         appID: currentAppId,
-        sourceAppID: source.appId,
-        sourceMetaToken: source.metaToken,
+        sourceAppID: appId,
         checkpointID: opts.checkpoint,
     });
     const fileBase64 = resp.file ?? '';
@@ -195,11 +157,9 @@ async function handleAppExport(opts) {
     if (archive.length > MAX_ARCHIVE_BYTES) {
         throw new error_1.AppError('EXPORT_ARCHIVE_TOO_LARGE', `归档超过大小上限（${String(archive.length)} > ${String(MAX_ARCHIVE_BYTES)} bytes）`);
     }
-    // 实际导出的源应用 ID：服务端回传优先（token 入参时为反查结果），appId 入参时兜底自身
-    const resolvedSourceAppId = resp.sourceAppID ?? source.appId ?? '';
     // 归档先落临时文件再解压；解压成功前不动已存在的 outDir 内容之外的文件
     const tmpDir = node_fs_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), 'miaoda-export-'));
-    const archivePath = node_path_1.default.join(tmpDir, resp.name ?? `${resolvedSourceAppId || 'source'}.zip`);
+    const archivePath = node_path_1.default.join(tmpDir, resp.name ?? `${appId}.zip`);
     try {
         node_fs_1.default.writeFileSync(archivePath, archive);
         node_fs_1.default.mkdirSync(outDir, { recursive: true });
@@ -217,9 +177,7 @@ async function handleAppExport(opts) {
     node_fs_1.default.rmSync(node_path_1.default.join(outDir, '.gitignore'), { force: true });
     const fileCount = countFiles(outDir);
     const manifest = {
-        sourceAppId: resolvedSourceAppId,
-        // token 入参时记录 token 供幂等比对；appId 入参时不写该字段
-        ...(source.metaToken ? { sourceMetaToken: source.metaToken } : {}),
+        sourceAppId: appId,
         archiveName: resp.name ?? '',
         checkpointId: opts.checkpoint ?? 0,
         exportedAt: new Date().toISOString(),
@@ -228,12 +186,6 @@ async function handleAppExport(opts) {
     node_fs_1.default.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n', 'utf-8');
     (0, logger_1.log)('export', 'Exported successfully');
     (0, output_1.emit)({
-        data: {
-            appId: resolvedSourceAppId,
-            out: outRel,
-            fileCount,
-            archiveName: manifest.archiveName,
-            skipped: false,
-        },
+        data: { appId, out: outRel, fileCount, archiveName: manifest.archiveName, skipped: false },
     });
 }

package/dist/config/migrate-configs/html-to-design-html.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * html → design-html 的跨 stack 迁移规则。
+ *
+ * html stack：应用文件在 src/（src/index.html 等），dev/build 走
+ * @lark-apaas/coding-html-devserver（devDependency + scripts.dev/build + package-lock）。
+ * design-html stack：buildless —— 文件直接放项目根（任意深度），无依赖、无 scripts，
+ * deploy 由 CLI 闭环（扫 *.html 生成 routes.json，见 services/deploy/modern/atoms/design-build）。
+ *
+ * 设计原则：**最小改动**。三件事 —— 布局搬迁、devserver 工具链清理、set-stack：
+ *   1. src/ 内容整体搬到项目根（merge：同名冲突 src/ 侧覆盖，搬完删 src/）
+ *   2. 清 devserver 残留：package-lock.json + package.json 的 dev/build scripts 与
+ *      coding-html-devserver devDependency（design-html 模板的 package.json 无任何
+ *      依赖 / scripts，用户其余自定义字段一律保留）
+ *   3. set-stack 切 .spark/meta.json（archType / templateVersion 由 handler 从
+ *      design-html template 包回写）
+ *
+ * 不做的事：
+ *   - 不从 design-html template 拷任何文件（模板本身只有 _gitignore + package.json；
+ *     用户已有的 .gitignore 是 html 版超集，保留无害）
+ *   - 不动 README.md / .npmrc / .env —— 部署时均被 EXCLUDES 过滤
+ *   - 不管 dev 进程 / MIAODA_APP_TYPE 切换（平台职责；沙箱 pkill 匹配的
+ *     scripts/dev.js 在 html 项目里不存在，自然跳过）
+ *
+ * handler 收尾的 npm install 照常跑：devserver 依赖删掉后重新生成精简 lockfile，
+ * 部署时被 EXCLUDES 过滤，无害；不为此引入 skip-install 能力。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MIGRATE_CONFIG = void 0;
+exports.MIGRATE_CONFIG = {
+    from: 'html',
+    to: 'design-html',
+    rules: [
+        // ===== 1. 布局搬迁：src/ 内容整体搬到项目根 =====
+        // 目标 '.'（项目根）已存在 → 走 merge 分支：src/ 每个 entry overlay 到根，
+        // 同名冲突 src/ 侧覆盖，完成后删除 src/。相对引用路径不变。
+        { type: 'move-directory', from: 'src', to: '.' },
+        // ===== 2. 清理 devserver 工具链残留 =====
+        // 依赖集合变了（清空），lockfile 删掉由 handler 收尾的 npm install 重新生成
+        { type: 'delete-file', to: 'package-lock.json' },
+        {
+            type: 'delete-json-keys',
+            to: 'package.json',
+            keys: [
+                // coding-html-devserver 的 dev/build 入口，design-html 无 scripts
+                'scripts.dev',
+                'scripts.build',
+                // devserver 工具链本体
+                'devDependencies.@lark-apaas/coding-html-devserver',
+            ],
+        },
+        // ===== 3. 切 stack =====
+        { type: 'set-stack', stack: 'design-html' },
+    ],
+};
+exports.default = exports.MIGRATE_CONFIG;

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

@@ -18,9 +18,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getMigrateConfig = getMigrateConfig;
 exports.listSupportedMigrations = listSupportedMigrations;
 const vite_react_to_nestjs_react_fullstack_1 = __importDefault(require("./vite-react-to-nestjs-react-fullstack"));
+const html_to_design_html_1 = __importDefault(require("./html-to-design-html"));
 /** key 格式：`<from>:<to>` */
 const MIGRATE_REGISTRY = {
     'vite-react:nestjs-react-fullstack': vite_react_to_nestjs_react_fullstack_1.default,
+    'html:design-html': html_to_design_html_1.default,
 };
 /** 返回 (from, to) 对应的 MigrateConfig；未注册时返回 null。 */
 function getMigrateConfig(from, to) {

package/dist/utils/devops-error.js

@@ -1,38 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BizErrCode = void 0;
 exports.mapDevopsError = mapDevopsError;
 const error_1 = require("./error");
-exports.BizErrCode = {
-    /** devops：应用不存在（含把非应用 ID 当 app-id 传入的情况） */
-    DEVOPS_APP_NOT_FOUND: '400002577',
-    /** devops：应用不存在（另一路径，与上同义） */
-    DEVOPS_APP_NOT_FOUND_ALT: '400002569',
-    /** devops：无应用权限 */
-    DEVOPS_APP_PERMISSION_DENIED: '400002579',
-    /** devops：参数非法（如 name / description 超长） */
-    DEVOPS_INVALID_ARG: '400002575',
-    /** studio_server：ErrUnauthenticated —— 身份换取失败或未通过资源鉴权 */
-    STUDIO_UNAUTHENTICATED: '400002671',
-    /** studio_server：ErrStudioAppNotFound —— meta_token 无效或未绑定妙搭应用 */
-    STUDIO_APP_NOT_FOUND: '400002667',
-};
 /**
  * 把 BAM lark.apaas.devops 的业务码（数字字符串）映射成 CLI 错误码。
+ * 来源：服务端技术方案 wiki L7P8wlNQ5iyShLkxzlOcCo8LnTg「业务错误码映射表」。
  *
  * 放在 utils 下而不是某个具体 api 域里：app / deploy 都跑在 lark.apaas.devops
  * 这同一 PSM，业务码命名空间也共享；boundaries 规则又禁止 api 域间互引。
  */
 function mapDevopsError(bizCode, message) {
     switch (bizCode) {
-        case exports.BizErrCode.DEVOPS_APP_NOT_FOUND:
-        case exports.BizErrCode.DEVOPS_APP_NOT_FOUND_ALT:
+        case '400002577':
+        case '400002569':
             return new error_1.AppError('APP_NOT_FOUND', message, {
                 next_actions: ['Run `miaoda app list` to see available apps'],
             });
-        case exports.BizErrCode.DEVOPS_APP_PERMISSION_DENIED:
+        case '400002579':
             return new error_1.AppError('APP_PERMISSION_DENIED', message);
-        case exports.BizErrCode.DEVOPS_INVALID_ARG:
+        case '400002575':
             return new error_1.AppError('INVALID_ARG_VALUE', message, {
                 next_actions: ['缩短 --name / --description 后重试（后端有长度限制）'],
             });

package/package.json

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