@ttmg/cli 0.4.6-vibe-beta.16 → 0.4.6-vibe-beta.18

package/README.md

@@ -1,8 +1,12 @@
 ### @ttmg/cli
 
+`0.4.6-vibe-beta.18` 在上传成功后短暂显示成功提示，再平滑返回原扫码界面，保留最初的绑定二维码，终态 `qrPurpose=authorization_binding`。CLI 继续查询同一任务，并通过 `previewUrl` 返回后端预览链接；电脑页面不切换为试玩码。预览超时或查询失败仍保留上传回执，请勿直接重传。详见 [Vibe 接入说明](vibe-upload.md)。
+
+Version `0.4.6-vibe-beta.18`: after upload, the page briefly confirms success, then smoothly returns to the original binding QR. The CLI keeps polling the same task and returns its preview link in `previewUrl`; the page QR remains for binding. A preview timeout or lookup failure preserves the upload receipt; do not upload again.
+
 Vibe 手机扫码授权与上传：`ttmg upload --vibe --dir ./game --title "My game" --icon ./avatar.png --format ndjson`。用户在手机 TikTok 扫码授权后，原命令自动上传。只收集标题和本地头像，并使用游戏目录或代码包；其他应用资料由 CLI 补齐。页面展示标题、头像、描述、类型和子类型。见 [Vibe 接入说明](vibe-upload.md)。
 
-扫码上传使用 `0.4.6-vibe-beta.16`，安装后核对版本与能力声明。扫码链路已用 PPE 测试素材完成真实上传；正式环境未开放。
+扫码上传使用 `0.4.6-vibe-beta.18`，安装后核对版本与能力声明。Snow Crew 已在 PPE 完成真实绑定上传，本次返回原绑定码的页面体验已由用户验证。预览链接的完整链路此前已在 beta.17 验证；正式环境未开放。
 
 `ttmg` is a command-line tool designed for managing and developing mini-game projects. It supports initialization, development, debugging, and packaging for both H5 and native mini-games.
 `ttmg` 是一款专为小游戏项目管理与开发设计的命令行工具，支持 H5 小游戏和原生小游戏的初始化、开发调试及打包构建。
