@ttmg/cli 0.4.6-vibe-beta.6 → 0.4.6-vibe-beta.7

package/README.md

@@ -21,9 +21,21 @@ npm install @ttmg/cli --save-dev
 
 #### Login 登录
 
-The experimental `upload --vibe` local prototype does not require platform login.
-See [Vibe binding/upload](vibe-upload.md) for the schema-v2 Skill contract, real local preparation and task-based Mock. Set `TTMG_VIBE_BACKEND=mock` outside the Skill; success ends at upload completion, without preview or release.
-实验性 `upload --vibe` 不要求平台登录。通过 `TTMG_VIBE_BACKEND=mock` 在 Skill 外配置模拟模式；真实本地准备、schema v2 状态、绑定上传 Mock 见 [Vibe 绑定上传](vibe-upload.md)。本次结束于上传完成，不含预览和发布。
+For the beta.7 trial, run `ttmg upload --vibe --mock` without environment setup.
+Task creation/polling use the built-in PPE lane; authorization and uploads remain
+simulated. Unlike beta.6, this is not offline: backend access is required and task
+creation is a real platform write. See [Vibe binding/upload](vibe-upload.md).
+beta.7 试用直接运行 `ttmg upload --vibe --mock`，不用登录或配置环境变量。
+创建／查询任务走 CLI 内置 PPE，授权／上传继续模拟；与 beta.6 不同，不再是全程离线。
+需要后端可访问，会创建真实任务，不上传游戏、不预览、不审核或发布。
+
+```sh
+npm install -g @ttmg/cli@0.4.6-vibe-beta.7
+ttmg upload --vibe --mock --dir ./game --title "My game" --icon ./avatar.png --format ndjson
+```
+
+PPE routing will be removed in a production release without Skill environment setup.
+上线时由 CLI 去掉 PPE 路由，不让 Skill 配置或切换环境。
 
 For the existing authenticated platform workflow, log in first; this does not apply to the local Vibe prototype above.
 原有需要平台鉴权的流程仍先登录；上述 Vibe 本地原型不需要此步骤。

package/dist/index.js

