@ttmg/cli 0.4.6-vibe-beta.2 → 0.4.6-vibe-beta.4

package/dist/index.js

@@ -13,6 +13,8 @@ var fs = require('fs');
 var handlebars = require('handlebars');
 var esbuild = require('esbuild');
 var worker_threads = require('worker_threads');
+var child_process = require('child_process');
+var http = require('http');
 var jsdom = require('jsdom');
 var prettier = require('prettier');
 var express = require('express');
@@ -29,7 +31,6 @@ var require$$0 = require('util');
 var require$$0$1 = require('events');
 var require$$0$2 = require('buffer');
 var require$$1$2 = require('stream');
-var http = require('http');
 var https = require('https');
 var dns = require('dns');
 var boxen = require('boxen');
@@ -46,7 +47,6 @@ var fs$1 = require('node:fs');
 var path$1 = require('node:path');
 var zlib = require('zlib');
 var promises = require('fs/promises');
-var child_process = require('child_process');
 
 function _interopNamespaceDefault(e) {
     var n = Object.create(null);
@@ -68,9 +68,9 @@ function _interopNamespaceDefault(e) {
 var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
 var os__namespace = /*#__PURE__*/_interopNamespaceDefault(os);
 var fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs);
+var http__namespace = /*#__PURE__*/_interopNamespaceDefault(http);
 var net__namespace = /*#__PURE__*/_interopNamespaceDefault(net);
 var require$$1__namespace = /*#__PURE__*/_interopNamespaceDefault(require$$1$1);
-var http__namespace = /*#__PURE__*/_interopNamespaceDefault(http);
 var dns__namespace = /*#__PURE__*/_interopNamespaceDefault(dns);
 var glob__namespace = /*#__PURE__*/_interopNamespaceDefault(glob);
 var fs__namespace$1 = /*#__PURE__*/_interopNamespaceDefault(fs$1);
@@ -7221,6 +7221,7 @@ const messages = {
         'cli.command.dev.noOpen': 'Do not open the DevTool page automatically',
         'cli.command.dev.evidenceDir': 'Session evidence output directory',
         'cli.command.dev.timeout': 'Stop a structured session after this many seconds',
+        'cli.command.dev.outputConflict': 'Dev output modes cannot be combined. Use either --format json for one manifest or --events ndjson for a lifecycle event stream.',
         'cli.command.dev.session.desc': 'Inspect and stop local DevTool sessions',
         'cli.command.dev.session.inspect': 'Inspect one local DevTool session',
         'cli.command.dev.session.list': 'List local DevTool sessions',
@@ -7253,6 +7254,8 @@ const messages = {
         'cli.command.upload.note': 'Note for the upload',
         'cli.command.upload.dir': 'Game project directory (default: current directory)',
         'cli.command.upload.preview': 'Wait for platform processing and output the preview payload',
+        'cli.command.upload.servePreviewPage': 'Serve a temporary local preview page with test-account and preview QR codes',
+        'cli.command.upload.noOpen': 'Do not open the local preview page in the default browser',
         'cli.command.upload.format': 'Output format: text | json | ndjson',
         'cli.command.testAccount.desc': 'Manage Mini Game test-account access',
         'cli.command.testAccount.add.desc': 'Generate the authorization entry for adding a TikTok test account',
@@ -7386,6 +7389,17 @@ const messages = {
         'upload.spinner.processing': 'Waiting for platform processing (status: {status})...',
         'upload.success': 'Upload success! View version at: {url}',
         'upload.previewSuccess': 'Preview version is ready: {url}',
+        'upload.previewPageReady': 'Local preview page: {url}',
+        'upload.previewPageHeading': 'Preview page',
+        'upload.previewPageOpenInBrowser': 'Open in browser',
+        'upload.previewPageAccessScope': 'Access scope',
+        'upload.previewPageSameMachine': 'Same machine only',
+        'upload.previewPageTerminalMode': 'Terminal fallback',
+        'upload.previewPageClickableLink': 'Clickable link',
+        'upload.previewPageExpiresAt': 'Expires at',
+        'upload.previewPageOpening': 'Opening the preview page in your browser...',
+        'upload.previewPageOpenFailed': 'Could not open the browser automatically. Use the link above.',
+        'upload.previewPageFailed': 'The preview was uploaded, but the local preview page failed: {error}',
         'upload.fail': 'Upload failed: {error}',
         'upload.error.noClientKey': 'Client Key is required for upload. Use --client-key <key>',
         'upload.error.notLoggedIn': 'Not logged in. Please run `ttmg login` first.',
@@ -7400,6 +7414,7 @@ const messages = {
         'upload.error.assetTimeout': 'Timed out waiting for platform asset processing.',
         'upload.error.previewTimeout': 'Timed out waiting for the preview URL.',
         'upload.error.previewQueryFailed': 'Failed to query the preview URL from the platform.',
+        'upload.error.previewPageRequiresPreview': '--serve-preview-page requires --preview.',
         'testAccount.success': 'Test-account authorization entry generated.',
         'testAccount.project': 'Project: {name} ({clientKey})',
         'testAccount.authorizationUrl': 'Authorization URL: {url}',
@@ -7441,6 +7456,7 @@ const messages = {
         'cli.command.dev.noOpen': '不自动打开 DevTool 页面',
         'cli.command.dev.evidenceDir': '会话证据输出目录',
         'cli.command.dev.timeout': '在指定秒数后停止结构化调试会话',
+        'cli.command.dev.outputConflict': 'Dev 输出模式不能同时使用：请用 --format json 输出一份 manifest，或用 --events ndjson 输出生命周期事件流。',
         'cli.command.dev.session.desc': '查询和停止本地 DevTool 会话',
         'cli.command.dev.session.inspect': '查询一个本地 DevTool 会话',
         'cli.command.dev.session.list': '列出本地 DevTool 会话',
@@ -7473,6 +7489,8 @@ const messages = {
         'cli.command.upload.note': '上传备注',
         'cli.command.upload.dir': '小游戏项目根目录（默认为当前目录）',
         'cli.command.upload.preview': '等待平台处理并输出预览二维码原始内容',
+        'cli.command.upload.servePreviewPage': '启动包含测试账号与预览二维码的临时本地页面',
+        'cli.command.upload.noOpen': '不使用默认浏览器打开本地预览页面',
         'cli.command.upload.format': '输出格式：text | json | ndjson',
         'cli.command.testAccount.desc': '管理小游戏测试账号访问',
         'cli.command.testAccount.add.desc': '生成添加 TikTok 测试账号的授权入口',
@@ -7606,6 +7624,17 @@ const messages = {
         'upload.spinner.processing': '正在等待平台处理（状态：{status}）...',
         'upload.success': '上传成功！可在以下地址查看版本：{url}',
         'upload.previewSuccess': '预览版本已就绪：{url}',
+        'upload.previewPageReady': '本地预览页面：{url}',
+        'upload.previewPageHeading': '预览页面',
+        'upload.previewPageOpenInBrowser': '浏览器打开',
+        'upload.previewPageAccessScope': '访问范围',
+        'upload.previewPageSameMachine': '仅当前设备',
+        'upload.previewPageTerminalMode': '终端降级',
+        'upload.previewPageClickableLink': '可点击链接',
+        'upload.previewPageExpiresAt': '过期时间',
+        'upload.previewPageOpening': '正在使用浏览器打开预览页面...',
+        'upload.previewPageOpenFailed': '无法自动打开浏览器，请使用上方链接。',
+        'upload.previewPageFailed': '预览版本已上传，但本地预览页面启动失败：{error}',
         'upload.fail': '上传失败：{error}',
         'upload.error.noClientKey': '上传必须提供 Client Key，请使用 --client-key <key> 参数',
         'upload.error.notLoggedIn': '未登录，请先执行 `ttmg login` 登录开发者平台账号。',
@@ -7620,6 +7649,7 @@ const messages = {
         'upload.error.assetTimeout': '等待平台处理上传版本超时。',
         'upload.error.previewTimeout': '等待平台生成预览地址超时。',
         'upload.error.previewQueryFailed': '查询平台预览地址失败。',
+        'upload.error.previewPageRequiresPreview': '--serve-preview-page 必须与 --preview 一起使用。',
         'testAccount.success': '测试账号授权入口已生成。',
         'testAccount.project': '项目：{name}（{clientKey}）',
         'testAccount.authorizationUrl': '授权地址：{url}',
@@ -8226,6 +8256,9 @@ const zipCwdToBuffer = (customIgnores = [], targetDir = process.cwd()) => {
         const defaultIgnores = [
             'node_modules/**',
             '.git/**',
+            '.agent/**',
+            '.claude/**',
+            '.trae/**',
             '.DS_Store',
             ttmgPack.TTMG_TEMP_DIR,
             `${ttmgPack.TTMG_TEMP_DIR}/**`,
@@ -8245,495 +8278,159 @@ const zipCwdToBuffer = (customIgnores = [], targetDir = process.cwd()) => {
     });
 };
 
-const DEFAULT_POLL_INTERVAL_MS = 3000;
-const DEFAULT_POLL_TIMEOUT_MS = 10 * 60 * 1000;
-const defaultDependencies$6 = {
-    getCurrentUser,
-    fetchGameInfo,
-    zipDirectory: targetDir => zipCwdToBuffer([], targetDir),
-    uploadGameToPlatform,
-    fetchGameAssets,
-    fetchGameAssetPreviewUrl,
-    sleep: ms => new Promise(resolve => setTimeout(resolve, ms)),
-    now: () => Date.now(),
-    pollIntervalMs: DEFAULT_POLL_INTERVAL_MS,
-    pollTimeoutMs: DEFAULT_POLL_TIMEOUT_MS,
-};
-function normalizeOutputFormat(format) {
-    const normalized = (format || 'text').toLowerCase();
-    if (normalized !== 'text' &&
-        normalized !== 'json' &&
-        normalized !== 'ndjson') {
-        throw new Error(t('upload.error.invalidFormat', { format: normalized }));
-    }
-    return normalized;
-}
-function getAssetStatusRaw(asset) {
-    return asset?.cdn_deploy_status ?? asset?.status ?? null;
-}
-function normalizeUploadPlatformStatus(rawStatus) {
-    if (rawStatus === null || rawStatus === undefined || rawStatus === '') {
-        return 'waiting_for_asset';
-    }
-    const numericStatus = Number(rawStatus);
-    if (Number.isInteger(numericStatus)) {
-        if (numericStatus === 0)
-            return 'unknown';
-        if (numericStatus === 1)
-            return 'pending';
-        if (numericStatus === 2)
-            return 'success';
-        if (numericStatus === 3)
-            return 'failed';
-        if (numericStatus === 4)
-            return 'processing';
-        return 'unknown';
-    }
-    const normalized = String(rawStatus).trim().toLowerCase();
-    const statusName = normalized.replace(/^deploy_status_/, '');
-    if (['ready', 'success', 'succeeded', 'available'].includes(statusName)) {
-        return 'success';
-    }
-    if (statusName.includes('fail') ||
-        statusName.includes('error') ||
-        statusName.includes('reject')) {
-        return 'failed';
-    }
-    if (statusName.includes('process') ||
-        statusName.includes('upload') ||
-        statusName.includes('deploy')) {
-        return 'processing';
-    }
-    if (statusName.includes('pending') ||
-        statusName.includes('queue') ||
-        statusName.includes('wait')) {
-        return 'pending';
-    }
-    return 'unknown';
-}
-function getAssetState(asset) {
-    const platformStatus = normalizeUploadPlatformStatus(getAssetStatusRaw(asset));
-    if (platformStatus === 'success') {
-        return 'ready';
-    }
-    if (platformStatus === 'failed') {
-        return 'failed';
-    }
-    return 'pending';
+var server = {};
+
+var canPromise;
+var hasRequiredCanPromise;
+
+function requireCanPromise () {
+	if (hasRequiredCanPromise) return canPromise;
+	hasRequiredCanPromise = 1;
+	// can-promise has a crash in some versions of react native that dont have
+	// standard global objects
+	// https://github.com/soldair/node-qrcode/issues/157
+
+	canPromise = function () {
+	  return typeof Promise === 'function' && Promise.prototype && Promise.prototype.then
+	};
+	return canPromise;
 }
-function extractAssets(data) {
-    if (!data) {
-        return [];
-    }
-    return [
-        data.preview_assets,
-        data.in_review_assets,
-        data.live_assets,
-        data.assets,
-    ].flatMap(group => (Array.isArray(group) ? group : []));
+
+var qrcode = {};
+
+var utils$1 = {};
+
+var hasRequiredUtils$1;
+
+function requireUtils$1 () {
+	if (hasRequiredUtils$1) return utils$1;
+	hasRequiredUtils$1 = 1;
+	let toSJISFunction;
+	const CODEWORDS_COUNT = [
+	  0, // Not used
+	  26, 44, 70, 100, 134, 172, 196, 242, 292, 346,
+	  404, 466, 532, 581, 655, 733, 815, 901, 991, 1085,
+	  1156, 1258, 1364, 1474, 1588, 1706, 1828, 1921, 2051, 2185,
+	  2323, 2465, 2611, 2761, 2876, 3034, 3196, 3362, 3532, 3706
+	];
+
+	/**
+	 * Returns the QR Code size for the specified version
+	 *
+	 * @param  {Number} version QR Code version
+	 * @return {Number}         size of QR code
+	 */
+	utils$1.getSymbolSize = function getSymbolSize (version) {
+	  if (!version) throw new Error('"version" cannot be null or undefined')
+	  if (version < 1 || version > 40) throw new Error('"version" should be in range from 1 to 40')
+	  return version * 4 + 17
+	};
+
+	/**
+	 * Returns the total number of codewords used to store data and EC information.
+	 *
+	 * @param  {Number} version QR Code version
+	 * @return {Number}         Data length in bits
+	 */
+	utils$1.getSymbolTotalCodewords = function getSymbolTotalCodewords (version) {
+	  return CODEWORDS_COUNT[version]
+	};
+
+	/**
+	 * Encode data with Bose-Chaudhuri-Hocquenghem
+	 *
+	 * @param  {Number} data Value to encode
+	 * @return {Number}      Encoded value
+	 */
+	utils$1.getBCHDigit = function (data) {
+	  let digit = 0;
+
+	  while (data !== 0) {
+	    digit++;
+	    data >>>= 1;
+	  }
+
+	  return digit
+	};
+
+	utils$1.setToSJISFunction = function setToSJISFunction (f) {
+	  if (typeof f !== 'function') {
+	    throw new Error('"toSJISFunc" is not a valid function.')
+	  }
+
+	  toSJISFunction = f;
+	};
+
+	utils$1.isKanjiModeEnabled = function () {
+	  return typeof toSJISFunction !== 'undefined'
+	};
+
+	utils$1.toSJIS = function toSJIS (kanji) {
+	  return toSJISFunction(kanji)
+	};
+	return utils$1;
 }
-function extractPreviewUrl(data) {
-    return typeof data?.preview_url === 'string' ? data.preview_url : '';
-}
-function createEvent(base, status, progress, overrides = {}) {
-    return {
-        schemaVersion: '1',
-        operationId: base.operationId,
-        ts: Date.now(),
-        clientKey: base.clientKey,
-        versionId: '',
-        status,
-        progress,
-        previewUrl: '',
-        qrPayload: '',
-        platformUrl: '',
-        error: null,
-        errorCode: null,
-        platformWrite: false,
-        ...overrides,
-    };
-}
-async function waitForAssetReady({ assetId, miniGameId, deadline, eventBase, onEvent, deps, }) {
-    let lastPlatformStatusRaw = null;
-    let hasEmittedPlatformStatus = false;
-    while (deps.now() < deadline) {
-        const response = await deps.fetchGameAssets({ miniGameId });
-        if (response.error) {
-            throw new Error(response.error?.StatusMessage ||
-                response.error?.message ||
-                t('upload.error.assetQueryFailed'));
-        }
-        const asset = extractAssets(response.data).find(item => String(item.asset_id || '') === assetId) || null;
-        const platformStatusRaw = getAssetStatusRaw(asset);
-        const platformStatus = normalizeUploadPlatformStatus(platformStatusRaw);
-        if (!hasEmittedPlatformStatus ||
-            platformStatusRaw !== lastPlatformStatusRaw) {
-            hasEmittedPlatformStatus = true;
-            lastPlatformStatusRaw = platformStatusRaw;
-            onEvent(createEvent(eventBase, 'processing', 0.7, {
-                versionId: assetId,
-                platformStatus,
-                ...(platformStatusRaw === null ? {} : { platformStatusRaw }),
-                platformWrite: true,
-            }));
-        }
-        const assetState = getAssetState(asset);
-        if (assetState === 'ready') {
-            return asset;
-        }
-        if (assetState === 'failed') {
-            throw new Error(t('upload.error.assetFailed', { status: platformStatus }));
-        }
-        await deps.sleep(deps.pollIntervalMs);
-    }
-    throw new Error(t('upload.error.assetTimeout'));
-}
-async function waitForPreviewUrl({ assetId, deadline, deps, }) {
-    while (deps.now() < deadline) {
-        const response = await deps.fetchGameAssetPreviewUrl({ assetId });
-        if (response.error) {
-            throw new Error(response.error?.StatusMessage ||
-                response.error?.message ||
-                t('upload.error.previewQueryFailed'));
-        }
-        const previewUrl = extractPreviewUrl(response.data);
-        if (previewUrl) {
-            return previewUrl;
-        }
-        await deps.sleep(deps.pollIntervalMs);
-    }
-    throw new Error(t('upload.error.previewTimeout'));
-}
-async function executeUpload(options, dependencies = {}) {
-    const deps = { ...defaultDependencies$6, ...dependencies };
-    const clientKey = options.clientKey?.trim();
-    const note = options.note || '--';
-    const eventBase = { operationId: options.operationId, clientKey };
-    const emit = options.onEvent;
-    emit(createEvent(eventBase, 'precheck', 0.05));
-    const user = deps.getCurrentUser();
-    if (!user || !user.cookie) {
-        throw new Error(t('upload.error.notLoggedIn'));
-    }
-    if (!clientKey) {
-        throw new Error(t('upload.error.noClientKey'));
-    }
-    const infoResponse = await deps.fetchGameInfo(clientKey);
-    if (infoResponse.error) {
-        throw new Error(infoResponse.error.errorMsg || t('upload.error.gameInfoFailed'));
-    }
-    const appId = infoResponse.data?.app_id || '';
-    const projectName = infoResponse.data?.name || 'game';
-    if (!appId) {
-        throw new Error(t('upload.error.noAppId'));
-    }
-    const targetDir = options.dir
-        ? path.resolve(process.cwd(), options.dir)
-        : process.cwd();
-    if (!fs.existsSync(targetDir) || !fs.statSync(targetDir).isDirectory()) {
-        throw new Error(t('upload.error.dirNotExist', { dir: targetDir }));
-    }
-    emit(createEvent(eventBase, 'packaging', 0.2, { appId, projectName }));
-    const zipBuffer = await deps.zipDirectory(targetDir);
-    const packageSizeBytes = zipBuffer.length;
-    emit(createEvent(eventBase, 'uploading', 0.4, {
-        appId,
-        projectName,
-        packageSizeBytes,
-    }));
-    const uploadResponse = await deps.uploadGameToPlatform({
-        data: zipBuffer.buffer.slice(zipBuffer.byteOffset, zipBuffer.byteOffset + zipBuffer.byteLength),
-        name: projectName,
-        clientKey,
-        note,
-        appId,
-    });
-    if (uploadResponse.error) {
-        throw new Error(uploadResponse.error.message || t('upload.error.platformUploadFailed'));
-    }
-    const assetId = String(uploadResponse.data?.asset_id || '');
-    const platformUrl = uploadResponse.data?.detail || '';
-    if (!assetId) {
-        throw new Error(t('upload.error.missingAssetId'));
-    }
-    if (!options.preview) {
-        const event = createEvent(eventBase, 'ready', 1, {
-            appId,
-            projectName,
-            packageSizeBytes,
-            versionId: assetId,
-            platformUrl,
-            platformWrite: true,
-        });
-        emit(event);
-        return event;
-    }
-    const deadline = deps.now() + deps.pollTimeoutMs;
-    await waitForAssetReady({
-        assetId,
-        miniGameId: appId,
-        deadline,
-        eventBase,
-        onEvent: emit,
-        deps,
-    });
-    emit(createEvent(eventBase, 'processing', 0.85, {
-        appId,
-        projectName,
-        packageSizeBytes,
-        versionId: assetId,
-        platformStatus: 'resolving_preview',
-        platformUrl,
-        platformWrite: true,
-    }));
-    const previewUrl = await waitForPreviewUrl({ assetId, deadline, deps });
-    const event = createEvent(eventBase, 'ready', 1, {
-        appId,
-        projectName,
-        packageSizeBytes,
-        versionId: assetId,
-        previewUrl,
-        qrPayload: previewUrl,
-        platformUrl,
-        platformStatus: 'ready',
-        platformWrite: true,
-    });
-    emit(event);
-    return event;
-}
-function getHumanEventText(event) {
-    if (event.status === 'precheck') {
-        return t('upload.spinner.fetchInfo', { clientKey: event.clientKey });
-    }
-    if (event.status === 'packaging') {
-        return t('upload.spinner.zipping', { dir: '' });
-    }
-    if (event.status === 'uploading') {
-        return t('upload.spinner.uploading', {
-            size: ((event.packageSizeBytes || 0) / 1024 / 1024).toFixed(2),
-        });
-    }
-    if (event.status === 'processing') {
-        return t('upload.spinner.processing', {
-            status: event.platformStatus || 'pending',
-        });
-    }
-    return '';
-}
-async function upload(options) {
-    const format = normalizeOutputFormat(options.format);
-    const operationId = `upload_${crypto.randomUUID()}`;
-    const ora = await import('ora');
-    const spinner = format === 'text'
-        ? ora
-            .default({ spinner: 'dots', text: t('upload.spinner.start') })
-            .start()
-        : null;
-    let lastEvent = null;
-    const onEvent = (event) => {
-        lastEvent = event;
-        if (format === 'ndjson') {
-            console.log(JSON.stringify(event));
-            return;
-        }
-        const nextText = getHumanEventText(event);
-        if (nextText && spinner) {
-            spinner.text = chalk.cyan.bold(nextText);
-        }
-    };
-    try {
-        const result = await executeUpload({ ...options, operationId, onEvent });
-        if (format === 'json') {
-            console.log(JSON.stringify(result));
-        }
-        else if (format === 'text' && spinner) {
-            if (result.previewUrl) {
-                spinner.succeed(chalk.green.bold(t('upload.previewSuccess', { url: result.previewUrl })));
-            }
-            else {
-                spinner.succeed(chalk.green.bold(t('upload.success', { url: result.platformUrl })));
-            }
-        }
-        return result;
-    }
-    catch (error) {
-        const message = error?.message || String(error);
-        const failedEvent = createEvent({ operationId, clientKey: options.clientKey || '' }, 'failed', lastEvent?.progress || 0, {
-            appId: lastEvent?.appId,
-            projectName: lastEvent?.projectName,
-            packageSizeBytes: lastEvent?.packageSizeBytes,
-            versionId: lastEvent?.versionId || '',
-            platformUrl: lastEvent?.platformUrl || '',
-            platformStatus: lastEvent?.platformStatus,
-            platformStatusRaw: lastEvent?.platformStatusRaw,
-            platformWrite: lastEvent?.platformWrite || false,
-            errorCode: 'UPLOAD_FAILED',
-            error: message,
-        });
-        if (format === 'json' || format === 'ndjson') {
-            console.log(JSON.stringify(failedEvent));
-        }
-        else {
-            spinner?.fail(chalk.red.bold(t('upload.fail', { error: message })));
-        }
-        process.exitCode = 1;
-        return failedEvent;
-    }
-}
-
-var server = {};
-
-var canPromise;
-var hasRequiredCanPromise;
-
-function requireCanPromise () {
-	if (hasRequiredCanPromise) return canPromise;
-	hasRequiredCanPromise = 1;
-	// can-promise has a crash in some versions of react native that dont have
-	// standard global objects
-	// https://github.com/soldair/node-qrcode/issues/157
-
-	canPromise = function () {
-	  return typeof Promise === 'function' && Promise.prototype && Promise.prototype.then
-	};
-	return canPromise;
-}
-
-var qrcode = {};
-
-var utils$1 = {};
-
-var hasRequiredUtils$1;
-
-function requireUtils$1 () {
-	if (hasRequiredUtils$1) return utils$1;
-	hasRequiredUtils$1 = 1;
-	let toSJISFunction;
-	const CODEWORDS_COUNT = [
-	  0, // Not used
-	  26, 44, 70, 100, 134, 172, 196, 242, 292, 346,
-	  404, 466, 532, 581, 655, 733, 815, 901, 991, 1085,
-	  1156, 1258, 1364, 1474, 1588, 1706, 1828, 1921, 2051, 2185,
-	  2323, 2465, 2611, 2761, 2876, 3034, 3196, 3362, 3532, 3706
-	];
-
-	/**
-	 * Returns the QR Code size for the specified version
-	 *
-	 * @param  {Number} version QR Code version
-	 * @return {Number}         size of QR code
-	 */
-	utils$1.getSymbolSize = function getSymbolSize (version) {
-	  if (!version) throw new Error('"version" cannot be null or undefined')
-	  if (version < 1 || version > 40) throw new Error('"version" should be in range from 1 to 40')
-	  return version * 4 + 17
-	};
-
-	/**
-	 * Returns the total number of codewords used to store data and EC information.
-	 *
-	 * @param  {Number} version QR Code version
-	 * @return {Number}         Data length in bits
-	 */
-	utils$1.getSymbolTotalCodewords = function getSymbolTotalCodewords (version) {
-	  return CODEWORDS_COUNT[version]
-	};
-
-	/**
-	 * Encode data with Bose-Chaudhuri-Hocquenghem
-	 *
-	 * @param  {Number} data Value to encode
-	 * @return {Number}      Encoded value
-	 */
-	utils$1.getBCHDigit = function (data) {
-	  let digit = 0;
-
-	  while (data !== 0) {
-	    digit++;
-	    data >>>= 1;
-	  }
-
-	  return digit
-	};
-
-	utils$1.setToSJISFunction = function setToSJISFunction (f) {
-	  if (typeof f !== 'function') {
-	    throw new Error('"toSJISFunc" is not a valid function.')
-	  }
-
-	  toSJISFunction = f;
-	};
-
-	utils$1.isKanjiModeEnabled = function () {
-	  return typeof toSJISFunction !== 'undefined'
-	};
-
-	utils$1.toSJIS = function toSJIS (kanji) {
-	  return toSJISFunction(kanji)
-	};
-	return utils$1;
-}
-
-var errorCorrectionLevel = {};
-
-var hasRequiredErrorCorrectionLevel;
-
-function requireErrorCorrectionLevel () {
-	if (hasRequiredErrorCorrectionLevel) return errorCorrectionLevel;
-	hasRequiredErrorCorrectionLevel = 1;
-	(function (exports$1) {
-		exports$1.L = { bit: 1 };
-		exports$1.M = { bit: 0 };
-		exports$1.Q = { bit: 3 };
-		exports$1.H = { bit: 2 };
-
-		function fromString (string) {
-		  if (typeof string !== 'string') {
-		    throw new Error('Param is not a string')
-		  }
-
-		  const lcStr = string.toLowerCase();
-
-		  switch (lcStr) {
-		    case 'l':
-		    case 'low':
-		      return exports$1.L
-
-		    case 'm':
-		    case 'medium':
-		      return exports$1.M
-
-		    case 'q':
-		    case 'quartile':
-		      return exports$1.Q
-
-		    case 'h':
-		    case 'high':
-		      return exports$1.H
-
-		    default:
-		      throw new Error('Unknown EC Level: ' + string)
-		  }
-		}
-
-		exports$1.isValid = function isValid (level) {
-		  return level && typeof level.bit !== 'undefined' &&
-		    level.bit >= 0 && level.bit < 4
-		};
-
-		exports$1.from = function from (value, defaultValue) {
-		  if (exports$1.isValid(value)) {
-		    return value
-		  }
-
-		  try {
-		    return fromString(value)
-		  } catch (e) {
-		    return defaultValue
-		  }
-		}; 
-	} (errorCorrectionLevel));
-	return errorCorrectionLevel;
+
+var errorCorrectionLevel = {};
+
+var hasRequiredErrorCorrectionLevel;
+
+function requireErrorCorrectionLevel () {
+	if (hasRequiredErrorCorrectionLevel) return errorCorrectionLevel;
+	hasRequiredErrorCorrectionLevel = 1;
+	(function (exports$1) {
+		exports$1.L = { bit: 1 };
+		exports$1.M = { bit: 0 };
+		exports$1.Q = { bit: 3 };
+		exports$1.H = { bit: 2 };
+
+		function fromString (string) {
+		  if (typeof string !== 'string') {
+		    throw new Error('Param is not a string')
+		  }
+
+		  const lcStr = string.toLowerCase();
+
+		  switch (lcStr) {
+		    case 'l':
+		    case 'low':
+		      return exports$1.L
+
+		    case 'm':
+		    case 'medium':
+		      return exports$1.M
+
+		    case 'q':
+		    case 'quartile':
+		      return exports$1.Q
+
+		    case 'h':
+		    case 'high':
+		      return exports$1.H
+
+		    default:
+		      throw new Error('Unknown EC Level: ' + string)
+		  }
+		}
+
+		exports$1.isValid = function isValid (level) {
+		  return level && typeof level.bit !== 'undefined' &&
+		    level.bit >= 0 && level.bit < 4
+		};
+
+		exports$1.from = function from (value, defaultValue) {
+		  if (exports$1.isValid(value)) {
+		    return value
+		  }
+
+		  try {
+		    return fromString(value)
+		  } catch (e) {
+		    return defaultValue
+		  }
+		}; 
+	} (errorCorrectionLevel));
+	return errorCorrectionLevel;
 }
 
 var bitBuffer;
@@ -14889,7 +14586,732 @@ function requireLib () {
 var libExports = requireLib();
 var QRCode = /*@__PURE__*/getDefaultExportFromCjs(libExports);
 
-const defaultDependencies$5 = {
+const PREVIEW_PAGE_SERVER_WORKER_ARG = '__preview-page-server';
+const PREVIEW_PAGE_CONTENT_TYPE = 'text/html; charset=utf-8';
+const DEFAULT_PREVIEW_PAGE_TTL_MS = 60 * 60 * 1000;
+const DEFAULT_PREVIEW_PAGE_EXPIRED_NOTICE_TTL_MS = 60 * 60 * 1000;
+const PREVIEW_PAGE_PURPOSE = 'authorize_test_account_and_open_preview';
+const PREVIEW_PAGE_PRESENTATION = {
+    audience: 'user',
+    preferredSurface: 'browser',
+    preferredAction: 'open_url',
+    terminalInline: false,
+    fallback: 'show_clickable_link',
+    sameHostRequired: true,
+};
+const PREVIEW_PAGE_START_TIMEOUT_MS = 5000;
+const PREVIEW_PAGE_CONTROL_PATH = '/__ttmg/preview-page/update';
+const PREVIEW_PAGE_STATE_DIR = 'ttmg-preview-pages';
+const PREVIEW_PAGE_LOCK_TIMEOUT_MS = 3000;
+const PREVIEW_PAGE_LOCK_STALE_MS = 10000;
+function createPreviewPageServerResult(url, expiresAt) {
+    return {
+        status: 'ready',
+        url,
+        contentType: PREVIEW_PAGE_CONTENT_TYPE,
+        purpose: PREVIEW_PAGE_PURPOSE,
+        presentation: PREVIEW_PAGE_PRESENTATION,
+        expiresAt,
+        localhostOnly: true,
+        latestOnly: true,
+    };
+}
+function escapeHtml(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+function isHttpUrl(value) {
+    try {
+        const url = new URL(value);
+        return url.protocol === 'http:' || url.protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}
+function isPreviewPageInput(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const input = value;
+    return (typeof input.authorizationUrl === 'string' &&
+        isHttpUrl(input.authorizationUrl) &&
+        typeof input.previewUrl === 'string' &&
+        isHttpUrl(input.previewUrl) &&
+        typeof input.clientKey === 'string' &&
+        input.clientKey.length > 0 &&
+        typeof input.projectName === 'string' &&
+        input.projectName.length > 0 &&
+        typeof input.versionId === 'string' &&
+        input.versionId.length > 0);
+}
+function isWorkerRequest(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const request = value;
+    if (request.type !== 'start' || !isPreviewPageInput(request))
+        return false;
+    const workerRequest = value;
+    return (typeof workerRequest.token === 'string' &&
+        workerRequest.token.length >= 32 &&
+        typeof workerRequest.ttlMs === 'number' &&
+        workerRequest.ttlMs > 0 &&
+        (workerRequest.expiredNoticeTtlMs === undefined ||
+            (typeof workerRequest.expiredNoticeTtlMs === 'number' &&
+                workerRequest.expiredNoticeTtlMs >= 0)) &&
+        (workerRequest.controlToken === undefined ||
+            (typeof workerRequest.controlToken === 'string' &&
+                workerRequest.controlToken.length >= 32)) &&
+        (workerRequest.statePath === undefined ||
+            typeof workerRequest.statePath === 'string'));
+}
+function getClientKeyHash(clientKey) {
+    return crypto.createHash('sha256').update(clientKey).digest('hex').slice(0, 24);
+}
+function getPreviewPageStatePath(clientKey) {
+    return path.join(os.tmpdir(), PREVIEW_PAGE_STATE_DIR, `${getClientKeyHash(clientKey)}.json`);
+}
+function getPreviewPageLockPath(clientKey) {
+    return `${getPreviewPageStatePath(clientKey)}.lock`;
+}
+function ensureStateDirectory(statePath) {
+    fs.mkdirSync(path.dirname(statePath), { recursive: true, mode: 0o700 });
+}
+function readServerState(statePath) {
+    try {
+        const state = JSON.parse(fs.readFileSync(statePath, 'utf8'));
+        if (state.schemaVersion !== 1 ||
+            !Number.isInteger(state.pid) ||
+            !Number.isInteger(state.port) ||
+            state.port <= 0 ||
+            state.port > 65535 ||
+            typeof state.controlToken !== 'string' ||
+            state.controlToken.length < 32 ||
+            typeof state.expiresAt !== 'string') {
+            return null;
+        }
+        return state;
+    }
+    catch {
+        return null;
+    }
+}
+function writeServerState(statePath, state) {
+    ensureStateDirectory(statePath);
+    const tempPath = `${statePath}.${process.pid}.${crypto.randomBytes(4).toString('hex')}.tmp`;
+    fs.writeFileSync(tempPath, JSON.stringify(state), { mode: 0o600 });
+    fs.rmSync(statePath, { force: true });
+    fs.renameSync(tempPath, statePath);
+}
+function removeMatchingServerState(statePath, pid, controlToken) {
+    if (!statePath)
+        return;
+    const state = readServerState(statePath);
+    if (state?.pid === pid && state.controlToken === controlToken) {
+        fs.rmSync(statePath, { force: true });
+    }
+}
+function tokensMatch(actual, expected) {
+    const actualBuffer = Buffer.from(actual);
+    const expectedBuffer = Buffer.from(expected);
+    return (actualBuffer.length === expectedBuffer.length &&
+        crypto.timingSafeEqual(actualBuffer, expectedBuffer));
+}
+async function withClientKeyLock(clientKey, action) {
+    const lockPath = getPreviewPageLockPath(clientKey);
+    ensureStateDirectory(lockPath);
+    const deadline = Date.now() + PREVIEW_PAGE_LOCK_TIMEOUT_MS;
+    let descriptor;
+    while (descriptor === undefined && Date.now() < deadline) {
+        try {
+            descriptor = fs.openSync(lockPath, 'wx', 0o600);
+        }
+        catch (error) {
+            if (error?.code !== 'EEXIST')
+                throw error;
+            try {
+                const ageMs = Date.now() - fs.statSync(lockPath).mtimeMs;
+                if (ageMs > PREVIEW_PAGE_LOCK_STALE_MS) {
+                    fs.rmSync(lockPath, { force: true });
+                    continue;
+                }
+            }
+            catch {
+                continue;
+            }
+            await new Promise(resolve => setTimeout(resolve, 40));
+        }
+    }
+    if (descriptor === undefined) {
+        throw new Error('Timed out waiting for the preview page service lock.');
+    }
+    try {
+        return await action();
+    }
+    finally {
+        fs.closeSync(descriptor);
+        fs.rmSync(lockPath, { force: true });
+    }
+}
+async function renderPreviewPage(input, expiresAt) {
+    const [authorizationQr, previewQr] = await Promise.all([
+        QRCode.toDataURL(input.authorizationUrl, {
+            errorCorrectionLevel: 'M',
+            margin: 2,
+            width: 360,
+            type: 'image/png',
+        }),
+        QRCode.toDataURL(input.previewUrl, {
+            errorCorrectionLevel: 'M',
+            margin: 2,
+            width: 360,
+            type: 'image/png',
+        }),
+    ]);
+    const projectName = escapeHtml(input.projectName);
+    const clientKey = escapeHtml(input.clientKey);
+    const versionId = escapeHtml(input.versionId);
+    const authorizationUrl = escapeHtml(input.authorizationUrl);
+    const previewUrl = escapeHtml(input.previewUrl);
+    const rerunCommand = escapeHtml(`ttmg upload --preview --serve-preview-page --client-key ${input.clientKey}`);
+    return `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <meta name="color-scheme" content="light" />
+  <title>${projectName} · Preview build</title>
+  <style>
+    :root {
+      --ink: #15171f;
+      --muted: #626879;
+      --line: rgba(21, 23, 31, 0.1);
+      --paper: rgba(255, 255, 255, 0.92);
+      --cyan: #00b8c8;
+      --cyan-soft: #e9fbfc;
+      --pink: #fe2c55;
+      --shadow: 0 10px 30px rgba(28, 34, 52, 0.07);
+    }
+    * { box-sizing: border-box; }
+    body {
+      margin: 0;
+      min-height: 100vh;
+      overflow-x: hidden;
+      color: var(--ink);
+      background:
+        linear-gradient(180deg, rgba(0, 184, 200, 0.035), transparent 18rem),
+        #f6f7f9;
+      font-family: Inter, ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+    }
+    .shell { width: min(1040px, calc(100% - 32px)); margin: 0 auto; padding: 30px 0 40px; }
+    .topbar { display: flex; align-items: center; justify-content: space-between; margin-bottom: 36px; }
+    .brand { display: flex; align-items: center; gap: 11px; font-size: 13px; font-weight: 800; letter-spacing: 0.15em; }
+    .mark { width: 28px; height: 28px; border-radius: 9px; background: linear-gradient(135deg, var(--cyan) 0 48%, var(--pink) 52% 100%); box-shadow: 0 7px 20px rgba(0, 184, 200, 0.24); }
+    .status { display: inline-flex; align-items: center; gap: 8px; padding: 8px 11px; border: 1px solid rgba(0, 184, 200, 0.24); border-radius: 999px; color: #007d89; background: var(--cyan-soft); font-size: 12px; font-weight: 750; }
+    .status::before { content: ""; width: 7px; height: 7px; border-radius: 50%; background: var(--cyan); box-shadow: 0 0 0 4px rgba(0, 184, 200, 0.12); }
+    .guidance { margin: 0 0 20px; padding: 12px 15px; border: 1px solid var(--line); border-radius: 12px; color: var(--muted); background: rgba(255, 255, 255, 0.7); font-size: 13px; line-height: 1.5; }
+    .cards { display: grid; min-width: 0; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 20px; }
+    .card { position: relative; min-width: 0; overflow: hidden; padding: 28px; border: 1px solid var(--line); border-radius: 20px; background: var(--paper); box-shadow: var(--shadow); }
+    .card::after { content: ""; position: absolute; top: 0; left: 0; width: 100%; height: 4px; background: linear-gradient(90deg, var(--cyan), transparent 68%); }
+    .card.preview::after { background: linear-gradient(90deg, var(--pink), transparent 68%); }
+    .step { display: inline-flex; align-items: center; gap: 8px; margin-bottom: 15px; color: #007d89; font-size: 11px; font-weight: 850; letter-spacing: 0.15em; text-transform: uppercase; }
+    .preview .step { color: #c82143; }
+    h2 { margin: 0; font-size: 22px; letter-spacing: -0.025em; }
+    .description { min-height: 54px; margin: 10px 0 22px; color: var(--muted); font-size: 14px; line-height: 1.55; }
+    .qr { display: grid; place-items: center; width: min(290px, 100%); aspect-ratio: 1; margin: 0 auto 22px; padding: 15px; border: 1px solid var(--line); border-radius: 22px; background: white; }
+    .qr img { display: block; width: 100%; height: 100%; image-rendering: pixelated; }
+    .linkbox { min-width: 0; overflow: hidden; padding: 12px 13px; border: 1px solid var(--line); border-radius: 14px; background: #f8f9fb; }
+    .linklabel { display: flex; align-items: center; justify-content: space-between; margin-bottom: 7px; color: #7b8190; font-size: 10px; font-weight: 800; letter-spacing: 0.12em; text-transform: uppercase; }
+    .copy { appearance: none; border: 0; color: #007d89; background: transparent; cursor: pointer; font: inherit; font-size: 10px; font-weight: 850; letter-spacing: 0.08em; text-transform: uppercase; }
+    .direct { display: block; overflow: hidden; color: #252936; font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; font-size: 12px; line-height: 1.45; text-decoration: none; text-overflow: ellipsis; white-space: nowrap; }
+    .meta { display: grid; grid-template-columns: 1.4fr 1fr 1fr; gap: 1px; overflow: hidden; margin-top: 22px; border: 1px solid var(--line); border-radius: 18px; background: var(--line); }
+    .meta div { min-width: 0; padding: 15px 17px; background: rgba(255, 255, 255, 0.82); }
+    .meta small { display: block; margin-bottom: 5px; color: #858b98; font-size: 9px; font-weight: 800; letter-spacing: 0.12em; text-transform: uppercase; }
+    .meta strong { display: block; overflow: hidden; font-size: 12px; text-overflow: ellipsis; white-space: nowrap; }
+    .foot { margin: 17px 0 0; color: #7d8391; font-size: 11px; text-align: center; }
+    [hidden] { display: none !important; }
+    .expired-view { margin: 88px auto 0; max-width: 620px; padding: 42px; border: 1px solid var(--line); border-radius: 22px; background: var(--paper); box-shadow: var(--shadow); text-align: center; }
+    .expired-view h1 { margin: 0; font-size: 28px; letter-spacing: -0.03em; }
+    .expired-view p { margin: 13px auto 24px; max-width: 460px; color: var(--muted); font-size: 14px; line-height: 1.6; }
+    .expired-command { display: block; padding: 14px 16px; border: 1px solid var(--line); border-radius: 14px; color: #252936; background: #f8f9fb; font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; font-size: 12px; line-height: 1.5; overflow-wrap: anywhere; text-align: left; white-space: normal; }
+    .status.expired { border-color: rgba(254, 44, 85, 0.2); color: #c82143; background: #fff0f3; }
+    .status.expired::before { background: var(--pink); box-shadow: 0 0 0 4px rgba(254, 44, 85, 0.1); }
+    @media (max-width: 760px) {
+      .shell { width: 100%; max-width: 560px; padding: 22px 11px 36px; }
+      .topbar { margin-bottom: 34px; }
+      .status { display: none; }
+      .cards { grid-template-columns: minmax(0, 1fr); }
+      .card { width: 100%; padding: 23px; border-radius: 22px; }
+      .description { min-height: 0; }
+      .qr { width: 100%; max-width: 290px; }
+      .meta { grid-template-columns: 1fr; }
+    }
+  </style>
+</head>
+<body data-expires-at="${escapeHtml(expiresAt)}">
+  <main class="shell">
+    <header class="topbar">
+      <div class="brand"><span class="mark" aria-hidden="true"></span>TTMG PREVIEW</div>
+      <div class="status">Preview ready</div>
+    </header>
+    <div id="active-view">
+      <p class="guidance">New test account: start with Step 1. Already authorized: go directly to Step 2.</p>
+      <section class="cards">
+      <article class="card">
+        <div class="step">Step 01 · Account access</div>
+        <h2>Authorize your test account</h2>
+        <p class="description">Scan once with the TikTok account you will use for testing. If it is already a test user for this Mini Game, skip this step.</p>
+        <div class="qr"><img src="${authorizationQr}" alt="QR code for test-account authorization" /></div>
+        <div class="linkbox">
+          <div class="linklabel">Open directly <button class="copy" data-target="authorization-link">Copy</button></div>
+          <a id="authorization-link" class="direct" href="${authorizationUrl}" target="_blank" rel="noreferrer">${authorizationUrl}</a>
+        </div>
+      </article>
+      <article class="card preview">
+        <div class="step">Step 02 · Preview build</div>
+        <h2>Open the game preview</h2>
+        <p class="description">Already added as a test user? Scan this code directly. Otherwise, complete Step 1 first with the same account.</p>
+        <div class="qr"><img src="${previewQr}" alt="QR code for the game preview" /></div>
+        <div class="linkbox">
+          <div class="linklabel">Open directly <button class="copy" data-target="preview-link">Copy</button></div>
+          <a id="preview-link" class="direct" href="${previewUrl}" target="_blank" rel="noreferrer">${previewUrl}</a>
+        </div>
+      </article>
+      </section>
+      <section class="meta" aria-label="Preview metadata">
+        <div><small>Mini Game</small><strong>${projectName}</strong></div>
+        <div><small>Client key</small><strong>${clientKey}</strong></div>
+        <div><small>Version</small><strong>${versionId}</strong></div>
+      </section>
+      <p class="foot">Local-only preview page · expires in <span id="countdown">60:00</span></p>
+    </div>
+    <section id="expired-view" class="expired-view" hidden>
+      <h1>This preview page has expired</h1>
+      <p>Run the upload command again from your Mini Game project to generate a new preview page and preview build.</p>
+      <code class="expired-command">${rerunCommand}</code>
+    </section>
+  </main>
+  <script>
+    document.querySelectorAll('[data-target]').forEach(function (button) {
+      button.addEventListener('click', async function () {
+        var target = document.getElementById(button.dataset.target);
+        if (!target) return;
+        await navigator.clipboard.writeText(target.textContent || '');
+        var previous = button.textContent;
+        button.textContent = 'Copied';
+        setTimeout(function () { button.textContent = previous; }, 1200);
+      });
+    });
+    var expiresAt = Date.parse(document.body.dataset.expiresAt || '');
+    var countdown = document.getElementById('countdown');
+    var activeView = document.getElementById('active-view');
+    var expiredView = document.getElementById('expired-view');
+    var status = document.querySelector('.status');
+    var timer;
+    function updateCountdown() {
+      var seconds = Math.max(0, Math.ceil((expiresAt - Date.now()) / 1000));
+      var minutes = Math.floor(seconds / 60);
+      countdown.textContent = String(minutes).padStart(2, '0') + ':' + String(seconds % 60).padStart(2, '0');
+      if (seconds === 0) {
+        activeView.hidden = true;
+        activeView.replaceChildren();
+        expiredView.hidden = false;
+        status.textContent = 'Preview expired';
+        status.classList.add('expired');
+        clearInterval(timer);
+      }
+    }
+    updateCountdown();
+    timer = setInterval(updateCountdown, 1000);
+  </script>
+</body>
+</html>`;
+}
+function renderExpiredPreviewPage(input) {
+    const projectName = escapeHtml(input.projectName);
+    const rerunCommand = escapeHtml(`ttmg upload --preview --serve-preview-page --client-key ${input.clientKey}`);
+    return `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <meta name="color-scheme" content="light" />
+  <title>${projectName} · Preview expired</title>
+  <style>
+    * { box-sizing: border-box; }
+    body { display: grid; min-height: 100vh; margin: 0; place-items: center; padding: 24px; color: #15171f; background: #f6f7f9; font-family: Inter, ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; }
+    main { width: min(620px, 100%); padding: 42px; border: 1px solid rgba(21, 23, 31, 0.1); border-radius: 22px; background: rgba(255, 255, 255, 0.94); box-shadow: 0 10px 30px rgba(28, 34, 52, 0.07); text-align: center; }
+    .mark { width: 30px; height: 30px; margin: 0 auto 22px; border-radius: 9px; background: linear-gradient(135deg, #00b8c8 0 48%, #fe2c55 52% 100%); }
+    h1 { margin: 0; font-size: 28px; letter-spacing: -0.03em; }
+    p { margin: 13px auto 24px; max-width: 460px; color: #626879; font-size: 14px; line-height: 1.6; }
+    code { display: block; padding: 14px 16px; border: 1px solid rgba(21, 23, 31, 0.1); border-radius: 14px; color: #252936; background: #f8f9fb; font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; font-size: 12px; line-height: 1.5; overflow-wrap: anywhere; text-align: left; white-space: normal; }
+  </style>
+</head>
+<body>
+  <main>
+    <div class="mark" aria-hidden="true"></div>
+    <h1>This preview page has expired</h1>
+    <p>Run the upload command again from your Mini Game project to generate a new preview page and preview build.</p>
+    <code>${rerunCommand}</code>
+  </main>
+</body>
+</html>`;
+}
+async function createPreviewPageHttpServer({ input, token, ttlMs = DEFAULT_PREVIEW_PAGE_TTL_MS, expiredNoticeTtlMs = DEFAULT_PREVIEW_PAGE_EXPIRED_NOTICE_TTL_MS, controlToken = crypto.randomBytes(24).toString('hex'), onClose, }) {
+    if (!isPreviewPageInput(input)) {
+        throw new Error('Preview page links must use HTTP or HTTPS.');
+    }
+    let port = 0;
+    let closed = false;
+    let expiryTimer;
+    let shutdownTimer;
+    let currentPage = {
+        pathname: `/preview/${token}`,
+        expiresAt: new Date(Date.now() + ttlMs).toISOString(),
+        html: '',
+        expiredHtml: renderExpiredPreviewPage(input),
+    };
+    currentPage.html = await renderPreviewPage(input, currentPage.expiresAt);
+    const getResult = () => createPreviewPageServerResult(`http://127.0.0.1:${port}${currentPage.pathname}`, currentPage.expiresAt);
+    let close;
+    const scheduleLifecycle = () => {
+        clearTimeout(expiryTimer);
+        clearTimeout(shutdownTimer);
+        expiryTimer = setTimeout(() => {
+            currentPage.html = '';
+        }, ttlMs);
+        shutdownTimer = setTimeout(() => {
+            void close();
+        }, ttlMs + expiredNoticeTtlMs);
+    };
+    const update = async (nextInput) => {
+        if (!isPreviewPageInput(nextInput)) {
+            throw new Error('Preview page links must use HTTP or HTTPS.');
+        }
+        const nextToken = crypto.randomBytes(24).toString('hex');
+        const nextExpiresAt = new Date(Date.now() + ttlMs).toISOString();
+        const nextHtml = await renderPreviewPage(nextInput, nextExpiresAt);
+        const nextExpiredHtml = renderExpiredPreviewPage(nextInput);
+        currentPage = {
+            pathname: `/preview/${nextToken}`,
+            expiresAt: nextExpiresAt,
+            html: nextHtml,
+            expiredHtml: nextExpiredHtml,
+        };
+        scheduleLifecycle();
+        return getResult();
+    };
+    const sendJson = (response, statusCode, value) => {
+        const body = JSON.stringify(value);
+        response.writeHead(statusCode, {
+            'Cache-Control': 'no-store',
+            'Content-Length': String(Buffer.byteLength(body)),
+            'Content-Type': 'application/json; charset=utf-8',
+            'X-Content-Type-Options': 'nosniff',
+        });
+        response.end(body);
+    };
+    const server = http.createServer(async (request, response) => {
+        const requestUrl = new URL(request.url || '/', 'http://127.0.0.1');
+        if (requestUrl.pathname === PREVIEW_PAGE_CONTROL_PATH) {
+            const authorization = Array.isArray(request.headers.authorization)
+                ? request.headers.authorization[0] || ''
+                : request.headers.authorization || '';
+            const bearerToken = authorization.startsWith('Bearer ')
+                ? authorization.slice('Bearer '.length)
+                : '';
+            if (request.method !== 'POST' ||
+                !tokensMatch(bearerToken, controlToken)) {
+                sendJson(response, 404, { error: 'Not Found' });
+                return;
+            }
+            try {
+                const chunks = [];
+                let totalBytes = 0;
+                for await (const chunk of request) {
+                    const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+                    totalBytes += buffer.length;
+                    if (totalBytes > 64 * 1024) {
+                        throw new Error('Preview page update is too large.');
+                    }
+                    chunks.push(buffer);
+                }
+                const nextInput = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+                const result = await update(nextInput);
+                sendJson(response, 200, result);
+            }
+            catch (error) {
+                sendJson(response, 400, {
+                    error: error?.message || String(error),
+                });
+            }
+            return;
+        }
+        const matchesPath = requestUrl.pathname === currentPage.pathname ||
+            requestUrl.pathname === `${currentPage.pathname}/`;
+        if (!matchesPath ||
+            (request.method !== 'GET' && request.method !== 'HEAD')) {
+            response.writeHead(404, {
+                'Cache-Control': 'no-store',
+                'Content-Type': 'text/plain; charset=utf-8',
+                'X-Content-Type-Options': 'nosniff',
+            });
+            response.end('Not Found');
+            return;
+        }
+        const isExpired = Date.now() >= Date.parse(currentPage.expiresAt);
+        if (isExpired)
+            currentPage.html = '';
+        const responseHtml = isExpired ? currentPage.expiredHtml : currentPage.html;
+        response.writeHead(200, {
+            'Cache-Control': 'no-store',
+            'Content-Length': String(Buffer.byteLength(responseHtml)),
+            'Content-Security-Policy': "default-src 'none'; img-src data:; style-src 'unsafe-inline'; script-src 'unsafe-inline'; base-uri 'none'; form-action 'none'; frame-ancestors 'none'",
+            'Content-Type': PREVIEW_PAGE_CONTENT_TYPE,
+            'Referrer-Policy': 'no-referrer',
+            'X-Content-Type-Options': 'nosniff',
+        });
+        response.end(request.method === 'HEAD' ? undefined : responseHtml);
+    });
+    await new Promise((resolve, reject) => {
+        const onError = (error) => {
+            server.off('listening', onListening);
+            reject(error);
+        };
+        const onListening = () => {
+            server.off('error', onError);
+            resolve();
+        };
+        server.once('error', onError);
+        server.once('listening', onListening);
+        server.listen(0, '127.0.0.1');
+    });
+    const address = server.address();
+    if (!address || typeof address === 'string') {
+        server.close();
+        throw new Error('Unable to resolve the preview page server address.');
+    }
+    port = address.port;
+    close = () => new Promise(resolve => {
+        if (closed) {
+            resolve();
+            return;
+        }
+        closed = true;
+        clearTimeout(expiryTimer);
+        clearTimeout(shutdownTimer);
+        server.close(() => {
+            currentPage.html = '';
+            currentPage.expiredHtml = '';
+            onClose?.();
+            resolve();
+        });
+    });
+    scheduleLifecycle();
+    return {
+        result: getResult(),
+        update,
+        close,
+    };
+}
+function runPreviewPageServerWorker() {
+    if (!process.send) {
+        process.exitCode = 1;
+        return;
+    }
+    process.once('message', async (message) => {
+        if (!isWorkerRequest(message)) {
+            process.send?.({
+                type: 'error',
+                error: 'Invalid preview page server request.',
+            });
+            process.disconnect?.();
+            process.exitCode = 1;
+            return;
+        }
+        try {
+            const controlToken = message.controlToken || crypto.randomBytes(24).toString('hex');
+            const pageServer = await createPreviewPageHttpServer({
+                input: message,
+                token: message.token,
+                ttlMs: message.ttlMs,
+                expiredNoticeTtlMs: message.expiredNoticeTtlMs,
+                controlToken,
+                onClose: () => removeMatchingServerState(message.statePath, process.pid, controlToken),
+            });
+            process.send?.({
+                type: 'ready',
+                url: pageServer.result.url,
+                contentType: pageServer.result.contentType,
+                expiresAt: pageServer.result.expiresAt,
+            });
+            process.disconnect?.();
+            const shutdown = () => {
+                void pageServer.close().finally(() => process.exit(0));
+            };
+            process.once('SIGINT', shutdown);
+            process.once('SIGTERM', shutdown);
+        }
+        catch (error) {
+            process.send?.({
+                type: 'error',
+                error: error?.message || String(error),
+            });
+            process.disconnect?.();
+            process.exitCode = 1;
+        }
+    });
+}
+async function updateExistingPreviewPageServer(state, input) {
+    const body = JSON.stringify(input);
+    return new Promise((resolve, reject) => {
+        const request = http.request({
+            hostname: '127.0.0.1',
+            port: state.port,
+            path: PREVIEW_PAGE_CONTROL_PATH,
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${state.controlToken}`,
+                'Content-Length': String(Buffer.byteLength(body)),
+                'Content-Type': 'application/json; charset=utf-8',
+            },
+        }, response => {
+            const chunks = [];
+            let totalBytes = 0;
+            response.on('data', chunk => {
+                const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+                totalBytes += buffer.length;
+                if (totalBytes <= 64 * 1024)
+                    chunks.push(buffer);
+            });
+            response.on('end', () => {
+                if (totalBytes > 64 * 1024) {
+                    reject(new Error('Preview page service response is too large.'));
+                    return;
+                }
+                try {
+                    const payload = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+                    if (response.statusCode !== 200 || payload?.status !== 'ready') {
+                        throw new Error(payload?.error || 'Preview page service update failed.');
+                    }
+                    resolve(payload);
+                }
+                catch (error) {
+                    reject(error);
+                }
+            });
+        });
+        request.setTimeout(1500, () => {
+            request.destroy(new Error('Preview page service update timed out.'));
+        });
+        request.once('error', reject);
+        request.end(body);
+    });
+}
+async function spawnDetachedPreviewPageServer(input, statePath, options) {
+    const ttlMs = options.ttlMs || DEFAULT_PREVIEW_PAGE_TTL_MS;
+    const expiredNoticeTtlMs = options.expiredNoticeTtlMs ?? DEFAULT_PREVIEW_PAGE_EXPIRED_NOTICE_TTL_MS;
+    const entryPath = options.entryPath || process.argv[1];
+    const token = crypto.randomBytes(24).toString('hex');
+    const controlToken = crypto.randomBytes(24).toString('hex');
+    const child = child_process.spawn(process.execPath, [entryPath, PREVIEW_PAGE_SERVER_WORKER_ARG], {
+        detached: true,
+        windowsHide: true,
+        stdio: ['ignore', 'ignore', 'ignore', 'ipc'],
+    });
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const finish = (error, result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            child.removeAllListeners('message');
+            child.removeAllListeners('error');
+            child.removeAllListeners('exit');
+            if (error) {
+                child.kill();
+                reject(error);
+                return;
+            }
+            if (child.connected)
+                child.disconnect();
+            child.unref();
+            resolve(result);
+        };
+        const timer = setTimeout(() => {
+            finish(new Error('Timed out starting the preview page server.'));
+        }, options.startTimeoutMs || PREVIEW_PAGE_START_TIMEOUT_MS);
+        child.once('error', error => finish(error));
+        child.once('exit', code => {
+            finish(new Error(`Preview page server exited before it was ready (code ${code ?? 'unknown'}).`));
+        });
+        child.on('message', message => {
+            const response = message;
+            if (response?.type === 'error') {
+                finish(new Error(response.error));
+                return;
+            }
+            if (response?.type === 'ready') {
+                const result = createPreviewPageServerResult(response.url, response.expiresAt);
+                try {
+                    const port = Number(new URL(result.url).port);
+                    writeServerState(statePath, {
+                        schemaVersion: 1,
+                        pid: child.pid,
+                        port,
+                        controlToken,
+                        expiresAt: result.expiresAt,
+                    });
+                    finish(undefined, result);
+                }
+                catch (error) {
+                    finish(error);
+                }
+            }
+        });
+        child.send({
+            type: 'start',
+            ...input,
+            token,
+            ttlMs,
+            expiredNoticeTtlMs,
+            controlToken,
+            statePath,
+        });
+    });
+}
+async function startDetachedPreviewPageServer(input, options = {}) {
+    if (!isPreviewPageInput(input)) {
+        throw new Error('Preview page links must use HTTP or HTTPS.');
+    }
+    return withClientKeyLock(input.clientKey, async () => {
+        const statePath = getPreviewPageStatePath(input.clientKey);
+        const existingState = readServerState(statePath);
+        if (existingState) {
+            try {
+                const result = await updateExistingPreviewPageServer(existingState, input);
+                writeServerState(statePath, {
+                    ...existingState,
+                    expiresAt: result.expiresAt,
+                });
+                return result;
+            }
+            catch {
+                fs.rmSync(statePath, { force: true });
+            }
+        }
+        else if (fs.existsSync(statePath)) {
+            fs.rmSync(statePath, { force: true });
+        }
+        return spawnDetachedPreviewPageServer(input, statePath, options);
+    });
+}
+
+const defaultDependencies$6 = {
     getCurrentUser,
     fetchGameInfo,
     writeQrFile: async (outputPath, payload) => {
@@ -14917,112 +15339,509 @@ function normalizeFormat$3(format) {
     }
     return normalized;
 }
-function buildTestAccountAuthorizationUrl(clientKey) {
-    return `https://www.tiktok.com/ttmg/dev/${encodeURIComponent(clientKey)}`;
+function buildTestAccountAuthorizationUrl(clientKey) {
+    return `https://www.tiktok.com/ttmg/dev/${encodeURIComponent(clientKey)}`;
+}
+async function generateTestAccountAuthorization(options, dependencies = {}) {
+    const deps = { ...defaultDependencies$6, ...dependencies };
+    const clientKey = options.clientKey?.trim();
+    const operationId = deps.operationId();
+    if (!clientKey) {
+        throw new TestAccountCommandError('INVALID_ARGUMENT', t('testAccount.error.noClientKey'));
+    }
+    const user = deps.getCurrentUser();
+    if (!user || !user.cookie) {
+        throw new TestAccountCommandError('NOT_AUTHENTICATED', t('testAccount.error.notLoggedIn'));
+    }
+    const infoResponse = await deps.fetchGameInfo(clientKey);
+    if (infoResponse.error) {
+        throw new TestAccountCommandError('PROJECT_LOOKUP_FAILED', infoResponse.error.errorMsg || t('testAccount.error.gameInfoFailed'));
+    }
+    const appId = infoResponse.data?.app_id || '';
+    if (!appId) {
+        throw new TestAccountCommandError('PROJECT_RESPONSE_INVALID', t('testAccount.error.noAppId'));
+    }
+    const projectName = infoResponse.data?.name || 'game';
+    const authorizationUrl = buildTestAccountAuthorizationUrl(clientKey);
+    const safeClientKey = clientKey.replace(/[^a-zA-Z0-9_-]/g, '_');
+    const qrFile = path.resolve(process.cwd(), options.qrOutput || path.join('.ttmg', `test-account-${safeClientKey}.png`));
+    try {
+        fs.mkdirSync(path.dirname(qrFile), { recursive: true });
+        await deps.writeQrFile(qrFile, authorizationUrl);
+    }
+    catch (error) {
+        throw new TestAccountCommandError('QR_WRITE_FAILED', error?.message || t('testAccount.error.qrWriteFailed'));
+    }
+    return {
+        schemaVersion: '1',
+        operationId,
+        ts: deps.now(),
+        operation: 'test-account.add',
+        status: 'authorization_required',
+        clientKey,
+        appId,
+        projectName,
+        authorizationUrl,
+        qrPayload: authorizationUrl,
+        qrFile,
+        portalUrl: `https://developers.tiktok.com/portal/game/${appId}`,
+        platformWrite: false,
+        verification: 'developer_portal',
+        errorCode: null,
+        error: null,
+    };
+}
+async function testAccountAdd(options, dependencies = {}) {
+    const deps = { ...defaultDependencies$6, ...dependencies };
+    let format = 'text';
+    const operationId = deps.operationId();
+    try {
+        format = normalizeFormat$3(options.format);
+        const result = await generateTestAccountAuthorization(options, {
+            ...dependencies,
+            operationId: () => operationId,
+        });
+        if (format === 'json') {
+            console.log(JSON.stringify(result));
+        }
+        else {
+            console.log(chalk.green.bold(t('testAccount.success')));
+            console.log(t('testAccount.project', {
+                name: result.projectName,
+                clientKey: result.clientKey,
+            }));
+            console.log(t('testAccount.authorizationUrl', { url: result.authorizationUrl }));
+            console.log(t('testAccount.qrFile', { file: result.qrFile }));
+            console.log(chalk.yellow(t('testAccount.verifyInPortal')));
+        }
+        return result;
+    }
+    catch (error) {
+        const message = error?.message || String(error);
+        const errorCode = error instanceof TestAccountCommandError ? error.code : 'UNKNOWN_ERROR';
+        const failedResult = {
+            schemaVersion: '1',
+            operationId,
+            ts: deps.now(),
+            operation: 'test-account.add',
+            status: 'failed',
+            clientKey: options.clientKey || '',
+            appId: '',
+            projectName: '',
+            authorizationUrl: '',
+            qrPayload: '',
+            qrFile: '',
+            portalUrl: '',
+            platformWrite: false,
+            verification: 'developer_portal',
+            errorCode,
+            error: message,
+        };
+        if (format === 'json') {
+            console.log(JSON.stringify(failedResult));
+        }
+        else {
+            console.error(chalk.red.bold(t('testAccount.fail', { error: message })));
+        }
+        process.exitCode = 1;
+        return failedResult;
+    }
+}
+
+const DEFAULT_POLL_INTERVAL_MS = 3000;
+const DEFAULT_POLL_TIMEOUT_MS = 10 * 60 * 1000;
+const defaultDependencies$5 = {
+    getCurrentUser,
+    fetchGameInfo,
+    zipDirectory: targetDir => zipCwdToBuffer([], targetDir),
+    uploadGameToPlatform,
+    fetchGameAssets,
+    fetchGameAssetPreviewUrl,
+    startPreviewPageServer: startDetachedPreviewPageServer,
+    sleep: ms => new Promise(resolve => setTimeout(resolve, ms)),
+    now: () => Date.now(),
+    pollIntervalMs: DEFAULT_POLL_INTERVAL_MS,
+    pollTimeoutMs: DEFAULT_POLL_TIMEOUT_MS,
+};
+const defaultUploadRuntime = {
+    openUrl: async (url) => {
+        const openModule = await import('open');
+        return openModule.default(url);
+    },
+};
+function normalizeOutputFormat(format) {
+    const normalized = (format || 'text').toLowerCase();
+    if (normalized !== 'text' &&
+        normalized !== 'json' &&
+        normalized !== 'ndjson') {
+        throw new Error(t('upload.error.invalidFormat', { format: normalized }));
+    }
+    return normalized;
+}
+function getAssetStatusRaw(asset) {
+    return asset?.cdn_deploy_status ?? asset?.status ?? null;
+}
+function normalizeUploadPlatformStatus(rawStatus) {
+    if (rawStatus === null || rawStatus === undefined || rawStatus === '') {
+        return 'waiting_for_asset';
+    }
+    const numericStatus = Number(rawStatus);
+    if (Number.isInteger(numericStatus)) {
+        if (numericStatus === 0)
+            return 'unknown';
+        if (numericStatus === 1)
+            return 'pending';
+        if (numericStatus === 2)
+            return 'success';
+        if (numericStatus === 3)
+            return 'failed';
+        if (numericStatus === 4)
+            return 'processing';
+        return 'unknown';
+    }
+    const normalized = String(rawStatus).trim().toLowerCase();
+    const statusName = normalized.replace(/^deploy_status_/, '');
+    if (['ready', 'success', 'succeeded', 'available'].includes(statusName)) {
+        return 'success';
+    }
+    if (statusName.includes('fail') ||
+        statusName.includes('error') ||
+        statusName.includes('reject')) {
+        return 'failed';
+    }
+    if (statusName.includes('process') ||
+        statusName.includes('upload') ||
+        statusName.includes('deploy')) {
+        return 'processing';
+    }
+    if (statusName.includes('pending') ||
+        statusName.includes('queue') ||
+        statusName.includes('wait')) {
+        return 'pending';
+    }
+    return 'unknown';
+}
+function getAssetState(asset) {
+    const platformStatus = normalizeUploadPlatformStatus(getAssetStatusRaw(asset));
+    if (platformStatus === 'success') {
+        return 'ready';
+    }
+    if (platformStatus === 'failed') {
+        return 'failed';
+    }
+    return 'pending';
+}
+function extractAssets(data) {
+    if (!data) {
+        return [];
+    }
+    return [
+        data.preview_assets,
+        data.in_review_assets,
+        data.live_assets,
+        data.assets,
+    ].flatMap(group => (Array.isArray(group) ? group : []));
+}
+function extractPreviewUrl(data) {
+    return typeof data?.preview_url === 'string' ? data.preview_url : '';
+}
+function createEvent(base, status, progress, overrides = {}) {
+    return {
+        schemaVersion: '1',
+        operationId: base.operationId,
+        ts: Date.now(),
+        clientKey: base.clientKey,
+        versionId: '',
+        status,
+        progress,
+        previewUrl: '',
+        qrPayload: '',
+        platformUrl: '',
+        error: null,
+        errorCode: null,
+        platformWrite: false,
+        ...overrides,
+    };
+}
+async function waitForAssetReady({ assetId, miniGameId, deadline, eventBase, onEvent, deps, }) {
+    let lastPlatformStatusRaw = null;
+    let hasEmittedPlatformStatus = false;
+    while (deps.now() < deadline) {
+        const response = await deps.fetchGameAssets({ miniGameId });
+        if (response.error) {
+            throw new Error(response.error?.StatusMessage ||
+                response.error?.message ||
+                t('upload.error.assetQueryFailed'));
+        }
+        const asset = extractAssets(response.data).find(item => String(item.asset_id || '') === assetId) || null;
+        const platformStatusRaw = getAssetStatusRaw(asset);
+        const platformStatus = normalizeUploadPlatformStatus(platformStatusRaw);
+        if (!hasEmittedPlatformStatus ||
+            platformStatusRaw !== lastPlatformStatusRaw) {
+            hasEmittedPlatformStatus = true;
+            lastPlatformStatusRaw = platformStatusRaw;
+            onEvent(createEvent(eventBase, 'processing', 0.7, {
+                versionId: assetId,
+                platformStatus,
+                ...(platformStatusRaw === null ? {} : { platformStatusRaw }),
+                platformWrite: true,
+            }));
+        }
+        const assetState = getAssetState(asset);
+        if (assetState === 'ready') {
+            return asset;
+        }
+        if (assetState === 'failed') {
+            throw new Error(t('upload.error.assetFailed', { status: platformStatus }));
+        }
+        await deps.sleep(deps.pollIntervalMs);
+    }
+    throw new Error(t('upload.error.assetTimeout'));
+}
+async function waitForPreviewUrl({ assetId, deadline, deps, }) {
+    while (deps.now() < deadline) {
+        const response = await deps.fetchGameAssetPreviewUrl({ assetId });
+        if (response.error) {
+            throw new Error(response.error?.StatusMessage ||
+                response.error?.message ||
+                t('upload.error.previewQueryFailed'));
+        }
+        const previewUrl = extractPreviewUrl(response.data);
+        if (previewUrl) {
+            return previewUrl;
+        }
+        await deps.sleep(deps.pollIntervalMs);
+    }
+    throw new Error(t('upload.error.previewTimeout'));
 }
-async function generateTestAccountAuthorization(options, dependencies = {}) {
+async function executeUpload(options, dependencies = {}) {
     const deps = { ...defaultDependencies$5, ...dependencies };
     const clientKey = options.clientKey?.trim();
-    const operationId = deps.operationId();
-    if (!clientKey) {
-        throw new TestAccountCommandError('INVALID_ARGUMENT', t('testAccount.error.noClientKey'));
+    const note = options.note || '--';
+    const eventBase = { operationId: options.operationId, clientKey };
+    const emit = options.onEvent;
+    if (options.servePreviewPage && !options.preview) {
+        throw new Error(t('upload.error.previewPageRequiresPreview'));
     }
+    emit(createEvent(eventBase, 'precheck', 0.05));
     const user = deps.getCurrentUser();
     if (!user || !user.cookie) {
-        throw new TestAccountCommandError('NOT_AUTHENTICATED', t('testAccount.error.notLoggedIn'));
+        throw new Error(t('upload.error.notLoggedIn'));
+    }
+    if (!clientKey) {
+        throw new Error(t('upload.error.noClientKey'));
     }
     const infoResponse = await deps.fetchGameInfo(clientKey);
     if (infoResponse.error) {
-        throw new TestAccountCommandError('PROJECT_LOOKUP_FAILED', infoResponse.error.errorMsg || t('testAccount.error.gameInfoFailed'));
+        throw new Error(infoResponse.error.errorMsg || t('upload.error.gameInfoFailed'));
     }
     const appId = infoResponse.data?.app_id || '';
-    if (!appId) {
-        throw new TestAccountCommandError('PROJECT_RESPONSE_INVALID', t('testAccount.error.noAppId'));
-    }
     const projectName = infoResponse.data?.name || 'game';
-    const authorizationUrl = buildTestAccountAuthorizationUrl(clientKey);
-    const safeClientKey = clientKey.replace(/[^a-zA-Z0-9_-]/g, '_');
-    const qrFile = path.resolve(process.cwd(), options.qrOutput || path.join('.ttmg', `test-account-${safeClientKey}.png`));
-    try {
-        fs.mkdirSync(path.dirname(qrFile), { recursive: true });
-        await deps.writeQrFile(qrFile, authorizationUrl);
+    if (!appId) {
+        throw new Error(t('upload.error.noAppId'));
     }
-    catch (error) {
-        throw new TestAccountCommandError('QR_WRITE_FAILED', error?.message || t('testAccount.error.qrWriteFailed'));
+    const targetDir = options.dir
+        ? path.resolve(process.cwd(), options.dir)
+        : process.cwd();
+    if (!fs.existsSync(targetDir) || !fs.statSync(targetDir).isDirectory()) {
+        throw new Error(t('upload.error.dirNotExist', { dir: targetDir }));
     }
-    return {
-        schemaVersion: '1',
-        operationId,
-        ts: deps.now(),
-        operation: 'test-account.add',
-        status: 'authorization_required',
+    emit(createEvent(eventBase, 'packaging', 0.2, { appId, projectName }));
+    const zipBuffer = await deps.zipDirectory(targetDir);
+    const packageSizeBytes = zipBuffer.length;
+    emit(createEvent(eventBase, 'uploading', 0.4, {
+        appId,
+        projectName,
+        packageSizeBytes,
+    }));
+    const uploadResponse = await deps.uploadGameToPlatform({
+        data: zipBuffer.buffer.slice(zipBuffer.byteOffset, zipBuffer.byteOffset + zipBuffer.byteLength),
+        name: projectName,
         clientKey,
+        note,
+        appId,
+    });
+    if (uploadResponse.error) {
+        throw new Error(uploadResponse.error.message || t('upload.error.platformUploadFailed'));
+    }
+    const assetId = String(uploadResponse.data?.asset_id || '');
+    const platformUrl = uploadResponse.data?.detail || '';
+    if (!assetId) {
+        throw new Error(t('upload.error.missingAssetId'));
+    }
+    if (!options.preview) {
+        const event = createEvent(eventBase, 'ready', 1, {
+            appId,
+            projectName,
+            packageSizeBytes,
+            versionId: assetId,
+            platformUrl,
+            platformWrite: true,
+        });
+        emit(event);
+        return event;
+    }
+    const deadline = deps.now() + deps.pollTimeoutMs;
+    await waitForAssetReady({
+        assetId,
+        miniGameId: appId,
+        deadline,
+        eventBase,
+        onEvent: emit,
+        deps,
+    });
+    emit(createEvent(eventBase, 'processing', 0.85, {
         appId,
         projectName,
-        authorizationUrl,
-        qrPayload: authorizationUrl,
-        qrFile,
-        portalUrl: `https://developers.tiktok.com/portal/game/${appId}`,
-        platformWrite: false,
-        verification: 'developer_portal',
-        errorCode: null,
-        error: null,
-    };
+        packageSizeBytes,
+        versionId: assetId,
+        platformStatus: 'resolving_preview',
+        platformUrl,
+        platformWrite: true,
+    }));
+    const previewUrl = await waitForPreviewUrl({ assetId, deadline, deps });
+    let previewPage;
+    if (options.servePreviewPage) {
+        try {
+            previewPage = await deps.startPreviewPageServer({
+                authorizationUrl: buildTestAccountAuthorizationUrl(clientKey),
+                previewUrl,
+                clientKey,
+                projectName,
+                versionId: assetId,
+            });
+        }
+        catch (error) {
+            previewPage = {
+                status: 'failed',
+                contentType: 'text/html; charset=utf-8',
+                errorCode: 'PREVIEW_PAGE_SERVER_FAILED',
+                error: error?.message || String(error),
+            };
+        }
+    }
+    const event = createEvent(eventBase, 'ready', 1, {
+        appId,
+        projectName,
+        packageSizeBytes,
+        versionId: assetId,
+        previewUrl,
+        qrPayload: previewUrl,
+        ...(previewPage ? { previewPage } : {}),
+        platformUrl,
+        platformStatus: 'ready',
+        platformWrite: true,
+    });
+    emit(event);
+    return event;
 }
-async function testAccountAdd(options, dependencies = {}) {
-    const deps = { ...defaultDependencies$5, ...dependencies };
-    let format = 'text';
-    const operationId = deps.operationId();
-    try {
-        format = normalizeFormat$3(options.format);
-        const result = await generateTestAccountAuthorization(options, {
-            ...dependencies,
-            operationId: () => operationId,
+function getHumanEventText(event) {
+    if (event.status === 'precheck') {
+        return t('upload.spinner.fetchInfo', { clientKey: event.clientKey });
+    }
+    if (event.status === 'packaging') {
+        return t('upload.spinner.zipping', { dir: '' });
+    }
+    if (event.status === 'uploading') {
+        return t('upload.spinner.uploading', {
+            size: ((event.packageSizeBytes || 0) / 1024 / 1024).toFixed(2),
+        });
+    }
+    if (event.status === 'processing') {
+        return t('upload.spinner.processing', {
+            status: event.platformStatus || 'pending',
         });
+    }
+    return '';
+}
+function getPreviewPageConsoleText(page) {
+    return [
+        '',
+        t('upload.previewPageHeading'),
+        `  ${t('upload.previewPageOpenInBrowser')}  ${page.url}`,
+        `  ${t('upload.previewPageAccessScope')}     ${t('upload.previewPageSameMachine')}`,
+        `  ${t('upload.previewPageTerminalMode')}    ${t('upload.previewPageClickableLink')}`,
+        `  ${t('upload.previewPageExpiresAt')}       ${page.expiresAt}`,
+    ].join('\n');
+}
+function shouldOpenPreviewPage(format, options, page) {
+    return (format === 'text' && options.open !== false && page?.status === 'ready');
+}
+async function upload(options, runtime = defaultUploadRuntime) {
+    const format = normalizeOutputFormat(options.format);
+    const operationId = `upload_${crypto.randomUUID()}`;
+    const ora = await import('ora');
+    const spinner = format === 'text'
+        ? ora
+            .default({ spinner: 'dots', text: t('upload.spinner.start') })
+            .start()
+        : null;
+    let lastEvent = null;
+    const onEvent = (event) => {
+        lastEvent = event;
+        if (format === 'ndjson') {
+            console.log(JSON.stringify(event));
+            return;
+        }
+        const nextText = getHumanEventText(event);
+        if (nextText && spinner) {
+            spinner.text = chalk.cyan.bold(nextText);
+        }
+    };
+    try {
+        const result = await executeUpload({ ...options, operationId, onEvent });
         if (format === 'json') {
             console.log(JSON.stringify(result));
         }
-        else {
-            console.log(chalk.green.bold(t('testAccount.success')));
-            console.log(t('testAccount.project', {
-                name: result.projectName,
-                clientKey: result.clientKey,
-            }));
-            console.log(t('testAccount.authorizationUrl', { url: result.authorizationUrl }));
-            console.log(t('testAccount.qrFile', { file: result.qrFile }));
-            console.log(chalk.yellow(t('testAccount.verifyInPortal')));
+        else if (format === 'text' && spinner) {
+            if (result.previewUrl) {
+                spinner.succeed(chalk.green.bold(t('upload.previewSuccess', { url: result.previewUrl })));
+                if (result.previewPage?.status === 'ready') {
+                    console.log(getPreviewPageConsoleText(result.previewPage));
+                    if (shouldOpenPreviewPage(format, options, result.previewPage)) {
+                        console.log(t('upload.previewPageOpening'));
+                        try {
+                            await runtime.openUrl(result.previewPage.url);
+                        }
+                        catch {
+                            console.error(chalk.yellow(t('upload.previewPageOpenFailed')));
+                        }
+                    }
+                }
+                else if (result.previewPage?.status === 'failed') {
+                    console.error(chalk.yellow(t('upload.previewPageFailed', {
+                        error: result.previewPage.error,
+                    })));
+                }
+            }
+            else {
+                spinner.succeed(chalk.green.bold(t('upload.success', { url: result.platformUrl })));
+            }
         }
         return result;
     }
     catch (error) {
         const message = error?.message || String(error);
-        const errorCode = error instanceof TestAccountCommandError ? error.code : 'UNKNOWN_ERROR';
-        const failedResult = {
-            schemaVersion: '1',
-            operationId,
-            ts: deps.now(),
-            operation: 'test-account.add',
-            status: 'failed',
-            clientKey: options.clientKey || '',
-            appId: '',
-            projectName: '',
-            authorizationUrl: '',
-            qrPayload: '',
-            qrFile: '',
-            portalUrl: '',
-            platformWrite: false,
-            verification: 'developer_portal',
-            errorCode,
+        const failedEvent = createEvent({ operationId, clientKey: options.clientKey || '' }, 'failed', lastEvent?.progress || 0, {
+            appId: lastEvent?.appId,
+            projectName: lastEvent?.projectName,
+            packageSizeBytes: lastEvent?.packageSizeBytes,
+            versionId: lastEvent?.versionId || '',
+            platformUrl: lastEvent?.platformUrl || '',
+            platformStatus: lastEvent?.platformStatus,
+            platformStatusRaw: lastEvent?.platformStatusRaw,
+            platformWrite: lastEvent?.platformWrite || false,
+            errorCode: 'UPLOAD_FAILED',
             error: message,
-        };
-        if (format === 'json') {
-            console.log(JSON.stringify(failedResult));
+        });
+        if (format === 'json' || format === 'ndjson') {
+            console.log(JSON.stringify(failedEvent));
         }
         else {
-            console.error(chalk.red.bold(t('testAccount.fail', { error: message })));
+            spinner?.fail(chalk.red.bold(t('upload.fail', { error: message })));
         }
         process.exitCode = 1;
-        return failedResult;
+        return failedEvent;
     }
 }
 
@@ -15117,7 +15936,7 @@ async function authStatus(options = {}) {
     return result;
 }
 
-var version = "0.4.6-vibe-beta.2";
+var version = "0.4.6-vibe-beta.4";
 var engines = {
 	node: ">=20.19.1 <21 || >=22"
 };
@@ -15173,7 +15992,9 @@ function getCapabilities() {
                 platformWrite: false,
             },
             dev: {
-                command: 'ttmg dev --format json --events ndjson --no-open',
+                command: 'ttmg dev --format json --no-open',
+                eventsCommand: 'ttmg dev --events ndjson --no-open',
+                outputModesMutuallyExclusive: true,
                 available: true,
                 platformWrite: false,
                 timeout: true,
@@ -15185,6 +16006,31 @@ function getCapabilities() {
                 command: 'ttmg upload --preview --format ndjson',
                 available: true,
                 platformWrite: true,
+                previewPage: {
+                    option: '--serve-preview-page',
+                    command: 'ttmg upload --preview --serve-preview-page --format ndjson',
+                    available: true,
+                    localhostOnly: true,
+                    inMemory: true,
+                    reuseScope: 'clientKey',
+                    latestOnly: true,
+                    renewsTtlOnUpload: true,
+                    textModeAutoOpen: true,
+                    structuredModeAutoOpen: false,
+                    noOpenOption: '--no-open',
+                    presentation: {
+                        audience: 'user',
+                        preferredSurface: 'browser',
+                        preferredAction: 'open_url',
+                        terminalInline: false,
+                        fallback: 'show_clickable_link',
+                        sameHostRequired: true,
+                    },
+                    includesTestAccountAuthorization: true,
+                    includesPreviewQr: true,
+                    ttlSeconds: 3600,
+                    expiredNoticeTtlSeconds: 3600,
+                },
             },
         },
         dev: {
@@ -15609,6 +16455,7 @@ function getDesktopPath() {
 }
 
 const program = new commander.Command();
+const isPreviewPageServerWorker = process.argv[2] === '__preview-page-server';
 const withVerboseOption = (command) => command.option('--verbose', t('cli.option.verbose'));
 const structuredFormatIndex = process.argv.indexOf('--format');
 const inlineStructuredFormat = process.argv.find(arg => arg.startsWith('--format='));
@@ -15617,7 +16464,8 @@ const structuredFormat = inlineStructuredFormat
     : structuredFormatIndex >= 0
         ? process.argv[structuredFormatIndex + 1]
         : '';
-if (structuredFormat !== 'json' &&
+if (!isPreviewPageServerWorker &&
+    structuredFormat !== 'json' &&
     structuredFormat !== 'ndjson' &&
     !process.argv.includes('--implicit')) {
     maybeShowPostInstallNotice(pkg.version);
@@ -15668,12 +16516,16 @@ withVerboseOption(program
     .option('-n, --note <note>', t('cli.command.upload.note'))
     .option('-d, --dir <dir>', t('cli.command.upload.dir'))
     .option('--preview', t('cli.command.upload.preview'))
+    .option('--serve-preview-page', t('cli.command.upload.servePreviewPage'))
+    .option('--no-open', t('cli.command.upload.noOpen'))
     .option('--format <format>', t('cli.command.upload.format'), 'text')).action(async (cmd) => {
     await upload({
         clientKey: cmd.clientKey,
         note: cmd.note,
         dir: cmd.dir,
         preview: cmd.preview,
+        servePreviewPage: cmd.servePreviewPage,
+        open: cmd.open,
         format: cmd.format,
     });
 });
@@ -15744,6 +16596,13 @@ const devCmd = program
     .option('--timeout <seconds>', t('cli.command.dev.timeout'));
 withVerboseOption(devCmd).action(async (cmd) => {
     const options = program.opts();
+    const format = String(cmd.format || 'text').toLowerCase();
+    const events = String(cmd.events || 'none').toLowerCase();
+    if (format === 'json' && events === 'ndjson') {
+        console.error(t('cli.command.dev.outputConflict'));
+        process.exitCode = 1;
+        return;
+    }
     if (options.h5) {
         await dev$1();
     }
@@ -15878,7 +16737,12 @@ withVerboseOption(program
         console.log(t('cli.native.build.placeholder'));
     }
 });
-program.parse(process.argv);
+if (isPreviewPageServerWorker) {
+    runPreviewPageServerWorker();
+}
+else {
+    program.parse(process.argv);
+}
 
 /**
  * 一个类型安全的、通用的事件发射器类。
@@ -21905,6 +22769,9 @@ function normalizeTimeout(timeout) {
 async function dev(options = {}) {
     const format = normalizeFormat(options.format);
     const events = normalizeEvents(options.events);
+    if (format === 'json' && events === 'ndjson') {
+        throw new Error('Dev output modes cannot be combined. Use either --format json or --events ndjson.');
+    }
     const structured = format === 'json' || events === 'ndjson';
     const timeoutMs = normalizeTimeout(options.timeout);
     if (timeoutMs > 0 && !structured) {