@@ -14,7 +18,7 @@ Vibe 版本支持手机扫码授权上传、可选 `--description`、分类查
 固定版本安装（发布标签为 `vibe-beta`）：
 
 ```bash
-npm install -g @ttmg/cli@0.4.6-vibe-beta.16
+npm install -g @ttmg/cli@0.4.6-vibe-beta.18
 ttmg --version
 ttmg capabilities --format json
 ttmg upload --help
@@ -89,16 +93,6 @@ ttmg login --implicit --email <email> --password <password>
 options when credentials are provided by the execution environment.
 执行环境也可以通过 `TTMG_LOGIN_EMAIL` 和 `TTMG_LOGIN_PASSWORD` 提供凭据。
 
-Inspect the reusable local session without exposing its Cookie. The status is
-local-only; it does not make a network request. `--require-auth` is useful for
-Agent preflight because it exits non-zero when login is missing.
-可在不暴露 Cookie 的情况下读取本地会话是否可复用。该状态只检查本地配置，不发起网络请求；Agent 预检可增加 `--require-auth`，未登录时以非零状态退出。
-
-```
-ttmg auth status --format json
-ttmg auth status --format json --require-auth
-```
-
 Agents can discover the exact command and runtime capability surface before
 acting. Unsupported device and Runtime features are explicitly reported as
 `false`; commands that create a platform version are marked with

package/dist/index.js

@@ -7263,6 +7263,8 @@ Vibe QR upload (real PPE trial):
   Keep this process running. At waiting_authorization, scan the QR on pageUrl with TikTok on your phone.
   pageUrl is the local QR/progress page on the CLI computer. Reopen it with authorizationOpenCommand.
   The CLI polls and uploads avatar, app_info and package automatically after authorization. Do not start a second upload.
+  After upload, pageUrl returns to the original binding QR. waiting_preview keeps polling the same task until previewUrl is available.
+  previewReady=true means the preview link is available; qrPurpose=authorization_binding describes the original QR retained on pageUrl. A preview timeout preserves uploaded=true; do not reupload.
   Real success: terminal=true, status=uploaded, uploaded=true, simulation=false. On failure, read errorCode and nextAction.
   The local QR page opens for every output format; --no-open disables automatic opening.
   The page displays the submitted title, icon, description, category and subcategory.
@@ -7711,6 +7713,8 @@ Vibe 扫码上传（真实 PPE 试用）：
   保持原进程运行。在 waiting_authorization 阶段，使用手机 TikTok 扫描 pageUrl 页面中的二维码。
   pageUrl 是 CLI 所在电脑的二维码／进度页；重新打开时，执行返回的 authorizationOpenCommand。
   CLI 负责轮询，授权后自动上传 avatar、app_info、package，不再启动第二次上传。
+  上传成功后 pageUrl 平滑返回原绑定二维码；waiting_preview 继续查询同一任务直到取得 previewUrl。
+  previewReady=true 表示预览链接已返回；qrPurpose=authorization_binding 表示 pageUrl 保留原绑定码。等待超时仍保留 uploaded=true，请核对任务，不要重传。
   真实成功：terminal=true、status=uploaded、uploaded=true、simulation=false。失败时读取 errorCode 和 nextAction。
   所有输出格式都会打开本地二维码页；--no-open 可关闭自动打开。
   页面展示本次提交的标题、头像、描述、类型和子类型。
@@ -16378,7 +16382,7 @@ async function authStatus(options = {}) {
     return result;
 }
 
-var version = "0.4.6-vibe-beta.16";
+var version = "0.4.6-vibe-beta.18";
 var engines = {
 	node: ">=20.19.1 <21 || >=22"
 };
@@ -17265,6 +17269,18 @@ function getCapabilities() {
                 httpContract: 'minis-import-task',
                 authorizationQr: true,
                 previewQr: false,
+                preview: {
+                    taskEndpoint: 'get_minis_import_task_detail_for_agent',
+                    waitingStatus: 'waiting_preview',
+                    resultFields: ['previewUrl', 'previewReady', 'clientKey', 'appId', 'codeAssetId', 'minisCenterHistoryId'],
+                    readiness: 'nonempty-valid-preview-url',
+                    qrPurpose: 'authorization_binding',
+                    pageQrSource: 'original-landing-url',
+                    sameTask: true,
+                    timeout: 'shared-operation-timeout',
+                    failurePreservesUploaded: true,
+                    deviceRunVerified: false,
+                },
                 realAuthorizationVerified: true,
                 realUploadVerified: true,
                 verificationScope: { backend: 'ppe', authorizationMode: 'qr', assets: 'test-fixtures', date: '2026-09-16', production: false },
@@ -18618,7 +18634,7 @@ var authOpen = /*#__PURE__*/Object.freeze({
 const prefix = '/bff/app_info/minis_import/';
 const MINIS_IMPORT_PATHS = {
     create: `${prefix}create_minis_import_task_for_agent/`,
-    status: `${prefix}get_minis_import_task_status_for_agent/`,
+    status: `${prefix}get_minis_import_task_detail_for_agent/`,
     icon: `${prefix}upload_minis_import_app_icon_for_agent/`,
     info: `${prefix}submit_minis_import_info_for_agent/`,
     package: `${prefix}upload_minis_import_package_for_agent/`,
@@ -18677,6 +18693,31 @@ function createBackend(mode, transport) {
     });
     return {
         mode,
+        async getTaskDetail(task, signal) {
+            const data = await call({ method: 'GET', path: MINIS_IMPORT_PATHS.status,
+                data: credentials(task), signal });
+            const raw = status(data.status);
+            if (raw === 8)
+                throw new VibeError('VIBE_AUTH_EXPIRED');
+            if (raw === 7)
+                throw new VibeError('VIBE_TASK_FAILED');
+            if (data.ready_for_input !== undefined && typeof data.ready_for_input !== 'boolean')
+                throw new VibeError('VIBE_INVALID_RESPONSE');
+            const detail = { statusRaw: raw, readyForInput: data.ready_for_input === true };
+            for (const [wire, field] of [['app_id', 'appId'], ['code_asset_id', 'codeAssetId'],
+                ['minis_center_history_id', 'minisCenterHistoryId']]) {
+                if (data[wire] !== undefined && data[wire] !== '')
+                    detail[field] = taskId(data[wire]);
+            }
+            if (data.client_key !== undefined && data.client_key !== '') {
+                if (!nonempty(data.client_key))
+                    throw new VibeError('VIBE_INVALID_RESPONSE');
+                detail.clientKey = data.client_key;
+            }
+            if (data.preview_url !== undefined && data.preview_url !== '')
+                detail.previewUrl = safeWebUrl(data.preview_url);
+            return detail;
+        },
         async createTask(input, signal) {
             const data = await call({
                 method: 'POST',
@@ -18807,6 +18848,7 @@ function createPpeMockBackend(lane, adapter, scenario = 'success') {
     };
     return {
         mode: 'ppe-mock',
+        getTaskDetail: (task, signal) => real.getTaskDetail(task, signal),
         uploadAvailable: true,
         dispose: () => real.dispose?.(),
         async createTask(input, signal) {
@@ -19283,9 +19325,9 @@ const vibePageStyles = `
 
 :root{font-family:Inter,-apple-system,BlinkMacSystemFont,"Segoe UI","PingFang SC","Microsoft YaHei",sans-serif;color:#24282f;background:#fff;font-synthesis:none;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased}
 *{box-sizing:border-box}
-body{margin:0;min-height:100vh;min-height:100svh;display:flex;align-items:center;justify-content:center;padding:36px 24px;font-size:14px;line-height:1.5}
-.shell{width:100%;max-width:400px}
-.steps{display:flex;align-items:center;justify-content:center;gap:10px;margin:0 0 32px;padding:0;list-style:none}
+body{margin:0;min-height:100vh;min-height:100svh;display:flex;align-items:center;justify-content:center;padding:64px 24px;font-size:14px;line-height:1.5}
+.shell{position:relative;width:100%;max-width:400px}
+.steps{display:flex;align-items:center;justify-content:center;gap:10px;margin:0 0 24px;padding:0;list-style:none}
 .step{display:flex;align-items:center;gap:6px;font-size:11px;color:#9298a2;white-space:nowrap}
 .step:after{content:"";height:1px;width:25px;margin-left:4px;background:#e9ebef}.step:last-child:after{display:none}
 .step-number{height:18px;min-width:18px;border-radius:50%;border:1px solid #e2e5e9;display:grid;place-items:center;font-size:10px}
@@ -19293,17 +19335,17 @@ body{margin:0;min-height:100vh;min-height:100svh;display:flex;align-items:center
 .step.done{color:#537565}.step.done .step-number{background:#edf6f0;color:#287c54;border-color:#edf6f0}
 .heading{text-align:center}h1{font-size:26px;font-weight:650;line-height:1.35;letter-spacing:-.6px;margin:0 0 10px}
 .subtitle{color:#7a818c;font-size:12px;line-height:1.7;margin:0;overflow-wrap:anywhere}
-.game{margin:28px 0 0;padding-top:24px;border-top:1px solid #eceef1}
-.game-summary{display:flex;align-items:center;gap:12px}.game-title{margin:0;font-size:15px;font-weight:600;overflow-wrap:anywhere;min-width:0}
+.game{margin:24px 0 0;padding-top:20px;border-top:1px solid #eceef1;text-align:center}
+.game-summary{display:flex;align-items:center;justify-content:center;gap:12px}.game-title{max-width:100%;margin:0;font-size:15px;font-weight:600;overflow-wrap:anywhere;min-width:0}
 .game-icon,.game-avatar{width:44px;height:44px;border-radius:10px;flex-shrink:0;background:#f0f2f5}.game-avatar{object-fit:cover}.game-icon{display:grid;place-items:center;color:#707b8b}
-.game-details{margin:20px 0 0;font-size:13px}.game-details dt{font-size:11px;color:#9298a2;margin-bottom:4px}.game-details dd{margin:0;overflow-wrap:anywhere}
-.game-description{white-space:pre-wrap;line-height:1.65}.game-categories{display:grid;grid-template-columns:1fr 1fr;gap:24px;margin-top:18px}
+.game-details{margin:16px 0 0;font-size:13px}.game-details>div:first-child,.game-categories>div{display:flex;align-items:baseline;justify-content:center;gap:8px}.game-details dt{flex-shrink:0;font-size:11px;color:#9298a2;margin:0}.game-details dd{min-width:0;margin:0;text-align:left;overflow-wrap:anywhere}
+.game-description{white-space:pre-wrap;line-height:1.65}.game-categories{display:grid;grid-template-columns:1fr;gap:16px;margin-top:16px}
 .scan-action{text-align:center;font-size:13px;font-weight:500;margin:26px 0 10px}.qr-area{display:flex;justify-content:center}.qr-frame{padding:8px;width:208px;height:208px}.qr-frame img{display:block;width:192px;height:192px;max-width:100%}
+.game+.qr-area{margin-top:20px}.scan-hint{text-align:center;font-size:11px;color:#7a818c;line-height:1.7;margin:8px 0 0}
 .upload-area{display:flex;align-items:center;flex-direction:column;gap:16px;padding-top:26px}.percentage{font-size:34px;line-height:1;font-variant-numeric:tabular-nums;font-weight:550}.percentage span{font-size:16px;color:#858e9d;padding-left:3px}
 .progress-wrap{width:100%}progress{display:block;width:100%;height:4px;border:none;border-radius:20px;overflow:hidden;background:#edf0f4;accent-color:#4c6378}progress::-webkit-progress-bar{background:#edf0f4;border-radius:20px}progress::-webkit-progress-value{background:#4c6378;border-radius:20px}progress::-moz-progress-bar{background:#4c6378;border-radius:20px}.transfer-label{text-align:center;font-size:11px;color:#8b939f;margin:8px 0 0}
-.footer{text-align:center;font-size:10px;line-height:1.7;color:#a0a5ae;margin:28px 0 0}.footer .dot{display:inline-block;height:5px;width:5px;border-radius:50%;background:#c1995e;vertical-align:middle;margin-right:5px}.mock-badge{width:fit-content;margin:0 0 10px auto;font-size:10px;padding:2px 7px;border:1px solid #dfe2e7;border-radius:5px;color:#707783}
-@media(max-width:380px){body{padding:28px 20px}.steps{gap:7px}.step:after{width:16px;margin-left:1px}h1{font-size:24px}}
-@media(max-height:640px){body{align-items:flex-start;padding-top:28px;padding-bottom:28px}}
+.footer{text-align:center;font-size:10px;line-height:1.7;color:#a0a5ae;margin:24px 0 0}.footer .dot{display:inline-block;height:5px;width:5px;border-radius:50%;background:#c1995e;vertical-align:middle;margin-right:5px}.mock-badge{width:fit-content;margin:0 0 10px auto;font-size:10px;padding:2px 7px;border:1px solid #dfe2e7;border-radius:5px;color:#707783}
+@media(max-width:380px){body{padding-left:20px;padding-right:20px}.steps{gap:7px}.step:after{width:16px;margin-left:1px}h1{font-size:24px}}
 `;
 
 const VIBE_PAGE_WORKER = '__vibe-page-server';
@@ -19311,7 +19353,38 @@ const VIBE_PAGE_WORKER = '__vibe-page-server';
 const VIBE_PAGE_HTML_LIMIT = 16 * 1024 * 1024;
 const pageUpdates = `(() => {
   let etag;
-  const terminal = () => ['complete', 'failed'].includes(document.querySelector('main')?.dataset.phase);
+  const terminal = () => ['complete', 'preview', 'failed'].includes(document.querySelector('main')?.dataset.phase);
+  const delay = ms => new Promise(resolve => setTimeout(resolve, ms));
+  async function replace(current, updated) {
+    const animate = current.dataset.phase !== updated.dataset.phase && current.animate &&
+      !window.matchMedia?.('(prefers-reduced-motion: reduce)').matches;
+    const height = current.getBoundingClientRect().height;
+    if (animate) await current.animate([{opacity: 1}, {opacity: 0}], {duration: 140, fill: 'forwards'}).finished.catch(() => {});
+    current.replaceWith(updated);
+    if (animate) await updated.animate([
+      {opacity: 0, height: height + 'px', overflow: 'hidden'},
+      {opacity: 1, height: updated.getBoundingClientRect().height + 'px', overflow: 'hidden'}
+    ], {duration: 280, easing: 'ease-out'}).finished.catch(() => {});
+  }
+  async function show(updated) {
+    let current = document.querySelector('main');
+    if (!current || current.outerHTML === updated.outerHTML) return;
+    if (updated.dataset.uploadedBinding === 'true' && current.dataset.uploadedBinding !== 'true') {
+      // Return to the original binding QR after showing the upload receipt,
+      // even when polling skips intermediate upload states.
+      const success = updated.cloneNode(true);
+      success.dataset.phase = 'upload_success';
+      delete success.dataset.uploadedBinding;
+      const heading = success.querySelector('.heading');
+      success.querySelector('h1').textContent = heading.dataset.uploadTitle;
+      success.querySelector('.subtitle').textContent = heading.dataset.uploadSubtitle;
+      success.querySelectorAll('.qr-area, .scan-action, .scan-hint').forEach(node => node.remove());
+      await replace(current, success);
+      current = success;
+      await delay(1200);
+    }
+    await replace(current, updated);
+  }
   async function refresh() {
     if (terminal()) return;
     try {
@@ -19319,8 +19392,8 @@ const pageUpdates = `(() => {
       if (response.ok) {
         etag = response.headers.get('etag');
         const next = new DOMParser().parseFromString(await response.text(), 'text/html');
-        const current = document.querySelector('main'), updated = next.querySelector('main');
-        if (current && updated && current.outerHTML !== updated.outerHTML) current.replaceWith(updated);
+        const updated = next.querySelector('main');
+        if (updated) await show(updated);
         document.title = next.title;
       }
     } catch { /* Keep the current page readable during a temporary connection failure. */ }
@@ -19333,6 +19406,8 @@ async function renderVibePage(input) {
     const zh = input.language !== 'en-US';
     const phase = input.phase ||
         (input.purpose === 'authorization_binding' ? 'binding' : 'uploading');
+    const uploadedBinding = !input.simulation && input.purpose === 'authorization_binding' &&
+        (phase === 'waiting_preview' || phase === 'preview' || phase === 'complete');
     const copy = zh
         ? {
             steps: ['扫码授权', '上传游戏', '完成'],
@@ -19357,7 +19432,6 @@ async function renderVibePage(input) {
             bindingCode: '授权绑定二维码',
             accepted: input.simulation ? '模拟完成' : '已上传',
             mockNote: input.hybrid ? '真实创建 / 查询任务 · 授权 / 上传为模拟 · 不改变真实任务状态' : '模拟运行 · 无需扫码，不会真实上传',
-            footer: '临时页面 · 15 分钟后关闭',
         }
         : {
             steps: ['Authorize', 'Upload', 'Done'],
@@ -19386,7 +19460,6 @@ async function renderVibePage(input) {
             bindingCode: 'Authorization QR',
             accepted: input.simulation ? 'Simulation complete' : 'Uploaded',
             mockNote: input.hybrid ? 'Real task creation / polling · Mock authorization / upload · Real task status unchanged' : 'Mock only · no scan needed, nothing is uploaded',
-            footer: 'Temporary page · closes after 15 minutes',
         };
     if (input.web) {
         copy.steps[0] = zh ? '网页授权' : 'Web authorization';
@@ -19405,28 +19478,42 @@ async function renderVibePage(input) {
         : '<span class="game-icon" aria-hidden="true"><svg width="22" height="22" viewBox="0 0 24 24" fill="none"><path d="M7 7h10c2 0 3 2 3 4l1 5c.4 2-1 3-2.5 2l-3-2h-7l-3 2C4 19 2.6 18 3 16l1-5c0-2 1-4 3-4Z" stroke="currentColor" stroke-width="1.4" stroke-linejoin="round"/><path d="M8 10v4m-2-2h4m6-1h.01M18 13h.01" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/></svg></span>';
     const game = `<div class="game"><div class="game-summary">${icon}<p class="game-title">${escape(input.title)}</p></div><dl class="game-details"><div><dt>${zh ? '描述' : 'Description'}</dt><dd class="game-description">${escape(input.description ?? VIBE_PPE_DEFAULT_APP_INFO.description)}</dd></div><div class="game-categories"><div><dt>${zh ? '类型' : 'Category'}</dt><dd>${escape(input.category ?? VIBE_PPE_DEFAULT_APP_INFO.category)}</dd></div><div><dt>${zh ? '子类型' : 'Subcategory'}</dt><dd>${escape(input.subcategory ?? VIBE_PPE_DEFAULT_APP_INFO.subcategory)}</dd></div></div></dl></div>`;
     const checkIcon = '<svg width="12" height="12" viewBox="0 0 16 16" fill="none" aria-hidden="true"><path d="m3 8 3 3 7-7" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/></svg>';
-    const title = phase === 'binding'
-        ? copy.bindingTitle
-        : phase === 'uploading'
-            ? copy.uploadingTitle
-            : phase === 'failed'
-                ? copy.failedTitle
-                : copy.completeTitle;
-    const subtitle = phase === 'binding'
-        ? copy.bindingSubtitle
-        : phase === 'uploading'
-            ? copy.uploadingSubtitle
-            : phase === 'failed'
-                ? escape(input.message)
-                : copy.completeSubtitle;
-    const qr = phase === 'binding' && !input.web && input.qrUrl
+    const uploadSuccessTitle = zh ? '上传成功' : 'Upload complete';
+    const uploadSuccessSubtitle = zh
+        ? '游戏内容已上传，正在返回扫码页面。'
+        : 'Your game has been uploaded. Returning to the scan page.';
+    const title = uploadedBinding ? (zh ? '扫码打开绑定页面' : 'Scan to open the binding page')
+        : phase === 'waiting_preview' ? (zh ? '正在准备预览' : 'Preparing preview')
+            : phase === 'preview' ? (zh ? '扫码预览游戏' : 'Scan to preview')
+                : phase === 'binding'
+                    ? copy.bindingTitle
+                    : phase === 'uploading'
+                        ? copy.uploadingTitle
+                        : phase === 'failed'
+                            ? copy.failedTitle
+                            : copy.completeTitle;
+    const subtitle = uploadedBinding ? (phase === 'complete' ? escape(input.message) : zh
+        ? '本次游戏代码包已上传完成，再次扫码即可查看预览版本并提交审核。'
+        : 'Your game package has been uploaded. Scan again to view the preview version and submit it for review.')
+        : phase === 'waiting_preview' ? (zh ? '游戏内容已上传，预览就绪后会自动显示二维码。' : 'Game content uploaded. The preview QR will appear when ready.')
+            : phase === 'preview' ? (zh ? '上传完成，使用手机 TikTok 扫描下方二维码。' : 'Upload complete. Scan the QR below with TikTok on your phone.')
+                : phase === 'complete' && !input.simulation ? escape(input.message)
+                    : phase === 'binding'
+                        ? copy.bindingSubtitle
+                        : phase === 'uploading'
+                            ? copy.uploadingSubtitle
+                            : phase === 'failed'
+                                ? escape(input.message)
+                                : copy.completeSubtitle;
+    const qr = (phase === 'binding' || phase === 'preview' || uploadedBinding) && !input.web && input.qrUrl
         ? await QRCode.toDataURL(input.qrUrl, {
             width: 384,
             margin: 4,
             errorCorrectionLevel: 'M',
         })
         : '';
-    const purpose = copy.bindingCode;
+    const purpose = phase === 'preview' && !uploadedBinding ? (zh ? '游戏预览二维码' : 'Game preview QR') : copy.bindingCode;
+    const done = phase === 'complete' || phase === 'preview' || phase === 'waiting_preview';
     const progress = typeof input.progressPercent === 'number' &&
         Number.isFinite(input.progressPercent)
         ? Math.max(0, Math.min(100, Math.round(input.progressPercent)))
@@ -19437,11 +19524,11 @@ async function renderVibePage(input) {
             ? `<div class="upload-area"><div class="percentage">${progress}<span>%</span></div><div class="progress-wrap"><progress aria-label="${copy.uploadLabel}" max="100" value="${progress}"></progress><p class="transfer-label">${copy.uploadLabel}</p></div></div>`
             : '';
     return `<!doctype html><html lang="${zh ? 'zh-CN' : 'en'}"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>${escape(title)} · ${escape(input.title)}</title><style>${vibePageStyles}</style><script src="?updates" defer></script></head>
-<body><main class="shell" data-phase="${phase}">${input.simulation ? `<p class="mock-badge">${copy.mock}</p>` : ''}
-<section class="card" aria-labelledby="page-title">${phase === 'failed' ? '' : `<ol class="steps" aria-label="${zh ? '上传步骤' : 'Upload steps'}">${copy.steps.map((label, i) => `<li class="step ${phase === 'complete' || i < step ? 'done' : i === step ? 'active' : ''}"${phase !== 'complete' && i === step ? ' aria-current="step"' : ''}><span class="step-number">${phase === 'complete' || i < step ? checkIcon : i + 1}</span>${label}</li>`).join('')}</ol>`}
-<div class="heading"><h1 id="page-title">${title}</h1><p class="subtitle" role="status">${subtitle}</p></div>${game}${phase === 'binding' ? `<p class="scan-action">${copy.bindingAction}</p>` : ''}${content}
+<body><main class="shell" data-phase="${phase}"${uploadedBinding ? ' data-uploaded-binding="true"' : ''}>${input.simulation ? `<p class="mock-badge">${copy.mock}</p>` : ''}
+<section class="card" aria-labelledby="page-title">${phase === 'failed' ? '' : `<ol class="steps" aria-label="${zh ? '上传步骤' : 'Upload steps'}">${copy.steps.map((label, i) => `<li class="step ${done || i < step ? 'done' : i === step ? 'active' : ''}"${!done && i === step ? ' aria-current="step"' : ''}><span class="step-number">${done || i < step ? checkIcon : i + 1}</span>${label}</li>`).join('')}</ol>`}
+<div class="heading"${uploadedBinding ? ` data-upload-title="${escape(uploadSuccessTitle)}" data-upload-subtitle="${escape(uploadSuccessSubtitle)}"` : ''}><h1 id="page-title">${title}</h1><p class="subtitle" role="status">${subtitle}</p></div>${game}${phase === 'binding' || uploadedBinding ? `<p class="scan-action">${copy.bindingAction}</p>` : ''}${content}${uploadedBinding ? `<p class="scan-hint">${zh ? '这是本次上传的原绑定二维码，无需重复上传。' : 'This is the original binding QR for this upload. No need to upload again.'}</p>` : ''}
 </section>
-<p class="footer">${input.simulation ? `<span class="dot" aria-hidden="true"></span>${copy.mockNote}` : copy.footer}</p></main></body></html>`;
+${input.simulation ? `<p class="footer"><span class="dot" aria-hidden="true"></span>${copy.mockNote}</p>` : ''}</main></body></html>`;
 }
 async function createVibePageServer() {
     const route = `/${crypto.randomBytes(24).toString('hex')}`;
@@ -19634,6 +19721,7 @@ const stageText = {
     ],
     uploading: ['授权完成，正在自动上传', 'Authorized; uploading automatically'],
     uploaded: ['上传完成', 'Upload complete'],
+    waiting_preview: ['上传完成，正在准备预览', 'Upload complete; preparing preview'],
     failed: [
         '本次操作失败，请根据错误码处理',
         'Operation failed; check the error code',
@@ -19701,6 +19789,7 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
     let timedOut = false;
     let page;
     let backend = deps.backend;
+    let task;
     let detached = false;
     let progressUpdates = Promise.resolve();
     let ppeLane;
@@ -19844,7 +19933,7 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
         };
         const sourceProjectId = deps.projectId(options);
         emit('creating_task', { platformWrite: backend.mode === 'ppe' || backend.mode === 'ppe-mock' });
-        const task = await backend.createTask({
+        task = await backend.createTask({
             source_type: 1,
             source_project_id: sourceProjectId,
             task_idempotency_id: result.operationId,
@@ -19979,7 +20068,6 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
                 }
             }
         });
-        task.importToken = '';
         task.landingUrl = '';
         // A validated upload receipt is authoritative even if result-page rendering fails.
         result = { ...result, uploaded: true, ...(backend.mode === 'ppe-mock'
@@ -19988,20 +20076,49 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
         await progressUpdates;
         if (progressPageError)
             throw progressPageError;
+        if (!result.simulation) {
+            emit('waiting_preview', { previewReady: false, terminal: false, nextAction: 'wait',
+                qrPurpose: 'authorization_binding', authorizationOpenCommand: undefined });
+            await page.update({ ...pageGame, language: getCurrentLanguage(), phase: 'waiting_preview',
+                qrUrl: authorizationUrl, purpose: 'authorization_binding',
+                simulation: false, message: text('waiting_preview') });
+            while (true) {
+                ensureActive();
+                const detail = await backend.getTaskDetail(task, controller.signal);
+                ensureActive();
+                const fields = { taskStatusRaw: detail.statusRaw,
+                    ...(detail.clientKey ? { clientKey: detail.clientKey } : {}),
+                    ...(detail.appId ? { appId: detail.appId } : {}),
+                    ...(detail.codeAssetId ? { codeAssetId: detail.codeAssetId } : {}),
+                    ...(detail.minisCenterHistoryId ? { minisCenterHistoryId: detail.minisCenterHistoryId } : {}) };
+                if (detail.previewUrl) {
+                    result = { ...result, ...fields, previewUrl: detail.previewUrl, previewReady: true };
+                    break;
+                }
+                if (Object.entries(fields).some(([key, value]) => result[key] !== value))
+                    emit('waiting_preview', fields);
+                await deps.sleep(pollMs, controller.signal);
+            }
+        }
         await page.update({
             ...pageGame,
             language: getCurrentLanguage(),
-            phase: 'complete',
+            phase: result.previewReady ? 'preview' : 'complete',
+            qrUrl: result.simulation ? undefined : authorizationUrl,
+            purpose: result.simulation ? undefined : 'authorization_binding',
             simulation: result.simulation,
             message: text('uploaded', result.simulation),
         });
         page.detach();
         detached = true;
-        return emit('uploaded', { terminal: true, nextAction: 'none' });
+        return emit('uploaded', { terminal: true, nextAction: result.previewReady ? 'scan_qr' : 'none',
+            qrPurpose: result.previewReady ? 'authorization_binding' : undefined,
+            ...(result.previewReady ? { message: getCurrentLanguage() === 'zh-CN'
+                    ? '上传完成。原绑定二维码已保留，可使用 TikTok 再次扫码打开绑定页面。' : 'Upload complete. The original binding QR is available to reopen the binding page with TikTok.' } : {}) });
     }
     catch (error) {
         const code = timedOut
-            ? 'VIBE_TIMEOUT'
+            ? result.uploaded ? 'VIBE_PREVIEW_TIMEOUT' : 'VIBE_TIMEOUT'
             : controller.signal.aborted
                 ? 'VIBE_CANCELLED'
                 : error instanceof VibeError
@@ -20090,14 +20207,14 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
         };
         const message = result.uploaded
             ? getCurrentLanguage() === 'zh-CN'
-                ? '上传已完成，但结果页面显示失败，请勿重复上传。'
-                : 'Upload completed, but the result page failed. Do not upload again.'
+                ? `游戏内容已上传，但${code === 'VIBE_PREVIEW_TIMEOUT' ? '等待预览超时' : code === 'VIBE_CANCELLED' ? '已停止等待预览' : '预览查询或页面显示未完成'}。请核对任务，请勿重复上传。`
+                : `Game content was uploaded, but ${code === 'VIBE_PREVIEW_TIMEOUT' ? 'preview polling timed out' : code === 'VIBE_CANCELLED' ? 'preview polling was cancelled' : 'preview lookup or display did not complete'}. Check the task; do not upload again.`
             : messages[code]?.[getCurrentLanguage() === 'zh-CN' ? 0 : 1] ||
                 text(status);
         controller.abort();
         await progressUpdates;
         // Remove the binding QR on failure too. Keep a readable terminal result page.
-        if (page && code !== 'VIBE_CANCELLED') {
+        if (page && (code !== 'VIBE_CANCELLED' || result.uploaded)) {
             try {
                 await page.update({
                     ...pageMetadata,
@@ -20106,7 +20223,11 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
                     simulation: result.simulation,
                     hybrid: result.backend === 'ppe-mock',
                     phase: result.uploaded ? 'complete' : 'failed',
-                    message,
+                    message: result.uploaded && !result.simulation
+                        ? getCurrentLanguage() === 'zh-CN'
+                            ? '本次游戏代码包已上传完成，可在手机端查看预览版本并提交审核。'
+                            : 'Your game package has been uploaded. You can view the preview version and submit it for review on your phone.'
+                        : message,
                 });
                 page.detach();
                 detached = true;
@@ -20117,7 +20238,7 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
         }
         return emit(status, {
             terminal: true,
-            nextAction: result.uploaded || code === 'VIBE_CANCELLED'
+            nextAction: result.uploaded ? 'check_task' : code === 'VIBE_CANCELLED'
                 ? 'none'
                 : result.uploadAttempted ||
                     (result.taskId &&
@@ -20141,6 +20262,10 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
         });
     }
     finally {
+        if (task) {
+            task.importToken = '';
+            task.landingUrl = '';
+        }
         clearTimeout(timeout);
         externalSignal?.removeEventListener('abort', cancel);
         backend?.dispose?.();