@@ -7277,12 +7277,12 @@ const messages = {
         '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.upload.vibe': 'Skill-guided binding and upload (schema v2; mock/local testing only)',
+        'cli.command.upload.vibe': 'Skill-guided binding and upload (schema v2; use --mock for the integration trial)',
         'cli.command.upload.vibeTitle': 'Game title supplied by the Skill (--vibe)',
         'cli.command.upload.vibeIcon': 'Local PNG/JPEG/WebP selected by the user (--vibe)',
         'cli.command.upload.vibePackage': 'Prepared ZIP instead of --dir (--vibe)',
         'cli.command.upload.vibeDryRun': 'Validate and package locally without authorization or upload (--vibe)',
-        'cli.command.upload.vibeMock': 'Auto-simulate authorization and upload; no backend or phone scan (--vibe)',
+        'cli.command.upload.vibeMock': 'Integration trial: real PPE task creation/polling, simulated authorization/upload; no environment setup or phone authorization (--vibe)',
         'cli.command.upload.vibeScenario': 'Mock: success | denied | expired | timeout | upload-failed | processing | icon-failed | info-failed',
         'cli.command.upload.vibeApi': 'Minis Import API origin on a loopback IP only (--vibe)',
         'cli.command.upload.vibeAuthorizeUrl': 'Obsolete: remove this option; task creation returns landing_url (--vibe)',
@@ -7537,12 +7537,12 @@ const messages = {
         'cli.command.upload.servePreviewPage': '启动包含测试账号与预览二维码的临时本地页面',
         'cli.command.upload.noOpen': '不使用默认浏览器打开本地预览页面',
         'cli.command.upload.format': '输出格式：text | json | ndjson',
-        'cli.command.upload.vibe': 'Skill 引导绑定上传（schema v2，当前仅 Mock/本地测试）',
+        'cli.command.upload.vibe': 'Skill 引导绑定上传（schema v2；使用 --mock 联调试用）',
         'cli.command.upload.vibeTitle': 'Skill 提供的游戏标题（--vibe）',
         'cli.command.upload.vibeIcon': '用户指定的本地 PNG/JPEG/WebP 图片（--vibe）',
         'cli.command.upload.vibePackage': '已准备的 ZIP，与 --dir 二选一（--vibe）',
         'cli.command.upload.vibeDryRun': '仅本地校验与打包，不授权、不上传（--vibe）',
-        'cli.command.upload.vibeMock': '自动模拟授权与上传，无需后端和手机扫码（--vibe）',
+        'cli.command.upload.vibeMock': '联调试用：真实 PPE 创建／查询，模拟授权／上传；无需环境配置或完成手机授权（--vibe）',
         'cli.command.upload.vibeScenario': '模拟：success | denied | expired | timeout | upload-failed | processing | icon-failed | info-failed',
         'cli.command.upload.vibeApi': 'Minis Import 接口地址，仅接受回环 IP（--vibe）',
         'cli.command.upload.vibeAuthorizeUrl': '已废弃，请移除此参数；授权地址由创建任务返回（--vibe）',
@@ -15993,7 +15993,7 @@ async function authStatus(options = {}) {
     return result;
 }
 
-var version = "0.4.6-vibe-beta.6";
+var version = "0.4.6-vibe-beta.7";
 var engines = {
 	node: ">=20.19.1 <21 || >=22"
 };
@@ -16017,11 +16017,28 @@ function getCapabilities() {
                 command: 'ttmg upload --vibe --mock --format ndjson',
                 option: '--vibe',
                 available: true,
-                platformWrite: false,
-                readiness: 'local-prototype',
+                platformWrite: true,
+                readiness: 'ppe-authorization-integration',
                 schemaVersion: '2',
                 backendEnvironment: 'TTMG_VIBE_BACKEND',
-                backendModes: ['mock', 'local-http'],
+                backendModes: ['mock', 'local-http', 'ppe', 'ppe-mock'],
+                ppeMock: {
+                    environment: 'TTMG_VIBE_PPE',
+                    realOperations: ['taskCreation', 'statusPolling'],
+                    mockOperations: ['authorization', 'avatar', 'app_info', 'package'],
+                    simulateAfterPolls: 3,
+                    realUploadEnabled: false,
+                    simulationStartsAt: 'authorization',
+                },
+                ppe: {
+                    environment: 'TTMG_VIBE_PPE',
+                    host: 'developers.tiktok.com',
+                    taskCreation: true,
+                    statusPolling: true,
+                    authorizationScheme: 'aweme://webview?url=<encoded landing_url>',
+                    uploadEnabled: false,
+                    uploadBlockedError: 'VIBE_REAL_UPLOAD_NOT_READY',
+                },
                 terminalSuccess: 'uploaded',
                 stages: ['precheck', 'packaging', 'prepared', 'creating_task', 'waiting_authorization', 'uploading', 'uploaded', 'failed', 'cancelled'],
                 uploadSteps: ['avatar', 'app_info', 'package'],
@@ -16034,6 +16051,9 @@ function getCapabilities() {
                 metadataForm: false,
                 dryRun: true,
                 mock: true,
+                mockRequiresBackend: true,
+                mockBackendRouting: 'built-in-ppe-task-only',
+                mockRequiresEnvironmentConfiguration: false,
                 mockAutoAuthorization: true,
                 mockRequiresClientScan: false,
                 mockSimulatedProgress: true,
@@ -16980,7 +17000,7 @@ class VibeError extends Error {
     }
 }
 
-// BFF IDL: feat-minis-import, verified 2026-09-12. No production adapter enabled.
+// BFF IDL: feat-minis-import. PPE task creation/polling only; no production adapter.
 const prefix = '/bff/app_info/minis_import/';
 const MINIS_IMPORT_PATHS = {
     create: `${prefix}create_minis_import_task_for_agent/`,
@@ -17020,7 +17040,7 @@ function status(value) {
 }
 function envelope(data) {
     if (!data || data.error_info?.code !== 0) {
-        if (data?.error_info?.code === 400001)
+        if (data?.error_info?.code === 400001 || data?.error_info?.code === 420001)
             throw new VibeError('VIBE_AUTH_EXPIRED');
         if (typeof data?.error_info?.code === 'number')
             throw new VibeError('VIBE_BACKEND_REJECTED');
@@ -17136,13 +17156,87 @@ function createLocalHttpBackend(baseUrl) {
         base.search ||
         base.hash)
         throw new VibeError('VIBE_INVALID_LOCAL_ENDPOINT');
+    return createHttpBackend('local-http', base.origin);
+}
+function createPpeBackend(lane, adapter) {
+    // No default lane and no production fallback. Keep PPE requests on the known host.
+    if (!lane || !/^ppe_[a-zA-Z0-9_-]{1,64}$/.test(lane))
+        throw new VibeError('VIBE_INVALID_PPE_ENV');
+    const backend = createHttpBackend('ppe', 'https://developers.tiktok.com', {
+        'x-use-ppe': '1',
+        'x-tt-env': lane,
+    }, adapter);
+    const uploadUnavailable = async () => {
+        throw new VibeError('VIBE_REAL_UPLOAD_NOT_READY');
+    };
+    return {
+        ...backend,
+        uploadAvailable: false,
+        uploadIcon: uploadUnavailable,
+        submitInfo: uploadUnavailable,
+        uploadPackage: uploadUnavailable,
+    };
+}
+/** Opt-in integration demo: only creation and polling can reach PPE. */
+// Release-owned configuration, not a developer setup step. Remove PPE routing
+// here when the production chain is ready; do not change the Skill command.
+function createVibeTrialBackend(scenario, adapter) {
+    return createPpeMockBackend('ppe_op_vc', adapter, scenario);
+}
+function createPpeMockBackend(lane, adapter, scenario = 'success') {
+    const real = createPpeBackend(lane, adapter);
+    const mock = createMockBackend(scenario);
+    let realTask;
+    let mockTask;
+    let polls = 0;
+    let simulatedReady = false;
+    const uploadTask = (task) => {
+        if (task !== realTask || !mockTask || !simulatedReady)
+            throw new VibeError('VIBE_TASK_NOT_ACCEPTING_INPUT');
+        return mockTask;
+    };
+    return {
+        mode: 'ppe-mock',
+        uploadAvailable: true,
+        async createTask(input, signal) {
+            if (realTask)
+                throw new VibeError('VIBE_TASK_NOT_ACCEPTING_INPUT');
+            realTask = await real.createTask(input, signal);
+            // Separate in-memory credentials: real import tokens never reach mock uploads.
+            mockTask = await mock.createTask(input, signal);
+            return realTask;
+        },
+        async getTaskStatus(task, signal) {
+            if (task !== realTask)
+                throw new VibeError('VIBE_TASK_NOT_ACCEPTING_INPUT');
+            // Errors remain errors; this is not an automatic fallback for failed requests.
+            const observed = await real.getTaskStatus(task, signal);
+            if (++polls >= 3) {
+                const simulated = await mock.getTaskStatus(mockTask, signal);
+                // The mock normal path needs three observations before accepting uploads.
+                if (!simulated.readyForInput) {
+                    await mock.getTaskStatus(mockTask, signal);
+                    simulatedReady = (await mock.getTaskStatus(mockTask, signal)).readyForInput;
+                }
+                else
+                    simulatedReady = true;
+            }
+            return { ...observed, simulatedReadyForInput: simulatedReady };
+        },
+        uploadIcon: async (task, input, signal) => mock.uploadIcon(uploadTask(task), input, signal),
+        submitInfo: async (task, title, iconUri, signal) => mock.submitInfo(uploadTask(task), title, iconUri, signal),
+        uploadPackage: async (task, input, signal, onProgress) => mock.uploadPackage(uploadTask(task), input, signal, onProgress),
+    };
+}
+function createHttpBackend(mode, baseURL, environmentHeaders = {}, adapter) {
     const client = axios.create({
-        baseURL: base.origin,
+        baseURL,
         timeout: 30000,
         maxRedirects: 0,
         proxy: false,
+        adapter,
     });
-    return createBackend('local-http', async (request) => {
+    return createBackend(mode, async (request) => {
         try {
             let body;
             let headers = {};
@@ -17169,7 +17263,7 @@ function createLocalHttpBackend(baseUrl) {
                 url: request.path,
                 params: request.method === 'GET' ? request.data : undefined,
                 data: body,
-                headers,
+                headers: { ...environmentHeaders, ...headers },
                 signal: request.signal,
                 maxBodyLength: Infinity,
                 onUploadProgress: p => request.onProgress?.(p.loaded, p.total),
@@ -17273,6 +17367,11 @@ function createMockBackend(scenario = 'success') {
     });
 }
 
+function createAuthorizationScheme(landingUrl) {
+    // Encode the entire landing URL once so its token/query stays inside the WebView.
+    return `aweme://webview?url=${encodeURIComponent(safeWebUrl(landingUrl))}`;
+}
+
 const DEV_PORT = 3000;
 const DEV_WS_PORT = 4000;
 path.join(os.homedir(), '__TTMG__');
@@ -17573,52 +17672,60 @@ async function renderVibePage(input) {
     const copy = zh
         ? {
             steps: ['扫码授权', '上传游戏', '完成'],
-            mock: '模拟',
+            mock: input.hybrid ? 'PPE + Mock' : '模拟',
             game: '当前游戏',
             gameIcon: '游戏头像',
             bindingTitle: '上传到 TikTok',
-            bindingAction: '使用 TikTok 扫描二维码',
-            bindingSubtitle: '在手机上确认授权后，将继续上传这个游戏。',
-            bindingStatus: input.simulation ? '模拟等待扫码' : '等待扫码',
+            bindingAction: input.hybrid ? '真实授权二维码 · 混合联调' : '使用 TikTok 扫描二维码',
+            bindingSubtitle: input.hybrid
+                ? '可扫码查看端内授权页。查询三次真实状态后，模拟授权和上传，无需完成手机授权。'
+                : input.uploadAvailable === false
+                    ? '请在手机上完成授权。当前为真实 PPE 授权联调，尚未开放上传。'
+                    : '在手机上确认授权后，将继续上传这个游戏。',
+            bindingStatus: input.hybrid ? '正在查询 PPE 任务' : input.simulation ? '模拟等待扫码' : '等待扫码',
             uploadingTitle: '正在上传小游戏',
-            uploadingSubtitle: '授权已完成，正在上传本次游戏内容。',
+            uploadingSubtitle: input.simulation ? '正在模拟授权后的上传流程，不会上传游戏内容。' : '授权已完成，正在上传本次游戏内容。',
             uploadLabel: input.simulation ? '模拟上传进度' : '上传进度',
             uploadStatus: '正在上传游戏，请稍候',
-            completeTitle: '上传完成',
+            completeTitle: input.simulation ? '模拟上传完成' : '上传完成',
             completeSubtitle: input.simulation
                 ? '绑定和上传流程模拟完成，未向 TikTok 上传游戏。'
                 : '游戏内容已上传，本次操作已完成。',
             failedTitle: '本次上传未完成',
             bindingCode: '授权绑定二维码',
-            accepted: '已上传',
-            mockNote: '模拟运行 · 无需扫码，不会真实上传',
+            accepted: input.simulation ? '模拟完成' : '已上传',
+            mockNote: input.hybrid ? '真实创建 / 查询任务 · 授权 / 上传为模拟 · 不改变真实任务状态' : '模拟运行 · 无需扫码，不会真实上传',
             footer: '临时页面 · 15 分钟后关闭',
         }
         : {
             steps: ['Authorize', 'Upload', 'Done'],
-            mock: 'MOCK',
+            mock: input.hybrid ? 'PPE + Mock' : 'MOCK',
             game: 'YOUR GAME',
             gameIcon: 'Game icon',
             bindingTitle: 'Upload to TikTok',
-            bindingAction: 'Scan the QR code with TikTok',
-            bindingSubtitle: 'Authorize on your phone to continue uploading this game.',
-            bindingStatus: input.simulation
+            bindingAction: input.hybrid ? 'Real authorization QR · integration demo' : 'Scan the QR code with TikTok',
+            bindingSubtitle: input.hybrid
+                ? 'Scan to view the in-app page. After three real status polls, authorization and upload are simulated. Phone authorization is not required.'
+                : input.uploadAvailable === false
+                    ? 'Authorize on your phone. This is a real PPE authorization test; upload is not enabled yet.'
+                    : 'Authorize on your phone to continue uploading this game.',
+            bindingStatus: input.hybrid ? 'Querying the PPE task' : input.simulation
                 ? 'Simulating scan request'
                 : 'Waiting for you to scan',
             uploadingTitle: 'Uploading your game',
-            uploadingSubtitle: 'Account authorized. Your game is being uploaded.',
+            uploadingSubtitle: input.simulation ? 'Simulating the post-authorization upload. No game content is sent.' : 'Account authorized. Your game is being uploaded.',
             uploadLabel: input.simulation
                 ? 'Simulated upload progress'
                 : 'Upload progress',
             uploadStatus: 'Uploading your game. Please wait.',
-            completeTitle: 'Upload complete',
+            completeTitle: input.simulation ? 'Simulated upload complete' : 'Upload complete',
             completeSubtitle: input.simulation
                 ? 'Binding and upload simulation complete. Nothing was uploaded to TikTok.'
                 : 'Your game content has been uploaded. This operation is complete.',
             failedTitle: 'Upload not completed',
             bindingCode: 'Authorization QR',
-            accepted: 'Uploaded',
-            mockNote: 'Mock only · no scan needed, nothing is uploaded',
+            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',
         };
     const step = phase === 'binding' ? 0 : phase === 'uploading' ? 1 : 2;
@@ -17887,6 +17994,7 @@ function abortableDelay(ms, signal) {
     });
 }
 const defaults = {
+    createTrialBackend: createVibeTrialBackend,
     prepare: prepareVibeInput,
     startPage: startVibePage,
     sleep: abortableDelay,
@@ -17905,6 +18013,9 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
     let page;
     let detached = false;
     let progressUpdates = Promise.resolve();
+    let ppeLane;
+    let ppeSelected = false;
+    let hybridSelected = false;
     let result = {
         schemaVersion: '2',
         command: 'upload',
@@ -17939,14 +18050,24 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
             throw new VibeError('VIBE_CANCELLED');
     };
     try {
-        // Backend selection is environment configuration, not a Skill workflow branch.
-        // Explicit command-line selection wins; never silently fall back to mock.
+        // --mock is the stable trial entry: working steps use the built-in PPE lane,
+        // blocked steps remain simulated. No environment setup is required.
+        // Explicit command-line selection wins; real failures never fall back to mock.
         if (!options.mock && !options.vibeApi && process.env.TTMG_VIBE_BACKEND) {
             const configured = process.env.TTMG_VIBE_BACKEND;
             if (configured === 'mock')
                 options = { ...options, mock: true };
             else if (configured === 'local-http' && process.env.TTMG_VIBE_API)
                 options = { ...options, vibeApi: process.env.TTMG_VIBE_API };
+            else if (configured === 'ppe' || configured === 'ppe-mock') {
+                if (process.env.TTMG_VIBE_API)
+                    throw new VibeError('VIBE_BACKEND_OPTION_CONFLICT');
+                ppeSelected = true;
+                hybridSelected = configured === 'ppe-mock';
+                ppeLane = process.env.TTMG_VIBE_PPE;
+                if (!ppeLane || !/^ppe_[a-zA-Z0-9_-]{1,64}$/.test(ppeLane))
+                    throw new VibeError('VIBE_INVALID_PPE_ENV');
+            }
             else
                 throw new VibeError('VIBE_BACKEND_NOT_CONFIGURED');
         }
@@ -17960,7 +18081,7 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
         if (options.vibeAuthorizeUrl)
             throw new VibeError('VIBE_DEPRECATED_OPTION');
         if ((options.mock && (options.vibeApi || options.vibeAuthorizeUrl)) ||
-            (!options.mock && options.mockScenario))
+            (!options.mock && !hybridSelected && options.mockScenario))
             throw new VibeError('VIBE_BACKEND_OPTION_CONFLICT');
         if (options.pollInterval !== undefined)
             seconds(options.pollInterval, 1);
@@ -17972,7 +18093,11 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
         let backend = deps.backend;
         if (!options.dryRun && !backend) {
             if (options.mock)
-                backend = createMockBackend(options.mockScenario);
+                backend = deps.createTrialBackend(options.mockScenario);
+            else if (hybridSelected)
+                backend = createPpeMockBackend(ppeLane, undefined, options.mockScenario);
+            else if (ppeSelected)
+                backend = createPpeBackend(ppeLane);
             else if (options.vibeApi)
                 backend = createLocalHttpBackend(options.vibeApi);
             else
@@ -17980,7 +18105,8 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
         }
         emit('precheck', {
             backend: backend?.mode || 'none',
-            simulation: backend?.mode === 'mock',
+            simulation: backend?.mode === 'mock' || backend?.mode === 'ppe-mock',
+            ...(backend?.mode === 'ppe-mock' ? { simulationStartsAt: 'authorization' } : {}),
         });
         ensureActive();
         const input = await deps.prepare(options, () => emit('packaging'), controller.signal);
@@ -18000,9 +18126,11 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
         const pageGame = {
             title: input.title,
             iconDataUrl: `data:${input.icon.contentType};base64,${input.icon.bytes.toString('base64')}`,
+            uploadAvailable: backend.uploadAvailable !== false,
+            hybrid: backend.mode === 'ppe-mock',
         };
         const sourceProjectId = deps.projectId(options);
-        emit('creating_task');
+        emit('creating_task', { platformWrite: backend.mode === 'ppe' || backend.mode === 'ppe-mock' });
         const task = await backend.createTask({
             source_type: 1,
             source_project_id: sourceProjectId,
@@ -18010,7 +18138,7 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
             minis_type: 'MINI_GAME',
         }, controller.signal);
         ensureActive();
-        const authorizationUrl = safeWebUrl(task.landingUrl);
+        const authorizationUrl = createAuthorizationScheme(task.landingUrl);
         const pollMs = seconds(options.pollInterval, task.pollIntervalSeconds);
         result = {
             ...result,
@@ -18019,17 +18147,25 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
         };
         page = await deps.startPage();
         ensureActive();
+        const bindingMessage = backend.mode === 'ppe-mock'
+            ? (getCurrentLanguage() === 'zh-CN'
+                ? '真实 PPE 任务和授权二维码；查询三次后模拟授权、上传，无需完成手机授权。'
+                : 'Real PPE task and authorization QR. After three polls, authorization and upload are simulated; phone authorization is not required.')
+            : backend.uploadAvailable === false
+                ? (getCurrentLanguage() === 'zh-CN' ? '请扫码完成真实 PPE 授权；上传尚未开放。' : 'Scan to authorize in PPE. Upload is not enabled yet.')
+                : text('waiting_authorization', result.simulation);
         await page.update({
             ...pageGame,
             language: getCurrentLanguage(),
             phase: 'binding',
             simulation: result.simulation,
-            message: text('waiting_authorization', result.simulation),
+            message: bindingMessage,
             qrUrl: authorizationUrl,
             purpose: 'authorization_binding',
         });
         ensureActive();
         emit('waiting_authorization', {
+            message: bindingMessage,
             pageUrl: page.url,
             qrPurpose: 'authorization_binding',
             nextAction: result.simulation ? 'wait' : 'scan_qr',
@@ -18046,11 +18182,17 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
                 ...result,
                 taskStatusRaw: response.statusRaw,
                 readyForInput: response.readyForInput,
+                ...(backend.mode === 'ppe-mock' ? {
+                    simulatedReadyForInput: response.simulatedReadyForInput === true,
+                    simulatedTaskStatusRaw: response.simulatedReadyForInput ? 2 : 1,
+                } : {}),
             };
-            if (response.readyForInput)
+            if (backend.mode === 'ppe-mock' ? response.simulatedReadyForInput : response.readyForInput)
                 break;
             await deps.sleep(pollMs, controller.signal);
         }
+        if (backend.uploadAvailable === false)
+            throw new VibeError('VIBE_REAL_UPLOAD_NOT_READY');
         await page.update({
             ...pageGame,
             language: getCurrentLanguage(),
@@ -18105,7 +18247,9 @@ 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, taskStatusRaw: receipt.statusRaw };
+        result = { ...result, uploaded: true, ...(backend.mode === 'ppe-mock'
+                ? { simulatedTaskStatusRaw: receipt.statusRaw }
+                : { taskStatusRaw: receipt.statusRaw }) };
         await progressUpdates;
         if (progressPageError)
             throw progressPageError;
@@ -18160,6 +18304,14 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
                 '尚未配置服务；本地模拟请使用 --mock。',
                 'No backend configured. Use --mock for local simulation.',
             ],
+            VIBE_INVALID_PPE_ENV: [
+                'PPE 模式需要显式设置 TTMG_VIBE_PPE，例如 ppe_op_vc。',
+                'PPE mode requires TTMG_VIBE_PPE, for example ppe_op_vc.',
+            ],
+            VIBE_REAL_UPLOAD_NOT_READY: [
+                '任务授权已完成，尚未上传：真实上传所需的完整基础信息尚未接入。不会模拟上传成功。',
+                'Task authorized; nothing uploaded. The complete app-info input contract is not integrated yet. No simulated success.',
+            ],
             VIBE_BACKEND_REQUEST_FAILED: [
                 '服务请求失败，本次操作已停止；已开始上传时请先核对任务，勿直接重传。',
                 'The service request failed. If upload started, check the task before retrying.',
@@ -18200,6 +18352,7 @@ async function executeVibeUpload(options, onEvent = () => { }, dependencies = {}
                     title: result.title || '',
                     language: getCurrentLanguage(),
                     simulation: result.simulation,
+                    hybrid: result.backend === 'ppe-mock',
                     phase: result.uploaded ? 'complete' : 'failed',
                     message,
                 });
@@ -18255,7 +18408,7 @@ async function vibeUpload(options) {
             else if (format === 'text')
                 console.log(`${event.simulation ? '[MOCK] ' : ''}${event.message}${event.status === 'uploading' && percent(event.loadedBytes, event.totalBytes) !== undefined ? ` ${percent(event.loadedBytes, event.totalBytes)}%` : ''}${event.pageUrl && ['waiting_authorization', 'uploaded'].includes(event.status) ? `\n${event.pageUrl}` : ''}${event.errorCode ? ` (${event.errorCode})` : ''}`);
             else if (event.status === 'waiting_authorization')
-                console.error(`${event.simulation ? '[MOCK] ' : ''}${text(event.status, event.simulation)}\n${event.pageUrl}`);
+                console.error(`${event.simulation ? '[MOCK] ' : ''}${event.message}\n${event.pageUrl}`);
         }, {}, controller.signal);
         if (format === 'json' || !['text', 'json', 'ndjson'].includes(format))
             console.log(JSON.stringify(result));